@fast-china/eslint-config 1.0.48 → 1.1.0

package/dist/index.js

@@ -1,273 +1,250 @@
-// src/configs/common.ts
-import { defineConfig } from "eslint/config";
+import { defineConfig } from 'eslint/config';
+import eslintPluginJsonc from 'eslint-plugin-jsonc';
+import globals from 'globals';
+import eslintConfigFlatGitignore from 'eslint-config-flat-gitignore';
+import eslintPluginImportX from 'eslint-plugin-import-x';
+import eslint from '@eslint/js';
+import eslintMarkdown from '@eslint/markdown';
+import eslintConfigPrettierFlat from 'eslint-config-prettier/flat';
+import eslintPluginRegexp from 'eslint-plugin-regexp';
+import tseslint2 from 'typescript-eslint';
+import eslintPluginVue from 'eslint-plugin-vue';
+import vueEslintParser from 'vue-eslint-parser';
+
+// src/configs/json.ts
+
+// src/constants/index.ts
+var CONST_JS = "**/*.?([cm])js";
+var CONST_JSX = "**/*.?([cm])jsx";
+var CONST_TS = "**/*.?([cm])ts";
+var CONST_TSX = "**/*.?([cm])tsx";
+var CONST_DTS = "**/*.d.ts";
+var CONST_JSON = "**/*.json";
+var CONST_JSONC = "**/*.jsonc";
+var CONST_JSON5 = "**/*.json5";
+var CONST_MD = "**/*.md";
+var CONST_VUE = "**/*.vue";
+var CONST_YAML = "**/*.y?(a)ml";
+var CONST_NODE_MODULES = "**/node_modules/**";
+var CONST_DIST = "**/dist/**";
+var CONST_LOCKFILE = ["**/package-lock.json", "**/yarn.lock", "**/pnpm-lock.yaml", "**/bun.lock", "**/bun.lockb", "**/deno.lock"];
+var CONST_PUBLIC = "**/public";
+var CONST_TSCONFIG = ["**/tsconfig.json", "**/tsconfig.*.json"];
+var GLOB_JAVASCRIPT = [CONST_JS, CONST_JSX];
+var GLOB_TYPESCRIPT = [CONST_TS, CONST_TSX];
+var GLOB_CODE = [...GLOB_JAVASCRIPT, ...GLOB_TYPESCRIPT, CONST_VUE];
+var GLOB_NODE = [
+  "**/*.{config,setup}.{js,cjs,mjs,ts,cts,mts}",
+  "**/{scripts,bin}/**/*.{js,cjs,mjs,ts,cts,mts}",
+  "**/{test,tests}/**/*.{js,cjs,mjs,ts,cts,mts}",
+  "**/cli.{js,cjs,mjs,ts,cts,mts}"
+];
+
+// src/configs/json.ts
+var jsonConfigs = defineConfig([
+  {
+    name: "@fast-china/json/strict",
+    files: [CONST_JSON],
+    extends: [eslintPluginJsonc.configs["flat/recommended-with-json"]]
+  },
+  {
+    name: "@fast-china/json/jsonc",
+    files: [CONST_JSONC],
+    extends: [eslintPluginJsonc.configs["flat/recommended-with-jsonc"]]
+  },
+  {
+    name: "@fast-china/json/json5",
+    files: [CONST_JSON5],
+    extends: [eslintPluginJsonc.configs["flat/recommended-with-json5"]]
+  },
+  {
+    name: "@fast-china/json/settings",
+    files: ["**/.vscode/settings.json"],
+    rules: {
+      // 允许注释
+      "jsonc/no-comments": "off"
+    }
+  }
+]);
+
+// src/define-rules.ts
+var defineRules = (rules) => rules;
 
 // src/rules/common.ts
 var commonRules = {
-  // 确保数组的回调函数（如 Array.prototype.map、Array.prototype.filter、Array.prototype.reduce 等）总是有一个返回值
+  // 要求数组回调在所有可到达分支返回值，避免 map/filter 等调用静默产生 undefined。
   "array-callback-return": "error",
-  // 强制使用块级作用域变量（let 或 const），避免使用函数作用域变量（var）
-  "block-scoped-var": "error",
-  // 禁止使用 alert、confirm 和 prompt 等浏览器弹出对话框
+  // 浏览器弹窗通常不适合生产代码，但保留为警告以兼容原型开发和已有项目。
   "no-alert": "warn",
-  // 禁止在 switch 语句的 case 或 default 子句中声明变量
+  // switch 的 case 不创建词法作用域；要求用花括号包裹声明，避免跨 case 冲突。
   "no-case-declarations": "error",
-  // 禁止使用多行字符串，即不允许使用反斜杠 \ 来连接多行字符串
+  // 禁止反斜杠续行字符串，优先使用可读性更好的模板字符串。
   "no-multi-str": "error",
-  // 禁止使用 with 语句
+  // with 会让标识符解析不可预测，并且在严格模式和 ESM 中不可用。
   "no-with": "error",
-  // 禁止使用 void 操作符
-  "no-void": "error",
-  // 禁止多个空行
-  "@stylistic/no-multiple-empty-lines": [
+  // 允许用 `void promise` 明确忽略 Promise，但禁止在普通表达式中滥用 void。
+  "no-void": [
     "error",
     {
-      // 最多允许1行
-      max: 1
+      allowAsStatement: true
     }
   ],
-  // import 排序
+  // 要求严格相等；保留 `value == null` 同时判断 null/undefined 的常用写法。
+  eqeqeq: ["error", "always", { null: "ignore" }],
+  // 幂运算统一使用 **，减少 Math.pow 嵌套并保持现代语法风格。
+  "prefer-exponentiation-operator": "error",
+  // 使用 Object.hasOwn，避免对象覆盖或缺少 hasOwnProperty 时产生异常。
+  "prefer-object-has-own": "error",
+  // [可自动修复] 声明间顺序交给 import-x；这里只排序同一 import 的成员。
   "sort-imports": [
     "warn",
     {
-      // 不忽略导入语句中模块名的大小写
       ignoreCase: false,
-      // 忽略导入声明的排序
       ignoreDeclarationSort: true,
-      // 不忽略导入成员的排序
       ignoreMemberSort: false,
-      // 成员语法排序顺序
       memberSyntaxSortOrder: ["none", "all", "multiple", "single"],
-      // 不允许分组导入
       allowSeparatedGroups: false
     }
-  ],
-  // 强制在数学运算中使用 ** 运算符代替 Math.pow()
-  "prefer-exponentiation-operator": "error"
+  ]
 };
 
 // src/rules/import.ts
