@fast-china/eslint-config 2.0.10 → 2.1.0

package/README.zh.md

@@ -8,21 +8,20 @@
 
 # @fast-china/eslint-config
 
-面向 Vue 3、React、Angular、Vite、TypeScript 与 JavaScript 项目的实用型 ESLint Flat Config 规则库。
+面向 Vue 3、UniApp、React、Angular、Vite、TypeScript 与 JavaScript 项目的实用型 ESLint Flat Config 规则库。
 
 [![npm version](https://img.shields.io/npm/v/@fast-china/eslint-config?color=orange)](https://www.npmjs.com/package/@fast-china/eslint-config) [![Node.js](https://img.shields.io/badge/node-%5E22.18%20%7C%7C%20%5E24.18-brightgreen)](https://nodejs.org/) [![ESLint](https://img.shields.io/badge/eslint-%5E10.0-4b32c3)](https://eslint.org/) [![license](https://img.shields.io/npm/l/@fast-china/eslint-config)](./LICENSE)
 
 ## 特性
 
 - 基于 ESLint 10，仅提供原生 Flat Config。
-- 默认针对 Vue 3 + TypeScript + Vite；React 与 Angular 是完整但按需启用的框架集成，Vue 项目不会意外接管无关文件。
-- 完整覆盖 JavaScript、TypeScript、Vue SFC、JSX/TSX、Angular TypeScript 与模板、JSON 各方言、Markdown、正则表达式与导入规则。
-- 默认导出可直接使用或展开的 Flat Config 数组；具名 `fastConfig()` 工厂用于自定义选项和项目覆写。
-- 根据 ESLint 与内置插件的规则 schema 生成精确类型，提供规则名和规则选项自动补全。
-- 插件与解析器均由本包直接声明依赖，使用者不需要手工拼装插件依赖树。
-- Prettier 只负责格式化：默认配置仅关闭冲突规则，不在 ESLint 内重复运行 Prettier。
-- 默认检查 Markdown，并安全排序 `package.json` 与 `tsconfig.json`；React 和 Angular 保持按需启用。
-- 可选统一使用 `lodash` 或 `lodash-unified`，避免同一项目混用多个 Lodash 入口。
+- 根入口固定面向 Vue 3 + TypeScript + UniApp，不再通过布尔选项启停语言和插件。
+- TypeScript、Vue 与 React TypeScript 始终使用类型感知推荐规则和 Project Service。
+- SDK、OA、Admin 与客户端使用同一套 JavaScript、TypeScript、Import 和 RegExp 规则，不提供严格度档位。
+- 默认启用 JavaScript、TypeScript、Vue/`.nvue`、UniApp globals、JSON 各方言、Import、RegExp、清单排序、`.gitignore` 与 Prettier 兼容层。
+- React、Angular、Markdown 和 Lodash 策略通过 `@fast-china/eslint-config/configs` 显式组合。
+- 根据规则 schema 生成精确 `RuleOptions`，提供规则名和规则选项自动补全。
+- 插件与解析器均由本包声明依赖，使用者不需要手工拼装依赖树。
 
 ## 环境要求
 
@@ -30,317 +29,192 @@
 - ESLint `^10.0.0`
 - TypeScript `^6.0.0`
 
-这些版本范围与 ESLint 10 及内置语言插件的运行要求保持一致。
-
 ## 安装
 
 ```sh
 pnpm add -D eslint typescript @fast-china/eslint-config
 ```
 
-也可以使用 npm、Yarn 或 Bun 的等价命令。
-
-## 快速开始：Vue 3 + Vite
+## Vue 3 / UniApp 快速开始
 
 创建 `eslint.config.mjs`：
 
 ```js
-import { defineConfig } from "eslint/config";
-
 import fastChina from "@fast-china/eslint-config";
 
-export default defineConfig([fastChina]);
+export default fastChina;
 ```
 
-也可以直接 `export default fastChina`，或在组合其他配置时使用 `...fastChina`。默认配置面向普通 Vue 3 浏览器后台管理项目，启用 Vue 3、TypeScript、JavaScript、JSON 各方言、Markdown、清单排序、导入排序、正则检查、`.gitignore` 与浏览器全局变量；常见配置文件、脚本、测试和 CLI 文件会额外获得 Node.js 全局变量。React 与 Angular 按需启用；Lodash 策略通过 `configs` 子路径独立组合。
+默认入口固定包含：
 
-## 适配其他项目
+- 浏览器运行环境和 Node.js 工程文件 globals。
+- JavaScript、类型感知 TypeScript、Vue 3 与 `.nvue`。
+- `uni`、`uniCloud`、页面 API 以及 `wx`、`plus`、`my`、`tt` 等条件编译平台 globals。
+- JSON、JSONC、JSON5，以及允许注释的 `pages.json`、`manifest.json` 和 VS Code `settings.json`、`extensions.json`。
+- Import、RegExp、`package.json`/`tsconfig*.json` 排序、`.gitignore` 和 Prettier 冲突关闭层。
 
-其他项目可以通过具名 `fastConfig()` 工厂配置选项，也可以完全绕过根工厂，直接组合所需片段。
+ESLint 不执行 UniApp 的 `#ifdef`/`#endif`，因此只能识别平台对象，不能验证对象是否位于正确的平台分支。当前不处理需要专用解析器的 `.uvue` 与 `.uts`。
 
-### 使用 `fastConfig()`
+## `fastConfig()`
 
-#### React + Vite
+根工厂只保留 `environment`，默认值为 `"browser"`：
 
 ```js
 import { fastConfig } from "@fast-china/eslint-config";
 
 export default fastConfig({
-	react: true,
-	vue: false,
+	environment: "universal",
 });
 ```
 
-React 集成会应用现代 `@eslint-react` JavaScript/TypeScript 预置、React 官方 Hooks Flat Config，以及额外的 DOM 安全检查。JSX 与 TSX 分别复用现有 JavaScript、TypeScript 解析能力。Preact 等兼容 React 的 JSX 运行时可设置 `react: { importSource: "preact" }`。
-
-#### Angular
-
-```js
-import { fastConfig } from "@fast-china/eslint-config";
-
-export default fastConfig({
-	angular: true,
-	vue: false,
-});
-```
+可选值：
 
-Angular 集成会检查框架 TypeScript、外部 `.html` 模板和组件内联模板。模板无障碍规则与内联模板提取默认开启，也可以显式配置：
+| 值            | 应用源码 globals |
+| ------------- | ---------------- |
+| `"browser"`   | 浏览器           |
+| `"node"`      | Node.js          |
+| `"universal"` | 浏览器和 Node.js |
 
-```js
-export default fastConfig({
-	angular: {
-		inlineTemplates: true,
-		templateAccessibility: true,
-	},
-	vue: false,
-});
-```
+配置文件、脚本、测试和 CLI 文件始终单独获得 Node.js globals，并允许必要的 `console` 和 CommonJS 兼容加载。
 
-Angular 依赖 TypeScript 集成；同时设置 `angular: true` 与 `typescript: false` 时会立即抛出清晰的配置错误。
+## 项目覆写
 
-#### Node.js + TypeScript
+规则、globals、ignores 和解析器特殊设置直接使用后置 Flat Config，不再包装成根工厂选项：
 
 ```js
-import { fastConfig } from "@fast-china/eslint-config";
+import { defineRules, fastConfig } from "@fast-china/eslint-config";
 
-export default fastConfig({
-	environment: "node",
-	vue: false,
-});
+export default fastConfig(
+	{ environment: "browser" },
+	{
+		ignores: ["public/vendor/**"],
+		languageOptions: {
+			globals: {
+				__APP_VERSION__: "readonly",
+			},
+		},
+		rules: defineRules({
+			"no-console": "warn",
+		}),
+	},
+	{
+		files: ["**/*.generated.ts"],
+		rules: defineRules({
+			"@typescript-eslint/no-unused-vars": "off",
+		}),
+	}
+);
 ```
 
-#### 纯 JavaScript
+后置配置拥有最高优先级。`defineRules()` 不修改对象，只提供精确的规则类型检查。
 
-```js
-import { fastConfig } from "@fast-china/eslint-config";
-
-export default fastConfig({
-	environment: "node",
-	json: false,
-	markdown: false,
-	typescript: false,
-	vue: false,
-});
-```
+## TypeScript
 
-#### 启用 TypeScript 类型感知规则
+`createTypeScriptConfigs()`、Vue SFC 和 React TSX 始终使用 `recommendedTypeChecked` 与：
 
 ```js
-import { fastConfig } from "@fast-china/eslint-config";
-
-export default fastConfig({
-	typescript: {
-		tsconfigRootDir: import.meta.dirname,
-		typeChecked: true,
-	},
-});
+parserOptions: {
+	projectService: true,
+}
 ```
 
-类型感知模式使用 typescript-eslint Project Service，被检查的文件必须属于某个 `tsconfig.json`。普通项目通常可省略 `tsconfigRootDir`；复杂 monorepo 建议显式传入配置文件所在目录。
+被检查文件必须属于可发现的 `tsconfig.json`。不再提供 `typeChecked` 和 `tsconfigRootDir` 包装选项；复杂 monorepo 如需指定根目录，可在后置 Flat Config 中直接覆盖 `languageOptions.parserOptions`。
 
-### 直接组合配置片段
+## React
 
-不希望使用根工厂的项目可以只组装需要的片段。以下 React 浏览器项目示例完全不依赖 `fastConfig()`：
+React 项目从不绑定框架的基础配置开始组合：
 
 ```js
+import { createBaseConfigs } from "@fast-china/eslint-config";
+import { createReactConfigs } from "@fast-china/eslint-config/configs";
 import { defineConfig } from "eslint/config";
 
-import {
-	createCommonConfigs,
-	createEnvironmentConfigs,
-	createGitignoreConfigs,
-	createGlobalIgnores,
-	createImportConfigs,
-	createJavaScriptConfigs,
-	createPrettierConfigs,
-	createReactConfigs,
-	createRegexpConfigs,
-	createTypeScriptConfigs,
-} from "@fast-china/eslint-config/configs";
-import { GLOBS_JAVASCRIPT, GLOBS_TYPESCRIPT } from "@fast-china/eslint-config/constants";
-
-const codeFiles = [...GLOBS_JAVASCRIPT, ...GLOBS_TYPESCRIPT];
-
-export default defineConfig([
-	...createGlobalIgnores(),
-	...createGitignoreConfigs(),
-	...createEnvironmentConfigs({ environment: "browser", files: codeFiles, nodeFiles: codeFiles }),
-	...createCommonConfigs(codeFiles),
-	...createJavaScriptConfigs(),
-	...createImportConfigs(codeFiles),
-	...createRegexpConfigs(codeFiles),
-	...createTypeScriptConfigs(),
-	...createReactConfigs({}, { javascript: true, typescript: true }),
-	...createPrettierConfigs(),
-]);
+export default defineConfig([...createBaseConfigs(), ...createReactConfigs()]);
 ```
 
-Vue SFC 可增加 `createVueConfigs()`，Angular 可增加 `createAngularConfigs()`，Node.js 项目则将环境设为 `"node"`。配置片段的顺序具有语义，项目覆写应始终放在最后。
-
-## 配置选项
-
-| 选项              | 默认值      | 作用                                                           |
-| ----------------- | ----------- | -------------------------------------------------------------- |
-| `angular`         | `false`     | 启用 Angular TypeScript 与模板，或传入 Angular 专用选项。      |
-| `environment`     | `"browser"` | 可选 `"browser"`、`"node"` 或 `"universal"` 全局变量。         |
-| `globals`         | 无          | 增加项目宿主、测试运行器等提供的全局变量。                     |
-| `gitignore`       | `true`      | 读取项目根目录的 `.gitignore`。                                |
-| `ignores`         | `[]`        | 追加项目自己的全局忽略模式。                                   |
-| `imports`         | `true`      | 启用 import-x 正确性与排序规则。                               |
-| `javascript`      | `true`      | 处理 JavaScript 与 JSX。                                       |
-| `json`            | `true`      | 启用 JSON、JSONC 与 JSON5 推荐规则。                           |
-| `markdown`        | `true`      | 启用官方 Markdown 语言规则。                                   |
-| `prettier`        | `true`      | 关闭与 Prettier 冲突的 ESLint 规则。                           |
-| `react`           | `false`     | 启用 React、JSX 与 Hooks，或传入运行时和 React 版本设置。      |
-| `regexp`          | `true`      | 启用推荐的正则表达式规则。                                     |
-| `rules`           | 无          | 对所有已启用代码文件追加具有精确类型的项目规则。               |
-| `sortPackageJson` | `true`      | 按安全白名单排序 `package.json`，不会进入 `exports` 条件对象。 |
-| `sortTsconfig`    | `true`      | 按 TypeScript 文档主题排序 `tsconfig*.json`。                  |
-| `typescript`      | `true`      | 可关闭，或传入 `{ typeChecked: true, tsconfigRootDir }`。      |
-| `vue`             | `true`      | 启用 Vue 3 单文件组件支持。                                    |
-
-## 框架覆盖范围
-
-Vue 3、React 与 Angular 都有专用解析器或处理器、推荐规则、配置选项、生成规则类型与集成测试。Nuxt 可使用 Vue 基础配置；Next.js 与 Remix 可使用 React 基础配置，并在 `fastConfig()` 后追加各自的框架 Flat Config。兼容 React 的 JSX 运行时可以使用 `react.importSource`。
-
-Svelte、Astro 与 Solid 具有不同的模板或编译器语义，目前不会被包装成名义上的“一键支持”。项目已经可以把它们的官方 Flat Config 作为末尾覆写传入；将来只有在解析器、处理器、规则 schema、文档和真实运行时 fixture 一并完成时，才会增加对应的一等开关。
-
-## Lodash 导入策略
+基础配置提供统一的 JavaScript、类型感知 TypeScript、JSON、Import、RegExp、清单排序和 Prettier 兼容层；React 片段追加 `@eslint-react`、React 官方 Hooks Recommended 和 DOM 安全规则，不会加载 Vue 或 UniApp globals。
 
-Lodash 策略不是 `fastConfig()` 选项。只有需要统一静态导入来源时，才从 `@fast-china/eslint-config/configs` 导入 `createLodashConfigs()`：
-
-- `createLodashConfigs("lodash-unified")`：禁止从 `lodash`、`lodash-es` 及其子路径静态导入或重新导出。
-- `createLodashConfigs("lodash")`：禁止从 `lodash-es`、`lodash-unified` 及其子路径静态导入或重新导出；允许 `lodash` 根入口和 `lodash/*` 按方法导入。
-
-选择 `lodash-unified`：
-
-```sh
-pnpm add lodash-unified
-```
+Preact 等兼容运行时可以传入 React 识别设置：
 
 ```js
-import { defineConfig } from "eslint/config";
-
-import fastChina from "@fast-china/eslint-config";
-import { createLodashConfigs } from "@fast-china/eslint-config/configs";
-import { cloneDeep, debounce } from "lodash-unified";
-
-export default defineConfig([...fastChina, ...createLodashConfigs("lodash-unified")]);
+export default defineConfig([...createBaseConfigs(), ...createReactConfigs({ importSource: "preact", version: "detect" })]);
 ```
 
-选择标准 `lodash`：
-
-```sh
-pnpm add lodash
-pnpm add -D @types/lodash
-```
+## Angular
 
 ```js
+import { createBaseConfigs } from "@fast-china/eslint-config";
+import { createAngularConfigs } from "@fast-china/eslint-config/configs";
 import { defineConfig } from "eslint/config";
 
-import fastChina from "@fast-china/eslint-config";
-import { createLodashConfigs } from "@fast-china/eslint-config/configs";
-import debounce from "lodash/debounce";
-
-export default defineConfig([...fastChina, ...createLodashConfigs("lodash")]);
+export default defineConfig([...createBaseConfigs(), ...createAngularConfigs()]);
 ```
 
-该片段使用 ESLint 核心 `no-restricted-imports`，不需要额外插件，也不会替项目安装 Lodash。它只检查静态 `import`/`export`，不检查动态 `import()` 或 CommonJS `require()`，并且独立于根工厂的 `imports` 选项。
-
-如果后续 `rules` 或文件级覆写再次设置 `no-restricted-imports`，ESLint 会用后面的完整规则替换这套策略，而不是合并选项。需要组合更多包限制时，可从 `@fast-china/eslint-config/rules` 导入原始 `preferLodashRules` 或 `preferLodashUnifiedRules`，统一维护一份完整规则。
-
-## 精确规则类型与自动补全
-
-本包根据 ESLint 核心规则和所有随包插件公开的 JSON Schema 生成 `RuleOptions`，并提供不会改变运行时对象的 `defineRules()`。在输入规则名、严重级别或选项时，TypeScript 与支持类型分析的编辑器会给出补全；拼错规则名或填写无效选项时会立即报错。
+Angular 片段检查 TypeScript 源码、外部 HTML 模板和组件内联模板，默认启用官方模板无障碍规则。特殊项目仍可配置：
 
 ```js
-// @ts-check
-import { defineRules, fastConfig } from "@fast-china/eslint-config";
-
-const projectRules = defineRules({
-	"@angular-eslint/template/alt-text": "error",
-	"@eslint-react/dom-no-missing-button-type": "error",
-	"@typescript-eslint/no-unused-vars": ["error", { args: "after-used" }],
-	"import-x/order": ["error", { "newlines-between": "never" }],
-	"react-hooks/exhaustive-deps": "warn",
-	"vue/attributes-order": ["error", { order: ["DEFINITION", "EVENTS", "CONTENT"] }],
+createAngularConfigs({
+	inlineTemplates: false,
+	templateAccessibility: false,
 });
-
-export default fastConfig(
-	{ rules: projectRules },
-	{
-		files: ["**/*.generated.ts"],
-		name: "project/generated",
-		rules: defineRules({ "@typescript-eslint/no-unused-vars": "off" }),
-	}
-);
 ```
 
-在 TypeScript 配置或工具代码中，也可以直接使用：
+## Node.js / SDK
 
-```ts
-import type { RuleOptions } from "@fast-china/eslint-config";
+不需要 Vue、UniApp、React 或 Angular 的项目直接使用基础配置：
 
-const rules = {
-	"no-console": ["warn", { allow: ["warn", "error"] }],
-} satisfies RuleOptions;
+```js
+import { createBaseConfigs } from "@fast-china/eslint-config";
+
+export default createBaseConfigs({ environment: "node" });
 ```
 
-精确类型覆盖 ESLint 核心规则和本包附带的插件规则；项目自行安装的额外插件不在该类型集合内。类型精度取决于对应规则公开的 schema。
+`createBaseConfigs()` 固定启用 JavaScript、类型感知 TypeScript、JSON、Import、RegExp、清单排序、`.gitignore` 和 Prettier 兼容层，但不接管任何框架文件。
 
-## 规则风险与维护
+## Markdown 与 Lodash
 
-默认配置包含少量高影响规则：它们可能阻断特定写法，或要求复核 import 副作用、类型导入、组件公共事件和清单排序结果。React 与 Angular 在全局默认关闭，但启用框架后也会启用文档中列出的现代框架约束和无障碍规则。源码使用 `[高影响]`、`[可自动修复]` 与 `[安全关注]` 标记这类规则。
+Markdown 需要显式组合：
 
-完整的默认预置来源、高影响规则清单、关闭示例和维护约定见 [默认规则与风险指南](./docs/rules-risk.zh.md)。运行 `eslint --fix` 前建议先只检查，在独立提交中应用修复，并审查 import、`package.json`、组件事件和构建产物。
+```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(), ...createMarkdownConfigs()]);
+```
 
-最常用的全局覆盖可以直接放入 `rules`；按文件覆盖作为后续参数传入，后面的配置优先级更高：
+Lodash 静态导入策略同样独立：
 
 ```js
