@zpcscc/configs 3.0.5 → 3.0.7

package/README.md

@@ -1,6 +1,6 @@
 # @zpcscc/configs
 
-[![NPM version](https://img.shields.io/npm/v/@zpcscc/configs.svg?style=flat)](https://www.npmjs.com/package/@zpcscc/configs) 
+[![NPM version](https://img.shields.io/npm/v/@zpcscc/configs.svg?style=flat)](https://www.npmjs.com/package/@zpcscc/configs)
 
 [![NPM downloads](http://img.shields.io/npm/dm/@zpcscc/configs.svg?style=flat)](https://www.npmjs.com/package/@zpcscc/configs)
 
@@ -17,46 +17,44 @@ npm install --save-dev @zpcscc/configs
 
 ## 使用
 
-### eslint
+### eslint（ESLint 9 Flat Config）
 
-`.eslintrc.js`
+`eslint.config.mjs`
 
 #### 基础配置
 
 ```javascript
-module.exports = {
-  extends: [require.resolve('@zpcscc/configs/eslint-config')],
-};
+import baseConfig from '@zpcscc/configs/eslint-config';
+
+export default [...baseConfig];
 ```
 
-#### react的eslint配置
+#### react 的 eslint 配置
 
 ```javascript
-module.exports = {
-  extends: [require.resolve('@zpcscc/configs/eslint-config/react')],
-};
+import reactConfig from '@zpcscc/configs/eslint-config/react';
+
+export default [...reactConfig];
 ```
 
-#### 补充配置
+#### 自定义覆盖
 
 ```javascript
-module.exports = {
-  // 由于使用了eslint-config-standard-with-typescript插件对ts的支持
-  // 部分规则需要tsconfig.json配置,需要在这里引入tsconfig.json文件
-  parserOptions: {
-    project: ['./tsconfig.json'],
+import baseConfig from '@zpcscc/configs/eslint-config';
+
+export default [
+  ...baseConfig,
+  // 自定义规则覆盖
+  {
+    rules: {
+      'no-console': 'warn',
+    },
   },
-};
-```
-
-`tsconfig.json`
-
-tsconfig.json 文件中，也需要在 include 中引入.eslintrc.js 文件
-
-```json
-{
-  "include": [".eslintrc.js"]
-}
+  // 忽略文件
+  {
+    ignores: ['dist/**', 'coverage/**'],
+  },
+];
 ```
 
 

package/eslint-config/index.js

@@ -1,256 +1,284 @@
-// 官方文档 https://eslint.org/
+// ESLint 9 Flat Config
+// 官方文档 https://eslint.org/docs/latest/use/configure/configuration-files
 // @ts-check
+const js = require('@eslint/js');
+const tseslint = require('typescript-eslint');
+const importXPlugin = require('eslint-plugin-import-x');
+const unicornPlugin = require('eslint-plugin-unicorn').default;
+const promisePlugin = require('eslint-plugin-promise');
+const eslintCommentsPlugin = require('@eslint-community/eslint-plugin-eslint-comments');
+const globals = require('globals');
+
 /**
- * @type {import("eslint").Linter.Config}
+ * 基础 ESLint Flat Config
+ * 适用于所有项目（纯 JS/TS，非 React）
+ *
+ * 使用方式（eslint.config.mjs）：
+ *   import baseConfig from '@zpcscc/configs/eslint-config';
+ *   export default [...baseConfig];
+ *
+ * 或带自定义覆盖：
+ *   import baseConfig from '@zpcscc/configs/eslint-config';
+ *   export default [...baseConfig, { rules: { 'no-console': 'warn' } }];
  */
-module.exports = {
-  extends: [
-  // eslint 的官方推荐配置
-  'eslint:recommended',
-  // eslint的标准配置
-  'standard',
-  // 对eslint注释的提示
-  'plugin:eslint-comments/recommended',
-  // ts推荐配置，做了一些兼容处理
-  'plugin:@typescript-eslint/recommended',
-  // eslint-plugin-import---对import的导入进行检查
-  'plugin:import/recommended',
-  // eslint-import-resolver-typescript---import校验对typescript的支持。是eslint-plugin-import插件的补充
-  'plugin:import/typescript',
-  // unicorn的推荐配置
-  'plugin:unicorn/recommended',
-  // 对promise的推荐配置
-  'plugin:promise/recommended',
-  /**
-   * eslint-plugin-prettier的推荐配置，需要放在最后一位，内部启用了eslint-plugin-prettier插件
-   * 用于关闭eslint中的所有格式化配置，全部在.prettierrc中进行格式化配置
-   */
-  'plugin:prettier/recommended'],
-  // 如果要在rules中针对某个插件做具体配置，则需要在plugins里先引入对应插件
-  plugins: ['@typescript-eslint', 'unicorn', 'promise', 'import'],
-  parserOptions: {
-    ecmaVersion: 'latest'
+module.exports = tseslint.config(
+  // ===== 基础推荐规则 =====
+  js.configs.recommended,
+
+  // ===== TypeScript =====
+  ...tseslint.configs.recommended,
+  {
+    languageOptions: {
+      ecmaVersion: 'latest',
+      sourceType: 'module',
+      parserOptions: {
+        ecmaFeatures: { jsx: true },
+      },
+    },
+    settings: {
+      'import-x/resolver': {
+        typescript: true,
+        node: true,
+      },
+    },
   },
-  // 运行的环境
-  env: {
-    browser: true,
-    commonjs: true,
-    es2024: true,
-    node: true,
-    jest: true
+
+  // ===== Import-X =====
+  importXPlugin.flatConfigs.recommended,
+  importXPlugin.flatConfigs.typescript,
+
+  // ===== Unicorn =====
+  unicornPlugin.configs['flat/recommended'],
+
+  // ===== Promise =====
+  promisePlugin.configs['flat/recommended'],
+
+  // ===== ESLint Comments =====
+  // eslintCommentsPlugin.configs.recommended 是旧格式，手动配置 flat config 版本
+  {
+    plugins: {
+      '@eslint-community/eslint-comments': eslintCommentsPlugin,
+    },
+    rules: {
+      '@eslint-community/eslint-comments/disable-enable-pair': 'error',
+      '@eslint-community/eslint-comments/no-aggregating-enable': 'error',
+      '@eslint-community/eslint-comments/no-duplicate-disable': 'error',
+      '@eslint-community/eslint-comments/no-unlimited-disable': 'error',
+      '@eslint-community/eslint-comments/no-unused-enable': 'error',
+    },
   },
-  settings: {
-    // eslint-import-resolver-typescript
-    'import/resolver': {
-      typescript: true,
-      node: true
-    }
+
+  // ===== 全局变量 + 环境 =====
+  {
+    languageOptions: {
+      globals: {
+        ...globals.browser,
+        ...globals.commonjs,
+        ...globals.jest,
+        // 自定义全局类型
+        Any: 'readonly',
+        AnyArray: 'readonly',
+        AnyObject: 'readonly',
+        AnyFunction: 'readonly',
+        NodeJS: 'readonly',
+      },
+    },
   },
-  globals: {
-    Any: true,
-    AnyArray: true,
-    AnyObject: true,
-    AnyFunction: true,
-    NodeJS: true
+
+  // ===== 自定义 Rules =====
+  {
+    rules: {
+      // --- TypeScript 规则 ---
+      // 数组类型。不限制写法
+      '@typescript-eslint/array-type': 'off',
+      // 强制要求注释描述，关闭
+      '@typescript-eslint/ban-ts-comment': 'off',
+      // 强制使用一致性类型断言。关闭，两种语法都允许
+      '@typescript-eslint/consistent-type-assertions': 'off',
+      // 强制 ts 类型使用 type 关键字
+      '@typescript-eslint/consistent-type-definitions': ['error', 'type'],
+      // import 类型时，需要加 type，使用内联方式
+      '@typescript-eslint/consistent-type-imports': [
+        'error',
+        { fixStyle: 'inline-type-imports' },
+      ],
+      // 显示函数返回类型。关闭
+      '@typescript-eslint/explicit-function-return-type': 'off',
+      // 无混淆空表达式。关闭（需要 type-aware linting，由消费者自行配置）
+      '@typescript-eslint/no-confusing-void-expression': 'off',
+      // 不允许有 any 类型。关闭，特殊情况需要
+      '@typescript-eslint/no-explicit-any': 'off',
+      // 禁止 require() 导入。关闭，部分场景需要 CJS
+      '@typescript-eslint/no-require-imports': 'off',
+      // 无浮动的 promise。关闭
+      '@typescript-eslint/no-floating-promises': 'off',
+      // 不得滥用 promise。关闭
+      '@typescript-eslint/no-misused-promises': 'off',
+      // 禁止变量重新声明
+      '@typescript-eslint/no-redeclare': 'error',
+      // 禁止未使用的表达式
+      '@typescript-eslint/no-unused-expressions': [
+        'error',
+        { allowShortCircuit: true, allowTernary: true },
+      ],
+      // 禁止使用类型断言。关闭
+      '@typescript-eslint/non-nullable-type-assertion-style': 'off',
+      // 限制命名规则。关闭，命名希望灵活些
+      '@typescript-eslint/naming-convention': 'off',
+      // 使用 ?? 替换 ||。关闭，部分场景需要手动选择
+      '@typescript-eslint/prefer-nullish-coalescing': 'off',
+      // promise 函数都需要使用 async。关闭
+      '@typescript-eslint/promise-function-async': 'off',
+      // 限制 + 操作符。关闭
+      '@typescript-eslint/restrict-plus-operands': 'off',
+      // 限制模板表达式。关闭
+      '@typescript-eslint/restrict-template-expressions': 'off',
+      // async 函数返回值需要有 await。关闭（需要 type-aware linting）
+      '@typescript-eslint/return-await': 'off',
+      // 严格的逻辑表达式。关闭
+      '@typescript-eslint/strict-boolean-expressions': 'off',
+      // 禁止三斜杠指令
+      '@typescript-eslint/triple-slash-reference': 'off',
+
+      // --- Import-X 规则 ---
+      'import-x/named': 'off',
+      'import-x/export': 'off',
+      'import-x/extensions': 'off',
+      'import-x/no-cycle': 'off',
+      'import-x/no-extraneous-dependencies': 'off',
+      'import-x/no-named-as-default': 'off',
+      'import-x/no-relative-packages': 'off',
+      'import-x/no-unresolved': 'off',
+      'import-x/prefer-default-export': 'off',
+      'import-x/no-duplicates': 'error',
+
+      // --- Unicorn 规则 ---
+      'unicorn/consistent-destructuring': 'off',
+      'unicorn/consistent-function-scoping': 'off',
+      'unicorn/prevent-abbreviations': 'off',
+      'unicorn/new-for-builtins': 'off',
+      'unicorn/no-array-callback-reference': 'off',
+      'unicorn/no-array-for-each': 'off',
+      'unicorn/no-array-reduce': 'off',
+      'unicorn/no-new-array': 'off',
+      'unicorn/no-null': 'off',
+      'unicorn/numeric-separators-style': 'off',
+      'unicorn/prefer-module': 'off',
+      'unicorn/filename-case': 'off',
+
+      // --- ESLint Comments 规则 ---
+      'eslint-comments/disable-enable-pair': 'off',
+
+      // --- Promise 规则 ---
+      'promise/always-return': 'off',
+      'promise/catch-or-return': 'off',
+
+      // --- 基础规则 ---
+      // 箭头函数体是否强制使用大括号。关闭
+      'arrow-body-style': 'off',
+      // if 语句是否需要加括号。多行加括号，单行不需要
+      curly: ['error', 'multi-line'],
+      'default-param-last': 'off',
+      // 禁止 console。关闭
+      'no-console': 'off',
+      // 禁止 continue。关闭
+      'no-continue': 'off',
+      // 禁止速记类型转换
+      'no-implicit-coercion': ['error'],
+      // async 返回值需要 await。关闭，使用 TS 的同名规则
+      'no-return-await': 'off',
+      // 禁止未使用的表达式。关闭，使用 TS 版本
+      'no-unused-expressions': 'off',
+      // 函数名称后需要跟一个空格。关闭
+      'space-before-function-paren': 'off',
+
+      // --- 以下规则已整理 ---
+      'array-bracket-spacing': ['error', 'never'],
+      'arrow-parens': ['error', 'always'],
+      'arrow-spacing': ['error', { after: true, before: true }],
+      camelcase: 'off',
+      'consistent-return': 'off',
+      'class-methods-use-this': 'off',
+      'default-case-last': ['error'],
+      'eol-last': ['error'],
+      eqeqeq: 'error',
+      'func-names': ['warn', 'never', { generators: 'as-needed' }],
+      'func-style': ['error'],
+      'keyword-spacing': ['error'],
+      'lines-between-class-members': 'off',
+      'max-classes-per-file': 'off',
+      'max-len': 'off',
+      'no-bitwise': ['error'],
+      'no-class-assign': ['error'],
+      'no-cond-assign': ['error', 'except-parens'],
+      'no-const-assign': ['error'],
+      'no-constructor-return': ['error'],
+      'no-dupe-class-members': ['error'],
+      'no-else-return': ['error'],
+      'no-eval': ['error'],
+      'no-inner-declarations': 'off',
+      'no-labels': ['error'],
+      'no-lonely-if': ['error'],
+      'no-new': ['error'],
+      'no-promise-executor-return': ['error'],
+      'no-param-reassign': ['error', { props: false }],
+      'no-plusplus': 'off',
+      'no-return-assign': ['error', 'except-parens'],
+      'no-shadow': 'off',
+      'no-mixed-spaces-and-tabs': ['error'],
+      'no-multi-assign': 'off',
+      'no-multiple-empty-lines': ['error'],
+      'no-nested-ternary': 'off',
+      'no-spaced-func': 'error',
+      'no-trailing-spaces': ['error'],
+      'no-use-before-define': 'off',
+      'no-useless-computed-key': ['error'],
+      'no-useless-concat': ['error'],
+      'no-useless-constructor': 'off',
+      'no-useless-return': ['error'],
+      'no-useless-rename': ['error'],
+      'no-undef': ['error'],
+      'no-unexpected-multiline': ['error'],
+      'no-unreachable-loop': ['error'],
+      'no-unneeded-ternary': ['error'],
+      'no-unused-vars': [
+        'error',
+        { args: 'none', vars: 'all' },
+      ],
+      'no-var': ['error'],
+      'no-void': ['error'],
+      'object-shorthand': [
+        'error',
+        'always',
+        { avoidQuotes: true, ignoreConstructors: false },
+      ],
+      'prefer-arrow-callback': [
+        'error',
+        { allowNamedFunctions: false, allowUnboundThis: true },
+      ],
+      'prefer-const': ['error'],
+      'prefer-destructuring': 'off',
+      'prefer-rest-params': ['error'],
+      'prefer-template': ['error'],
+      quotes: ['error', 'single'],
+      'require-atomic-updates': ['error'],
+      semi: ['error', 'always'],
+      'space-before-blocks': ['error', 'always'],
+      'space-in-parens': ['error', 'never'],
+      'space-unary-ops': ['error', { nonwords: false, overrides: {} }],
+      'symbol-description': ['error'],
+      'template-curly-spacing': ['error', 'never'],
+    },
   },
-  rules: {
-    // 数组类型。这里不限制写法
-    '@typescript-eslint/array-type': 'off',
-    // 强制要求注释描述，这里关闭
-    '@typescript-eslint/ban-ts-comment': 'off',
-    // 强制使用一致性类型断言。<>语法，或者as语法
-    '@typescript-eslint/consistent-type-assertions': 'off',
-    // 强制ts类型使用type关键字，好处是，type关键字可以让ts类型更加明确，鼠标悬浮可以显示具体类型，且有interface的所有功能；
-    '@typescript-eslint/consistent-type-definitions': ['error', 'type'],
-    // import 类型时，需要加 type，使用内联方式。 import { type FC } from 'react'
-    '@typescript-eslint/consistent-type-imports': ['error', {
-      fixStyle: 'inline-type-imports'
-    }],
-    // 显示函数返回类型。关闭此校验，部分函数没有返回值。无需每个都显示类型
-    '@typescript-eslint/explicit-function-return-type': 'off',
-    /**
-     * 无混淆空表达式。默认所有void都不能直接返回，需要用{}包裹。这里排除掉箭头函数。
-     * 可以直接写成 onchange={(value)=> onChange(value) }
-     * 而不是 onchange={(value)=>{ onChange(value) }}
-     */
-    '@typescript-eslint/no-confusing-void-expression': ['error', {
-      ignoreArrowShorthand: true
-    }],
-    // ts不允许有any类型。关闭此校验，特殊情况，需要any类型
-    '@typescript-eslint/no-explicit-any': 'off',
-    // 无浮动的promise，要求处理每个promise的then和catch。
-    '@typescript-eslint/no-floating-promises': 'off',
-    // 不得滥用promise，这里关闭
-    '@typescript-eslint/no-misused-promises': 'off',
-    // 禁止变量重新声明
-    '@typescript-eslint/no-redeclare': 'error',
-    // 禁止未使用的表达式
-    '@typescript-eslint/no-unused-expressions': ['error', {
-      allowShortCircuit: true,
-      allowTernary: true
-    }],
-    // 禁止使用类型断言，应使用 ！进行断言，这里关闭。类型断言更语意化，会好些。
-    '@typescript-eslint/non-nullable-type-assertion-style': 'off',
-    // 限制命名规则。这里关闭。命名希望灵活些
-    '@typescript-eslint/naming-convention': 'off',
-    // 为了安全使用 ?? 替换 ||。关闭此选项，部分场景，需要手动选择??还是||； ??会把空字符串也认为是true
-    '@typescript-eslint/prefer-nullish-coalescing': 'off',
-    // promise函数都需要使用async。这里关闭。
-    '@typescript-eslint/promise-function-async': 'off',
-    // 限制 + 操作符，两边必须相同。这里关闭
-    '@typescript-eslint/restrict-plus-operands': 'off',
-    // 限制模板表达式。关闭此校验，希望模板表达式更加灵活
-    '@typescript-eslint/restrict-template-expressions': 'off',
-    // 若函数是async，则返回值需要有await
-    '@typescript-eslint/return-await': ['error'],
-    // 严格的逻辑表达式。关闭此选项，可以使用 !value 的方式来进行判断；
-    '@typescript-eslint/strict-boolean-expressions': 'off',
-    // 禁止某些支持 ES6 样式导入声明的三重斜杠指令
-    '@typescript-eslint/triple-slash-reference': 'off',
-    // 函数体周围是否强制使用大括号。这里关闭，不强制。部分小函数，单行可以实现时，无需大括号限制
-    'arrow-body-style': 'off',
-    // if语句是否需要加括号。设置为多行加括号，单行不需要加括号
-    curly: ['error', 'multi-line'],
-    'default-param-last': 'off',
-    // 禁止整个文件的注释，只允许注释文件块。这里关闭。
-    'eslint-comments/disable-enable-pair': 'off',
-    // 名称校验，这里关闭
-    'import/named': 'off',
-    // 禁止console输入。这里关闭
-    'no-console': 'off',
-    // 禁止使用continue跳出循环。这里关闭
-    'no-continue': 'off',
-    // 禁止速记类型转换
-    'no-implicit-coercion': ['error'],
-    // 若函数是async，则返回值需要有await，这里关闭，使用typescript的同名规则；
-    'no-return-await': 'off',
-    // 禁止未使用的表达式
-    'no-unused-expressions': 'off',
-    // 函数名称后需要跟一个空格。这里关闭
-    'space-before-function-paren': 'off',
-    // 在属性上使用析构函数变量。这里关闭
-    'unicorn/consistent-destructuring': 'off',
-    // 箭头函数移动到外部作用于。这里关闭。在react组件内，经常会使用到箭头函数
-    'unicorn/consistent-function-scoping': 'off',
-    // 使用更具有描述性的名称。这里关闭
-    'unicorn/prevent-abbreviations': 'off',
-    // 不允许使用 新的特性。这里关闭
-    'unicorn/new-for-builtins': 'off',
-    // 禁止将函数直接传给方法。这里关闭。
-    'unicorn/no-array-callback-reference': 'off',
-    // 不允许使用 array的forEach。这里管理
-    'unicorn/no-array-for-each': 'off',
-    // 不允许使用 array的reduce方法。这里关闭
-    'unicorn/no-array-reduce': 'off',
-    // 不允许使用 new Array()声明数组。这里关闭
-    'unicorn/no-new-array': 'off',
-    // 不使用 null。这里关闭。实际上，与后台交互时，经常需要用到null。也更有语义化。
-    'unicorn/no-null': 'off',
-    // 强制使用数字分隔符。这里关闭。
-    'unicorn/numeric-separators-style': 'off',
-    // 使用esm的格式，而不是commonjs。这里关闭。部分模块还是需要使用commonjs保证兼容性
-    'unicorn/prefer-module': 'off',
-    // 以下配置待整理完善，以上配置已整理，尽量不要动了。
-    'array-bracket-spacing': ['error', 'never'],
-    'arrow-parens': ['error', 'always'],
-    'arrow-spacing': ['error', {
-      after: true,
-      before: true
-    }],
-    camelcase: 'off',
-    'consistent-return': 'off',
-    'class-methods-use-this': 'off',
-    'default-case-last': ['error'],
-    'eol-last': ['error'],
-    eqeqeq: 'error',
-    'func-names': ['warn', 'never', {
-      generators: 'as-needed'
-    }],
-    'func-style': ['error'],
-    'import/export': 'off',
-    'import/extensions': 'off',
-    'import/no-cycle': 'off',
-    'import/no-extraneous-dependencies': 'off',
-    'import/no-named-as-default': 'off',
-    'import/no-relative-packages': 'off',
-    'import/no-unresolved': 'off',
-    'import/prefer-default-export': 'off',
-    'keyword-spacing': ['error'],
-    'lines-between-class-members': 'off',
-    'max-classes-per-file': 'off',
-    'max-len': ['error', {
-      code: 180,
-      ignoreComments: true,
-      ignoreRegExpLiterals: true
-    }],
-    'no-bitwise': ['error'],
-    'no-class-assign': ['error'],
-    'no-cond-assign': ['error', 'except-parens'],
-    'no-const-assign': ['error'],
-    'no-constructor-return': ['error'],
-    'no-dupe-class-members': ['error'],
-    'no-duplicate-imports': ['error'],
-    'no-else-return': ['error'],
-    'no-eval': ['error'],
-    'no-inner-declarations': 'off',
-    'no-labels': ['error'],
-    'no-lonely-if': ['error'],
-    'no-new': ['error'],
-    'no-promise-executor-return': ['error'],
-    'no-param-reassign': ['error', {
-      props: false
-    }],
-    'no-plusplus': 'off',
-    'no-return-assign': ['error', 'except-parens'],
-    'no-shadow': 'off',
-    'no-mixed-spaces-and-tabs': ['error'],
-    'no-multi-assign': 'off',
-    'no-multiple-empty-lines': ['error'],
-    'no-nested-ternary': 'off',
-    'no-new-symbol': ['error'],
-    'no-spaced-func': ['error'],
-    'no-trailing-spaces': ['error'],
-    'no-use-before-define': 'off',
-    'no-useless-computed-key': ['error'],
-    'no-useless-concat': ['error'],
-    'no-useless-constructor': 'off',
-    'no-useless-return': ['error'],
-    'no-useless-rename': ['error'],
-    'no-undef': ['error'],
-    'no-unexpected-multiline': ['error'],
-    'no-unreachable-loop': ['error'],
-    'no-unneeded-ternary': ['error'],
-    'no-unused-vars': ['error', {
-      args: 'none',
-      vars: 'all'
-    }],
-    'no-var': ['error'],
-    'no-void': ['error'],
-    'object-shorthand': ['error', 'always', {
-      avoidQuotes: true,
-      ignoreConstructors: false
-    }],
-    'prefer-arrow-callback': ['error', {
-      allowNamedFunctions: false,
-      allowUnboundThis: true
-    }],
-    'prefer-const': ['error'],
-    'prefer-destructuring': 'off',
-    'prefer-rest-params': ['error'],
-    'prefer-template': ['error'],
-    'promise/always-return': 'off',
-    'promise/catch-or-return': 'off',
-    quotes: ['error'],
-    'require-atomic-updates': ['error'],
-    semi: ['error', 'always'],
-    'space-before-blocks': ['error', 'always'],
-    'space-in-parens': ['error', 'never'],
-    'space-unary-ops': ['error', {
-      nonwords: false,
-      overrides: {}
-    }],
-    'symbol-description': ['error'],
-    'template-curly-spacing': ['error', 'never'],
-    'unicorn/filename-case': 'off'
-  }
-};
+
+  // ===== 忽略文件 =====
+  {
+    ignores: [
+      '**/node_modules/**',
+      '**/dist/**',
+      '**/docs-dist/**',
+      '**/.dumi/**',
+      '**/*.d.ts',
+    ],
+  },
+);

package/eslint-config/react/index.js

@@ -1,55 +1,69 @@
+// ESLint 9 Flat Config - React 扩展
 // @ts-check
+const tseslint = require('typescript-eslint');
+const reactPlugin = require('eslint-plugin-react');
+const reactHooksPlugin = require('eslint-plugin-react-hooks');
+const jsxA11yPlugin = require('eslint-plugin-jsx-a11y');
+const { FlatCompat } = require('@eslint/eslintrc');
+const baseConfig = require('../index');
+
+const compat = new FlatCompat();
+
 /**
- * @type {import("eslint").Linter.Config}
+ * React ESLint Flat Config
+ * 在基础配置上增加 React 相关规则
+ *
+ * 使用方式（eslint.config.mjs）：
+ *   import reactConfig from '@zpcscc/configs/eslint-config/react';
+ *   export default [...reactConfig];
  */
-module.exports = {
-  extends: [
-  // 对react的推荐配置
-  'plugin:react/recommended',
-  // react17及以上，新的jsx转换规则，需要引入react/jsx-runtime以禁止部分规则
-  'plugin:react/jsx-runtime',
-  // react-hook的推荐配置
-  'plugin:react-hooks/recommended',
-  // 对jsx的支持与推荐配置
-  'plugin:jsx-a11y/recommended', require.resolve("../index")],
-  plugins: ['react', 'react-hooks'],
-  // 使用typescript解析器
-  parser: '@typescript-eslint/parser',
-  parserOptions: {
-    // 使用额外的语言特性
-    ecmaFeatures: {
-      // 开启jsx支持
-      jsx: true,
-      sourceType: 'module'
-    }
+module.exports = tseslint.config(
+  // 继承基础配置
+  ...baseConfig,
+
+  // React 插件（原生 flat config）
+  reactPlugin.configs.flat.recommended,
+  reactPlugin.configs.flat['jsx-runtime'],
+
+  // React Hooks（使用 FlatCompat 兼容旧格式）
+  ...compat.config(reactHooksPlugin.configs.recommended),
+
+  // JSX A11y
+  jsxA11yPlugin.flatConfigs.recommended,
+
+  // React 特定配置
+  {
+    languageOptions: {
+      parserOptions: {
+        ecmaFeatures: { jsx: true },
+      },
+    },
+    settings: {
+      react: {
+        version: 'detect',
+      },
+    },
+    plugins: {
+      react: reactPlugin,
+    },
+    rules: {
+      'react/destructuring-assignment': 'off',
+      'react/jsx-uses-react': 'off',
+      'react/jsx-props-no-spreading': 'off',
+      // props 类型检查，TS 有静态类型检查
+      'react/prop-types': 'off',
+      'react/react-in-jsx-scope': 'off',
+      'react/self-closing-comp': 'warn',
+      'react/sort-comp': 'off',
+      'react/no-access-state-in-setstate': 'off',
+      // 忽略 emotion 的 css 属性报错
+      'react/no-unknown-property': ['error', { ignore: ['css'] }],
+      // useEffect 依赖数组提示
+      'react-hooks/exhaustive-deps': 'off',
+      // 非 button 元素点击事件必须有键盘事件。关闭
+      'jsx-a11y/click-events-have-key-events': 'off',
+      // 交互式元素应是可聚焦的。关闭
+      'jsx-a11y/interactive-supports-focus': 'off',
+    },
   },
-  settings: {
-    // eslint-plugin-react的配置https://github.com/jsx-eslint/eslint-plugin-react#configuration
-    react: {
-      version: 'detect'
-    }
-  },
-  rules: {
-    'react/destructuring-assignment': 'off',
-    // react17之后引入新的jsx转换。不再需要显示引入react。这两项规则需要关闭。
-    'react/jsx-uses-react': 'off',
-    'react/jsx-props-no-spreading': 'off',
-    // props类型检查.关闭此校验，ts有静态类型检查
-    'react/prop-types': 'off',
-    'react/react-in-jsx-scope': 'off',
-    'react/self-closing-comp': 'warn',
-    'react/sort-comp': 'off',
-    'react/no-access-state-in-setstate': 'off',
-    // 禁止未知属性。这里忽略emotion里的css属性报错。将css属性视为正常属性
-    'react/no-unknown-property': ['error', {
-      ignore: ['css']
-    }],
-    // useEffect数组的提示
-    'react-hooks/exhaustive-deps': 'off',
-    // 非button的元素点击事件必须同时有个键盘事件。这里关闭
-    'jsx-a11y/click-events-have-key-events': 'off',
-    // 交互式元素应是可聚焦的。这里关闭
-    'jsx-a11y/interactive-supports-focus': 'off'
-    // 强制填写了默认值的参数在最后。需关闭此选项，否则部分函数参数值，无法任意调整位置。
-  }
-};
+);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zpcscc/configs",
-  "version": "3.0.5",
+  "version": "3.0.7",
   "description": "项目通用配置",
   "keywords": [
     "commitlint",
@@ -27,7 +27,7 @@
     "types"
   ],
   "scripts": {
-    "build": "father build && mkdir -p dist/tsconfig && cp src/tsconfig/tsconfig.json dist/tsconfig/",
+    "build": "father build && mkdir -p dist/tsconfig && cp src/tsconfig/tsconfig.json dist/tsconfig/ && rm -rf dist/eslint-config && cp -r src/eslint-config dist/eslint-config",
     "build:watch": "father dev",
     "commit": "git add . && git-cz",
     "deploy": "pnpm run docs:build && pnpm run docs:deploy",
@@ -43,31 +43,32 @@
     "@babel/plugin-syntax-flow": "7.26.0",
     "@babel/plugin-transform-react-jsx": "7.25.9",
     "@babel/runtime": "7.26.10",
-    "@commitlint/cz-commitlint": "19.8.0",
+    "@commitlint/cz-commitlint": "20.5.0",
+    "@eslint-community/eslint-plugin-eslint-comments": "4.7.1",
+    "@eslint/eslintrc": "3.3.5",
+    "@eslint/js": "9.39.4",
     "@types/node": "22.13.10",
     "@types/react": "19.0.11",
     "@types/react-dom": "19.0.4",
-    "@typescript-eslint/eslint-plugin": "8.26.1",
-    "@typescript-eslint/parser": "8.26.1",
     "commitizen": "4.3.1",
-    "eslint": "8.57.0",
+    "eslint": "9.27.0",
     "eslint-config-prettier": "10.1.1",
-    "eslint-config-standard": "17.1.0",
     "eslint-import-resolver-typescript": "4.2.0",
-    "eslint-plugin-eslint-comments": "3.2.0",
-    "eslint-plugin-import": "2.31.0",
+    "eslint-plugin-import-x": "4.16.2",
     "eslint-plugin-jsx-a11y": "6.10.2",
     "eslint-plugin-prettier": "5.2.3",
-    "eslint-plugin-promise": "6.6.0",
-    "eslint-plugin-react": "7.37.4",
+    "eslint-plugin-promise": "7.2.1",
+    "eslint-plugin-react": "7.37.5",
     "eslint-plugin-react-hooks": "5.2.0",
-    "eslint-plugin-unicorn": "56.0.1",
-    "inquirer": "9.3.5",
+    "eslint-plugin-unicorn": "59.0.1",
+    "globals": "17.4.0",
+    "inquirer": "9.3.8",
     "postcss": "8.5.3",
     "prettier": "3.5.3",
     "prettier-plugin-organize-imports": "4.1.0",
     "prettier-plugin-packagejson": "2.5.10",
-    "typescript": "5.8.2"
+    "typescript": "5.8.2",
+    "typescript-eslint": "8.57.2"
   },
   "devDependencies": {
     "dumi": "2.4.18",

package/tsconfig/tsconfig.json

@@ -34,15 +34,13 @@
     "sourceMap": true,
     // 报告未使用的局部变量的错误。建议开启
     "noUnusedLocals": true,
-    // 严格的空检查；建议开启，方便提示某字段可能为null，undefined，false等情况
-    "strictNullChecks": true,
     // 启用对装饰器的实验性支持
     "experimentalDecorators": true,
     // 允许默认全部导出，而不是 * as newName的形式
     "allowSyntheticDefaultImports": true,
-    // 开启后，所有的文件都应是模块
-    "isolatedModules": false
-    // 模块导入修复。启用此项会自动启用 allowSyntheticDefaultImports // ts 5.0后才支持。
+    // 开启后，所有的文件都应是模块。Vite/esbuild/SWC 等工具链要求开启
+    "isolatedModules": true
+    // TS 5.0+ 推荐开启，替代 esModuleInterop + allowSyntheticDefaultImports
     // "verbatimModuleSyntax": true
     // 允许在项目中导入js文件
     // "allowJs": true,