@gooddata/eslint-config 11.19.0-alpha.0 → 11.19.0-alpha.10

package/LICENSE

@@ -0,0 +1,7 @@
+Copyright (c) 2022 GoodData Corporation
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/PACKAGES_V8.md

@@ -0,0 +1,26 @@
+# ESLint V8 Packages
+
+This table shows which packages are required for each configuration.
+
+| Package                           | base   | browser | browser-esm | esm    | esm-react | esm-react-cypress | esm-react-vitest | esm-react-vitest-storybook | esm-vitest | react  | react-cypress | react-vitest | vitest |
+| --------------------------------- | ------ | ------- | ----------- | ------ | --------- | ----------------- | ---------------- | -------------------------- | ---------- | ------ | ------------- | ------------ | ------ |
+| @testing-library/dom              |        |         |             |        |           |                   |                  | 10.4.1                     |            |        |               |              |        |
+| @typescript-eslint/eslint-plugin  | 8.52.0 | 8.52.0  | 8.52.0      | 8.52.0 | 8.52.0    | 8.52.0            | 8.52.0           | 8.52.0                     | 8.52.0     | 8.52.0 | 8.52.0        | 8.52.0       | 8.52.0 |
+| @typescript-eslint/parser         | 8.52.0 | 8.52.0  | 8.52.0      | 8.52.0 | 8.52.0    | 8.52.0            | 8.52.0           | 8.52.0                     | 8.52.0     | 8.52.0 | 8.52.0        | 8.52.0       | 8.52.0 |
+| @vitest/eslint-plugin             |        |         |             |        |           |                   | 1.6.6            | 1.6.6                      | 1.6.6      |        |               | 1.6.6        | 1.6.6  |
+| eslint-import-resolver-typescript | 4.4.4  | 4.4.4   | 4.4.4       | 4.4.4  | 4.4.4     | 4.4.4             | 4.4.4            | 4.4.4                      | 4.4.4      | 4.4.4  | 4.4.4         | 4.4.4        | 4.4.4  |
+| eslint-plugin-chai-friendly       |        |         |             |        |           | 1.1.0             |                  |                            |            |        | 1.1.0         |              |        |
+| eslint-plugin-cypress             |        |         |             |        |           | 3.6.0             |                  |                            |            |        | 3.6.0         |              |        |
+| eslint-plugin-header              | 3.1.1  | 3.1.1   | 3.1.1       | 3.1.1  | 3.1.1     | 3.1.1             | 3.1.1            | 3.1.1                      | 3.1.1      | 3.1.1  | 3.1.1         | 3.1.1        | 3.1.1  |
+| eslint-plugin-import-esm          |        |         | 1.2.1       | 1.2.1  | 1.2.1     | 1.2.1             | 1.2.1            | 1.2.1                      | 1.2.1      |        |               |              |        |
+| eslint-plugin-import-x            | 4.16.1 | 4.16.1  | 4.16.1      | 4.16.1 | 4.16.1    | 4.16.1            | 4.16.1           | 4.16.1                     | 4.16.1     | 4.16.1 | 4.16.1        | 4.16.1       | 4.16.1 |
+| eslint-plugin-jsdoc               | 62.1.0 | 62.1.0  | 62.1.0      | 62.1.0 | 62.1.0    | 62.1.0            | 62.1.0           | 62.1.0                     | 62.1.0     | 62.1.0 | 62.1.0        | 62.1.0       | 62.1.0 |
+| eslint-plugin-no-barrel-files     | 1.2.2  | 1.2.2   | 1.2.2       | 1.2.2  | 1.2.2     | 1.2.2             | 1.2.2            | 1.2.2                      | 1.2.2      | 1.2.2  | 1.2.2         | 1.2.2        | 1.2.2  |
+| eslint-plugin-no-only-tests       |        |         |             |        |           | 2.6.0             | 2.6.0            | 2.6.0                      | 2.6.0      |        | 2.6.0         | 2.6.0        | 2.6.0  |
+| eslint-plugin-react               |        |         |             |        | 7.37.5    | 7.37.5            | 7.37.5           | 7.37.5                     |            | 7.37.5 | 7.37.5        | 7.37.5       |        |
+| eslint-plugin-react-hooks         |        |         |             |        | 5.2.0     | 5.2.0             | 5.2.0            | 5.2.0                      |            | 5.2.0  | 5.2.0         | 5.2.0        |        |
+| eslint-plugin-sonarjs             | 3.0.6  | 3.0.6   | 3.0.6       | 3.0.6  | 3.0.6     | 3.0.6             | 3.0.6            | 3.0.6                      | 3.0.6      | 3.0.6  | 3.0.6         | 3.0.6        | 3.0.6  |
+| eslint-plugin-storybook           |        |         |             |        |           |                   |                  | 10.1.11                    |            |        |               |              |        |
+| react                             |        |         |             |        |           |                   |                  | 19.1.1                     |            |        |               |              |        |
+| react-dom                         |        |         |             |        |           |                   |                  | 19.1.1                     |            |        |               |              |        |
+| storybook                         |        |         |             |        |           |                   |                  | ^10.1.11                   |            |        |               |              |        |