-import { defineRules, fastConfig } from "@fast-china/eslint-config";
+import { createLodashConfigs } from "@fast-china/eslint-config/configs";
 
-export default fastConfig(
-	{
-		rules: {
-			"no-console": "warn",
-		},
-	},
-	{
-		files: ["**/{scripts,tests}/**/*.{js,ts}"],
-		name: "project/node-files",
-		rules: defineRules({ "no-console": "off" }),
-	}
-);
+createLodashConfigs("lodash");
+createLodashConfigs("lodash-unified");
 ```
 
-根入口只公开 `fastConfig`、`defaultConfigOptions`、`defineRules`、`FastConfigOptions` 和 `RuleOptions`。高级组合通过职责明确的子路径完成，避免扩大根入口：
+## 公共入口
 
-- `@fast-china/eslint-config/configs` 导出全部配置创建函数及其选项类型。
-- `@fast-china/eslint-config/constants` 导出项目维护的全部文件 glob。
-- `@fast-china/eslint-config/rules` 导出带完整注释的原始规则记录和 `RuleOptions`。
+根入口只公开：
 
-```js
-import { defineConfig } from "eslint/config";
+- 默认 Vue 3 + TypeScript + UniApp Flat Config。
+- `fastConfig`、`createBaseConfigs`、`FastConfigOptions`。
+- `defineRules`、`RuleOptions`。
 
