@dobroslavlabs/oxlint

@dobroslavlabs/oxlint

Custom Oxlint JS plugin + Ultracite-style presets for JS/TS, React/JSX, Effect, Elysia, Bun, and Zod.

• Package: @dobroslavlabs/oxlint (0.1.3)
• Repo: github.com/dobroslavlabs/oxlint
• Author: Dobroslav Radosavljevic
• Rule IDs: dobroslavlabs/<rule>
• Changelog: CHANGELOG.md

Quick start

bun add -d oxlint @dobroslavlabs/oxlint

// oxlint.config.ts
import { defineConfig } from "oxlint";
import recommended from "@dobroslavlabs/oxlint/recommended";

export default defineConfig({
  extends: [recommended],
});

Or pick surfaces:

import { defineConfig } from "oxlint";
import core from "@dobroslavlabs/oxlint/core"; // JS/TS
import react from "@dobroslavlabs/oxlint/react"; // JSX/TSX + hooks
import effect from "@dobroslavlabs/oxlint/effect"; // Effect (opt-in)
import elysia from "@dobroslavlabs/oxlint/elysia"; // Elysia (opt-in)
import bun from "@dobroslavlabs/oxlint/bun"; // Bun (opt-in)
import zod from "@dobroslavlabs/oxlint/zod"; // Zod (opt-in)

export default defineConfig({
  extends: [core, react, effect, elysia, bun, zod],
});

Presets

Each preset sets jsPlugins: ["@dobroslavlabs/oxlint"] and turns on the matching rules. /effect, /elysia, /bun, and /zod are not included in /recommended.

Rules

Core

Most core rules accept { allow?: string[] } (path substrings — use distinctive fragments). no-direct-process-env also takes allowKeys ([] bans all keys; does not fall back to defaults).

Notes: no-index-imports only flags explicit /index paths (directory imports like ./components are allowed).

"dobroslavlabs/require-jsdoc": ["error", { minStatements: 5, minParams: 4 }],
"dobroslavlabs/no-index-barrels": ["error", { allow: ["src/index.ts"] }],
"dobroslavlabs/no-direct-process-env": ["error", { allowKeys: ["NODE_ENV", "CI"] }],
"dobroslavlabs/no-forbidden-imports": [
  "error",
  {
    paths: [{ name: "lucide-react", message: "Use Hugeicons instead." }],
    patterns: [{ regex: "^@unpic/react", message: "Use the shared Image component." }],
  },
],

React

React JSX rules are scoped to **/*.{jsx,tsx} in the react preset. Hook rules and no-react-namespace also apply to plain .ts (React types / hooks). Most accept { allow?: string[] }.

Limits (v1): class components and forwardRef wrappers are not covered by file-shape / JSX-hygiene rules. Secondary named exports after the first primary component are ignored by component-file-name-match.

no-native-html default ban list:
button · a · input · textarea · select · option · optgroup · label · img · video · audio · picture · source · iframe · dialog · details · summary · progress · ul · ol · li · table · thead · tbody · tfoot · tr · th · td · caption · hr

"dobroslavlabs/no-native-html": ["error", { tags: ["button", "a"] }],

Effect (opt-in — @dobroslavlabs/oxlint/effect)

Most accept { allow?: string[] }. Pair with @effect/language-service for type-aware checks (floating Effect, full outdated API catalog, etc.).

import effect from "@dobroslavlabs/oxlint/effect";

export default defineConfig({
  extends: [recommended, effect],
});

Zod (opt-in — @dobroslavlabs/oxlint/zod)

zod-schema-naming flags definitional z.object() / z.string() etc., not UserSchema.pick() or makeUserSchema().

import zod from "@dobroslavlabs/oxlint/zod";

export default defineConfig({
  extends: [recommended, zod],
});

Elysia (opt-in — @dobroslavlabs/oxlint/elysia)

Rules only run in files that import from elysia.

import elysia from "@dobroslavlabs/oxlint/elysia";

export default defineConfig({
  extends: [recommended, elysia],
});

Bun (opt-in — @dobroslavlabs/oxlint/bun)

For Bun apps. Prefer Bun-native APIs over Node fallbacks (docs: Bun.file / Bun.write / Bun.spawn / bun:sqlite). Does not ban node:fs directory APIs (readdir, mkdir, …). Use { allow } for isomorphic packages.

import bun from "@dobroslavlabs/oxlint/bun";

export default defineConfig({
  extends: [recommended, bun],
});

Develop

bun install
bun run test        # Vitest + Oxlint RuleTester (Node 22+)
bun run typecheck   # strict TypeScript 7
bun run fmt         # oxfmt
bun run lint        # build + ultracite check (dogfoods this package)
bun run build       # tsdown → dist (publint + attw + unused)
bun run check       # build → typecheck → test → fmt:check → lint

Stack: Bun · TypeScript 7 · Ultracite (oxlint + oxfmt) · tsdown · Vitest · @oxlint/plugins

CI (.github/workflows/ci.yml) runs check on main push/PR. It does not publish.

Editor: Oxc VS Code extension (format + fix on save — import sort via oxfmt, unused-import removal via oxlint).

Publish (local only)

bun run login      # npm login --auth-type=web (browser / 2FA)
bun run pack:dry   # check + npm pack --dry-run
bun run release    # npm publish --access public

prepublishOnly runs check; prepack runs build. See CHANGELOG.md for release notes.