Registry / testing / oxlint-plugin-effect

oxlint-plugin-effect

library0.2.2jsnpmunverified

oxlint-plugin-effect (v0.2.2) is an oxlint plugin that provides lint rules specific to the Effect-TS ecosystem. It includes both JavaScript-based rules and Go-based type-aware rules for deeper analysis. The plugin supports Effect v3 and v4 dual-version codebases, and ships precompiled binaries for multiple platforms. Key differentiators: type-aware linting via tsgolint Go binary, 59+ rules covering Effect patterns, and integration with oxlint's plugin system. The plugin is actively maintained with releases on a changeset-based cadence. Peer dependency: effect >=4.0.0-beta.49.

testing

npm install oxlint-plugin-effect

github ↗package ↗

INSTALL

IMPORT

SIG · OXLINT-PLUGIN-EFFE

oxlint-plugin-effect

testingjavascriptv0.2.2

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

oxlint-plugin-effect

✓ {} from 'oxlint-plugin-effect'

✗ require('oxlint-plugin-effect')

Plugin is loaded by oxlint via its plugin mechanism; direct import is not typical.

rules

✓ import { rules } from 'oxlint-plugin-effect'

✗ const { rules } = require('oxlint-plugin-effect')

The plugin exposes an object with a 'rules' property.

configs

✓ import { configs } from 'oxlint-plugin-effect'

configs contains presets like 'recommended' and 'strict'.

Configures oxlint with the Effect plugin and enables two rules as an example.

// oxlint.config.ts import { defineLinter } from 'oxlint'; import pluginEffect from 'oxlint-plugin-effect'; export default defineLinter({ plugins: { effect: pluginEffect, }, rules: { 'effect/no-unnecessary-pipe-chain': 'error', 'effect/no-catch-all-to-map-error': 'warn', }, });

Debug

Known issues

breakingPlugin fails to load because it shipped raw TypeScript files instead of compiled JavaScript.

fix

Upgrade to oxlint-plugin-effect@0.2.1 or later, which ships compiled JS.

affects: <=0.2.0

breakingRemoved rule 'noReturnNull' from strict preset; using that preset may cause oxlint config parse failure.

fix

Remove any reference to 'noReturnNull' from your config; use 'noReturnNullish' instead.

affects: >=0.2.2

breakingRule names changed between v0.1.0 and v0.2.0, e.g., 'noEffectMap' replaced by 'no-effect-map'.

fix

Update rule names to kebab-case format as used in oxlint config.

affects: 0.2.0

deprecatedThe 'full' preset is deprecated in favor of 'recommended' or 'strict'.

fix

Use 'configs.recommended' or 'configs.strict' instead of 'configs.full'.

affects: >=0.2.0

gotchaPeer dependency 'effect' must be >=4.0.0-beta.49; older versions will cause rule errors.

fix

Ensure your project depends on effect >=4.0.0-beta.49.

affects: >=0.1.0

Errors

Common errors & fixes

ERR_UNSUPPORTED_NODE_MODULES_TYPE_STRIPPING

Plugin shipped raw TypeScript; Node cannot strip types under node_modules.

fix

Upgrade to oxlint-plugin-effect@0.2.1 or later.

Error: Failed to parse oxlint config: unknown rule 'effect/noReturnNull'

The rule 'noReturnNull' was removed from the plugin in v0.2.2.

fix

Replace 'effect/noReturnNull' with 'effect/noReturnNullish' in your config.

Cannot find module 'oxlint-plugin-effect'

Plugin not installed or version mismatch.

fix

Run 'npm install oxlint-plugin-effect' and check peer dependency effect.

TypeError: pluginEffect is not a function

Plugin default export is not a function; it is an object.

fix

Use 'pluginEffect' directly in the plugins object, not as pluginEffect().

Upgrade

Version history

0.2.2latest on npm

Audit

Dependencies

effectrequiredruntime peer dependency; lint rules check Effect symbols and APIs

Agent activity

2 hits · last 30 days

node

Resources

githubhttps://github.com/cevr/effect-oxlint ↗

packagehttps://www.npmjs.com/package/oxlint-plugin-effect ↗