eslint-config-setup 0.3.2 → 0.4.0

package/dist/index.js

@@ -1,70 +1,3 @@
-// src/loader.ts
-import { readFileSync } from "fs";
-import path from "path";
-
-// src/hash.ts
-import { createHash } from "crypto";
-function optionsToBitmask(opts) {
-  let mask = 0;
-  if (opts.react) mask |= 1 << 0;
-  if (opts.node) mask |= 1 << 1;
-  if (opts.ai) mask |= 1 << 2;
-  if (opts.oxlint) mask |= 1 << 3;
-  return mask;
-}
-function bitmaskToHash(mask) {
-  const input = `effective-eslint-config:${mask}`;
-  return createHash("sha1").update(input).digest("hex").slice(0, 8);
-}
-function optionsToFilename(opts) {
-  return `${bitmaskToHash(optionsToBitmask(opts))}.js`;
-}
-function oxlintOptionsToBitmask(opts) {
-  let mask = 0;
-  if (opts.react) mask |= 1 << 0;
-  if (opts.node) mask |= 1 << 1;
-  if (opts.ai) mask |= 1 << 2;
-  return mask;
-}
-function oxlintBitmaskToHash(mask) {
-  const input = `eslint-config-setup-oxlint:${mask}`;
-  return createHash("sha1").update(input).digest("hex").slice(0, 8);
-}
-function oxlintOptionsToFilename(opts) {
-  return `${oxlintBitmaskToHash(oxlintOptionsToBitmask(opts))}.json`;
-}
-
-// src/loader.ts
-async function getEslintConfig(opts = {}) {
-  const filename = optionsToFilename(opts);
-  const dirname = import.meta.dirname;
-  const configPath = path.join(dirname, "configs", filename);
-  try {
-    const module = await import(
-      /* webpackIgnore: true */
-      `${configPath}?${Date.now()}`
-    );
-    return module.default;
-  } catch {
-    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.`
-    );
-  }
-}
-function getOxlintConfig(opts = {}) {
-  const filename = oxlintOptionsToFilename(opts);
-  const dirname = import.meta.dirname;
-  const configPath = path.join(dirname, "oxlint-configs", filename);
-  try {
-    const content = readFileSync(configPath, "utf8");
-    return JSON.parse(content);
-  } catch {
-    throw new Error(
-      `eslint-config-setup: No pre-generated OxLint config found for options ${JSON.stringify(opts)}. Expected file: oxlint-configs/${filename}. Run "npm run generate" in the package to build configs.`
-    );
-  }
-}
-
 // src/api/rule-helpers.ts
 var CONFIG_PREFIX = "eslint-config-setup/";
 var SCOPE_TO_BLOCK = {
@@ -145,6 +78,71 @@ function disableAllRulesBut(config, keepRuleName) {
     }
   }
 }
+
+// src/hash.ts
+import { createHash } from "crypto";
+function optionsToBitmask(opts) {
+  let mask = 0;
+  if (opts.react) mask |= 1 << 0;
+  if (opts.node) mask |= 1 << 1;
+  if (opts.ai) mask |= 1 << 2;
+  if (opts.oxlint) mask |= 1 << 3;
+  return mask;
+}
+function bitmaskToHash(mask) {
+  const input = `effective-eslint-config:${mask}`;
+  return createHash("sha1").update(input).digest("hex").slice(0, 8);
+}
+function optionsToFilename(opts) {
+  return `${bitmaskToHash(optionsToBitmask(opts))}.js`;
+}
+function oxlintOptionsToBitmask(opts) {
+  let mask = 0;
+  if (opts.react) mask |= 1 << 0;
+  if (opts.node) mask |= 1 << 1;
+  if (opts.ai) mask |= 1 << 2;
+  return mask;
+}
+function oxlintBitmaskToHash(mask) {
+  const input = `eslint-config-setup-oxlint:${mask}`;
+  return createHash("sha1").update(input).digest("hex").slice(0, 8);
+}
+function oxlintOptionsToFilename(opts) {
+  return `${oxlintBitmaskToHash(oxlintOptionsToBitmask(opts))}.json`;
+}
+
+// src/loader.ts
+import { readFileSync } from "fs";
+import path from "path";
+async function getEslintConfig(opts = {}) {
+  const filename = optionsToFilename(opts);
+  const dirname = import.meta.dirname;
+  const configPath = path.join(dirname, "configs", filename);
+  try {
+    const module = await import(
+      /* webpackIgnore: true */
+      `${configPath}?${Date.now()}`
+    );
+    return module.default;
+  } catch {
+    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.`
+    );
+  }
+}
+function getOxlintConfig(opts = {}) {
+  const filename = oxlintOptionsToFilename(opts);
+  const dirname = import.meta.dirname;
+  const configPath = path.join(dirname, "oxlint-configs", filename);
+  try {
+    const content = readFileSync(configPath, "utf8");
+    return JSON.parse(content);
+  } catch {
+    throw new Error(
+      `eslint-config-setup: No pre-generated OxLint config found for options ${JSON.stringify(opts)}. Expected file: oxlint-configs/${filename}. Run "npm run generate" in the package to build configs.`
+    );
+  }
+}
 export {
   addRule,
   bitmaskToHash,

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/loader.ts","../src/hash.ts","../src/api/rule-helpers.ts"],"sourcesContent":["/* eslint-disable security/detect-non-literal-fs-filename -- 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","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 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"],"mappings":"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","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 { 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":"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","names":[]}

package/dist/modules.d.ts

@@ -1,21 +1,9 @@
-import { F as FlatConfigArray, C as ConfigOptions } from './types-CAUUIuJR.js';
+import { C as ConfigOptions, F as FlatConfigArray } from './types-CAO1PbsB.js';
 import 'eslint';
 
-/**
- * AI mode rules — strict clean-code rules that are trivial for AI assistants
- * to follow but produce significantly more maintainable code.
- *
- * These rules would traditionally be considered "too strict" for humans,
- * but since most code is now AI-generated, they serve as effective
- * guardrails that the AI cannot ignore (unlike documentation).
- *
- * No plugin preset is used — all rules are hand-picked from existing plugins
- * and tightened beyond their defaults for AI-generated code.
- * @see ADR-0006: docs/adr/0006-ai-mode-as-dedicated-flag.md
- */
-declare function aiConfig(opts?: {
-    react?: boolean;
-}): FlatConfigArray;
+declare function composeConfig(opts: ConfigOptions): FlatConfigArray;
+
+declare function aiConfig(): FlatConfigArray;
 
 /**
  * Base ESLint config — extends `eslint.configs.recommended` with additional
@@ -27,7 +15,9 @@ declare function aiConfig(opts?: {
  * Preset: `@eslint/js` recommended
  * @see https://eslint.org/docs/latest/rules/
  */
-declare function baseConfig(): FlatConfigArray;
+declare function baseConfig(opts?: {
+    ai?: boolean;
+}): FlatConfigArray;
 
 /**
  * CSpell config — spell checking for identifiers and comments.
@@ -72,7 +62,9 @@ declare function importsConfig(): FlatConfigArray;
  * - param/return descriptions downgraded to warn — helpful but not blocking
  * @see https://github.com/gajus/eslint-plugin-jsdoc#rules
  */
-declare function jsdocConfig(): FlatConfigArray;
+declare function jsdocConfig(opts?: {
+    ai?: boolean;
+}): FlatConfigArray;
 
 /**
  * JSON/JSONC config — native JSON linting using the official `@eslint/json` plugin.
@@ -103,7 +95,9 @@ declare function markdownConfig(): FlatConfigArray;
  *
  * @see https://github.com/eslint-community/eslint-plugin-n#-rules
  */
-declare function nodeConfig(): FlatConfigArray;
+declare function nodeConfig(opts?: {
+    ai?: boolean;
+}): FlatConfigArray;
 
 /**
  * Package.json config — semantic validation of package.json files.
@@ -168,19 +162,21 @@ 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. Plugins are registered under
- * familiar namespaces (`react/`, `react-dom/`, `react-hooks/`) for compatibility
- * with OxLint and user overrides — the same pattern used for `import` (import-x)
- * and `node` (eslint-plugin-n).
+ * 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.
  *
- * Stylistic JSX rules (self-closing, curly braces) are provided by `@stylistic`.
+ * 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.
  *
  * @see https://eslint-react.xyz/docs/rules/overview
- * @see https://github.com/facebook/react/tree/main/packages/eslint-plugin-react-hooks
  * @see https://github.com/ArnaudBarre/eslint-plugin-react-refresh
  * @see https://github.com/jsx-eslint/eslint-plugin-jsx-a11y#supported-rules
  */
-declare function reactConfig(): FlatConfigArray;
+declare function reactConfig(opts?: {
+    ai?: boolean;
+}): FlatConfigArray;
 
 /**
  * React effect config — catches unnecessary useEffect anti-patterns.
@@ -204,7 +200,9 @@ declare function reactEffectConfig(): FlatConfigArray;
  * @see https://ota-meshi.github.io/eslint-plugin-regexp/
  * @see https://ota-meshi.github.io/eslint-plugin-regexp/rules/
  */
-declare function regexpConfig(): FlatConfigArray;
+declare function regexpConfig(opts?: {
+    ai?: boolean;
+}): FlatConfigArray;
 
 /**
  * Security config — Node.js security patterns from eslint-plugin-security.
@@ -223,7 +221,9 @@ declare function securityConfig(): FlatConfigArray;
  *
  * @see https://github.com/SonarSource/SonarJS/tree/master/packages/jsts/src/rules#readme
  */
-declare function sonarjsConfig(): FlatConfigArray;
+declare function sonarjsConfig(opts?: {
+    ai?: boolean;
+}): FlatConfigArray;
 
 /**
  * TypeScript config — extends typescript-eslint strict presets with project-wide type checking.
@@ -238,7 +238,10 @@ declare function sonarjsConfig(): FlatConfigArray;
  * @see https://typescript-eslint.io/getting-started/
  * @see https://typescript-eslint.io/rules/
  */
-declare function typescriptConfig(): FlatConfigArray;
+declare function typescriptConfig(opts?: {
+    ai?: boolean;
+    react?: boolean;
+}): FlatConfigArray;
 
 /**
  * Unicorn config — modern JavaScript idioms and best practices.
@@ -248,7 +251,9 @@ declare function typescriptConfig(): FlatConfigArray;
  *
  * @see https://github.com/sindresorhus/eslint-plugin-unicorn#rules
  */
-declare function unicornConfig(): FlatConfigArray;
+declare function unicornConfig(opts?: {
+    ai?: boolean;
+}): FlatConfigArray;
 
 /**
  * Config file overrides — relaxed rules for tool configuration files.
@@ -304,13 +309,6 @@ declare function storiesOverride(): FlatConfigArray;
  */
 declare function testsOverride(): FlatConfigArray;
 
-/**
- * Complexity preset — limits for production code that encourage small,
- * focused functions and aggressive extraction of helper functions.
- * @see https://eslint.org/docs/latest/rules/#suggestions (complexity rules)
- */
-declare function standardComplexity(): FlatConfigArray;
-
 /**
  * Appends eslint-plugin-oxlint configs that disable all ESLint rules
  * already covered by OxLint. Must be the LAST config in the array.
@@ -321,9 +319,10 @@ declare function standardComplexity(): FlatConfigArray;
 declare function oxlintIntegration(opts: ConfigOptions): FlatConfigArray;
 
 /**
- * Composes a full flat config array from the given options.
- * This is the core logic used by the build system to generate configs.
+ * Complexity preset — limits for production code that encourage small,
+ * focused functions and aggressive extraction of helper functions.
+ * @see https://eslint.org/docs/latest/rules/#suggestions (complexity rules)
  */
-declare function composeConfig(opts: ConfigOptions): FlatConfigArray;
+declare function standardComplexity(): FlatConfigArray;
 
 export { aiConfig as ai, baseConfig as base, composeConfig, configFilesOverride as configFiles, cspellConfig as cspell, deMorganConfig as deMorgan, declarationsOverride as declarations, e2eOverride as e2e, importsConfig as imports, jsdocConfig as jsdoc, jsonConfig as json, markdownConfig as markdown, nodeConfig as node, oxlintIntegration as oxlint, packageJsonConfig as packageJson, packageJsonAiConfig as packageJsonAi, perfectionistConfig as perfectionist, perfectionistAiConfig as perfectionistAi, prettierCompatConfig as prettier, reactConfig as react, reactEffectConfig as reactEffect, regexpConfig as regexp, scriptsOverride as scripts, securityConfig as security, sonarjsConfig as sonarjs, standardComplexity, storiesOverride as stories, testsOverride as tests, typescriptConfig as typescript, unicornConfig as unicorn };