eslint-config-setup 0.4.0 → 0.5.1

package/dist/configs/d537b683.js

@@ -14,6 +14,8 @@ import packageJsonPlugin from "eslint-plugin-package-json"
 import perfectionistPlugin from "eslint-plugin-perfectionist"
 import playwrightPlugin from "eslint-plugin-playwright"
 import reactEffectPlugin from "eslint-plugin-react-you-might-not-need-an-effect"
+import reactHooksPlugin from "eslint-plugin-react-hooks"
+import reactPerfPlugin from "eslint-plugin-react-perf"
 import reactRefreshPlugin from "eslint-plugin-react-refresh"
 import regexpPlugin from "eslint-plugin-regexp"
 import securityPlugin from "eslint-plugin-security"
@@ -26,7 +28,7 @@ import unicornPlugin from "eslint-plugin-unicorn"
 import unusedImportsPlugin from "eslint-plugin-unused-imports"
 import vitestPlugin from "@vitest/eslint-plugin"
 
-// React compat plugin — merges @eslint-react sub-plugins into a single `react/` namespace
+// React compat plugin — maps @eslint-react rule families into the `react/` namespace
 // and aliases rules to legacy eslint-plugin-react names for OxLint compatibility.
 const reactCompatPlugin = (() => {
   const core = eslintReactPlugin.rules
@@ -52,7 +54,6 @@ const reactCompatPlugin = (() => {
     "no-unstable-nested-components": [core, "no-nested-component-definitions"],
     "display-name": [core, "no-missing-component-display-name"],
     "forward-ref-uses-ref": [core, "no-forward-ref"],
-    "destructuring-assignment": [core, "prefer-destructuring-assignment"],
     "no-did-mount-set-state": [core, "no-set-state-in-component-did-mount"],
     "no-did-update-set-state": [core, "no-set-state-in-component-did-update"],
     "no-will-update-set-state": [core, "no-set-state-in-component-will-update"],
@@ -74,7 +75,7 @@ const reactCompatPlugin = (() => {
   // Identical-name aliases (core rules where legacy name = @eslint-react name)
   const identicalCore = [
     "no-access-state-in-setstate", "no-array-index-key",
-    "no-direct-mutation-state", "no-redundant-should-component-update",
+    "no-direct-mutation-state",
     "no-unused-class-component-members", "no-unused-state",
   ]
   for (const n of identicalCore) aliases[n] = [core, n]
@@ -131,6 +132,8 @@ export default [
       "node": nodePlugin,
       "perfectionist": perfectionistPlugin,
       "react": reactCompatPlugin,
+      "react-hooks": reactHooksPlugin,
+      "react-perf": reactPerfPlugin,
       "react-refresh": reactRefreshPlugin,
       "react-you-might-not-need-an-effect": reactEffectPlugin,
       "regexp": regexpPlugin,
@@ -929,6 +932,27 @@ export default [
       "prefer-template": "error",
       "preserve-caught-error": "error",
       "radix": "error",
+      "react-hooks/config": "error",
+      "react-hooks/error-boundaries": "error",
+      "react-hooks/exhaustive-deps": "warn",
+      "react-hooks/gating": "error",
+      "react-hooks/globals": "error",
+      "react-hooks/immutability": "error",
+      "react-hooks/incompatible-library": "warn",
+      "react-hooks/preserve-manual-memoization": "error",
+      "react-hooks/purity": "error",
+      "react-hooks/refs": "error",
+      "react-hooks/rules-of-hooks": "error",
+      "react-hooks/set-state-in-effect": "error",
+      "react-hooks/set-state-in-render": "error",
+      "react-hooks/static-components": "error",
+      "react-hooks/unsupported-syntax": "warn",
+      "react-hooks/use-memo": "error",
+      "react-hooks/void-use-memo": "error",
+      "react-perf/jsx-no-jsx-as-prop": "error",
+      "react-perf/jsx-no-new-array-as-prop": "error",
+      "react-perf/jsx-no-new-function-as-prop": "error",
+      "react-perf/jsx-no-new-object-as-prop": "error",
       "react-refresh/only-export-components": [
         "warn",
         {
@@ -938,18 +962,14 @@ export default [
       "react-you-might-not-need-an-effect/no-adjust-state-on-prop-change": "warn",
       "react-you-might-not-need-an-effect/no-chain-state-updates": "error",
       "react-you-might-not-need-an-effect/no-derived-state": "error",
-      "react-you-might-not-need-an-effect/no-empty-effect": "error",
       "react-you-might-not-need-an-effect/no-event-handler": "error",
+      "react-you-might-not-need-an-effect/no-external-store-subscription": "error",
       "react-you-might-not-need-an-effect/no-initialize-state": "error",
       "react-you-might-not-need-an-effect/no-pass-data-to-parent": "error",
       "react-you-might-not-need-an-effect/no-pass-live-state-to-parent": "error",
       "react-you-might-not-need-an-effect/no-reset-all-state-on-prop-change": "error",
       "react/button-has-type": "error",
-      "react/component-hook-factories": "error",
       "react/context-name": "warn",
-      "react/destructuring-assignment": "warn",
-      "react/error-boundaries": "error",
-      "react/exhaustive-deps": "warn",
       "react/forward-ref-uses-ref": "error",
       "react/function-definition": "error",
       "react/hook-use-state": "warn",
@@ -960,6 +980,7 @@ export default [
       "react/jsx-no-children-prop-with-children": "error",
       "react/jsx-no-comment-textnodes": "error",
       "react/jsx-no-constructed-context-values": "error",
+      "react/jsx-no-leaked-dollar": "warn",
       "react/jsx-no-leaked-render": "error",
       "react/jsx-no-leaked-semicolon": "warn",
       "react/jsx-no-script-url": "warn",
@@ -991,6 +1012,8 @@ export default [
       "react/no-hydrate": "error",
       "react/no-implicit-key": "error",
       "react/no-leaked-event-listener": "error",
+      "react/no-leaked-fetch": "warn",
+      "react/no-leaked-intersection-observer": "warn",
       "react/no-leaked-interval": "error",
       "react/no-leaked-resize-observer": "error",
       "react/no-leaked-timeout": "error",
@@ -998,12 +1021,9 @@ export default [
       "react/no-namespace": "error",
       "react/no-nested-lazy-component-declarations": "error",
       "react/no-object-type-as-default-prop": "error",
-      "react/no-redundant-should-component-update": "error",
       "react/no-render": "error",
       "react/no-render-return-value": "error",
       "react/no-unknown-property": "error",
-      "react/no-unnecessary-use-callback": "warn",
-      "react/no-unnecessary-use-memo": "warn",
       "react/no-unnecessary-use-prefix": "warn",
       "react/no-unsafe-component-will-mount": "warn",
       "react/no-unsafe-component-will-receive-props": "warn",
@@ -1016,14 +1036,8 @@ export default [
       "react/no-use-context": "error",
       "react/no-use-form-state": "error",
       "react/no-will-update-set-state": "warn",
-      "react/purity": "warn",
       "react/ref-name": "warn",
-      "react/rules-of-hooks": "error",
-      "react/set-state-in-effect": "warn",
-      "react/set-state-in-render": "error",
       "react/style-prop-object": "error",
-      "react/unsupported-syntax": "error",
-      "react/use-memo": "error",
       "react/void-dom-elements-no-children": "error",
       "regexp/confusing-quantifier": "warn",
       "regexp/control-character-escape": "error",
@@ -1173,7 +1187,10 @@ export default [
             "camelCase": true,
             "pascalCase": true,
             "kebabCase": true
-          }
+          },
+          "ignore": [
+            "__tests__"
+          ]
         }
       ],
       "unicorn/new-for-builtins": "error",
@@ -1181,12 +1198,12 @@ export default [
       "unicorn/no-accessor-recursion": "error",
       "unicorn/no-anonymous-default-export": "error",
       "unicorn/no-array-callback-reference": "error",
-      "unicorn/no-array-for-each": "error",
       "unicorn/no-array-method-this-argument": "error",
       "unicorn/no-array-push-push": "error",
       "unicorn/no-array-reduce": "error",
       "unicorn/no-await-expression-member": "error",
       "unicorn/no-await-in-promise-methods": "error",
+      "unicorn/no-for-each": "error",
       "unicorn/no-for-loop": "error",
       "unicorn/no-instanceof-builtins": "error",
       "unicorn/no-invalid-fetch-options": "error",
@@ -1226,7 +1243,7 @@ export default [
       "unicorn/prefer-export-from": [
         "error",
         {
-          "ignoreUsedVariables": true
+          "checkUsedVariables": false
         }
       ],
       "unicorn/prefer-global-this": "error",
@@ -1263,7 +1280,6 @@ export default [
       ],
       "unicorn/prefer-top-level-await": "error",
       "unicorn/prefer-type-error": "error",
-      "unicorn/prevent-abbreviations": "error",
       "unicorn/relative-url-style": "error",
       "unicorn/switch-case-braces": "error",
       "unicorn/text-encoding-identifier-case": "error",

package/dist/configs/db69ebb6.js

@@ -8,13 +8,13 @@ import globals from "globals"
 import importXPlugin from "eslint-plugin-import-x"
 import jsdocPlugin from "eslint-plugin-jsdoc"
 import jsonPlugin from "@eslint/json"
-import jsxA11yPlugin from "eslint-plugin-jsx-a11y"
 import nodePlugin from "eslint-plugin-n"
 import oxlintPlugin from "eslint-plugin-oxlint"
 import packageJsonPlugin from "eslint-plugin-package-json"
 import perfectionistPlugin from "eslint-plugin-perfectionist"
 import playwrightPlugin from "eslint-plugin-playwright"
 import reactEffectPlugin from "eslint-plugin-react-you-might-not-need-an-effect"
+import reactHooksPlugin from "eslint-plugin-react-hooks"
 import regexpPlugin from "eslint-plugin-regexp"
 import securityPlugin from "eslint-plugin-security"
 import sonarjsPlugin from "eslint-plugin-sonarjs"
@@ -26,7 +26,7 @@ import unicornPlugin from "eslint-plugin-unicorn"
 import unusedImportsPlugin from "eslint-plugin-unused-imports"
 import vitestPlugin from "@vitest/eslint-plugin"
 
-// React compat plugin — merges @eslint-react sub-plugins into a single `react/` namespace
+// React compat plugin — maps @eslint-react rule families into the `react/` namespace
 // and aliases rules to legacy eslint-plugin-react names for OxLint compatibility.
 const reactCompatPlugin = (() => {
   const core = eslintReactPlugin.rules
@@ -52,7 +52,6 @@ const reactCompatPlugin = (() => {
     "no-unstable-nested-components": [core, "no-nested-component-definitions"],
     "display-name": [core, "no-missing-component-display-name"],
     "forward-ref-uses-ref": [core, "no-forward-ref"],
-    "destructuring-assignment": [core, "prefer-destructuring-assignment"],
     "no-did-mount-set-state": [core, "no-set-state-in-component-did-mount"],
     "no-did-update-set-state": [core, "no-set-state-in-component-did-update"],
     "no-will-update-set-state": [core, "no-set-state-in-component-will-update"],
@@ -74,7 +73,7 @@ const reactCompatPlugin = (() => {
   // Identical-name aliases (core rules where legacy name = @eslint-react name)
   const identicalCore = [
     "no-access-state-in-setstate", "no-array-index-key",
-    "no-direct-mutation-state", "no-redundant-should-component-update",
+    "no-direct-mutation-state",
     "no-unused-class-component-members", "no-unused-state",
   ]
   for (const n of identicalCore) aliases[n] = [core, n]
@@ -127,10 +126,10 @@ export default [
       "de-morgan": deMorganPlugin,
       "import": importXPlugin,
       "jsdoc": jsdocPlugin,
-      "jsx-a11y": jsxA11yPlugin,
       "node": nodePlugin,
       "perfectionist": perfectionistPlugin,
       "react": reactCompatPlugin,
+      "react-hooks": reactHooksPlugin,
       "react-you-might-not-need-an-effect": reactEffectPlugin,
       "regexp": regexpPlugin,
       "security": securityPlugin,
@@ -234,10 +233,6 @@ export default [
           ]
         }
       ],
-      "@typescript-eslint/method-signature-style": [
-        "error",
-        "property"
-      ],
       "@typescript-eslint/naming-convention": [
         "error",
         {
@@ -484,7 +479,6 @@ export default [
         "getBeforeSet"
       ],
       "guard-for-in": "error",
-      "import/newline-after-import": "error",
       "import/no-extraneous-dependencies": [
         "error",
         {
@@ -506,13 +500,9 @@ export default [
       "jsdoc/reject-function-type": "error",
       "jsdoc/require-next-type": "error",
       "jsdoc/require-returns-check": "error",
-      "jsdoc/require-throws-type": "error",
       "jsdoc/require-yields-check": "error",
-      "jsdoc/require-yields-type": "error",
       "jsdoc/ts-no-empty-object-type": "error",
       "jsdoc/valid-types": "error",
-      "jsx-a11y/interactive-supports-focus": "error",
-      "jsx-a11y/no-noninteractive-element-interactions": "error",
       "logical-assignment-operators": [
         "error",
         "always",
@@ -700,24 +690,36 @@ export default [
       "prefer-template": "error",
       "preserve-caught-error": "error",
       "radix": "error",
+      "react-hooks/config": "error",
+      "react-hooks/error-boundaries": "error",
+      "react-hooks/gating": "error",
+      "react-hooks/globals": "error",
+      "react-hooks/immutability": "error",
+      "react-hooks/incompatible-library": "warn",
+      "react-hooks/preserve-manual-memoization": "error",
+      "react-hooks/purity": "error",
+      "react-hooks/refs": "error",
+      "react-hooks/set-state-in-effect": "error",
+      "react-hooks/set-state-in-render": "error",
+      "react-hooks/static-components": "error",
+      "react-hooks/unsupported-syntax": "warn",
+      "react-hooks/use-memo": "error",
+      "react-hooks/void-use-memo": "error",
       "react-you-might-not-need-an-effect/no-adjust-state-on-prop-change": "warn",
       "react-you-might-not-need-an-effect/no-chain-state-updates": "error",
       "react-you-might-not-need-an-effect/no-derived-state": "error",
-      "react-you-might-not-need-an-effect/no-empty-effect": "error",
       "react-you-might-not-need-an-effect/no-event-handler": "error",
+      "react-you-might-not-need-an-effect/no-external-store-subscription": "error",
       "react-you-might-not-need-an-effect/no-initialize-state": "error",
       "react-you-might-not-need-an-effect/no-pass-data-to-parent": "error",
       "react-you-might-not-need-an-effect/no-pass-live-state-to-parent": "error",
       "react-you-might-not-need-an-effect/no-reset-all-state-on-prop-change": "error",
-      "react/component-hook-factories": "error",
       "react/context-name": "warn",
-      "react/destructuring-assignment": "warn",
-      "react/error-boundaries": "error",
-      "react/exhaustive-deps": "warn",
       "react/function-definition": "error",
       "react/id-name": "warn",
       "react/jsx-key-before-spread": "error",
       "react/jsx-no-children-prop-with-children": "error",
+      "react/jsx-no-leaked-dollar": "warn",
       "react/jsx-no-leaked-render": "error",
       "react/jsx-no-leaked-semicolon": "warn",
       "react/no-access-state-in-setstate": "error",
@@ -732,39 +734,30 @@ export default [
       "react/no-component-will-update": "error",
       "react/no-context-provider": "error",
       "react/no-create-ref": "error",
-      "react/no-did-update-set-state": "warn",
       "react/no-duplicate-key": "error",
       "react/no-flush-sync": "error",
       "react/no-hydrate": "error",
       "react/no-implicit-key": "error",
       "react/no-leaked-event-listener": "error",
+      "react/no-leaked-fetch": "warn",
+      "react/no-leaked-intersection-observer": "warn",
       "react/no-leaked-interval": "error",
       "react/no-leaked-resize-observer": "error",
       "react/no-leaked-timeout": "error",
       "react/no-misused-capture-owner-stack": "error",
       "react/no-nested-lazy-component-declarations": "error",
-      "react/no-object-type-as-default-prop": "error",
       "react/no-render": "error",
-      "react/no-unnecessary-use-callback": "warn",
-      "react/no-unnecessary-use-memo": "warn",
       "react/no-unnecessary-use-prefix": "warn",
       "react/no-unsafe-component-will-mount": "warn",
       "react/no-unsafe-component-will-receive-props": "warn",
       "react/no-unsafe-component-will-update": "warn",
       "react/no-unsafe-iframe-sandbox": "warn",
-      "react/no-unstable-nested-components": "error",
       "react/no-unused-class-component-members": "warn",
       "react/no-unused-props": "warn",
       "react/no-unused-state": "error",
       "react/no-use-context": "error",
       "react/no-use-form-state": "error",
-      "react/purity": "warn",
       "react/ref-name": "warn",
-      "react/rules-of-hooks": "error",
-      "react/set-state-in-effect": "warn",
-      "react/set-state-in-render": "error",
-      "react/unsupported-syntax": "error",
-      "react/use-memo": "error",
       "regexp/confusing-quantifier": "warn",
       "regexp/control-character-escape": "error",
       "regexp/match-any": "error",
@@ -893,20 +886,14 @@ export default [
       "sonarjs/reduce-initial-value": "error",
       "symbol-description": "error",
       "unicorn/no-array-push-push": "error",
+      "unicorn/no-for-each": "error",
       "unicorn/no-for-loop": "error",
-      "unicorn/prefer-export-from": [
-        "error",
-        {
-          "ignoreUsedVariables": true
-        }
-      ],
       "unicorn/prefer-switch": [
         "error",
         {
           "minimumCases": 3
         }
       ],
-      "unicorn/prevent-abbreviations": "error",
       "unused-imports/no-unused-imports": "error",
       "yoda": "error"
     },
@@ -922,7 +909,6 @@ export default [
       "@typescript-eslint/consistent-type-exports": "off",
       "@typescript-eslint/dot-notation": "off",
       "@typescript-eslint/member-ordering": "off",
-      "@typescript-eslint/method-signature-style": "off",
       "@typescript-eslint/naming-convention": "off",
       "@typescript-eslint/no-array-delete": "off",
       "@typescript-eslint/no-base-to-string": "off",
@@ -981,7 +967,6 @@ export default [
       "@typescript-eslint/unbound-method": "off",
       "@typescript-eslint/use-unknown-in-catch-callback-variable": "off",
       "dot-notation": "off",
-      "getter-return": "error",
       "no-array-constructor": "off",
       "no-dupe-args": "error",
       "no-empty-function": "off",
@@ -992,7 +977,6 @@ export default [
       "no-shadow": "off",
       "no-throw-literal": "off",
       "no-undef": "error",
-      "no-unreachable": "error",
       "no-useless-constructor": "off",
       "prefer-const": [
         "error",
@@ -1242,7 +1226,6 @@ export default [
         "@typescript-eslint/consistent-type-exports": "off",
         "@typescript-eslint/dot-notation": "off",
         "@typescript-eslint/member-ordering": "off",
-        "@typescript-eslint/method-signature-style": "off",
         "@typescript-eslint/naming-convention": "off",
         "@typescript-eslint/no-array-delete": "off",
         "@typescript-eslint/no-base-to-string": "off",
@@ -1322,13 +1305,15 @@ export default [
   },
 
   // OxLint integration — disables rules already covered by OxLint
-  ...[oxlintPlugin.configs["flat/recommended"]].flat().map((c) => ({ name: "eslint-config-setup/oxlint", ...c })),
-  ...[oxlintPlugin.configs["flat/react"]].flat().map((c) => ({ name: "eslint-config-setup/oxlint-react", ...c })),
-  ...[oxlintPlugin.configs["flat/jsx-a11y"]].flat().map((c) => ({ name: "eslint-config-setup/oxlint-jsx-a11y", ...c })),
-  ...[oxlintPlugin.configs["flat/node"]].flat().map((c) => ({ name: "eslint-config-setup/oxlint-node", ...c })),
-  ...[oxlintPlugin.configs["flat/typescript"]].flat().map((c) => ({ name: "eslint-config-setup/oxlint-typescript", ...c })),
-  ...[oxlintPlugin.configs["flat/unicorn"]].flat().map((c) => ({ name: "eslint-config-setup/oxlint-unicorn", ...c })),
-  ...[oxlintPlugin.configs["flat/import"]].flat().map((c) => ({ name: "eslint-config-setup/oxlint-import", ...c })),
-  ...[oxlintPlugin.configs["flat/jsdoc"]].flat().map((c) => ({ name: "eslint-config-setup/oxlint-jsdoc", ...c })),
+  ...[oxlintPlugin.configs["flat/recommended"]].flat().map((c, index, array) => ({ ...c, name: "eslint-config-setup/oxlint" + (array.length > 1 ? "-" + (index + 1) : "") })),
+  ...[oxlintPlugin.configs["flat/react"]].flat().map((c, index, array) => ({ ...c, name: "eslint-config-setup/oxlint-react" + (array.length > 1 ? "-" + (index + 1) : "") })),
+  ...[oxlintPlugin.configs["flat/jsx-a11y"]].flat().map((c, index, array) => ({ ...c, name: "eslint-config-setup/oxlint-jsx-a11y" + (array.length > 1 ? "-" + (index + 1) : "") })),
+  ...[oxlintPlugin.configs["flat/react-hooks"]].flat().map((c, index, array) => ({ ...c, name: "eslint-config-setup/oxlint-react-hooks" + (array.length > 1 ? "-" + (index + 1) : "") })),
+  ...[oxlintPlugin.configs["flat/react-perf"]].flat().map((c, index, array) => ({ ...c, name: "eslint-config-setup/oxlint-react-perf" + (array.length > 1 ? "-" + (index + 1) : "") })),
+  ...[oxlintPlugin.configs["flat/node"]].flat().map((c, index, array) => ({ ...c, name: "eslint-config-setup/oxlint-node" + (array.length > 1 ? "-" + (index + 1) : "") })),
+  ...[oxlintPlugin.configs["flat/typescript"]].flat().map((c, index, array) => ({ ...c, name: "eslint-config-setup/oxlint-typescript" + (array.length > 1 ? "-" + (index + 1) : "") })),
+  ...[oxlintPlugin.configs["flat/unicorn"]].flat().map((c, index, array) => ({ ...c, name: "eslint-config-setup/oxlint-unicorn" + (array.length > 1 ? "-" + (index + 1) : "") })),
+  ...[oxlintPlugin.configs["flat/import"]].flat().map((c, index, array) => ({ ...c, name: "eslint-config-setup/oxlint-import" + (array.length > 1 ? "-" + (index + 1) : "") })),
+  ...[oxlintPlugin.configs["flat/jsdoc"]].flat().map((c, index, array) => ({ ...c, name: "eslint-config-setup/oxlint-jsdoc" + (array.length > 1 ? "-" + (index + 1) : "") })),
 
 ]

package/dist/configs/e4b137fa.js

@@ -621,7 +621,10 @@ export default [
             "camelCase": true,
             "pascalCase": true,
             "kebabCase": true
-          }
+          },
+          "ignore": [
+            "__tests__"
+          ]
         }
       ],
       "unicorn/new-for-builtins": "error",
@@ -670,7 +673,7 @@ export default [
       "unicorn/prefer-export-from": [
         "error",
         {
-          "ignoreUsedVariables": true
+          "checkUsedVariables": false
         }
       ],
       "unicorn/prefer-global-this": "error",

package/dist/index.js

@@ -112,21 +112,31 @@ function oxlintOptionsToFilename(opts) {
 }
 
 // src/loader.ts
-import { readFileSync } from "fs";
+import { existsSync, readFileSync } from "fs";
 import path from "path";
+import { pathToFileURL } from "url";
 async function getEslintConfig(opts = {}) {
   const filename = optionsToFilename(opts);
   const dirname = import.meta.dirname;
   const configPath = path.join(dirname, "configs", filename);
+  if (!existsSync(configPath)) {
+    throwMissingConfigError(opts, filename);
+  }
+  const configUrl = pathToFileURL(configPath);
+  configUrl.search = String(Date.now());
   try {
     const module = await import(
       /* webpackIgnore: true */
-      `${configPath}?${Date.now()}`
+      configUrl.href
     );
     return module.default;
-  } catch {
+  } catch (error) {
+    if (!existsSync(configPath)) {
+      throwMissingConfigError(opts, filename, error);
+    }
     throw new Error(
-      `eslint-config-setup: No pre-generated config found for options ${JSON.stringify(opts)}. Expected file: configs/${filename}. Run "npm run generate" in the package to build configs.`
+      `eslint-config-setup: Pre-generated config failed to load for options ${JSON.stringify(opts)}. Expected file: configs/${filename}. Original error: ${getErrorMessage(error)}`,
+      { cause: error }
     );
   }
 }
@@ -143,6 +153,16 @@ function getOxlintConfig(opts = {}) {
     );
   }
 }
+function getErrorMessage(error) {
+  return error instanceof Error ? error.message : String(error);
+}
+function throwMissingConfigError(opts, filename, cause) {
+  const message = `eslint-config-setup: No pre-generated config found for options ${JSON.stringify(opts)}. Expected file: configs/${filename}. Run "npm run generate" in the package to build configs.`;
+  if (cause === void 0) {
+    throw new Error(message);
+  }
+  throw new Error(message, { cause });
+}
 export {
   addRule,
   bitmaskToHash,

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/api/rule-helpers.ts","../src/hash.ts","../src/loader.ts"],"sourcesContent":["/* eslint-disable max-params, complexity -- Public API: config + ruleName + severity + options is the natural signature. Options objects would hurt ergonomics for one-liner calls. */\nimport type { Linter } from \"eslint\"\n\nimport type {\n  FlatConfigArray,\n  RuleOptions,\n  RuleSeverity,\n} from \"../types\"\n\nconst CONFIG_PREFIX = \"eslint-config-setup/\"\n\n/** Maps user-facing scope names to config block name segments. */\nconst SCOPE_TO_BLOCK: Record<string, string> = {\n  configs: \"config-files\",\n}\n\n/**\n * Check if a config block matches a given scope.\n * A block matches if its name is `eslint-config-setup/{segment}` or starts with `eslint-config-setup/{segment}-`.\n */\nfunction blockMatchesScope(\n  block: Linter.Config,\n  scope: string,\n): boolean {\n  const name = block.name\n  if (name == null) return false\n  const segment = SCOPE_TO_BLOCK[scope] ?? scope\n  const target = `${CONFIG_PREFIX}${segment}`\n  return name === target || name.startsWith(`${target}-`)\n}\n\n/**\n * Change the severity of a rule across all config blocks, preserving options.\n */\nexport function setRuleSeverity(\n  config: FlatConfigArray,\n  ruleName: string,\n  severity: RuleSeverity,\n  options?: RuleOptions,\n): void {\n  for (const block of config) {\n    if (options?.scope !== undefined && !blockMatchesScope(block, options.scope)) continue\n    if (block.rules?.[ruleName] == null) continue\n\n    const current = block.rules[ruleName]\n    if (Array.isArray(current)) {\n      block.rules[ruleName] = [severity, ...current.slice(1)] as Linter.RuleEntry\n    } else {\n      block.rules[ruleName] = severity\n    }\n  }\n}\n\n/**\n * Update the options of a rule across all config blocks, preserving severity.\n */\nexport function configureRule(\n  config: FlatConfigArray,\n  ruleName: string,\n  options: unknown[],\n  ruleOptions?: RuleOptions,\n): void {\n  for (const block of config) {\n    if (ruleOptions?.scope !== undefined && !blockMatchesScope(block, ruleOptions.scope))\n      continue\n    if (block.rules?.[ruleName] == null) continue\n\n    const current = block.rules[ruleName]\n    const severity = Array.isArray(current) ? current[0] : current\n    block.rules[ruleName] = [severity, ...options] as Linter.RuleEntry\n  }\n}\n\n/**\n * Completely disable a rule across all config blocks.\n * With scope: disables in the first matching block (creates entry if needed).\n */\nexport function disableRule(\n  config: FlatConfigArray,\n  ruleName: string,\n  options?: RuleOptions,\n): void {\n  if (options?.scope != null) {\n    const { scope } = options\n    const block = config.find((b) => blockMatchesScope(b, scope))\n    if (!block) return\n    block.rules ??= {}\n    block.rules[ruleName] = \"off\"\n    return\n  }\n\n  for (const block of config) {\n    if (block.rules?.[ruleName] == null) continue\n    block.rules[ruleName] = \"off\"\n  }\n}\n\n/**\n * Add a new rule to the first (base) config block.\n * With scope: adds to the first matching block instead.\n */\nexport function addRule(\n  config: FlatConfigArray,\n  ruleName: string,\n  severity: RuleSeverity,\n  options?: RuleOptions | unknown[],\n  ruleOptions?: RuleOptions,\n): void {\n  // Handle overloaded signatures: addRule(config, rule, severity, options?, ruleOptions?)\n  // When options is a plain object with scope, it's actually ruleOptions\n  let ruleOpts: undefined | unknown[]\n  let scopeOpts: RuleOptions | undefined\n\n  if (Array.isArray(options)) {\n    ruleOpts = options\n    scopeOpts = ruleOptions\n  } else if (options && typeof options === \"object\" && \"scope\" in options) {\n    scopeOpts = options\n  } else if (options === undefined) {\n    scopeOpts = ruleOptions\n  }\n\n  let target: Linter.Config | undefined\n  if (scopeOpts?.scope != null) {\n    const { scope } = scopeOpts\n    target = config.find((b) => blockMatchesScope(b, scope))\n  } else {\n    target = config[0]\n  }\n\n  if (!target) return\n\n  target.rules ??= {}\n  target.rules[ruleName] = ruleOpts\n    ? ([severity, ...ruleOpts] as Linter.RuleEntry)\n    : severity\n}\n\n/**\n * Disable all rules except the specified one — useful for debugging.\n */\nexport function disableAllRulesBut(\n  config: FlatConfigArray,\n  keepRuleName: string,\n): void {\n  for (const block of config) {\n    if (!block.rules) continue\n    for (const ruleName of Object.keys(block.rules)) {\n      if (ruleName !== keepRuleName) {\n        block.rules[ruleName] = \"off\"\n      }\n    }\n  }\n}\n","import { createHash } from \"node:crypto\"\n\nimport type { ConfigOptions, OxlintConfigOptions } from \"./types\"\n\n/**\n * Converts config options to a deterministic bitmask.\n * Bit order is fixed and must never change (would break published configs).\n */\nexport function optionsToBitmask(opts: ConfigOptions): number {\n  let mask = 0\n  if (opts.react) mask |= 1 << 0\n  if (opts.node) mask |= 1 << 1\n  if (opts.ai) mask |= 1 << 2\n  if (opts.oxlint) mask |= 1 << 3\n  return mask\n}\n\n/**\n * Converts a bitmask to a short deterministic hash (8 hex chars).\n * The same hash is produced at build-time (generate) and run-time (getConfig).\n */\nexport function bitmaskToHash(mask: number): string {\n  const input = `effective-eslint-config:${mask}`\n  return createHash(\"sha1\").update(input).digest(\"hex\").slice(0, 8)\n}\n\n/** Convenience: options → filename (without path prefix). */\nexport function optionsToFilename(opts: ConfigOptions): string {\n  return `${bitmaskToHash(optionsToBitmask(opts))}.js`\n}\n\n/** Total number of permutations (2^4 = 16). */\nexport const TOTAL_PERMUTATIONS = 16\n\n/** Iterate all possible option combinations. */\nexport function* allPermutations(): Generator<ConfigOptions> {\n  for (let mask = 0; mask < TOTAL_PERMUTATIONS; mask++) {\n    yield {\n      react: Boolean(mask & (1 << 0)),\n      node: Boolean(mask & (1 << 1)),\n      ai: Boolean(mask & (1 << 2)),\n      oxlint: Boolean(mask & (1 << 3)),\n    }\n  }\n}\n\n// --- OxLint config permutations (3 flags → 8 combos) ---\n\n/** Converts OxLint-relevant options to a 3-bit bitmask (react, node, ai). */\nexport function oxlintOptionsToBitmask(opts: OxlintConfigOptions): number {\n  let mask = 0\n  if (opts.react) mask |= 1 << 0\n  if (opts.node) mask |= 1 << 1\n  if (opts.ai) mask |= 1 << 2\n  return mask\n}\n\n/** Deterministic hash for OxLint configs (different salt to avoid collisions). */\nexport function oxlintBitmaskToHash(mask: number): string {\n  const input = `eslint-config-setup-oxlint:${mask}`\n  return createHash(\"sha1\").update(input).digest(\"hex\").slice(0, 8)\n}\n\n/** OxLint options → filename (without path prefix). */\nexport function oxlintOptionsToFilename(opts: OxlintConfigOptions): string {\n  return `${oxlintBitmaskToHash(oxlintOptionsToBitmask(opts))}.json`\n}\n\n/** Total number of OxLint permutations (2^3 = 8). */\nexport const TOTAL_OXLINT_PERMUTATIONS = 8\n\n/** Iterate all OxLint option combinations. */\nexport function* allOxlintPermutations(): Generator<OxlintConfigOptions> {\n  for (let mask = 0; mask < TOTAL_OXLINT_PERMUTATIONS; mask++) {\n    yield {\n      react: Boolean(mask & (1 << 0)),\n      node: Boolean(mask & (1 << 1)),\n      ai: Boolean(mask & (1 << 2)),\n    }\n  }\n}\n","/* eslint-disable security/detect-non-literal-fs-filename, @typescript-eslint/no-unsafe-type-assertion -- Paths are computed from deterministic hashes in dist/, not from user input. */\nimport { readFileSync } from \"node:fs\"\nimport path from \"node:path\"\n\nimport type { ConfigOptions, FlatConfigArray, OxlintConfigOptions, OxlintConfigResult } from \"./types\"\n\nimport { optionsToFilename, oxlintOptionsToFilename } from \"./hash\"\n\n/**\n * Loads a pre-generated ESLint config by dynamically importing the hashed file.\n * The hash is computed from the options using the same algorithm as the build.\n */\nexport async function getEslintConfig(\n  opts: ConfigOptions = {},\n): Promise<FlatConfigArray> {\n  const filename = optionsToFilename(opts)\n  const dirname = import.meta.dirname\n  const configPath = path.join(dirname, \"configs\", filename)\n\n  try {\n    const module = (await import(\n      /* webpackIgnore: true */\n      `${configPath}?${Date.now()}`\n    )) as { default: FlatConfigArray }\n    return module.default\n  } catch {\n    throw new Error(\n      `eslint-config-setup: No pre-generated config found for options ${JSON.stringify(opts)}. ` +\n        `Expected file: configs/${filename}. Run \"npm run generate\" in the package to build configs.`,\n    )\n  }\n}\n\n/**\n * Loads a pre-generated OxLint config from the hashed JSON file.\n * Only `react`, `node`, and `ai` flags are relevant — `oxlint` is ignored.\n */\nexport function getOxlintConfig(\n  opts: OxlintConfigOptions = {},\n): OxlintConfigResult {\n  const filename = oxlintOptionsToFilename(opts)\n  const dirname = import.meta.dirname\n  const configPath = path.join(dirname, \"oxlint-configs\", filename)\n\n  try {\n    const content = readFileSync(configPath, \"utf8\")\n    return JSON.parse(content) as OxlintConfigResult\n  } catch {\n    throw new Error(\n      `eslint-config-setup: No pre-generated OxLint config found for options ${JSON.stringify(opts)}. ` +\n        `Expected file: oxlint-configs/${filename}. Run \"npm run generate\" in the package to build configs.`,\n    )\n  }\n}\n"],"mappings":";AASA,IAAM,gBAAgB;AAGtB,IAAM,iBAAyC;AAAA,EAC7C,SAAS;AACX;AAMA,SAAS,kBACP,OACA,OACS;AACT,QAAM,OAAO,MAAM;AACnB,MAAI,QAAQ,KAAM,QAAO;AACzB,QAAM,UAAU,eAAe,KAAK,KAAK;AACzC,QAAM,SAAS,GAAG,aAAa,GAAG,OAAO;AACzC,SAAO,SAAS,UAAU,KAAK,WAAW,GAAG,MAAM,GAAG;AACxD;AAKO,SAAS,gBACd,QACA,UACA,UACA,SACM;AACN,aAAW,SAAS,QAAQ;AAC1B,QAAI,SAAS,UAAU,UAAa,CAAC,kBAAkB,OAAO,QAAQ,KAAK,EAAG;AAC9E,QAAI,MAAM,QAAQ,QAAQ,KAAK,KAAM;AAErC,UAAM,UAAU,MAAM,MAAM,QAAQ;AACpC,QAAI,MAAM,QAAQ,OAAO,GAAG;AAC1B,YAAM,MAAM,QAAQ,IAAI,CAAC,UAAU,GAAG,QAAQ,MAAM,CAAC,CAAC;AAAA,IACxD,OAAO;AACL,YAAM,MAAM,QAAQ,IAAI;AAAA,IAC1B;AAAA,EACF;AACF;AAKO,SAAS,cACd,QACA,UACA,SACA,aACM;AACN,aAAW,SAAS,QAAQ;AAC1B,QAAI,aAAa,UAAU,UAAa,CAAC,kBAAkB,OAAO,YAAY,KAAK;AACjF;AACF,QAAI,MAAM,QAAQ,QAAQ,KAAK,KAAM;AAErC,UAAM,UAAU,MAAM,MAAM,QAAQ;AACpC,UAAM,WAAW,MAAM,QAAQ,OAAO,IAAI,QAAQ,CAAC,IAAI;AACvD,UAAM,MAAM,QAAQ,IAAI,CAAC,UAAU,GAAG,OAAO;AAAA,EAC/C;AACF;AAMO,SAAS,YACd,QACA,UACA,SACM;AACN,MAAI,SAAS,SAAS,MAAM;AAC1B,UAAM,EAAE,MAAM,IAAI;AAClB,UAAM,QAAQ,OAAO,KAAK,CAAC,MAAM,kBAAkB,GAAG,KAAK,CAAC;AAC5D,QAAI,CAAC,MAAO;AACZ,UAAM,UAAU,CAAC;AACjB,UAAM,MAAM,QAAQ,IAAI;AACxB;AAAA,EACF;AAEA,aAAW,SAAS,QAAQ;AAC1B,QAAI,MAAM,QAAQ,QAAQ,KAAK,KAAM;AACrC,UAAM,MAAM,QAAQ,IAAI;AAAA,EAC1B;AACF;AAMO,SAAS,QACd,QACA,UACA,UACA,SACA,aACM;AAGN,MAAI;AACJ,MAAI;AAEJ,MAAI,MAAM,QAAQ,OAAO,GAAG;AAC1B,eAAW;AACX,gBAAY;AAAA,EACd,WAAW,WAAW,OAAO,YAAY,YAAY,WAAW,SAAS;AACvE,gBAAY;AAAA,EACd,WAAW,YAAY,QAAW;AAChC,gBAAY;AAAA,EACd;AAEA,MAAI;AACJ,MAAI,WAAW,SAAS,MAAM;AAC5B,UAAM,EAAE,MAAM,IAAI;AAClB,aAAS,OAAO,KAAK,CAAC,MAAM,kBAAkB,GAAG,KAAK,CAAC;AAAA,EACzD,OAAO;AACL,aAAS,OAAO,CAAC;AAAA,EACnB;AAEA,MAAI,CAAC,OAAQ;AAEb,SAAO,UAAU,CAAC;AAClB,SAAO,MAAM,QAAQ,IAAI,WACpB,CAAC,UAAU,GAAG,QAAQ,IACvB;AACN;AAKO,SAAS,mBACd,QACA,cACM;AACN,aAAW,SAAS,QAAQ;AAC1B,QAAI,CAAC,MAAM,MAAO;AAClB,eAAW,YAAY,OAAO,KAAK,MAAM,KAAK,GAAG;AAC/C,UAAI,aAAa,cAAc;AAC7B,cAAM,MAAM,QAAQ,IAAI;AAAA,MAC1B;AAAA,IACF;AAAA,EACF;AACF;;;ACzJA,SAAS,kBAAkB;AAQpB,SAAS,iBAAiB,MAA6B;AAC5D,MAAI,OAAO;AACX,MAAI,KAAK,MAAO,SAAQ,KAAK;AAC7B,MAAI,KAAK,KAAM,SAAQ,KAAK;AAC5B,MAAI,KAAK,GAAI,SAAQ,KAAK;AAC1B,MAAI,KAAK,OAAQ,SAAQ,KAAK;AAC9B,SAAO;AACT;AAMO,SAAS,cAAc,MAAsB;AAClD,QAAM,QAAQ,2BAA2B,IAAI;AAC7C,SAAO,WAAW,MAAM,EAAE,OAAO,KAAK,EAAE,OAAO,KAAK,EAAE,MAAM,GAAG,CAAC;AAClE;AAGO,SAAS,kBAAkB,MAA6B;AAC7D,SAAO,GAAG,cAAc,iBAAiB,IAAI,CAAC,CAAC;AACjD;AAoBO,SAAS,uBAAuB,MAAmC;AACxE,MAAI,OAAO;AACX,MAAI,KAAK,MAAO,SAAQ,KAAK;AAC7B,MAAI,KAAK,KAAM,SAAQ,KAAK;AAC5B,MAAI,KAAK,GAAI,SAAQ,KAAK;AAC1B,SAAO;AACT;AAGO,SAAS,oBAAoB,MAAsB;AACxD,QAAM,QAAQ,8BAA8B,IAAI;AAChD,SAAO,WAAW,MAAM,EAAE,OAAO,KAAK,EAAE,OAAO,KAAK,EAAE,MAAM,GAAG,CAAC;AAClE;AAGO,SAAS,wBAAwB,MAAmC;AACzE,SAAO,GAAG,oBAAoB,uBAAuB,IAAI,CAAC,CAAC;AAC7D;;;ACjEA,SAAS,oBAAoB;AAC7B,OAAO,UAAU;AAUjB,eAAsB,gBACpB,OAAsB,CAAC,GACG;AAC1B,QAAM,WAAW,kBAAkB,IAAI;AACvC,QAAM,UAAU,YAAY;AAC5B,QAAM,aAAa,KAAK,KAAK,SAAS,WAAW,QAAQ;AAEzD,MAAI;AACF,UAAM,SAAU,MAAM;AAAA;AAAA,MAEpB,GAAG,UAAU,IAAI,KAAK,IAAI,CAAC;AAAA;AAE7B,WAAO,OAAO;AAAA,EAChB,QAAQ;AACN,UAAM,IAAI;AAAA,MACR,kEAAkE,KAAK,UAAU,IAAI,CAAC,4BAC1D,QAAQ;AAAA,IACtC;AAAA,EACF;AACF;AAMO,SAAS,gBACd,OAA4B,CAAC,GACT;AACpB,QAAM,WAAW,wBAAwB,IAAI;AAC7C,QAAM,UAAU,YAAY;AAC5B,QAAM,aAAa,KAAK,KAAK,SAAS,kBAAkB,QAAQ;AAEhE,MAAI;AACF,UAAM,UAAU,aAAa,YAAY,MAAM;AAC/C,WAAO,KAAK,MAAM,OAAO;AAAA,EAC3B,QAAQ;AACN,UAAM,IAAI;AAAA,MACR,yEAAyE,KAAK,UAAU,IAAI,CAAC,mCAC1D,QAAQ;AAAA,IAC7C;AAAA,EACF;AACF;","names":[]}
+{"version":3,"sources":["../src/api/rule-helpers.ts","../src/hash.ts","../src/loader.ts"],"sourcesContent":["/* eslint-disable max-params, complexity -- Public API: config + ruleName + severity + options is the natural signature. Options objects would hurt ergonomics for one-liner calls. */\nimport type { Linter } from \"eslint\"\n\nimport type {\n  FlatConfigArray,\n  RuleOptions,\n  RuleSeverity,\n} from \"../types\"\n\nconst CONFIG_PREFIX = \"eslint-config-setup/\"\n\n/** Maps user-facing scope names to config block name segments. */\nconst SCOPE_TO_BLOCK: Record<string, string> = {\n  configs: \"config-files\",\n}\n\n/**\n * Check if a config block matches a given scope.\n * A block matches if its name is `eslint-config-setup/{segment}` or starts with `eslint-config-setup/{segment}-`.\n */\nfunction blockMatchesScope(\n  block: Linter.Config,\n  scope: string,\n): boolean {\n  const name = block.name\n  if (name == null) return false\n  const segment = SCOPE_TO_BLOCK[scope] ?? scope\n  const target = `${CONFIG_PREFIX}${segment}`\n  return name === target || name.startsWith(`${target}-`)\n}\n\n/**\n * Change the severity of a rule across all config blocks, preserving options.\n */\nexport function setRuleSeverity(\n  config: FlatConfigArray,\n  ruleName: string,\n  severity: RuleSeverity,\n  options?: RuleOptions,\n): void {\n  for (const block of config) {\n    if (options?.scope !== undefined && !blockMatchesScope(block, options.scope)) continue\n    if (block.rules?.[ruleName] == null) continue\n\n    const current = block.rules[ruleName]\n    if (Array.isArray(current)) {\n      block.rules[ruleName] = [severity, ...current.slice(1)] as Linter.RuleEntry\n    } else {\n      block.rules[ruleName] = severity\n    }\n  }\n}\n\n/**\n * Update the options of a rule across all config blocks, preserving severity.\n */\nexport function configureRule(\n  config: FlatConfigArray,\n  ruleName: string,\n  options: unknown[],\n  ruleOptions?: RuleOptions,\n): void {\n  for (const block of config) {\n    if (ruleOptions?.scope !== undefined && !blockMatchesScope(block, ruleOptions.scope))\n      continue\n    if (block.rules?.[ruleName] == null) continue\n\n    const current = block.rules[ruleName]\n    const severity = Array.isArray(current) ? current[0] : current\n    block.rules[ruleName] = [severity, ...options] as Linter.RuleEntry\n  }\n}\n\n/**\n * Completely disable a rule across all config blocks.\n * With scope: disables in the first matching block (creates entry if needed).\n */\nexport function disableRule(\n  config: FlatConfigArray,\n  ruleName: string,\n  options?: RuleOptions,\n): void {\n  if (options?.scope != null) {\n    const { scope } = options\n    const block = config.find((b) => blockMatchesScope(b, scope))\n    if (!block) return\n    block.rules ??= {}\n    block.rules[ruleName] = \"off\"\n    return\n  }\n\n  for (const block of config) {\n    if (block.rules?.[ruleName] == null) continue\n    block.rules[ruleName] = \"off\"\n  }\n}\n\n/**\n * Add a new rule to the first (base) config block.\n * With scope: adds to the first matching block instead.\n */\nexport function addRule(\n  config: FlatConfigArray,\n  ruleName: string,\n  severity: RuleSeverity,\n  options?: RuleOptions | unknown[],\n  ruleOptions?: RuleOptions,\n): void {\n  // Handle overloaded signatures: addRule(config, rule, severity, options?, ruleOptions?)\n  // When options is a plain object with scope, it's actually ruleOptions\n  let ruleOpts: undefined | unknown[]\n  let scopeOpts: RuleOptions | undefined\n\n  if (Array.isArray(options)) {\n    ruleOpts = options\n    scopeOpts = ruleOptions\n  } else if (options && typeof options === \"object\" && \"scope\" in options) {\n    scopeOpts = options\n  } else if (options === undefined) {\n    scopeOpts = ruleOptions\n  }\n\n  let target: Linter.Config | undefined\n  if (scopeOpts?.scope != null) {\n    const { scope } = scopeOpts\n    target = config.find((b) => blockMatchesScope(b, scope))\n  } else {\n    target = config[0]\n  }\n\n  if (!target) return\n\n  target.rules ??= {}\n  target.rules[ruleName] = ruleOpts\n    ? ([severity, ...ruleOpts] as Linter.RuleEntry)\n    : severity\n}\n\n/**\n * Disable all rules except the specified one — useful for debugging.\n */\nexport function disableAllRulesBut(\n  config: FlatConfigArray,\n  keepRuleName: string,\n): void {\n  for (const block of config) {\n    if (!block.rules) continue\n    for (const ruleName of Object.keys(block.rules)) {\n      if (ruleName !== keepRuleName) {\n        block.rules[ruleName] = \"off\"\n      }\n    }\n  }\n}\n","import { createHash } from \"node:crypto\"\n\nimport type { ConfigOptions, OxlintConfigOptions } from \"./types\"\n\n/**\n * Converts config options to a deterministic bitmask.\n * Bit order is fixed and must never change (would break published configs).\n */\nexport function optionsToBitmask(opts: ConfigOptions): number {\n  let mask = 0\n  if (opts.react) mask |= 1 << 0\n  if (opts.node) mask |= 1 << 1\n  if (opts.ai) mask |= 1 << 2\n  if (opts.oxlint) mask |= 1 << 3\n  return mask\n}\n\n/**\n * Converts a bitmask to a short deterministic hash (8 hex chars).\n * The same hash is produced at build-time (generate) and run-time (getConfig).\n */\nexport function bitmaskToHash(mask: number): string {\n  const input = `effective-eslint-config:${mask}`\n  return createHash(\"sha1\").update(input).digest(\"hex\").slice(0, 8)\n}\n\n/** Convenience: options → filename (without path prefix). */\nexport function optionsToFilename(opts: ConfigOptions): string {\n  return `${bitmaskToHash(optionsToBitmask(opts))}.js`\n}\n\n/** Total number of permutations (2^4 = 16). */\nexport const TOTAL_PERMUTATIONS = 16\n\n/** Iterate all possible option combinations. */\nexport function* allPermutations(): Generator<ConfigOptions> {\n  for (let mask = 0; mask < TOTAL_PERMUTATIONS; mask++) {\n    yield {\n      react: Boolean(mask & (1 << 0)),\n      node: Boolean(mask & (1 << 1)),\n      ai: Boolean(mask & (1 << 2)),\n      oxlint: Boolean(mask & (1 << 3)),\n    }\n  }\n}\n\n// --- OxLint config permutations (3 flags → 8 combos) ---\n\n/** Converts OxLint-relevant options to a 3-bit bitmask (react, node, ai). */\nexport function oxlintOptionsToBitmask(opts: OxlintConfigOptions): number {\n  let mask = 0\n  if (opts.react) mask |= 1 << 0\n  if (opts.node) mask |= 1 << 1\n  if (opts.ai) mask |= 1 << 2\n  return mask\n}\n\n/** Deterministic hash for OxLint configs (different salt to avoid collisions). */\nexport function oxlintBitmaskToHash(mask: number): string {\n  const input = `eslint-config-setup-oxlint:${mask}`\n  return createHash(\"sha1\").update(input).digest(\"hex\").slice(0, 8)\n}\n\n/** OxLint options → filename (without path prefix). */\nexport function oxlintOptionsToFilename(opts: OxlintConfigOptions): string {\n  return `${oxlintBitmaskToHash(oxlintOptionsToBitmask(opts))}.json`\n}\n\n/** Total number of OxLint permutations (2^3 = 8). */\nexport const TOTAL_OXLINT_PERMUTATIONS = 8\n\n/** Iterate all OxLint option combinations. */\nexport function* allOxlintPermutations(): Generator<OxlintConfigOptions> {\n  for (let mask = 0; mask < TOTAL_OXLINT_PERMUTATIONS; mask++) {\n    yield {\n      react: Boolean(mask & (1 << 0)),\n      node: Boolean(mask & (1 << 1)),\n      ai: Boolean(mask & (1 << 2)),\n    }\n  }\n}\n","/* eslint-disable security/detect-non-literal-fs-filename, @typescript-eslint/no-unsafe-type-assertion -- Paths are computed from deterministic hashes in dist/, not from user input. */\nimport { existsSync, readFileSync } from \"node:fs\"\nimport path from \"node:path\"\nimport { pathToFileURL } from \"node:url\"\n\nimport type { ConfigOptions, FlatConfigArray, OxlintConfigOptions, OxlintConfigResult } from \"./types\"\n\nimport { optionsToFilename, oxlintOptionsToFilename } from \"./hash\"\n\n/**\n * Loads a pre-generated ESLint config by dynamically importing the hashed file.\n * The hash is computed from the options using the same algorithm as the build.\n */\nexport async function getEslintConfig(\n  opts: ConfigOptions = {},\n): Promise<FlatConfigArray> {\n  const filename = optionsToFilename(opts)\n  const dirname = import.meta.dirname\n  const configPath = path.join(dirname, \"configs\", filename)\n\n  if (!existsSync(configPath)) {\n    throwMissingConfigError(opts, filename)\n  }\n\n  const configUrl = pathToFileURL(configPath)\n  configUrl.search = String(Date.now())\n\n  try {\n    const module = (await import(\n      /* webpackIgnore: true */\n      configUrl.href\n    )) as { default: FlatConfigArray }\n    return module.default\n  } catch (error) {\n    if (!existsSync(configPath)) {\n      throwMissingConfigError(opts, filename, error)\n    }\n\n    throw new Error(\n      `eslint-config-setup: Pre-generated config failed to load for options ${JSON.stringify(opts)}. ` +\n        `Expected file: configs/${filename}. Original error: ${getErrorMessage(error)}`,\n      { cause: error },\n    )\n  }\n}\n\n/**\n * Loads a pre-generated OxLint config from the hashed JSON file.\n * Only `react`, `node`, and `ai` flags are relevant — `oxlint` is ignored.\n */\nexport function getOxlintConfig(\n  opts: OxlintConfigOptions = {},\n): OxlintConfigResult {\n  const filename = oxlintOptionsToFilename(opts)\n  const dirname = import.meta.dirname\n  const configPath = path.join(dirname, \"oxlint-configs\", filename)\n\n  try {\n    const content = readFileSync(configPath, \"utf8\")\n    return JSON.parse(content) as OxlintConfigResult\n  } catch {\n    throw new Error(\n      `eslint-config-setup: No pre-generated OxLint config found for options ${JSON.stringify(opts)}. ` +\n        `Expected file: oxlint-configs/${filename}. Run \"npm run generate\" in the package to build configs.`,\n    )\n  }\n}\n\nfunction getErrorMessage(error: unknown): string {\n  return error instanceof Error ? error.message : String(error)\n}\n\nfunction throwMissingConfigError(\n  opts: ConfigOptions,\n  filename: string,\n  cause?: unknown,\n): never {\n  const message =\n    `eslint-config-setup: No pre-generated config found for options ${JSON.stringify(opts)}. ` +\n    `Expected file: configs/${filename}. Run \"npm run generate\" in the package to build configs.`\n\n  if (cause === undefined) {\n    throw new Error(message)\n  }\n\n  throw new Error(message, { cause })\n}\n"],"mappings":"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","names":[]}

package/dist/modules.d.ts

@@ -161,16 +161,18 @@ declare function prettierCompatConfig(): FlatConfigArray;
 /**
  * React config — React 19+, Hooks, JSX accessibility, and Web API leak detection.
  *
- * Uses `@eslint-react` (eslint-plugin-react-x) as the primary React linting plugin,
- * replacing the unmaintained eslint-plugin-react. All rules — including DOM, Web API,
- * naming-convention, and RSC sub-plugins — are registered under a single `react/`
- * namespace via the react-compat plugin for maximum OxLint compatibility.
+ * Uses `@eslint-react` (eslint-plugin-react-x) for React, DOM, Web API,
+ * naming-convention, and RSC rules under the `react/` compat namespace.
+ * Rules of Hooks and React Compiler linting come from Meta's
+ * eslint-plugin-react-hooks under the native `react-hooks/` namespace.
  *
- * Base rule severities come from the `recommended` + `strict` presets via
- * `createConfig`. When `ai: true`, preset "warn" rules that AI should always
- * get right are promoted to "error" — validated at build time.
+ * Base React severities come from the `@eslint-react` `strict-type-checked` preset.
+ * When `ai: true`, preset "warn" rules that AI should always get right are
+ * promoted to "error", and React performance rules are enabled as errors.
  *
  * @see https://eslint-react.xyz/docs/rules/overview
+ * @see https://www.npmjs.com/package/eslint-plugin-react-hooks
+ * @see https://github.com/cvazac/eslint-plugin-react-perf
  * @see https://github.com/ArnaudBarre/eslint-plugin-react-refresh
  * @see https://github.com/jsx-eslint/eslint-plugin-jsx-a11y#supported-rules
  */