@fast-china/eslint-config 2.1.9 → 2.1.10

package/README.zh.md

@@ -1,16 +1,20 @@
-<p align="left">
-	<strong>简体中文</strong> | <a href="./README.md">English</a>
-</p>
+**简体中文** | [English](./README.md)
 
 <p align="center">
-	<img src="./Fast.png" alt="logo" width="160" />
+	<img src="./Fast.png" width="128" alt="Fast.ESLint.Config Logo" />
 </p>
 
-# @fast-china/eslint-config
+<h1 align="center">Fast.ESLint.Config</h1>
+
+<p align="center">
+	<a href="https://www.npmjs.com/package/@fast-china/eslint-config"><img src="https://img.shields.io/npm/v/@fast-china/eslint-config?logo=npm" alt="npm version" /></a>
+	<a href="https://www.npmjs.com/package/@fast-china/eslint-config"><img src="https://img.shields.io/npm/dm/@fast-china/eslint-config" alt="npm downloads" /></a>
+	<a href="./LICENSE"><img src="https://img.shields.io/npm/l/@fast-china/eslint-config" alt="License" /></a>
+</p>
 
-面向 Vue 3、UniApp、SDK、Node.js、React、Angular、TypeScript 与 JavaScript 项目的实用型 ESLint Flat Config。
+面向 Vue 3、uni-app、TypeScript 与 Node.js 的 ESLint Flat Config，提供按需框架配置与规则类型。
 