-import { createCommonConfigs, createTypeScriptConfigs } from "@fast-china/eslint-config/configs";
-import { GLOBS_TYPESCRIPT } from "@fast-china/eslint-config/constants";
+高级组合通过职责明确的子路径提供：
 
-export default defineConfig([...createCommonConfigs(GLOBS_TYPESCRIPT), ...createTypeScriptConfigs({ typeChecked: true })]);
-```
+- `@fast-china/eslint-config/configs`：框架和功能配置片段。
+- `@fast-china/eslint-config/constants`：文件 glob 与 UniApp globals。
+- `@fast-china/eslint-config/rules`：带类型的原始规则记录。
 
 ## Prettier
 
-Prettier 不再是 peer dependency，也不会作为 ESLint 规则运行。项目需要格式化时单独安装并执行：
+Prettier 不作为 ESLint 规则运行。默认配置只加载 `eslint-config-prettier` 关闭冲突规则；项目需要自行安装并执行格式化：
 
 ```sh
 pnpm add -D prettier
 pnpm exec prettier --check .
 ```
 
-如果使用其他格式化工具，或希望保留完整的样式类 ESLint 规则，请设置 `prettier: false`。
-
 ## 文档
 
 - [默认规则与风险指南](./docs/rules-risk.zh.md)
@@ -358,9 +232,7 @@ pnpm check
 pnpm pack --dry-run
 ```
 