package/PACKAGES_V9.md

@@ -0,0 +1,28 @@
+# ESLint V9 Packages
+
+This table shows which packages are required for each configuration.
+
+| Package                           | base   | browser | browser-esm | esm    | esm-react | esm-react-cypress | esm-react-vitest | esm-react-vitest-storybook | esm-vitest | react  | react-cypress | react-vitest | vitest |
+| --------------------------------- | ------ | ------- | ----------- | ------ | --------- | ----------------- | ---------------- | -------------------------- | ---------- | ------ | ------------- | ------------ | ------ |
+| @eslint/js                        | 9.28.0 | 9.28.0  | 9.28.0      | 9.28.0 | 9.28.0    | 9.28.0            | 9.28.0           | 9.28.0                     | 9.28.0     | 9.28.0 | 9.28.0        | 9.28.0       | 9.28.0 |
+| @testing-library/dom              |        |         |             |        |           |                   |                  | 10.4.1                     |            |        |               |              |        |
+| @typescript-eslint/eslint-plugin  | 8.52.0 | 8.52.0  | 8.52.0      | 8.52.0 | 8.52.0    | 8.52.0            | 8.52.0           | 8.52.0                     | 8.52.0     | 8.52.0 | 8.52.0        | 8.52.0       | 8.52.0 |
+| @typescript-eslint/parser         | 8.52.0 | 8.52.0  | 8.52.0      | 8.52.0 | 8.52.0    | 8.52.0            | 8.52.0           | 8.52.0                     | 8.52.0     | 8.52.0 | 8.52.0        | 8.52.0       | 8.52.0 |
+| @vitest/eslint-plugin             |        |         |             |        |           |                   | 1.6.6            | 1.6.6                      | 1.6.6      |        |               | 1.6.6        | 1.6.6  |
+| eslint-import-resolver-typescript | 4.4.4  | 4.4.4   | 4.4.4       | 4.4.4  | 4.4.4     | 4.4.4             | 4.4.4            | 4.4.4                      | 4.4.4      | 4.4.4  | 4.4.4         | 4.4.4        | 4.4.4  |
+| eslint-plugin-chai-friendly       |        |         |             |        |           | 1.1.0             |                  |                            |            |        | 1.1.0         |              |        |
+| eslint-plugin-cypress             |        |         |             |        |           | 3.6.0             |                  |                            |            |        | 3.6.0         |              |        |
+| eslint-plugin-headers             | 1.3.3  | 1.3.3   | 1.3.3       | 1.3.3  | 1.3.3     | 1.3.3             | 1.3.3            | 1.3.3                      | 1.3.3      | 1.3.3  | 1.3.3         | 1.3.3        | 1.3.3  |
+| eslint-plugin-import-esm          |        |         | 1.2.1       | 1.2.1  | 1.2.1     | 1.2.1             | 1.2.1            | 1.2.1                      | 1.2.1      |        |               |              |        |
+| eslint-plugin-import-x            | 4.16.1 | 4.16.1  | 4.16.1      | 4.16.1 | 4.16.1    | 4.16.1            | 4.16.1           | 4.16.1                     | 4.16.1     | 4.16.1 | 4.16.1        | 4.16.1       | 4.16.1 |
+| eslint-plugin-jsdoc               | 62.1.0 | 62.1.0  | 62.1.0      | 62.1.0 | 62.1.0    | 62.1.0            | 62.1.0           | 62.1.0                     | 62.1.0     | 62.1.0 | 62.1.0        | 62.1.0       | 62.1.0 |
+| eslint-plugin-no-barrel-files     | 1.2.2  | 1.2.2   | 1.2.2       | 1.2.2  | 1.2.2     | 1.2.2             | 1.2.2            | 1.2.2                      | 1.2.2      | 1.2.2  | 1.2.2         | 1.2.2        | 1.2.2  |
+| eslint-plugin-no-only-tests       |        |         |             |        |           | 3.3.0             | 3.3.0            | 3.3.0                      | 3.3.0      |        | 3.3.0         | 3.3.0        | 3.3.0  |
+| eslint-plugin-react               |        |         |             |        | 7.37.5    | 7.37.5            | 7.37.5           | 7.37.5                     |            | 7.37.5 | 7.37.5        | 7.37.5       |        |
+| eslint-plugin-react-hooks         |        |         |             |        | 5.2.0     | 5.2.0             | 5.2.0            | 5.2.0                      |            | 5.2.0  | 5.2.0         | 5.2.0        |        |
+| eslint-plugin-sonarjs             | 3.0.6  | 3.0.6   | 3.0.6       | 3.0.6  | 3.0.6     | 3.0.6             | 3.0.6            | 3.0.6                      | 3.0.6      | 3.0.6  | 3.0.6         | 3.0.6        | 3.0.6  |
+| eslint-plugin-storybook           |        |         |             |        |           |                   |                  | 10.1.11                    |            |        |               |              |        |
+| globals                           | 17.2.0 | 17.2.0  | 17.2.0      | 17.2.0 | 17.2.0    | 17.2.0            | 17.2.0           | 17.2.0                     | 17.2.0     | 17.2.0 | 17.2.0        | 17.2.0       | 17.2.0 |
+| react                             |        |         |             |        |           |                   |                  | 19.1.1                     |            |        |               |              |        |
+| react-dom                         |        |         |             |        |           |                   |                  | 19.1.1                     |            |        |               |              |        |
+| storybook                         |        |         |             |        |           |                   |                  | ^10.1.11                   |            |        |               |              |        |

