eslint-config-setup 0.3.2 → 0.4.0

package/dist/modules.js

@@ -1,594 +1,81 @@
 // src/configs/ai.ts
-function aiConfig(opts) {
-  const isReact = opts?.react ?? false;
-  const configs = [
-    {
-      name: "eslint-config-setup/ai-structural",
-      rules: {
-        // ── A. Structural clarity — always explicit, never ambiguous ──
-        // Require braces for ALL control flow — no ambiguous one-liners
-        // https://eslint.org/docs/latest/rules/curly
-        curly: ["error", "all"],
-        // Disallow else after return — flattens control flow
-        // https://eslint.org/docs/latest/rules/no-else-return
-        "no-else-return": ["error", { allowElseIf: false }],
-        // No nested ternaries — unreadable, use if/else or early return
-        // https://eslint.org/docs/latest/rules/no-nested-ternary
-        "no-nested-ternary": "error",
-        // No ternary when simpler alternatives exist (e.g., || or ??)
-        // https://eslint.org/docs/latest/rules/no-unneeded-ternary
-        "no-unneeded-ternary": "error",
-        // No negated conditions in if/else — flip the branches instead
-        // https://eslint.org/docs/latest/rules/no-negated-condition
-        "no-negated-condition": "error",
-        // No standalone if in else — use else-if instead
-        // https://eslint.org/docs/latest/rules/no-lonely-if
-        "no-lonely-if": "error",
-        // No parameter reassignment — prevents subtle mutation bugs
-        // https://eslint.org/docs/latest/rules/no-param-reassign
-        "no-param-reassign": ["error", { props: true }],
-        // One assignment per statement — prevents `a = b = c` chains
-        // https://eslint.org/docs/latest/rules/no-multi-assign
-        "no-multi-assign": "error",
-        // One variable per declaration — clear and grep-friendly
-        // https://eslint.org/docs/latest/rules/one-var
-        "one-var": ["error", "never"],
-        // No implicit type coercion (!!x, +x, "" + x) — use explicit Boolean/Number/String
-        // https://eslint.org/docs/latest/rules/no-implicit-coercion
-        "no-implicit-coercion": "error",
-        // Prefer const for all bindings in destructuring when possible
-        // https://eslint.org/docs/latest/rules/prefer-const
-        "prefer-const": ["error", { destructuring: "all" }],
-        // Disallow var — block-scoped let/const only
-        // https://eslint.org/docs/latest/rules/no-var
-        "no-var": "error",
-        // Require strict equality (===) — no type coercion
-        // https://eslint.org/docs/latest/rules/eqeqeq
-        eqeqeq: "error",
-        // Prefer template literals over concatenation — more readable
-        // https://eslint.org/docs/latest/rules/prefer-template
-        "prefer-template": "error",
-        // Require shorthand properties in objects — concise, skip quoted keys
-        // https://eslint.org/docs/latest/rules/object-shorthand
-        "object-shorthand": ["error", "always", { avoidQuotes: true }],
-        // Prefer concise arrow body: `() => expr` over `() => { return expr }`
-        // https://eslint.org/docs/latest/rules/arrow-body-style
-        "arrow-body-style": "error",
-        // Prefer arrow functions for callbacks — lexical `this`
-        // https://eslint.org/docs/latest/rules/prefer-arrow-callback
-        "prefer-arrow-callback": ["error", { allowNamedFunctions: true }],
-        // Prefer `x ??= y` over `x = x ?? y` — concise null-coalescing assignment
-        // https://eslint.org/docs/latest/rules/logical-assignment-operators
-        "logical-assignment-operators": [
-          "error",
-          "always",
-          { enforceForIfStatements: true }
-        ],
-        // No assignment in return statements — separate mutation from return
-        // https://eslint.org/docs/latest/rules/no-return-assign
-        "no-return-assign": ["error", "always"],
-        // One statement per line — scannable, diff-friendly
-        // https://eslint.org/docs/latest/rules/max-statements-per-line
-        "max-statements-per-line": ["error", { max: 1 }],
-        // Prefer `x ** 2` over `Math.pow(x, 2)` — modern operator syntax
-        // https://eslint.org/docs/latest/rules/prefer-exponentiation-operator
-        "prefer-exponentiation-operator": "error",
-        // Require named capture groups in regex — self-documenting patterns
-        // https://eslint.org/docs/latest/rules/prefer-named-capture-group
-        "prefer-named-capture-group": "error",
-        // Require Unicode-aware regex (`u` or `v` flag) — correct string handling
-        // https://eslint.org/docs/latest/rules/require-unicode-regexp
-        "require-unicode-regexp": "error",
-        // ── B. Magic numbers & constants — no unexplained code ────────
-        // No magic numbers — extract to named constants (allows -1, 0, 1, 2)
-        // https://typescript-eslint.io/rules/no-magic-numbers
-        "@typescript-eslint/no-magic-numbers": [
-          "error",
-          {
-            ignore: [-1, 0, 1, 2],
-            ignoreArrayIndexes: true,
-            ignoreDefaultValues: true,
-            enforceConst: true,
-            ignoreClassFieldInitialValues: true,
-            ignoreEnums: true,
-            ignoreNumericLiteralTypes: true,
-            ignoreReadonlyClassProperties: true,
-            ignoreTypeIndexes: true
-          }
-        ],
-        // No duplicate strings (threshold 3) — extract to constant
-        // https://sonarsource.github.io/rspec/#/rspec/S1192/javascript
-        "sonarjs/no-duplicate-string": ["error", { threshold: 3 }],
-        // Flag TODO/FIXME/HACK comments — technical debt tracker
-        // https://eslint.org/docs/latest/rules/no-warning-comments
-        "no-warning-comments": "warn",
-        // ── F. Async/Promise hygiene ──────────────────────────────────
-        // No await inside loops — use Promise.all() for parallel execution
-        // https://eslint.org/docs/latest/rules/no-await-in-loop
-        "no-await-in-loop": "error",
-        // Disallow returning values from Promise executors — use resolve/reject
-        // https://eslint.org/docs/latest/rules/no-promise-executor-return
-        "no-promise-executor-return": "error",
-        // Every Promise must be awaited, returned, or voided — prevents silent failures
-        // https://typescript-eslint.io/rules/no-floating-promises
-        "@typescript-eslint/no-floating-promises": [
-          "error",
-          { checkThenables: true, ignoreVoid: true }
-        ]
-      }
-    },
-    {
-      name: "eslint-config-setup/ai-typescript",
-      rules: {
-        // ── C. TypeScript strictness — explicit types, safe patterns ──
-        // Require explicit return types — self-documenting function signatures
-        // https://typescript-eslint.io/rules/explicit-function-return-type
-        "@typescript-eslint/explicit-function-return-type": [
-          "error",
-          {
-            allowExpressions: true,
-            allowTypedFunctionExpressions: true,
-            allowHigherOrderFunctions: true,
-            allowIIFEs: true
-          }
-        ],
-        // Enforce consistent naming: camelCase for values, PascalCase for types,
-        // is/has/can/should/will/did prefix for boolean variables
-        // 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: [
-              "classProperty",
-              "parameterProperty",
-              "classMethod",
-              "objectLiteralMethod",
-              "typeMethod",
-              "accessor"
-            ],
-            format: ["strictCamelCase"],
-            leadingUnderscore: "allowSingleOrDouble",
-            trailingUnderscore: "allow",
-            filter: { regex: "[- ]", match: false }
-          },
-          {
-            selector: ["objectLiteralProperty", "typeProperty"],
-            format: null
-          },
-          {
-            selector: "typeLike",
-            format: ["StrictPascalCase"]
-          },
-          {
-            // No "I" prefix on interfaces — use descriptive names (XO convention)
-            selector: "interface",
-            format: ["StrictPascalCase"],
-            custom: { regex: "^I[A-Z]", match: false }
-          },
-          {
-            // Type parameters: single uppercase letter (T) or PascalCase (TResult)
-            selector: "typeParameter",
-            format: ["PascalCase"],
-            custom: { regex: "^(T([A-Z][a-zA-Z]*)?|[A-Z])$", match: true }
-          },
-          {
-            selector: "variable",
-            types: ["boolean"],
-            format: ["StrictPascalCase"],
-            prefix: ["is", "has", "can", "should", "will", "did"]
-          },
-          {
-            selector: ["classProperty", "objectLiteralProperty"],
-            format: null,
-            modifiers: ["requiresQuotes"]
-          }
-        ],
-        // Enforce `import type { T }` — types are erased at compile time
-        // https://typescript-eslint.io/rules/consistent-type-imports
-        "@typescript-eslint/consistent-type-imports": [
-          "error",
-          { fixStyle: "inline-type-imports" }
-        ],
-        // Enforce `export type { T }` — matches import convention
-        // https://typescript-eslint.io/rules/consistent-type-exports
-        "@typescript-eslint/consistent-type-exports": [
-          "error",
-          { fixMixedExportsWithInlineTypeSpecifier: true }
-        ],
-        // Disallow `any` type — auto-fix to `unknown` for type safety
-        // https://typescript-eslint.io/rules/no-explicit-any
-        "@typescript-eslint/no-explicit-any": ["error", { fixToUnknown: true }],
-        // Prefer readonly for unmodified class properties — signals immutability
-        // https://typescript-eslint.io/rules/prefer-readonly
-        "@typescript-eslint/prefer-readonly": "error",
-        // Functions returning promises must be async — consistent async patterns
-        // https://typescript-eslint.io/rules/promise-function-async
-        "@typescript-eslint/promise-function-async": "error",
-        // Exhaustive switch statements — no missing cases, no unnecessary defaults
-        // https://typescript-eslint.io/rules/switch-exhaustiveness-check
-        "@typescript-eslint/switch-exhaustiveness-check": [
-          "error",
-          {
-            allowDefaultCaseForExhaustiveSwitch: false,
-            requireDefaultForNonUnion: true
-          }
-        ],
-        // Disallow unsafe type assertions (as Type) — use type guards instead
-        // https://typescript-eslint.io/rules/no-unsafe-type-assertion
-        "@typescript-eslint/no-unsafe-type-assertion": "error",
-        // Require comparator for Array.sort() — prevents locale-dependent string sort
-        // https://typescript-eslint.io/rules/require-array-sort-compare
-        "@typescript-eslint/require-array-sort-compare": [
-          "error",
-          { ignoreStringArrays: true }
-        ],
-        // Require explicit `public`/`private`/`protected` on class members
-        // https://typescript-eslint.io/rules/explicit-member-accessibility
-        "@typescript-eslint/explicit-member-accessibility": "error",
-        // Enforce property style for method signatures — prevents bivariance issues
-        // https://typescript-eslint.io/rules/method-signature-style
-        "@typescript-eslint/method-signature-style": ["error", "property"],
-        // Require explicit values for enum members — prevents accidental shifts on reorder
-        // https://typescript-eslint.io/rules/prefer-enum-initializers
-        "@typescript-eslint/prefer-enum-initializers": "error",
-        // Prefer `type` over `interface` — consistent, supports unions/intersections
-        // https://typescript-eslint.io/rules/consistent-type-definitions
-        "@typescript-eslint/consistent-type-definitions": ["error", "type"],
-        // Enforce consistent member ordering in classes and interfaces
-        // Static → fields by visibility → constructors → methods by visibility (XO convention)
-        // https://typescript-eslint.io/rules/member-ordering
-        "@typescript-eslint/member-ordering": [
-          "warn",
-          {
-            default: [
-              // Index signature
-              "signature",
-              "call-signature",
-              // Static
-              "public-static-field",
-              "protected-static-field",
-              "private-static-field",
-              "#private-static-field",
-              "static-field",
-              "public-static-method",
-              "protected-static-method",
-              "private-static-method",
-              "#private-static-method",
-              "static-method",
-              // Fields
-              "public-decorated-field",
-              "protected-decorated-field",
-              "private-decorated-field",
-              "public-instance-field",
-              "protected-instance-field",
-              "private-instance-field",
-              "#private-instance-field",
-              "public-abstract-field",
-              "protected-abstract-field",
-              "field",
-              // Constructors
-              "public-constructor",
-              "protected-constructor",
-              "private-constructor",
-              "constructor",
-              // Getters/Setters
-              ["public-get", "public-set"],
-              ["protected-get", "protected-set"],
-              ["private-get", "private-set"],
-              ["#private-get", "#private-set"],
-              // Methods
-              "public-decorated-method",
-              "protected-decorated-method",
-              "private-decorated-method",
-              "public-instance-method",
-              "protected-instance-method",
-              "private-instance-method",
-              "#private-instance-method",
-              "public-abstract-method",
-              "protected-abstract-method",
-              "method"
-            ]
-          }
-        ]
-      }
-    },
-    {
-      name: "eslint-config-setup/ai-unicorn",
-      rules: {
-        // ── D. Unicorn — modern, idiomatic patterns ───────────────────
-        // Move functions to the smallest scope where they're used
-        // https://github.com/sindresorhus/eslint-plugin-unicorn/blob/main/docs/rules/consistent-function-scoping.md
-        "unicorn/consistent-function-scoping": "error",
-        // Forbid blanket `/* eslint-disable */` — must specify rules
-        // https://github.com/sindresorhus/eslint-plugin-unicorn/blob/main/docs/rules/no-abusive-eslint-disable.md
-        "unicorn/no-abusive-eslint-disable": "error",
-        // No .forEach() — use for-of loop (breakable, async-safe)
-        // https://github.com/sindresorhus/eslint-plugin-unicorn/blob/main/docs/rules/no-array-for-each.md
-        "unicorn/no-array-for-each": "error",
-        // No .reduce() — explicit loops are more readable
-        // https://github.com/sindresorhus/eslint-plugin-unicorn/blob/main/docs/rules/no-array-reduce.md
-        "unicorn/no-array-reduce": "error",
-        // Prefer simple ternary over if/else for single-line assignments
-        // https://github.com/sindresorhus/eslint-plugin-unicorn/blob/main/docs/rules/prefer-ternary.md
-        "unicorn/prefer-ternary": ["error", "only-single-line"],
-        // Prefer switch for 3+ conditions on same variable — structured
-        // https://github.com/sindresorhus/eslint-plugin-unicorn/blob/main/docs/rules/prefer-switch.md
-        "unicorn/prefer-switch": ["error", { minimumCases: 3 }],
-        // Enforce camelCase or PascalCase filenames — consistent project structure
-        // https://github.com/sindresorhus/eslint-plugin-unicorn/blob/main/docs/rules/filename-case.md
-        "unicorn/filename-case": [
-          "error",
-          { cases: { camelCase: true, pascalCase: true } }
-        ],
-        // Prevent abbreviated variable names (e → error, btn → button) — readable
-        // https://github.com/sindresorhus/eslint-plugin-unicorn/blob/main/docs/rules/prevent-abbreviations.md
-        "unicorn/prevent-abbreviations": "error",
-        // Detect useless switch cases that fall through to the next case
-        // https://github.com/sindresorhus/eslint-plugin-unicorn/blob/main/docs/rules/no-useless-switch-case.md
-        "unicorn/no-useless-switch-case": "error",
-        // Enforce correct Error subclassing (name, constructor pattern)
-        // https://github.com/sindresorhus/eslint-plugin-unicorn/blob/main/docs/rules/custom-error-definition.md
-        "unicorn/custom-error-definition": "error",
-        // Prefer default parameters over manual reassignment
-        // https://github.com/sindresorhus/eslint-plugin-unicorn/blob/main/docs/rules/prefer-default-parameters.md
-        "unicorn/prefer-default-parameters": "error",
-        // Prefer `a || b` over `a ? a : b` — simpler when equivalent
-        // https://github.com/sindresorhus/eslint-plugin-unicorn/blob/main/docs/rules/prefer-logical-operator-over-ternary.md
-        "unicorn/prefer-logical-operator-over-ternary": "error",
-        // Prefer Math.min()/Math.max() over ternaries for clamping
-        // https://github.com/sindresorhus/eslint-plugin-unicorn/blob/main/docs/rules/prefer-math-min-max.md
-        "unicorn/prefer-math-min-max": "error",
-        // Prefer Set#size over converting to array — direct and correct
-        // https://github.com/sindresorhus/eslint-plugin-unicorn/blob/main/docs/rules/prefer-set-size.md
-        "unicorn/prefer-set-size": "error",
-        // Enforce explicit `.length > 0` / `.length === 0` checks
-        // https://github.com/sindresorhus/eslint-plugin-unicorn/blob/main/docs/rules/explicit-length-check.md
-        "unicorn/explicit-length-check": "error",
-        // Prefer for-of over C-style for loops — no off-by-one risk
-        // https://github.com/sindresorhus/eslint-plugin-unicorn/blob/main/docs/rules/no-for-loop.md
-        "unicorn/no-for-loop": "error",
-        // Enforce braces in switch cases — prevents scope leakage
-        // https://github.com/sindresorhus/eslint-plugin-unicorn/blob/main/docs/rules/switch-case-braces.md
-        "unicorn/switch-case-braces": "error",
-        // Combine multiple .push() calls into one — cleaner
-        // https://github.com/sindresorhus/eslint-plugin-unicorn/blob/main/docs/rules/no-array-push-push.md
-        "unicorn/no-array-push-push": "error"
-      }
-    },
-    {
-      name: "eslint-config-setup/ai-sonarjs",
-      rules: {
-        // ── E. SonarJS — code quality and duplicates ──────────────────
-        // Detect copy-pasted functions — extract to shared helper
-        // https://sonarsource.github.io/rspec/#/rspec/S4144/javascript
-        "sonarjs/no-identical-functions": "error",
-        // Merge nested if-statements that can be combined — reduce nesting
-        // https://sonarsource.github.io/rspec/#/rspec/S1066/javascript
-        "sonarjs/no-collapsible-if": "error",
-        // Simplify redundant boolean expressions
-        // https://sonarsource.github.io/rspec/#/rspec/S1125/javascript
-        "sonarjs/no-redundant-boolean": "error",
-        // Detect collections that are populated but never read — dead code
-        // https://sonarsource.github.io/rspec/#/rspec/S4030/javascript
-        "sonarjs/no-unused-collection": "error",
-        // Return value directly instead of storing in temp variable
-        // https://sonarsource.github.io/rspec/#/rspec/S1488/javascript
-        "sonarjs/prefer-immediate-return": "error",
-        // Simplify boolean return patterns
-        // https://sonarsource.github.io/rspec/#/rspec/S1126/javascript
-        "sonarjs/prefer-single-boolean-return": "error",
-        // Detect identical sub-expressions on both sides of operator
-        // https://sonarsource.github.io/rspec/#/rspec/S1764/javascript
-        "sonarjs/no-identical-expressions": "error",
-        // Simplify negated boolean checks — `!a !== b` → `a === b`
-        // https://sonarsource.github.io/rspec/#/rspec/S1940/javascript
-        "sonarjs/no-inverted-boolean-check": "error",
-        // Disallow nested switch statements — extract to function
-        // https://sonarsource.github.io/rspec/#/rspec/S1821/javascript
-        "sonarjs/no-nested-switch": "error",
-        // Disallow nested template literals — unreadable
-        // https://sonarsource.github.io/rspec/#/rspec/S4624/javascript
-        "sonarjs/no-nested-template-literals": "error",
-        // Limit union type size — too many members signals missing abstraction
-        // https://sonarsource.github.io/rspec/#/rspec/S4622/javascript
-        "sonarjs/max-union-size": ["error", { threshold: 5 }],
-        // Prefer type predicates for type narrowing — safer than assertions
-        // https://sonarsource.github.io/rspec/#/rspec/S4322/javascript
-        "sonarjs/prefer-type-guard": "error",
-        // Public static fields should be readonly — prevents accidental mutation
-        // https://sonarsource.github.io/rspec/#/rspec/S1444/javascript
-        "sonarjs/public-static-readonly": "error"
-      }
-    },
-    {
-      name: "eslint-config-setup/ai-regexp",
-      rules: {
-        // Prefer lookarounds over capturing groups used only for context
-        // https://ota-meshi.github.io/eslint-plugin-regexp/rules/prefer-lookaround.html
-        "regexp/prefer-lookaround": "error",
-        // Prefer named backreferences — \k<quote> over \1
-        // https://ota-meshi.github.io/eslint-plugin-regexp/rules/prefer-named-backreference.html
-        "regexp/prefer-named-backreference": "error",
-        // Prefer named replacement — $<name> over $1
-        // https://ota-meshi.github.io/eslint-plugin-regexp/rules/prefer-named-replacement.html
-        "regexp/prefer-named-replacement": "error",
-        // Prefer quantifier shorthand — a{3} over aaa
-        // https://ota-meshi.github.io/eslint-plugin-regexp/rules/prefer-quantifier.html
-        "regexp/prefer-quantifier": "error",
-        // Prefer match.groups.name over match[1] — consistent named groups usage
-        // https://ota-meshi.github.io/eslint-plugin-regexp/rules/prefer-result-array-groups.html
-        "regexp/prefer-result-array-groups": "error",
-        // Require v flag (unicode sets) over u flag — stricter ES2024 superset
-        // https://ota-meshi.github.io/eslint-plugin-regexp/rules/require-unicode-sets-regexp.html
-        "regexp/require-unicode-sets-regexp": "error"
-      }
-    },
-    {
-      name: "eslint-config-setup/ai-jsdoc",
-      rules: {
-        // Prevent comments that just repeat the name — `/** The name */ name: string`
-        // https://github.com/gajus/eslint-plugin-jsdoc/blob/main/docs/rules/informative-docs.md
-        "jsdoc/informative-docs": "error",
-        // AI should document parameters and return values completely
-        "jsdoc/require-param": "error",
-        "jsdoc/require-returns": "error"
-      }
-    },
-    {
-      name: "eslint-config-setup/ai-node",
-      rules: {
-        // Warn when using Node.js builtins not available in the target version
-        // https://github.com/eslint-community/eslint-plugin-n/blob/master/docs/rules/no-unsupported-features/node-builtins.md
-        "node/no-unsupported-features/node-builtins": "error"
-      }
-    },
-    {
-      name: "eslint-config-setup/ai-react",
-      rules: {
-        // No click handlers on static elements without role — use semantic HTML
-        // https://github.com/jsx-eslint/eslint-plugin-jsx-a11y/blob/main/docs/rules/no-static-element-interactions.md
-        "jsx-a11y/no-static-element-interactions": "error",
-        // No event handlers on non-interactive elements — use button/link instead
-        // https://github.com/jsx-eslint/eslint-plugin-jsx-a11y/blob/main/docs/rules/no-noninteractive-element-interactions.md
-        "jsx-a11y/no-noninteractive-element-interactions": "error",
-        // Interactive elements (role="button") must be focusable
-        // https://github.com/jsx-eslint/eslint-plugin-jsx-a11y/blob/main/docs/rules/interactive-supports-focus.md
-        "jsx-a11y/interactive-supports-focus": "error"
-      }
-    },
-    {
-      name: "eslint-config-setup/ai-complexity",
-      rules: {
-        // Cyclomatic complexity limit — max branches per function
-        // https://eslint.org/docs/latest/rules/complexity
-        complexity: ["error", 10],
-        // Max nesting depth — deep nesting signals need for extraction
-        // https://eslint.org/docs/latest/rules/max-depth
-        "max-depth": ["error", 3],
-        // Max nested callbacks — prevents callback hell
-        // https://eslint.org/docs/latest/rules/max-nested-callbacks
-        "max-nested-callbacks": ["error", 2],
-        // Max function parameters — many params suggest a config object
-        // https://eslint.org/docs/latest/rules/max-params
-        "max-params": ["error", 3],
-        // Max statements per function — keeps functions focused
-        // https://eslint.org/docs/latest/rules/max-statements
-        "max-statements": ["error", 15],
-        // Max lines per function — encourages extraction of helpers
-        // https://eslint.org/docs/latest/rules/max-lines-per-function
-        "max-lines-per-function": [
-          "error",
-          {
-            max: 50,
-            skipBlankLines: true,
-            skipComments: true
-          }
-        ],
-        // Max lines per file — encourages modular file organization
-        // https://eslint.org/docs/latest/rules/max-lines
-        "max-lines": [
-          "error",
-          {
-            max: 300,
-            skipBlankLines: true,
-            skipComments: true
-          }
-        ],
-        // Cognitive complexity — measures how hard a function is to understand
-        // https://sonarsource.github.io/rspec/#/rspec/S3776/javascript
-        "sonarjs/cognitive-complexity": ["error", 10]
-      }
-    },
-    {
-      name: "eslint-config-setup/ai-tests-strict",
-      files: ["**/*.test.{ts,tsx}", "**/__tests__/**/*.{ts,tsx}"],
-      rules: {
-        // Every test must be inside a describe block — organized test suites
-        // https://github.com/vitest-dev/eslint-plugin-vitest/blob/main/docs/rules/require-top-level-describe.md
-        "vitest/require-top-level-describe": "error",
-        // Hooks (beforeEach, afterEach) must be at the top of describe — predictable setup
-        // https://github.com/vitest-dev/eslint-plugin-vitest/blob/main/docs/rules/prefer-hooks-on-top.md
-        "vitest/prefer-hooks-on-top": "error"
-      }
-    },
-    {
-      name: "eslint-config-setup/ai-tests-relaxed",
-      files: ["**/*.test.{ts,tsx}", "**/__tests__/**/*.{ts,tsx}"],
-      rules: {
-        "max-lines": "off",
-        "max-lines-per-function": "off",
-        "max-statements": "off",
-        "max-nested-callbacks": "off",
-        "@typescript-eslint/no-magic-numbers": "off",
-        "sonarjs/no-duplicate-string": "off",
-        "@typescript-eslint/explicit-function-return-type": "off",
-        "@typescript-eslint/naming-convention": "off",
-        "unicorn/prevent-abbreviations": "off"
-      }
-    },
-    {
-      name: "eslint-config-setup/ai-e2e-relaxed",
-      files: ["**/*.spec.ts"],
-      rules: {
-        "max-lines": "off",
-        "max-lines-per-function": "off",
-        "max-statements": "off",
-        "@typescript-eslint/no-magic-numbers": "off",
-        "@typescript-eslint/explicit-function-return-type": "off"
-      }
-    },
-    {
-      name: "eslint-config-setup/ai-config-relaxed",
-      files: [
-        "**/*.config.{ts,mts,cts,js,mjs,cjs}",
-        "**/vite.config.*",
-        "**/vitest.config.*",
-        "**/next.config.*"
-      ],
-      rules: {
-        complexity: "off",
-        "max-lines": "off",
-        "max-lines-per-function": "off",
-        "max-statements": "off",
-        "@typescript-eslint/no-magic-numbers": "off",
-        "@typescript-eslint/explicit-function-return-type": "off",
-        "@typescript-eslint/naming-convention": "off"
-      }
-    },
-    {
-      name: "eslint-config-setup/ai-declarations-relaxed",
-      files: ["**/*.d.ts"],
-      rules: {
-        "@typescript-eslint/explicit-function-return-type": "off",
-        "@typescript-eslint/naming-convention": "off",
-        "@typescript-eslint/no-explicit-any": "off",
-        "@typescript-eslint/no-magic-numbers": "off",
-        "unicorn/prevent-abbreviations": "off",
-        "unicorn/filename-case": "off"
-      }
-    }
+var TEST_FILES = ["**/*.test.{ts,tsx}", "**/__tests__/**/*.{ts,tsx}"];
+var E2E_FILES = ["**/*.spec.ts"];
+var CONFIG_FILES = [
+  "**/*.config.{ts,mts,cts,js,mjs,cjs}",
+  "**/vite.config.*",
+  "**/vitest.config.*",
+  "**/next.config.*"
+];
+var AI_TESTS_STRICT_CONFIG = {
+  name: "eslint-config-setup/ai-tests-strict",
+  files: TEST_FILES,
+  rules: {
+    // Every test must be inside a describe block — organized test suites
+    "vitest/require-top-level-describe": "error",
+    // Hooks (beforeEach, afterEach) must be at the top of describe — predictable setup
+    "vitest/prefer-hooks-on-top": "error"
+  }
+};
+var AI_TESTS_RELAXED_CONFIG = {
+  name: "eslint-config-setup/ai-tests-relaxed",
+  files: TEST_FILES,
+  rules: {
+    "max-lines": "off",
+    "max-lines-per-function": "off",
+    "max-statements": "off",
+    "max-nested-callbacks": "off",
+    "@typescript-eslint/no-magic-numbers": "off",
+    "sonarjs/no-duplicate-string": "off",
+    "@typescript-eslint/explicit-function-return-type": "off",
+    "@typescript-eslint/naming-convention": "off",
+    "unicorn/prevent-abbreviations": "off"
+  }
+};
+var AI_E2E_RELAXED_CONFIG = {
+  name: "eslint-config-setup/ai-e2e-relaxed",
+  files: E2E_FILES,
+  rules: {
+    "max-lines": "off",
+    "max-lines-per-function": "off",
+    "max-statements": "off",
+    "@typescript-eslint/no-magic-numbers": "off",
+    "@typescript-eslint/explicit-function-return-type": "off"
+  }
+};
+var AI_CONFIG_RELAXED_CONFIG = {
+  name: "eslint-config-setup/ai-config-relaxed",
+  files: CONFIG_FILES,
+  rules: {
+    complexity: "off",
+    "max-lines": "off",
+    "max-lines-per-function": "off",
+    "max-statements": "off",
+    "@typescript-eslint/no-magic-numbers": "off",
+    "@typescript-eslint/explicit-function-return-type": "off",
+    "@typescript-eslint/naming-convention": "off"
+  }
+};
+var AI_DECLARATIONS_RELAXED_CONFIG = {
+  name: "eslint-config-setup/ai-declarations-relaxed",
+  files: ["**/*.d.ts"],
+  rules: {
+    "@typescript-eslint/explicit-function-return-type": "off",
+    "@typescript-eslint/naming-convention": "off",
+    "@typescript-eslint/no-explicit-any": "off",
+    "@typescript-eslint/no-magic-numbers": "off",
+    "unicorn/prevent-abbreviations": "off",
+    "unicorn/filename-case": "off"
+  }
+};
+function aiConfig() {
+  return [
+    AI_TESTS_STRICT_CONFIG,
+    AI_TESTS_RELAXED_CONFIG,
+    AI_E2E_RELAXED_CONFIG,
+    AI_CONFIG_RELAXED_CONFIG,
+    AI_DECLARATIONS_RELAXED_CONFIG
   ];
-  return configs;
 }
 
 // src/configs/base.ts