-规则取舍遵循：先尊重社区通用写法并保持代码简洁、易读，再依次考虑真实 Bug / 类型安全、代码一致性和 Fast 系列项目偏好。不会为了满足 ESLint 强制改写语义正常、普遍使用的代码。
+**[使用文档](http://docs.fastdotnet.cn/zh-CN/frontend/eslint-config/) · [官方网站](http://fastdotnet.com)**
 
 ## 特性
 
@@ -28,11 +32,15 @@
 - ESLint `^10.0.0`
 - TypeScript `^6.0.0`
 
+## 安装
+
 ```sh
 pnpm add -D eslint typescript @fast-china/eslint-config
 ```
 
-## Vue 3
+## 快速开始
+
+在 Vue 3 项目中创建 `eslint.config.mjs`：
 
 ```js
 import { vueConfig } from "@fast-china/eslint-config";
@@ -42,139 +50,43 @@ export default defineConfig([
 	...vueConfig,
 	{
 		name: "project/custom",
-		rules: {
-			"no-console": "warn",
-		},
+		rules: {},
 	},
 ]);
 ```
 
-该入口处理 JavaScript、类型感知 TypeScript、Vue SFC，以及 Vue 项目常用的独立 `.jsx`/`.tsx` 组件文件；Vue JSX/TSX 继续检查显式 emits、重复键、只读 props、响应性丢失和保留组件名，但不会套用模板专属的 kebab-case、模板属性排序或 `v-text`/`v-html` 规则。配置同时包含 JSON、Import、RegExp、`.gitignore` 和 Prettier 兼容规则，但不包含任何 UniApp 能力。
-
-## UniApp
-
-```js
-import { uniAppConfig } from "@fast-china/eslint-config";
-import { defineConfig } from "eslint/config";
-
-export default defineConfig([
-	...uniAppConfig,
-	{
-		name: "project/custom",
-		ignores: ["src/generated/**"],
-		rules: {
-			"no-console": "warn",
-		},
-	},
-]);
-```
-
-UniApp 入口在 Vue 完整能力之外增加 `.nvue`、`uni`、`uniCloud`、页面 API、条件编译平台 globals、`unpackage` 忽略，以及 `pages.json`、`manifest.json` 注释适配。
-
-ESLint 不执行 `#ifdef`/`#endif`，因此只能识别平台对象，不能验证对象是否位于正确的平台分支。当前不处理需要专用解析器的 `.uvue` 与 `.uts`。
-
-## 工厂与项目覆写
-
-根入口只提供含义明确的具名配置与工厂。项目需要选择运行环境或追加覆写时使用对应工厂：
-
-```js
-import { createVueProjectConfigs, defineRules } from "@fast-china/eslint-config";
-import { defineConfig } from "eslint/config";
-
-export default defineConfig([
-	...createVueProjectConfigs({ environment: "universal" }),
-	{
-		name: "project/custom",
-		ignores: ["public/vendor/**"],
-		languageOptions: {
-			globals: {
-				__APP_VERSION__: "readonly",
-			},
-		},
-		rules: defineRules({
-			"no-console": "warn",
-		}),
-	},
-]);
+```sh
+pnpm exec eslint .
 ```
 
-可用工厂：
-
-- `createVueProjectConfigs(options, ...overrides)`
-- `createUniAppProjectConfigs(options, ...overrides)`
-- `createBaseConfigs(options)`：不绑定前端框架，适用于 Node.js、SDK 及其他显式组合场景
-
-`environment` 可为 `"browser"`、`"node"` 或 `"universal"`，默认是 `"browser"`。配置文件、脚本、测试和 CLI 文件始终单独获得 Node.js globals。
-
-后置 Flat Config 拥有最高优先级。`defineRules()` 不修改传入对象，只提供精确规则类型检查。
-
-## TypeScript 策略
+类型感知检查的源码应属于项目 tsconfig 范围。Vue 配置不包含 uni-app 平台能力。
 
-类型感知文件必须属于 Project Service 可发现的 `tsconfig.json`。
+## 常见用法
 
-- `explicit-module-boundary-types: "error"`：`.ts`、`.mts`、`.cts` 导出函数及导出类的公共边界必须显式声明参数和返回类型。
-- `.tsx` 默认关闭模块边界类型强制：组件 Props 继续接受 TypeScript 检查，但不要求补写可稳定推断的 JSX 返回类型。
-- `explicit-function-return-type: "off"`：内部函数、局部处理函数和内联回调使用 TypeScript 推断。
-- `no-inferrable-types` 不删除参数和属性上的显式类型。
-- Vue/NVue SFC 与独立 TSX 组件不强制模块边界和函数返回类型，以保留常见简洁写法。
-- `no-floating-promises` 关闭；是否等待 Promise 由业务顺序和异常语义决定。
-- `no-void: "error"`：不使用 `void promise` 或其他 `void` 表达式规避检查。
-- `require-await: "error"`：没有真实 `await` 的函数应删除 `async`，避免改变返回值和异常语义。
-- `no-misused-promises`、`await-thenable`、unsafe 类型规则及精选的高置信度类型规则保持为错误。
-- 标准非空断言可用；矛盾、重复或无效的断言仍由专项规则检查。
-- 数字和布尔值可直接用于模板字符串；运行时防御性条件不会因类型看似多余而报错。
-
-## JavaScript、Import 与 Vue 策略
-
-- `no-empty` 允许完全空的 `catch`，其他空代码块仍报错。
-- `camelcase: ["error", { properties: "never" }]`：变量和类型使用 camelCase，外部协议对象属性保持原名。
-- `no-eval`、`no-implied-eval`、`no-new-func`、`no-debugger` 等真实风险规则为错误。
-- `import-x/first`、`import-x/no-duplicates` 与 `import-x/order` 均为错误；声明顺序支持自动修复。
-- 保留 UniApp、Vue、React、Angular、Vite、Element Plus、Fast 和 Lodash 等常用 pathGroups，`@/**` 归入 internal，类型导入不参与 pathGroups 匹配。
-- `sort-imports` 只检查同一 import 声明 `{}` 内的成员顺序，不接管声明之间的排序。
-- `import-x/style-imports-last` 要求样式文件形成最后一个连续分组，同时不改变样式组内部顺序。
-- Vue SFC 使用官方 `flat/recommended`；显式 emits、重复键、只读 props、响应性丢失和保留组件名等脚本语义规则也应用于 Vue JSX/TSX。
-- kebab-case 属性、模板属性顺序和组件上的 `v-text`/`v-html` 仅检查 `.vue/.nvue` 模板；JSX 属性继续遵循 JavaScript 的 camelCase 约定。`no-v-html` 保持警告。
-
-## React 与 Angular
+uni-app 使用独立入口，不与 Vue 完整配置叠加：
 
 ```js
-import { createBaseConfigs } from "@fast-china/eslint-config";
-import { createReactConfigs } from "@fast-china/eslint-config/configs";
+import { uniAppConfig } from "@fast-china/eslint-config";
 import { defineConfig } from "eslint/config";
 
 export default defineConfig([
-	...createBaseConfigs(),
-	...createReactConfigs(),
+	...uniAppConfig,
 	{
 		name: "project/custom",
-		rules: { "no-console": "warn" },
+		rules: {},
 	},
 ]);
 ```
 
-Angular 同理组合 `createAngularConfigs()`。基础配置不会加载 Vue 或 UniApp。
-
-## 可选能力与清单排序
-
-Markdown 和 Lodash 导入策略需要显式组合：
+不绑定框架的 Node.js 项目：
 
 ```js
 import { createBaseConfigs } from "@fast-china/eslint-config";
-import { createMarkdownConfigs } from "@fast-china/eslint-config/configs";
-import { defineConfig } from "eslint/config";
 
-export default defineConfig([
-	...createBaseConfigs({ environment: "node" }),
-	...createMarkdownConfigs(),
-	{
-		name: "project/custom",
-		rules: { "no-console": "warn" },
-	},
-]);
+export default createBaseConfigs({ environment: "node" });
 ```
 
-`createBaseConfigs()`、`vueConfig` 和 `uniAppConfig` 都默认启用 `package.json` 与 `tsconfig*.json` 排序。`package.json` 排序不会进入顺序具有运行时语义的条件 `exports` 对象。
+将项目自定义配置放在共享配置之后；`rules: {}` 留给项目按需填写。需要调整运行环境时，可使用配置工厂。Fast 生态的本地规则副本继续按各仓库 AGENTS.md 同步，不因示例而改成安装配置包。
 
 ## 公共入口
 
@@ -189,8 +101,8 @@ Prettier 不作为 ESLint 规则运行。默认配置只加载 `eslint-config-pr
 
 ## 文档
 
-- [完整规则手册](./docs/rules/index.zh.md)
-- [默认规则与风险指南](./docs/rules-risk.zh.md)
+- [完整规则手册](http://docs.fastdotnet.cn/zh-CN/frontend/eslint-config/rules/)
+- [默认规则与风险指南](http://docs.fastdotnet.cn/zh-CN/frontend/eslint-config/rules-risk)
 - [工程质量审查报告](./docs/engineering-audit.zh.md)
 - [更新日志](./CHANGELOG.md)
 
@@ -203,3 +115,17 @@ pnpm install --frozen-lockfile
 pnpm typegen
 pnpm check
 ```
+
+## 贡献与安全
+
+[贡献指南](./CONTRIBUTING.md) · [安全策略](./SECURITY.md)
+
+## 版权、许可证与使用声明
+
+版权所有 © 2018-Now 小方。本项目依据 [Apache License 2.0](./LICENSE) 开源；在遵守许可证的前提下，可以使用、修改和分发本软件，包括商业使用。
+
+再分发时，应按许可证要求提供许可证副本、对修改的文件作出显著说明，并保留适用的版权和归属声明；包含需要保留的 NOTICE 信息时一并处理。本说明不替代正式许可证，也不额外要求在产品界面展示作者或项目标识。
+
+使用者应就自身使用、二次开发、部署、数据处理及运营活动遵守适用法律和第三方合法权益，自行取得依法需要的授权。上述内容为合规提醒，不构成附加许可条件。
+
+除适用法律另有规定或另有书面约定外，本软件按“原样”提供；保证排除与责任限制以许可证第 7、8 条为准。提供本项目不代表原作者为使用者的二次开发和运营活动背书，也不当然承担其对第三方作出的合同承诺。本说明不排除依法不得排除的责任。

package/dist/configs/ignores.d.mts

@@ -1,7 +1,7 @@
 import { defineConfig } from "eslint/config";
 //#region src/configs/ignores.d.ts
 /**
- * 默认忽略依赖、构建结果、缓存、生成文件和包管理器锁文件。
+ * 默认忽略依赖、构建结果、缓存、生成文件、AI 技能内容和工具锁文件。
  *
  * @remarks
  * 不忽略 `src`、`public`、测试夹具或普通 Markdown 文档，避免共享配置静默漏检

package/dist/configs/ignores.mjs

@@ -3,7 +3,7 @@ import { defineConfig, globalIgnores } from "eslint/config";
 import eslintConfigFlatGitignore from "eslint-config-flat-gitignore";
 //#region src/configs/ignores.ts
 /**
-* 默认忽略依赖、构建结果、缓存、生成文件和包管理器锁文件。
+* 默认忽略依赖、构建结果、缓存、生成文件、AI 技能内容和工具锁文件。
 *
 * @remarks
 * 不忽略 `src`、`public`、测试夹具或普通 Markdown 文档，避免共享配置静默漏检
@@ -14,6 +14,7 @@ const DEFAULT_IGNORE_PATTERNS = Object.freeze([
 	"**/{dist,build,coverage,output,temp,tmp}/**",
 	"**/{.cache,.nuxt,.output,.vercel,.nitro}/**",
 	"**/{.vitepress/cache,.vite-inspect}/**",
+	"**/.agents/**",
 	"**/__snapshots__/**",
 	"**/*.min.*",
 	"**/auto-import?(s).d.ts",

package/dist/configs/ignores.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"ignores.mjs","names":[],"sources":["../../src/configs/ignores.ts"],"sourcesContent":["import { defineConfig, globalIgnores } from \"eslint/config\";\nimport eslintConfigFlatGitignore from \"eslint-config-flat-gitignore\";\nimport { GLOBS_LOCKFILES } from \"../constants\";\n\n/**\n * 默认忽略依赖、构建结果、缓存、生成文件和包管理器锁文件。\n *\n * @remarks\n * 不忽略 `src`、`public`、测试夹具或普通 Markdown 文档，避免共享配置静默漏检\n * 应由项目维护的文件。\n */\nexport const DEFAULT_IGNORE_PATTERNS = Object.freeze([\n\t\"**/{.pnpm-store,node_modules}/**\",\n\t\"**/{dist,build,coverage,output,temp,tmp}/**\",\n\t\"**/{.cache,.nuxt,.output,.vercel,.nitro}/**\",\n\t\"**/{.vitepress/cache,.vite-inspect}/**\",\n\t\"**/__snapshots__/**\",\n\t\"**/*.min.*\",\n\t\"**/auto-import?(s).d.ts\",\n\t\"**/components.d.ts\",\n\t...GLOBS_LOCKFILES,\n]);\n\n/**\n * 创建全局忽略配置，并在默认集合之后追加项目自定义模式。\n *\n * @param additionalPatterns - 追加到 {@link DEFAULT_IGNORE_PATTERNS} 之后的 ESLint 全局忽略模式。\n * @returns 包含单个命名全局忽略片段的 Flat Config 数组。\n */\nexport const createGlobalIgnores = (additionalPatterns: readonly string[] = []): ReturnType<typeof defineConfig> =>\n\tdefineConfig([globalIgnores([...DEFAULT_IGNORE_PATTERNS, ...additionalPatterns], \"@fast-china/ignores/global\")]);\n\n/**\n * 创建读取项目 `.gitignore` 的全局忽略配置。\n *\n * @remarks\n * `.gitignore` 的查找位置由 `eslint-config-flat-gitignore` 根据 ESLint 当前工作目录确定。\n * 未找到文件时不会抛错；该片段也不会替代 {@link createGlobalIgnores} 的内置模式。\n *\n * @returns 包含 `.gitignore` 转换结果的 Flat Config 数组。\n */\nexport const createGitignoreConfigs = (): ReturnType<typeof defineConfig> =>\n\tdefineConfig([\n\t\t{\n\t\t\t...eslintConfigFlatGitignore({ strict: false }),\n\t\t\tname: \"@fast-china/ignores/git\",\n\t\t},\n\t]);\n"],"mappings":";;;;;;;;;;;AAWA,MAAa,0BAA0B,OAAO,OAAO;CACpD;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA,GAAG;AACJ,CAAC;;;;;;;AAQD,MAAa,uBAAuB,qBAAwC,CAAC,MAC5E,aAAa,CAAC,cAAc,CAAC,GAAG,yBAAyB,GAAG,kBAAkB,GAAG,4BAA4B,CAAC,CAAC;;;;;;;;;;AAWhH,MAAa,+BACZ,aAAa,CACZ;CACC,GAAG,0BAA0B,EAAE,QAAQ,MAAM,CAAC;CAC9C,MAAM;AACP,CACD,CAAC"}
+{"version":3,"file":"ignores.mjs","names":[],"sources":["../../src/configs/ignores.ts"],"sourcesContent":["import { defineConfig, globalIgnores } from \"eslint/config\";\nimport eslintConfigFlatGitignore from \"eslint-config-flat-gitignore\";\nimport { GLOBS_LOCKFILES } from \"../constants\";\n\n/**\n * 默认忽略依赖、构建结果、缓存、生成文件、AI 技能内容和工具锁文件。\n *\n * @remarks\n * 不忽略 `src`、`public`、测试夹具或普通 Markdown 文档，避免共享配置静默漏检\n * 应由项目维护的文件。\n */\nexport const DEFAULT_IGNORE_PATTERNS = Object.freeze([\n\t\"**/{.pnpm-store,node_modules}/**\",\n\t\"**/{dist,build,coverage,output,temp,tmp}/**\",\n\t\"**/{.cache,.nuxt,.output,.vercel,.nitro}/**\",\n\t\"**/{.vitepress/cache,.vite-inspect}/**\",\n\t\"**/.agents/**\",\n\t\"**/__snapshots__/**\",\n\t\"**/*.min.*\",\n\t\"**/auto-import?(s).d.ts\",\n\t\"**/components.d.ts\",\n\t...GLOBS_LOCKFILES,\n]);\n\n/**\n * 创建全局忽略配置，并在默认集合之后追加项目自定义模式。\n *\n * @param additionalPatterns - 追加到 {@link DEFAULT_IGNORE_PATTERNS} 之后的 ESLint 全局忽略模式。\n * @returns 包含单个命名全局忽略片段的 Flat Config 数组。\n */\nexport const createGlobalIgnores = (additionalPatterns: readonly string[] = []): ReturnType<typeof defineConfig> =>\n\tdefineConfig([globalIgnores([...DEFAULT_IGNORE_PATTERNS, ...additionalPatterns], \"@fast-china/ignores/global\")]);\n\n/**\n * 创建读取项目 `.gitignore` 的全局忽略配置。\n *\n * @remarks\n * `.gitignore` 的查找位置由 `eslint-config-flat-gitignore` 根据 ESLint 当前工作目录确定。\n * 未找到文件时不会抛错；该片段也不会替代 {@link createGlobalIgnores} 的内置模式。\n *\n * @returns 包含 `.gitignore` 转换结果的 Flat Config 数组。\n */\nexport const createGitignoreConfigs = (): ReturnType<typeof defineConfig> =>\n\tdefineConfig([\n\t\t{\n\t\t\t...eslintConfigFlatGitignore({ strict: false }),\n\t\t\tname: \"@fast-china/ignores/git\",\n\t\t},\n\t]);\n"],"mappings":";;;;;;;;;;;AAWA,MAAa,0BAA0B,OAAO,OAAO;CACpD;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA,GAAG;AACJ,CAAC;;;;;;;AAQD,MAAa,uBAAuB,qBAAwC,CAAC,MAC5E,aAAa,CAAC,cAAc,CAAC,GAAG,yBAAyB,GAAG,kBAAkB,GAAG,4BAA4B,CAAC,CAAC;;;;;;;;;;AAWhH,MAAa,+BACZ,aAAa,CACZ;CACC,GAAG,0BAA0B,EAAE,QAAQ,MAAM,CAAC;CAC9C,MAAM;AACP,CACD,CAAC"}

