@fast-china/eslint-config 2.0.4 → 2.0.6

package/CHANGELOG.md

@@ -6,6 +6,21 @@ The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and
 
 ## Unreleased
 
+## 2.0.6 - 2026-08-04
+
+### Changed
+
+- Standardized the bilingual README, repository ignores, editor settings, TypeScript checks, and tsdown output configuration across the Fast frontend SDK repositories.
+- Simplified the test pipeline to runtime, type-contract, and package-contract verification by removing documentation- and comment-governance tests.
+- Included contribution and security documents in the published package and refreshed the engineering guidance for the current workflow.
+
+## 2.0.5 - 2026-08-02
+
+### Changed
+
+- Upgraded public API documentation to complete TSDoc, including standard defaults, parameters, return values, thrown errors, remarks, examples, and package-level documentation.
+- Separated runtime, type-contract, rule-governance, and package-contract tests, and replaced the hard-coded release version assertion with SemVer and changelog consistency checks.
+
 ## 2.0.4 - 2026-08-02
 
 ### Added

package/CONTRIBUTING.md

@@ -0,0 +1,62 @@
+# Contributing
+
+Thank you for improving `@fast-china/eslint-config`.
+
+## Prerequisites
+
+- A supported Node.js version from `package.json`
+- pnpm `11.x`
+
+## Local workflow
+
+```sh
+pnpm install
+pnpm typegen
+pnpm check
+```
+
+Use `pnpm dev` to inspect the active Flat Config interactively while changing factories or rules.
+
+Use `pnpm lint:fix` and `pnpm format` for safe mechanical fixes. `pnpm test` first rebuilds `dist`, then runs consumer type-contract, runtime integration, and package-contract suites. `pnpm check` is the same quality gate used by CI and adds source type-checking, full-repository linting, and formatting verification.
+
+`src/typegen.d.ts` is generated from ESLint rule schemas and is part of the public type API. Run `pnpm typegen` after changing ESLint or plugin versions, inspect and commit the generated diff, and use `pnpm typegen:check` to verify it. Never edit the generated declaration manually.
+
+## Changing rules or factory behavior
+
+1. Keep correctness rules separate from formatting rules.
+2. Scope every rule group with `files` unless it is intentionally global.
+3. Register each plugin in a configuration that matches the same files as its rules.
+4. Prefer upstream recommended configs before adding local overrides.
+5. Keep organization-specific dependency restrictions out of this general-purpose package; projects should own those policies.
+6. Explain the purpose, rationale, and important exception or risk immediately above every local rule override.
+7. Mark disruptive defaults with `[高影响]`; verify `meta.fixable` before using `[可自动修复]`, and keep `docs/rules-risk.md` plus `docs/rules-risk.zh.md` synchronized.
+8. Never sort a map whose key order has semantics, including conditional objects under `package.json#exports`.
+9. Regenerate `src/typegen.d.ts` whenever ESLint or a bundled plugin changes; confirm new rules and changed option schemas intentionally.
+10. Add or update an integration test for every parser, plugin, option, auto-fix, generated type, or public export change. The root API is intentionally limited to `fastConfig`, `defaultConfigOptions`, `defineRules`, and related types.
+11. Document behavior changes in `CHANGELOG.md` and both README files.
+
+## Pull requests
+
+Keep changes focused and explain user-visible compatibility effects. Do not commit credentials or publish from a pull request. Changes to the Node.js, ESLint, TypeScript, Vue, React, Angular, Prettier, or module-format contract should be treated as release-significant changes.
+
+## Releases
+
+The package is ESM-only and publication is maintainer-controlled. Update `CHANGELOG.md` and `package.json`, commit the release state, then run:
+
+```sh
+pnpm check
+pnpm pack --dry-run
+pnpm publish --access public --registry https://registry.npmjs.org/
+```
+
+`prepack` reruns the complete quality gate before pnpm creates the publish archive. Inspect the dry-run list and verify that both root and `./rules` entry points contain JavaScript and declarations, together with the generated JavaScript and declaration source maps. After publication, verify the registry result and tag the exact commit:
+
+```sh
+pnpm view @fast-china/eslint-config version --registry https://registry.npmjs.org/
+VERSION=$(node -p "require('./package.json').version")
+git tag -a "v$VERSION" -m "release: v$VERSION"
+git push origin master
+git push origin "v$VERSION"
+```
+
+npm versions are immutable; never reuse an already published version.

package/README.md

@@ -1,11 +1,16 @@
-[中文](./README.zh.md) | **English**
+<p align="left">
+	<a href="./README.zh.md">简体中文</a> | <strong>English</strong>
+</p>
+
+<p align="center">
+	<img src="./Fast.png" alt="logo" width="160" />
+</p>
 
 # @fast-china/eslint-config
 
 A practical, typed ESLint Flat Config for Vue 3, React, Angular, Vite, TypeScript, and JavaScript projects.
 