package/PACKAGES_V9_OXLINT.md

@@ -0,0 +1,28 @@
+# ESLint V9 OxLint Packages
+
+This table shows which packages are required for each configuration.
+
+| Package                           | oxlint-base | oxlint-browser | oxlint-browser-esm | oxlint-esm | oxlint-esm-react | oxlint-esm-react-cypress | oxlint-esm-react-vitest | oxlint-esm-react-vitest-storybook | oxlint-esm-vitest | oxlint-react | oxlint-react-cypress | oxlint-react-vitest | oxlint-vitest |
+| --------------------------------- | ----------- | -------------- | ------------------ | ---------- | ---------------- | ------------------------ | ----------------------- | --------------------------------- | ----------------- | ------------ | -------------------- | ------------------- | ------------- |
+| @eslint/js                        | 9.28.0      | 9.28.0         | 9.28.0             | 9.28.0     | 9.28.0           | 9.28.0                   | 9.28.0                  | 9.28.0                            | 9.28.0            | 9.28.0       | 9.28.0               | 9.28.0              | 9.28.0        |
+| @testing-library/dom              |             |                |                    |            |                  |                          |                         | 10.4.1                            |                   |              |                      |                     |               |
+| @typescript-eslint/eslint-plugin  | 8.52.0      | 8.52.0         | 8.52.0             | 8.52.0     | 8.52.0           | 8.52.0                   | 8.52.0                  | 8.52.0                            | 8.52.0            | 8.52.0       | 8.52.0               | 8.52.0              | 8.52.0        |
+| @typescript-eslint/parser         | 8.52.0      | 8.52.0         | 8.52.0             | 8.52.0     | 8.52.0           | 8.52.0                   | 8.52.0                  | 8.52.0                            | 8.52.0            | 8.52.0       | 8.52.0               | 8.52.0              | 8.52.0        |
+| @vitest/eslint-plugin             |             |                |                    |            |                  |                          | 1.6.6                   | 1.6.6                             | 1.6.6             |              |                      | 1.6.6               | 1.6.6         |
+| eslint-import-resolver-typescript | 4.4.4       | 4.4.4          | 4.4.4              | 4.4.4      | 4.4.4            | 4.4.4                    | 4.4.4                   | 4.4.4                             | 4.4.4             | 4.4.4        | 4.4.4                | 4.4.4               | 4.4.4         |
+| eslint-plugin-chai-friendly       |             |                |                    |            |                  | 1.1.0                    |                         |                                   |                   |              | 1.1.0                |                     |               |
+| eslint-plugin-cypress             |             |                |                    |            |                  | 3.6.0                    |                         |                                   |                   |              | 3.6.0                |                     |               |
+| eslint-plugin-headers             | 1.3.3       | 1.3.3          | 1.3.3              | 1.3.3      | 1.3.3            | 1.3.3                    | 1.3.3                   | 1.3.3                             | 1.3.3             | 1.3.3        | 1.3.3                | 1.3.3               | 1.3.3         |
+| eslint-plugin-import-esm          |             |                | 1.2.1              | 1.2.1      | 1.2.1            | 1.2.1                    | 1.2.1                   | 1.2.1                             | 1.2.1             |              |                      |                     |               |
+| eslint-plugin-import-x            | 4.16.1      | 4.16.1         | 4.16.1             | 4.16.1     | 4.16.1           | 4.16.1                   | 4.16.1                  | 4.16.1                            | 4.16.1            | 4.16.1       | 4.16.1               | 4.16.1              | 4.16.1        |
+| eslint-plugin-jsdoc               | 62.1.0      | 62.1.0         | 62.1.0             | 62.1.0     | 62.1.0           | 62.1.0                   | 62.1.0                  | 62.1.0                            | 62.1.0            | 62.1.0       | 62.1.0               | 62.1.0              | 62.1.0        |
+| eslint-plugin-no-barrel-files     | 1.2.2       | 1.2.2          | 1.2.2              | 1.2.2      | 1.2.2            | 1.2.2                    | 1.2.2                   | 1.2.2                             | 1.2.2             | 1.2.2        | 1.2.2                | 1.2.2               | 1.2.2         |
+| eslint-plugin-no-only-tests       |             |                |                    |            |                  | 3.3.0                    | 3.3.0                   | 3.3.0                             | 3.3.0             |              | 3.3.0                | 3.3.0               | 3.3.0         |
+| eslint-plugin-react               |             |                |                    |            | 7.37.5           | 7.37.5                   | 7.37.5                  | 7.37.5                            |                   | 7.37.5       | 7.37.5               | 7.37.5              |               |
+| eslint-plugin-react-hooks         |             |                |                    |            | 5.2.0            | 5.2.0                    | 5.2.0                   | 5.2.0                             |                   | 5.2.0        | 5.2.0                | 5.2.0               |               |
+| eslint-plugin-sonarjs             | 3.0.6       | 3.0.6          | 3.0.6              | 3.0.6      | 3.0.6            | 3.0.6                    | 3.0.6                   | 3.0.6                             | 3.0.6             | 3.0.6        | 3.0.6                | 3.0.6               | 3.0.6         |
+| eslint-plugin-storybook           |             |                |                    |            |                  |                          |                         | 10.1.11                           |                   |              |                      |                     |               |
+| globals                           | 17.2.0      | 17.2.0         | 17.2.0             | 17.2.0     | 17.2.0           | 17.2.0                   | 17.2.0                  | 17.2.0                            | 17.2.0            | 17.2.0       | 17.2.0               | 17.2.0              | 17.2.0        |
+| react                             |             |                |                    |            |                  |                          |                         | 19.1.1                            |                   |              |                      |                     |               |
+| react-dom                         |             |                |                    |            |                  |                          |                         | 19.1.1                            |                   |              |                      |                     |               |
+| storybook                         |             |                |                    |            |                  |                          |                         | ^10.1.11                          |                   |              |                      |                     |               |

