@mplibunao/oxlint-standards

Opinionated oxlint presets for MP's code-quality backpressure package.

The package exports an oxlint JS plugin plus preset objects for Effect, Effect-in-React, stack-neutral JavaScript/TypeScript hygiene, and monorepo boundaries.

Usage

Install the package, then load it from a standalone .oxlintrc.json:

{
  "jsPlugins": ["@mplibunao/oxlint-standards"],
  "rules": {
    "@mplibunao/oxlint-standards/no-effect-as": "error",
    "@mplibunao/oxlint-standards/no-barrel-import": "error"
  }
}

The compiled package is the supported consumer path. Inline vite-plus jsPlugins config may work later, but this package validates the standalone oxlint config path first.

Rule severity

Rules ship with graded default severities. Correctness, safety, and agent-failure-mode rules default to error. Style and preference rules default to a quieter level. The aim is an error signal worth acting on instead of a wall of errors.

Some coding agents act on error but skip warn, so an adversarial review step helps the quieter rules land. Every rule is overridable: raise any rule to error in your own .oxlintrc.json when you want a hard stop. The reasoning is in docs/decisions/004-rule-curation-and-severity-posture.md.

Presets

The main package entry exports:

• effectPreset: gen-first Effect v4 structural rules. It includes require-yield: off and no-shadow: off because idiomatic Effect.gen conflicts with those native rules.
• effectReactPreset: Effect and @effect-atom rules for React code, including atom/state-update rules and the broad React state-hook ban.
• generalPreset: stack-neutral JS/TS backpressure, including prevent-dynamic-imports and built-in no-nested-ternary.
• boundariesPreset: package-boundary rules such as no-cross-package-relative-imports.

The unqualified react preset name is reserved for a future stack-neutral React preset. Do not combine effect-react with that future hooks-first preset because effect-react forbids hooks that a general React preset would regulate.

Effect language-service boundary

This package ships fast AST-shape rules only. Type-aware Effect semantics belong in the consumer's own @effect/language-service setup.

Recommended consumer setup:

{
  "compilerOptions": {
    "plugins": [
      {
        "name": "@effect/language-service",
        "diagnosticSeverity": {
          "importFromBarrel": "error",
          "missingEffectServiceDependency": "error",
          "leakingRequirements": "error",
          "unsafeEffectTypeAssertion": "error",
          "instanceOfSchema": "error",
          "globalDate": "error",
          "globalRandom": "error",
          "globalConsole": "error",
          "globalFetch": "error",
          "globalTimers": "error",
          "preferSchemaOverJson": "error",
          "schemaSyncInEffect": "error",
          "cryptoRandomUUID": "error"
        }
      }
    ]
  }
}

no-barrel-import intentionally overlaps the language service's importFromBarrel diagnostic because the AST rule gives config-free feedback before a TypeScript project is wired.

Catalog posture

v0 targets Effect v4 identifiers. Effect v3 spellings are out of scope unless a v4 structural matcher catches them naturally.

The catalog currently records:

• 50 linteffect v0.0.6 source rules represented for inventory.
• 47 ported linteffect rules.
• 3 explicit linteffect drops: no-if-statement, no-effect-fn-generator, and no-ternary.
• 21 reimplemented structural/recon rules, including effect-no-multiple-provide, prefer-effect-fn, no-barrel-import, no-inline-schema-compile, and executor-derived error/schema/promise rules.
• 1 built-in default: oxlint no-nested-ternary in generalPreset.
• 13 LSP-owned semantic diagnostics documented for @effect/language-service.

See docs/references/rules.md for the consumer-facing catalog and src/rule-manifest.ts for the machine-checkable source of truth.

Attribution

The linteffect-derived rules are derived from @catenarycloud/linteffect, the MIT-licensed GritQL rule pack by Roman Naumenko. The GritQL tooling is not copied into this package.