-[![npm version](https://img.shields.io/npm/v/@fast-china/eslint-config?color=orange)](https://www.npmjs.com/package/@fast-china/eslint-config)
-[![license](https://img.shields.io/npm/l/@fast-china/eslint-config)](./LICENSE)
+[![npm version](https://img.shields.io/npm/v/@fast-china/eslint-config?color=orange)](https://www.npmjs.com/package/@fast-china/eslint-config) [![node](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)
 
 ## Highlights
 
@@ -334,18 +339,26 @@ pnpm exec prettier --check .
 
 Set `prettier: false` if another formatter or stylistic rule set should remain fully in control.
 
+## Documentation
+
+- [Default rules and risk guide](./docs/rules-risk.md)
+- [Engineering audit (Chinese)](./docs/engineering-audit.zh.md)
+- [Contributing guide](./CONTRIBUTING.md)
+- [Security policy](./SECURITY.md)
+- [Changelog](./CHANGELOG.md)
+
 ## Development
 
 ```sh
-pnpm install
+pnpm install --frozen-lockfile
 pnpm typegen
 pnpm check
 pnpm pack --dry-run
 ```
 
-Run `pnpm typegen` after upgrading ESLint or a plugin and commit `src/typegen.d.ts`; never edit the generated file manually. `pnpm check` verifies that generated types are current, builds the package, type-checks source, lints all supported file types, checks formatting, and runs both runtime and consumer type tests against the built package.
+Use `pnpm dev` to inspect the active Flat Config interactively while changing factories or rules.
 
-See [CONTRIBUTING.md](./CONTRIBUTING.md) for the contribution workflow, the [default-rule and risk guide](./docs/rules-risk.md) for rule maintenance, and [the engineering audit](./docs/engineering-audit.zh.md) for the current quality baseline.
+Run `pnpm typegen` after upgrading ESLint or a plugin and commit `src/typegen.d.ts`; never edit the generated file manually. `pnpm test` rebuilds the package before running consumer type-contract, runtime integration, and package-contract tests. `pnpm check` adds source type-checking, full-repository linting, and formatting verification.
 
 ## License
 

package/README.zh.md

@@ -1,11 +1,16 @@
-**中文** | [English](./README.md)
+<p align="left">
+	<strong>简体中文</strong> | <a href="./README.md">English</a>
+</p>
+
+<p align="center">
+	<img src="./Fast.png" alt="logo" width="160" />
+</p>
 
 # @fast-china/eslint-config
 
 面向 Vue 3、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)
-[![license](https://img.shields.io/npm/l/@fast-china/eslint-config)](./LICENSE)
+[![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)
 
 ## 特性
 
@@ -334,18 +339,26 @@ pnpm exec prettier --check .
 
 如果使用其他格式化工具，或希望保留完整的样式类 ESLint 规则，请设置 `prettier: false`。
 
+## 文档
+
+- [默认规则与风险指南](./docs/rules-risk.zh.md)
+- [工程质量审查报告](./docs/engineering-audit.zh.md)
+- [贡献指南](./CONTRIBUTING.md)
+- [安全策略](./SECURITY.md)
+- [更新日志](./CHANGELOG.md)
+
 ## 开发与贡献
 
 ```sh
-pnpm install
+pnpm install --frozen-lockfile
 pnpm typegen
 pnpm check
 pnpm pack --dry-run
 ```
 
-升级 ESLint 或插件后运行 `pnpm typegen` 并提交 `src/typegen.d.ts`；不要手工编辑生成文件。`pnpm check` 会验证生成类型没有漂移，然后依次构建、类型检查、检查所有支持的文件类型、验证格式，并针对构建后的真实包运行运行时和消费者类型测试。
+修改配置工厂或规则时，可使用 `pnpm dev` 交互检查实际生效的 Flat Config。
 
-贡献流程见 [CONTRIBUTING.md](./CONTRIBUTING.md)，规则维护约定见 [默认规则与风险指南](./docs/rules-risk.zh.md)，本次工程审查和质量基线见 [工程质量审查报告](./docs/engineering-audit.zh.md)。
+升级 ESLint 或插件后运行 `pnpm typegen` 并提交 `src/typegen.d.ts`；不要手工编辑生成文件。`pnpm test` 会先重新构建发布产物，再分别执行消费者类型契约、运行时集成和发布包契约测试。`pnpm check` 在此基础上增加源码类型检查、全仓 ESLint 和格式验证。
 
 ## 开源协议
 

package/SECURITY.md

@@ -0,0 +1,133 @@
+# Security Policy
+
+[中文说明](#安全策略) | **English**
+
+## Supported versions
+
+Security fixes are provided for the latest release in the current major line.
+Fixes are not backported to unsupported versions.
+
+| Version   | Supported |
+| --------- | --------- |
+| `2.0.6`   | Yes       |
+| `< 2.0.6` | No        |
+
+## Reporting a vulnerability
+
+Do not disclose a suspected vulnerability in a public Issue, Pull Request,
+Discussion, or other public channel.
+
+This project does not currently publish a dedicated security email address. To
+request a private reporting channel, create a minimal issue in the
+[Gitee issue tracker](https://gitee.com/FastDotnet/fast.eslint.config/issues/new)
+with the title `[Security] Private report request`. Include only the affected
+package version and a safe way for the maintainer to contact you. Do not include
+technical details, proof-of-concept code, logs, attachments, credentials, or
+other sensitive information in that issue.
+
+After a private channel has been established, please provide:
+
+- the affected package version and runtime environment;
+- the vulnerability type and potential impact;
+- the smallest reproducible example or proof of concept;
+- the conditions required to reproduce the issue;
+- any known workaround or suggested remediation; and
+- your preferred disclosure timeline and attribution name, if any.
+
+Never include real credentials, tokens, personal data, or third-party secrets
+in a report or reproduction.
+
+## Response and disclosure process
+
+The maintainers aim to:
+
+- acknowledge a report within 7 calendar days;
+- provide an initial assessment within 14 calendar days; and
+- send progress updates at least every 14 calendar days while remediation is in
+  progress.
+
+These are response targets rather than guaranteed service-level commitments.
+Validated reports will be handled through coordinated disclosure. Please avoid
+public disclosure until a fixed release is available or another disclosure date
+has been agreed upon. When appropriate, the fix will be accompanied by release
+notes or a security advisory. Reporter attribution is optional and will follow
+the reporter's preference.
+
+## Scope
+
+Examples of issues that may be security vulnerabilities include:
+
+- unintended code execution while installing, importing, or running the
+  package;
+- tampered or unexpected contents in a published package or release artifact;
+- exposure of credentials or sensitive local project data caused by this
+  package; and
+- a dependency or configuration weakness that is demonstrably exploitable
+  through this package.
+
+The following are normally handled as regular bug reports:
+
+- disagreements about rule defaults or formatting preferences;
+- lint false positives or false negatives without a concrete security impact;
+- issues that affect only unsupported versions; and
+- vulnerabilities that exist solely in an upstream dependency and cannot be
+  exploited through this package.
+
+When researching a potential vulnerability, act in good faith: avoid accessing
+data that is not yours, degrading services, or disrupting other users.
+
+---
+
+## 安全策略
+
+### 支持版本
+
+安全修复仅面向当前主版本线中的最新发布版本，不会向已停止支持的版本回移植。
+
+| 版本      | 是否支持 |
+| --------- | -------- |
+| `2.0.6`   | 是       |
+| `< 2.0.6` | 否       |
+
+### 报告安全漏洞
+
+请勿在公开的 Issue、Pull Request、讨论区或其他公开渠道中披露疑似漏洞的技术细节。
+
+本项目目前没有公开专用的安全邮箱。如需建立私密报告渠道，请在
+[Gitee Issue](https://gitee.com/FastDotnet/fast.eslint.config/issues/new)
+中创建一个标题为 `[Security] Private report request` 的最小化 Issue。公开内容只能包含受影响的包版本，以及维护者可用于联系你的安全联系方式。请勿在该 Issue 中提交技术细节、概念验证代码、日志、附件、凭据或其他敏感信息。
+
+建立私密渠道后，请尽量提供：
+
+- 受影响的包版本和运行环境；
+- 漏洞类型及潜在影响；
+- 最小复现示例或概念验证；
+- 复现所需的前置条件；
+- 已知的临时规避方案或修复建议；
+- 期望的披露时间，以及是否需要署名。
+
+报告和复现内容中不得包含真实凭据、令牌、个人数据或第三方秘密信息。
+
+### 响应与披露流程
+
+维护者计划在 7 个自然日内确认收到报告，在 14 个自然日内给出初步评估；修复期间至少每 14 个自然日同步一次进展。这些时间是处理目标，不构成服务等级承诺。
+
+确认有效的漏洞将采用协同披露流程。请在修复版本发布或双方约定的披露日期之前避免公开漏洞。必要时，修复版本会附带发布说明或安全公告。是否公开报告者署名，以报告者的意愿为准。
+
+### 适用范围
+
+以下问题可能属于安全漏洞：
+
+- 安装、导入或运行本包时发生未预期的代码执行；
+- npm 发布包或 Release 产物包含被篡改或未预期的内容；
+- 本包导致凭据或本地项目敏感数据泄露；
+- 依赖或配置缺陷能够通过本包被明确利用。
+
+以下问题通常按普通 Bug 处理：
+
+- 对默认规则或格式偏好的不同意见；
+- 没有明确安全影响的误报或漏报；
+- 仅影响已停止支持版本的问题；
+- 仅存在于上游依赖、且无法通过本包利用的漏洞。
+
+研究疑似漏洞时请遵循善意原则：不要访问不属于你的数据，不要降低服务可用性，也不要影响其他用户。

package/dist/configs/angular.d.mts

@@ -2,6 +2,7 @@
 /**
  * Angular TypeScript 源码与 HTML 模板检查的细分选项。
  *
+ * @remarks
  * 该对象通过 `fastConfig({ angular: { ... } })` 传入。只要传入对象，Angular 支持就会
  * 被启用；未指定的字段继续使用各自默认值。Angular 配置始终包含框架 TypeScript 规则
  * 和外部 `.html` 模板基础规则，本接口只控制成本或迁移影响较高的可选部分。
@@ -16,7 +17,7 @@ interface AngularConfigOptions {
    *
    * 关闭后仍会检查 Angular TypeScript 源码和外部 `.html` 模板，只是不再处理组件中的
    * 内联模板。大型项目若主要使用外部模板，或 processor 与其他工具发生冲突，可暂时关闭。
-   * @default true
+   * @defaultValue `true`
    */
   inlineTemplates?: boolean;
   /**
@@ -25,15 +26,19 @@ interface AngularConfigOptions {
    * 该规则组检查替代文本、键盘交互、焦点、表单标签和 ARIA 等可访问性问题，适用于
    * 外部模板与已提取的内联模板。关闭后仍保留模板语法、严格比较和现代控制流等基础规则。
    * 对旧项目而言可能一次产生较多报告，建议在确认迁移计划后再决定是否临时关闭。
-   * @default true
+   * @defaultValue `true`
    */
   templateAccessibility?: boolean;
 }
 /**
  * 创建 Angular TypeScript、外部 HTML 模板与内联模板配置。
  *
+ * @remarks
  * Angular 支持依赖工厂的 TypeScript 配置先注册 typescript-eslint 解析器；模板由
  * Angular 专用 parser 解析，内联模板通过官方 processor 复用同一套 HTML 规则。
+ *
+ * @param options - 控制内联模板处理与模板无障碍规则的 Angular 选项。
+ * @returns 按 TypeScript 源码、外部模板顺序排列的 ESLint Flat Config 数组。
  */
 declare const createAngularConfigs: ({ inlineTemplates, templateAccessibility }?: AngularConfigOptions) => import("eslint/config").ConfigObject[];
 //#endregion

package/dist/configs/angular.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"angular.d.mts","names":[],"sources":["../../src/configs/angular.ts"],"mappings":";;;;;;;;;;;UAoBiB;;;;;;;;;EAShB;;;;;;;;;EASA;;;;;;;;cASY,yBAAwB,iBAAA,0BAA0D,iDAAyB"}
+{"version":3,"file":"angular.d.mts","names":[],"sources":["../../src/configs/angular.ts"],"mappings":";;;;;;;;;;;;UAqBiB;;;;;;;;;EAShB;;;;;;;;;EASA;;;;;;;;;;;;cAaY,yBAAwB,iBAAA,0BAA0D,iDAAyB"}

package/dist/configs/angular.mjs

@@ -8,8 +8,12 @@ import { defineConfig } from "eslint/config";
 /**
 * 创建 Angular TypeScript、外部 HTML 模板与内联模板配置。
 *
+* @remarks
 * Angular 支持依赖工厂的 TypeScript 配置先注册 typescript-eslint 解析器；模板由
 * Angular 专用 parser 解析，内联模板通过官方 processor 复用同一套 HTML 规则。
+*
+* @param options - 控制内联模板处理与模板无障碍规则的 Angular 选项。
+* @returns 按 TypeScript 源码、外部模板顺序排列的 ESLint Flat Config 数组。
 */
 const createAngularConfigs = ({ inlineTemplates = true, templateAccessibility = true } = {}) => defineConfig([{
 	name: inlineTemplates ? "@fast-china/angular/typescript-with-inline-templates" : "@fast-china/angular/typescript",

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\";\n\nimport { GLOB_ANGULAR_TEMPLATE, GLOB_ANGULAR_TYPESCRIPT } from \"../constants\";\nimport { angularRules, angularTemplateAccessibilityRules, angularTemplateRules } from \"../rules\";\n\nimport type { ESLint, Linter } from \"eslint\";\n\n/**\n * Angular TypeScript 源码与 HTML 模板检查的细分选项。\n *\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 * @default true\n\t */\n\tinlineTemplates?: boolean;\n\t/**\n\t * 是否在模板基础正确性规则之外启用 Angular 模板无障碍规则组。\n\t *\n\t * 该规则组检查替代文本、键盘交互、焦点、表单标签和 ARIA 等可访问性问题，适用于\n\t * 外部模板与已提取的内联模板。关闭后仍保留模板语法、严格比较和现代控制流等基础规则。\n\t * 对旧项目而言可能一次产生较多报告，建议在确认迁移计划后再决定是否临时关闭。\n\t * @default true\n\t */\n\ttemplateAccessibility?: boolean;\n}\n\n/**\n * 创建 Angular TypeScript、外部 HTML 模板与内联模板配置。\n *\n * Angular 支持依赖工厂的 TypeScript 配置先注册 typescript-eslint 解析器；模板由\n * Angular 专用 parser 解析，内联模板通过官方 processor 复用同一套 HTML 规则。\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":";;;;;;;;;;;;;AA+CA,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\";\n\nimport { GLOB_ANGULAR_TEMPLATE, GLOB_ANGULAR_TYPESCRIPT } from \"../constants\";\nimport { angularRules, angularTemplateAccessibilityRules, angularTemplateRules } from \"../rules\";\n\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":";;;;;;;;;;;;;;;;;AAoDA,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"}

package/dist/configs/common.d.mts

@@ -2,8 +2,12 @@
 /**
  * 创建跨 JavaScript、TypeScript 与 Vue 脚本生效的通用配置。
  *
+ * @remarks
  * 除公共规则外，这里还把无效的 `eslint-disable` 指令提升为错误，避免规则被移除后
  * 留下长期失效的抑制注释。
+ *
+ * @param files - 应用公共规则的 ESLint glob 列表。
+ * @returns 包含公共规则与无效禁用指令检查的 Flat Config 数组。
  */
 declare const createCommonConfigs: (files?: readonly string[]) => import("eslint/config").ConfigObject[];
 //#endregion

package/dist/configs/common.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"common.d.mts","names":[],"sources":["../../src/configs/common.ts"],"mappings":";;;;;;;cAWa,sBAAuB,sDAAqC"}
+{"version":3,"file":"common.d.mts","names":[],"sources":["../../src/configs/common.ts"],"mappings":";;;;;;;;;;;cAea,sBAAuB,sDAAqC"}

package/dist/configs/common.mjs

@@ -5,8 +5,12 @@ import { defineConfig } from "eslint/config";
 /**
 * 创建跨 JavaScript、TypeScript 与 Vue 脚本生效的通用配置。
 *
+* @remarks
 * 除公共规则外，这里还把无效的 `eslint-disable` 指令提升为错误，避免规则被移除后
 * 留下长期失效的抑制注释。
+*
+* @param files - 应用公共规则的 ESLint glob 列表。
+* @returns 包含公共规则与无效禁用指令检查的 Flat Config 数组。
 */
 const createCommonConfigs = (files = GLOBS_CODE) => defineConfig([{
 	name: "@fast-china/common",

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\";\n\nimport { GLOBS_CODE } from \"../constants\";\nimport { commonRules } from \"../rules\";\n\n/**\n * 创建跨 JavaScript、TypeScript 与 Vue 脚本生效的通用配置。\n *\n * 除公共规则外，这里还把无效的 `eslint-disable` 指令提升为错误，避免规则被移除后\n * 留下长期失效的抑制注释。\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":";;;;;;;;;;AAWA,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\";\n\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":";;;;;;;;;;;;;;AAeA,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,9 +1,17 @@
 import { Linter } from "eslint";
 //#region src/configs/environment.d.ts
+/**
+ * 应用源码可声明的运行时环境。
+ *
+ * - `"browser"` 仅提供浏览器全局变量。
+ * - `"node"` 仅提供 Node.js 全局变量。
+ * - `"universal"` 同时提供浏览器与 Node.js 全局变量。
+ */
 type RuntimeEnvironment = "browser" | "node" | "universal";
 /**
  * 运行时全局变量配置片段的选项。
  *
+ * @remarks
  * `fastConfig()` 会根据已启用的语言和框架计算 `files`、`nodeFiles`，再调用
  * `createEnvironmentConfigs()`。该接口仍保持独立，以便环境片段的输入、默认值和文件
  * 范围在源码中具有明确契约；直接组合配置片段时可从 `./configs` 子路径使用。
@@ -18,7 +26,7 @@ interface EnvironmentConfigOptions {
    * `"browser"` 只注入浏览器全局变量，`"node"` 只注入 Node.js 全局变量，
    * `"universal"` 同时注入两组。该值不会影响 `nodeFiles` 对应的工程文件；后者始终
    * 使用 Node.js 全局变量。
-   * @default "browser"
+   * @defaultValue `"browser"`
    */
   environment?: RuntimeEnvironment;
   /**
@@ -26,7 +34,7 @@ interface EnvironmentConfigOptions {
    *
    * 工厂会把当前启用的 JavaScript、TypeScript 和 Vue 文件范围传入这里。数组会复制到
    * 生成配置中，不会在函数内部修改调用方传入的值。
-   * @default GLOBS_CODE
+   * @defaultValue {@link GLOBS_CODE}
    */
   files?: readonly string[];
   /**
@@ -35,7 +43,7 @@ interface EnvironmentConfigOptions {
    * 每一项都会与内置的配置文件、脚本目录、测试文件和 CLI 文件模式组合为 ESLint
    * Flat Config 的 AND 文件条件。例如顶层关闭 TypeScript 后，Node.js 工程片段也不会
    * 因自身模式较宽而意外接管 `.ts` 文件。
-   * @default GLOBS_JAVASCRIPT
+   * @defaultValue {@link GLOBS_JAVASCRIPT}
    */
   nodeFiles?: readonly string[];
   /**
@@ -44,16 +52,20 @@ interface EnvironmentConfigOptions {
    * 该记录在标准环境全局变量之后合并，所以同名条目可以覆盖预置权限。它应用于完整
    * `files` 范围；其中属于 Node.js 工程文件的子集还会由后续片段追加标准 Node.js 全局
    * 变量。值格式遵循 ESLint `Linter.Globals`。
-   * @default {}
+   * @defaultValue `{}`
    */
   globals?: Linter.Globals;
 }
 /**
  * 创建运行时环境相关的 ESLint 配置。
  *
+ * @remarks
  * 返回两个相互独立的 Flat Config 片段：第一个为应用源码配置所选环境和项目级全局
  * 变量；第二个仅命中配置、脚本、测试与 CLI 等工程文件，为它们配置 Node.js 全局变量
  * 并允许使用 `console`。分离范围可以减少跨运行时的假阴性。
+ *
+ * @param options - 运行时环境、目标文件范围与项目级全局变量。
+ * @returns 依次包含应用运行时环境和 Node.js 工程文件环境的 Flat Config 数组。
  */
 declare const createEnvironmentConfigs: ({ environment, files, nodeFiles, globals: projectGlobals }?: EnvironmentConfigOptions) => import("eslint/config").ConfigObject[];
 //#endregion

package/dist/configs/environment.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"environment.d.mts","names":[],"sources":["../../src/configs/environment.ts"],"mappings":";;KAOY;;;;;;;;;;;UAYK;;;;;;;;;EAShB,cAAc;;;;;;;;EAQd;;;;;;;;;EASA;;;;;;;;;EASA,UAAU,OAAO;;;;;;;;;cAUL,6BAA4B,aAAA,OAAA,WAAA,SAAA,mBAKtC,qDAA6B"}
+{"version":3,"file":"environment.d.mts","names":[],"sources":["../../src/configs/environment.ts"],"mappings":";;;;;;;;;KAcY;;;;;;;;;;;;UAaK;;;;;;;;;EAShB,cAAc;;;;;;;;EAQd;;;;;;;;;EASA;;;;;;;;;EASA,UAAU,OAAO;;;;;;;;;;;;;cAcL,6BAA4B,aAAA,OAAA,WAAA,SAAA,mBAKtC,qDAA6B"}

package/dist/configs/environment.mjs

@@ -5,9 +5,13 @@ import globals from "globals";
 /**
 * 创建运行时环境相关的 ESLint 配置。
 *
+* @remarks
 * 返回两个相互独立的 Flat Config 片段：第一个为应用源码配置所选环境和项目级全局
 * 变量；第二个仅命中配置、脚本、测试与 CLI 等工程文件，为它们配置 Node.js 全局变量
 * 并允许使用 `console`。分离范围可以减少跨运行时的假阴性。
+*
+* @param options - 运行时环境、目标文件范围与项目级全局变量。
+* @returns 依次包含应用运行时环境和 Node.js 工程文件环境的 Flat Config 数组。
 */
 const createEnvironmentConfigs = ({ environment = "browser", files = GLOBS_CODE, nodeFiles = GLOBS_JAVASCRIPT, globals: projectGlobals = {} } = {}) => {
 	const runtimeGlobals = {

package/dist/configs/environment.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"environment.mjs","names":[],"sources":["../../src/configs/environment.ts"],"sourcesContent":["import { defineConfig } from \"eslint/config\";\nimport globals from \"globals\";\n\nimport { GLOBS_CODE, GLOBS_JAVASCRIPT, GLOBS_NODE_TOOLING } from \"../constants\";\n\nimport type { Linter } from \"eslint\";\n\nexport type RuntimeEnvironment = \"browser\" | \"node\" | \"universal\";\n\n/**\n * 运行时全局变量配置片段的选项。\n *\n * `fastConfig()` 会根据已启用的语言和框架计算 `files`、`nodeFiles`，再调用\n * `createEnvironmentConfigs()`。该接口仍保持独立，以便环境片段的输入、默认值和文件\n * 范围在源码中具有明确契约；直接组合配置片段时可从 `./configs` 子路径使用。\n *\n * 应用代码与 Node.js 工程文件使用两个独立 Flat Config 片段，避免浏览器源码无条件获得\n * `process`、`Buffer` 等 Node.js 全局变量，也避免配置文件误报这些合法全局变量未定义。\n */\nexport interface EnvironmentConfigOptions {\n\t/**\n\t * 应用代码实际运行的环境，决定 `files` 范围内注入哪组标准全局变量。\n\t *\n\t * `\"browser\"` 只注入浏览器全局变量，`\"node\"` 只注入 Node.js 全局变量，\n\t * `\"universal\"` 同时注入两组。该值不会影响 `nodeFiles` 对应的工程文件；后者始终\n\t * 使用 Node.js 全局变量。\n\t * @default \"browser\"\n\t */\n\tenvironment?: RuntimeEnvironment;\n\t/**\n\t * 需要获得所选运行时全局变量的应用代码 glob 列表。\n\t *\n\t * 工厂会把当前启用的 JavaScript、TypeScript 和 Vue 文件范围传入这里。数组会复制到\n\t * 生成配置中，不会在函数内部修改调用方传入的值。\n\t * @default GLOBS_CODE\n\t */\n\tfiles?: readonly string[];\n\t/**\n\t * 当前启用且允许作为 Node.js 工程文件执行的脚本扩展名 glob 列表。\n\t *\n\t * 每一项都会与内置的配置文件、脚本目录、测试文件和 CLI 文件模式组合为 ESLint\n\t * Flat Config 的 AND 文件条件。例如顶层关闭 TypeScript 后，Node.js 工程片段也不会\n\t * 因自身模式较宽而意外接管 `.ts` 文件。\n\t * @default GLOBS_JAVASCRIPT\n\t */\n\tnodeFiles?: readonly string[];\n\t/**\n\t * 追加到应用代码环境中的项目级全局变量及其读写权限。\n\t *\n\t * 该记录在标准环境全局变量之后合并，所以同名条目可以覆盖预置权限。它应用于完整\n\t * `files` 范围；其中属于 Node.js 工程文件的子集还会由后续片段追加标准 Node.js 全局\n\t * 变量。值格式遵循 ESLint `Linter.Globals`。\n\t * @default {}\n\t */\n\tglobals?: Linter.Globals;\n}\n\n/**\n * 创建运行时环境相关的 ESLint 配置。\n *\n * 返回两个相互独立的 Flat Config 片段：第一个为应用源码配置所选环境和项目级全局\n * 变量；第二个仅命中配置、脚本、测试与 CLI 等工程文件，为它们配置 Node.js 全局变量\n * 并允许使用 `console`。分离范围可以减少跨运行时的假阴性。\n */\nexport const createEnvironmentConfigs = ({\n\tenvironment = \"browser\",\n\tfiles = GLOBS_CODE,\n\tnodeFiles = GLOBS_JAVASCRIPT,\n\tglobals: projectGlobals = {},\n}: EnvironmentConfigOptions = {}) => {\n\tconst runtimeGlobals = {\n\t\t...(environment !== \"node\" ? globals.browser : {}),\n\t\t...(environment !== \"browser\" ? globals.node : {}),\n\t\t...projectGlobals,\n\t};\n\tconst nodeToolingFiles = GLOBS_NODE_TOOLING.flatMap((nodeGlob) => nodeFiles.map((fileGlob) => [nodeGlob, fileGlob]));\n\n\treturn defineConfig([\n\t\t{\n\t\t\tname: `@fast-china/globals/${environment}`,\n\t\t\tfiles: [...files],\n\t\t\tlanguageOptions: {\n\t\t\t\tglobals: runtimeGlobals,\n\t\t\t},\n\t\t},\n\t\t{\n\t\t\tname: \"@fast-china/globals/node-tooling\",\n\t\t\tfiles: nodeToolingFiles,\n\t\t\tlanguageOptions: {\n\t\t\t\tglobals: globals.node,\n\t\t\t},\n\t\t\trules: {\n\t\t\t\t\"no-console\": \"off\",\n\t\t\t},\n\t\t},\n\t]);\n};\n"],"mappings":";;;;;;;;;;;AAgEA,MAAa,4BAA4B,EACxC,cAAc,WACd,QAAQ,YACR,YAAY,kBACZ,SAAS,iBAAiB,CAAC,MACE,CAAC,MAAM;CACpC,MAAM,iBAAiB;EACtB,GAAI,gBAAgB,SAAS,QAAQ,UAAU,CAAC;EAChD,GAAI,gBAAgB,YAAY,QAAQ,OAAO,CAAC;EAChD,GAAG;CACJ;CACA,MAAM,mBAAmB,mBAAmB,SAAS,aAAa,UAAU,KAAK,aAAa,CAAC,UAAU,QAAQ,CAAC,CAAC;CAEnH,OAAO,aAAa,CACnB;EACC,MAAM,uBAAuB;EAC7B,OAAO,CAAC,GAAG,KAAK;EAChB,iBAAiB,EAChB,SAAS,eACV;CACD,GACA;EACC,MAAM;EACN,OAAO;EACP,iBAAiB,EAChB,SAAS,QAAQ,KAClB;EACA,OAAO,EACN,cAAc,MACf;CACD,CACD,CAAC;AACF"}
+{"version":3,"file":"environment.mjs","names":[],"sources":["../../src/configs/environment.ts"],"sourcesContent":["import { defineConfig } from \"eslint/config\";\nimport globals from \"globals\";\n\nimport { GLOBS_CODE, GLOBS_JAVASCRIPT, GLOBS_NODE_TOOLING } from \"../constants\";\n\nimport type { Linter } from \"eslint\";\n\n/**\n * 应用源码可声明的运行时环境。\n *\n * - `\"browser\"` 仅提供浏览器全局变量。\n * - `\"node\"` 仅提供 Node.js 全局变量。\n * - `\"universal\"` 同时提供浏览器与 Node.js 全局变量。\n */\nexport type RuntimeEnvironment = \"browser\" | \"node\" | \"universal\";\n\n/**\n * 运行时全局变量配置片段的选项。\n *\n * @remarks\n * `fastConfig()` 会根据已启用的语言和框架计算 `files`、`nodeFiles`，再调用\n * `createEnvironmentConfigs()`。该接口仍保持独立，以便环境片段的输入、默认值和文件\n * 范围在源码中具有明确契约；直接组合配置片段时可从 `./configs` 子路径使用。\n *\n * 应用代码与 Node.js 工程文件使用两个独立 Flat Config 片段，避免浏览器源码无条件获得\n * `process`、`Buffer` 等 Node.js 全局变量，也避免配置文件误报这些合法全局变量未定义。\n */\nexport interface EnvironmentConfigOptions {\n\t/**\n\t * 应用代码实际运行的环境，决定 `files` 范围内注入哪组标准全局变量。\n\t *\n\t * `\"browser\"` 只注入浏览器全局变量，`\"node\"` 只注入 Node.js 全局变量，\n\t * `\"universal\"` 同时注入两组。该值不会影响 `nodeFiles` 对应的工程文件；后者始终\n\t * 使用 Node.js 全局变量。\n\t * @defaultValue `\"browser\"`\n\t */\n\tenvironment?: RuntimeEnvironment;\n\t/**\n\t * 需要获得所选运行时全局变量的应用代码 glob 列表。\n\t *\n\t * 工厂会把当前启用的 JavaScript、TypeScript 和 Vue 文件范围传入这里。数组会复制到\n\t * 生成配置中，不会在函数内部修改调用方传入的值。\n\t * @defaultValue {@link GLOBS_CODE}\n\t */\n\tfiles?: readonly string[];\n\t/**\n\t * 当前启用且允许作为 Node.js 工程文件执行的脚本扩展名 glob 列表。\n\t *\n\t * 每一项都会与内置的配置文件、脚本目录、测试文件和 CLI 文件模式组合为 ESLint\n\t * Flat Config 的 AND 文件条件。例如顶层关闭 TypeScript 后，Node.js 工程片段也不会\n\t * 因自身模式较宽而意外接管 `.ts` 文件。\n\t * @defaultValue {@link GLOBS_JAVASCRIPT}\n\t */\n\tnodeFiles?: readonly string[];\n\t/**\n\t * 追加到应用代码环境中的项目级全局变量及其读写权限。\n\t *\n\t * 该记录在标准环境全局变量之后合并，所以同名条目可以覆盖预置权限。它应用于完整\n\t * `files` 范围；其中属于 Node.js 工程文件的子集还会由后续片段追加标准 Node.js 全局\n\t * 变量。值格式遵循 ESLint `Linter.Globals`。\n\t * @defaultValue `{}`\n\t */\n\tglobals?: Linter.Globals;\n}\n\n/**\n * 创建运行时环境相关的 ESLint 配置。\n *\n * @remarks\n * 返回两个相互独立的 Flat Config 片段：第一个为应用源码配置所选环境和项目级全局\n * 变量；第二个仅命中配置、脚本、测试与 CLI 等工程文件，为它们配置 Node.js 全局变量\n * 并允许使用 `console`。分离范围可以减少跨运行时的假阴性。\n *\n * @param options - 运行时环境、目标文件范围与项目级全局变量。\n * @returns 依次包含应用运行时环境和 Node.js 工程文件环境的 Flat Config 数组。\n */\nexport const createEnvironmentConfigs = ({\n\tenvironment = \"browser\",\n\tfiles = GLOBS_CODE,\n\tnodeFiles = GLOBS_JAVASCRIPT,\n\tglobals: projectGlobals = {},\n}: EnvironmentConfigOptions = {}) => {\n\tconst runtimeGlobals = {\n\t\t...(environment !== \"node\" ? globals.browser : {}),\n\t\t...(environment !== \"browser\" ? globals.node : {}),\n\t\t...projectGlobals,\n\t};\n\tconst nodeToolingFiles = GLOBS_NODE_TOOLING.flatMap((nodeGlob) => nodeFiles.map((fileGlob) => [nodeGlob, fileGlob]));\n\n\treturn defineConfig([\n\t\t{\n\t\t\tname: `@fast-china/globals/${environment}`,\n\t\t\tfiles: [...files],\n\t\t\tlanguageOptions: {\n\t\t\t\tglobals: runtimeGlobals,\n\t\t\t},\n\t\t},\n\t\t{\n\t\t\tname: \"@fast-china/globals/node-tooling\",\n\t\t\tfiles: nodeToolingFiles,\n\t\t\tlanguageOptions: {\n\t\t\t\tglobals: globals.node,\n\t\t\t},\n\t\t\trules: {\n\t\t\t\t\"no-console\": \"off\",\n\t\t\t},\n\t\t},\n\t]);\n};\n"],"mappings":";;;;;;;;;;;;;;;AA4EA,MAAa,4BAA4B,EACxC,cAAc,WACd,QAAQ,YACR,YAAY,kBACZ,SAAS,iBAAiB,CAAC,MACE,CAAC,MAAM;CACpC,MAAM,iBAAiB;EACtB,GAAI,gBAAgB,SAAS,QAAQ,UAAU,CAAC;EAChD,GAAI,gBAAgB,YAAY,QAAQ,OAAO,CAAC;EAChD,GAAG;CACJ;CACA,MAAM,mBAAmB,mBAAmB,SAAS,aAAa,UAAU,KAAK,aAAa,CAAC,UAAU,QAAQ,CAAC,CAAC;CAEnH,OAAO,aAAa,CACnB;EACC,MAAM,uBAAuB;EAC7B,OAAO,CAAC,GAAG,KAAK;EAChB,iBAAiB,EAChB,SAAS,eACV;CACD,GACA;EACC,MAAM;EACN,OAAO;EACP,iBAAiB,EAChB,SAAS,QAAQ,KAClB;EACA,OAAO,EACN,cAAc,MACf;CACD,CACD,CAAC;AACF"}

package/dist/configs/ignores.d.mts

@@ -2,13 +2,27 @@
 /**
  * 默认忽略依赖、构建结果、缓存、生成文件和包管理器锁文件。
  *
+ * @remarks
  * 不忽略 `src`、`public`、测试夹具或普通 Markdown 文档，避免共享配置静默漏检
  * 应由项目维护的文件。
  */
 declare const DEFAULT_IGNORE_PATTERNS: readonly string[];
-/** 创建全局忽略配置，并在默认集合之后追加项目自定义模式。 */
+/**
+ * 创建全局忽略配置，并在默认集合之后追加项目自定义模式。
+ *
+ * @param additionalPatterns - 追加到 {@link DEFAULT_IGNORE_PATTERNS} 之后的 ESLint 全局忽略模式。
+ * @returns 包含单个命名全局忽略片段的 Flat Config 数组。
+ */
 declare const createGlobalIgnores: (additionalPatterns?: readonly string[]) => import("eslint/config").ConfigObject[];
-/** 读取运行 ESLint 的项目根目录中的 `.gitignore`。 */
+/**
+ * 创建读取项目 `.gitignore` 的全局忽略配置。
+ *
+ * @remarks
+ * `.gitignore` 的查找位置由 `eslint-config-flat-gitignore` 根据 ESLint 当前工作目录确定。
+ * 未找到文件时不会抛错；该片段也不会替代 {@link createGlobalIgnores} 的内置模式。
+ *
+ * @returns 包含 `.gitignore` 转换结果的 Flat Config 数组。
+ */
 declare const createGitignoreConfigs: () => import("eslint/config").ConfigObject[];
 //#endregion
 export { DEFAULT_IGNORE_PATTERNS, createGitignoreConfigs, createGlobalIgnores };

package/dist/configs/ignores.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"ignores.d.mts","names":[],"sources":["../../src/configs/ignores.ts"],"mappings":";;;;;;;cAWa;;cAaA,sBAAuB,mEAA0C;;cAIjE,sDAAsB"}
+{"version":3,"file":"ignores.d.mts","names":[],"sources":["../../src/configs/ignores.ts"],"mappings":";;;;;;;;cAYa;;;;;;;cAkBA,sBAAuB,mEAA0C;;;;;;;;;;cAYjE,sDAAsB"}

package/dist/configs/ignores.mjs

@@ -5,6 +5,7 @@ import eslintConfigFlatGitignore from "eslint-config-flat-gitignore";
 /**
 * 默认忽略依赖、构建结果、缓存、生成文件和包管理器锁文件。
 *
+* @remarks
 * 不忽略 `src`、`public`、测试夹具或普通 Markdown 文档，避免共享配置静默漏检
 * 应由项目维护的文件。
 */
@@ -19,9 +20,22 @@ const DEFAULT_IGNORE_PATTERNS = Object.freeze([
 	"**/components.d.ts",
 	...GLOBS_LOCKFILES
 ]);
-/** 创建全局忽略配置，并在默认集合之后追加项目自定义模式。 */
+/**
+* 创建全局忽略配置，并在默认集合之后追加项目自定义模式。
+*
+* @param additionalPatterns - 追加到 {@link DEFAULT_IGNORE_PATTERNS} 之后的 ESLint 全局忽略模式。
+* @returns 包含单个命名全局忽略片段的 Flat Config 数组。
+*/
 const createGlobalIgnores = (additionalPatterns = []) => defineConfig([globalIgnores([...DEFAULT_IGNORE_PATTERNS, ...additionalPatterns], "@fast-china/ignores/global")]);
-/** 读取运行 ESLint 的项目根目录中的 `.gitignore`。 */
+/**
+* 创建读取项目 `.gitignore` 的全局忽略配置。
+*
+* @remarks
+* `.gitignore` 的查找位置由 `eslint-config-flat-gitignore` 根据 ESLint 当前工作目录确定。
+* 未找到文件时不会抛错；该片段也不会替代 {@link createGlobalIgnores} 的内置模式。
+*
+* @returns 包含 `.gitignore` 转换结果的 Flat Config 数组。
+*/
 const createGitignoreConfigs = () => defineConfig([{
 	name: "@fast-china/ignores/git",
 	...eslintConfigFlatGitignore({ strict: false })

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\";\n\nimport { GLOBS_LOCKFILES } from \"../constants\";\n\n/**\n * 默认忽略依赖、构建结果、缓存、生成文件和包管理器锁文件。\n *\n * 不忽略 `src`、`public`、测试夹具或普通 Markdown 文档，避免共享配置静默漏检\n * 应由项目维护的文件。\n */\nexport const DEFAULT_IGNORE_PATTERNS = Object.freeze([\n\t\"**/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/** 创建全局忽略配置，并在默认集合之后追加项目自定义模式。 */\nexport const createGlobalIgnores = (additionalPatterns: readonly string[] = []) =>\n\tdefineConfig([globalIgnores([...DEFAULT_IGNORE_PATTERNS, ...additionalPatterns], \"@fast-china/ignores/global\")]);\n\n/** 读取运行 ESLint 的项目根目录中的 `.gitignore`。 */\nexport const createGitignoreConfigs = () =>\n\tdefineConfig([\n\t\t{\n\t\t\tname: \"@fast-china/ignores/git\",\n\t\t\t...eslintConfigFlatGitignore({ strict: false }),\n\t\t},\n\t]);\n"],"mappings":";;;;;;;;;;AAWA,MAAa,0BAA0B,OAAO,OAAO;CACpD;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA,GAAG;AACJ,CAAC;;AAGD,MAAa,uBAAuB,qBAAwC,CAAC,MAC5E,aAAa,CAAC,cAAc,CAAC,GAAG,yBAAyB,GAAG,kBAAkB,GAAG,4BAA4B,CAAC,CAAC;;AAGhH,MAAa,+BACZ,aAAa,CACZ;CACC,MAAM;CACN,GAAG,0BAA0B,EAAE,QAAQ,MAAM,CAAC;AAC/C,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\";\n\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\"**/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[] = []) =>\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 = () =>\n\tdefineConfig([\n\t\t{\n\t\t\tname: \"@fast-china/ignores/git\",\n\t\t\t...eslintConfigFlatGitignore({ strict: false }),\n\t\t},\n\t]);\n"],"mappings":";;;;;;;;;;;AAYA,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,MAAM;CACN,GAAG,0BAA0B,EAAE,QAAQ,MAAM,CAAC;AAC/C,CACD,CAAC"}