package/dist/constants/index.d.mts

@@ -73,7 +73,7 @@ export declare const GLOBS_CODE: readonly ["**/*.{js,cjs,mjs,jsx}", "**/*.{ts,ct
 export declare const GLOBS_NODE_TOOLING: readonly ["**/*.{config,setup}.{js,cjs,mjs,jsx,ts,cts,mts,tsx}", "**/{scripts,bin}/**/*.{js,cjs,mjs,jsx,ts,cts,mts,tsx}", "**/{test,tests}/**/*.{js,cjs,mjs,jsx,ts,cts,mts,tsx}", "**/*.{test,spec}.{js,cjs,mjs,jsx,ts,cts,mts,tsx}", "**/cli.{js,cjs,mjs,ts,cts,mts}"];
 /** TypeScript 配置文件；它们使用 JSONC 语法并允许注释。 */
 export declare const GLOBS_TSCONFIG: readonly ["**/tsconfig.json", "**/tsconfig.*.json"];
-/** 不应交给 JSON/Markdown 解析器处理的包管理器锁文件。 */
-export declare const GLOBS_LOCKFILES: readonly ["**/package-lock.json", "**/yarn.lock", "**/pnpm-lock.yaml", "**/bun.lock", "**/bun.lockb", "**/deno.lock"];
+/** 不应交给 JSON/Markdown 解析器处理的包管理器及开发工具锁文件。 */
+export declare const GLOBS_LOCKFILES: readonly ["**/package-lock.json", "**/yarn.lock", "**/pnpm-lock.yaml", "**/bun.lock", "**/bun.lockb", "**/deno.lock", "**/skills-lock.json"];
 //#endregion
 //# sourceMappingURL=index.d.mts.map

package/dist/constants/index.mjs

@@ -83,14 +83,15 @@ const GLOBS_NODE_TOOLING = [
 ];
 /** TypeScript 配置文件；它们使用 JSONC 语法并允许注释。 */
 const GLOBS_TSCONFIG = ["**/tsconfig.json", "**/tsconfig.*.json"];
-/** 不应交给 JSON/Markdown 解析器处理的包管理器锁文件。 */
+/** 不应交给 JSON/Markdown 解析器处理的包管理器及开发工具锁文件。 */
 const GLOBS_LOCKFILES = [
 	"**/package-lock.json",
 	"**/yarn.lock",
 	"**/pnpm-lock.yaml",
 	"**/bun.lock",
 	"**/bun.lockb",
-	"**/deno.lock"
+	"**/deno.lock",
+	"**/skills-lock.json"
 ];
 //#endregion
 export { GLOBS_CODE, GLOBS_JAVASCRIPT, GLOBS_LOCKFILES, GLOBS_NODE_TOOLING, GLOBS_TSCONFIG, GLOBS_TYPESCRIPT, GLOBS_UNIAPP_JSON, GLOB_ANGULAR_TEMPLATE, GLOB_ANGULAR_TYPESCRIPT, GLOB_JSON, GLOB_JSON5, GLOB_JSONC, GLOB_JSX, GLOB_MARKDOWN, GLOB_NVUE, GLOB_TSX, GLOB_VUE, UNIAPP_CONDITIONAL_GLOBALS, UNIAPP_GLOBALS };

package/dist/constants/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../../src/constants/index.ts"],"sourcesContent":["/**\n * `@fast-china/eslint-config/constants` 公开的文件匹配常量。\n *\n * @remarks\n * 所有模式均使用 ESLint Flat Config 的 glob 语义，可直接用于配置的 `files` 或\n * `ignores` 字段。数组常量使用只读元组类型，调用方组合时应复制而非原地修改。\n *\n * @packageDocumentation\n */\n\n/** JavaScript 与 JSX 文件；扩展名列表与 Node.js ESM/CJS 约定保持一致。 */\nexport const GLOBS_JAVASCRIPT = [\"**/*.{js,cjs,mjs,jsx}\"] as const;\n\n/** TypeScript 与 TSX 文件；包含 TypeScript 的 ESM/CJS 专用扩展名。 */\nexport const GLOBS_TYPESCRIPT = [\"**/*.{ts,cts,mts,tsx}\"] as const;\n\n/** 独立 JSX 文件；用于为 Vue 等 JSX 运行时叠加组件脚本语义规则。 */\nexport const GLOB_JSX = \"**/*.jsx\";\n\n/** 独立 TSX 文件；用于在完整 TypeScript 范围内叠加 UI 组件专项规则。 */\nexport const GLOB_TSX = \"**/*.tsx\";\n\n/** Vue 3 单文件组件。 */\nexport const GLOB_VUE = \"**/*.vue\";\n\n/** UniApp 原生渲染页面使用的 Vue 单文件组件。 */\nexport const GLOB_NVUE = \"**/*.nvue\";\n\n/** Angular 组件、指令、服务等框架源码；Angular CLI 项目以 `.ts` 为标准源码扩展名。 */\nexport const GLOB_ANGULAR_TYPESCRIPT = \"**/*.ts\";\n\n/** Angular 外部模板；内联模板由 Angular 处理器提取后复用同一模板配置。 */\nexport const GLOB_ANGULAR_TEMPLATE = \"**/*.html\";\n\n/** 严格 JSON 文件。 */\nexport const GLOB_JSON = \"**/*.json\";\n/** 允许注释与尾随逗号的 JSONC 文件。 */\nexport const GLOB_JSONC = \"**/*.jsonc\";\n/** 使用 JSON5 语法的配置文件。 */\nexport const GLOB_JSON5 = \"**/*.json5\";\n\n/** Markdown 文档。 */\nexport const GLOB_MARKDOWN = \"**/*.md\";\n\n/** UniApp 项目允许使用注释的应用清单和页面路由配置。 */\nexport const GLOBS_UNIAPP_JSON = [\"**/manifest.json\", \"**/pages.json\"] as const;\n\n/** UniApp 跨端运行时提供的公共全局变量。 */\nexport const UNIAPP_GLOBALS = {\n\tgetApp: \"readonly\",\n\tgetCurrentPages: \"readonly\",\n\tgetCurrentSubNVue: \"readonly\",\n\tuni: \"readonly\",\n\tuniCloud: \"readonly\",\n} as const;\n\n/**\n * UniApp 条件编译分支中可能由目标平台注入的全局变量。\n *\n * @remarks\n * ESLint 不执行 `#ifdef`/`#endif` 预处理，因此启用 UniApp 后统一声明这些对象。它们只解决\n * 静态 `no-undef`，不会验证当前发行目标是否真的提供对应 API。\n */\nexport const UNIAPP_CONDITIONAL_GLOBALS = {\n\tdd: \"readonly\",\n\tjd: \"readonly\",\n\tks: \"readonly\",\n\tmy: \"readonly\",\n\tplus: \"readonly\",\n\tqh: \"readonly\",\n\tqq: \"readonly\",\n\tswan: \"readonly\",\n\ttt: \"readonly\",\n\tweex: \"readonly\",\n\twx: \"readonly\",\n} as const;\n\n/** 默认由 JavaScript、TypeScript 和 Vue 规则处理的全部代码文件。 */\nexport const GLOBS_CODE = [...GLOBS_JAVASCRIPT, ...GLOBS_TYPESCRIPT, GLOB_VUE] as const;\n\n/**\n * 应额外获得 Node.js 全局变量的工程文件。\n *\n * 这些模式还会与当前已启用的 JavaScript/TypeScript 文件模式做 AND 匹配，\n * 因而关闭 TypeScript 后不会意外让 ESLint 接管 `.ts` 文件。\n */\nexport const GLOBS_NODE_TOOLING = [\n\t\"**/*.{config,setup}.{js,cjs,mjs,jsx,ts,cts,mts,tsx}\",\n\t\"**/{scripts,bin}/**/*.{js,cjs,mjs,jsx,ts,cts,mts,tsx}\",\n\t\"**/{test,tests}/**/*.{js,cjs,mjs,jsx,ts,cts,mts,tsx}\",\n\t\"**/*.{test,spec}.{js,cjs,mjs,jsx,ts,cts,mts,tsx}\",\n\t\"**/cli.{js,cjs,mjs,ts,cts,mts}\",\n] as const;\n\n/** TypeScript 配置文件；它们使用 JSONC 语法并允许注释。 */\nexport const GLOBS_TSCONFIG = [\"**/tsconfig.json\", \"**/tsconfig.*.json\"] as const;\n\n/** 不应交给 JSON/Markdown 解析器处理的包管理器锁文件。 */\nexport const GLOBS_LOCKFILES = [\"**/package-lock.json\", \"**/yarn.lock\", \"**/pnpm-lock.yaml\", \"**/bun.lock\", \"**/bun.lockb\", \"**/deno.lock\"] as const;\n"],"mappings":";;;;;;;;;;;AAWA,MAAa,mBAAmB,CAAC,uBAAuB;;AAGxD,MAAa,mBAAmB,CAAC,uBAAuB;;AAGxD,MAAa,WAAW;;AAGxB,MAAa,WAAW;;AAGxB,MAAa,WAAW;;AAGxB,MAAa,YAAY;;AAGzB,MAAa,0BAA0B;;AAGvC,MAAa,wBAAwB;;AAGrC,MAAa,YAAY;;AAEzB,MAAa,aAAa;;AAE1B,MAAa,aAAa;;AAG1B,MAAa,gBAAgB;;AAG7B,MAAa,oBAAoB,CAAC,oBAAoB,eAAe;;AAGrE,MAAa,iBAAiB;CAC7B,QAAQ;CACR,iBAAiB;CACjB,mBAAmB;CACnB,KAAK;CACL,UAAU;AACX;;;;;;;;AASA,MAAa,6BAA6B;CACzC,IAAI;CACJ,IAAI;CACJ,IAAI;CACJ,IAAI;CACJ,MAAM;CACN,IAAI;CACJ,IAAI;CACJ,MAAM;CACN,IAAI;CACJ,MAAM;CACN,IAAI;AACL;;AAGA,MAAa,aAAa;CAAC,GAAG;CAAkB,GAAG;CAAkB;AAAQ;;;;;;;AAQ7E,MAAa,qBAAqB;CACjC;CACA;CACA;CACA;CACA;AACD;;AAGA,MAAa,iBAAiB,CAAC,oBAAoB,oBAAoB;;AAGvE,MAAa,kBAAkB;CAAC;CAAwB;CAAgB;CAAqB;CAAe;CAAgB;AAAc"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../../src/constants/index.ts"],"sourcesContent":["/**\n * `@fast-china/eslint-config/constants` 公开的文件匹配常量。\n *\n * @remarks\n * 所有模式均使用 ESLint Flat Config 的 glob 语义，可直接用于配置的 `files` 或\n * `ignores` 字段。数组常量使用只读元组类型，调用方组合时应复制而非原地修改。\n *\n * @packageDocumentation\n */\n\n/** JavaScript 与 JSX 文件；扩展名列表与 Node.js ESM/CJS 约定保持一致。 */\nexport const GLOBS_JAVASCRIPT = [\"**/*.{js,cjs,mjs,jsx}\"] as const;\n\n/** TypeScript 与 TSX 文件；包含 TypeScript 的 ESM/CJS 专用扩展名。 */\nexport const GLOBS_TYPESCRIPT = [\"**/*.{ts,cts,mts,tsx}\"] as const;\n\n/** 独立 JSX 文件；用于为 Vue 等 JSX 运行时叠加组件脚本语义规则。 */\nexport const GLOB_JSX = \"**/*.jsx\";\n\n/** 独立 TSX 文件；用于在完整 TypeScript 范围内叠加 UI 组件专项规则。 */\nexport const GLOB_TSX = \"**/*.tsx\";\n\n/** Vue 3 单文件组件。 */\nexport const GLOB_VUE = \"**/*.vue\";\n\n/** UniApp 原生渲染页面使用的 Vue 单文件组件。 */\nexport const GLOB_NVUE = \"**/*.nvue\";\n\n/** Angular 组件、指令、服务等框架源码；Angular CLI 项目以 `.ts` 为标准源码扩展名。 */\nexport const GLOB_ANGULAR_TYPESCRIPT = \"**/*.ts\";\n\n/** Angular 外部模板；内联模板由 Angular 处理器提取后复用同一模板配置。 */\nexport const GLOB_ANGULAR_TEMPLATE = \"**/*.html\";\n\n/** 严格 JSON 文件。 */\nexport const GLOB_JSON = \"**/*.json\";\n/** 允许注释与尾随逗号的 JSONC 文件。 */\nexport const GLOB_JSONC = \"**/*.jsonc\";\n/** 使用 JSON5 语法的配置文件。 */\nexport const GLOB_JSON5 = \"**/*.json5\";\n\n/** Markdown 文档。 */\nexport const GLOB_MARKDOWN = \"**/*.md\";\n\n/** UniApp 项目允许使用注释的应用清单和页面路由配置。 */\nexport const GLOBS_UNIAPP_JSON = [\"**/manifest.json\", \"**/pages.json\"] as const;\n\n/** UniApp 跨端运行时提供的公共全局变量。 */\nexport const UNIAPP_GLOBALS = {\n\tgetApp: \"readonly\",\n\tgetCurrentPages: \"readonly\",\n\tgetCurrentSubNVue: \"readonly\",\n\tuni: \"readonly\",\n\tuniCloud: \"readonly\",\n} as const;\n\n/**\n * UniApp 条件编译分支中可能由目标平台注入的全局变量。\n *\n * @remarks\n * ESLint 不执行 `#ifdef`/`#endif` 预处理，因此启用 UniApp 后统一声明这些对象。它们只解决\n * 静态 `no-undef`，不会验证当前发行目标是否真的提供对应 API。\n */\nexport const UNIAPP_CONDITIONAL_GLOBALS = {\n\tdd: \"readonly\",\n\tjd: \"readonly\",\n\tks: \"readonly\",\n\tmy: \"readonly\",\n\tplus: \"readonly\",\n\tqh: \"readonly\",\n\tqq: \"readonly\",\n\tswan: \"readonly\",\n\ttt: \"readonly\",\n\tweex: \"readonly\",\n\twx: \"readonly\",\n} as const;\n\n/** 默认由 JavaScript、TypeScript 和 Vue 规则处理的全部代码文件。 */\nexport const GLOBS_CODE = [...GLOBS_JAVASCRIPT, ...GLOBS_TYPESCRIPT, GLOB_VUE] as const;\n\n/**\n * 应额外获得 Node.js 全局变量的工程文件。\n *\n * 这些模式还会与当前已启用的 JavaScript/TypeScript 文件模式做 AND 匹配，\n * 因而关闭 TypeScript 后不会意外让 ESLint 接管 `.ts` 文件。\n */\nexport const GLOBS_NODE_TOOLING = [\n\t\"**/*.{config,setup}.{js,cjs,mjs,jsx,ts,cts,mts,tsx}\",\n\t\"**/{scripts,bin}/**/*.{js,cjs,mjs,jsx,ts,cts,mts,tsx}\",\n\t\"**/{test,tests}/**/*.{js,cjs,mjs,jsx,ts,cts,mts,tsx}\",\n\t\"**/*.{test,spec}.{js,cjs,mjs,jsx,ts,cts,mts,tsx}\",\n\t\"**/cli.{js,cjs,mjs,ts,cts,mts}\",\n] as const;\n\n/** TypeScript 配置文件；它们使用 JSONC 语法并允许注释。 */\nexport const GLOBS_TSCONFIG = [\"**/tsconfig.json\", \"**/tsconfig.*.json\"] as const;\n\n/** 不应交给 JSON/Markdown 解析器处理的包管理器及开发工具锁文件。 */\nexport const GLOBS_LOCKFILES = [\n\t\"**/package-lock.json\",\n\t\"**/yarn.lock\",\n\t\"**/pnpm-lock.yaml\",\n\t\"**/bun.lock\",\n\t\"**/bun.lockb\",\n\t\"**/deno.lock\",\n\t\"**/skills-lock.json\",\n] as const;\n"],"mappings":";;;;;;;;;;;AAWA,MAAa,mBAAmB,CAAC,uBAAuB;;AAGxD,MAAa,mBAAmB,CAAC,uBAAuB;;AAGxD,MAAa,WAAW;;AAGxB,MAAa,WAAW;;AAGxB,MAAa,WAAW;;AAGxB,MAAa,YAAY;;AAGzB,MAAa,0BAA0B;;AAGvC,MAAa,wBAAwB;;AAGrC,MAAa,YAAY;;AAEzB,MAAa,aAAa;;AAE1B,MAAa,aAAa;;AAG1B,MAAa,gBAAgB;;AAG7B,MAAa,oBAAoB,CAAC,oBAAoB,eAAe;;AAGrE,MAAa,iBAAiB;CAC7B,QAAQ;CACR,iBAAiB;CACjB,mBAAmB;CACnB,KAAK;CACL,UAAU;AACX;;;;;;;;AASA,MAAa,6BAA6B;CACzC,IAAI;CACJ,IAAI;CACJ,IAAI;CACJ,IAAI;CACJ,MAAM;CACN,IAAI;CACJ,IAAI;CACJ,MAAM;CACN,IAAI;CACJ,MAAM;CACN,IAAI;AACL;;AAGA,MAAa,aAAa;CAAC,GAAG;CAAkB,GAAG;CAAkB;AAAQ;;;;;;;AAQ7E,MAAa,qBAAqB;CACjC;CACA;CACA;CACA;CACA;AACD;;AAGA,MAAa,iBAAiB,CAAC,oBAAoB,oBAAoB;;AAGvE,MAAa,kBAAkB;CAC9B;CACA;CACA;CACA;CACA;CACA;CACA;AACD"}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@fast-china/eslint-config",
-	"version": "2.1.9",
+	"version": "2.1.10",
 	"description": "Practical, typed ESLint Flat Config for Vue 3, UniApp, React, Angular, Vite, TypeScript, JavaScript, and Node.js.",
 	"type": "module",
 	"keywords": [
@@ -18,7 +18,7 @@
 		"vue3"
 	],
 	"license": "Apache-2.0",