-修改配置工厂或规则时，可使用 `pnpm dev` 交互检查实际生效的 Flat Config。
-
-升级 ESLint 或插件后运行 `pnpm typegen` 并提交 `src/typegen.d.ts`；不要手工编辑生成文件。`pnpm test` 会先重新构建发布产物，再分别执行消费者类型契约、运行时集成和发布包契约测试。`pnpm check` 在此基础上增加源码类型检查、全仓 ESLint 和格式验证。
+升级 ESLint 或插件后运行 `pnpm typegen` 并提交 `src/typegen.d.ts`。`pnpm check` 会验证类型、构建、运行时行为、发布包契约、ESLint 和格式。
 
 ## 开源协议
 

package/SECURITY.md

@@ -9,8 +9,8 @@ Fixes are not backported to unsupported versions.
 
 | Version   | Supported |
 | --------- | --------- |
-| `2.0.6`   | Yes       |
-| `< 2.0.6` | No        |
+| `2.1.x`   | Yes       |
+| `< 2.1.0` | No        |
 
 ## Reporting a vulnerability
 
@@ -86,8 +86,8 @@ data that is not yours, degrading services, or disrupting other users.
 
 | 版本      | 是否支持 |
 | --------- | -------- |
-| `2.0.6`   | 是       |
-| `< 2.0.6` | 否       |
+| `2.1.x`   | 是       |
+| `< 2.1.0` | 否       |
 
 ### 报告安全漏洞
 

