@fast-china/eslint-config 2.0.0 → 2.0.1

package/docs/rules-risk.md

@@ -11,15 +11,17 @@ This document records what the default config inherits, which rules can have a l
 
 High impact does not mean inherently unsafe. It means adoption or fix review is relatively expensive. Module side effects, getters and proxies, build-tool conventions, and public component APIs deserve particular attention.
 
-## Upstream presets enabled by default
+## Bundled preset sources
 
-`fastConfig()` defaults to Vue 3, TypeScript, JavaScript, import, RegExp, JSON, Markdown, and the Prettier compatibility layer. Type-aware TypeScript linting and manifest sorting are opt-in.
+`fastConfig()` defaults to Vue 3, TypeScript, JavaScript, import, RegExp, JSON, Markdown, and the Prettier compatibility layer. React, Angular, type-aware TypeScript linting, and manifest sorting are opt-in.
 
 | Scope                  | Inherited preset                                                                                   | Notes                                                                                                   |
 | ---------------------- | -------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------- |
 | JavaScript             | `@eslint/js` `recommended`                                                                         | Core syntax and runtime correctness, including `no-undef` and `no-unused-vars`.                         |
 | TypeScript             | typescript-eslint `recommended` + `stylistic`                                                      | Does not read type information by default; local overrides are applied afterward.                       |
 | Vue 3                  | `@eslint/js`, non-type-aware typescript-eslint presets, and `eslint-plugin-vue` `flat/recommended` | Handles Vue 3 SFCs and applies TypeScript rules to `<script lang="ts">` correctly.                      |
+| React (opt-in)         | `@eslint-react/recommended*` and `eslint-plugin-react-hooks` `flat/recommended`                    | Checks components, JSX/TSX, DOM APIs, Hooks, and stable React Compiler diagnostics.                     |
+| Angular (opt-in)       | angular-eslint 22.x TypeScript, template recommended, and template accessibility rule sets         | Checks Angular TypeScript plus external and extracted inline templates; requires TypeScript support.    |
 | Imports                | `eslint-plugin-import-x` `recommended`                                                             | Local rules add import placement, deduplication, and ordering. Resolver-dependent checks stay disabled. |
 | RegExp                 | `eslint-plugin-regexp` `flat/recommended`                                                          | Some rules can rewrite regular expressions; run tests after bulk fixes.                                 |
 | JSON dialects          | The matching `eslint-plugin-jsonc` `flat/recommended-*` preset                                     | JSON, JSONC, and JSON5 are scoped separately.                                                           |
@@ -52,11 +54,15 @@ The exact upstream rule set is defined by the dependency versions in `pnpm-lock.
 ## High-impact features not enabled by default
 
 - Type-aware TypeScript and Vue presets require `typeChecked: true`. They add project-service cost and rules such as `no-floating-promises`.
+- React requires `react: true`. Its upstream recommended and official Hooks presets include blocking component, Hooks, and React Compiler rules; review existing custom hook and memoization patterns when adopting it.
+- Angular requires `angular: true`. The framework bundle enables `prefer-inject`, OnPush change detection, standalone components, modern template control flow, and template accessibility. These policies are intentionally not active in the default Vue configuration.
 - The `jsonc/sort-keys` and `jsonc/sort-array-values` manifest rules require `sortPackageJson: true` or `sortTsconfig: true`. Isolate the first fix and verify the publish manifest.
 - Lodash import restrictions require `lodash: "lodash"` or `lodash: "lodash-unified"`. They use `no-restricted-imports` to prevent mixed static package entry points but do not inspect dynamic `import()` or CommonJS `require()`.
 - Resolver-dependent import checks such as `import-x/no-unresolved` and `import-x/named` stay disabled.
 - Keys inside `package.json#exports` are never sorted. Node conditional exports use key order during matching, so reordering can change the loaded file.
 
+When Angular is enabled, the highest-adoption-cost rules are `@angular-eslint/prefer-inject`, `@angular-eslint/prefer-on-push-component-change-detection`, `@angular-eslint/prefer-standalone`, and `@angular-eslint/template/prefer-control-flow`. Treat their fixes as framework migrations rather than formatting cleanup. Set `angular: { templateAccessibility: false }` only when accessibility is enforced by another equivalent tool; individual exceptions should normally use file-scoped trailing overrides.
+
 ## Scoped overrides
 
 Overrides must follow the shared config and should target only the affected files:

package/docs/rules-risk.zh.md

