oxlint-plugin-enforce-source-imports

Oxlint plugin that keeps imports pointed at their source files instead of middleman re-export modules.

Rules

| Rule | Purpose | |------|---------| | enforce-source-imports/no-unauthorized-reexports | Forbids middleman re-exports except in allowed stub entrypoints (index.ts, registry.ts, etc.). Covers export { … } from "…", export * from "…", export type Alias = ImportedType, export const Alias = importedBinding, export default importedBinding, and export { importedBinding } without a from clause. Autofix removes or de-exports every middleman export in a file in one pass (unused imports are left for a separate unused-import rule). | | enforce-source-imports/import-from-source | Rewrites imports that pull symbols through a non-stub re-export barrel to the defining module, including default imports and multi-hop named re-exports. Autofix for named/default imports when safe (no inline or in-statement comments; namespace-only imports are skipped). |

Install

bun add -D oxlint-plugin-enforce-source-imports @oxlint/plugins oxlint typescript

For local development against a checkout of this repo:

bun add -D oxlint-plugin-enforce-source-imports@file:../oxlint-plugin-enforce-source-imports

Configure

Add the plugin to .oxlintrc.json:

{
  "jsPlugins": ["oxlint-plugin-enforce-source-imports"],
  "rules": {
    "enforce-source-imports/no-unauthorized-reexports": "error",
    "enforce-source-imports/import-from-source": "error"
  }
}

The plugin reads your project tsconfig.json path aliases (for example @/*) and builds a pre-built re-export map from src/ once per oxlint run (for fast @/… barrel lookups). When a consumer imports a middleman via a relative path outside that index (for example ./i18n-messages from scripts/), the map resolves that barrel on demand from the resolved file path — no project-wide directory walk and no hardcoded folder skip lists.

Lint scope is yours: oxlint CLI arguments and ignorePatterns in .oxlintrc.json decide which files are linted and autofixed (same as ESLint). Run lint across every file that participates in a re-export chain — for example oxlint --fix . with scripts/ included — so no-unauthorized-reexports and import-from-source can both apply.

Autofix is conservative: it skips fixes when comments are inside the statement or on the same line, and when an import mixes default/namespace and named specifiers.

Allowed stub files

Only files named index.ts, registry.ts, and related variants (index.tsx, registry.tsx, etc.) may re-export from other modules. Use registry.ts for autogenerated aggregate entrypoints (for example a subject config registry). Every other file must import from the source directly.

Development

bun install
bun run verify

verify runs typecheck, build, and the full test suite (including oxlint e2e when run via bun run test:e2e).

prepare runs build on install so dist/*.js exists for oxlint to load from node_modules.

License

MIT