package/dist/configs/angular.d.mts

@@ -1,14 +1,14 @@
+import { defineConfig } from "eslint/config";
 //#region src/configs/angular.d.ts
 /**
  * Angular TypeScript 源码与 HTML 模板检查的细分选项。
  *
  * @remarks
- * 该对象通过 `fastConfig({ angular: { ... } })` 传入。只要传入对象，Angular 支持就会
- * 被启用；未指定的字段继续使用各自默认值。Angular 配置始终包含框架 TypeScript 规则
+ * 该对象直接传给 `createAngularConfigs()`。Angular 配置始终包含框架 TypeScript 规则
  * 和外部 `.html` 模板基础规则，本接口只控制成本或迁移影响较高的可选部分。
  *
- * Angular 支持依赖顶层 `typescript` 能力，不能与 `typescript: false` 同时使用。
- * 这些选项不会修改 Angular 编译器、CLI 或模板类型检查配置。
+ * 这些选项不会修改 Angular 编译器、CLI 或模板类型检查配置。调用方应先组合
+ * `createBaseConfigs()`，以提供统一的类型感知 TypeScript 配置。
  */
 interface AngularConfigOptions {
   /**
@@ -34,13 +34,13 @@ interface AngularConfigOptions {
  * 创建 Angular TypeScript、外部 HTML 模板与内联模板配置。
  *
  * @remarks
- * Angular 支持依赖工厂的 TypeScript 配置先注册 typescript-eslint 解析器；模板由
+ * Angular 支持依赖基础配置先注册 typescript-eslint 解析器；模板由
  * Angular 专用 parser 解析，内联模板通过官方 processor 复用同一套 HTML 规则。
  *
  * @param options - 控制内联模板处理与模板无障碍规则的 Angular 选项。
  * @returns 按 TypeScript 源码、外部模板顺序排列的 ESLint Flat Config 数组。
  */
-declare const createAngularConfigs: ({ inlineTemplates, templateAccessibility }?: AngularConfigOptions) => import("eslint/config").ConfigObject[];
+declare const createAngularConfigs: ({ inlineTemplates, templateAccessibility }?: AngularConfigOptions) => ReturnType<typeof defineConfig>;
 //#endregion
 export { AngularConfigOptions, createAngularConfigs };
 //# sourceMappingURL=angular.d.mts.map

package/dist/configs/angular.mjs

@@ -9,7 +9,7 @@ import { defineConfig } from "eslint/config";
 * 创建 Angular TypeScript、外部 HTML 模板与内联模板配置。
 *
 * @remarks
-* Angular 支持依赖工厂的 TypeScript 配置先注册 typescript-eslint 解析器；模板由
+* Angular 支持依赖基础配置先注册 typescript-eslint 解析器；模板由
 * Angular 专用 parser 解析，内联模板通过官方 processor 复用同一套 HTML 规则。
 *
 * @param options - 控制内联模板处理与模板无障碍规则的 Angular 选项。

package/dist/configs/angular.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"angular.mjs","names":[],"sources":["../../src/configs/angular.ts"],"sourcesContent":["import angularPlugin from \"@angular-eslint/eslint-plugin\";\nimport angularTemplatePlugin from \"@angular-eslint/eslint-plugin-template\";\nimport angularTemplateParser from \"@angular-eslint/template-parser\";\nimport { defineConfig } from \"eslint/config\";\nimport { GLOB_ANGULAR_TEMPLATE, GLOB_ANGULAR_TYPESCRIPT } from \"../constants\";\nimport { angularRules, angularTemplateAccessibilityRules, angularTemplateRules } from \"../rules\";\nimport type { ESLint, Linter } from \"eslint\";\n\n/**\n * Angular TypeScript 源码与 HTML 模板检查的细分选项。\n *\n * @remarks\n * 该对象通过 `fastConfig({ angular: { ... } })` 传入。只要传入对象，Angular 支持就会\n * 被启用；未指定的字段继续使用各自默认值。Angular 配置始终包含框架 TypeScript 规则\n * 和外部 `.html` 模板基础规则，本接口只控制成本或迁移影响较高的可选部分。\n *\n * Angular 支持依赖顶层 `typescript` 能力，不能与 `typescript: false` 同时使用。\n * 这些选项不会修改 Angular 编译器、CLI 或模板类型检查配置。\n */\nexport interface AngularConfigOptions {\n\t/**\n\t * 是否使用 Angular 官方 processor，从 TypeScript 文件的\n\t * `@Component({ template: ... })` 元数据中提取内联 HTML 并复用模板规则进行检查。\n\t *\n\t * 关闭后仍会检查 Angular TypeScript 源码和外部 `.html` 模板，只是不再处理组件中的\n\t * 内联模板。大型项目若主要使用外部模板，或 processor 与其他工具发生冲突，可暂时关闭。\n\t * @defaultValue `true`\n\t */\n\tinlineTemplates?: boolean;\n\t/**\n\t * 是否在模板基础正确性规则之外启用 Angular 模板无障碍规则组。\n\t *\n\t * 该规则组检查替代文本、键盘交互、焦点、表单标签和 ARIA 等可访问性问题，适用于\n\t * 外部模板与已提取的内联模板。关闭后仍保留模板语法、严格比较和现代控制流等基础规则。\n\t * 对旧项目而言可能一次产生较多报告，建议在确认迁移计划后再决定是否临时关闭。\n\t * @defaultValue `true`\n\t */\n\ttemplateAccessibility?: boolean;\n}\n\n/**\n * 创建 Angular TypeScript、外部 HTML 模板与内联模板配置。\n *\n * @remarks\n * Angular 支持依赖工厂的 TypeScript 配置先注册 typescript-eslint 解析器；模板由\n * Angular 专用 parser 解析，内联模板通过官方 processor 复用同一套 HTML 规则。\n *\n * @param options - 控制内联模板处理与模板无障碍规则的 Angular 选项。\n * @returns 按 TypeScript 源码、外部模板顺序排列的 ESLint Flat Config 数组。\n */\nexport const createAngularConfigs = ({ inlineTemplates = true, templateAccessibility = true }: AngularConfigOptions = {}) =>\n\tdefineConfig([\n\t\t{\n\t\t\tname: inlineTemplates ? \"@fast-china/angular/typescript-with-inline-templates\" : \"@fast-china/angular/typescript\",\n\t\t\tfiles: [GLOB_ANGULAR_TYPESCRIPT],\n\t\t\tplugins: {\n\t\t\t\t\"@angular-eslint\": angularPlugin as unknown as ESLint.Plugin,\n\t\t\t},\n\t\t\t...(inlineTemplates\n\t\t\t\t? {\n\t\t\t\t\t\tprocessor: angularTemplatePlugin.processors[\"extract-inline-html\"] as Linter.Processor,\n\t\t\t\t\t}\n\t\t\t\t: {}),\n\t\t\trules: angularRules,\n\t\t},\n\t\t{\n\t\t\tname: templateAccessibility ? \"@fast-china/angular/template-accessibility\" : \"@fast-china/angular/template\",\n\t\t\tfiles: [GLOB_ANGULAR_TEMPLATE],\n\t\t\tlanguageOptions: {\n\t\t\t\tparser: angularTemplateParser as unknown as Linter.Parser,\n\t\t\t},\n\t\t\tplugins: {\n\t\t\t\t\"@angular-eslint/template\": angularTemplatePlugin as unknown as ESLint.Plugin,\n\t\t\t},\n\t\t\trules: {\n\t\t\t\t...angularTemplateRules,\n\t\t\t\t...(templateAccessibility ? angularTemplateAccessibilityRules : {}),\n\t\t\t},\n\t\t},\n\t]);\n"],"mappings":";;;;;;;;;;;;;;;;;AAkDA,MAAa,wBAAwB,EAAE,kBAAkB,MAAM,wBAAwB,SAA+B,CAAC,MACtH,aAAa,CACZ;CACC,MAAM,kBAAkB,yDAAyD;CACjF,OAAO,CAAC,uBAAuB;CAC/B,SAAS,EACR,mBAAmB,cACpB;CACA,GAAI,kBACD,EACA,WAAW,sBAAsB,WAAW,uBAC7C,IACC,CAAC;CACJ,OAAO;AACR,GACA;CACC,MAAM,wBAAwB,+CAA+C;CAC7E,OAAO,CAAC,qBAAqB;CAC7B,iBAAiB,EAChB,QAAQ,sBACT;CACA,SAAS,EACR,4BAA4B,sBAC7B;CACA,OAAO;EACN,GAAG;EACH,GAAI,wBAAwB,oCAAoC,CAAC;CAClE;AACD,CACD,CAAC"}
+{"version":3,"file":"angular.mjs","names":[],"sources":["../../src/configs/angular.ts"],"sourcesContent":["import angularPlugin from \"@angular-eslint/eslint-plugin\";\nimport angularTemplatePlugin from \"@angular-eslint/eslint-plugin-template\";\nimport angularTemplateParser from \"@angular-eslint/template-parser\";\nimport { defineConfig } from \"eslint/config\";\nimport { GLOB_ANGULAR_TEMPLATE, GLOB_ANGULAR_TYPESCRIPT } from \"../constants\";\nimport { angularRules, angularTemplateAccessibilityRules, angularTemplateRules } from \"../rules\";\nimport type { ESLint, Linter } from \"eslint\";\n\n/**\n * Angular TypeScript 源码与 HTML 模板检查的细分选项。\n *\n * @remarks\n * 该对象直接传给 `createAngularConfigs()`。Angular 配置始终包含框架 TypeScript 规则\n * 和外部 `.html` 模板基础规则，本接口只控制成本或迁移影响较高的可选部分。\n *\n * 这些选项不会修改 Angular 编译器、CLI 或模板类型检查配置。调用方应先组合\n * `createBaseConfigs()`，以提供统一的类型感知 TypeScript 配置。\n */\nexport interface AngularConfigOptions {\n\t/**\n\t * 是否使用 Angular 官方 processor，从 TypeScript 文件的\n\t * `@Component({ template: ... })` 元数据中提取内联 HTML 并复用模板规则进行检查。\n\t *\n\t * 关闭后仍会检查 Angular TypeScript 源码和外部 `.html` 模板，只是不再处理组件中的\n\t * 内联模板。大型项目若主要使用外部模板，或 processor 与其他工具发生冲突，可暂时关闭。\n\t * @defaultValue `true`\n\t */\n\tinlineTemplates?: boolean;\n\t/**\n\t * 是否在模板基础正确性规则之外启用 Angular 模板无障碍规则组。\n\t *\n\t * 该规则组检查替代文本、键盘交互、焦点、表单标签和 ARIA 等可访问性问题，适用于\n\t * 外部模板与已提取的内联模板。关闭后仍保留模板语法、严格比较和现代控制流等基础规则。\n\t * 对旧项目而言可能一次产生较多报告，建议在确认迁移计划后再决定是否临时关闭。\n\t * @defaultValue `true`\n\t */\n\ttemplateAccessibility?: boolean;\n}\n\n/**\n * 创建 Angular TypeScript、外部 HTML 模板与内联模板配置。\n *\n * @remarks\n * Angular 支持依赖基础配置先注册 typescript-eslint 解析器；模板由\n * Angular 专用 parser 解析，内联模板通过官方 processor 复用同一套 HTML 规则。\n *\n * @param options - 控制内联模板处理与模板无障碍规则的 Angular 选项。\n * @returns 按 TypeScript 源码、外部模板顺序排列的 ESLint Flat Config 数组。\n */\nexport const createAngularConfigs = ({ inlineTemplates = true, templateAccessibility = true }: AngularConfigOptions = {}): ReturnType<\n\ttypeof defineConfig\n> =>\n\tdefineConfig([\n\t\t{\n\t\t\tname: inlineTemplates ? \"@fast-china/angular/typescript-with-inline-templates\" : \"@fast-china/angular/typescript\",\n\t\t\tfiles: [GLOB_ANGULAR_TYPESCRIPT],\n\t\t\tplugins: {\n\t\t\t\t\"@angular-eslint\": angularPlugin as unknown as ESLint.Plugin,\n\t\t\t},\n\t\t\t...(inlineTemplates\n\t\t\t\t? {\n\t\t\t\t\t\tprocessor: angularTemplatePlugin.processors[\"extract-inline-html\"] as Linter.Processor,\n\t\t\t\t\t}\n\t\t\t\t: {}),\n\t\t\trules: angularRules,\n\t\t},\n\t\t{\n\t\t\tname: templateAccessibility ? \"@fast-china/angular/template-accessibility\" : \"@fast-china/angular/template\",\n\t\t\tfiles: [GLOB_ANGULAR_TEMPLATE],\n\t\t\tlanguageOptions: {\n\t\t\t\tparser: angularTemplateParser as unknown as Linter.Parser,\n\t\t\t},\n\t\t\tplugins: {\n\t\t\t\t\"@angular-eslint/template\": angularTemplatePlugin as unknown as ESLint.Plugin,\n\t\t\t},\n\t\t\trules: {\n\t\t\t\t...angularTemplateRules,\n\t\t\t\t...(templateAccessibility ? angularTemplateAccessibilityRules : {}),\n\t\t\t},\n\t\t},\n\t]);\n"],"mappings":";;;;;;;;;;;;;;;;;AAiDA,MAAa,wBAAwB,EAAE,kBAAkB,MAAM,wBAAwB,SAA+B,CAAC,MAGtH,aAAa,CACZ;CACC,MAAM,kBAAkB,yDAAyD;CACjF,OAAO,CAAC,uBAAuB;CAC/B,SAAS,EACR,mBAAmB,cACpB;CACA,GAAI,kBACD,EACA,WAAW,sBAAsB,WAAW,uBAC7C,IACC,CAAC;CACJ,OAAO;AACR,GACA;CACC,MAAM,wBAAwB,+CAA+C;CAC7E,OAAO,CAAC,qBAAqB;CAC7B,iBAAiB,EAChB,QAAQ,sBACT;CACA,SAAS,EACR,4BAA4B,sBAC7B;CACA,OAAO;EACN,GAAG;EACH,GAAI,wBAAwB,oCAAoC,CAAC;CAClE;AACD,CACD,CAAC"}