package/README.md

@@ -11,6 +11,7 @@ This package consolidates ESLint configurations that were previously scattered a
 
 The new approach provides:
 
+- **ESLint v8 and v9 support** - Dual configuration format for both legacy and flat config
 - **Modular structure** - Rules organized by plugin/concern in separate files
 - **Easy to edit** - Find and modify rules in logical locations
 - **Unified configs** - Single source of truth for linting standards
@@ -31,10 +32,10 @@ The new approach provides:
     - `variants` object: Different combinations for specific use cases
 
 3. **Build Process** (`npm run build`)
-    - Merges configuration modules into JSON files in `dist/`
-    - Creates `base.json` (all common configs)
-    - Creates variant files: `browser.json`, `react.json`, `esm-react.json`, etc.
-    - Consumers import via: `@gooddata/eslint-config/react` � `dist/react.json`
+    - Generates both ESLint v8 (JSON) and v9 (JS flat config) formats
+    - Creates `base.json` + `base.js` (all common configs)
+    - Creates variant files: `browser.json`/`.js`, `react.json`/`.js`, etc.
+    - Package exports use conditional exports: `require` → JSON (v8), `import` → JS (v9)
 
 4. **Package Sync** (`npm run update-package`)
     - Auto-updates `package.json` dependencies and peer dependencies
