eslint-config-setup 0.3.3 → 0.5.0

package/README.md

@@ -1,5 +1,6 @@
 # ESLint Config Setup
 
+[![Powered by Sebastian Software](https://img.shields.io/badge/Powered%20by-Sebastian%20Software-00718d?style=flat-square)](https://oss.sebastian-software.com)
 [![CI](https://github.com/sebastian-software/eslint-config-setup/actions/workflows/ci.yml/badge.svg)](https://github.com/sebastian-software/eslint-config-setup/actions/workflows/ci.yml)
 [![npm version](https://img.shields.io/npm/v/eslint-config-setup.svg)](https://www.npmjs.com/package/eslint-config-setup)
 [![npm downloads](https://img.shields.io/npm/dm/eslint-config-setup.svg)](https://www.npmjs.com/package/eslint-config-setup)
@@ -7,15 +8,15 @@
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![Node.js](https://img.shields.io/node/v/eslint-config-setup.svg)](https://nodejs.org)
 [![TypeScript](https://img.shields.io/badge/TypeScript-5.0+-blue.svg)](https://www.typescriptlang.org)
-[![ESLint](https://img.shields.io/badge/ESLint-9.22+-4B32C3.svg)](https://eslint.org)
+[![ESLint](https://img.shields.io/badge/ESLint-10+-4B32C3.svg)](https://eslint.org)
 
 The ESLint config for teams that ship with AI and want to move fast.
 
 Most ESLint configs compose rules at runtime from dozens of plugins. That means version conflicts, plugin mismatches, and "works on my machine" differences. **ESLint Config Setup** resolves every rule at build time — you get a flat, pre-built config where every rule is already decided. No runtime composition, no surprises.
 
 - **AI guardrails** — a dedicated `ai` mode that enforces what code review can't: explicit types, strict naming, no magic values, complexity limits. Rules that humans find tedious are trivial for an AI to follow. The AI doesn't push back. It just fixes the code.
-- **OxLint-ready** — a single `oxlint` flag disables every ESLint rule that OxLint already covers, and `getOxlintConfig()` generates a matching OxLint config. No manual migration, no rule conflicts, no coverage gaps. Run both linters, get the full rule set at 100x the speed.
-- **27 plugins, one import** — TypeScript (`strictTypeChecked`), React 19, import cycles, security, browser compat, spell checking, and more. Every rule pre-resolved at build time. No plugin conflicts, no version mismatches.
+- **OxLint-ready** — a single `oxlint` flag disables every ESLint rule that OxLint already covers, and `getOxlintConfig()` generates a matching OxLint config. No manual migration, no rule conflicts, no coverage gaps. Run both linters and keep the full rule surface.
+- **Curated plugin stack, one import** — TypeScript (`strictTypeChecked`), React 19, import cycles, security, browser compat, spell checking, and more. Every rule pre-resolved at build time. No plugin conflicts, no version mismatches.
 
 ```typescript
 // eslint.config.ts
@@ -37,6 +38,8 @@ import { getEslintConfig } from "eslint-config-setup"
 export default await getEslintConfig({ react: true })
 ```
 
+Requires Node.js >= 22, ESLint >= 10, and TypeScript >= 5.0.
+
 ## Configuration flags
 
 | Flag | Default | What it does |
@@ -64,12 +67,16 @@ export default config
 ## Documentation
 
 - [Getting Started](https://sebastian-software.github.io/eslint-config-setup/guide/getting-started) — installation and setup
+- [React Linting](https://sebastian-software.github.io/eslint-config-setup/guide/react) — React 19 rules, compat layer, and OxLint acceleration
 - [AI Mode](https://sebastian-software.github.io/eslint-config-setup/guide/ai-mode) — why AI-generated code needs different rules
 - [OxLint Integration](https://sebastian-software.github.io/eslint-config-setup/guide/oxlint) — run ESLint + OxLint without conflicts
-- [All 27 Plugins](https://sebastian-software.github.io/eslint-config-setup/guide/plugins) — what's included and why
+- [Included Plugins](https://sebastian-software.github.io/eslint-config-setup/guide/plugins) — what's included and why
 - [Configuration](https://sebastian-software.github.io/eslint-config-setup/guide/configuration) — flags and usage examples
 - [Rule API](https://sebastian-software.github.io/eslint-config-setup/guide/rule-api) — rule manipulation and scoped overrides
+- [File Conventions](https://sebastian-software.github.io/eslint-config-setup/guide/file-conventions) — automatic test/config/story/script overrides
+- [Modular Imports](https://sebastian-software.github.io/eslint-config-setup/guide/modular-imports) — compose individual config blocks manually
 - [Architecture](https://sebastian-software.github.io/eslint-config-setup/guide/architecture) — how pre-generation works
+- [Contributing](https://sebastian-software.github.io/eslint-config-setup/guide/contributing) — monorepo workflow, self-linting, and hooks
 
 ## Contributing
 
@@ -77,4 +84,19 @@ See [CONTRIBUTING.md](CONTRIBUTING.md) for development setup, architecture overv
 
 ## License
 
-[MIT](LICENSE) — Copyright (c) 2025 [Sebastian Software GmbH](https://sebastian-software.com)
+[MIT](LICENSE)
+
+---
+
+<!-- sebastian-software-branding:start -->
+<p align="center">
+  <a href="https://oss.sebastian-software.com">
+    <img src="https://sebastian-brand.vercel.app/sebastian-software/logo-software.svg" alt="Sebastian Software" width="240" />
+  </a>
+</p>
+
+<p align="center">
+  <a href="https://oss.sebastian-software.com">Open Source at Sebastian Software</a><br />
+  Copyright &copy; 2026 Sebastian Software GmbH
+</p>
+<!-- sebastian-software-branding:end -->

package/dist/configs/0b23ff88.js

@@ -7,8 +7,6 @@ import deMorganPlugin from "eslint-plugin-de-morgan"
 import importXPlugin from "eslint-plugin-import-x"
 import jsdocPlugin from "eslint-plugin-jsdoc"
 import jsonPlugin from "@eslint/json"
-import jsxA11yPlugin from "eslint-plugin-jsx-a11y"
-import nodePlugin from "eslint-plugin-n"
 import oxlintPlugin from "eslint-plugin-oxlint"
 import packageJsonPlugin from "eslint-plugin-package-json"
 import perfectionistPlugin from "eslint-plugin-perfectionist"
@@ -27,9 +25,10 @@ export default [
   // TypeScript parser setup
   ...tseslint.configs.strictTypeChecked.slice(0, 2),
 
-  // Base rules — all effective rules for *.ts files
+  // Base rules — all effective rules for TS plus shared JS/TS rules
   {
     name: "eslint-config-setup/base",
+    ignores: ["**/*.{md,mdx}"],
     plugins: {
       "@cspell": cspellPlugin,
       "@typescript-eslint": tseslint.plugin,
@@ -37,8 +36,6 @@ export default [
       "de-morgan": deMorganPlugin,
       "import": importXPlugin,
       "jsdoc": jsdocPlugin,
-      "jsx-a11y": jsxA11yPlugin,
-      "node": nodePlugin,
       "perfectionist": perfectionistPlugin,
       "regexp": regexpPlugin,
       "security": securityPlugin,
@@ -70,7 +67,6 @@ export default [
         }
       ],
       "@typescript-eslint/dot-notation": "error",
-      "@typescript-eslint/explicit-member-accessibility": "error",
       "@typescript-eslint/member-ordering": [
         "warn",
         {
@@ -130,10 +126,6 @@ export default [
           ]
         }
       ],
-      "@typescript-eslint/method-signature-style": [
-        "error",
-        "property"
-      ],
       "@typescript-eslint/naming-convention": [
         "error",
         {
@@ -374,7 +366,12 @@ export default [
         "getBeforeSet"
       ],
       "guard-for-in": "error",
-      "import/newline-after-import": "error",
+      "import/no-extraneous-dependencies": [
+        "error",
+        {
+          "includeTypes": true
+        }
+      ],
       "import/no-useless-path-segments": "error",
       "jsdoc/check-alignment": "error",
       "jsdoc/check-param-names": "error",
@@ -390,13 +387,9 @@ export default [
       "jsdoc/reject-function-type": "error",
       "jsdoc/require-next-type": "error",
       "jsdoc/require-returns-check": "error",
-      "jsdoc/require-throws-type": "error",
       "jsdoc/require-yields-check": "error",
-      "jsdoc/require-yields-type": "error",
       "jsdoc/ts-no-empty-object-type": "error",
       "jsdoc/valid-types": "error",
-      "jsx-a11y/interactive-supports-focus": "error",
-      "jsx-a11y/no-noninteractive-element-interactions": "error",
       "logical-assignment-operators": [
         "error",
         "always",
@@ -419,7 +412,7 @@ export default [
       "max-lines-per-function": [
         "error",
         {
-          "max": 50,
+          "max": 100,
           "skipBlankLines": true,
           "skipComments": true
         }
@@ -451,6 +444,7 @@ export default [
       "no-extra-bind": "error",
       "no-fallthrough": "error",
       "no-implicit-coercion": "error",
+      "no-implicit-globals": "error",
       "no-labels": "error",
       "no-lone-blocks": "error",
       "no-lonely-if": "error",
@@ -480,23 +474,33 @@ export default [
       ],
       "no-script-url": "error",
       "no-self-compare": "error",
-      "no-sequences": "error",
+      "no-sequences": [
+        "error",
+        {
+          "allowInParentheses": false
+        }
+      ],
       "no-template-curly-in-string": "error",
       "no-unmodified-loop-condition": "error",
       "no-unneeded-ternary": "error",
       "no-unreachable-loop": "error",
       "no-useless-assignment": "error",
       "no-useless-call": "error",
-      "no-useless-computed-key": "error",
+      "no-useless-computed-key": [
+        "error",
+        {
+          "enforceForClassMembers": true
+        }
+      ],
       "no-useless-concat": "error",
       "no-useless-return": "error",
       "no-var": "error",
       "no-warning-comments": "warn",
-      "node/no-unsupported-features/node-builtins": "error",
       "object-shorthand": [
         "error",
         "always",
         {
+          "avoidExplicitReturnArrows": true,
           "avoidQuotes": true
         }
       ],
@@ -531,14 +535,10 @@ export default [
           "allowNamedFunctions": true
         }
       ],
-      "prefer-const": [
-        "error",
-        {
-          "destructuring": "all"
-        }
-      ],
+      "prefer-const": "error",
       "prefer-exponentiation-operator": "error",
       "prefer-named-capture-group": "error",
+      "prefer-numeric-literals": "error",
       "prefer-object-has-own": "error",
       "prefer-object-spread": "error",
       "prefer-regex-literals": "error",
@@ -674,16 +674,9 @@ export default [
       "sonarjs/public-static-readonly": "error",
       "sonarjs/reduce-initial-value": "error",
       "symbol-description": "error",
-      "unicorn/custom-error-definition": "error",
       "unicorn/no-array-push-push": "error",
+      "unicorn/no-for-each": "error",
       "unicorn/no-for-loop": "error",
-      "unicorn/prefer-export-from": [
-        "error",
-        {
-          "ignoreUsedVariables": true
-        }
-      ],
-      "unicorn/prefer-import-meta-properties": "error",
       "unicorn/prefer-switch": [
         "error",
         {
@@ -703,12 +696,16 @@ export default [
     rules: {
       "@typescript-eslint/await-thenable": "off",
       "@typescript-eslint/consistent-return": "off",
+      "@typescript-eslint/consistent-type-exports": "off",
       "@typescript-eslint/dot-notation": "off",
+      "@typescript-eslint/member-ordering": "off",
+      "@typescript-eslint/naming-convention": "off",
       "@typescript-eslint/no-array-delete": "off",
       "@typescript-eslint/no-base-to-string": "off",
       "@typescript-eslint/no-confusing-void-expression": "off",
       "@typescript-eslint/no-deprecated": "off",
       "@typescript-eslint/no-duplicate-type-constituents": "off",
+      "@typescript-eslint/no-floating-promises": "off",
       "@typescript-eslint/no-for-in-array": "off",
       "@typescript-eslint/no-implied-eval": "off",
       "@typescript-eslint/no-meaningless-void-operator": "off",
@@ -730,6 +727,7 @@ export default [
       "@typescript-eslint/no-unsafe-enum-comparison": "off",
       "@typescript-eslint/no-unsafe-member-access": "off",
       "@typescript-eslint/no-unsafe-return": "off",
+      "@typescript-eslint/no-unsafe-type-assertion": "off",
       "@typescript-eslint/no-unsafe-unary-minus": "off",
       "@typescript-eslint/no-useless-default-assignment": "off",
       "@typescript-eslint/non-nullable-type-assertion-style": "off",
@@ -740,26 +738,44 @@ export default [
       "@typescript-eslint/prefer-nullish-coalescing": "off",
       "@typescript-eslint/prefer-optional-chain": "off",
       "@typescript-eslint/prefer-promise-reject-errors": "off",
+      "@typescript-eslint/prefer-readonly": "off",
       "@typescript-eslint/prefer-readonly-parameter-types": "off",
       "@typescript-eslint/prefer-reduce-type-parameter": "off",
       "@typescript-eslint/prefer-regexp-exec": "off",
       "@typescript-eslint/prefer-return-this-type": "off",
       "@typescript-eslint/prefer-string-starts-ends-with": "off",
+      "@typescript-eslint/promise-function-async": "off",
       "@typescript-eslint/related-getter-setter-pairs": "off",
+      "@typescript-eslint/require-array-sort-compare": "off",
       "@typescript-eslint/require-await": "off",
       "@typescript-eslint/restrict-plus-operands": "off",
       "@typescript-eslint/restrict-template-expressions": "off",
       "@typescript-eslint/return-await": "off",
       "@typescript-eslint/strict-boolean-expressions": "off",
       "@typescript-eslint/strict-void-return": "off",
+      "@typescript-eslint/switch-exhaustiveness-check": "off",
       "@typescript-eslint/unbound-method": "off",
       "@typescript-eslint/use-unknown-in-catch-callback-variable": "off",
-      "getter-return": "error",
+      "dot-notation": "off",
+      "no-array-constructor": "off",
       "no-dupe-args": "error",
+      "no-empty-function": "off",
+      "no-implied-eval": "off",
       "no-new-symbol": "off",
       "no-redeclare": "error",
+      "no-return-await": "off",
+      "no-shadow": "off",
+      "no-throw-literal": "off",
       "no-undef": "error",
-      "no-unreachable": "error"
+      "no-useless-constructor": "off",
+      "prefer-const": [
+        "error",
+        {
+          "destructuring": "all"
+        }
+      ],
+      "prefer-promise-reject-errors": "off",
+      "require-await": "off"
     },
   },
 
@@ -806,8 +822,7 @@ export default [
       "vitest/prefer-strict-equal": "error",
       "vitest/prefer-to-be": "error",
       "vitest/prefer-to-have-length": "error",
-      "vitest/require-top-level-describe": "error",
-      "vitest/valid-title": "error"
+      "vitest/require-top-level-describe": "error"
     },
   },
 
@@ -988,7 +1003,87 @@ export default [
   // Markdown/MDX code block linting
   {
     ...mdxPlugin.flatCodeBlocks,
+    languageOptions: {
+      ...mdxPlugin.flatCodeBlocks.languageOptions,
+      parserOptions: {
+        ...mdxPlugin.flatCodeBlocks.languageOptions?.parserOptions,
+        projectService: false,
+      },
+    },
     rules: {
+      ...{
+        "@typescript-eslint/await-thenable": "off",
+        "@typescript-eslint/consistent-type-exports": "off",
+        "@typescript-eslint/dot-notation": "off",
+        "@typescript-eslint/member-ordering": "off",
+        "@typescript-eslint/naming-convention": "off",
+        "@typescript-eslint/no-array-delete": "off",
+        "@typescript-eslint/no-base-to-string": "off",
+        "@typescript-eslint/no-confusing-void-expression": "off",
+        "@typescript-eslint/no-deprecated": "off",
+        "@typescript-eslint/no-duplicate-type-constituents": "off",
+        "@typescript-eslint/no-floating-promises": "off",
+        "@typescript-eslint/no-for-in-array": "off",
+        "@typescript-eslint/no-implied-eval": "off",
+        "@typescript-eslint/no-meaningless-void-operator": "off",
+        "@typescript-eslint/no-misused-promises": "off",
+        "@typescript-eslint/no-misused-spread": "off",
+        "@typescript-eslint/no-mixed-enums": "off",
+        "@typescript-eslint/no-redundant-type-constituents": "off",
+        "@typescript-eslint/no-unnecessary-boolean-literal-compare": "off",
+        "@typescript-eslint/no-unnecessary-condition": "off",
+        "@typescript-eslint/no-unnecessary-qualifier": "off",
+        "@typescript-eslint/no-unnecessary-template-expression": "off",
+        "@typescript-eslint/no-unnecessary-type-arguments": "off",
+        "@typescript-eslint/no-unnecessary-type-assertion": "off",
+        "@typescript-eslint/no-unnecessary-type-conversion": "off",
+        "@typescript-eslint/no-unnecessary-type-parameters": "off",
+        "@typescript-eslint/no-unsafe-argument": "off",
+        "@typescript-eslint/no-unsafe-assignment": "off",
+        "@typescript-eslint/no-unsafe-call": "off",
+        "@typescript-eslint/no-unsafe-enum-comparison": "off",
+        "@typescript-eslint/no-unsafe-member-access": "off",
+        "@typescript-eslint/no-unsafe-return": "off",
+        "@typescript-eslint/no-unsafe-type-assertion": "off",
+        "@typescript-eslint/no-unsafe-unary-minus": "off",
+        "@typescript-eslint/no-useless-default-assignment": "off",
+        "@typescript-eslint/non-nullable-type-assertion-style": "off",
+        "@typescript-eslint/only-throw-error": "off",
+        "@typescript-eslint/prefer-find": "off",
+        "@typescript-eslint/prefer-includes": "off",
+        "@typescript-eslint/prefer-nullish-coalescing": "off",
+        "@typescript-eslint/prefer-optional-chain": "off",
+        "@typescript-eslint/prefer-promise-reject-errors": "off",
+        "@typescript-eslint/prefer-readonly": "off",
+        "@typescript-eslint/prefer-reduce-type-parameter": "off",
+        "@typescript-eslint/prefer-regexp-exec": "off",
+        "@typescript-eslint/prefer-return-this-type": "off",
+        "@typescript-eslint/prefer-string-starts-ends-with": "off",
+        "@typescript-eslint/promise-function-async": "off",
+        "@typescript-eslint/related-getter-setter-pairs": "off",
+        "@typescript-eslint/require-array-sort-compare": "off",
+        "@typescript-eslint/require-await": "off",
+        "@typescript-eslint/restrict-plus-operands": "off",
+        "@typescript-eslint/restrict-template-expressions": "off",
+        "@typescript-eslint/return-await": "off",
+        "@typescript-eslint/strict-boolean-expressions": "off",
+        "@typescript-eslint/strict-void-return": "off",
+        "@typescript-eslint/switch-exhaustiveness-check": "off",
+        "@typescript-eslint/unbound-method": "off",
+        "@typescript-eslint/use-unknown-in-catch-callback-variable": "off",
+        "dot-notation": "off",
+        "no-array-constructor": "off",
+        "no-empty-function": "off",
+        "no-implied-eval": "off",
+        "no-return-await": "off",
+        "no-shadow": "off",
+        "no-throw-literal": "off",
+        "no-useless-constructor": "off",
+        "prefer-promise-reject-errors": "off",
+        "require-await": "off",
+        "strict": "off",
+        "unicode-bom": "off"
+      },
       ...mdxPlugin.flatCodeBlocks.rules,
       "eol-last": "off",
       "no-undef": "off",
@@ -1001,10 +1096,10 @@ export default [
   },
 
   // OxLint integration — disables rules already covered by OxLint
-  ...[oxlintPlugin.configs["flat/recommended"]].flat().map((c) => ({ name: "eslint-config-setup/oxlint", ...c })),
-  ...[oxlintPlugin.configs["flat/typescript"]].flat().map((c) => ({ name: "eslint-config-setup/oxlint-typescript", ...c })),
-  ...[oxlintPlugin.configs["flat/unicorn"]].flat().map((c) => ({ name: "eslint-config-setup/oxlint-unicorn", ...c })),
-  ...[oxlintPlugin.configs["flat/import"]].flat().map((c) => ({ name: "eslint-config-setup/oxlint-import", ...c })),
-  ...[oxlintPlugin.configs["flat/jsdoc"]].flat().map((c) => ({ name: "eslint-config-setup/oxlint-jsdoc", ...c })),
+  ...[oxlintPlugin.configs["flat/recommended"]].flat().map((c, index, array) => ({ ...c, name: "eslint-config-setup/oxlint" + (array.length > 1 ? "-" + (index + 1) : "") })),
+  ...[oxlintPlugin.configs["flat/typescript"]].flat().map((c, index, array) => ({ ...c, name: "eslint-config-setup/oxlint-typescript" + (array.length > 1 ? "-" + (index + 1) : "") })),
+  ...[oxlintPlugin.configs["flat/unicorn"]].flat().map((c, index, array) => ({ ...c, name: "eslint-config-setup/oxlint-unicorn" + (array.length > 1 ? "-" + (index + 1) : "") })),
+  ...[oxlintPlugin.configs["flat/import"]].flat().map((c, index, array) => ({ ...c, name: "eslint-config-setup/oxlint-import" + (array.length > 1 ? "-" + (index + 1) : "") })),
+  ...[oxlintPlugin.configs["flat/jsdoc"]].flat().map((c, index, array) => ({ ...c, name: "eslint-config-setup/oxlint-jsdoc" + (array.length > 1 ? "-" + (index + 1) : "") })),
 
 ]