package/dist/configs/common.d.mts

@@ -1,3 +1,4 @@
+import { defineConfig } from "eslint/config";
 //#region src/configs/common.d.ts
 /**
  * 创建跨 JavaScript、TypeScript 与 Vue 脚本生效的通用配置。
@@ -9,7 +10,7 @@
  * @param files - 应用公共规则的 ESLint glob 列表。
  * @returns 包含公共规则与无效禁用指令检查的 Flat Config 数组。
  */
-declare const createCommonConfigs: (files?: readonly string[]) => import("eslint/config").ConfigObject[];
+declare const createCommonConfigs: (files?: readonly string[]) => ReturnType<typeof defineConfig>;
 //#endregion
 export { createCommonConfigs };
 //# sourceMappingURL=common.d.mts.map

package/dist/configs/common.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"common.mjs","names":[],"sources":["../../src/configs/common.ts"],"sourcesContent":["import { defineConfig } from \"eslint/config\";\nimport { GLOBS_CODE } from \"../constants\";\nimport { commonRules } from \"../rules\";\n\n/**\n * 创建跨 JavaScript、TypeScript 与 Vue 脚本生效的通用配置。\n *\n * @remarks\n * 除公共规则外，这里还把无效的 `eslint-disable` 指令提升为错误，避免规则被移除后\n * 留下长期失效的抑制注释。\n *\n * @param files - 应用公共规则的 ESLint glob 列表。\n * @returns 包含公共规则与无效禁用指令检查的 Flat Config 数组。\n */\nexport const createCommonConfigs = (files: readonly string[] = GLOBS_CODE) =>\n\tdefineConfig([\n\t\t{\n\t\t\tname: \"@fast-china/common\",\n\t\t\tfiles: [...files],\n\t\t\tlinterOptions: {\n\t\t\t\treportUnusedDisableDirectives: \"error\",\n\t\t\t},\n\t\t\trules: commonRules,\n\t\t},\n\t]);\n"],"mappings":";;;;;;;;;;;;;;AAcA,MAAa,uBAAuB,QAA2B,eAC9D,aAAa,CACZ;CACC,MAAM;CACN,OAAO,CAAC,GAAG,KAAK;CAChB,eAAe,EACd,+BAA+B,QAChC;CACA,OAAO;AACR,CACD,CAAC"}
+{"version":3,"file":"common.mjs","names":[],"sources":["../../src/configs/common.ts"],"sourcesContent":["import { defineConfig } from \"eslint/config\";\nimport { GLOBS_CODE } from \"../constants\";\nimport { commonRules } from \"../rules\";\n\n/**\n * 创建跨 JavaScript、TypeScript 与 Vue 脚本生效的通用配置。\n *\n * @remarks\n * 除公共规则外，这里还把无效的 `eslint-disable` 指令提升为错误，避免规则被移除后\n * 留下长期失效的抑制注释。\n *\n * @param files - 应用公共规则的 ESLint glob 列表。\n * @returns 包含公共规则与无效禁用指令检查的 Flat Config 数组。\n */\nexport const createCommonConfigs = (files: readonly string[] = GLOBS_CODE): ReturnType<typeof defineConfig> =>\n\tdefineConfig([\n\t\t{\n\t\t\tname: \"@fast-china/common\",\n\t\t\tfiles: [...files],\n\t\t\tlinterOptions: {\n\t\t\t\treportUnusedDisableDirectives: \"error\",\n\t\t\t},\n\t\t\trules: commonRules,\n\t\t},\n\t]);\n"],"mappings":";;;;;;;;;;;;;;AAcA,MAAa,uBAAuB,QAA2B,eAC9D,aAAa,CACZ;CACC,MAAM;CACN,OAAO,CAAC,GAAG,KAAK;CAChB,eAAe,EACd,+BAA+B,QAChC;CACA,OAAO;AACR,CACD,CAAC"}