@@ -43,51 +44,129 @@ The new approach provides:
 
 ## Available Variants
 
-- **base** (`.`) - Core rules for all packages
-- **browser** (`/browser`) - For packages using browser APIs (document, window)
-- **browser-esm** (`/browser-esm`) - Browser + ESM import rules
-- **esm** (`/esm`) - ESM-specific import rules
-- **esm-vitest** (`/esm-vitest`) - ESM + Vitest rules
-- **react** (`/react`) - Browser + React + React Hooks rules
-- **react-cypress** (`/react-cypress`) - Browser + React + React Hooks + Cypress rules
-- **esm-react** (`/esm-react`) - Browser + React + React Hooks + ESM rules (most React libraries)
-- **esm-react-cypress** (`/esm-react-cypress`) - Browser + React + React Hooks + ESM + Cypress rules
-- **esm-react-vitest** (`/esm-react-vitest`) - Browser + React + React Hooks + ESM + Vitest rules
+For a complete list of available variants and their required packages, see:
+
+- [PACKAGES_V8.md](./PACKAGES_V8.md) - Package requirements for ESLint v8 configurations
+- [PACKAGES_V9.md](./PACKAGES_V9.md) - Package requirements for ESLint v9 configurations
+- [PACKAGES_V9_OXLINT.md](./PACKAGES_V9_OXLINT.md) - Package requirements for ESLint v9 + oxlint configurations
+
+## OxLint Migration Variants
+
+This package also provides `oxlint-*` variants designed to be used alongside `@gooddata/oxlint-config`. These variants have certain ESLint plugins disabled because those rules are handled by oxlint instead, providing faster linting performance.
+
+**How it works:**
+
+- **eslint-config `oxlint-*` variants** contain ESLint rules that oxlint does not support
+- **oxlint-config** contains the equivalent rules handled by oxlint
+- Together, they provide the same coverage as the standard ESLint variants, but with oxlint handling the bulk of the work for better performance
+
+**Example usage:**
+
+```typescript
+// eslint.config.ts
+import config from "@gooddata/eslint-config/oxlint-esm-react-vitest";
+
+export default config;
+```
+
+See `@gooddata/oxlint-config` for the corresponding oxlint configuration and detailed setup instructions.
+
+## ESLint v8 vs v9 Support
+
+This package supports both ESLint v8 (legacy config) and ESLint v9 (flat config):
+
+| ESLint Version | Config Format | File Extension     | Import Type |
+| -------------- | ------------- | ------------------ | ----------- |
+| v8             | Legacy JSON   | `.eslintrc.js`     | `require()` |
+| v9             | Flat Config   | `eslint.config.js` | `import`    |
+
+The package uses conditional exports to automatically serve the correct format:
+
+- **CommonJS/require** → Returns JSON config for ESLint v8
+- **ESM/import** → Returns JS flat config for ESLint v9
+
+Some packages differ between v8 and v9 (e.g., `eslint-plugin-header` vs `eslint-plugin-headers`). See [PACKAGES_V8.md](./PACKAGES_V8.md) and [PACKAGES_V9.md](./PACKAGES_V9.md) for the complete list of required packages for each version.
 
 ## Usage
 
