eslint-config-typed 2.3.2 → 3.1.0

package/README.md

@@ -36,7 +36,7 @@ A comprehensive ESLint configuration package with strongly-typed rule definition
         - [Rule Types](#rule-types)
 - [Customization](#customization)
     - [Override Specific Rules](#override-specific-rules)
-    - [Use Type-Safe Rule Options](#use-type-safe-rule-options)
+    - [Use RulesOptions Types](#use-rulesoptions-types)
     - [Target Specific Files](#target-specific-files)
 - [Troubleshooting](#troubleshooting)
     - [Common Issues](#common-issues)
@@ -49,7 +49,7 @@ A comprehensive ESLint configuration package with strongly-typed rule definition
 
 ## Features
 
-- 🎯 **Type-Safe Configuration**: Fully typed ESLint rules and configurations for better IDE support
+- 🎯 **Type-Safe Configuration**: Fully typed ESLint rules **and options** and configurations for better IDE support
 - 📦 **Pre-configured Setups**: Ready-to-use configurations for TypeScript, React, Preact, and popular testing frameworks
 - 📝 **Comprehensive Type Definitions**: Complete TypeScript types for all ESLint rules and options
 - 🔄 **ESLint Flat Config Support**: Built for the modern ESLint flat configuration system
@@ -75,15 +75,17 @@ All required ESLint plugins and dependencies are automatically installed.
 
 ## Quick Start
 
-Create an `eslint.config.js` file in your project root:
+Create an `eslint.config.js` or `eslint.config.ts` file in your project root:
 
-```js
+```tsx
 import {
     defineConfig,
+    defineKnownRules,
     eslintConfigForTypeScript,
     eslintConfigForVitest,
-    defineKnownRules,
+    withDefaultOption,
 } from 'eslint-config-typed';
+
 // import * as path from 'node:path';
 // import * as url from 'node:url';
 
@@ -110,17 +112,15 @@ export default defineConfig([
     // You can override per-rule settings if necessary.
     {
         rules: defineKnownRules({
-            '@typescript-eslint/no-explicit-any': 'warn',
+            '@typescript-eslint/no-explicit-any': withDefaultOption('warn'),
             '@typescript-eslint/prefer-readonly-parameter-types': 'off',
-            'react-hooks/exhaustive-deps': 'warn',
+            'react-hooks/exhaustive-deps': withDefaultOption('warn'),
             'functional/no-let': [
                 'error',
                 {
                     allowInForLoopInit: true,
                     allowInFunctions: false,
-                    ignoreIdentifierPattern: ignorePattern.filter(
-                        (p) => p !== '^draft',
-                    ),
+                    ignoreIdentifierPattern: ['^mut_', '^_mut_', '^#mut_'],
                 },
             ],
         }),
@@ -151,14 +151,20 @@ npm run lint:fix
 
 `defineConfig` wraps your flat configuration array so JavaScript config files get full IntelliSense without relying on JSDoc casts. It keeps literal types intact while returning the config unchanged at runtime.
 
-```js
-import { defineConfig, eslintConfigForTypeScript } from 'eslint-config-typed';
+```tsx
+import {
+    defineConfig,
+    defineKnownRules,
+    eslintConfigForTypeScript,
+} from 'eslint-config-typed';
+
+const thisDir = import.meta.dirname;
 
 export default defineConfig([
     ...eslintConfigForTypeScript({
-        tsconfigRootDir: import.meta.dirname,
+        tsconfigRootDir: thisDir,
         tsconfigFileName: './tsconfig.json',
-        packageDirs: [import.meta.dirname],
+        packageDirs: [thisDir],
     }),
     {
         rules: defineKnownRules({
@@ -170,93 +176,195 @@ export default defineConfig([
 
 This is equivalent to:
 
-```js
-import { eslintConfigForTypeScript } from 'eslint-config-typed';
+```tsx
+import {
+    defineKnownRules,
+    eslintConfigForTypeScript,
+    type FlatConfig,
+} from 'eslint-config-typed';
+
+const thisDir = import.meta.dirname;
 
-/** @type {import('@typescript-eslint/utils/ts-eslint').FlatConfig[]} */
 export default [
     ...eslintConfigForTypeScript({
-        tsconfigRootDir: import.meta.dirname,
+        tsconfigRootDir: thisDir,
         tsconfigFileName: './tsconfig.json',
-        packageDirs: [import.meta.dirname],
+        packageDirs: [thisDir],
     }),
     {
         rules: defineKnownRules({
             // ...
         }),
     },
-];
+] satisfies readonly FlatConfig[];
 ```
 
 ### defineKnownRules utility
 
-`defineKnownRules` is a helper designed for the `rules` field in ESLint flat configs. It keeps the returned object untouched while giving you type-safe rule names and option inference in editors. When you wrap your overrides with this function you can rely on:
+`defineKnownRules` is a helper designed for the `rules` field in ESLint flat configs. It keeps the returned object untouched while giving you **type-safe rule names and option inference** in editors (like biome.json). When you wrap your overrides with this function you can rely on:
 
 - autocomplete and early feedback for rule identifiers, eliminating typo-prone string literals;
 - strongly typed options for every plugin rule that ships with `eslint-config-typed`, so you can discover valid properties without leaving your editor;
 - a zero-cost runtime helper—because the object is returned as-is, it blends seamlessly into any flat config block.
 
+```tsx
+import {
+    defineKnownRules,
+    eslintConfigForTypeScript,
+    type FlatConfig,
+} from 'eslint-config-typed';
+
+const thisDir = import.meta.dirname;
+
+export default [
+    ...eslintConfigForTypeScript({
+        tsconfigRootDir: thisDir,
+        tsconfigFileName: './tsconfig.json',
+        packageDirs: [thisDir],
+    }),
+    {
+        rules: defineKnownRules({
+            // @ts-expect-error typo of rule name
+            'no-restricted-globalsSSSS': 'error',
+            // ~~~~~~~~~~~~~~~~~~~~~~~
+        }),
+    },
+    {
+        rules: defineKnownRules({
+            'no-unsafe-optional-chaining': [
+                'error',
+                // @ts-expect-error typo of an option key
+                { disallowArithmeticOperatorsSSSSS: true },
+                // ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+            ],
+        }),
+    },
+] satisfies FlatConfig[];
+```
+
 ### withDefaultOption utility
 
 `withDefaultOption` is a companion helper that highlights rules which ship with option objects. It maps the familiar severity strings to the numeric values ESLint expects: `withDefaultOption('error')` returns `2`, and `withDefaultOption('warn')` returns `1`. Within `defineKnownRules`, rules that provide options require one of these helpers when you want to keep the defaults and only adjust severity. This convention visually distinguishes rules that contain options, reminding users that a rule has configurable options.
 
 `defineKnownRules` also reserves `0` for deprecated rules. The resulting severity matrix looks like this:
 
-| Rule type            | Allowed severity values in `defineKnownRules`                  |
-| :------------------- | :------------------------------------------------------------- |
-| Deprecated rule      | `0`                                                            |
-| Rule without options | `"off"`, `"warn"`, `"error"`                                   |
-| Rule with options    | `"off"`, `1`, `2`, `["warn", <option>]`, `["error", <option>]` |
+| Rule type            | Allowed severity values in `defineKnownRules` |
+| :------------------- | :-------------------------------------------- | ------ | -------- | ------- | ------------------- |
+| Deprecated rule      | `0`                                           |
+| Rule without options | `"off"                                        | "warn" | "error"` |
+| Rule with options    | `"off"                                        | 1      | 2        | ["warn" | "error", <option>]` |
+
+```tsx
+import {
+    defineKnownRules,
+    eslintConfigForTypeScript,
+    withDefaultOption,
+    type FlatConfig,
+} from 'eslint-config-typed';
+
+const thisDir = import.meta.dirname;
+
+export default [
+    ...eslintConfigForTypeScript({
+        tsconfigRootDir: thisDir,
+        tsconfigFileName: './tsconfig.json',
+        packageDirs: [thisDir],
+    }),
+    {
+        rules: defineKnownRules({
+            // @ts-expect-error Simply passing the string "error" to a rule with options is not allowed
+            'no-restricted-globals': 'error',
+            // ~~~~~~~~~~~~~~~~~~~~
+            // ^ Type Error! (Because "no-restricted-globals" has options)
+            // NOTE: In addition, some rules, such as "no-restricted-syntax" "and no-restricted-globals", have no effect unless you set the option.
+
+            // OK
+            'object-shorthand': withDefaultOption('error'),
+
+            // OK (options are set explicitly)
+            'no-unsafe-optional-chaining': [
+                'error',
+                { disallowArithmeticOperators: true },
+            ],
+        }),
+    },
+] satisfies FlatConfig[];
+```
+
+### TypeScript Configuration Files
+
+You can also write your eslint config in `.ts` or `.mts` format, all you need to do is run `npm add -D jiti`.
+
+```tsx
+import {
+    eslintConfigForTypeScript,
+    eslintConfigForVitest,
+    type FlatConfig,
+} from 'eslint-config-typed';
+
+const thisDir = import.meta.dirname;
+
+export default [
+    ...eslintConfigForTypeScript({
+        tsconfigRootDir: thisDir,
+        tsconfigFileName: './tsconfig.json',
+        packageDirs: [thisDir],
+    }),
+    eslintConfigForVitest(),
+] satisfies FlatConfig[];
+```
+
+For details, see <https://eslint.org/docs/latest/use/configure/configuration-files#typescript-configuration-files>.
 
 ## Configuration Examples
 
 ### TypeScript + React Project
 
-```js
+```tsx
 import {
-    defineConfig,
-    eslintConfigForTypeScript,
-    eslintConfigForReact,
-    eslintConfigForNodeJs,
     defineKnownRules,
+    eslintConfigForNodeJs,
+    eslintConfigForReact,
+    eslintConfigForTypeScript,
+    type FlatConfig,
 } from 'eslint-config-typed';
 
 const thisDir = import.meta.dirname;
 
-export default defineConfig([
-    { ignores: ['**/dist/**', '**/build/**', '**/.next/**'] },
+export default [
+    { ignores: ['**/dist/**', '**/build/**', '**/.next/**', 'public/**'] },
     ...eslintConfigForTypeScript({
         tsconfigRootDir: thisDir,
         tsconfigFileName: './tsconfig.json',
         packageDirs: [thisDir],
     }),
-    eslintConfigForReact(['src/**']),
+    ...eslintConfigForReact(['src/**']),
     eslintConfigForNodeJs(['scripts/**', 'configs/**']),
     {
         files: ['scripts/**', 'configs/**'],
         rules: defineKnownRules({
             '@typescript-eslint/explicit-function-return-type': 'off',
             'no-await-in-loop': 'off',
-            'import/no-unassigned-import': 'off',
-            'import/no-internal-modules': 'off',
-            'import/no-default-export': 'off',
-            'import/no-extraneous-dependencies': 'off',
+            'import-x/no-unassigned-import': 'off',
+            'import-x/no-internal-modules': 'off',
+            'import-x/no-default-export': 'off',
+            'import-x/no-extraneous-dependencies': 'off',
         }),
     },
-]);
+] satisfies FlatConfig[];
 ```
 
 ### Node.js TypeScript Project
 
-```js
+```tsx
 import {
-    defineConfig,
-    eslintConfigForTypeScript,
-    eslintConfigForNodeJs,
     defineKnownRules,
+    eslintConfigForNodeJs,
+    eslintConfigForTypeScript,
+    type FlatConfig,
 } from 'eslint-config-typed';
 
-export default defineConfig([
+export default [
     { ignores: ['**/dist/**', '**/node_modules/**'] },
     ...eslintConfigForTypeScript({
         tsconfigRootDir: import.meta.dirname,
@@ -268,25 +376,23 @@ export default defineConfig([
         rules: defineKnownRules({
             // Allow console in Node.js
             'no-console': 'off',
-            // Allow process.env access
-            'no-process-env': 'off',
         }),
     },
-]);
+] satisfies FlatConfig[];
 ```
 
 ### React + Testing Libraries
 
-```js
+```tsx
 import {
-    defineConfig,
-    eslintConfigForTypeScript,
     eslintConfigForReact,
-    eslintConfigForVitest,
     eslintConfigForTestingLibrary,
+    eslintConfigForTypeScript,
+    eslintConfigForVitest,
+    type FlatConfig,
 } from 'eslint-config-typed';
 
-export default defineConfig([
+export default [
     { ignores: ['**/dist/**', '**/coverage/**'] },
     ...eslintConfigForTypeScript({
         tsconfigRootDir: import.meta.dirname,
@@ -296,7 +402,7 @@ export default defineConfig([
     ...eslintConfigForReact(),
     eslintConfigForVitest(),
     eslintConfigForTestingLibrary(),
-]);
+] satisfies FlatConfig[];
 ```
 
 ## VS Code Integration
@@ -310,36 +416,13 @@ Add the following to `.vscode/settings.json` for proper ESLint integration:
             "mode": "auto"
         }
     ],
-    "eslint.experimental.useFlatConfig": true,
-    "editor.codeActionsOnSave": {
-        "source.fixAll.eslint": "explicit"
-    }
+    "eslint.experimental.useFlatConfig": true
+    // "editor.codeActionsOnSave": {
+    //   "source.fixAll.eslint": "explicit"
+    // }
 }
 ```
 
-## TypeScript Configuration Files
-
-You can also write your eslint config in `.ts` or `.mts` format, all you need to do is run `npm add -D jiti`.
-
-```ts
-import {
-    eslintConfigForTypeScript,
-    eslintConfigForVitest,
-    type FlatConfig,
-} from 'eslint-config-typed';
-
-export default [
-    ...eslintConfigForTypeScript({
-        tsconfigRootDir: thisDir,
-        tsconfigFileName: './tsconfig.json',
-        packageDirs: [thisDir],
-    }),
-    eslintConfigForVitest(),
-] satisfies FlatConfig[];
-```
-
-For details, see <https://eslint.org/docs/latest/use/configure/configuration-files#typescript-configuration-files>.
-
 ## Included plugins
 
 - @typescript-eslint/eslint-plugin
@@ -351,7 +434,7 @@ For details, see <https://eslint.org/docs/latest/use/configure/configuration-fil
 - eslint-plugin-sort-destructure-keys
 - eslint-plugin-security
 - eslint-plugin-promise
-- eslint-plugin-import
+- eslint-plugin-import-x
 - eslint-plugin-strict-dependencies
 - eslint-plugin-tree-shakable (Reimplemented in this repository to support flat config)
 - eslint-plugin-react
@@ -370,7 +453,7 @@ For details, see <https://eslint.org/docs/latest/use/configure/configuration-fil
 
 ### Configuration Functions
 
-These functions return arrays of ESLint flat configurations:
+These functions return (arrays of) ESLint flat configuration(s):
 
 #### Base Configurations
 
@@ -385,7 +468,7 @@ These functions return arrays of ESLint flat configurations:
 
 - **`eslintConfigForReact(options?)`** - React configuration with hooks and JSX rules
     - `eslintConfigForBrowser` is included in this configuration
-- **`eslintConfigForPreact(options?)`** - Preact configuration (lighter React alternative)
+- **`eslintConfigForPreact(options?)`** - Preact (lighter React alternative) configuration
     - `eslintConfigForBrowser` is included in this configuration
 - **`eslintConfigForVitest(options?)`** - Vitest testing framework configuration
 - **`eslintConfigForJest(options?)`** - Jest testing framework configuration
@@ -401,31 +484,32 @@ These functions return arrays of ESLint flat configurations:
 
 Pre-configured rule sets that can be imported and customized:
 
-| Rule set                                   | Plugin name                            | Description                          |
-| :----------------------------------------- | :------------------------------------- | :----------------------------------- |
-| **`eslintRules`**                          | (eslint)                               | Core ESLint rules                    |
-| **`typescriptEslintRules`**                | `@typescript-eslint/eslint-plugin`     | TypeScript-specific ESLint rules     |
-| **`eslintFunctionalRules`**                | `eslint-plugin-functional`             | Functional programming style rules   |
-| **`eslintTotalFunctionsRules`**            | `eslint-plugin-total-functions`        | Functional programming style rules   |
-| **`eslintUnicornRules`**                   | `eslint-plugin-unicorn`                | Unicorn plugin rules for better code |
-| **`eslintArrayFuncRules`**                 | `eslint-plugin-array-func`             | Array function preference rules      |
-| **`eslintPreferArrowFunctionRules`**       | `eslint-plugin-prefer-arrow-functions` | Arrow function preference rules      |
-| **`eslintPluginSortDestructureKeysRules`** | `eslint-plugin-sort-destructure-keys`  | Object destructuring rules           |
-| **`eslintPromiseRules`**                   | `eslint-plugin-promise`                | Promise handling rules               |
-| **`eslintImportsRules`**                   | `eslint-plugin-import`                 | Import/export rules                  |
-| **`eslintSecurityRules`**                  | `eslint-plugin-security`               | Security best practices              |
-| **`eslintTreeShakableRules`**              | `eslint-plugin-tree-shakable`          | Tree-shaking optimization rules      |
-| **`eslintReactRules`**                     | `eslint-plugin-react`                  | React-specific rules                 |
-| **`eslintReactHooksRules`**                | `eslint-plugin-react-hooks`            | React Hooks rules                    |
-| **`eslintReactPerfRules`**                 | `eslint-plugin-react-perf`             | React performance optimization rules |
-| **`eslintReactRefreshRules`**              | `eslint-plugin-react-refresh`          | React Refresh (HMR) rules            |
-| **`eslintJsxA11yRules`**                   | `eslint-plugin-jsx-a11y`               | Accessibility rules for JSX          |
-| **`eslintVitestRules`**                    | `eslint-plugin-vitest`                 | Vitest-specific rules                |
-| **`eslintJestRules`**                      | `eslint-plugin-jest`                   | Jest-specific rules                  |
-| **`eslintTestingLibraryRules`**            | `eslint-plugin-testing-library`        | Testing Library rules                |
-| **`eslintPlaywrightRules`**                | `eslint-plugin-playwright`             | Playwright-specific rules            |
-| **`eslintCypressRules`**                   | `eslint-plugin-cypress`                | Cypress-specific rules               |
-| **`eslintPluginRules`**                    | `eslint-plugin-eslint-plugin`          | eslint-plugin development rules      |
+| Rule set                                   | Plugin name                            | Description                             |
+| :----------------------------------------- | :------------------------------------- | :-------------------------------------- |
+| **`eslintRules`**                          | (eslint)                               | Core ESLint rules                       |
+| **`typescriptEslintRules`**                | `@typescript-eslint/eslint-plugin`     | TypeScript-specific ESLint rules        |
+| **`eslintFunctionalRules`**                | `eslint-plugin-functional`             | Functional programming style rules      |
+| **`eslintTotalFunctionsRules`**            | `eslint-plugin-total-functions`        | Functional programming style rules      |
+| **`eslintUnicornRules`**                   | `eslint-plugin-unicorn`                | Unicorn plugin rules for better code    |
+| **`eslintArrayFuncRules`**                 | `eslint-plugin-array-func`             | Array function preference rules         |
+| **`eslintPreferArrowFunctionRules`**       | `eslint-plugin-prefer-arrow-functions` | Arrow function preference rules         |
+| **`eslintPluginSortDestructureKeysRules`** | `eslint-plugin-sort-destructure-keys`  | Object destructuring rules              |
+| **`eslintPromiseRules`**                   | `eslint-plugin-promise`                | Promise handling rules                  |
+| **`eslintImportsRules`**                   | `eslint-plugin-import-x`               | Import/export rules                     |
+| **`eslintSecurityRules`**                  | `eslint-plugin-security`               | Security best practices                 |
+| **`eslintTreeShakableRules`**              | `eslint-plugin-tree-shakable`          | Tree-shaking optimization rules         |
+| **`eslintReactRules`**                     | `eslint-plugin-react`                  | React-specific rules                    |
+| **`eslintReactHooksRules`**                | `eslint-plugin-react-hooks`            | React Hooks rules                       |
+| **`eslintReactPerfRules`**                 | `eslint-plugin-react-perf`             | React performance optimization rules    |
+| **`eslintReactRefreshRules`**              | `eslint-plugin-react-refresh`          | React Refresh (HMR) rules               |
+| **`eslintReactCodingStyleRules`**          | `eslint-plugin-react-coding-style`     | Opinionated React component style rules |
+| **`eslintJsxA11yRules`**                   | `eslint-plugin-jsx-a11y`               | Accessibility rules for JSX             |
+| **`eslintVitestRules`**                    | `eslint-plugin-vitest`                 | Vitest-specific rules                   |
+| **`eslintJestRules`**                      | `eslint-plugin-jest`                   | Jest-specific rules                     |
+| **`eslintTestingLibraryRules`**            | `eslint-plugin-testing-library`        | Testing Library rules                   |
+| **`eslintPlaywrightRules`**                | `eslint-plugin-playwright`             | Playwright-specific rules               |
+| **`eslintCypressRules`**                   | `eslint-plugin-cypress`                | Cypress-specific rules                  |
+| **`eslintPluginRules`**                    | `eslint-plugin-eslint-plugin`          | eslint-plugin development rules         |
 
 ### Exported Pre-configured Rule Options
 
@@ -434,7 +518,6 @@ Pre-configured rule sets that can be imported and customized:
 | **`restrictedGlobals`**           | `no-restricted-globals` | Array of restricted global variables                                                                                                                          |
 | **`restrictedGlobalsForBrowser`** | `no-restricted-globals` | Browser-environment-specific restricted globals                                                                                                               |
 | **`restrictedSyntax`**            | `no-restricted-syntax`  | Disallows the `in` operator, `Object.prototype.hasOwnProperty.call` (suggests using `Object.hasOwn`), and `new Array(*)` syntax (suggests using `Array.from`) |
-| **`restrictedSyntaxForReact`**    | `no-restricted-syntax`  | Rule set to restrict React component styling                                                                                                                  |
 
 You can find other pre-configured rule options by traversing the pre-defined rules object like this:
 
@@ -449,16 +532,23 @@ The shape of the rule option varies depending on the rule, so please check the c
     - `eslint-plugin-total-functions` with support for Flat Config
 - **`eslintPluginTreeShakable`**
     - `eslint-plugin-tree-shakable` with support for Flat Config
+- **`eslintPluginReactCodingStyle`**
+    - Custom ESLint plugin that codifies this repository's React memo component conventions (namespace imports, `React.memo<Props>`, arrow props naming, etc.). See [`src/plugins/react-coding-style/README.md`](src/plugins/react-coding-style/README.md) for the rationale and examples.
+    - Provides rules such as `react-coding-style/import-style`, `react-coding-style/component-var-type-annotation`, `react-coding-style/react-memo-type-parameter`, `react-coding-style/react-memo-props-argument-name`, `react-coding-style/props-type-annotation-style`, and `react-coding-style/react-hooks-definition-style`.
 - **`eslintPluginCustom`** - Custom ESLint plugin with additional rules
     - Currently, this plugin only provides the `custom/no-restricted-syntax` rule (which duplicates ESLint's `no-restricted-syntax` rule).
     - Can be used to set the error level to `error` or `warn` as needed.
 
 Example:
 
-```js
-import { eslintRules } from 'eslint-config-typed';
+```tsx
+import {
+    defineKnownRules,
+    eslintRules,
+    type FlatConfig,
+} from 'eslint-config-typed';
 
-export default defineConfig([
+export default [
     // ...
     {
         rules: defineKnownRules({
@@ -478,7 +568,7 @@ export default defineConfig([
             ],
         }),
     },
-]);
+] satisfies FlatConfig[];
 ```
 
 ### Type Definitions
@@ -488,9 +578,13 @@ All rules and configurations come with complete TypeScript type definitions:
 #### Core Types
 
 - **`FlatConfig`** - ESLint flat configuration type
+    - `= DeepReadonly<import('@typescript-eslint/utils/ts-eslint').FlatConfig>`
 - **`ESLintPlugin`** - ESLint plugin type
+    - `= DeepReadonly<import('@typescript-eslint/utils/ts-eslint').FlatConfig.Plugin>`
 - **`Rule`** - ESLint rule definition type
+    - `= DeepReadonly<import('@eslint/core').RuleDefinition>`
 - **`Rules`** - Collection of rules type
+    - `= Readonly<Record<string, Rule>>`
 
 #### Rule Types
 
@@ -533,15 +627,27 @@ The pre-configured rules of `eslint-config-typed` are opinionated settings that
 
 You can override any rule by adding a configuration object after the preset configurations:
 
-```js
-import { typescriptEslintRules } from 'eslint-config-typed';
+```tsx
+import {
+    defineKnownRules,
+    eslintConfigForTypeScript,
+    type FlatConfig,
+    typescriptEslintRules,
+    withDefaultOption,
+} from 'eslint-config-typed';
 
-export default defineConfig([
-    ...eslintConfigForTypeScript(options),
+const thisDir = import.meta.dirname;
+
+export default [
+    ...eslintConfigForTypeScript({
+        tsconfigRootDir: thisDir,
+        tsconfigFileName: './tsconfig.json',
+        packageDirs: [thisDir],
+    }),
     {
         rules: defineKnownRules({
             // Downgrade to warning (Option settings are inherited)
-            '@typescript-eslint/no-explicit-any': 'warn',
+            '@typescript-eslint/no-explicit-any': withDefaultOption('warn'),
             // Disable a rule
             '@typescript-eslint/prefer-readonly-parameter-types': 'off',
             // Configure with options
@@ -567,19 +673,18 @@ export default defineConfig([
             ],
         }),
     },
-]);
+] satisfies FlatConfig[];
 ```
 
-### Use Type-Safe Rule Options
+### Use RulesOptions Types
 
 Leverage TypeScript for type-safe rule configuration:
 
-```ts
+```tsx
 // configs/restricted-syntax-defs.mjs
 
-import { eslintRules } from 'eslint-config-typed';
+import { eslintRules, type EslintRulesOption } from 'eslint-config-typed';
 
-/** @type {import("eslint-config-typed").EslintRulesOption["no-restricted-syntax"]} */
 export const restrictedSyntax = [
     ...eslintRules['no-restricted-syntax'].slice(1),
     {
@@ -589,31 +694,54 @@ export const restrictedSyntax = [
         message:
             'The variable type T should be annotated as `React.useMemo<T>` or `const v: T = React.useMemo(...)`.',
     },
-];
+] satisfies EslintRulesOption['no-restricted-syntax'];
 ```
 
-```ts
-// eslint.config.js
+```tsx
+// eslint.config.mts
+
+import {
+    defineKnownRules,
+    eslintConfigForTypeScript,
+    type FlatConfig,
+} from 'eslint-config-typed';
+import { restrictedSyntax } from './restricted-syntax-defs.mjs';
 
-import { restrictedSyntax } from './configs/restricted-syntax-defs.mjs';
+const thisDir = import.meta.dirname;
 
-export default defineConfig([
-    ...eslintConfigForTypeScript(options),
+export default [
+    ...eslintConfigForTypeScript({
+        tsconfigRootDir: thisDir,
+        tsconfigFileName: './tsconfig.json',
+        packageDirs: [thisDir],
+    }),
     {
         rules: defineKnownRules({
-            'no-restricted-syntax': ['error', restrictedSyntax],
+            'no-restricted-syntax': ['error', ...restrictedSyntax],
         }),
     },
-]);
+] satisfies readonly FlatConfig[];
 ```
 
 ### Target Specific Files
 
 Apply different rules to different file patterns:
 
-```js
-export default defineConfig([
-    ...eslintConfigForTypeScript(options),
+```tsx
+import {
+    defineKnownRules,
+    eslintConfigForTypeScript,
+    type FlatConfig,
+} from 'eslint-config-typed';
+
+const thisDir = import.meta.dirname;
+
+export default [
+    ...eslintConfigForTypeScript({
+        tsconfigRootDir: thisDir,
+        tsconfigFileName: './tsconfig.json',
+        packageDirs: [thisDir],
+    }),
     {
         files: ['**/*.test.ts', '**/*.spec.ts'],
         rules: defineKnownRules({
@@ -628,10 +756,10 @@ export default defineConfig([
         rules: defineKnownRules({
             // Allow console in scripts
             'no-await-in-loop': 'off',
-            'import/no-unassigned-import': 'off',
+            'import-x/no-unassigned-import': 'off',
         }),
     },
-]);
+] satisfies FlatConfig[];
 ```
 
 ## Troubleshooting
@@ -642,33 +770,41 @@ export default defineConfig([
 
 Ensure the paths are correct:
 
-```js
+```tsx
+import {
+    eslintConfigForTypeScript,
+    type FlatConfig,
+} from 'eslint-config-typed';
+
 const thisDir = import.meta.dirname;
 
-export default defineConfig([
-    ...eslintConfigForTypeScript({
-        tsconfigRootDir: thisDir, // Must be absolute path
-        tsconfigFileName: './tsconfig.json', // Relative to tsconfigRootDir
-        packageDirs: [thisDir],
-    }),
-]);
+export default eslintConfigForTypeScript({
+    tsconfigRootDir: thisDir, // Must be absolute path
+    tsconfigFileName: './tsconfig.json', // Relative to tsconfigRootDir
+    packageDirs: [thisDir],
+}) satisfies readonly FlatConfig[];
 ```
 
 #### 2. Import resolution errors
 
 The `packageDirs` option helps ESLint resolve imports correctly in monorepos:
 
-```js
-export default defineConfig([
-    ...eslintConfigForTypeScript({
-        tsconfigRootDir: thisDir,
-        tsconfigFileName: './tsconfig.json',
-        packageDirs: [
-            path.resolve(thisDir, '../../..'), // Monorepo root
-            thisDir, // Current package
-        ],
-    }),
-]);
+```tsx
+import {
+    eslintConfigForTypeScript,
+    type FlatConfig,
+} from 'eslint-config-typed';
+
+const thisDir = import.meta.dirname;
+
+export default eslintConfigForTypeScript({
+    tsconfigRootDir: thisDir,
+    tsconfigFileName: './tsconfig.json',
+    packageDirs: [
+        path.resolve(thisDir, '../../..'), // Monorepo root
+        thisDir, // Current package
+    ],
+}) satisfies readonly FlatConfig[];
 ```
 
 #### 3. Performance issues
@@ -682,9 +818,36 @@ For large projects, consider:
 - Running ESLint with `--cache` flag
 - Limiting the scope of type-aware rules
 
+#### 4. How to Use import-x/no-unused-modules
+
+[`import-x/no-unused-modules`](https://github.com/un-ts/eslint-plugin-import-x/blob/v4.16.1/docs/rules/no-unused-modules.md) reports exported values that are never imported anywhere else. The rule still relies on ESLint’s classic configuration loader to discover ignore patterns, so a flat-config-only setup is not enough. For this to work, you need to place a `.eslintrc.cjs` file along with `eslint.config.mts`.
+
+```cjs
+// .eslintrc.cjs
+module.exports = {
+    ignorePatterns: ['**/node_modules/**', 'dist', '.eslintrc.cjs'],
+};
+```
+
+The flat config then enables the rule for our source tree and marks the public federation module as an allowed unused export:
+
+```ts
+// eslint.config.mts (excerpt)
+{
+  files: ['src/**'],
+  rules: defineKnownRules({
+    'import-x/no-unused-modules': [
+      'error',
+      { unusedExports: true, ignoreExports: ['src/entry-point.mts'] },
+    ],
+  }),
+},
+```
+
+With this configuration, you can run eslint and receive actionable diagnostic information when exports are no longer referenced. If you implement a library, add the file paths that define the variables, types, etc. that your library exports to the `ignoreExports` array so that the rule does not flag intentionally re-exported surfaces.
+
 ### Known Limitations
 
-- The `import/no-unused-modules` rule does not function properly with Native ESM
 - Some type-aware rules may have performance impacts on very large codebases
 - Flat config requires ESLint 9.0+ and may not be compatible with older tools