package/dist/configs/environment.d.mts

@@ -1,3 +1,4 @@
+import { defineConfig } from "eslint/config";
 import { Linter } from "eslint";
 //#region src/configs/environment.d.ts
 /**
@@ -12,9 +13,8 @@ type RuntimeEnvironment = "browser" | "node" | "universal";
  * 运行时全局变量配置片段的选项。
  *
  * @remarks
- * `fastConfig()` 会根据已启用的语言和框架计算 `files`、`nodeFiles`，再调用
- * `createEnvironmentConfigs()`。该接口仍保持独立，以便环境片段的输入、默认值和文件
- * 范围在源码中具有明确契约；直接组合配置片段时可从 `./configs` 子路径使用。
+ * 固定项目组合会根据自身处理的语言和框架传入 `files`、`nodeFiles`。该接口仍保持独立，
+ * 以便低层组合明确控制环境片段的文件范围。
  *
  * 应用代码与 Node.js 工程文件使用两个独立 Flat Config 片段，避免浏览器源码无条件获得
  * `process`、`Buffer` 等 Node.js 全局变量，也避免配置文件误报这些合法全局变量未定义。
@@ -32,8 +32,8 @@ interface EnvironmentConfigOptions {
   /**
    * 需要获得所选运行时全局变量的应用代码 glob 列表。
    *
-   * 工厂会把当前启用的 JavaScript、TypeScript 和 Vue 文件范围传入这里。数组会复制到
-   * 生成配置中，不会在函数内部修改调用方传入的值。
+   * 项目组合会把自身负责的 JavaScript、TypeScript 和框架文件范围传入这里。数组会
+   * 复制到生成配置中，不会在函数内部修改调用方传入的值。
    * @defaultValue {@link GLOBS_CODE}
    */
   files?: readonly string[];