@@ -13,15 +13,17 @@
 
 “高影响”不等于规则本身不安全。它表示规则的采用成本或修复审查成本较高。默认自动修复的目标仍是保持语义，但模块副作用、getter/Proxy、构建器约定和公共组件 API 都需要项目维护者复核。
 
-## 默认继承的上游预置
+## 内置预置来源
 
-`fastConfig()` 默认开启 Vue 3、TypeScript、JavaScript、import、RegExp、JSON、Markdown 与 Prettier 兼容层；TypeScript 类型感知和清单排序默认关闭。
+`fastConfig()` 默认开启 Vue 3、TypeScript、JavaScript、import、RegExp、JSON、Markdown 与 Prettier 兼容层；React、Angular、TypeScript 类型感知和清单排序默认关闭。
 
 | 范围             | 默认继承                                                                                  | 说明                                                                             |
 | ---------------- | ----------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------- |
 | JavaScript       | `@eslint/js` 的 `recommended`                                                             | 基础语法和运行时正确性，包括 `no-undef`、`no-unused-vars` 等。                   |
 | TypeScript       | typescript-eslint 的 `recommended` + `stylistic`                                          | 默认不读取类型信息；本库规则在预置之后覆写。                                     |
 | Vue 3            | `@eslint/js`、typescript-eslint 非类型感知预置、`eslint-plugin-vue` 的 `flat/recommended` | 处理 Vue 3 单文件组件，并让 TypeScript 规则正确作用于 `<script lang="ts">`。     |
+| React（按需）    | `@eslint-react/recommended*` 与 `eslint-plugin-react-hooks` 的 `flat/recommended`         | 检查组件、JSX/TSX、DOM API、Hooks 与稳定的 React Compiler 诊断。                 |
+| Angular（按需）  | angular-eslint 22.x 的 TypeScript、模板推荐与模板无障碍规则集                             | 检查 Angular TypeScript、外部模板和提取后的内联模板；必须启用 TypeScript。       |
 | import           | `eslint-plugin-import-x` 的 `recommended`                                                 | 本库额外配置导入位置、去重和排序。解析器相关规则默认关闭，避免绑定具体别名方案。 |
 | RegExp           | `eslint-plugin-regexp` 的 `flat/recommended`                                              | 部分规则可自动改写正则表达式，批量修复后需运行测试。                             |
 | JSON/JSONC/JSON5 | `eslint-plugin-jsonc` 对应方言的 `flat/recommended-*`                                     | 三种方言按扩展名隔离，不会互相叠加。                                             |
@@ -56,11 +58,15 @@
 ## 明确不默认启用的高影响能力
 
 - TypeScript 和 Vue 的类型感知预置仅在 `typeChecked: true` 时启用；它们会增加项目服务开销，并启用 `no-floating-promises` 等需要类型信息的规则。
+- React 仅在 `react: true` 时启用。其上游推荐预置和官方 Hooks 预置包含阻断级组件、Hooks 与 React Compiler 规则；接入旧项目时应重点审查自定义 Hook 和 memoization 写法。
+- Angular 仅在 `angular: true` 时启用。框架规则默认要求 `inject()`、OnPush 变更检测、独立组件、现代模板控制流和模板无障碍；这些约束不会进入默认 Vue 配置。
 - 清单排序规则 `jsonc/sort-keys`、`jsonc/sort-array-values` 分别仅在 `sortPackageJson: true`、`sortTsconfig: true` 时启用；首次修复应单独提交并核对发布清单。
 - Lodash 静态导入限制仅在 `lodash: "lodash"` 或 `lodash: "lodash-unified"` 时启用。该策略使用 `no-restricted-imports` 阻止混用包入口，但不会检查动态 `import()` 或 CommonJS `require()`。
 - `import-x/no-unresolved`、`import-x/named` 等依赖 resolver 的检查默认关闭。
 - `package.json` 的 `exports` 条件键永不自动排序。Node 条件导出按键顺序匹配，改写顺序可能改变实际加载文件。
 
+启用 Angular 后，采用成本最高的规则是 `@angular-eslint/prefer-inject`、`@angular-eslint/prefer-on-push-component-change-detection`、`@angular-eslint/prefer-standalone` 与 `@angular-eslint/template/prefer-control-flow`。应把修复视为框架迁移，而不是格式整理。只有项目已使用等效工具保障无障碍时，才建议设置 `angular: { templateAccessibility: false }`；个别例外通常应通过末尾的文件级覆写处理。
+
 ## 按项目降低规则强度
 
 覆盖项必须放在共享配置之后，并尽量限定文件范围：