-	"homepage": "https://fastdotnet.com",
+	"homepage": "http://fastdotnet.com",
 	"bugs": {
 		"url": "https://gitee.com/FastDotnet/fast.eslint.config/issues"
 	},
@@ -35,8 +35,7 @@
 		"README.md",
 		"README.zh.md",
 		"SECURITY.md",
-		"dist",
-		"docs"
+		"dist"
 	],
 	"main": "./dist/index.mjs",
 	"module": "./dist/index.mjs",
@@ -83,7 +82,7 @@
 		"format:check": "prettier --check .",
 		"test": "pnpm run build && pnpm run test:types && pnpm run test:runtime && pnpm run test:package",
 		"test:types": "tsc --noEmit --project tests/tsconfig.json",
-		"test:runtime": "node --test tests/config.test.mjs",
+		"test:runtime": "node --test tests/config.test.mjs tests/tool-ignores.test.mjs",
 		"test:package": "node --test tests/package.test.mjs",
 		"check": "pnpm run typecheck && pnpm run docs:rules:check && pnpm run test && pnpm run lint && pnpm run format:check",
 		"prepack": "pnpm run check"

package/docs/engineering-audit.zh.md

@@ -1,78 +0,0 @@
-# 工程质量审查报告
-
-审查日期：2026-09-14
-
-审查对象：`@fast-china/eslint-config` 2.1.9 工作区
-
-## 结论
-
-当前配置已从“固定 Vue + UniApp 根预置”调整为根入口的两个独立具名完整配置，并将规则基线收敛到社区通用写法、简洁性和高置信度问题。普通 Vue 项目不再继承 UniApp globals、`.nvue` 解析、清单适配或 `unpackage` 忽略。
-
-TypeScript 不再叠加完整 strict/stylistic 类型预置，而是在 `recommendedTypeChecked` 之上明确选择高价值规则。`.ts`/`.tsx` 导出边界继续按 SDK 公共 API 严格检查，内部实现则使用类型推断。
-
-## 公共入口
-
-- 根入口：命名导出 `vueConfig`、`uniAppConfig`、三个项目工厂、`defineRules()`、`ProjectConfigOptions` 和 `RuleOptions`，不提供默认导出或框架子入口。
-- `./configs`：React、Angular、Markdown、Lodash、清单排序及低层配置片段；完整配置默认包含清单排序。
-- `./constants`、`./rules`：glob/globals 和原始规则记录。
-
-本轮不保留旧 `fastConfig()`、根默认导出或 `FastConfigOptions` 兼容层。
-
-## 当前规则模型
-
-- JavaScript、TypeScript、Import 和 RegExp 只有一套共享规则，SDK 与应用项目不设严格度档位。
-- 完全空的 `catch` 被允许；其他空块继续报错。
-- `no-void` 和 `require-await` 保持错误：不使用 `void` 规避检查，也不保留没有 `await`、会改变函数语义的 `async`。
-- `camelcase: ["error", { properties: "never" }]` 保持错误，兼顾代码命名与外部协议字段。
-- TypeScript 模块导出边界要求显式类型，内部函数返回类型不强制标注。
-- `no-non-null-assertion` 和 `no-unnecessary-condition` 关闭，避免破坏标准断言和运行时防御。
-- Import 位置、重复导入、成员顺序和声明顺序均为错误；保留常用 pathGroups，样式文件单独保持在最后。
-- Vue 使用官方 `flat/recommended`，显式 emits、kebab-case、props 只读、关键正确性规则和属性顺序为错误，`v-html` 风险为警告。
-- `package.json` 和 `tsconfig*.json` 排序保持为所有完整配置的基础能力。
-
-## 工程能力
-
-| 领域          | 状态 | 质量保障                                              |
-| ------------- | ---- | ----------------------------------------------------- |
-| 公共 API      | 通过 | 根入口具名导出独立 Vue、UniApp 配置和工厂             |
-| JavaScript    | 通过 | recommended + 精选正确性和可读性规则                  |
-| TypeScript    | 通过 | `recommendedTypeChecked` + Project Service + 边界规则 |
-| Vue 3         | 通过 | `.vue` 独立 parser 扩展，不注入 UniApp                |
-| UniApp        | 通过 | `.vue`/`.nvue`、globals、清单注释和独立忽略项         |
-| Import        | 通过 | 正确性、成员/声明顺序和样式末尾均为 error             |
-| React/Angular | 通过 | 从框架无关基础配置显式组合                            |
-| JSON/RegExp   | 通过 | 方言解析与高置信度正确性、安全规则                    |
-| 清单排序      | 通过 | 默认启用并保留 `exports` 条件顺序                     |
-| 类型生成      | 通过 | 插件 schema 生成精确 `RuleOptions`                    |
-| 构建发布      | 通过 | ESM、声明文件、根入口具名配置和根目录 `dist/`         |
-
-## 配置顺序
-
-完整配置按以下顺序组合：
-
-1. 全局忽略项和 `.gitignore`。
-2. 应用运行环境与 Node.js 工程文件 globals。
-3. Common、JavaScript、Import、RegExp、TypeScript 与 JSON。
-4. `package.json` 与 `tsconfig*.json` 排序。
-5. Vue 或 Vue + UniApp 的独立框架层。
-6. Prettier 冲突关闭层。
-7. Node.js 工程文件末尾覆写。
-8. 调用方后置 Flat Config。
-
-## 发布前验证
-
-```sh
-pnpm typegen
-pnpm check
-pnpm pack --dry-run
-```
-
-发布归档必须包含根入口、`./configs`、`./constants` 和 `./rules`，不得包含源码缓存或本地依赖目录。CI 只负责验证，不自动发布 npm。
-
-## 剩余风险
-
-- 上游 recommended 会随依赖升级变化，升级 ESLint 或插件后必须检查最终生效配置。
-- 类型感知依赖 tsconfig 覆盖和 Project Service，复杂 monorepo 需要维护清晰的项目边界。
-- `explicit-module-boundary-types` 会要求应用项目中的 `.ts`/`.tsx` 导出也按 SDK 公共接口显式标注，这是本项目有意选择的统一边界。
-- ESLint 无法验证 UniApp 条件编译对象是否处于正确平台分支。
-- `.uvue` 与 `.uts` 仍不在支持范围。