eslint-plugin-haskellish-effect

eslint-plugin-haskellish-effect

Part of haskellish-effect-ts — Haskell-like discipline for TypeScript, enforced by tooling. For motivation, full documentation, and quick setup, see the main repository.

ESLint plugin that enforces Haskell-style purity discipline in TypeScript via Effect-TS.

Install

bun add -d eslint-plugin-haskellish-effect eslint

For a one-import setup with pre-configured rule sets, use haskellish-effect-config instead.

Rules

Rule	What it enforces	recommended	strict
only-allowed-imports	Blocks direct effect imports and unknown packages	error	error
no-global-access	Blocks fetch, console, Date, Math, etc.	error	error
no-implicit-globalthis	Blocks globalThis, window, document, self	error	error
capability-enforcement	Closed-world rule — all bindings must be traceable to imports	warn	error
no-promise	Blocks async/await and new Promise() — use Effect	warn	error
no-explicit-any	Blocks any type annotations	warn	error
no-throw	Blocks throw — use Effect.fail or Effect.die	warn	error
no-mutation	Blocks let/var, reassignment, ++/-- — use const and Effect's Ref	warn	error
effect-boundary	Exported functions should return Effect	—	error

Usage

// eslint.config.js
import haskellishPlugin, { recommended } from 'eslint-plugin-haskellish-effect'

export default [
  recommended,
  // or use `strict` for all rules as errors
]

For manual rule configuration:

// eslint.config.js
import haskellishPlugin from 'eslint-plugin-haskellish-effect'

export default [
  {
    plugins: { 'haskellish-effect': haskellishPlugin },
    rules: {
      'haskellish-effect/no-global-access': 'error',
      'haskellish-effect/no-promise': 'warn',
      // ...
    },
  },
]

License

MIT