@@ -41,8 +41,7 @@ interface EnvironmentConfigOptions {
    * 当前启用且允许作为 Node.js 工程文件执行的脚本扩展名 glob 列表。
    *
    * 每一项都会与内置的配置文件、脚本目录、测试文件和 CLI 文件模式组合为 ESLint
-   * Flat Config 的 AND 文件条件。例如顶层关闭 TypeScript 后，Node.js 工程片段也不会
-   * 因自身模式较宽而意外接管 `.ts` 文件。
+   * Flat Config 的 AND 文件条件，避免工程文件模式意外接管组合范围之外的扩展名。
    * @defaultValue {@link GLOBS_JAVASCRIPT}
    */
   nodeFiles?: readonly string[];
@@ -61,13 +60,24 @@ interface EnvironmentConfigOptions {
  *
  * @remarks
  * 返回两个相互独立的 Flat Config 片段：第一个为应用源码配置所选环境和项目级全局
- * 变量；第二个仅命中配置、脚本、测试与 CLI 等工程文件，为它们配置 Node.js 全局变量
- * 并允许使用 `console`。分离范围可以减少跨运行时的假阴性。
+ * 变量；第二个仅命中配置、脚本、测试与 CLI 等工程文件，为它们配置 Node.js 全局变量。
+ * Node 工具文件的规则覆写由 {@link createNodeToolingConfigs} 在语言规则之后应用。
  *
  * @param options - 运行时环境、目标文件范围与项目级全局变量。
  * @returns 依次包含应用运行时环境和 Node.js 工程文件环境的 Flat Config 数组。
  */
-declare const createEnvironmentConfigs: ({ environment, files, nodeFiles, globals: projectGlobals }?: EnvironmentConfigOptions) => import("eslint/config").ConfigObject[];
+declare const createEnvironmentConfigs: ({ environment, files, nodeFiles, globals: projectGlobals }?: EnvironmentConfigOptions) => ReturnType<typeof defineConfig>;
+/**
+ * 创建 Node.js 配置、脚本、测试和 CLI 文件的末尾规则覆写。
+ *
+ * @remarks
+ * 该片段必须放在 JavaScript 与 TypeScript 规则之后，确保工具文件可以输出日志并使用
+ * CommonJS 兼容加载，而不会放宽浏览器业务源码。
+ *
+ * @param nodeFiles - 当前已启用的 JavaScript/TypeScript 文件 glob。
+ * @returns Node 工具文件规则覆写数组。
+ */
+declare const createNodeToolingConfigs: (nodeFiles?: readonly string[]) => ReturnType<typeof defineConfig>;
 //#endregion
-export { EnvironmentConfigOptions, RuntimeEnvironment, createEnvironmentConfigs };
+export { EnvironmentConfigOptions, RuntimeEnvironment, createEnvironmentConfigs, createNodeToolingConfigs };
 //# sourceMappingURL=environment.d.mts.map