@@ -596,7 +83,7 @@ import eslint from "@eslint/js";
 
 // src/build/config-builder.ts
 function createConfig(options) {
-  const presetRules = /* @__PURE__ */ new Map();
+  const presetRules2 = /* @__PURE__ */ new Map();
   const presetPlugins = {};
   if (options.presets) {
     for (const preset of options.presets) {
@@ -606,7 +93,7 @@ function createConfig(options) {
       if (preset.rules) {
         for (const [name, value] of Object.entries(preset.rules)) {
           if (value !== void 0) {
-            presetRules.set(name, value);
+            presetRules2.set(name, value);
           }
         }
       }
@@ -619,7 +106,7 @@ function createConfig(options) {
   const fileOverrides = [];
   const builder = {
     overrideRule(name, value) {
-      if (!presetRules.has(name)) {
+      if (!presetRules2.has(name)) {
         throw new Error(
           `overrideRule("${name}"): rule not found in preset. Cannot override a rule that doesn't exist in the preset.`
         );
@@ -627,8 +114,34 @@ function createConfig(options) {
       overrides.set(name, value);
       return builder;
     },
+    overrideSeverity(name, severity) {
+      if (!presetRules2.has(name)) {
+        throw new Error(
+          `overrideSeverity("${name}"): rule not found in preset. Cannot override severity of a rule that doesn't exist in the preset.`
+        );
+      }
+      const existing = presetRules2.get(name);
+      if (Array.isArray(existing)) {
+        const [, ...restOptions] = existing;
+        overrides.set(name, [severity, ...restOptions]);
+      } else {
+        overrides.set(name, severity);
+      }
+      return builder;
+    },
+    overrideOptions(name, ...ruleOptions) {
+      if (!presetRules2.has(name)) {
+        throw new Error(
+          `overrideOptions("${name}"): rule not found in preset. Cannot override options of a rule that doesn't exist in the preset.`
+        );
+      }
+      const existing = presetRules2.get(name);
+      const severity = Array.isArray(existing) ? existing[0] : existing;
+      overrides.set(name, [severity, ...ruleOptions]);
+      return builder;
+    },
     addRule(name, value) {
-      if (presetRules.has(name)) {
+      if (presetRules2.has(name)) {
         throw new Error(
           `addRule("${name}"): rule already exists in preset. Use overrideRule() to change its value, or removeRule() to drop it.`
         );
@@ -642,7 +155,7 @@ function createConfig(options) {
       return builder;
     },
     disableRule(name) {
-      if (!presetRules.has(name) && !additions.has(name)) {
+      if (!presetRules2.has(name) && !additions.has(name)) {
         throw new Error(
           `disableRule("${name}"): rule not found in preset or additions. Cannot disable a rule that doesn't exist.`
         );
@@ -651,7 +164,7 @@ function createConfig(options) {
       return builder;
     },
     removeRule(name) {
-      if (!presetRules.has(name) && !additions.has(name)) {
+      if (!presetRules2.has(name) && !additions.has(name)) {
         throw new Error(
           `removeRule("${name}"): rule not found in preset or additions. Cannot remove a rule that doesn't exist.`
         );
@@ -665,7 +178,7 @@ function createConfig(options) {
     },
     build() {
       const rules = {};
-      for (const [name, value] of presetRules) {
+      for (const [name, value] of presetRules2) {
         if (!removed.has(name)) {
           rules[name] = value;
         }
@@ -724,14 +237,147 @@ function createConfig(options) {
 }
 
 // src/configs/base.ts
-function baseConfig() {
-  return createConfig({
+var ERROR_PREVENTION_RULES = {
+  "accessor-pairs": ["error", { enforceForClassMembers: true }],
+  "array-callback-return": ["error", { allowImplicit: true }],
+  "no-constructor-return": "error",
+  "no-promise-executor-return": "error",
+  "no-self-compare": "error",
+  "no-template-curly-in-string": "error",
+  "no-unreachable-loop": "error",
+  "require-atomic-updates": "error",
+  "no-unmodified-loop-condition": "error",
+  "grouped-accessor-pairs": ["error", "getBeforeSet"],
+  "no-useless-rename": "error",
+  "no-useless-computed-key": ["error", { enforceForClassMembers: true }]
+};
+var DANGEROUS_PATTERN_RULES = {
+  "no-eval": "error",
+  "no-alert": "error",
+  "no-caller": "error",
+  "no-extend-native": "error",
+  "no-new-func": "error",
+  "no-new-wrappers": "error",
+  "no-object-constructor": "error",
+  "no-proto": "error",
+  "no-iterator": "error",
+  "no-script-url": "error",
+  "no-octal-escape": "error",
+  "no-implicit-globals": "error"
+};
+var CODE_QUALITY_RULES = {
+  eqeqeq: ["error", "smart"],
+  "guard-for-in": "error",
+  "default-case-last": "error",
+  radix: "error",
+  yoda: "error",
+  "no-sequences": ["error", { allowInParentheses: false }],
+  "no-new": "error",
+  "no-labels": "error",
+  "no-extra-bind": "error",
+  "no-lone-blocks": "error",
+  "no-useless-call": "error",
+  "no-useless-concat": "error",
+  "no-useless-return": "error",
+  "no-return-assign": ["error", "always"],
+  "no-multi-str": "error",
+  "prefer-regex-literals": ["error", { disallowRedundantWrapping: true }]
+};
+var MODERN_STYLE_RULES = {
+  "no-var": "error",
+  "prefer-const": ["error", { destructuring: "all" }],
+  "prefer-object-has-own": "error",
+  "prefer-object-spread": "error",
+  "prefer-rest-params": "error",
+  "prefer-spread": "error",
+  "symbol-description": "error",
+  "prefer-numeric-literals": "error",
+  "object-shorthand": ["error", "always", { avoidExplicitReturnArrows: true, avoidQuotes: true }]
+};
+var AI_STRUCTURAL_RULES = {
+  curly: ["error", "all"],
+  "no-else-return": ["error", { allowElseIf: false }],
+  "no-nested-ternary": "error",
+  "no-unneeded-ternary": "error",
+  "no-negated-condition": "error",
+  "no-lonely-if": "error",
+  "no-param-reassign": ["error", { props: true }],
+  "no-multi-assign": "error",
+  "one-var": ["error", "never"],
+  "no-implicit-coercion": "error",
+  "arrow-body-style": "error",
+  "prefer-arrow-callback": ["error", { allowNamedFunctions: true }],
+  "logical-assignment-operators": ["error", "always", { enforceForIfStatements: true }],
+  "max-statements-per-line": ["error", { max: 1 }],
+  "prefer-exponentiation-operator": "error",
+  "prefer-named-capture-group": "error",
+  "require-unicode-regexp": "error",
+  "no-warning-comments": "warn",
+  "no-await-in-loop": "error"
+};
+function addRules(builder, rules) {
+  for (const [ruleName, value] of Object.entries(rules)) {
+    builder.addRule(ruleName, value);
+  }
+}
+function addBaseOverrides(builder) {
+  builder.overrideRule("use-isnan", ["error", { enforceForIndexOf: true, enforceForSwitchCase: true }]);
+  builder.overrideRule("valid-typeof", ["error", { requireStringLiterals: true }]);
+}
+function addComplexityRules(builder, isAi) {
+  builder.addRule("complexity", ["error", isAi ? 10 : 20]);
+  builder.addRule("max-depth", ["error", isAi ? 3 : 5]);
+  builder.addRule("max-nested-callbacks", ["error", isAi ? 2 : 4]);
+  builder.addRule("max-params", ["error", isAi ? 3 : 5]);
+  builder.addRule("max-statements", ["error", isAi ? 15 : 25]);
+  builder.addRule("max-lines-per-function", [
+    "error",
+    { max: isAi ? 100 : 200, skipBlankLines: true, skipComments: true }
+  ]);
+  builder.addRule("max-lines", [
+    "error",
+    { max: isAi ? 300 : 500, skipBlankLines: true, skipComments: true }
+  ]);
+  builder.addRule("sonarjs/cognitive-complexity", ["error", isAi ? 10 : 20]);
+}
+function addModernStyleRules(builder, isAi) {
+  addRules(builder, MODERN_STYLE_RULES);
+  builder.addRule("prefer-template", isAi ? "error" : "warn");
+}
+function baseConfig(opts) {
+  const isAi = opts?.ai ?? false;
+  const builder = createConfig({
     name: "eslint-config-setup/base",
     presets: [eslint.configs.recommended]
-  }).addRule("accessor-pairs", ["error", { enforceForClassMembers: true }]).addRule("array-callback-return", ["error", { allowImplicit: true }]).addRule("no-constructor-return", "error").addRule("no-promise-executor-return", "error").addRule("no-self-compare", "error").addRule("no-template-curly-in-string", "error").addRule("no-unreachable-loop", "error").addRule("require-atomic-updates", "error").addRule("no-unmodified-loop-condition", "error").addRule("grouped-accessor-pairs", ["error", "getBeforeSet"]).addRule("no-useless-rename", "error").addRule("no-useless-computed-key", "error").addRule("no-eval", "error").addRule("no-alert", "error").addRule("no-caller", "error").addRule("no-extend-native", "error").addRule("no-new-func", "error").addRule("no-new-wrappers", "error").addRule("no-object-constructor", "error").addRule("no-proto", "error").addRule("no-iterator", "error").addRule("no-script-url", "error").addRule("no-octal-escape", "error").addRule("eqeqeq", ["error", "smart"]).addRule("guard-for-in", "error").addRule("default-case-last", "error").addRule("radix", "error").addRule("yoda", "error").addRule("no-sequences", "error").addRule("no-new", "error").addRule("no-labels", "error").addRule("no-extra-bind", "error").addRule("no-lone-blocks", "error").addRule("no-useless-call", "error").addRule("no-useless-concat", "error").addRule("no-useless-return", "error").addRule("no-multi-str", "error").addRule("prefer-regex-literals", [
-    "error",
-    { disallowRedundantWrapping: true }
-  ]).addRule("no-var", "error").addRule("prefer-const", ["error", { destructuring: "all" }]).addRule("prefer-object-has-own", "error").addRule("prefer-object-spread", "error").addRule("prefer-rest-params", "error").addRule("prefer-spread", "error").addRule("prefer-template", "error").addRule("symbol-description", "error").build();
+  });
+  addRules(builder, ERROR_PREVENTION_RULES);
+  addBaseOverrides(builder);
+  addRules(builder, DANGEROUS_PATTERN_RULES);
+  addRules(builder, CODE_QUALITY_RULES);
+  addComplexityRules(builder, isAi);
+  addModernStyleRules(builder, isAi);
+  if (isAi) {
+    addRules(builder, AI_STRUCTURAL_RULES);
+  }
+  return builder.build();
+}
+
+// src/configs/compat.ts
+import compatPlugin from "eslint-plugin-compat";
+function compatConfig() {
+  return [
+    {
+      name: "eslint-config-setup/compat",
+      plugins: {
+        compat: compatPlugin
+      },
+      rules: {
+        // Warn when using browser APIs not supported in browserslist targets
+        // https://github.com/amilajack/eslint-plugin-compat#usage
+        "compat/compat": "warn"
+      }
+    }
+  ];
 }
 
 // src/configs/cspell.ts
@@ -791,6 +437,7 @@ function importsConfig() {
     {
       name: "eslint-config-setup/imports",
       plugins: {
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion -- Plugin type is compatible
         "import": importXPlugin,
         "unused-imports": unusedImportsPlugin
       },
@@ -798,7 +445,7 @@ function importsConfig() {
         // ── Validation (import-x) ────────────────────────────────────
         // Merge duplicate import paths into one statement — reduces noise
         // https://github.com/un-ts/eslint-plugin-import/blob/master/docs/rules/no-duplicates.md
-        "import/no-duplicates": ["error", { "prefer-inline": true }],
+        "import/no-duplicates": "error",
         // Forbid a module from importing itself — always a bug
         // https://github.com/un-ts/eslint-plugin-import/blob/master/docs/rules/no-self-import.md
         "import/no-self-import": "error",
@@ -829,6 +476,30 @@ function importsConfig() {
         // Forbid absolute file paths in imports — not portable across machines
         // https://github.com/un-ts/eslint-plugin-import-x/blob/master/docs/rules/no-absolute-path.md
         "import/no-absolute-path": "error",
+        // Forbid imports of packages not listed in package.json — catches phantom deps
+        // https://github.com/un-ts/eslint-plugin-import-x/blob/master/docs/rules/no-extraneous-dependencies.md
+        "import/no-extraneous-dependencies": ["error", { includeTypes: true }],
+        // Forbid side-effect-only imports — make dependencies explicit
+        // https://github.com/un-ts/eslint-plugin-import-x/blob/master/docs/rules/no-unassigned-import.md
+        "import/no-unassigned-import": [
+          "error",
+          {
+            allow: [
+              "@babel/polyfill",
+              "**/register",
+              "**/register.*",
+              "**/register/**",
+              "**/register/**.*",
+              "**/*.css",
+              "**/*.scss",
+              "**/*.sass",
+              "**/*.less"
+            ]
+          }
+        ],
+        // Forbid `import { default as Foo }` — use `import Foo` instead
+        // https://github.com/un-ts/eslint-plugin-import-x/blob/master/docs/rules/no-named-default.md
+        "import/no-named-default": "error",
         // ── Disabled: ordering handled by perfectionist ────────────────
         // https://github.com/un-ts/eslint-plugin-import/blob/master/docs/rules/order.md
         "import/order": "off",
@@ -845,11 +516,18 @@ function importsConfig() {
 
 // src/configs/jsdoc.ts
 import jsdocPlugin from "eslint-plugin-jsdoc";
-function jsdocConfig() {
-  return createConfig({
+function jsdocConfig(opts) {
+  const isAi = opts?.ai ?? false;
+  const builder = createConfig({
     name: "eslint-config-setup/jsdoc",
     presets: [jsdocPlugin.configs["flat/recommended-typescript-error"]]
-  }).overrideRule("jsdoc/require-jsdoc", "off").overrideRule("jsdoc/require-param", "off").overrideRule("jsdoc/require-returns", "off").overrideRule("jsdoc/require-yields", "off").overrideRule("jsdoc/require-param-description", "warn").overrideRule("jsdoc/require-returns-description", "warn").overrideRule("jsdoc/check-tag-names", "error").overrideRule("jsdoc/no-undefined-types", "error").overrideRule("jsdoc/tag-lines", "off").build();
+  }).overrideRule("jsdoc/require-jsdoc", "off").overrideRule("jsdoc/require-param", "off").overrideRule("jsdoc/require-returns", "off").overrideRule("jsdoc/require-yields", "off").overrideRule("jsdoc/require-param-description", "warn").overrideRule("jsdoc/require-returns-description", "warn").overrideRule("jsdoc/check-tag-names", "error").overrideRule("jsdoc/no-undefined-types", "error").overrideRule("jsdoc/tag-lines", "off");
+  if (isAi) {
+    builder.overrideRule("jsdoc/require-param", "error");
+    builder.overrideRule("jsdoc/require-returns", "error");
+    builder.overrideRule("jsdoc/informative-docs", "error");
+  }
+  return builder.build();
 }
 
 // src/configs/json.ts
@@ -913,6 +591,8 @@ function jsonConfig() {
 // src/configs/markdown.ts
 import * as mdxPlugin from "eslint-plugin-mdx";
 function markdownConfig() {
+  const codeBlockLanguageOptions = mdxPlugin.flatCodeBlocks.languageOptions ?? {};
+  const codeBlockParserOptions = codeBlockLanguageOptions.parserOptions ?? {};
   return [
     // ── MDX / Markdown parsing ─────────────────────────────────────
     {
@@ -927,6 +607,13 @@ function markdownConfig() {
     // Relaxes rules that don't apply to incomplete code snippets.
     {
       ...mdxPlugin.flatCodeBlocks,
+      languageOptions: {
+        ...codeBlockLanguageOptions,
+        parserOptions: {
+          ...codeBlockParserOptions,
+          projectService: false
+        }
+      },
       rules: {
         ...mdxPlugin.flatCodeBlocks.rules,
         // Snippets don't need trailing newlines
@@ -951,69 +638,76 @@ function markdownConfig() {
 // src/configs/node.ts
 import nodePlugin from "eslint-plugin-n";
 import globals from "globals";
-function nodeConfig() {
-  return [
-    {
-      name: "eslint-config-setup/node",
-      languageOptions: {
-        globals: {
-          ...globals.node
+function nodeConfig(opts) {
+  const isAi = opts?.ai ?? false;
+  const builder = createConfig({
+    name: "eslint-config-setup/node",
+    presets: [
+      {
+        rules: {
+          // Detect usage of deprecated Node.js APIs (fs.exists, url.parse, etc.)
+          // https://github.com/eslint-community/eslint-plugin-n/blob/master/docs/rules/no-deprecated-api.md
+          "node/no-deprecated-api": "error",
+          // Prevent `module.exports = ...` assignment in ES modules
+          // https://github.com/eslint-community/eslint-plugin-n/blob/master/docs/rules/no-exports-assign.md
+          "node/no-exports-assign": "error",
+          // OFF: TypeScript resolves imports — this rule has false positives
+          // https://github.com/eslint-community/eslint-plugin-n/blob/master/docs/rules/no-missing-import.md
+          "node/no-missing-import": "off",
+          // OFF: TypeScript resolves requires — this rule has false positives
+          // https://github.com/eslint-community/eslint-plugin-n/blob/master/docs/rules/no-missing-require.md
+          "node/no-missing-require": "off",
+          // Warn on process.exit() — prefer throwing errors for clean shutdown
+          // https://github.com/eslint-community/eslint-plugin-n/blob/master/docs/rules/no-process-exit.md
+          "node/no-process-exit": "warn",
+          // OFF: Too many false positives with monorepos and devDependencies
+          // https://github.com/eslint-community/eslint-plugin-n/blob/master/docs/rules/no-unpublished-import.md
+          "node/no-unpublished-import": "off",
+          // Validate hashbang lines — correct syntax, Unix linebreaks, only in entry files
+          // https://github.com/eslint-community/eslint-plugin-n/blob/master/docs/rules/hashbang.md
+          "node/hashbang": "error",
+          // Detect `__dirname + '/foo'` — use path.join() instead (breaks on Windows)
+          // https://github.com/eslint-community/eslint-plugin-n/blob/master/docs/rules/no-path-concat.md
+          "node/no-path-concat": "error",
+          // Treat process.exit() as throw — prevents false positives in unreachable code analysis
+          // https://github.com/eslint-community/eslint-plugin-n/blob/master/docs/rules/process-exit-as-throw.md
+          "node/process-exit-as-throw": "error",
+          // Ensure error parameters in callbacks are handled — don't silently swallow errors
+          // https://github.com/eslint-community/eslint-plugin-n/blob/master/docs/rules/handle-callback-err.md
+          "node/handle-callback-err": "error",
+          // ── Prefer global builtins ────────────────────────────────────
+          // Use global Buffer instead of require('buffer').Buffer
+          // https://github.com/eslint-community/eslint-plugin-n/blob/master/docs/rules/prefer-global/buffer.md
+          "node/prefer-global/buffer": ["error", "always"],
+          // Use global console — always available in Node.js
+          // https://github.com/eslint-community/eslint-plugin-n/blob/master/docs/rules/prefer-global/console.md
+          "node/prefer-global/console": ["error", "always"],
+          // Use global process — always available in Node.js
+          // https://github.com/eslint-community/eslint-plugin-n/blob/master/docs/rules/prefer-global/process.md
+          "node/prefer-global/process": ["error", "always"],
+          // Use global URL — available since Node.js 10
+          // https://github.com/eslint-community/eslint-plugin-n/blob/master/docs/rules/prefer-global/url.md
+          "node/prefer-global/url": ["error", "always"],
+          // Use global URLSearchParams — available since Node.js 10
+          // https://github.com/eslint-community/eslint-plugin-n/blob/master/docs/rules/prefer-global/url-search-params.md
+          "node/prefer-global/url-search-params": ["error", "always"],
+          // ── Prefer promise-based APIs ─────────────────────────────────
+          // Use dns.promises instead of callback-based dns — modern async
+          // https://github.com/eslint-community/eslint-plugin-n/blob/master/docs/rules/prefer-promises/dns.md
+          "node/prefer-promises/dns": "error",
+          // Use fs.promises instead of callback-based fs — modern async
+          // https://github.com/eslint-community/eslint-plugin-n/blob/master/docs/rules/prefer-promises/fs.md
+          "node/prefer-promises/fs": "error"
         }
-      },
-      plugins: {
-        node: nodePlugin
-      },
-      rules: {
-        // Detect usage of deprecated Node.js APIs (fs.exists, url.parse, etc.)
-        // https://github.com/eslint-community/eslint-plugin-n/blob/master/docs/rules/no-deprecated-api.md
-        "node/no-deprecated-api": "error",
-        // Prevent `module.exports = ...` assignment in ES modules
-        // https://github.com/eslint-community/eslint-plugin-n/blob/master/docs/rules/no-exports-assign.md
-        "node/no-exports-assign": "error",
-        // OFF: TypeScript resolves imports — this rule has false positives
-        // https://github.com/eslint-community/eslint-plugin-n/blob/master/docs/rules/no-missing-import.md
-        "node/no-missing-import": "off",
-        // OFF: TypeScript resolves requires — this rule has false positives
-        // https://github.com/eslint-community/eslint-plugin-n/blob/master/docs/rules/no-missing-require.md
-        "node/no-missing-require": "off",
-        // Warn on process.exit() — prefer throwing errors for clean shutdown
-        // https://github.com/eslint-community/eslint-plugin-n/blob/master/docs/rules/no-process-exit.md
-        "node/no-process-exit": "warn",
-        // OFF: Too many false positives with monorepos and devDependencies
-        // https://github.com/eslint-community/eslint-plugin-n/blob/master/docs/rules/no-unpublished-import.md
-        "node/no-unpublished-import": "off",
-        // Validate hashbang lines — correct syntax, Unix linebreaks, only in entry files
-        // https://github.com/eslint-community/eslint-plugin-n/blob/master/docs/rules/hashbang.md
-        "node/hashbang": "error",
-        // Detect `__dirname + '/foo'` — use path.join() instead (breaks on Windows)
-        // https://github.com/eslint-community/eslint-plugin-n/blob/master/docs/rules/no-path-concat.md
-        "node/no-path-concat": "error",
-        // ── Prefer global builtins ────────────────────────────────────
-        // Use global Buffer instead of require('buffer').Buffer
-        // https://github.com/eslint-community/eslint-plugin-n/blob/master/docs/rules/prefer-global/buffer.md
-        "node/prefer-global/buffer": ["error", "always"],
-        // Use global console — always available in Node.js
-        // https://github.com/eslint-community/eslint-plugin-n/blob/master/docs/rules/prefer-global/console.md
-        "node/prefer-global/console": ["error", "always"],
-        // Use global process — always available in Node.js
-        // https://github.com/eslint-community/eslint-plugin-n/blob/master/docs/rules/prefer-global/process.md
-        "node/prefer-global/process": ["error", "always"],
-        // Use global URL — available since Node.js 10
-        // https://github.com/eslint-community/eslint-plugin-n/blob/master/docs/rules/prefer-global/url.md
-        "node/prefer-global/url": ["error", "always"],
-        // Use global URLSearchParams — available since Node.js 10
-        // https://github.com/eslint-community/eslint-plugin-n/blob/master/docs/rules/prefer-global/url-search-params.md
-        "node/prefer-global/url-search-params": ["error", "always"],
-        // ── Prefer promise-based APIs ─────────────────────────────────
-        // Use dns.promises instead of callback-based dns — modern async
-        // https://github.com/eslint-community/eslint-plugin-n/blob/master/docs/rules/prefer-promises/dns.md
-        "node/prefer-promises/dns": "error",
-        // Use fs.promises instead of callback-based fs — modern async
-        // https://github.com/eslint-community/eslint-plugin-n/blob/master/docs/rules/prefer-promises/fs.md
-        "node/prefer-promises/fs": "error"
       }
-    }
-  ];
+    ],
+    plugins: { node: nodePlugin },
+    languageOptions: { globals: { ...globals.node } }
+  });
+  if (isAi) {
+    builder.addRule("node/no-unsupported-features/node-builtins", "error");
+  }
+  return builder.build();
 }
 
 // src/configs/package-json.ts
@@ -1140,235 +834,326 @@ function prettierCompatConfig() {
 }
 
 // src/configs/react.ts
-import eslintReactPlugin from "@eslint-react/eslint-plugin";
+import eslintReactPlugin2 from "@eslint-react/eslint-plugin";
 import stylisticPlugin from "@stylistic/eslint-plugin";
 import jsxA11yPlugin from "eslint-plugin-jsx-a11y";
-import reactHooksPlugin from "eslint-plugin-react-hooks";
 import reactRefreshPlugin from "eslint-plugin-react-refresh";
 import globals2 from "globals";
-function reactConfig() {
-  const reactDomPlugin = eslintReactPlugin.configs.dom.plugins;
-  const reactWebApiPlugin = eslintReactPlugin.configs["web-api"].plugins;
-  return [
+
+// src/file-patterns.ts
+var TYPESCRIPT_SOURCE_FILES = [
+  "**/*.ts",
+  "**/*.tsx",
+  "**/*.mts",
+  "**/*.cts"
+];
+var MARKDOWN_CODE_BLOCK_FILES = ["**/*.{md,mdx}/**"];
+
+// src/plugins/react-compat.ts
+import eslintReactPlugin from "@eslint-react/eslint-plugin";
+var coreRules = eslintReactPlugin.rules;
+function selectPrefixedRules(prefix) {
+  const result = {};
+  for (const [name, rule] of Object.entries(coreRules)) {
+    if (name.startsWith(prefix)) {
+      result[name.slice(prefix.length)] = rule;
+    }
+  }
+  return result;
+}
+var domRules = selectPrefixedRules("dom-");
+var jsxRules = selectPrefixedRules("jsx-");
+var namingRules = selectPrefixedRules("naming-convention-");
+var rscRules = selectPrefixedRules("rsc-");
+var webApiRules = selectPrefixedRules("web-api-");
+var LEGACY_ALIASES = {
+  // ── Core: identical names ──────────────────────────────────────────
+  "no-access-state-in-setstate": [coreRules, "no-access-state-in-setstate"],
+  "no-array-index-key": [coreRules, "no-array-index-key"],
+  "no-children-prop": [jsxRules, "no-children-prop"],
+  "no-direct-mutation-state": [coreRules, "no-direct-mutation-state"],
+  "no-redundant-should-component-update": [
+    coreRules,
+    "no-redundant-should-component-update"
+  ],
+  "no-unused-class-component-members": [
+    coreRules,
+    "no-unused-class-component-members"
+  ],
+  "no-unused-state": [coreRules, "no-unused-state"],
+  "jsx-no-comment-textnodes": [jsxRules, "no-comment-textnodes"],
+  // ── Core: renamed 1:1 ──────────────────────────────────────────────
+  "jsx-key": [coreRules, "no-missing-key"],
+  "jsx-key-before-spread": [jsxRules, "no-key-after-spread"],
+  "jsx-no-constructed-context-values": [
+    coreRules,
+    "no-unstable-context-value"
+  ],
+  "jsx-no-leaked-render": [coreRules, "no-leaked-conditional-rendering"],
+  "jsx-no-useless-fragment": [jsxRules, "no-useless-fragment"],
+  "no-object-type-as-default-prop": [coreRules, "no-unstable-default-props"],
+  "no-unstable-nested-components": [
+    coreRules,
+    "no-nested-component-definitions"
+  ],
+  "display-name": [coreRules, "no-missing-component-display-name"],
+  "forward-ref-uses-ref": [coreRules, "no-forward-ref"],
+  "destructuring-assignment": [coreRules, "prefer-destructuring-assignment"],
+  "no-did-mount-set-state": [
+    coreRules,
+    "no-set-state-in-component-did-mount"
+  ],
+  "no-did-update-set-state": [
+    coreRules,
+    "no-set-state-in-component-did-update"
+  ],
+  "no-will-update-set-state": [
+    coreRules,
+    "no-set-state-in-component-will-update"
+  ],
+  // ── Naming convention → legacy names ───────────────────────────────
+  "hook-use-state": [coreRules, "use-state"],
+  // ── DOM → legacy react/ names (not react-dom/) ─────────────────────
+  "no-danger": [domRules, "no-dangerously-set-innerhtml"],
+  "no-danger-with-children": [
+    domRules,
+    "no-dangerously-set-innerhtml-with-children"
+  ],
+  "no-find-dom-node": [domRules, "no-find-dom-node"],
+  "no-namespace": [jsxRules, "no-namespace"],
+  "no-render-return-value": [domRules, "no-render-return-value"],
+  "jsx-no-script-url": [domRules, "no-script-url"],
+  "jsx-no-target-blank": [domRules, "no-unsafe-target-blank"],
+  "no-unknown-property": [domRules, "no-unknown-property"],
+  "void-dom-elements-no-children": [
+    domRules,
+    "no-void-elements-with-children"
+  ],
+  "button-has-type": [domRules, "no-missing-button-type"],
+  "iframe-missing-sandbox": [domRules, "no-missing-iframe-sandbox"],
+  "style-prop-object": [domRules, "no-string-style-prop"]
+};
+var aliasedOriginals = /* @__PURE__ */ new Set();
+for (const [source, originalName] of Object.values(LEGACY_ALIASES)) {
+  if (source === coreRules) {
+    aliasedOriginals.add(originalName);
+  } else if (source === domRules) {
+    aliasedOriginals.add(`dom-${originalName}`);
+  } else if (source === jsxRules) {
+    aliasedOriginals.add(`jsx-${originalName}`);
+  } else if (source === namingRules) {
+    aliasedOriginals.add(`naming-convention-${originalName}`);
+  } else if (source === rscRules) {
+    aliasedOriginals.add(`rsc-${originalName}`);
+  } else if (source === webApiRules) {
+    aliasedOriginals.add(`web-api-${originalName}`);
+  }
+}
+var mergedRules = {};
+for (const [name, rule] of Object.entries(coreRules)) {
+  if (!aliasedOriginals.has(name)) {
+    mergedRules[name] = rule;
+  }
+}
+var subPlugins = [
+  [domRules, /* @__PURE__ */ new Set(["prefer-namespace-import"])],
+  [jsxRules, /* @__PURE__ */ new Set()],
+  [webApiRules, /* @__PURE__ */ new Set()],
+  [namingRules, /* @__PURE__ */ new Set()],
+  [rscRules, /* @__PURE__ */ new Set()]
+];
+for (const [rules, skip] of subPlugins) {
+  for (const [name, rule] of Object.entries(rules)) {
+    if (skip.has(name)) continue;
+    const isAliased = Object.values(LEGACY_ALIASES).some(
+      ([source, originalName]) => source === rules && originalName === name
+    );
+    if (!isAliased) {
+      mergedRules[name] = rule;
+    }
+  }
+}
+for (const [legacyName, [source, originalName]] of Object.entries(
+  LEGACY_ALIASES
+)) {
+  mergedRules[legacyName] = source[originalName];
+}
+var originalToCompat = /* @__PURE__ */ new Map();
+for (const [legacyName, [source, originalName]] of Object.entries(LEGACY_ALIASES)) {
+  originalToCompat.set(originalName, legacyName);
+  if (source === domRules) {
+    originalToCompat.set(`dom-${originalName}`, legacyName);
+  } else if (source === jsxRules) {
+    originalToCompat.set(`jsx-${originalName}`, legacyName);
+  } else if (source === namingRules) {
+    originalToCompat.set(`naming-convention-${originalName}`, legacyName);
+  } else if (source === rscRules) {
+    originalToCompat.set(`rsc-${originalName}`, legacyName);
+  } else if (source === webApiRules) {
+    originalToCompat.set(`web-api-${originalName}`, legacyName);
+  }
+}
+function translatePresetRules(presetRules2) {
+  const result = {};
+  for (const [key, value] of Object.entries(presetRules2)) {
+    const shortName = key.replace(
+      /^@eslint-react\/(?:dom|web-api|naming-convention|rsc)\//,
+      ""
+    ).replace(/^@eslint-react\//, "").replace(/^(?:dom|web-api|naming-convention|rsc)-/, "");
+    const compatName = originalToCompat.get(shortName) ?? shortName;
+    if (compatName in mergedRules) {
+      result[`react/${compatName}`] = value;
+    }
+  }
+  return result;
+}
+var reactCompatPlugin = {
+  meta: {
+    name: "react-compat",
+    version: "1.0.0"
+  },
+  rules: mergedRules
+};
+
+// src/configs/react.ts
+var typedConfigs = eslintReactPlugin2.configs;
+var recommendedRules = typedConfigs.recommended.rules;
+var strictRules = typedConfigs.strict.rules;
+var presetRules = translatePresetRules({ ...recommendedRules, ...strictRules });
+var EXTRA_REACT_RULES = {
+  "react/jsx-no-leaked-render": "error",
+  "react/no-duplicate-key": "error",
+  "react/no-implicit-key": "error",
+  "react/no-unused-props": "warn",
+  "react/no-unknown-property": "error",
+  "react/style-prop-object": "error"
+};
+var JSX_A11Y_ERROR_RULES = {
+  "jsx-a11y/alt-text": "error",
+  "jsx-a11y/anchor-has-content": "error",
+  "jsx-a11y/anchor-is-valid": "error",
+  "jsx-a11y/aria-activedescendant-has-tabindex": "error",
+  "jsx-a11y/aria-props": "error",
+  "jsx-a11y/aria-proptypes": "error",
+  "jsx-a11y/aria-role": "error",
+  "jsx-a11y/aria-unsupported-elements": "error",
+  "jsx-a11y/click-events-have-key-events": "error",
+  "jsx-a11y/heading-has-content": "error",
+  "jsx-a11y/html-has-lang": "error",
+  "jsx-a11y/img-redundant-alt": "error",
+  "jsx-a11y/label-has-associated-control": "error",
+  "jsx-a11y/mouse-events-have-key-events": "error",
+  "jsx-a11y/no-access-key": "error",
+  "jsx-a11y/no-distracting-elements": "error",
+  "jsx-a11y/no-redundant-roles": "error",
+  "jsx-a11y/role-has-required-aria-props": "error",
+  "jsx-a11y/role-supports-aria-props": "error",
+  "jsx-a11y/scope": "error",
+  "jsx-a11y/tabindex-no-positive": "error",
+  "jsx-a11y/lang": "error",
+  "jsx-a11y/autocomplete-valid": "error"
+};
+var AI_PROMOTED_REACT_RULES = [
+  "react/jsx-no-comment-textnodes",
+  "react/jsx-no-useless-fragment",
+  "react/jsx-no-constructed-context-values",
+  "react/no-array-index-key",
+  "react/no-object-type-as-default-prop",
+  "react/no-unused-state",
+  "react/jsx-no-target-blank",
+  "react/button-has-type",
+  "react/iframe-missing-sandbox",
+  "react/forward-ref-uses-ref",
+  "react/no-context-provider",
+  "react/no-use-context",
+  "react/no-leaked-event-listener",
+  "react/no-leaked-interval",
+  "react/no-leaked-timeout",
+  "react/no-leaked-resize-observer"
+];
+var AI_A11Y_RULES = [
+  "jsx-a11y/no-static-element-interactions",
+  "jsx-a11y/no-noninteractive-element-interactions",
+  "jsx-a11y/interactive-supports-focus"
+];
+function addRules2(builder, rules) {
+  for (const [ruleName, value] of Object.entries(rules)) {
+    builder.addRule(ruleName, value);
+  }
+}
+function addExtraReactRules(builder) {
+  addRules2(builder, EXTRA_REACT_RULES);
+}
+function addStylisticReactRules(builder) {
+  builder.addRule("@stylistic/jsx-self-closing-comp", "error");
+  builder.addRule("@stylistic/jsx-curly-brace-presence", [
+    "error",
+    { props: "never", children: "never" }
+  ]);
+}
+function addReactRefreshRules(builder) {
+  builder.addRule("react-refresh/only-export-components", [
+    "warn",
+    { allowConstantExport: true }
+  ]);
+}
+function addAccessibilityRules(builder) {
+  addRules2(builder, JSX_A11Y_ERROR_RULES);
+  builder.addRule("jsx-a11y/no-autofocus", ["error", { ignoreNonDOM: true }]);
+}
+function applyAiReactRules(builder) {
+  for (const ruleName of AI_PROMOTED_REACT_RULES) {
+    builder.overrideSeverity(ruleName, "error");
+  }
+  for (const ruleName of AI_A11Y_RULES) {
+    builder.addRule(ruleName, "error");
+  }
+}
+function addReactFileOverrides(builder) {
+  builder.addFileOverride(
+    "eslint-config-setup/react-typescript",
+    [...TYPESCRIPT_SOURCE_FILES],
     {
-      name: "eslint-config-setup/react",
-      languageOptions: {
-        globals: {
-          ...globals2.browser
-        },
-        parserOptions: {
-          ecmaFeatures: {
-            jsx: true
-          }
-        }
-      },
-      plugins: {
-        // @eslint-react core → registered as "react" (like import-x → "import")
-        react: eslintReactPlugin,
-        // @eslint-react/dom → registered as "react-dom"
-        "react-dom": reactDomPlugin["@eslint-react/dom"],
-        // @eslint-react/web-api → registered as "react-web-api"
-        "react-web-api": reactWebApiPlugin["@eslint-react/web-api"],
-        // eslint-plugin-react-hooks stays as-is
-        "react-hooks": reactHooksPlugin,
-        "@stylistic": stylisticPlugin,
-        "react-refresh": reactRefreshPlugin,
-        "jsx-a11y": jsxA11yPlugin
+      // Allow async event handlers — onClick={async () => {...}} is idiomatic React
+      "@typescript-eslint/no-misused-promises": [
+        "error",
+        { checksVoidReturn: false }
+      ]
+    }
+  );
+}
+function reactConfig(opts) {
+  const isAi = opts?.ai ?? false;
+  const builder = createConfig({
+    name: "eslint-config-setup/react",
+    presets: [{ rules: presetRules }],
+    plugins: {
+      react: reactCompatPlugin,
+      "@stylistic": stylisticPlugin,
+      "react-refresh": reactRefreshPlugin,
+      // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion -- Plugin from untyped module
+      "jsx-a11y": jsxA11yPlugin
+    },
+    languageOptions: {
+      globals: {
+        ...globals2.browser
       },
-      rules: {
-        // ── React core (react/) ─────────────────────────────────────────
-        // Prevent passing children as a prop — use JSX children syntax instead
-        // https://eslint-react.xyz/docs/rules/no-children-prop
-        "react/no-children-prop": "error",
-        // Prevent direct mutation of this.state — use setState instead
-        // https://eslint-react.xyz/docs/rules/no-direct-mutation-state
-        "react/no-direct-mutation-state": "error",
-        // Prevent unstable nested component definitions — causes remounts
-        // https://eslint-react.xyz/docs/rules/no-nested-component-definitions
-        "react/no-nested-component-definitions": "error",
-        // Require key prop in iterators — prevent reconciliation bugs
-        // https://eslint-react.xyz/docs/rules/no-missing-key
-        "react/no-missing-key": "error",
-        // Prevent duplicate key props in iterators
-        // https://eslint-react.xyz/docs/rules/no-duplicate-key
-        "react/no-duplicate-key": "error",
-        // Prevent comments from being inserted as text nodes in JSX
-        // https://eslint-react.xyz/docs/rules/jsx-no-comment-textnodes
-        "react/jsx-no-comment-textnodes": "error",
-        // Remove unnecessary JSX fragments — <>{x}</> → {x}
-        // https://eslint-react.xyz/docs/rules/no-useless-fragment
-        "react/no-useless-fragment": "error",
-        // Prefer <Foo active /> over <Foo active={true} /> — concise
-        // https://eslint-react.xyz/docs/rules/jsx-shorthand-boolean
-        "react/jsx-shorthand-boolean": "error",
-        // Prevent using array index as key — breaks reconciliation on reorder
-        // https://eslint-react.xyz/docs/rules/no-array-index-key
-        "react/no-array-index-key": "error",
-        // Prevent object/array literals as default props — creates new reference every render
-        // https://eslint-react.xyz/docs/rules/no-unstable-default-props
-        "react/no-unstable-default-props": "error",
-        // Prevent `{count && <Foo />}` — renders "0" when count is 0
-        // https://eslint-react.xyz/docs/rules/no-leaked-conditional-rendering
-        "react/no-leaked-conditional-rendering": "error",
-        // Prevent inline object creation in context providers — causes re-renders
-        // https://eslint-react.xyz/docs/rules/no-unstable-context-value
-        "react/no-unstable-context-value": "error",
-        // Prevent `this.setState({ count: this.state.count + 1 })` — race condition
-        // https://eslint-react.xyz/docs/rules/no-access-state-in-setstate
-        "react/no-access-state-in-setstate": "error",
-        // Detect state properties that are set but never read — dead code
-        // https://eslint-react.xyz/docs/rules/no-unused-state
-        "react/no-unused-state": "error",
-        // ── React 19 migration rules ────────────────────────────────────
-        // React 19: Use <Context> instead of <Context.Provider>
-        // https://eslint-react.xyz/docs/rules/no-context-provider
-        "react/no-context-provider": "error",
-        // React 19: Use ref as prop instead of forwardRef
-        // https://eslint-react.xyz/docs/rules/no-forward-ref
-        "react/no-forward-ref": "error",
-        // React 19: Use use() instead of useContext()
-        // https://eslint-react.xyz/docs/rules/no-use-context
-        "react/no-use-context": "error",
-        // ── React DOM (react-dom/) ──────────────────────────────────────
-        // Prevent unsafe target="_blank" links — requires rel="noreferrer"
-        // https://eslint-react.xyz/docs/rules/dom-no-unsafe-target-blank
-        "react-dom/no-unsafe-target-blank": "error",
-        // Prevent unknown DOM properties (e.g., class → className)
-        // https://eslint-react.xyz/docs/rules/dom-no-unknown-property
-        "react-dom/no-unknown-property": "error",
-        // Prevent void DOM elements (br, img, hr) from having children
-        // https://eslint-react.xyz/docs/rules/dom-no-void-elements-with-children
-        "react-dom/no-void-elements-with-children": "error",
-        // Require sandbox attribute on iframes — security best practice
-        // https://eslint-react.xyz/docs/rules/dom-no-missing-iframe-sandbox
-        "react-dom/no-missing-iframe-sandbox": "error",
-        // Prevent `style="color: red"` — must be an object in React
-        // https://eslint-react.xyz/docs/rules/dom-no-string-style-prop
-        "react-dom/no-string-style-prop": "error",
-        // Require explicit type on <button> — prevents unintended form submits
-        // https://eslint-react.xyz/docs/rules/dom-no-missing-button-type
-        "react-dom/no-missing-button-type": "error",
-        // Prevent dangerouslySetInnerHTML + children at the same time — conflict
-        // https://eslint-react.xyz/docs/rules/dom-no-dangerously-set-innerhtml-with-children
-        "react-dom/no-dangerously-set-innerhtml-with-children": "error",
-        // Warn on dangerouslySetInnerHTML — XSS risk, should be reviewed
-        // https://eslint-react.xyz/docs/rules/dom-no-dangerously-set-innerhtml
-        "react-dom/no-dangerously-set-innerhtml": "warn",
-        // ── React Web API (react-web-api/) — cleanup leak detection ─────
-        // Require cleanup for addEventListener in effects
-        // https://eslint-react.xyz/docs/rules/web-api-no-leaked-event-listener
-        "react-web-api/no-leaked-event-listener": "error",
-        // Require cleanup for setInterval in effects
-        // https://eslint-react.xyz/docs/rules/web-api-no-leaked-interval
-        "react-web-api/no-leaked-interval": "error",
-        // Require cleanup for setTimeout in effects
-        // https://eslint-react.xyz/docs/rules/web-api-no-leaked-timeout
-        "react-web-api/no-leaked-timeout": "error",
-        // Require cleanup for ResizeObserver in effects
-        // https://eslint-react.xyz/docs/rules/web-api-no-leaked-resize-observer
-        "react-web-api/no-leaked-resize-observer": "error",
-        // ── React Hooks (react-hooks/) — eslint-plugin-react-hooks ──────
-        // Enforce Rules of Hooks — hooks must be called at the top level
-        // https://react.dev/reference/rules/rules-of-hooks
-        "react-hooks/rules-of-hooks": "error",
-        // Verify dependency arrays in useEffect/useMemo/useCallback
-        // https://react.dev/reference/react/useEffect#specifying-reactive-dependencies
-        "react-hooks/exhaustive-deps": "error",
-        // ── @stylistic — JSX formatting rules ───────────────────────────
-        // Enforce self-closing tags for components without children — <Foo />
-        // https://eslint.style/rules/jsx/jsx-self-closing-comp
-        "@stylistic/jsx-self-closing-comp": "error",
-        // Prevent unnecessary string curly braces: title={"foo"} → title="foo"
-        // https://eslint.style/rules/jsx/jsx-curly-brace-presence
-        "@stylistic/jsx-curly-brace-presence": [
-          "error",
-          { props: "never", children: "never" }
-        ],
-        // ── React Refresh (Fast Refresh / HMR) ────────────────────────
-        // Ensure components are exported in a way that supports Fast Refresh.
-        // Mixed exports (component + constants) break HMR state preservation.
-        // allowConstantExport: Vite handles constant exports without breaking HMR.
-        // https://github.com/ArnaudBarre/eslint-plugin-react-refresh
-        "react-refresh/only-export-components": [
-          "warn",
-          { allowConstantExport: true }
-        ],
-        // ── JSX Accessibility (a11y) ──────────────────────────────────
-        // Require alt text on img, area, input[type="image"], object
-        // https://github.com/jsx-eslint/eslint-plugin-jsx-a11y/blob/main/docs/rules/alt-text.md
-        "jsx-a11y/alt-text": "error",
-        // Require anchor content — empty links are inaccessible
-        // https://github.com/jsx-eslint/eslint-plugin-jsx-a11y/blob/main/docs/rules/anchor-has-content.md
-        "jsx-a11y/anchor-has-content": "error",
-        // Require valid href on anchors — no `#` or `javascript:` void
-        // https://github.com/jsx-eslint/eslint-plugin-jsx-a11y/blob/main/docs/rules/anchor-is-valid.md
-        "jsx-a11y/anchor-is-valid": "error",
-        // Active descendant elements must be focusable (tabindex)
-        // https://github.com/jsx-eslint/eslint-plugin-jsx-a11y/blob/main/docs/rules/aria-activedescendant-has-tabindex.md
-        "jsx-a11y/aria-activedescendant-has-tabindex": "error",
-        // Validate aria-* attributes exist — catches typos in ARIA props
-        // https://github.com/jsx-eslint/eslint-plugin-jsx-a11y/blob/main/docs/rules/aria-props.md
-        "jsx-a11y/aria-props": "error",
-        // Validate aria-* values match their type (boolean, token, etc.)
-        // https://github.com/jsx-eslint/eslint-plugin-jsx-a11y/blob/main/docs/rules/aria-proptypes.md
-        "jsx-a11y/aria-proptypes": "error",
-        // Validate role attribute values — catches invalid role names
-        // https://github.com/jsx-eslint/eslint-plugin-jsx-a11y/blob/main/docs/rules/aria-role.md
-        "jsx-a11y/aria-role": "error",
-        // Prevent ARIA on elements that don't support it (meta, script, style)
-        // https://github.com/jsx-eslint/eslint-plugin-jsx-a11y/blob/main/docs/rules/aria-unsupported-elements.md
-        "jsx-a11y/aria-unsupported-elements": "error",
-        // Click handlers must have keyboard equivalent — keyboard accessibility
-        // https://github.com/jsx-eslint/eslint-plugin-jsx-a11y/blob/main/docs/rules/click-events-have-key-events.md
-        "jsx-a11y/click-events-have-key-events": "error",
-        // Heading elements must have content — screen readers need it
-        // https://github.com/jsx-eslint/eslint-plugin-jsx-a11y/blob/main/docs/rules/heading-has-content.md
-        "jsx-a11y/heading-has-content": "error",
-        // Require lang attribute on <html> — language identification
-        // https://github.com/jsx-eslint/eslint-plugin-jsx-a11y/blob/main/docs/rules/html-has-lang.md
-        "jsx-a11y/html-has-lang": "error",
-        // Prevent redundant alt text like "image of..." — screen readers add this
-        // https://github.com/jsx-eslint/eslint-plugin-jsx-a11y/blob/main/docs/rules/img-redundant-alt.md
-        "jsx-a11y/img-redundant-alt": "error",
-        // Every form label must be associated with a control
-        // https://github.com/jsx-eslint/eslint-plugin-jsx-a11y/blob/main/docs/rules/label-has-associated-control.md
-        "jsx-a11y/label-has-associated-control": "error",
-        // Mouse event handlers must have keyboard equivalents
-        // https://github.com/jsx-eslint/eslint-plugin-jsx-a11y/blob/main/docs/rules/mouse-events-have-key-events.md
-        "jsx-a11y/mouse-events-have-key-events": "error",
-        // No accessKey attribute — inconsistent shortcuts confuse users
-        // https://github.com/jsx-eslint/eslint-plugin-jsx-a11y/blob/main/docs/rules/no-access-key.md
-        "jsx-a11y/no-access-key": "error",
-        // No autofocus attribute (except non-DOM) — disorienting for screen readers
-        // https://github.com/jsx-eslint/eslint-plugin-jsx-a11y/blob/main/docs/rules/no-autofocus.md
-        "jsx-a11y/no-autofocus": ["error", { ignoreNonDOM: true }],
-        // No <marquee>/<blink> — deprecated distracting elements
-        // https://github.com/jsx-eslint/eslint-plugin-jsx-a11y/blob/main/docs/rules/no-distracting-elements.md
-        "jsx-a11y/no-distracting-elements": "error",
-        // No redundant ARIA roles (e.g., <button role="button">)
-        // https://github.com/jsx-eslint/eslint-plugin-jsx-a11y/blob/main/docs/rules/no-redundant-roles.md
-        "jsx-a11y/no-redundant-roles": "error",
-        // Role elements must have all required ARIA props
-        // https://github.com/jsx-eslint/eslint-plugin-jsx-a11y/blob/main/docs/rules/role-has-required-aria-props.md
-        "jsx-a11y/role-has-required-aria-props": "error",
-        // Don't use unsupported ARIA attributes for a given role
-        // https://github.com/jsx-eslint/eslint-plugin-jsx-a11y/blob/main/docs/rules/role-supports-aria-props.md
-        "jsx-a11y/role-supports-aria-props": "error",
-        // scope attribute only on <th> elements — HTML specification
-        // https://github.com/jsx-eslint/eslint-plugin-jsx-a11y/blob/main/docs/rules/scope.md
-        "jsx-a11y/scope": "error",
-        // No positive tabIndex values — disrupts natural tab order
-        // https://github.com/jsx-eslint/eslint-plugin-jsx-a11y/blob/main/docs/rules/tabindex-no-positive.md
-        "jsx-a11y/tabindex-no-positive": "error",
-        // Validate lang attribute values — e.g. "de" ok, "deutsch" not
-        // https://github.com/jsx-eslint/eslint-plugin-jsx-a11y/blob/main/docs/rules/lang.md
-        "jsx-a11y/lang": "error",
-        // Validate autocomplete attribute values on form elements
-        // https://github.com/jsx-eslint/eslint-plugin-jsx-a11y/blob/main/docs/rules/autocomplete-valid.md
-        "jsx-a11y/autocomplete-valid": "error"
+      parserOptions: {
+        ecmaFeatures: {
+          jsx: true
+        }
       }
     }
-  ];
+  });
+  addExtraReactRules(builder);
+  addStylisticReactRules(builder);
+  addReactRefreshRules(builder);
+  addAccessibilityRules(builder);
+  if (isAi) {
+    applyAiReactRules(builder);
+  }
+  addReactFileOverrides(builder);
+  return builder.build();
 }
 
 // src/configs/react-effect.ts
@@ -1415,11 +1200,21 @@ function reactEffectConfig() {
 
 // src/configs/regexp.ts
 import { configs as regexpConfigs } from "eslint-plugin-regexp";
-function regexpConfig() {
-  return createConfig({
+function regexpConfig(opts) {
+  const isAi = opts?.ai ?? false;
+  const builder = createConfig({
     name: "eslint-config-setup/regexp",
     presets: [regexpConfigs["flat/recommended"]]
-  }).addRule("regexp/no-control-character", "error").addRule("regexp/no-octal", "error").addRule("regexp/no-standalone-backslash", "error").addRule("regexp/no-super-linear-move", "error").addRule("regexp/prefer-escape-replacement-dollar-char", "error").build();
+  }).addRule("regexp/no-control-character", "error").addRule("regexp/no-octal", "error").addRule("regexp/no-standalone-backslash", "error").addRule("regexp/no-super-linear-move", "error").addRule("regexp/prefer-escape-replacement-dollar-char", "error");
+  if (isAi) {
+    builder.addRule("regexp/prefer-lookaround", "error");
+    builder.addRule("regexp/prefer-named-backreference", "error");
+    builder.addRule("regexp/prefer-named-replacement", "error");
+    builder.addRule("regexp/prefer-quantifier", "error");
+    builder.addRule("regexp/prefer-result-array-groups", "error");
+    builder.addRule("regexp/require-unicode-sets-regexp", "error");
+  }
+  return builder.build();
 }
 
 // src/configs/security.ts
@@ -1485,13 +1280,12 @@ function securityConfig() {
 
 // src/configs/sonarjs.ts
 import sonarjsPlugin from "eslint-plugin-sonarjs";
-function sonarjsConfig() {
-  return [
-    {
-      name: "eslint-config-setup/sonarjs",
-      plugins: {
-        sonarjs: sonarjsPlugin
-      },
+function sonarjsConfig(opts) {
+  const isAi = opts?.ai === true;
+  const builder = createConfig({
+    name: "eslint-config-setup/sonarjs",
+    presets: [{
+      plugins: { sonarjs: sonarjsPlugin },
       rules: {
         // Detect copy-pasted functions — extract to shared helper instead
         // https://sonarsource.github.io/rspec/#/rspec/S4144/javascript
@@ -1554,13 +1348,24 @@ function sonarjsConfig() {
         // https://sonarsource.github.io/rspec/#/rspec/S6418/javascript
         "sonarjs/no-hardcoded-secrets": "warn"
       }
-    }
-  ];
+    }]
+  });
+  if (isAi) {
+    builder.addRule("sonarjs/no-nested-switch", "error");
+    builder.addRule("sonarjs/no-nested-template-literals", "error");
+    builder.addRule("sonarjs/max-union-size", ["error", { threshold: 5 }]);
+    builder.addRule("sonarjs/prefer-type-guard", "error");
+    builder.addRule("sonarjs/public-static-readonly", "error");
+    builder.addRule("sonarjs/no-duplicate-string", ["error", { threshold: 3 }]);
+  }
+  return builder.build();
 }
 
 // src/configs/typescript.ts
 import tseslint from "typescript-eslint";
-function typescriptConfig() {
+function typescriptConfig(opts) {
+  const isAi = opts?.ai ?? false;
+  const isReact = opts?.react ?? false;
   const typeChecked = tseslint.configs.strictTypeChecked;
   const stylistic = tseslint.configs.stylisticTypeChecked;
   const structuralBlocks = typeChecked.slice(0, 2);
@@ -1569,6 +1374,8 @@ function typescriptConfig() {
     name: "eslint-config-setup/typescript",
     passthrough: structuralBlocks,
     presets: ruleBlocks,
+    files: [...TYPESCRIPT_SOURCE_FILES],
+    ignores: [...MARKDOWN_CODE_BLOCK_FILES],
     languageOptions: {
       parserOptions: {
         // Use project service for automatic tsconfig resolution
@@ -1597,10 +1404,25 @@ function typescriptConfig() {
     "error",
     "in-try-catch"
   ]);
-  builder.overrideRule("@typescript-eslint/no-deprecated", "warn");
+  builder.overrideSeverity("@typescript-eslint/no-deprecated", "warn");
+  builder.overrideRule("@typescript-eslint/no-explicit-any", [
+    "warn",
+    { fixToUnknown: true }
+  ]);
+  builder.overrideRule("@typescript-eslint/consistent-type-definitions", [
+    "error",
+    "type"
+  ]);
+  builder.overrideOptions("@typescript-eslint/ban-ts-comment", {
+    "ts-expect-error": "allow-with-description"
+  });
+  builder.overrideOptions("@typescript-eslint/no-floating-promises", {
+    checkThenables: true,
+    ignoreIIFE: true
+  });
   builder.addRule("@typescript-eslint/consistent-type-imports", [
     "error",
-    { fixStyle: "inline-type-imports" }
+    { fixStyle: isAi ? "inline-type-imports" : "separate-type-imports" }
   ]);
   builder.addRule("@typescript-eslint/consistent-type-exports", [
     "error",
@@ -1614,6 +1436,24 @@ function typescriptConfig() {
     "error"
   );
   builder.addRule("@typescript-eslint/strict-void-return", "error");
+  builder.addRule("@typescript-eslint/prefer-readonly", isAi ? "error" : "warn");
+  builder.addRule("@typescript-eslint/require-array-sort-compare", [
+    "error",
+    { ignoreStringArrays: true }
+  ]);
+  builder.addRule("@typescript-eslint/no-unsafe-type-assertion", "error");
+  builder.addRule("@typescript-eslint/switch-exhaustiveness-check", [
+    "error",
+    {
+      allowDefaultCaseForExhaustiveSwitch: false,
+      requireDefaultForNonUnion: true
+    }
+  ]);
+  builder.addRule("@typescript-eslint/promise-function-async", "error");
+  builder.addRule("@typescript-eslint/method-signature-style", [
+    "error",
+    "property"
+  ]);
   builder.addRule("no-shadow", "off");
   builder.addRule("@typescript-eslint/no-shadow", [
     "error",
@@ -1624,10 +1464,7 @@ function typescriptConfig() {
       ignoreFunctionTypeParameterNameValueShadow: true
     }
   ]);
-  builder.overrideRule("@typescript-eslint/restrict-template-expressions", [
-    "error",
-    { allowNumber: true }
-  ]);
+  builder.overrideOptions("@typescript-eslint/restrict-template-expressions", { allowNumber: true });
   builder.addRule("@typescript-eslint/strict-boolean-expressions", [
     "error",
     { allowNullableBoolean: true, allowNullableObject: true }
@@ -1637,18 +1474,168 @@ function typescriptConfig() {
     ["**/*.{js,mjs,cjs}"],
     tseslint.configs.disableTypeChecked.rules ?? {}
   );
+  if (isAi) {
+    builder.overrideSeverity("@typescript-eslint/no-explicit-any", "error");
+    builder.overrideRule("@typescript-eslint/no-floating-promises", [
+      "error",
+      { checkThenables: true, ignoreVoid: true }
+    ]);
+    builder.addRule("@typescript-eslint/no-magic-numbers", [
+      "error",
+      {
+        ignore: [-1, 0, 1, 2],
+        ignoreArrayIndexes: true,
+        ignoreDefaultValues: true,
+        enforceConst: true,
+        ignoreClassFieldInitialValues: true,
+        ignoreEnums: true,
+        ignoreNumericLiteralTypes: true,
+        ignoreReadonlyClassProperties: true,
+        ignoreTypeIndexes: true
+      }
+    ]);
+    builder.addRule("@typescript-eslint/explicit-function-return-type", [
+      "error",
+      {
+        allowExpressions: true,
+        allowTypedFunctionExpressions: true,
+        allowHigherOrderFunctions: true,
+        allowIIFEs: true
+      }
+    ]);
+    builder.addRule(
+      "@typescript-eslint/explicit-member-accessibility",
+      "error"
+    );
+    builder.addRule(
+      "@typescript-eslint/prefer-enum-initializers",
+      "error"
+    );
+    builder.addRule("@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: [
+          "classProperty",
+          "parameterProperty",
+          "classMethod",
+          "objectLiteralMethod",
+          "typeMethod",
+          "accessor"
+        ],
+        format: ["strictCamelCase"],
+        leadingUnderscore: "allowSingleOrDouble",
+        trailingUnderscore: "allow",
+        filter: { regex: "[- ]", match: false }
+      },
+      {
+        selector: ["objectLiteralProperty", "typeProperty"],
+        format: null
+      },
+      { selector: "typeLike", format: ["StrictPascalCase"] },
+      {
+        selector: "interface",
+        format: ["StrictPascalCase"],
+        custom: { regex: "^I[A-Z]", match: false }
+      },
+      {
+        selector: "typeParameter",
+        format: ["PascalCase"],
+        custom: {
+          regex: "^(T([A-Z][a-zA-Z]*)?|[A-Z])$",
+          match: true
+        }
+      },
+      {
+        selector: "variable",
+        types: ["boolean"],
+        format: ["StrictPascalCase"],
+        prefix: ["is", "has", "can", "should", "will", "did"]
+      },
+      {
+        selector: ["classProperty", "objectLiteralProperty"],
+        format: null,
+        modifiers: ["requiresQuotes"]
+      }
+    ]);
+    builder.addRule("@typescript-eslint/member-ordering", [
+      "warn",
+      {
+        default: [
+          "signature",
+          "call-signature",
+          "public-static-field",
+          "protected-static-field",
+          "private-static-field",
+          "#private-static-field",
+          "static-field",
+          "public-static-method",
+          "protected-static-method",
+          "private-static-method",
+          "#private-static-method",
+          "static-method",
+          "public-decorated-field",
+          "protected-decorated-field",
+          "private-decorated-field",
+          "public-instance-field",
+          "protected-instance-field",
+          "private-instance-field",
+          "#private-instance-field",
+          "public-abstract-field",
+          "protected-abstract-field",
+          "field",
+          "public-constructor",
+          "protected-constructor",
+          "private-constructor",
+          "constructor",
+          ["public-get", "public-set"],
+          ["protected-get", "protected-set"],
+          ["private-get", "private-set"],
+          ["#private-get", "#private-set"],
+          "public-decorated-method",
+          "protected-decorated-method",
+          "private-decorated-method",
+          "public-instance-method",
+          "protected-instance-method",
+          "private-instance-method",
+          "#private-instance-method",
+          "public-abstract-method",
+          "protected-abstract-method",
+          "method"
+        ]
+      }
+    ]);
+  }
   return builder.build();
 }
 
 // src/configs/unicorn.ts
 import unicornPlugin from "eslint-plugin-unicorn";
-function unicornConfig() {
-  return [
-    {
-      name: "eslint-config-setup/unicorn",
-      plugins: {
-        unicorn: unicornPlugin
-      },
+function unicornConfig(opts) {
+  const isAi = opts?.ai === true;
+  const builder = createConfig({
+    name: "eslint-config-setup/unicorn",
+    presets: [{
+      plugins: { unicorn: unicornPlugin },
       rules: {
         // ── Error prevention ──────────────────────────────────────────
         // Forbid `/* eslint-disable */` without specific rule — too broad
@@ -1678,9 +1665,11 @@ function unicornConfig() {
         // Remove useless Promise.resolve/reject wrappers — simplify async code
         // https://github.com/sindresorhus/eslint-plugin-unicorn/blob/main/docs/rules/no-useless-promise-resolve-reject.md
         "unicorn/no-useless-promise-resolve-reject": "error",
-        // Disallow `return undefined` — implicit undefined is cleaner
+        // Disallow redundant undefined where omission preserves semantics.
+        // Keep call arguments unchecked: TypeScript often needs explicit
+        // `undefined` for required parameters typed as `T | undefined`.
         // https://github.com/sindresorhus/eslint-plugin-unicorn/blob/main/docs/rules/no-useless-undefined.md
-        "unicorn/no-useless-undefined": "error",
+        "unicorn/no-useless-undefined": ["warn", { checkArguments: false }],
         // Disallow `await` in Promise.all/race arguments — already a promise
         // https://github.com/sindresorhus/eslint-plugin-unicorn/blob/main/docs/rules/no-await-in-promise-methods.md
         "unicorn/no-await-in-promise-methods": "error",
@@ -1736,6 +1725,28 @@ function unicornConfig() {
         // Enforce consistent style for indexOf/findIndex existence checks
         // https://github.com/sindresorhus/eslint-plugin-unicorn/blob/main/docs/rules/consistent-existence-index-check.md
         "unicorn/consistent-existence-index-check": "error",
+        // Move functions to the smallest possible scope — avoids re-creation on every call,
+        // improves testability, and makes dependencies explicit
+        // https://github.com/sindresorhus/eslint-plugin-unicorn/blob/main/docs/rules/consistent-function-scoping.md
+        "unicorn/consistent-function-scoping": "warn",
+        // Enforce consistent filename casing — camelCase, PascalCase, or kebab-case (no snake_case)
+        // https://github.com/sindresorhus/eslint-plugin-unicorn/blob/main/docs/rules/filename-case.md
+        "unicorn/filename-case": [
+          "error",
+          {
+            cases: {
+              camelCase: true,
+              pascalCase: true,
+              kebabCase: true
+            }
+          }
+        ],
+        // Discourage Array.reduce() — hard to read for many developers, prefer for...of or other methods
+        // https://github.com/sindresorhus/eslint-plugin-unicorn/blob/main/docs/rules/no-array-reduce.md
+        "unicorn/no-array-reduce": "warn",
+        // Prefer for...of over C-style for loops — more readable when index isn't needed
+        // https://github.com/sindresorhus/eslint-plugin-unicorn/blob/main/docs/rules/no-for-loop.md
+        "unicorn/no-for-loop": "warn",
         // ── Modern API preferences ────────────────────────────────────
         // Prefer .flatMap() over .map().flat() — single pass, more readable
         // https://github.com/sindresorhus/eslint-plugin-unicorn/blob/main/docs/rules/prefer-array-flat-map.md
@@ -1761,6 +1772,9 @@ function unicornConfig() {
         // Prefer .before()/.after()/.replaceWith() over parent.insertBefore()
         // https://github.com/sindresorhus/eslint-plugin-unicorn/blob/main/docs/rules/prefer-modern-dom-apis.md
         "unicorn/prefer-modern-dom-apis": "error",
+        // Prefer element.dataset.foo over setAttribute('data-foo') — modern, readable
+        // https://github.com/sindresorhus/eslint-plugin-unicorn/blob/main/docs/rules/prefer-dom-node-dataset.md
+        "unicorn/prefer-dom-node-dataset": "error",
         // Prefer Math.log10/Math.hypot over manual math — accurate and readable
         // https://github.com/sindresorhus/eslint-plugin-unicorn/blob/main/docs/rules/prefer-modern-math-apis.md
         "unicorn/prefer-modern-math-apis": "error",
@@ -1866,8 +1880,27 @@ function unicornConfig() {
         // https://github.com/sindresorhus/eslint-plugin-unicorn/blob/main/docs/rules/prefer-single-call.md
         "unicorn/prefer-single-call": "off"
       }
-    }
-  ];
+    }]
+  });
+  if (isAi) {
+    builder.overrideSeverity("unicorn/consistent-function-scoping", "error");
+    builder.overrideSeverity("unicorn/no-array-reduce", "error");
+    builder.overrideSeverity("unicorn/no-for-loop", "error");
+    builder.addRule("unicorn/no-array-for-each", "error");
+    builder.addRule("unicorn/prefer-ternary", ["error", "only-single-line"]);
+    builder.addRule("unicorn/prefer-switch", ["error", { minimumCases: 3 }]);
+    builder.addRule("unicorn/prevent-abbreviations", "error");
+    builder.addRule("unicorn/no-useless-switch-case", "error");
+    builder.addRule("unicorn/custom-error-definition", "error");
+    builder.addRule("unicorn/prefer-default-parameters", "error");
+    builder.addRule("unicorn/prefer-logical-operator-over-ternary", "error");
+    builder.addRule("unicorn/prefer-math-min-max", "error");
+    builder.addRule("unicorn/prefer-set-size", "error");
+    builder.addRule("unicorn/explicit-length-check", "error");
+    builder.addRule("unicorn/switch-case-braces", "error");
+    builder.addRule("unicorn/no-array-push-push", "error");
+  }
+  return builder.build();
 }
 
 // src/overrides/config-files.ts
@@ -2100,136 +2133,165 @@ function storiesOverride() {
 // src/overrides/tests.ts
 import vitestPlugin from "@vitest/eslint-plugin";
 import testingLibraryPlugin from "eslint-plugin-testing-library";
+var TEST_FILES2 = ["**/*.test.{ts,tsx}", "**/__tests__/**/*.{ts,tsx}"];
+var VITEST_RULES = {
+  // ── Vitest rules ──────────────────────────────────────────────
+  // Every test must contain at least one assertion
+  // https://github.com/vitest-dev/eslint-plugin-vitest/blob/main/docs/rules/expect-expect.md
+  "vitest/expect-expect": "error",
+  // Prevent duplicate test titles within a describe block
+  // https://github.com/vitest-dev/eslint-plugin-vitest/blob/main/docs/rules/no-identical-title.md
+  "vitest/no-identical-title": "error",
+  // No it.only / describe.only — prevents accidentally skipping tests in CI
+  // https://github.com/vitest-dev/eslint-plugin-vitest/blob/main/docs/rules/no-focused-tests.md
+  "vitest/no-focused-tests": "error",
+  // Warn on it.skip / describe.skip — track disabled tests
+  // https://github.com/vitest-dev/eslint-plugin-vitest/blob/main/docs/rules/no-disabled-tests.md
+  "vitest/no-disabled-tests": "warn",
+  // No duplicate beforeEach/afterEach hooks — merge them
+  // https://github.com/vitest-dev/eslint-plugin-vitest/blob/main/docs/rules/no-duplicate-hooks.md
+  "vitest/no-duplicate-hooks": "error",
+  // Prefer .toBe() over .toEqual() for primitives — clearer intent
+  // https://github.com/vitest-dev/eslint-plugin-vitest/blob/main/docs/rules/prefer-to-be.md
+  "vitest/prefer-to-be": "error",
+  // Prefer .toHaveLength() over .toBe(arr.length) — better errors
+  // https://github.com/vitest-dev/eslint-plugin-vitest/blob/main/docs/rules/prefer-to-have-length.md
+  "vitest/prefer-to-have-length": "error",
+  // Validate expect() usage — no dangling expect without assertion
+  // https://github.com/vitest-dev/eslint-plugin-vitest/blob/main/docs/rules/valid-expect.md
+  "vitest/valid-expect": "error",
+  // Validate test/describe title format — no empty or invalid titles
+  // https://github.com/vitest-dev/eslint-plugin-vitest/blob/main/docs/rules/valid-title.md
+  "vitest/valid-title": "error",
+  // No conditional logic (if/else) inside tests — split into separate tests
+  // https://github.com/vitest-dev/eslint-plugin-vitest/blob/main/docs/rules/no-conditional-in-test.md
+  "vitest/no-conditional-in-test": "error",
+  // No expect() inside conditional blocks — always assert unconditionally
+  // https://github.com/vitest-dev/eslint-plugin-vitest/blob/main/docs/rules/no-conditional-expect.md
+  "vitest/no-conditional-expect": "error",
+  // No standalone expect() outside test blocks — always wrap in it/test
+  // https://github.com/vitest-dev/eslint-plugin-vitest/blob/main/docs/rules/no-standalone-expect.md
+  "vitest/no-standalone-expect": "error",
+  // Prefer .toStrictEqual() over .toEqual() — catches undefined vs missing
+  // https://github.com/vitest-dev/eslint-plugin-vitest/blob/main/docs/rules/prefer-strict-equal.md
+  "vitest/prefer-strict-equal": "error",
+  // Prefer vi.spyOn() over vi.fn() for method mocks — preserves original
+  // https://github.com/vitest-dev/eslint-plugin-vitest/blob/main/docs/rules/prefer-spy-on.md
+  "vitest/prefer-spy-on": "error",
+  // Require message argument in toThrow/toThrowError — verify correct error
+  // https://github.com/vitest-dev/eslint-plugin-vitest/blob/main/docs/rules/require-to-throw-message.md
+  "vitest/require-to-throw-message": "error",
+  // ── Relaxed rules for tests ───────────────────────────────────
+  // Tests are naturally verbose and use patterns banned in prod code
+  // Tests can be long (setup + many assertions)
+  "max-lines": "off",
+  "max-lines-per-function": "off",
+  "max-statements": "off",
+  // Tests often need `any` for mocking and type assertions
+  "@typescript-eslint/no-explicit-any": "off",
+  "@typescript-eslint/no-non-null-assertion": "off",
+  "@typescript-eslint/no-unsafe-assignment": "off",
+  "@typescript-eslint/no-unsafe-member-access": "off"
+};
+var TESTING_LIBRARY_RULES = {
+  // ── Testing Library rules ───────────────────────────────────
+  // Await async events (userEvent.click, etc.) — prevents race conditions
+  // https://github.com/testing-library/eslint-plugin-testing-library/blob/main/docs/rules/await-async-events.md
+  "testing-library/await-async-events": "error",
+  // Await async queries (findBy*) — they return promises
+  // https://github.com/testing-library/eslint-plugin-testing-library/blob/main/docs/rules/await-async-queries.md
+  "testing-library/await-async-queries": "error",
+  // Await async utilities (waitFor, waitForElementToBeRemoved)
+  // https://github.com/testing-library/eslint-plugin-testing-library/blob/main/docs/rules/await-async-utils.md
+  "testing-library/await-async-utils": "error",
+  // Don't await synchronous events — misleading
+  // https://github.com/testing-library/eslint-plugin-testing-library/blob/main/docs/rules/no-await-sync-events.md
+  "testing-library/no-await-sync-events": "error",
+  // Don't await synchronous queries (getBy*, queryBy*) — not promises
+  // https://github.com/testing-library/eslint-plugin-testing-library/blob/main/docs/rules/no-await-sync-queries.md
+  "testing-library/no-await-sync-queries": "error",
+  // Don't use container.querySelector — use queries instead
+  // https://github.com/testing-library/eslint-plugin-testing-library/blob/main/docs/rules/no-container.md
+  "testing-library/no-container": "error",
+  // Warn on debug()/prettyDOM() left in tests — debugging artifacts
+  // https://github.com/testing-library/eslint-plugin-testing-library/blob/main/docs/rules/no-debugging-utils.md
+  "testing-library/no-debugging-utils": "warn",
+  // Don't access DOM nodes directly — use queries
+  // https://github.com/testing-library/eslint-plugin-testing-library/blob/main/docs/rules/no-node-access.md
+  "testing-library/no-node-access": "error",
+  // Don't call render in beforeEach — call in each test
+  // https://github.com/testing-library/eslint-plugin-testing-library/blob/main/docs/rules/no-render-in-lifecycle.md
+  "testing-library/no-render-in-lifecycle": "error",
+  // No unnecessary act() wrappers — TL handles this internally
+  // https://github.com/testing-library/eslint-plugin-testing-library/blob/main/docs/rules/no-unnecessary-act.md
+  "testing-library/no-unnecessary-act": "error",
+  // One assertion per waitFor — multiple can mask failures
+  // https://github.com/testing-library/eslint-plugin-testing-library/blob/main/docs/rules/no-wait-for-multiple-assertions.md
+  "testing-library/no-wait-for-multiple-assertions": "error",
+  // No side effects in waitFor — only assertions
+  // https://github.com/testing-library/eslint-plugin-testing-library/blob/main/docs/rules/no-wait-for-side-effects.md
+  "testing-library/no-wait-for-side-effects": "error",
+  // Prefer findBy* over waitFor + getBy* — built-in combination
+  // https://github.com/testing-library/eslint-plugin-testing-library/blob/main/docs/rules/prefer-find-by.md
+  "testing-library/prefer-find-by": "error",
+  // Use getBy* (throws) for present elements, queryBy* for absent
+  // https://github.com/testing-library/eslint-plugin-testing-library/blob/main/docs/rules/prefer-presence-queries.md
+  "testing-library/prefer-presence-queries": "error",
+  // Use queryBy* for disappearance checks — returns null when gone
+  // https://github.com/testing-library/eslint-plugin-testing-library/blob/main/docs/rules/prefer-query-by-disappearance.md
+  "testing-library/prefer-query-by-disappearance": "error",
+  // Use screen.getBy* over destructured render result — consistent
+  // https://github.com/testing-library/eslint-plugin-testing-library/blob/main/docs/rules/prefer-screen-queries.md
+  "testing-library/prefer-screen-queries": "error",
+  // Name render result consistently (e.g., `const { getByText } = render(...)`)
+  // https://github.com/testing-library/eslint-plugin-testing-library/blob/main/docs/rules/render-result-naming-convention.md
+  "testing-library/render-result-naming-convention": "error"
+};
 function testsOverride() {
-  const configs = [
+  return [
     {
       name: "eslint-config-setup/tests",
-      files: ["**/*.test.{ts,tsx}", "**/__tests__/**/*.{ts,tsx}"],
+      files: TEST_FILES2,
       plugins: {
         vitest: vitestPlugin
       },
-      rules: {
-        // ── Vitest rules ──────────────────────────────────────────────
-        // Every test must contain at least one assertion
-        // https://github.com/vitest-dev/eslint-plugin-vitest/blob/main/docs/rules/expect-expect.md
-        "vitest/expect-expect": "error",
-        // Prevent duplicate test titles within a describe block
-        // https://github.com/vitest-dev/eslint-plugin-vitest/blob/main/docs/rules/no-identical-title.md
-        "vitest/no-identical-title": "error",
-        // No it.only / describe.only — prevents accidentally skipping tests in CI
-        // https://github.com/vitest-dev/eslint-plugin-vitest/blob/main/docs/rules/no-focused-tests.md
-        "vitest/no-focused-tests": "error",
-        // Warn on it.skip / describe.skip — track disabled tests
-        // https://github.com/vitest-dev/eslint-plugin-vitest/blob/main/docs/rules/no-disabled-tests.md
-        "vitest/no-disabled-tests": "warn",
-        // No duplicate beforeEach/afterEach hooks — merge them
-        // https://github.com/vitest-dev/eslint-plugin-vitest/blob/main/docs/rules/no-duplicate-hooks.md
-        "vitest/no-duplicate-hooks": "error",
-        // Prefer .toBe() over .toEqual() for primitives — clearer intent
-        // https://github.com/vitest-dev/eslint-plugin-vitest/blob/main/docs/rules/prefer-to-be.md
-        "vitest/prefer-to-be": "error",
-        // Prefer .toHaveLength() over .toBe(arr.length) — better errors
-        // https://github.com/vitest-dev/eslint-plugin-vitest/blob/main/docs/rules/prefer-to-have-length.md
-        "vitest/prefer-to-have-length": "error",
-        // Validate expect() usage — no dangling expect without assertion
-        // https://github.com/vitest-dev/eslint-plugin-vitest/blob/main/docs/rules/valid-expect.md
-        "vitest/valid-expect": "error",
-        // Validate test/describe title format — no empty or invalid titles
-        // https://github.com/vitest-dev/eslint-plugin-vitest/blob/main/docs/rules/valid-title.md
-        "vitest/valid-title": "error",
-        // No conditional logic (if/else) inside tests — split into separate tests
-        // https://github.com/vitest-dev/eslint-plugin-vitest/blob/main/docs/rules/no-conditional-in-test.md
-        "vitest/no-conditional-in-test": "error",
-        // No expect() inside conditional blocks — always assert unconditionally
-        // https://github.com/vitest-dev/eslint-plugin-vitest/blob/main/docs/rules/no-conditional-expect.md
-        "vitest/no-conditional-expect": "error",
-        // No standalone expect() outside test blocks — always wrap in it/test
-        // https://github.com/vitest-dev/eslint-plugin-vitest/blob/main/docs/rules/no-standalone-expect.md
-        "vitest/no-standalone-expect": "error",
-        // Prefer .toStrictEqual() over .toEqual() — catches undefined vs missing
-        // https://github.com/vitest-dev/eslint-plugin-vitest/blob/main/docs/rules/prefer-strict-equal.md
-        "vitest/prefer-strict-equal": "error",
-        // Prefer vi.spyOn() over vi.fn() for method mocks — preserves original
-        // https://github.com/vitest-dev/eslint-plugin-vitest/blob/main/docs/rules/prefer-spy-on.md
-        "vitest/prefer-spy-on": "error",
-        // Require message argument in toThrow/toThrowError — verify correct error
-        // https://github.com/vitest-dev/eslint-plugin-vitest/blob/main/docs/rules/require-to-throw-message.md
-        "vitest/require-to-throw-message": "error",
-        // ── Relaxed rules for tests ───────────────────────────────────
-        // Tests are naturally verbose and use patterns banned in prod code
-        // Tests can be long (setup + many assertions)
-        "max-lines": "off",
-        "max-lines-per-function": "off",
-        "max-statements": "off",
-        // Tests often need `any` for mocking and type assertions
-        "@typescript-eslint/no-explicit-any": "off",
-        "@typescript-eslint/no-non-null-assertion": "off",
-        "@typescript-eslint/no-unsafe-assignment": "off",
-        "@typescript-eslint/no-unsafe-member-access": "off"
-      }
+      rules: VITEST_RULES
     },
     {
       name: "eslint-config-setup/tests-testing-library",
-      files: ["**/*.test.{ts,tsx}", "**/__tests__/**/*.{ts,tsx}"],
+      files: TEST_FILES2,
       plugins: {
         "testing-library": testingLibraryPlugin
       },
-      rules: {
-        // ── Testing Library rules ───────────────────────────────────
-        // Await async events (userEvent.click, etc.) — prevents race conditions
-        // https://github.com/testing-library/eslint-plugin-testing-library/blob/main/docs/rules/await-async-events.md
-        "testing-library/await-async-events": "error",
-        // Await async queries (findBy*) — they return promises
-        // https://github.com/testing-library/eslint-plugin-testing-library/blob/main/docs/rules/await-async-queries.md
-        "testing-library/await-async-queries": "error",
-        // Await async utilities (waitFor, waitForElementToBeRemoved)
-        // https://github.com/testing-library/eslint-plugin-testing-library/blob/main/docs/rules/await-async-utils.md
-        "testing-library/await-async-utils": "error",
-        // Don't await synchronous events — misleading
-        // https://github.com/testing-library/eslint-plugin-testing-library/blob/main/docs/rules/no-await-sync-events.md
-        "testing-library/no-await-sync-events": "error",
-        // Don't await synchronous queries (getBy*, queryBy*) — not promises
-        // https://github.com/testing-library/eslint-plugin-testing-library/blob/main/docs/rules/no-await-sync-queries.md
-        "testing-library/no-await-sync-queries": "error",
-        // Don't use container.querySelector — use queries instead
-        // https://github.com/testing-library/eslint-plugin-testing-library/blob/main/docs/rules/no-container.md
-        "testing-library/no-container": "error",
-        // Warn on debug()/prettyDOM() left in tests — debugging artifacts
-        // https://github.com/testing-library/eslint-plugin-testing-library/blob/main/docs/rules/no-debugging-utils.md
-        "testing-library/no-debugging-utils": "warn",
-        // Don't access DOM nodes directly — use queries
-        // https://github.com/testing-library/eslint-plugin-testing-library/blob/main/docs/rules/no-node-access.md
-        "testing-library/no-node-access": "error",
-        // Don't call render in beforeEach — call in each test
-        // https://github.com/testing-library/eslint-plugin-testing-library/blob/main/docs/rules/no-render-in-lifecycle.md
-        "testing-library/no-render-in-lifecycle": "error",
-        // No unnecessary act() wrappers — TL handles this internally
-        // https://github.com/testing-library/eslint-plugin-testing-library/blob/main/docs/rules/no-unnecessary-act.md
-        "testing-library/no-unnecessary-act": "error",
-        // One assertion per waitFor — multiple can mask failures
-        // https://github.com/testing-library/eslint-plugin-testing-library/blob/main/docs/rules/no-wait-for-multiple-assertions.md
-        "testing-library/no-wait-for-multiple-assertions": "error",
-        // No side effects in waitFor — only assertions
-        // https://github.com/testing-library/eslint-plugin-testing-library/blob/main/docs/rules/no-wait-for-side-effects.md
-        "testing-library/no-wait-for-side-effects": "error",
-        // Prefer findBy* over waitFor + getBy* — built-in combination
-        // https://github.com/testing-library/eslint-plugin-testing-library/blob/main/docs/rules/prefer-find-by.md
-        "testing-library/prefer-find-by": "error",
-        // Use getBy* (throws) for present elements, queryBy* for absent
-        // https://github.com/testing-library/eslint-plugin-testing-library/blob/main/docs/rules/prefer-presence-queries.md
-        "testing-library/prefer-presence-queries": "error",
-        // Use queryBy* for disappearance checks — returns null when gone
-        // https://github.com/testing-library/eslint-plugin-testing-library/blob/main/docs/rules/prefer-query-by-disappearance.md
-        "testing-library/prefer-query-by-disappearance": "error",
-        // Use screen.getBy* over destructured render result — consistent
-        // https://github.com/testing-library/eslint-plugin-testing-library/blob/main/docs/rules/prefer-screen-queries.md
-        "testing-library/prefer-screen-queries": "error",
-        // Name render result consistently (e.g., `const { getByText } = render(...)`)
-        // https://github.com/testing-library/eslint-plugin-testing-library/blob/main/docs/rules/render-result-naming-convention.md
-        "testing-library/render-result-naming-convention": "error"
-      }
+      rules: TESTING_LIBRARY_RULES
     }
   ];
+}
+
+// src/oxlint/integration.ts
+import oxlintPlugin from "eslint-plugin-oxlint";
+function oxlintIntegration(opts) {
+  const typedPlugin = oxlintPlugin;
+  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) {
+    add("flat/react", "oxlint-react");
+    add("flat/jsx-a11y", "oxlint-jsx-a11y");
+  }
+  if (opts.node) {
+    add("flat/node", "oxlint-node");
+  }
+  add("flat/typescript", "oxlint-typescript");
+  add("flat/unicorn", "oxlint-unicorn");
+  add("flat/import", "oxlint-import");
+  add("flat/jsdoc", "oxlint-jsdoc");
   return configs;
 }
 
@@ -2284,65 +2346,24 @@ function standardComplexity() {
   ];
 }
 
-// src/oxlint/integration.ts
-import oxlintPlugin from "eslint-plugin-oxlint";
-function oxlintIntegration(opts) {
-  const typedPlugin = oxlintPlugin;
-  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) {
-    add("flat/react", "oxlint-react");
-    add("flat/jsx-a11y", "oxlint-jsx-a11y");
-  }
-  if (opts.node) {
-    add("flat/node", "oxlint-node");
-  }
-  add("flat/typescript", "oxlint-typescript");
-  add("flat/unicorn", "oxlint-unicorn");
-  add("flat/import", "oxlint-import");
-  add("flat/jsdoc", "oxlint-jsdoc");
-  return configs;
-}
-
-// src/configs/compat.ts
-import compatPlugin from "eslint-plugin-compat";
-function compatConfig() {
-  return [
-    {
-      name: "eslint-config-setup/compat",
-      plugins: {
-        compat: compatPlugin
-      },
-      rules: {
-        // Warn when using browser APIs not supported in browserslist targets
-        // https://github.com/amilajack/eslint-plugin-compat#usage
-        "compat/compat": "warn"
-      }
-    }
-  ];
-}
-
 // src/build/compose.ts
-function composeConfig(opts) {
-  const config = [];
-  config.push(...baseConfig());
-  config.push(...typescriptConfig());
-  config.push(...importsConfig());
-  config.push(...perfectionistConfig());
-  config.push(...unicornConfig());
-  config.push(...regexpConfig());
-  config.push(...jsdocConfig());
-  config.push(...cspellConfig());
-  config.push(...sonarjsConfig());
-  config.push(...securityConfig());
-  config.push(...deMorganConfig());
+function addCoreConfigs(config, opts) {
+  const ai = opts.ai;
+  config.push(
+    ...baseConfig({ ai }),
+    ...typescriptConfig({ ai, react: opts.react }),
+    ...importsConfig(),
+    ...perfectionistConfig(),
+    ...unicornConfig({ ai }),
+    ...regexpConfig({ ai }),
+    ...jsdocConfig({ ai }),
+    ...cspellConfig(),
+    ...sonarjsConfig({ ai }),
+    ...securityConfig(),
+    ...deMorganConfig()
+  );
+}
+function addConditionalConfigs(config, opts) {
   if (!opts.node) {
     config.push(...compatConfig());
   }
@@ -2350,30 +2371,40 @@ function composeConfig(opts) {
     config.push(...standardComplexity());
   }
   if (opts.node) {
-    config.push(...nodeConfig());
+    config.push(...nodeConfig({ ai: opts.ai }));
   }
   if (opts.react) {
-    config.push(...reactConfig());
+    config.push(...reactConfig({ ai: opts.ai }));
     config.push(...reactEffectConfig());
   }
   if (opts.ai) {
-    config.push(...aiConfig({ react: opts.react }));
+    config.push(...aiConfig());
     config.push(...perfectionistAiConfig());
     config.push(...packageJsonAiConfig());
   }
-  config.push(...testsOverride());
-  config.push(...e2eOverride());
-  config.push(...storiesOverride());
-  config.push(...configFilesOverride());
-  config.push(...declarationsOverride());
-  config.push(...scriptsOverride());
-  config.push(...jsonConfig());
-  config.push(...packageJsonConfig());
-  config.push(...markdownConfig());
-  config.push(...prettierCompatConfig());
+}
+function addFileTypeOverrides(config) {
+  config.push(
+    ...testsOverride(),
+    ...e2eOverride(),
+    ...storiesOverride(),
+    ...configFilesOverride(),
+    ...declarationsOverride(),
+    ...scriptsOverride()
+  );
+}
+function addFinalConfigs(config, opts) {
+  config.push(...jsonConfig(), ...packageJsonConfig(), ...markdownConfig(), ...prettierCompatConfig());
   if (opts.oxlint) {
     config.push(...oxlintIntegration(opts));
   }
+}
+function composeConfig(opts) {
+  const config = [];
+  addCoreConfigs(config, opts);
+  addConditionalConfigs(config, opts);
+  addFileTypeOverrides(config);
+  addFinalConfigs(config, opts);
   return config;
 }
 export {