package/package.json

@@ -1,13 +1,15 @@
 {
 	"name": "@fast-china/eslint-config",
-	"version": "2.0.0",
-	"description": "Opinionated, typed ESLint Flat Config for Vue 3, Vite, TypeScript, JavaScript, and Node.js.",
+	"version": "2.0.1",
+	"description": "Opinionated, typed ESLint Flat Config for Vue 3, React, Angular, Vite, TypeScript, JavaScript, and Node.js.",
 	"type": "module",
 	"keywords": [
 		"fast",
+		"angular",
 		"eslint",
 		"eslint-config",
 		"flat-config",
+		"react",
 		"typescript",
 		"vite",
 		"vue",
@@ -32,19 +34,19 @@
 		"dist",
 		"docs"
 	],
-	"main": "./dist/index.js",
-	"module": "./dist/index.js",
-	"types": "./dist/index.d.ts",
+	"main": "./dist/index.mjs",
+	"module": "./dist/index.mjs",
+	"types": "./dist/index.d.mts",
 	"exports": {
 		".": {
-			"types": "./dist/index.d.ts",
-			"import": "./dist/index.js",
-			"default": "./dist/index.js"
+			"types": "./dist/index.d.mts",
+			"import": "./dist/index.mjs",
+			"default": "./dist/index.mjs"
 		},
 		"./rules": {
-			"types": "./dist/rules/index.d.ts",
-			"import": "./dist/rules/index.js",
-			"default": "./dist/rules/index.js"
+			"types": "./dist/rules/index.d.mts",
+			"import": "./dist/rules/index.mjs",
+			"default": "./dist/rules/index.mjs"
 		},
 		"./package.json": "./package.json"
 	},
@@ -54,7 +56,7 @@
 	},
 	"scripts": {
 		"dev": "eslint-config-inspector --config src/eslint-inspector.config.ts",
-		"build": "pnpm run typegen:check && tsup",
+		"build": "pnpm run typegen:check && tsdown",
 		"build:inspector": "eslint-config-inspector build --config src/eslint-inspector.config.ts",
 		"typegen": "tsx scripts/typegen.ts",
 		"typegen:check": "tsx scripts/typegen.ts --check",
@@ -70,15 +72,20 @@
 	},
 	"peerDependencies": {
 		"eslint": "^10.0.0",
-		"typescript": ">=5.3.0 <6.1.0"
+		"typescript": ">=6.0.0 <6.1.0"
 	},
 	"dependencies": {
+		"@angular-eslint/eslint-plugin": "^22.1.0",
+		"@angular-eslint/eslint-plugin-template": "^22.1.0",
+		"@angular-eslint/template-parser": "^22.1.0",
+		"@eslint-react/eslint-plugin": "^5.18.0",
 		"@eslint/js": "^10.0.0",
 		"@eslint/markdown": "^8.0.3",
 		"eslint-config-flat-gitignore": "^2.0.0",
 		"eslint-config-prettier": "^10.0.0",
 		"eslint-plugin-import-x": "^4.17.1",
 		"eslint-plugin-jsonc": "^3.3.0",
+		"eslint-plugin-react-hooks": "^7.1.1",
 		"eslint-plugin-regexp": "^3.1.1",
 		"eslint-plugin-vue": "^10.10.0",
 		"globals": "^17.7.0",
@@ -88,15 +95,15 @@
 	"devDependencies": {
 		"@eslint/config-inspector": "^3.1.0",
 		"@types/node": "^24.13.3",
-		"eslint": "^10.7.0",
+		"eslint": "^10.8.0",
 		"eslint-typegen": "^2.3.1",
 		"prettier": "^3.9.6",
-		"tsup": "^8.0.0",
+		"tsdown": "^0.22.14",
 		"tsx": "^4.23.1",
-		"typescript": "^5.9.0"
+		"typescript": "^6.0.3"
 	},
 	"engines": {
-		"node": "^22.13.0 || ^24.0.0",
+		"node": "^22.18.0 || >=24.11.0",
 		"pnpm": "^11.0.0"
 	}
 }

package/dist/index.d.ts