-### TypeScript Projects (Recommended)
+### ESLint v9 (Flat Config) - Recommended
+
+For ESLint v9 with flat config, create an `eslint.config.js` or `eslint.config.ts` file:
+
+```typescript
+// eslint.config.ts
+// (C) 2025 GoodData Corporation
+
+import config from "@gooddata/eslint-config/esm-react-vitest";
+
+export default config;
+```
 
-For TypeScript projects, use the `tsOverride` helper which automatically configures the TypeScript parser, import resolver, and other required settings:
+To add custom rules or overrides:
+
+```typescript
+// eslint.config.ts
+// (C) 2025 GoodData Corporation
+
+import config from "@gooddata/eslint-config/esm-react-vitest";
+
+export default [
+    ...config,
+    {
+        rules: {
+            // Custom rule overrides (applies to all files)
+            "no-console": "warn",
+        },
+    },
+];
+```
+
+To add TypeScript-specific rule overrides, specify a `files` pattern:
+
+```typescript
+// eslint.config.ts
+// (C) 2025 GoodData Corporation
+
+import config from "@gooddata/eslint-config/esm-react-vitest";
+
+export default [
+    ...config,
+    {
+        files: ["**/*.ts", "**/*.tsx", "**/*.mts", "**/*.cts"],
+        rules: {
+            // TypeScript rule overrides (applies only to TS files)
+            "@typescript-eslint/no-namespace": "off",
+            "@typescript-eslint/no-explicit-any": "warn",
+        },
+    },
+];
+```
+
+### ESLint v8 (Legacy Config)
+
+For ESLint v8, use the legacy JSON-based configuration:
 
 ```javascript
+// .eslintrc.js
 // (C) 2020 GoodData Corporation
 
-const { tsOverride } = require("@gooddata/eslint-config/tsOverride");
-
 module.exports = {
     extends: ["@gooddata/eslint-config/react"],
     overrides: [
-        tsOverride(__dirname, {
-            // Optional: Add custom TypeScript rule overrides here
-            "@typescript-eslint/no-namespace": "off",
-            "@typescript-eslint/no-unsafe-assignment": "off",
-        }),
+        {
+            files: ["**/*.ts", "**/*.tsx", "**/*.mts", "**/*.cts"],
+            rules: {
+                // Custom TypeScript rule overrides
+                "@typescript-eslint/no-namespace": "off",
+            },
+        },
     ],
 };
 ```
 