-var importUseLodashUnifiedRules = {
-  // 限制某些模块导入
-  "no-restricted-imports": [
-    "error",
-    {
-      paths: [
-        { name: "lodash", message: "Use lodash-unified instead." },
-        { name: "lodash-es", message: "Use lodash-unified instead." }
-      ],
-      patterns: [
-        {
-          group: ["lodash/*", "lodash-es/*"],
-          message: "Use lodash-unified instead."
-        }
-      ]
-    }
-  ]
-};
 var importRules = {
-  // 确保所有的 import 语句位于文件的顶部，紧接在文件的开头部分，且在任何其他代码之前
+  // import 必须位于其他语句之前，避免模块依赖散落在执行逻辑中。
   "import-x/first": "error",
-  // 禁止在同一文件中出现重复的 import 语句
+  // 合并同一模块的重复 import，避免绑定分散或副作用被误读。
   "import-x/no-duplicates": "error",
-  // 导入模块排序风格
+  // [高影响][可自动修复] 按来源分组并排序；带副作用的裸 import 仅报告，人工移动前必须确认执行顺序。
   "import-x/order": [
     "error",
     {
-      // 导入模块分组
       groups: [
         // Node.js 内置模块
         "builtin",
-        // 第三方模块
+        // 第三方依赖
         "external",
-        // 项目内部模块
+        // 项目内部别名模块
         "internal",
-        // 父级目录中的模块
+        // 父级目录模块
         "parent",
-        // 具有相同父级的模块
+        // 同级目录模块
         "sibling",
-        // 当前目录的 index.js 或 index.ts 文件
+        // 当前目录入口模块
         "index",
+        // TypeScript import = require() 导入
         "object",
+        // TypeScript 类型导入
         "type",
+        // 无法识别分类的导入
         "unknown"
       ],
-      pathGroups: [
-        {
-          pattern: "@dcloudio/*",
-          group: "external",
-          position: "before"
-        },
-        {
-          pattern: "vue",
-          group: "external",
-          position: "before"
-        },
-        {
-          pattern: "@vue/**",
-          group: "external",
-          position: "before"
-        },
-        {
-          pattern: "element-plus",
-          group: "external",
-          position: "before"
-        },
-        {
-          pattern: "@element-plus/**",
-          group: "external",
-          position: "before"
-        },
-        {
-          pattern: "fast-element-plus",
-          group: "external",
-          position: "before"
-        },
-        {
-          pattern: "@fast-element-plus/**",
-          group: "external",
-          position: "before"
-        },
-        {
-          pattern: "@fast-china/**",
-          group: "external",
-          position: "before"
-        },
-        {
-          pattern: "lodash",
-          group: "external",
-          position: "before"
-        },
-        {
-          pattern: "lodash-es",
-          group: "external",
-          position: "before"
-        },
-        {
-          pattern: "lodash-unified",
-          group: "external",
-          position: "before"
-        }
-      ],
-      pathGroupsExcludedImportTypes: ["type"],
-      // 禁止不同组之间进行换行
-      "newlines-between": "never",
-      // 根据字母顺序对每个组内的顺序进行排序
+      // 不同 import 分组之间必须保留一个空行
+      "newlines-between": "always",
+      // 同一分组内按照模块路径字母升序排列
       alphabetize: {
         order: "asc",
         caseInsensitive: true
-      }
+      },
+      // 对没有赋值给变量的副作用导入进行排序检查
+      warnOnUnassignedImports: true
     }
   ],
-  // 关闭 - 禁用对无法解析的模块导入的检查
+  // [默认关闭] Vite/TypeScript 别名由项目解析器校验，避免共享配置绑定特定 resolver。
   "import-x/no-unresolved": "off",
-  // 关闭 - 禁用对命名空间导入（例如，import * as）的检查
+  // [默认关闭] 未配置 resolver 时，namespace 导出的静态分析容易产生误报。
   "import-x/namespace": "off",
-  // 关闭 - 禁用对默认导入的检查
+  // [默认关闭] 未配置 resolver 时，默认导出的静态分析容易产生误报。
   "import-x/default": "off",
-  // 关闭 - 禁用对以默认导出方式作为命名导入的检查
+  // [默认关闭] 不限制同时存在默认导出与相近命名导出的模块 API 风格。
   "import-x/no-named-as-default": "off",
-  // 关闭 - 禁用对将默认导出成员当作命名导入的检查
+  // [默认关闭] 不限制通过默认导入对象访问同名属性的项目 API 风格。
   "import-x/no-named-as-default-member": "off",
