eslint-config-setup 0.3.0 → 0.3.2

package/dist/configs/e4b137fa.js

@@ -526,7 +526,6 @@ export default [
       "sonarjs/prefer-single-boolean-return": "error",
       "sonarjs/reduce-initial-value": "error",
       "symbol-description": "error",
-      "unicorn/better-regex": "error",
       "unicorn/catch-error-name": [
         "error",
         {

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { C as ConfigOptions, F as FlatConfigArray, O as OxlintConfigOptions, R as RuleSeverity, a as RuleOptions } from './types-D227zLeg.js';
-export { b as RuleScope } from './types-D227zLeg.js';
+import { C as ConfigOptions, F as FlatConfigArray, O as OxlintConfigOptions, a as OxlintConfigResult, R as RuleSeverity, b as RuleOptions } from './types-CAUUIuJR.js';
+export { c as RuleScope } from './types-CAUUIuJR.js';
 import 'eslint';
 
 /**
@@ -11,7 +11,7 @@ declare function getEslintConfig(opts?: ConfigOptions): Promise<FlatConfigArray>
  * Loads a pre-generated OxLint config from the hashed JSON file.
  * Only `react`, `node`, and `ai` flags are relevant — `oxlint` is ignored.
  */
-declare function getOxlintConfig(opts?: OxlintConfigOptions): unknown;
+declare function getOxlintConfig(opts?: OxlintConfigOptions): OxlintConfigResult;
 
 /**
  * Change the severity of a rule across all config blocks, preserving options.
@@ -49,4 +49,4 @@ declare function bitmaskToHash(mask: number): string;
 /** Convenience: options → filename (without path prefix). */
 declare function optionsToFilename(opts: ConfigOptions): string;
 
-export { ConfigOptions, FlatConfigArray, OxlintConfigOptions, RuleOptions, RuleSeverity, addRule, bitmaskToHash, configureRule, disableAllRulesBut, disableRule, getEslintConfig, getOxlintConfig, optionsToBitmask, optionsToFilename, setRuleSeverity };
+export { ConfigOptions, FlatConfigArray, OxlintConfigOptions, OxlintConfigResult, RuleOptions, RuleSeverity, addRule, bitmaskToHash, configureRule, disableAllRulesBut, disableRule, getEslintConfig, getOxlintConfig, optionsToBitmask, optionsToFilename, setRuleSeverity };

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 } 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): unknown {\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 unknown\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/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":[]}

package/dist/modules.d.ts

@@ -1,4 +1,4 @@
-import { F as FlatConfigArray, C as ConfigOptions } from './types-D227zLeg.js';
+import { F as FlatConfigArray, C as ConfigOptions } from './types-CAUUIuJR.js';
 import 'eslint';
 
 /**
@@ -13,7 +13,9 @@ import 'eslint';
  * and tightened beyond their defaults for AI-generated code.
  * @see ADR-0006: docs/adr/0006-ai-mode-as-dedicated-flag.md
  */
-declare function aiConfig(): FlatConfigArray;
+declare function aiConfig(opts?: {
+    react?: boolean;
+}): FlatConfigArray;
 
 /**
  * Base ESLint config — extends `eslint.configs.recommended` with additional

package/dist/modules.js

@@ -1,5 +1,6 @@
 // src/configs/ai.ts
-function aiConfig() {
+function aiConfig(opts) {
+  const isReact = opts?.react ?? false;
   const configs = [
     {
       name: "eslint-config-setup/ai-structural",
@@ -136,12 +137,29 @@ function aiConfig() {
         // https://typescript-eslint.io/rules/naming-convention
         "@typescript-eslint/naming-convention": [
           "error",
+          {
+            selector: "variable",
+            format: isReact ? ["strictCamelCase", "UPPER_CASE", "StrictPascalCase"] : ["strictCamelCase", "UPPER_CASE"],
+            leadingUnderscore: "allowSingleOrDouble",
+            trailingUnderscore: "allow",
+            filter: { regex: "[- ]", match: false }
+          },
+          {
+            selector: "function",
+            format: isReact ? ["strictCamelCase", "StrictPascalCase"] : ["strictCamelCase"]
+          },
+          {
+            selector: "parameter",
+            format: ["strictCamelCase"],
+            leadingUnderscore: "allow"
+          },
+          {
+            selector: "import",
+            format: ["strictCamelCase", "StrictPascalCase", "UPPER_CASE"]
+          },
           {
             selector: [
-              "variable",
-              "function",
               "classProperty",
-              "objectLiteralProperty",
               "parameterProperty",
               "classMethod",
               "objectLiteralMethod",
@@ -153,6 +171,10 @@ function aiConfig() {
             trailingUnderscore: "allow",
             filter: { regex: "[- ]", match: false }
           },
+          {
+            selector: ["objectLiteralProperty", "typeProperty"],
+            format: null
+          },
           {
             selector: "typeLike",
             format: ["StrictPascalCase"]
@@ -1776,9 +1798,11 @@ function unicornConfig() {
         // https://github.com/sindresorhus/eslint-plugin-unicorn/blob/main/docs/rules/prefer-type-error.md
         "unicorn/prefer-type-error": "error",
         // ── Regex ─────────────────────────────────────────────────────
-        // Simplify regex patterns — auto-fixable regex optimization
-        // https://github.com/sindresorhus/eslint-plugin-unicorn/blob/main/docs/rules/better-regex.md
-        "unicorn/better-regex": "error",
+        // Disabled — conflicts with regexp/strict from eslint-plugin-regexp.
+        // Both rules auto-fix regex escaping but disagree on whether characters
+        // like { } ] should be escaped, causing circular fixes.
+        // regexp/strict is the more thorough rule, so we defer to it.
+        "unicorn/better-regex": "off",
         // ── Misc ──────────────────────────────────────────────────────
         // Enforce `error` name in catch blocks — consistent naming
         // https://github.com/sindresorhus/eslint-plugin-unicorn/blob/main/docs/rules/catch-error-name.md
@@ -2264,40 +2288,26 @@ function standardComplexity() {
 import oxlintPlugin from "eslint-plugin-oxlint";
 function oxlintIntegration(opts) {
   const typedPlugin = oxlintPlugin;
-  const configs = [
-    {
-      name: "eslint-config-setup/oxlint",
-      ...typedPlugin.configs["flat/recommended"]
+  const configs = [];
+  const add = (configName, blockName) => {
+    const raw = typedPlugin.configs[configName];
+    const items = Array.isArray(raw) ? raw : [raw];
+    for (const item of items) {
+      configs.push({ name: `eslint-config-setup/${blockName}`, ...item });
     }
-  ];
+  };
+  add("flat/recommended", "oxlint");
   if (opts.react) {
-    configs.push({
-      name: "eslint-config-setup/oxlint-react",
-      ...typedPlugin.configs["flat/react"]
-    }, {
-      name: "eslint-config-setup/oxlint-jsx-a11y",
-      ...typedPlugin.configs["flat/jsx-a11y"]
-    });
+    add("flat/react", "oxlint-react");
+    add("flat/jsx-a11y", "oxlint-jsx-a11y");
   }
   if (opts.node) {
-    configs.push({
-      name: "eslint-config-setup/oxlint-node",
-      ...typedPlugin.configs["flat/node"]
-    });
+    add("flat/node", "oxlint-node");
   }
-  configs.push({
-    name: "eslint-config-setup/oxlint-typescript",
-    ...typedPlugin.configs["flat/typescript"]
-  }, {
-    name: "eslint-config-setup/oxlint-unicorn",
-    ...typedPlugin.configs["flat/unicorn"]
-  }, {
-    name: "eslint-config-setup/oxlint-import",
-    ...typedPlugin.configs["flat/import"]
-  }, {
-    name: "eslint-config-setup/oxlint-jsdoc",
-    ...typedPlugin.configs["flat/jsdoc"]
-  });
+  add("flat/typescript", "oxlint-typescript");
+  add("flat/unicorn", "oxlint-unicorn");
+  add("flat/import", "oxlint-import");
+  add("flat/jsdoc", "oxlint-jsdoc");
   return configs;
 }
 
@@ -2347,7 +2357,7 @@ function composeConfig(opts) {
     config.push(...reactEffectConfig());
   }
   if (opts.ai) {
-    config.push(...aiConfig());
+    config.push(...aiConfig({ react: opts.react }));
     config.push(...perfectionistAiConfig());
     config.push(...packageJsonAiConfig());
   }