-**What `tsOverride` does:**
+### Non-TypeScript Projects (v8)
 
-- Sets up the TypeScript parser (`@typescript-eslint/parser`)
-- Configures `tsconfigRootDir` to point to your project directory
-- Configures the import resolver to handle TypeScript imports correctly
-- Applies to `**/*.ts` and `**/*.tsx` files
-- Allows you to pass custom rule overrides as the second parameter
-
-### Non-TypeScript Projects
-
-For non-TypeScript projects, simply extend the configuration:
+For non-TypeScript projects using ESLint v8, simply extend the configuration:
 
 ```javascript
 module.exports = {
@@ -97,8 +176,6 @@ module.exports = {
 
 **Important Notes:**
 
-- **TypeScript Projects**: Using `tsOverride(__dirname, rules)` is **mandatory** for TypeScript projects. Without it, `@typescript-eslint/parser` won't know where to find your `tsconfig.json`, and import resolution will not work correctly.
-
 - **Peer Dependencies**: Only packages from the `common` configuration are listed in `peerDependencies`. Variant-specific packages (e.g., `eslint-plugin-react` for the `react` variant) are **not** included as peer dependencies since they're not required by all consumers.
 
 - **Verify Dependencies**: After adopting a configuration, run `npm run eslint` (or your lint command) to ensure all necessary dependencies are present in your project. If you get plugin errors, install the missing packages.
@@ -209,6 +286,7 @@ rules: {
 - **`npm run update-package`** - Syncs dependencies and exports
     - Updates `devDependencies` and `peerDependencies` in `package.json`
     - Updates `exports` field based on available variants
+    - Generates `PACKAGES_V8.md` and `PACKAGES_V9.md` documentation files
     - **Must run after**: adding variants, adding configs, changing package versions
 
 - **`npm run validate`** - Type-checks TypeScript files
@@ -269,3 +347,25 @@ interface IConfiguration<RulePrefix extends string = ""> {
 
 - The base configuration automatically ignores `**/dist/**/*.*` and `**/esm/**/*.*` files.
 - **ESM vs ImportESM**: The `esm` configuration sets `parserOptions.sourceType: "module"` to tell the parser to treat files as ES modules. The `importEsm` configuration adds the `eslint-plugin-import-esm` plugin which enforces ESM-specific import rules (e.g., requiring `.js` extensions in imports). Most ESM projects need both.
+
+## Formatting
+
+This package is **decoupled from formatters**. The `formatter` configuration (included in all variants by default) disables ESLint rules that conflict with code formatters, allowing you to use any formatter of your choice (Prettier, oxfmt, Biome, etc.) as a separate tool.
+
+**How it works:**
+
+- ESLint focuses solely on code quality and best practices
+- Formatting rules (indentation, spacing, quotes, etc.) are disabled
+- Run your formatter separately (e.g., `prettier --write` or `oxfmt`)
+
+**Recommended setup:**
+
+1. Install your preferred formatter (e.g., `prettier` or `oxfmt`)
+2. Configure it separately (e.g., `.prettierrc` or `oxfmt.json`)
+3. Run formatting as a separate step in your workflow or editor
+
+This approach provides:
+
+- **Flexibility** - Choose any formatter without changing ESLint config
+- **Performance** - Formatters run faster when not piped through ESLint
+- **Clarity** - Clear separation between linting (code quality) and formatting (code style)

package/dist/base.d.ts

@@ -0,0 +1,12 @@
+export interface FlatConfig {
+    files?: string[];
+    ignores?: string[];
+    languageOptions?: Record<string, unknown>;
+    linterOptions?: Record<string, unknown>;
+    processor?: unknown;
+    plugins?: Record<string, unknown>;
+    rules?: Record<string, unknown>;
+    settings?: Record<string, unknown>;
+}
+declare const config: FlatConfig[];
+export default config;