@fast-china/eslint-config 2.1.8 → 2.1.10

package/CHANGELOG.md

@@ -1,12 +1,28 @@
 # Changelog
 
-All notable changes to this project will be documented in this file.
+All notable changes to this project are documented in this file.
 
 The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and releases should follow [Semantic Versioning](https://semver.org/).
 
-## Unreleased
+## [2.1.10] - 2026-09-22
 
-## 2.1.8 - 2026-09-12
+### Fixed
+
+- Exclude root and nested `.agents` directories and `skills-lock.json` from the shared default ignores; keep Prettier ignores independent.
+
+### Documentation and Tooling
+
+- Correct localized Fast.Docs links and retain minimal README examples.
+- Align public-contract comments and agent guidance; keep licenses and `.editorconfig` unchanged.
+- Keep ESLint and Prettier skill-file ignores separate and add regression checks.
+
+## [2.1.9] - 2026-09-14
+
+### Changed
+
+- Disabled `@typescript-eslint/switch-exhaustiveness-check` for Vue single-file components while retaining the error-level check for regular TypeScript and TSX files.
+
+## [2.1.8] - 2026-09-12
 
 ### Added
 
@@ -31,7 +47,7 @@ The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and
 - Removed the 2.x default export, `fastConfig()`, and `FastConfigOptions`; consumers now select the Vue or UniApp named configuration explicitly.
 - Removed Vue-to-UniApp capability leakage from the new Vue-only entry and removed `prefer-object-has-own` from the defaults.
 
-## 2.1.7 - 2026-09-11
+## [2.1.7] - 2026-09-11
 
 ### Added
 
@@ -41,7 +57,7 @@ The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and
 
 - Allowed Promise-returning event handlers in Vue templates and TSX attributes while retaining all other `no-misused-promises` checks.
 
-## 2.1.6 - 2026-09-11
+## [2.1.6] - 2026-09-11
 
 ### Added
 
@@ -57,31 +73,31 @@ The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and
 - Reduced syntax-only enforcement for type declarations, indexed objects, literal class properties, RegExp calls, dynamic object deletion, and static utility classes; deprecated APIs and apparently unnecessary runtime guards now warn instead of blocking builds.
 - Updated runtime and development dependencies to their latest compatible releases while retaining TypeScript 6, tsdown 0.22, and the existing peer compatibility ranges.
 
-## 2.1.5 - 2026-09-01
+## [2.1.5] - 2026-09-01
 
 ### Changed
 
 - Unified `extraFileExtensions: [".vue", ".nvue"]` across type-aware TypeScript, TSX, Vue, and NVue parsing so Project Service does not reload the project while linting mixed file types.
 
-## 2.1.4 - 2026-08-30
+## [2.1.4] - 2026-08-30
 
 ### Changed
 
 - Classified `@/**` root aliases as leading internal imports and moved the `type` group after every other non-style import group, while styles remain in their final stable group.
 
-## 2.1.3 - 2026-08-29
+## [2.1.3] - 2026-08-29
 
 ### Changed
 
 - Enabled `import-x/order` `sortTypesGroup` so separate type imports retain the final type group while sorting by their original source category within it.
 
-## 2.1.2 - 2026-08-29
+## [2.1.2] - 2026-08-29
 
 ### Changed
 
 - Changed `@typescript-eslint/consistent-type-imports` fixes from inline type specifiers to separate `import type` declarations.
 
-## 2.1.1 - 2026-08-29
+## [2.1.1] - 2026-08-29
 
 ### Added
 
@@ -92,7 +108,7 @@ The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and
 - Expanded the inline documentation for local ESLint rules and scoped overrides, including their purpose, important exceptions, and ownership of duplicate React checks.
 - Excluded stylesheet imports from `import-x/order` while preserving its grouping, alphabetizing, and `warnOnUnassignedImports` checks for all other imports.
 
-## 2.1.0 - 2026-08-26
+## [2.1.0] - 2026-08-26
 
 ### Added
 
@@ -119,27 +135,27 @@ The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and
 
 - Removed `defaultConfigOptions`, root language/framework/plugin switches, factory-level rules/globals/ignores, `typeChecked`, and `tsconfigRootDir`. Native trailing Flat Config and focused factories replace these wrapper options.
 
-## 2.0.10 - 2026-08-19
+## [2.0.10] - 2026-08-19
 
 ### Changed
 
 - Changed the default export to a ready-to-use Flat Config array that can be exported directly or spread into another configuration; configurable usage remains available through the named `fastConfig()` export.
 - Enabled Markdown, `package.json` sorting, and `tsconfig*.json` sorting by default while keeping React and Angular disabled by default.
 
-## 2.0.9 - 2026-08-10
+## [2.0.9] - 2026-08-10
 
 ### Changed
 
 - Allowed type-aware TypeScript configurations to forward `unknown` Promise rejection reasons without disabling `prefer-promise-reject-errors` for statically known non-`Error` values.
 
-## 2.0.8 - 2026-08-09
+## [2.0.8] - 2026-08-09
 
 ### Changed
 
 - Added prioritized import path groups for the uni-app, Vue, Element Plus, Fast Element Plus, Fast China, and Lodash ecosystems while keeping type-only imports in the dedicated type group.
 - Changed import group spacing to a compact no-blank-line style and normalized the repository imports to the new policy.
 
-## 2.0.7 - 2026-08-08
+## [2.0.7] - 2026-08-08
 
 ### Changed
 
@@ -147,7 +163,7 @@ The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and
 - Removed `src` and declaration maps that referenced unpublished source files while retaining self-contained runtime source maps.
 - Added package-contract coverage for the publish allowlist and source-map integrity.
 
-## 2.0.6 - 2026-08-04
+## [2.0.6] - 2026-08-04
 
 ### Changed
 
@@ -155,14 +171,14 @@ The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and
 - 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
+## [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
+## [2.0.4] - 2026-08-02
 
 ### Added
 
@@ -178,21 +194,21 @@ The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and
 - Changed `createGlobalIgnores()` to return a config array like the other fragment factories, so direct composition consistently uses spread syntax.
 - Updated `@eslint-react/eslint-plugin`, `@eslint/config-inspector`, and `globals` within their existing compatible version ranges.
 
-## 2.0.3 - 2026-07-29
+## [2.0.3] - 2026-07-29
 
 ### Changed
 
 - Renamed the internal factory directory from `src/code` to the clearer `src/core` and updated all source and type-generation imports.
 - Expanded JSDoc for public and internal configuration interfaces, covering defaults, activation conditions, file scopes, option interactions, performance tradeoffs, and behavior intentionally left to project tooling.
 
-## 2.0.2 - 2026-07-29
+## [2.0.2] - 2026-07-29
 
 ### Changed
 
 - Moved the `fastConfig()` factory implementation to `src/code/index.ts` so the source layout groups the primary code entry consistently.
 - Inlined `defineRules()` into the root entry and kept `@fast-china/eslint-config/rules` focused on the documented raw rule records and generated `RuleOptions` type.
 
-## 2.0.1 - 2026-07-26
+## [2.0.1] - 2026-07-26
 
 ### Added
 
@@ -206,7 +222,7 @@ The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and
 - Raised the verified runtime baselines to Node.js 22.18.0 and 24.11.0 to match the current tsdown toolchain.
 - Updated the development baseline to ESLint 10.8.0, then upgraded `actions/checkout` plus `actions/setup-node` to their current v7 major releases.
 
-## 2.0.0 - 2026-07-26
+## [2.0.0] - 2026-07-26
 
 ### Added
 
@@ -224,3 +240,26 @@ The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and
 
 - Raised the minimum supported Node.js version to 22.13.0 so the package, local development workflow, and pnpm 11 CI use one consistent runtime baseline.
 - Upgraded `pnpm/action-setup` to v6 so GitHub Actions uses its Node.js 24 runtime without Node.js 20 deprecation warnings.
+
+[2.1.10]: https://gitee.com/FastDotnet/fast.eslint.config/compare/v2.1.9...v2.1.10
+[2.1.9]: https://gitee.com/FastDotnet/fast.eslint.config/compare/v2.1.8...v2.1.9
+[2.1.8]: https://gitee.com/FastDotnet/fast.eslint.config/compare/v2.1.7...v2.1.8
+[2.1.7]: https://gitee.com/FastDotnet/fast.eslint.config/compare/v2.1.6...v2.1.7
+[2.1.6]: https://gitee.com/FastDotnet/fast.eslint.config/compare/v2.1.5...v2.1.6
+[2.1.5]: https://gitee.com/FastDotnet/fast.eslint.config/compare/v2.1.4...v2.1.5
+[2.1.4]: https://gitee.com/FastDotnet/fast.eslint.config/compare/v2.1.3...v2.1.4
+[2.1.3]: https://gitee.com/FastDotnet/fast.eslint.config/compare/v2.1.2...v2.1.3
+[2.1.2]: https://gitee.com/FastDotnet/fast.eslint.config/compare/v2.1.1...v2.1.2
+[2.1.1]: https://gitee.com/FastDotnet/fast.eslint.config/compare/v2.1.0...v2.1.1
+[2.1.0]: https://gitee.com/FastDotnet/fast.eslint.config/compare/v2.0.10...v2.1.0
+[2.0.10]: https://gitee.com/FastDotnet/fast.eslint.config/compare/v2.0.9...v2.0.10
+[2.0.9]: https://gitee.com/FastDotnet/fast.eslint.config/compare/v2.0.8...v2.0.9
+[2.0.8]: https://gitee.com/FastDotnet/fast.eslint.config/compare/v2.0.7...v2.0.8
+[2.0.7]: https://gitee.com/FastDotnet/fast.eslint.config/compare/v2.0.6...v2.0.7
+[2.0.6]: https://gitee.com/FastDotnet/fast.eslint.config/compare/v2.0.5...v2.0.6
+[2.0.5]: https://gitee.com/FastDotnet/fast.eslint.config/compare/v2.0.4...v2.0.5
+[2.0.4]: https://gitee.com/FastDotnet/fast.eslint.config/compare/v2.0.3...v2.0.4
+[2.0.3]: https://gitee.com/FastDotnet/fast.eslint.config/compare/v2.0.2...v2.0.3
+[2.0.2]: https://gitee.com/FastDotnet/fast.eslint.config/compare/v2.0.1...v2.0.2
+[2.0.1]: https://gitee.com/FastDotnet/fast.eslint.config/compare/v2.0.0...v2.0.1
+[2.0.0]: https://gitee.com/FastDotnet/fast.eslint.config/releases/tag/v2.0.0

package/CONTRIBUTING.md

@@ -30,7 +30,7 @@ Use `pnpm lint:fix` and `pnpm format` for safe mechanical fixes. `pnpm test` fir
 5. Preserve the documented JavaScript, TypeScript, and Vue behavior unless a release explicitly changes it; keep historical comparisons in the changelog rather than source comments.
 6. Keep organization-specific dependency restrictions out of this general-purpose package; projects should own those policies.
 7. Explain the purpose, rationale, and important exception or risk immediately above every local rule override.
-8. Document every default rule's severity and valid exceptions; every generated rule entry must have explicitly reviewed incorrect and correct code rather than placeholder comments. Keep repository overrides before third-party preset rules, verify `meta.fixable` before claiming auto-fix support, run `pnpm run docs:rules` after any rule or dependency change, and keep `docs/rules-risk.md` plus `docs/rules-risk.zh.md` synchronized.
+8. Document every default rule's severity and valid exceptions; every generated rule entry must have explicitly reviewed incorrect and correct code rather than placeholder comments. Keep repository overrides before third-party preset rules, verify `meta.fixable` before claiming auto-fix support, run `pnpm run docs:rules` after any rule or dependency change, and keep [rules-risk.en](http://docs.fastdotnet.cn/en-US/frontend/eslint-config/rules-risk) plus [rules-risk](http://docs.fastdotnet.cn/zh-CN/frontend/eslint-config/rules-risk) synchronized.
 9. Never sort a map whose key order has semantics, including conditional objects under `package.json#exports`.
 10. Regenerate `src/typegen.d.ts` whenever ESLint or a bundled plugin changes; confirm new rules and changed option schemas intentionally.
 11. 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 the Vue, UniApp, and framework-neutral project factories, their ready configurations, `defineRules`, and related types.

package/README.md

@@ -1,16 +1,20 @@
-<p align="left">
-	<a href="./README.zh.md">简体中文</a> | <strong>English</strong>
-</p>
+[简体中文](./README.zh.md) | **English**
 
 <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>
 
-A practical ESLint Flat Config for Vue 3, UniApp, SDKs, Node.js, React, Angular, TypeScript, and JavaScript projects.
+Typed ESLint Flat Config for Vue 3, uni-app, TypeScript and Node.js, with optional framework integrations.
 
-The policy starts from common ecosystem conventions and concise, readable code. It then prioritizes real bugs and type safety, consistency, and finally Fast project preferences. It does not force unusual rewrites merely to satisfy ESLint.
+**[Documentation](http://docs.fastdotnet.cn/en-US/frontend/eslint-config/) · [Official website](http://fastdotnet.com)**
 
 ## Highlights
 
@@ -28,118 +32,61 @@ The policy starts from common ecosystem conventions and concise, readable code.
 - ESLint `^10.0.0`
 - TypeScript `^6.0.0`
 
+## Installation
+
 ```sh
 pnpm add -D eslint typescript @fast-china/eslint-config
 ```
 
-## Vue 3
-
-```js
-import { vueConfig } from "@fast-china/eslint-config";
-
-export default vueConfig;
-```
-
-This entry covers JavaScript, type-aware TypeScript, Vue SFCs, and standalone `.jsx`/`.tsx` components used by Vue projects. Vue JSX/TSX keeps checks for explicit emits, duplicate keys, readonly props, reactivity loss, and reserved component names without inheriting template-only kebab-case, attribute-order, or `v-text`/`v-html` rules. The entry also includes JSON, Import, RegExp, `.gitignore`, and Prettier compatibility without loading UniApp capabilities.
+## Quick start
 
-## UniApp
+Create `eslint.config.mjs` in the Vue 3 project:
 
 ```js
-import { uniAppConfig } from "@fast-china/eslint-config";
-
-export default uniAppConfig;
-```
-
-The UniApp entry adds `.nvue`, `uni`, `uniCloud`, page APIs, conditional-platform globals, the `unpackage` ignore, and comment handling for `pages.json` and `manifest.json`.
-
-ESLint does not execute `#ifdef` or `#endif`, so it can recognize platform objects but cannot prove that they occur in the correct branch. `.uvue` and `.uts` remain unsupported because they require dedicated parsers.
-
-## Factories and project overrides
-
-The root entry provides explicit named configurations and factories. Use a factory when the project needs to select its runtime environment or append overrides:
-
-```js
-import { createVueProjectConfigs, defineRules } from "@fast-china/eslint-config";
+import { vueConfig } from "@fast-china/eslint-config";
+import { defineConfig } from "eslint/config";
 
-export default createVueProjectConfigs(
-	{ environment: "universal" },
+export default defineConfig([
+	...vueConfig,
 	{
-		ignores: ["public/vendor/**"],
-		languageOptions: {
-			globals: {
-				__APP_VERSION__: "readonly",
-			},
-		},
-		rules: defineRules({
-			"no-console": "warn",
-		}),
-	}
-);
+		name: "project/custom",
+		rules: {},
+	},
+]);
 ```
 
-Available factories:
-
-- `createVueProjectConfigs(options, ...overrides)`
-- `createUniAppProjectConfigs(options, ...overrides)`
-- `createBaseConfigs(options)` for framework-neutral Node.js, SDK, and explicit composition
-
-`environment` accepts `"browser"`, `"node"`, or `"universal"` and defaults to `"browser"`. Configuration, script, test, and CLI files always receive Node.js globals separately.
-
-Trailing Flat Config objects have the highest precedence. `defineRules()` returns its input unchanged and only adds precise rule typing.
-
-## TypeScript policy
-
-Type-aware files must belong to a `tsconfig.json` discoverable by Project Service.
-
-- `explicit-module-boundary-types: "error"` requires explicit parameter and return types for exported `.ts`, `.mts`, and `.cts` functions and public boundaries of exported classes.
-- `.tsx` disables the module-boundary annotation requirement by default: component props remain type checked without forcing an otherwise inferable JSX return annotation.
-- `explicit-function-return-type: "off"` leaves internal functions, local handlers, and inline callbacks to TypeScript inference.
-- `no-inferrable-types` preserves explicit parameter and property types.
-- Vue/NVue SFCs and standalone TSX components do not require module-boundary or function-return annotations, retaining common concise component forms.
-- `no-floating-promises` is disabled because Promise waiting depends on business ordering and error semantics.
-- `no-void: "error"` rejects `void promise` and other `void` expressions as lint workarounds.
-- `require-await: "error"` requires removing `async` when there is no real `await`, avoiding changed return and exception semantics.
-- `no-misused-promises`, `await-thenable`, unsafe-type rules, and selected high-confidence type rules remain errors.
-- Standard non-null assertions are permitted; contradictory, redundant, or invalid assertions remain checked by focused rules.
-- Numbers and booleans may be interpolated directly in template strings, and runtime guards are not rejected merely because types make them look unnecessary.
+```sh
+pnpm exec eslint .
+```
 
-## JavaScript, Import, and Vue policy
+Type-aware source files must belong to the project tsconfig. The Vue configuration does not include uni-app capabilities.
 
-- `no-empty` permits a completely empty `catch` while reporting other empty blocks.
-- `camelcase: ["error", { properties: "never" }]` applies to variables and types while preserving external protocol property names.
-- Real-risk rules such as `no-eval`, `no-implied-eval`, `no-new-func`, and `no-debugger` remain errors.
-- `import-x/first`, `import-x/no-duplicates`, and `import-x/order` are errors; declaration ordering supports automatic fixes.
-- Common path groups cover UniApp, Vue, React, Angular, Vite, Element Plus, Fast, and Lodash. `@/**` is internal, and type imports do not participate in path-group matching.
-- `sort-imports` checks only member order inside one import declaration and does not order declarations.
-- `import-x/style-imports-last` keeps stylesheets in the final contiguous group without reordering that group internally.
-- Vue SFCs use the official `flat/recommended`; script-semantic checks for explicit emits, duplicate keys, readonly props, reactivity loss, and reserved component names also apply to Vue JSX/TSX.
-- Kebab-case attributes, template attribute ordering, and component `v-text`/`v-html` remain limited to `.vue/.nvue` templates; JSX attributes retain JavaScript camelCase conventions. `no-v-html` remains a warning.
+## Common usage
 
-## React and Angular
+Use the independent uni-app entry rather than stacking both complete configurations:
 
 ```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()]);
+export default defineConfig([
+	...uniAppConfig,
+	{
+		name: "project/custom",
+		rules: {},
+	},
+]);
 ```
 
-Angular composes `createAngularConfigs()` in the same way. The base configuration loads neither Vue nor UniApp.
-
-## Optional capabilities and manifest sorting
-
-Markdown and Lodash import policy require explicit composition:
+For framework-independent Node.js projects:
 
 ```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()]);
+export default createBaseConfigs({ environment: "node" });
 ```
 
-`createBaseConfigs()`, `vueConfig`, and `uniAppConfig` all enable `package.json` and `tsconfig*.json` sorting by default. Package sorting does not enter conditional `exports` objects whose order has runtime meaning.
+Append project configuration after the shared preset; leave `rules: {}` empty until project-specific rules are needed. Use the configuration factories to customize the runtime environment. Fast repositories maintaining local rule copies continue following their own AGENTS.md synchronization policy.
 
 ## Public entries
 
@@ -154,8 +101,8 @@ Prettier does not run as an ESLint rule. The defaults only load `eslint-config-p
 
 ## Documentation
 
-- [Complete rule reference (Chinese)](./docs/rules/index.zh.md)
-- [Default rules and risk guide](./docs/rules-risk.md)
+- [Complete rule reference (Chinese)](http://docs.fastdotnet.cn/en-US/frontend/eslint-config/rules/)
+- [Default rules and risk guide](http://docs.fastdotnet.cn/en-US/frontend/eslint-config/rules-risk)
 - [Chinese engineering audit](./docs/engineering-audit.zh.md)
 - [Changelog](./CHANGELOG.md)
 
@@ -168,3 +115,17 @@ pnpm install --frozen-lockfile
 pnpm typegen
 pnpm check
 ```
+
+## Contribution and security
+
+[Contributing](./CONTRIBUTING.md) · [Security policy](./SECURITY.md)
+
+## Copyright, license and use
+
+Copyright © 2018-Now 小方. This project uses [Apache License 2.0](./LICENSE). Use, modification, distribution and commercial use are permitted subject to its terms.
+
+When redistributing, provide the license, mark modified files and preserve applicable copyright, attribution and supplied NOTICE information as required. This summary does not replace the license or impose additional UI attribution.
+
+Users are responsible for the legal compliance and authorization of their own modifications, deployment, data processing and operations. This reminder is not an additional license condition.
+
+Except as required by applicable law or agreed in writing, the software is provided on an "AS IS" basis. Sections 7 and 8 govern warranty disclaimers and liability limits. Providing the project does not endorse downstream activities or assume users' contractual commitments. This statement does not exclude liability that cannot lawfully be excluded.

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,118 +32,61 @@
 - ESLint `^10.0.0`
 - TypeScript `^6.0.0`
 
+## 安装
+
 ```sh
 pnpm add -D eslint typescript @fast-china/eslint-config
 ```
 
-## Vue 3
-
-```js
-import { vueConfig } from "@fast-china/eslint-config";
-
-export default vueConfig;
-```
-
-该入口处理 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
+在 Vue 3 项目中创建 `eslint.config.mjs`：
 
 ```js
-import { uniAppConfig } from "@fast-china/eslint-config";
-
-export default uniAppConfig;
-```
-
-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 { vueConfig } from "@fast-china/eslint-config";
+import { defineConfig } from "eslint/config";
 
-export default createVueProjectConfigs(
-	{ environment: "universal" },
+export default defineConfig([
+	...vueConfig,
 	{
-		ignores: ["public/vendor/**"],
-		languageOptions: {
-			globals: {
-				__APP_VERSION__: "readonly",
-			},
-		},
-		rules: defineRules({
-			"no-console": "warn",
-		}),
-	}
-);
+		name: "project/custom",
+		rules: {},
+	},
+]);
 ```
 
-可用工厂：
-
-- `createVueProjectConfigs(options, ...overrides)`
-- `createUniAppProjectConfigs(options, ...overrides)`
-- `createBaseConfigs(options)`：不绑定前端框架，适用于 Node.js、SDK 及其他显式组合场景
-
-`environment` 可为 `"browser"`、`"node"` 或 `"universal"`，默认是 `"browser"`。配置文件、脚本、测试和 CLI 文件始终单独获得 Node.js globals。
-
-后置 Flat Config 拥有最高优先级。`defineRules()` 不修改传入对象，只提供精确规则类型检查。
-
-## TypeScript 策略
-
-类型感知文件必须属于 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 类型规则及精选的高置信度类型规则保持为错误。
-- 标准非空断言可用；矛盾、重复或无效的断言仍由专项规则检查。
-- 数字和布尔值可直接用于模板字符串；运行时防御性条件不会因类型看似多余而报错。
+```sh
+pnpm exec eslint .
+```
 
-## JavaScript、Import 与 Vue 策略
+类型感知检查的源码应属于项目 tsconfig 范围。Vue 配置不包含 uni-app 平台能力。
 
-- `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()]);
+export default defineConfig([
+	...uniAppConfig,
+	{
+		name: "project/custom",
+		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()]);
+export default createBaseConfigs({ environment: "node" });
 ```
 
-`createBaseConfigs()`、`vueConfig` 和 `uniAppConfig` 都默认启用 `package.json` 与 `tsconfig*.json` 排序。`package.json` 排序不会进入顺序具有运行时语义的条件 `exports` 对象。
+将项目自定义配置放在共享配置之后；`rules: {}` 留给项目按需填写。需要调整运行环境时，可使用配置工厂。Fast 生态的本地规则副本继续按各仓库 AGENTS.md 同步，不因示例而改成安装配置包。
 
 ## 公共入口
 
@@ -154,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)
 
@@ -168,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 文档，避免共享配置静默漏检