-  // 关闭 - 禁用对命名导入（即从模块中导入特定命名的内容）的检查
+  // [默认关闭] 未配置 resolver 时，命名导出的静态分析容易产生误报。
   "import-x/named": "off"
 };
 
 // src/rules/javascript.ts
 var javascriptRules = {
-  // JS/TS (http://eslint.cn/docs/rules)
-  // 强制使用 camelCase 命名风格
-  camelcase: [
-    "error",
-    {
-      // 允许对象属性使用非 camelCase 风格
-      properties: "never"
-    }
-  ],
-  // 禁止使用控制台
+  // 控制台调用在应用源码中需要人工确认；warn/error 仍可用于必要的诊断输出。
   "no-console": [
     "warn",
     {
-      // 允许除 warn/error 之外的其他 console.xx 方法
       allow: ["warn", "error"]
     }
   ],
-  // 禁止使用 debugger
-  "no-debugger": "warn",
-  // 禁止在条件语句中使用常量条件
+  // 防止调试断点进入发布代码并中断运行。
+  "no-debugger": "error",
+  // 禁止意外的恒定条件，但允许 while (true) 等有明确退出逻辑的循环。
   "no-constant-condition": [
     "error",
     {
-      // 允许在循环语句中使用常量条件
       checkLoops: false
     }
   ],
-  // 禁止使用某些特定的语法
-  "no-restricted-syntax": [
-    "error",
-    // 禁止使用标记语句（labeled statements）
-    "LabeledStatement",
-    // 禁止使用 with 语句
-    "WithStatement"
-  ],
-  // 禁止在 return 语句中使用 await
-  "@typescript-eslint/return-await": "error",
-  // 禁止使用 var 关键字，强制使用 let 或 const
+  // [高影响] 禁止标签语句；迁移包含多层循环 labeled break/continue 的代码时需先重构控制流。
+  "no-restricted-syntax": ["error", "LabeledStatement"],
+  // [高影响][可自动修复] 使用 let/const 替代 var；首次迁移需复核循环闭包和声明提升行为。
   "no-var": "error",
-  // 禁止使用空的块语句
+  // 禁止无说明的空代码块；允许用于“忽略失败”语义的空 catch。
   "no-empty": [
     "error",
     {
-      // 允许空的 catch 块
       allowEmptyCatch: true
     }
   ],
-  // 该规则禁止使用不规则或不标准的空白字符
+  // 拒绝肉眼难以识别、可能导致解析差异的非常规空白字符。
   "no-irregular-whitespace": "error",
-  // 禁止在函数或变量定义之前使用它们
-  "no-use-before-define": "warn",
-  // 强制使用 const 声明不被修改的变量
+  // 变量和类先声明后使用；函数声明允许提升。使用 warn 降低旧项目迁移阻力。
+  "no-use-before-define": [
+    "warn",
+    {
+      classes: true,
+      functions: false,
+      variables: true
+    }
+  ],
+  // [可自动修复] 能保持引用不变的变量优先使用 const；读取发生在赋值前时不做不可靠判断。
   "prefer-const": [
     "warn",
     {
-      // 在解构赋值时也推荐使用 const
       destructuring: "all",
-      // 允许在变量首次赋值前读取变量的值
       ignoreReadBeforeAssign: true
     }
   ],
-  // 强制使用箭头函数而非普通函数
+  // [高影响][可自动修复] 优先箭头回调；批量迁移后应复核 this/arguments 与函数名栈信息。
   "prefer-arrow-callback": [
     "error",
     {
-      // 不允许使用命名函数作为回调函数
       allowNamedFunctions: false,
-      // 允许在箭头函数中使用 this 绑定的上下文
       allowUnboundThis: true
     }
   ],
-  // 强制使用对象字面量的方法和属性简写语法
+  // [可自动修复] 属性和值同名时使用对象简写，带引号键名不强制改写。
   "object-shorthand": [
     "error",
     "always",
     {
-      // 不忽略构造函数中的属性简写
       ignoreConstructors: false,
-      // 强制避免在属性名中使用引号
       avoidQuotes: true
     }
   ],
-  // 强制使用 rest 参数代替 arguments 对象
+  // [高影响][可自动修复] 使用 ||=、&&=、??=；涉及 getter/Proxy 的代码应复核求值次数。
+  "logical-assignment-operators": ["error", "always", { enforceForIfStatements: true }],
+  // [可自动修复] 合并对象时优先展开语法，避免 Object.assign 的额外目标对象样板。
+  "prefer-object-spread": "error",
+  // 可变参数函数优先 rest 参数，避免依赖类数组 arguments；该规则只报告，不自动改写签名。
   "prefer-rest-params": "error",
-  // 强制使用展开运算符（...）代替 Function.prototype.apply
+  // 调用可迭代对象时优先 spread；该规则只报告，避免自动改变 apply 的 this 语义。
   "prefer-spread": "error",
-  // 强制使用模板字面量代替字符串连接
+  // [可自动修复] 字符串拼接优先模板字符串，便于阅读和多段插值。
   "prefer-template": "error",
-  // 禁止在同一作用域中重新声明变量
+  // 同一作用域禁止重复声明，避免后声明遮盖前声明。
   "no-redeclare": "error"
 };
 
 // src/rules/sort-package.ts
 var packageJsonSortRules = {
+  // [高影响][可自动修复] npm 的 files 清单按字母排序；数组顺序不改打包集合，但首次 diff 较大。
   "jsonc/sort-array-values": [
     "error",
     {
@@ -275,8 +252,10 @@ var packageJsonSortRules = {
       pathPattern: "^files$"
     }
   ],
+  // [高影响][可自动修复] 仅排序明确安全的 package.json 区域，不进入 exports 条件对象。
   "jsonc/sort-keys": [
     "error",
+    // 根字段按常见阅读顺序组织，减少不同项目之间的清单噪声。
     {
       order: [
         "name",
@@ -324,14 +303,12 @@ var packageJsonSortRules = {
       ],
       pathPattern: "^$"
     },
+    // 各类依赖映射按包名排序，方便发现重复或异常依赖。
     {
       order: { type: "asc" },
       pathPattern: "^(?:dev|peer|optional|bundled)?[Dd]ependencies(Meta)?$"
     },
-    {
-      order: ["types", "require", "import", "default"],
-      pathPattern: "^exports.*$"
-    },
+    // overrides/resolutions 只排序直接键；修改前仍应关注包管理器的模式匹配语义。
     {
       order: { type: "asc" },
       pathPattern: "^(?:resolutions|overrides|pnpm.overrides)$"
@@ -341,14 +318,17 @@ var packageJsonSortRules = {
 
 // src/rules/sort-tsconfig.ts
 var tsconfigJsonSortRules = {
-  // 允许注释
+  // tsconfig 是 JSONC，注释用于解释不直观的编译器取舍，必须保留。
   "jsonc/no-comments": "off",
+  // [高影响][可自动修复] 只调整顶层和 compilerOptions 的键顺序，不改写任何选项值或数组。
   "jsonc/sort-keys": [
     "error",
+    // 顶层按继承、选项、项目引用和文件范围的阅读顺序排列。
     {
       order: ["extends", "compilerOptions", "references", "files", "include", "exclude"],
       pathPattern: "^$"
     },
+    // compilerOptions 的顺序跟随 TypeScript 文档主题，便于检索和代码审查。
     {
       order: [
         /* Projects */
@@ -456,110 +436,76 @@ var tsconfigJsonSortRules = {
 
 // src/rules/typescript.ts
 var typescriptRules = {
-  // TS (https://typescript-eslint.io/rules)
-  // 要求在导出函数和类的公共方法上显式声明返回类型
-  "@typescript-eslint/explicit-module-boundary-types": [
+  // 使用 TypeScript 版本避免核心规则误判声明合并、类型和值的同名声明。
+  "@typescript-eslint/no-redeclare": "error",
+  // [高影响][可自动修复] 未使用符号视为错误；以下划线开头可显式表示参数或变量被有意忽略。
+  "@typescript-eslint/no-unused-vars": [
     "error",
     {
-      allowArgumentsExplicitlyTypedAsAny: true
+      args: "after-used",
+      argsIgnorePattern: "^_",
+      caughtErrors: "all",
+      caughtErrorsIgnorePattern: "^_",
+      ignoreRestSiblings: true,
+      varsIgnorePattern: "^_"
     }
   ],
-  // 要求在 TypeScript 函数和方法中显式地指定返回类型
-  "@typescript-eslint/explicit-function-return-type": "error",
-  // 禁止在同一作用域中重新声明 TypeScript 变量
-  "@typescript-eslint/no-redeclare": "error",
-  // 禁止定义未使用的变量，方法参数排除。
-  "@typescript-eslint/no-unused-vars": ["error", { args: "none" }],
-  // 允许使用自定义TypeScript模块和命名空间
+  // [默认关闭] 声明文件、全局扩展和部分 SDK 仍需要 namespace。
   "@typescript-eslint/no-namespace": "off",
-  // 允许使用 any 类型
-  "@typescript-eslint/no-explicit-any": "off",
-  // 禁止在 TypeScript 文件中使用 require 函数进行模块导入
+  // any 会绕过类型检查，但在迁移和第三方边界中有合理用途，因此只警告。
+  "@typescript-eslint/no-explicit-any": "warn",
+  // [高影响] 默认要求 ESM import；CommonJS、动态加载或工具链互操作代码可能需要按文件关闭。
   "@typescript-eslint/no-require-imports": "error",
-  // 禁止定义空函数
-  "@typescript-eslint/no-empty-function": ["error", { allow: [] }],
-  // 禁止无用的表达式
+  // 使用 TS 版本识别类型断言等语法；允许常见的短路和三元表达式调用模式。
   "@typescript-eslint/no-unused-expressions": [
     "error",
     {
-      // 允许短路操作符（&& 和 ||）中的无副作用表达式
       allowShortCircuit: true,
-      // 允许三元操作符中的无副作用表达式
       allowTernary: true
     }
   ],
-  // 禁止在 TypeScript 代码中对类型已经可以被推断的变量或参数进行显式的类型注解
+  // [可自动修复] 删除可由 TypeScript 明确推断的原始值类型标注，减少重复信息。
   "@typescript-eslint/no-inferrable-types": "error",
-  // 禁止使用后缀运算符的非空断言(!)
-  "@typescript-eslint/no-non-null-assertion": "error",
-  // 禁止在可选链(?)后使用非空断言(!)
+  // 非空断言可能隐藏空值缺陷；以警告提示逐步消除而不阻断迁移。
+  "@typescript-eslint/no-non-null-assertion": "warn",
+  // 可选链之后再做非空断言逻辑矛盾，通常表示边界条件设计有误。
   "@typescript-eslint/no-non-null-asserted-optional-chain": "error",
-  // 禁止在代码中使用 @ts-ignore 注释
-  "@typescript-eslint/ban-ts-comment": ["error", { "ts-ignore": false }],
-  // 一致地使用 TypeScript 类型导入
+  // [高影响][可自动修复] 类型依赖改用内联 type import；需复核仅靠 import 触发的模块副作用。
   "@typescript-eslint/consistent-type-imports": [
     "error",
     {
-      // 允许使用类型注解
-      disallowTypeAnnotations: false
+      disallowTypeAnnotations: false,
+      fixStyle: "inline-type-imports",
+      prefer: "type-imports"
     }
   ]
 };
 
 // src/rules/vue.ts
 var vueRules = {
-  // vue (https://eslint.vuejs.org/rules)
-  // 允许使用 v-html
-  "vue/no-v-html": "off",
-  // 禁用所有 props 必填时，必须提供默认值
+  // [安全关注] v-html 可能引入 XSS；保留 warn 以兼容经过净化的富文本场景。
+  "vue/no-v-html": "warn",
+  // [默认关闭] TypeScript 类型 props 和 required 声明已能表达可选性，不强制每个可选 prop 提供默认值。
   "vue/require-default-prop": "off",
-  // 强制组件中必须使用 emits 选项声明事件
+  // [高影响] 组件必须声明对外事件；旧组件迁移时会暴露未建模的公共事件 API。
   "vue/require-explicit-emits": "error",
-  // 禁用组件名称必须是多单词
+  // [默认关闭] 允许 App、Layout 等约定俗成的单词组件名。
   "vue/multi-word-component-names": "off",
-  // 关闭 - 强制从 vue 中导入 Vue相关 API
-  "vue/prefer-import-from-vue": "off",
-  // 强制 HTML 属性使用 camelCase 风格
-  "vue/attribute-hyphenation": [
-    "error",
-    "never",
-    {
-      ignore: [
-        // 忽略 Element-Plus 加载文案"element-loading-text"
-        "element-loading-text",
-        // 忽略 UniApp view 标签的一些属性
-        "hover-class",
-        "hover-stop-propagation",
-        "hover-start-time",
-        "hover-stay-time"
-      ]
-    }
-  ],
-  // 禁止重复的字段名
+  // 优先从 vue 入口导入由 Vue 重新导出的 API，避免依赖内部包边界。
+  "vue/prefer-import-from-vue": "warn",
+  // 防止 props、data、computed、methods 等组件命名空间出现冲突。
   "vue/no-dupe-keys": "error",
-  // 禁止直接修改 props 的值
+  // [高影响] 禁止组件直接修改 props，要求通过事件或本地状态维持单向数据流。
   "vue/no-mutating-props": "error",
-  // 禁止使用 Vue.js 内置的保留组件名称（如 transition、keep-alive 等）作为自定义组件名称
+  // 避免自定义组件名与 Vue 内置组件冲突。
   "vue/no-reserved-component-names": "error",
-  // 禁止在自定义组件上使用 v-text 或 v-html 指令
-  "vue/no-v-text-v-html-on-component": "off",
-  // 防止<script setup>使用的变量<template>被标记为未使用，此规则仅在启用该no-unused-vars规则时有效。
-  // "vue/script-setup-uses-vars": "error",
-  // 强制自定义事件名称使用 camelCase 风格命名
+  // [安全关注] 禁止在组件节点上使用 v-text/v-html，避免覆盖组件内容和模糊数据边界。
+  "vue/no-v-text-v-html-on-component": "error",
+  // 统一模板与脚本中的自定义事件名称为 camelCase。
   "vue/custom-event-name-casing": ["error", "camelCase"],
-  // 强制每个 Vue 文件中只包含一个 Vue 组件
+  // [默认关闭] 允许在一个 SFC 中声明仅供当前文件使用的小型辅助组件。
   "vue/one-component-per-file": "off",
-  // 闭合标签换行风格
-  "vue/html-closing-bracket-newline": [
-    "error",
-    {
-      // 强制要求当 HTML 元素跨多行时，闭合标签必须出现在新的一行上
-      multiline: "always",
-      // 强制要求当 HTML 元素只有一行时，闭合标签应与开始标签在同一行上
-      singleline: "never"
-    }
-  ],
-  // 强制 Vue 模板中 HTML 元素的属性按照指定的顺序排列
+  // [高影响][可自动修复] 统一模板属性分组；首次启用可能产生大量仅排序的模板差异。
   "vue/attributes-order": [
     "error",
     {
@@ -568,410 +514,273 @@ var vueRules = {
   ]
 };
 
-// src/configs/common.ts
-var commonConfigs = defineConfig([
+// src/configs/sort-package.ts
+var packageJsonSortConfigs = defineConfig([
+  {
+    name: "@fast-china/sort/package",
+    files: ["**/package.json"],
+    rules: packageJsonSortRules
+  }
+]);
+var tsconfigJsonSortConfigs = defineConfig([
+  {
+    name: "@fast-china/sort/tsconfig",
+    files: CONST_TSCONFIG,
+    rules: tsconfigJsonSortRules
+  }
+]);
+var createCommonConfigs = (files = GLOB_CODE) => defineConfig([
   {
     name: "@fast-china/common",
+    files: [...files],
+    linterOptions: {
+      reportUnusedDisableDirectives: "error"
+    },
     rules: commonRules
   }
 ]);
-
-// src/configs/ignores.ts
-import { defineConfig as defineConfig2 } from "eslint/config";
-import eslintConfigFlatGitignore from "eslint-config-flat-gitignore";
-
-// src/constants/index.ts
-var CONST_JS = "**/*.?([cm])js";
-var CONST_JSX = "**/*.?([cm])jsx";
-var CONST_TS = "**/*.?([cm])ts";
-var CONST_TSX = "**/*.?([cm])tsx";
-var CONST_DTS = "**/*.d.ts";
-var CONST_JSON = "**/*.json";
-var CONST_JSONC = "**/*.jsonc";
-var CONST_JSON5 = "**/*.json5";
-var CONST_MD = "**/*.md";
-var CONST_VUE = "**/*.vue";
-var CONST_YAML = "**/*.y?(a)ml";
-var CONST_NODE_MODULES = "**/node_modules";
-var CONST_DIST = "**/dist";
-var CONST_LOCKFILE = ["**/package-lock.json", "**/yarn.lock", "**/pnpm-lock.yaml", "**/bun.lockb"];
-var CONST_PUBLIC = "**/public";
-var CONST_TSCONFIG = ["**/tsconfig.json", "**/tsconfig.*.json"];
-
-// src/configs/ignores.ts
-var ignoresConfigs = defineConfig2([
+var commonConfigs = createCommonConfigs();
+var createEnvironmentConfigs = (environment = "browser", files = GLOB_CODE) => {
+  const runtimeGlobals = {
+    ...environment !== "node" ? globals.browser : {},
+    ...environment !== "browser" ? globals.node : {}
+  };
+  const nodeToolingFiles = GLOB_NODE.flatMap((nodeGlob) => files.map((fileGlob) => [nodeGlob, fileGlob]));
+  return defineConfig([
+    {
+      name: `@fast-china/globals/${environment}`,
+      files: [...files],
+      languageOptions: {
+        globals: runtimeGlobals
+      }
+    },
+    {
+      name: "@fast-china/globals/node-tooling",
+      files: nodeToolingFiles,
+      languageOptions: {
+        globals: globals.node
+      },
+      rules: {
+        "no-console": "off"
+      }
+    }
+  ]);
+};
+var browserConfigs = createEnvironmentConfigs("browser");
+var nodeConfigs = createEnvironmentConfigs("node");
+var universalConfigs = createEnvironmentConfigs("universal");
+var globalIgnoresConfigs = defineConfig([
   {
     name: "@fast-china/ignores/global",
     ignores: [
       CONST_NODE_MODULES,
       CONST_DIST,
-      CONST_PUBLIC,
       ...CONST_LOCKFILE,
-      "**/output",
-      "**/coverage",
-      "**/temp",
-      "**/fixtures",
-      "**/.vitepress/cache",
-      "**/.nuxt",
-      "**/.vercel",
-      "**/.changeset",
-      "**/.idea",
-      "**/.output",
-      "**/.vite-inspect",
-      "**/.nitro",
+      "**/{coverage,output,temp}/**",
+      "**/{.nuxt,.output,.vercel,.nitro}/**",
+      "**/{.vitepress/cache,.vite-inspect}/**",
       "**/CHANGELOG*.md",
       "**/*.min.*",
       "**/LICENSE*",
-      "**/__snapshots__",
+      "**/__snapshots__/**",
       "**/auto-import?(s).d.ts",
       "**/components.d.ts"
     ]
-  },
+  }
+]);
+var gitignoreConfigs = defineConfig([
   {
     name: "@fast-china/ignores/git",
     ...eslintConfigFlatGitignore({ strict: false })
   }
 ]);
-
-// src/configs/import.ts
-import { defineConfig as defineConfig3 } from "eslint/config";
-import eslintPluginImportX from "eslint-plugin-import-x";
-var importConfigs = defineConfig3([
+var ignoresConfigs = defineConfig([...globalIgnoresConfigs, ...gitignoreConfigs]);
+var createImportConfigs = (files = GLOB_CODE) => defineConfig([
   {
     name: "@fast-china/import",
-    // 继承某些已有的规则
-    extends: [eslintPluginImportX.flatConfigs.recommended, eslintPluginImportX.flatConfigs.typescript],
-    settings: {
-      // 确保 ESLint 和 eslint-plugin-import 能够正确解析项目中的所有相关文件类型
-      "import-x/resolver": {
-        node: {
-          alwaysTryTypes: true,
-          extensions: [CONST_JS, CONST_JSX, CONST_TS, CONST_TSX, CONST_DTS]
-        },
-        typescript: {
-          alwaysTryTypes: true,
-          project: ["./tsconfig.json", "./tsconfig.*.json", "./packages/*/tsconfig.json", "./packages/*/tsconfig.*.json"]
-        }
-      }
-    },
-    rules: {
-      ...importRules,
-      ...importUseLodashUnifiedRules
-    }
+    files: [...files],
+    extends: [eslintPluginImportX.flatConfigs.recommended],
+    rules: importRules
   }
 ]);
-
-// src/configs/javascript.ts
-import eslint from "@eslint/js";
-import { defineConfig as defineConfig4 } from "eslint/config";
-import globals from "globals";
-var javascriptConfigs = defineConfig4([
+var importConfigs = createImportConfigs();
+var javascriptConfigs = defineConfig([
   {
     name: "@fast-china/javascript",
+    files: [...GLOB_JAVASCRIPT],
     // 继承某些已有的规则
     extends: [eslint.configs.recommended],
     languageOptions: {
-      //  允许使用最新的 ECMAScript 语法特性
+      // 允许使用最新的 ECMAScript 语法特性
       ecmaVersion: "latest",
-      globals: {
-        ...globals.browser,
-        ...globals.es2022,
-        ...globals.node
-      },
       parserOptions: {
         ecmaFeatures: {
-          // 允许使用 JSX 语法，适用于 Vue 组件中的 JSX 代码。
+          // 允许在 JavaScript 文件中使用 JSX。
           jsx: true
-        },
-        sourceType: "module"
+        }
       }
     },
     rules: javascriptRules
-  },
-  {
-    name: "@fast-china/javascript/md/js",
-    files: ["**/*.md/*.js"],
-    rules: {
-      // 使用使用控制台
-      "no-console": "off",
-      // 关闭 - 禁止使用未声明的变量，除非/*global *\/注释中提到
-      "no-undef": "off",
-      // 关闭 - 禁用对无法解析的模块导入的检查
-      "import/no-unresolved": "off",
-      // 关闭 - 禁止在文件中重复导入相同的模块
-      "import/no-duplicates": "off"
-    }
-  },
-  {
-    name: "@fast-china/javascript/script",
-    files: ["**/scripts/*", "**/cli.*"],
-    rules: {
-      // 使用使用控制台
-      "no-console": "off"
-    }
-  }
-]);
-
-// src/configs/json.ts
-import { defineConfig as defineConfig5 } from "eslint/config";
-import eslintPluginJsonc from "eslint-plugin-jsonc";
-import * as jsoncEslintParser from "jsonc-eslint-parser";
-var jsonConfigs = defineConfig5([
-  {
-    name: "@fast-china/json",
-    files: [CONST_JSON, CONST_JSONC, CONST_JSON5],
-    // 继承某些已有的规则
-    extends: [
-      ...eslintPluginJsonc.configs["flat/recommended-with-json"],
-      ...eslintPluginJsonc.configs["flat/recommended-with-jsonc"],
-      ...eslintPluginJsonc.configs["flat/recommended-with-json5"]
-    ],
-    languageOptions: {
-      parser: jsoncEslintParser
-    }
-  },
-  {
-    name: "@fast-china/json/settings",
-    files: ["**/.vscode/settings.json"],
-    rules: {
-      // 允许注释
-      "jsonc/no-comments": "off"
-    }
   }
 ]);
-
-// src/configs/markdown.ts
-import eslintMarkdown from "@eslint/markdown";
-import { defineConfig as defineConfig6 } from "eslint/config";
-var markdownConfigs = defineConfig6([
+var markdownConfigs = defineConfig([
   {
     name: "@fast-china/markdown",
     files: [CONST_MD],
-    // 继承某些已有的规则
-    extends: [...eslintMarkdown.configs["recommended"]],
-    plugins: {
-      markdown: eslintMarkdown
-    }
+    extends: [eslintMarkdown.configs.recommended]
   }
 ]);
-
-// src/configs/prettier.ts
-import { defineConfig as defineConfig7 } from "eslint/config";
-import eslintConfigPrettierFlat from "eslint-config-prettier/flat";
-import eslintPluginPrettier from "eslint-plugin-prettier";
-import eslintPluginPrettierRecommended from "eslint-plugin-prettier/recommended";
-var prettierConfigs = defineConfig7([
+var prettierConfigs = defineConfig([
   {
-    name: "@fast-china/prettier",
-    // 继承某些已有的规则
-    extends: [eslintConfigPrettierFlat, eslintPluginPrettierRecommended],
-    plugins: {
-      prettier: eslintPluginPrettier
-    },
-    rules: {
-      // 确保 Prettier 错误被 ESLint 捕获
-      "prettier/prettier": "error"
-    }
+    ...eslintConfigPrettierFlat,
+    name: "@fast-china/prettier"
   }
 ]);
-
-// src/configs/regexp.ts
-import { defineConfig as defineConfig8 } from "eslint/config";
-import eslintPluginRegexp from "eslint-plugin-regexp";
-var regexpConfigs = defineConfig8([
+var createRegexpConfigs = (files = GLOB_CODE) => defineConfig([
   {
     name: "@fast-china/regexp",
-    ...eslintPluginRegexp.configs["flat/recommended"]
-  }
-]);
-
-// src/configs/sort-package.ts
-import { defineConfig as defineConfig9 } from "eslint/config";
-var packageJsonSortConfigs = defineConfig9([
-  {
-    name: "@fast-china/sort/package",
-    files: ["**/package.json"],
-    rules: packageJsonSortRules
-  }
-]);
-
-// src/configs/sort-tsconfig.ts
-import { defineConfig as defineConfig10 } from "eslint/config";
-var tsconfigJsonSortConfigs = defineConfig10([
-  {
-    name: "@fast-china/sort/tsconfig",
-    files: CONST_TSCONFIG,
-    rules: tsconfigJsonSortRules
+    files: [...files],
+    extends: [eslintPluginRegexp.configs["flat/recommended"]]
   }
 ]);
-
-// src/configs/typescript.ts
-import { defineConfig as defineConfig11 } from "eslint/config";
-import tseslint from "typescript-eslint";
-var typescriptCoreConfigs = defineConfig11([
+var regexpConfigs = createRegexpConfigs();
+var createTypeScriptCoreConfigs = ({ typeChecked = false } = {}) => defineConfig([
   {
-    name: "@fast-china/typescript",
-    files: [CONST_TS, CONST_TSX],
-    // 继承某些已有的规则
-    extends: [tseslint.configs.recommended],
+    name: typeChecked ? "@fast-china/typescript/type-checked" : "@fast-china/typescript",
+    files: [...GLOB_TYPESCRIPT],
+    extends: [
+      ...typeChecked ? tseslint2.configs.recommendedTypeChecked : tseslint2.configs.recommended,
+      ...typeChecked ? tseslint2.configs.stylisticTypeChecked : tseslint2.configs.stylistic
+    ],
     languageOptions: {
-      //  允许使用最新的 ECMAScript 语法特性
       ecmaVersion: "latest",
-      parser: tseslint.parser,
       parserOptions: {
-        ecmaFeatures: {
-          // 允许使用 TSX 语法，适用于 Vue 组件中的 TSX 代码。
-          tsx: true
-        },
-        sourceType: "module"
+        ...typeChecked ? { projectService: true } : {}
       }
     },
     rules: typescriptRules
   }
 ]);
-var typescriptConfigs = defineConfig11([
-  ...typescriptCoreConfigs,
+var typescriptCoreConfigs = createTypeScriptCoreConfigs();
+var createTypeScriptConfigs = (options = {}) => defineConfig([
+  ...createTypeScriptCoreConfigs(options),
   {
-    name: "@fast-china/typescript/dts",
+    name: "@fast-china/typescript/declarations",
     files: [CONST_DTS],
     rules: {
-      // 关闭 - 一致地使用 TypeScript 类型导入
-      "@typescript-eslint/consistent-type-imports": "off"
-    }
-  },
-  {
-    name: "@fast-china/typescript/vite",
-    files: ["**/vite.config.*"],
-    rules: {
-      // 关闭 - 要求在 TypeScript 函数和方法中显式地指定返回类型
-      "@typescript-eslint/explicit-function-return-type": "off"
-    }
-  },
-  {
-    name: "@fast-china/typescript/md/js",
-    files: ["**/*.md/*.ts"],
-    rules: {
-      // 允许定义未使用的变量
+      "@typescript-eslint/consistent-type-imports": "off",
       "@typescript-eslint/no-unused-vars": "off"
     }
   }
 ]);
-
-// src/configs/vue.ts
-import { defineConfig as defineConfig12 } from "eslint/config";
-import eslintPluginVue from "eslint-plugin-vue";
-import tseslint2 from "typescript-eslint";
-import vueEslintParser from "vue-eslint-parser";
-
-// src/env/index.ts
-import { getPackageInfoSync } from "local-pkg";
-var getVueVersion = () => {
-  const pkg = getPackageInfoSync("vue", { paths: [process.cwd()] });
-  if (pkg && typeof pkg.version === "string" && !Number.isNaN(+pkg.version[0])) {
-    return +pkg.version[0];
-  }
-  return 3;
+var typescriptConfigs = createTypeScriptConfigs();
+var typescriptTypeCheckedConfigs = createTypeScriptConfigs({ typeChecked: true });
+var withoutFileScope = (config) => {
+  const { files: _files, ...unscopedConfig } = config;
+  return unscopedConfig;
 };
-var isVue3 = getVueVersion() === 3;
-
-// src/configs/vue.ts
-var vueConfigs = defineConfig12([
-  {
-    name: "@fast-china/vue/ts",
-    files: [CONST_VUE],
-    // 继承某些已有的规则
-    extends: [...typescriptCoreConfigs]
-  },
-  {
-    name: "@fast-china/vue",
-    files: [CONST_VUE],
-    // 继承某些已有的规则
-    extends: [...isVue3 ? eslintPluginVue.configs["flat/recommended"] : eslintPluginVue.configs["flat/vue2-recommended"]],
-    languageOptions: {
-      //  允许使用最新的 ECMAScript 语法特性
-      ecmaVersion: "latest",
-      // 允许 ESLint 处理 Vue 文件中的模板和脚本
-      parser: vueEslintParser,
-      parserOptions: {
-        // 允许在 Vue 文件中的脚本部分使用 TypeScript 语法
-        parser: tseslint2.parser,
-        // parser: "@typescript-eslint/parser",
-        // 指定额外的文件扩展名，告诉解析器 .vue 文件也需要处理
-        extraFileExtensions: [".vue"],
-        // 允许使用 JSX/TSX 语法，适用于 Vue 组件中的 JSX/TSX 代码。
-        ecmaFeatures: {
-          jsx: true,
-          tsx: true
-        },
-        sourceType: "module"
-      }
-    },
-    plugins: {
-      "@typescript-eslint": tseslint2.plugin,
-      vue: eslintPluginVue
-    },
-    rules: {
-      ...vueRules,
-      // 关闭 - 禁止使用未声明的变量，以避免在 .vue 文件中出现关于未定义变量的警告，这在 Vue 单文件组件中可能不适用或会导致不必要的警告
-      "no-undef": "off",
-      // 关闭 - 要求在 TypeScript 函数和方法中显式地指定返回类型
-      "@typescript-eslint/explicit-function-return-type": "off"
-    }
-  },
-  {
-    name: "@fast-china/reactivity",
-    languageOptions: {
-      globals: {
-        $: "readonly",
-        $$: "readonly",
-        $computed: "readonly",
-        $customRef: "readonly",
-        $ref: "readonly",
-        $shallowRef: "readonly",
-        $toRef: "readonly"
+var createVueConfigs = ({ typeChecked = false, version = 3 } = {}) => {
+  const typeScriptConfigs = [
+    ...typeChecked ? tseslint2.configs.recommendedTypeChecked : tseslint2.configs.recommended,
+    ...typeChecked ? tseslint2.configs.stylisticTypeChecked : tseslint2.configs.stylistic
+  ].map((config) => withoutFileScope(config));
+  const vueRecommendedConfigs = version === 3 ? eslintPluginVue.configs["flat/recommended"] : eslintPluginVue.configs["flat/vue2-recommended"];
+  return defineConfig([
+    {
+      name: version === 3 ? "@fast-china/vue3" : "@fast-china/vue2",
+      files: [CONST_VUE],
+      extends: [eslint.configs.recommended, ...typeScriptConfigs, ...vueRecommendedConfigs],
+      languageOptions: {
+        ecmaVersion: "latest",
+        parser: vueEslintParser,
+        parserOptions: {
+          parser: tseslint2.parser,
+          extraFileExtensions: [".vue"],
+          ecmaFeatures: {
+            jsx: true
+          },
+          sourceType: "module",
+          ...typeChecked ? { projectService: true } : {}
+        }
+      },
+      rules: {
+        ...typescriptRules,
+        ...vueRules
       }
     }
+  ]);
+};
+var vueConfigs = createVueConfigs();
+var vue2Configs = createVueConfigs({ version: 2 });
+var vueTypeCheckedConfigs = createVueConfigs({ typeChecked: true });
+
+// src/factory.ts
+var defaultOptions = Object.freeze({
+  environment: "browser",
+  gitignore: true,
+  imports: true,
+  json: true,
+  markdown: true,
+  prettier: true,
+  regexp: true,
+  typescript: true,
+  vue: 3
+});
+var createConfig = (options = {}) => {
+  const resolvedOptions = { ...defaultOptions, ...options };
+  const typeScriptEnabled = resolvedOptions.typescript !== false;
+  const typeScriptOptions = typeof resolvedOptions.typescript === "object" ? resolvedOptions.typescript : {};
+  const vueEnabled = resolvedOptions.vue !== false;
+  let vueOptions = {
+    typeChecked: typeScriptOptions.typeChecked,
+    version: 3
+  };
+  if (typeof resolvedOptions.vue === "number") {
+    vueOptions = { ...vueOptions, version: resolvedOptions.vue };
+  } else if (typeof resolvedOptions.vue === "object") {
+    vueOptions = { ...vueOptions, ...resolvedOptions.vue };
   }
-]);
+  const codeFiles = [...GLOB_JAVASCRIPT, ...typeScriptEnabled ? GLOB_TYPESCRIPT : [], ...vueEnabled ? [CONST_VUE] : []];
+  return defineConfig([
+    ...globalIgnoresConfigs,
+    ...resolvedOptions.gitignore ? gitignoreConfigs : [],
+    ...resolvedOptions.ignores?.length ? [
+      {
+        name: "@fast-china/ignores/custom",
+        ignores: resolvedOptions.ignores
+      }
+    ] : [],
+    ...createEnvironmentConfigs(resolvedOptions.environment, codeFiles),
+    ...createCommonConfigs(codeFiles),
+    ...javascriptConfigs,
+    ...resolvedOptions.imports ? createImportConfigs(codeFiles) : [],
+    ...resolvedOptions.regexp ? createRegexpConfigs(codeFiles) : [],
+    ...typeScriptEnabled ? createTypeScriptConfigs(typeScriptOptions) : [],
+    ...resolvedOptions.json ? [...jsonConfigs, ...packageJsonSortConfigs, ...tsconfigJsonSortConfigs] : [],
+    ...vueEnabled ? createVueConfigs(vueOptions) : [],
+    ...resolvedOptions.markdown ? markdownConfigs : [],
+    ...resolvedOptions.prettier ? prettierConfigs : []
+  ]);
+};
 
 // src/index.ts
-var PresetJavascriptConfigs = [...ignoresConfigs, ...commonConfigs, ...javascriptConfigs, ...importConfigs, ...regexpConfigs];
+var PresetJavascriptConfigs = createConfig({
+  json: false,
+  markdown: false,
+  typescript: false,
+  vue: false
+});
 var PresetJsonConfigs = [...jsonConfigs, ...packageJsonSortConfigs, ...tsconfigJsonSortConfigs];
-var PresetBasicConfigs = [...PresetJavascriptConfigs, ...typescriptConfigs, ...PresetJsonConfigs];
-var index_default = [...PresetBasicConfigs, ...vueConfigs, ...markdownConfigs, ...prettierConfigs];
-export {
-  CONST_DIST,
-  CONST_DTS,
-  CONST_JS,
-  CONST_JSON,
-  CONST_JSON5,
-  CONST_JSONC,
-  CONST_JSX,
-  CONST_LOCKFILE,
-  CONST_MD,
-  CONST_NODE_MODULES,
-  CONST_PUBLIC,
-  CONST_TS,
-  CONST_TSCONFIG,
-  CONST_TSX,
-  CONST_VUE,
-  CONST_YAML,
-  PresetBasicConfigs,
-  PresetJavascriptConfigs,
-  PresetJsonConfigs,
-  commonConfigs,
-  index_default as default,
-  ignoresConfigs,
-  importConfigs,
-  javascriptConfigs,
-  jsonConfigs,
-  markdownConfigs,
-  packageJsonSortConfigs,
-  prettierConfigs,
-  regexpConfigs,
-  tsconfigJsonSortConfigs,
-  typescriptConfigs,
-  typescriptCoreConfigs,
-  vueConfigs
-};
+var PresetTypescriptConfigs = createConfig({
+  json: false,
+  markdown: false,
+  vue: false
+});
+var PresetTypeScriptConfigs = PresetTypescriptConfigs;
+var PresetBasicConfigs = createConfig({ markdown: false, vue: false });
+var PresetVueConfigs = createConfig();
+var src_default = PresetVueConfigs;
+
+export { CONST_DIST, CONST_DTS, CONST_JS, CONST_JSON, CONST_JSON5, CONST_JSONC, CONST_JSX, CONST_LOCKFILE, CONST_MD, CONST_NODE_MODULES, CONST_PUBLIC, CONST_TS, CONST_TSCONFIG, CONST_TSX, CONST_VUE, CONST_YAML, GLOB_CODE, GLOB_JAVASCRIPT, GLOB_NODE, GLOB_TYPESCRIPT, PresetBasicConfigs, PresetJavascriptConfigs, PresetJsonConfigs, PresetTypeScriptConfigs, PresetTypescriptConfigs, PresetVueConfigs, browserConfigs, commonConfigs, createCommonConfigs, createConfig, createEnvironmentConfigs, createImportConfigs, createRegexpConfigs, createTypeScriptConfigs, createTypeScriptCoreConfigs, createVueConfigs, src_default as default, defaultOptions, defineRules, gitignoreConfigs, globalIgnoresConfigs, ignoresConfigs, importConfigs, javascriptConfigs, jsonConfigs, markdownConfigs, nodeConfigs, packageJsonSortConfigs, prettierConfigs, regexpConfigs, tsconfigJsonSortConfigs, typescriptConfigs, typescriptCoreConfigs, typescriptTypeCheckedConfigs, universalConfigs, vue2Configs, vueConfigs, vueTypeCheckedConfigs };
+//# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map