@@ -1,133 +0,0 @@
-import { R as RuleOptions } from './define-rules-CSwQ8C1q.js';
-export { d as defineRules } from './define-rules-CSwQ8C1q.js';
-import { Config } from 'eslint/config';
-import { Linter } from 'eslint';
-
-type RuntimeEnvironment = "browser" | "node" | "universal";
-
-/** 项目允许使用的 Lodash 导入来源。 */
-type LodashPreference = "lodash" | "lodash-unified";
-
-interface TypeScriptConfigOptions {
-    /**
-     * 是否启用依赖 TypeScript 类型信息的规则；开启后会增加启动和检查成本。
-     * @default false
-     */
-    typeChecked?: boolean;
-    /**
-     * 查找 tsconfig.json 的根目录。
-     *
-     * typescript-eslint 通常可从 `eslint.config.*` 调用栈推断；复杂 monorepo 可显式传入
-     * `import.meta.dirname`，避免从错误目录启动 Project Service。
-     * @default undefined
-     */
-    tsconfigRootDir?: string;
-}
-
-interface FastConfigOptions {
-    /**
-     * 应用代码的运行环境；Vue/Vite 项目通常使用 `browser`。
-     * @default "browser"
-     */
-    environment?: RuntimeEnvironment;
-    /**
-     * 项目额外提供的全局变量，例如测试运行器或宿主平台 API。
-     * @default undefined
-     */
-    globals?: Linter.Globals;
-    /**
-     * 是否读取项目根目录的 .gitignore。
-     * @default true
-     */
-    gitignore?: boolean;
-    /**
-     * 追加到内置集合的全局忽略模式。
-     * @default []
-     */
-    ignores?: readonly string[];
-    /**
-     * 是否启用 import-x 规则。
-     * @default true
-     */
-    imports?: boolean;
-    /**
-     * 是否处理 JavaScript 与 JSX 文件。
-     * @default true
-     */
-    javascript?: boolean;
-    /**
-     * 是否启用 JSON、JSONC 与 JSON5 推荐规则；清单排序由独立选项控制。
-     * @default true
-     */
-    json?: boolean;
-    /**
-     * 统一项目使用的 Lodash 包；`false` 表示不限制 `lodash`、`lodash-es` 或 `lodash-unified`。
-     * @default false
-     */
-    lodash?: false | LodashPreference;
-    /**
-     * 是否启用 Markdown 规则。
-     * @default true
-     */
-    markdown?: boolean;
-    /**
-     * 是否在末尾关闭与 Prettier 冲突的格式规则。
-     * @default true
-     */
-    prettier?: boolean;
-    /**
-     * 是否启用正则表达式规则。
-     * @default true
-     */
-    regexp?: boolean;
-    /**
-     * 应用于全部已启用代码文件的项目级规则，提供精确规则名与选项类型。
-     * @default undefined
-     */
-    rules?: RuleOptions;
-    /**
-     * 是否按安全的固定顺序整理 package.json；启用后首次运行可能产生较大 diff。
-     * @default false
-     */
-    sortPackageJson?: boolean;
-    /**
-     * 是否按 TypeScript 文档主题整理 tsconfig*.json。
-     * @default false
-     */
-    sortTsconfig?: boolean;
-    /**
-     * TypeScript 支持；传入对象可开启类型感知规则。
-     * @default true
-     */
-    typescript?: boolean | TypeScriptConfigOptions;
-    /**
-     * 是否启用 Vue 3 单文件组件支持。
-     * @default true
-     */
-    vue?: boolean;
-}
-/** `fastConfig()` 使用的稳定默认值；对象被冻结，避免运行时被意外修改。 */
-declare const defaultConfigOptions: Readonly<{
-    readonly environment: "browser";
-    readonly gitignore: true;
-    readonly imports: true;
-    readonly javascript: true;
-    readonly json: true;
-    readonly lodash: false;
-    readonly markdown: true;
-    readonly prettier: true;
-    readonly regexp: true;
-    readonly sortPackageJson: false;
-    readonly sortTsconfig: false;
-    readonly typescript: true;
-    readonly vue: true;
-}>;
-/**
- * 创建面向 Vue 3、Vite、TypeScript、JavaScript 与 Node.js 项目的 ESLint Flat Config。
- *
- * 默认导出就是此函数。额外配置参数会放在内置配置之后，因此项目可以按文件范围
- * 覆盖任何默认规则，而无需再次调用 ESLint 的 `defineConfig()`。
- */
-declare const fastConfig: (options?: FastConfigOptions, ...overrides: Config[]) => Config[];
-
-export { type FastConfigOptions, type LodashPreference, RuleOptions, type RuntimeEnvironment, type TypeScriptConfigOptions, fastConfig as default, defaultConfigOptions, fastConfig };