@fast-china/eslint-config 2.0.0 → 2.0.1

package/dist/rules.mjs

@@ -0,0 +1,485 @@
+//#region src/define-rules.ts
+/**
+* 为项目规则提供精确的规则名、严重级别和规则选项自动补全。
+*
+* 该函数不会修改传入对象；它只在 TypeScript 编译阶段拒绝未知规则和无效选项。
+*/
+const defineRules = (rules) => rules;
+//#endregion
+//#region src/rules/angular.ts
+/**
+* Angular TypeScript 推荐规则。
+*
+* Angular ESLint 的拆分插件不直接导出 Flat Config 预置；本记录与 angular-eslint
+* 22.x 的 `tsRecommended` 保持一致，并逐条说明启用理由。
+*/
+const angularRules = {
+	"@angular-eslint/contextual-lifecycle": "error",
+	"@angular-eslint/no-empty-lifecycle-method": "error",
+	"@angular-eslint/no-input-rename": "error",
+	"@angular-eslint/no-inputs-metadata-property": "error",
+	"@angular-eslint/no-output-native": "error",
+	"@angular-eslint/no-output-on-prefix": "error",
+	"@angular-eslint/no-output-rename": "error",
+	"@angular-eslint/no-outputs-metadata-property": "error",
+	"@angular-eslint/prefer-inject": "error",
+	"@angular-eslint/prefer-on-push-component-change-detection": "error",
+	"@angular-eslint/prefer-standalone": "error",
+	"@angular-eslint/use-pipe-transform-interface": "error",
+	"@angular-eslint/use-lifecycle-interface": "warn"
+};
+/** Angular HTML 模板推荐规则，与 angular-eslint 22.x 的 `templateRecommended` 对齐。 */
+const angularTemplateRules = {
+	"@angular-eslint/template/banana-in-box": "error",
+	"@angular-eslint/template/eqeqeq": "error",
+	"@angular-eslint/template/no-negated-async": "error",
+	"@angular-eslint/template/prefer-control-flow": "error"
+};
+/** Angular 模板无障碍规则；可通过 `angular.templateAccessibility` 整组关闭。 */
+const angularTemplateAccessibilityRules = {
+	"@angular-eslint/template/alt-text": "error",
+	"@angular-eslint/template/click-events-have-key-events": "error",
+	"@angular-eslint/template/elements-content": "error",
+	"@angular-eslint/template/interactive-supports-focus": "error",
+	"@angular-eslint/template/label-has-associated-control": "error",
+	"@angular-eslint/template/mouse-events-have-key-events": "error",
+	"@angular-eslint/template/no-autofocus": "error",
+	"@angular-eslint/template/no-distracting-elements": "error",
+	"@angular-eslint/template/role-has-required-aria": "error",
+	"@angular-eslint/template/table-scope": "error",
+	"@angular-eslint/template/valid-aria": "error"
+};
+//#endregion
+//#region src/rules/common.ts
+/**
+* 跨 JavaScript、TypeScript 与 Vue 脚本生效的公共规则。
+*
+* 维护约定：每条本地覆写都要说明启用原因；可能造成大面积改动、采用成本或
+* 行为变化的规则使用 `[高影响]` 标记，并同步维护 `docs/rules-risk.zh.md`。
+*/
+const commonRules = {
+	"array-callback-return": "error",
+	"no-alert": "warn",
+	"no-case-declarations": "error",
+	"no-multi-str": "error",
+	"no-with": "error",
+	"no-void": ["error", { allowAsStatement: true }],
+	eqeqeq: [
+		"error",
+		"always",
+		{ null: "ignore" }
+	],
+	"prefer-exponentiation-operator": "error",
+	"prefer-object-has-own": "error",
+	"sort-imports": ["warn", {
+		ignoreCase: false,
+		ignoreDeclarationSort: true,
+		ignoreMemberSort: false,
+		memberSyntaxSortOrder: [
+			"none",
+			"all",
+			"multiple",
+			"single"
+		],
+		allowSeparatedGroups: false
+	}]
+};
+//#endregion
+//#region src/rules/import.ts
+/** 默认启用的模块导入正确性与排序规则。 */
+const importRules = {
+	"import-x/first": "error",
+	"import-x/no-duplicates": "error",
+	"import-x/order": ["error", {
+		groups: [
+			"builtin",
+			"external",
+			"internal",
+			"parent",
+			"sibling",
+			"index",
+			"object",
+			"type",
+			"unknown"
+		],
+		"newlines-between": "always",
+		alphabetize: {
+			order: "asc",
+			caseInsensitive: true
+		},
+		warnOnUnassignedImports: true
+	}],
+	"import-x/no-unresolved": "off",
+	"import-x/namespace": "off",
+	"import-x/default": "off",
+	"import-x/no-named-as-default": "off",
+	"import-x/no-named-as-default-member": "off",
+	"import-x/named": "off"
+};
+//#endregion
+//#region src/rules/javascript.ts
+/**
+* JavaScript 本地覆写规则。
+* 高影响规则的解释与关闭方式见 `docs/rules-risk.zh.md`。
+*/
+const javascriptRules = {
+	"no-console": ["warn", { allow: ["warn", "error"] }],
+	"no-debugger": "error",
+	"no-constant-condition": ["error", { checkLoops: false }],
+	"no-restricted-syntax": ["error", "LabeledStatement"],
+	"no-var": "error",
+	"no-empty": ["error", { allowEmptyCatch: true }],
+	"no-irregular-whitespace": "error",
+	"no-use-before-define": ["warn", {
+		classes: true,
+		functions: false,
+		variables: true
+	}],
+	"prefer-const": ["warn", {
+		destructuring: "all",
+		ignoreReadBeforeAssign: true
+	}],
+	"prefer-arrow-callback": ["error", {
+		allowNamedFunctions: false,
+		allowUnboundThis: true
+	}],
+	"object-shorthand": [
+		"error",
+		"always",
+		{
+			ignoreConstructors: false,
+			avoidQuotes: true
+		}
+	],
+	"logical-assignment-operators": [
+		"error",
+		"always",
+		{ enforceForIfStatements: true }
+	],
+	"prefer-object-spread": "error",
+	"prefer-rest-params": "error",
+	"prefer-spread": "error",
+	"prefer-template": "error",
+	"no-redeclare": "error"
+};
+//#endregion
+//#region src/rules/lodash.ts
+/**
+* 统一使用 `lodash-unified` 的可选导入策略。
+*
+* 该规则只约束静态 import/export 的模块来源，不会安装依赖，也不会检查动态
+* `import()` 或 CommonJS `require()`。选择此策略的项目应自行安装 `lodash-unified`。
+*/
+const preferLodashUnifiedRules = { "no-restricted-imports": ["error", {
+	paths: [{
+		name: "lodash",
+		message: "Use \"lodash-unified\" consistently instead of \"lodash\"."
+	}, {
+		name: "lodash-es",
+		message: "Use \"lodash-unified\" consistently instead of \"lodash-es\"."
+	}],
+	patterns: [{
+		group: ["lodash/*", "lodash-es/*"],
+		message: "Use exports from \"lodash-unified\" instead of Lodash subpath imports."
+	}]
+}] };
+/**
+* 统一使用 `lodash` 的可选导入策略。
+*
+* 根入口和 `lodash/*` 子路径都允许使用；规则只负责避免与 `lodash-es` 或
+* `lodash-unified` 混用，不替项目决定整包导入或按方法导入。
+*/
+const preferLodashRules = { "no-restricted-imports": ["error", {
+	paths: [{
+		name: "lodash-es",
+		message: "Use \"lodash\" consistently instead of \"lodash-es\"."
+	}, {
+		name: "lodash-unified",
+		message: "Use \"lodash\" consistently instead of \"lodash-unified\"."
+	}],
+	patterns: [{
+		group: ["lodash-es/*", "lodash-unified/*"],
+		message: "Use \"lodash\" or a \"lodash/*\" subpath consistently."
+	}]
+}] };
+//#endregion
+//#region src/rules/react.ts
+/**
+* React 本地覆写规则。
+*
+* `@eslint-react/recommended*` 负责组件、JSX、DOM 与 Web API 正确性，
+* `react-hooks/recommended` 负责 React 官方 Hooks 与 Compiler 诊断。这里关闭两套
+* 预置间的重复诊断，并补充少量明确的 DOM 安全约束。
+*/
+const reactRules = {
+	"@eslint-react/error-boundaries": "off",
+	"@eslint-react/exhaustive-deps": "off",
+	"@eslint-react/purity": "off",
+	"@eslint-react/rules-of-hooks": "off",
+	"@eslint-react/set-state-in-effect": "off",
+	"@eslint-react/set-state-in-render": "off",
+	"@eslint-react/static-components": "off",
+	"@eslint-react/unsupported-syntax": "off",
+	"@eslint-react/use-memo": "off",
+	"@eslint-react/dom-no-missing-button-type": "error",
+	"@eslint-react/dom-no-missing-iframe-sandbox": "warn",
+	"@eslint-react/dom-no-unknown-property": "error",
+	"@eslint-react/dom-no-unsafe-target-blank": "error"
+};
+//#endregion
+//#region src/rules/sort-package.ts
+/**
+* package.json 属性排序规则。
+*
+* `[高影响][可自动修复]`：仅在 `sortPackageJson: true` 时启用，首次修复可能重排大量字段。
+* 注意：这里故意不排序 `exports` 内部键；条件导出的键顺序具有模块解析语义。
+*/
+const packageJsonSortRules = {
+	"jsonc/sort-array-values": ["error", {
+		order: { type: "asc" },
+		pathPattern: "^files$"
+	}],
+	"jsonc/sort-keys": [
+		"error",
+		{
+			order: [
+				"name",
+				"version",
+				"private",
+				"packageManager",
+				"description",
+				"type",
+				"keywords",
+				"license",
+				"homepage",
+				"bugs",
+				"repository",
+				"author",
+				"contributors",
+				"funding",
+				"files",
+				"main",
+				"module",
+				"types",
+				"exports",
+				"typesVersions",
+				"sideEffects",
+				"unpkg",
+				"jsdelivr",
+				"browser",
+				"bin",
+				"man",
+				"directories",
+				"publishConfig",
+				"scripts",
+				"peerDependencies",
+				"peerDependenciesMeta",
+				"optionalDependencies",
+				"dependencies",
+				"devDependencies",
+				"engines",
+				"config",
+				"overrides",
+				"pnpm",
+				"husky",
+				"lint-staged",
+				"eslintConfig",
+				"prettier"
+			],
+			pathPattern: "^$"
+		},
+		{
+			order: { type: "asc" },
+			pathPattern: "^(?:dev|peer|optional|bundled)?[Dd]ependencies(Meta)?$"
+		},
+		{
+			order: { type: "asc" },
+			pathPattern: "^(?:resolutions|overrides|pnpm.overrides)$"
+		}
+	]
+};
+//#endregion
+//#region src/rules/sort-tsconfig.ts
+/**
+* tsconfig.json 属性排序规则。
+*
+* `[高影响][可自动修复]`：仅在 `sortTsconfig: true` 时启用，首次修复会重排大量字段，
+* 但只改变 JSONC 的阅读顺序，不改变 TypeScript 编译选项值。
+*/
+const tsconfigJsonSortRules = {
+	"jsonc/no-comments": "off",
+	"jsonc/sort-keys": [
+		"error",
+		{
+			order: [
+				"extends",
+				"compilerOptions",
+				"references",
+				"files",
+				"include",
+				"exclude"
+			],
+			pathPattern: "^$"
+		},
+		{
+			order: [
+				"incremental",
+				"composite",
+				"tsBuildInfoFile",
+				"disableSourceOfProjectReferenceRedirect",
+				"disableSolutionSearching",
+				"disableReferencedProjectLoad",
+				"target",
+				"jsx",
+				"jsxFactory",
+				"jsxFragmentFactory",
+				"jsxImportSource",
+				"lib",
+				"moduleDetection",
+				"noLib",
+				"reactNamespace",
+				"useDefineForClassFields",
+				"emitDecoratorMetadata",
+				"experimentalDecorators",
+				"baseUrl",
+				"rootDir",
+				"rootDirs",
+				"customConditions",
+				"module",
+				"moduleResolution",
+				"moduleSuffixes",
+				"noResolve",
+				"paths",
+				"resolveJsonModule",
+				"resolvePackageJsonExports",
+				"resolvePackageJsonImports",
+				"typeRoots",
+				"types",
+				"allowArbitraryExtensions",
+				"allowImportingTsExtensions",
+				"allowUmdGlobalAccess",
+				"allowJs",
+				"checkJs",
+				"maxNodeModuleJsDepth",
+				"strict",
+				"strictBindCallApply",
+				"strictFunctionTypes",
+				"strictNullChecks",
+				"strictPropertyInitialization",
+				"allowUnreachableCode",
+				"allowUnusedLabels",
+				"alwaysStrict",
+				"exactOptionalPropertyTypes",
+				"noFallthroughCasesInSwitch",
+				"noImplicitAny",
+				"noImplicitOverride",
+				"noImplicitReturns",
+				"noImplicitThis",
+				"noPropertyAccessFromIndexSignature",
+				"noUncheckedIndexedAccess",
+				"noUnusedLocals",
+				"noUnusedParameters",
+				"useUnknownInCatchVariables",
+				"declaration",
+				"declarationDir",
+				"declarationMap",
+				"downlevelIteration",
+				"emitBOM",
+				"emitDeclarationOnly",
+				"importHelpers",
+				"importsNotUsedAsValues",
+				"inlineSourceMap",
+				"inlineSources",
+				"isolatedDeclarations",
+				"mapRoot",
+				"newLine",
+				"noEmit",
+				"noEmitHelpers",
+				"noEmitOnError",
+				"outDir",
+				"outFile",
+				"preserveConstEnums",
+				"preserveValueImports",
+				"removeComments",
+				"sourceMap",
+				"sourceRoot",
+				"stripInternal",
+				"allowSyntheticDefaultImports",
+				"esModuleInterop",
+				"forceConsistentCasingInFileNames",
+				"isolatedModules",
+				"preserveSymlinks",
+				"verbatimModuleSyntax",
+				"skipDefaultLibCheck",
+				"skipLibCheck"
+			],
+			pathPattern: "^compilerOptions$"
+		}
+	]
+};
+//#endregion
+//#region src/rules/typescript.ts
+/**
+* TypeScript 本地覆写规则。
+* 这里补充 typescript-eslint 预置；高影响规则需同步维护风险文档。
+*/
+const typescriptRules = {
+	"@typescript-eslint/no-redeclare": "error",
+	"@typescript-eslint/no-unused-vars": ["error", {
+		args: "after-used",
+		argsIgnorePattern: "^_",
+		caughtErrors: "all",
+		caughtErrorsIgnorePattern: "^_",
+		ignoreRestSiblings: true,
+		varsIgnorePattern: "^_"
+	}],
+	"@typescript-eslint/no-namespace": "off",
+	"@typescript-eslint/no-explicit-any": "warn",
+	"@typescript-eslint/no-require-imports": "error",
+	"@typescript-eslint/no-unused-expressions": ["error", {
+		allowShortCircuit: true,
+		allowTernary: true
+	}],
+	"@typescript-eslint/no-inferrable-types": "error",
+	"@typescript-eslint/no-non-null-assertion": "warn",
+	"@typescript-eslint/no-non-null-asserted-optional-chain": "error",
+	"@typescript-eslint/consistent-type-imports": ["error", {
+		disallowTypeAnnotations: false,
+		fixStyle: "inline-type-imports",
+		prefer: "type-imports"
+	}]
+};
+//#endregion
+//#region src/rules/vue.ts
+/**
+* Vue SFC 本地覆写规则。
+* 上游 `flat/recommended` 已覆盖基础正确性，这里只记录项目取舍与附加约束。
+*/
+const vueRules = {
+	"vue/no-v-html": "warn",
+	"vue/require-default-prop": "off",
+	"vue/require-explicit-emits": "error",
+	"vue/multi-word-component-names": "off",
+	"vue/prefer-import-from-vue": "warn",
+	"vue/no-dupe-keys": "error",
+	"vue/no-mutating-props": "error",
+	"vue/no-reserved-component-names": "error",
+	"vue/no-v-text-v-html-on-component": "error",
+	"vue/custom-event-name-casing": ["error", "camelCase"],
+	"vue/one-component-per-file": "off",
+	"vue/attributes-order": ["error", { order: [
+		"DEFINITION",
+		"LIST_RENDERING",
+		"CONDITIONALS",
+		"RENDER_MODIFIERS",
+		"GLOBAL",
+		"UNIQUE",
+		"OTHER_ATTR",
+		"EVENTS",
+		"CONTENT"
+	] }]
+};
+//#endregion
+export { reactRules as a, javascriptRules as c, angularRules as d, angularTemplateAccessibilityRules as f, packageJsonSortRules as i, importRules as l, defineRules as m, typescriptRules as n, preferLodashRules as o, angularTemplateRules as p, tsconfigJsonSortRules as r, preferLodashUnifiedRules as s, vueRules as t, commonRules as u };
+
+//# sourceMappingURL=rules.mjs.map

package/dist/rules.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"rules.mjs","names":[],"sources":["../src/define-rules.ts","../src/rules/angular.ts","../src/rules/common.ts","../src/rules/import.ts","../src/rules/javascript.ts","../src/rules/lodash.ts","../src/rules/react.ts","../src/rules/sort-package.ts","../src/rules/sort-tsconfig.ts","../src/rules/typescript.ts","../src/rules/vue.ts"],"sourcesContent":["import type { RuleOptions } from \"./typegen\";\nimport type { Linter } from \"eslint\";\n\ntype RejectUnknownRuleNames<Rules extends RuleOptions> = Rules & Record<Exclude<keyof Rules, keyof RuleOptions>, never>;\n\n/**\n * 为项目规则提供精确的规则名、严重级别和规则选项自动补全。\n *\n * 该函数不会修改传入对象；它只在 TypeScript 编译阶段拒绝未知规则和无效选项。\n */\nexport const defineRules = <const Rules extends RuleOptions>(rules: RejectUnknownRuleNames<Rules>): Rules & Linter.RulesRecord => rules;\n\nexport type { RuleOptions } from \"./typegen\";\n","import type { RuleOptions } from \"../typegen\";\n\n/**\n * Angular TypeScript 推荐规则。\n *\n * Angular ESLint 的拆分插件不直接导出 Flat Config 预置；本记录与 angular-eslint\n * 22.x 的 `tsRecommended` 保持一致，并逐条说明启用理由。\n */\nexport const angularRules = {\n\t// 生命周期方法只能出现在对应的 Angular 组件或指令上下文中，避免无效钩子。\n\t\"@angular-eslint/contextual-lifecycle\": \"error\",\n\t// 空生命周期方法没有行为且容易误导维护者，应直接移除。\n\t\"@angular-eslint/no-empty-lifecycle-method\": \"error\",\n\t// Input 别名会让模板 API 与类属性名称分离，增加搜索和重构成本。\n\t\"@angular-eslint/no-input-rename\": \"error\",\n\t// 统一使用 input()/@Input 声明输入，避免与 metadata 数组混用两套 API。\n\t\"@angular-eslint/no-inputs-metadata-property\": \"error\",\n\t// 输出名称不得覆盖原生 DOM 事件，否则模板事件含义容易混淆。\n\t\"@angular-eslint/no-output-native\": \"error\",\n\t// 输出本身已经表达事件语义，不使用 on 前缀以保持 Angular 公共 API 约定。\n\t\"@angular-eslint/no-output-on-prefix\": \"error\",\n\t// Output 别名会让模板 API 与类属性名称分离，增加搜索和重构成本。\n\t\"@angular-eslint/no-output-rename\": \"error\",\n\t// 统一使用 output()/@Output 声明输出，避免与 metadata 数组混用两套 API。\n\t\"@angular-eslint/no-outputs-metadata-property\": \"error\",\n\t// [高影响][按需启用] Angular 22 推荐 inject()，旧构造器注入代码启用框架后可能集中报错。\n\t\"@angular-eslint/prefer-inject\": \"error\",\n\t// [高影响][按需启用] OnPush 改变变更检测边界，修复时必须验证状态更新与视图刷新。\n\t\"@angular-eslint/prefer-on-push-component-change-detection\": \"error\",\n\t// [高影响][按需启用] 独立组件是现代 Angular 默认模型，旧 NgModule 项目需规划后再迁移。\n\t\"@angular-eslint/prefer-standalone\": \"error\",\n\t// Pipe 类实现接口后可由 TypeScript 检查 transform 签名，避免运行时才发现不一致。\n\t\"@angular-eslint/use-pipe-transform-interface\": \"error\",\n\t// 生命周期接口让方法拼写和签名可由 TypeScript 验证；warn 便于渐进补齐旧代码。\n\t\"@angular-eslint/use-lifecycle-interface\": \"warn\",\n} satisfies RuleOptions;\n\n/** Angular HTML 模板推荐规则，与 angular-eslint 22.x 的 `templateRecommended` 对齐。 */\nexport const angularTemplateRules = {\n\t// 双向绑定必须使用 [(...)] 顺序，反写的“香蕉盒”通常是模板笔误。\n\t\"@angular-eslint/template/banana-in-box\": \"error\",\n\t// 模板比较使用严格等号，避免 Angular 表达式中的隐式类型转换。\n\t\"@angular-eslint/template/eqeqeq\": \"error\",\n\t// 对 async pipe 结果直接取反会让初始 null 状态产生反直觉分支。\n\t\"@angular-eslint/template/no-negated-async\": \"error\",\n\t// [高影响][按需启用] 统一采用现代 @if/@for 控制流，旧模板启用后需要规划迁移。\n\t\"@angular-eslint/template/prefer-control-flow\": \"error\",\n} satisfies RuleOptions;\n\n/** Angular 模板无障碍规则；可通过 `angular.templateAccessibility` 整组关闭。 */\nexport const angularTemplateAccessibilityRules = {\n\t// 图片和图像型元素需要替代文本，确保非视觉用户能获得等价信息。\n\t\"@angular-eslint/template/alt-text\": \"error\",\n\t// click 交互需要键盘等价入口，避免仅鼠标用户可操作。\n\t\"@angular-eslint/template/click-events-have-key-events\": \"error\",\n\t// 需要可访问名称的元素不得为空，避免读屏软件播报无意义控件。\n\t\"@angular-eslint/template/elements-content\": \"error\",\n\t// 具有交互语义的元素必须可聚焦，确保键盘导航能够到达。\n\t\"@angular-eslint/template/interactive-supports-focus\": \"error\",\n\t// 表单 label 必须关联控件，扩大可点击区域并为辅助技术提供名称。\n\t\"@angular-eslint/template/label-has-associated-control\": \"error\",\n\t// mouseover/mouseout 行为需要对应键盘焦点事件，保持输入方式等价。\n\t\"@angular-eslint/template/mouse-events-have-key-events\": \"error\",\n\t// autofocus 会突然移动焦点并干扰读屏流程，默认禁止。\n\t\"@angular-eslint/template/no-autofocus\": \"error\",\n\t// 禁止 marquee、blink 等干扰性元素，避免可读性和可访问性问题。\n\t\"@angular-eslint/template/no-distracting-elements\": \"error\",\n\t// ARIA role 必须提供该角色要求的属性，避免声明不完整的语义。\n\t\"@angular-eslint/template/role-has-required-aria\": \"error\",\n\t// 表头 scope 只能使用合法值，使表格关系可被辅助技术正确解析。\n\t\"@angular-eslint/template/table-scope\": \"error\",\n\t// ARIA 属性名和值必须有效，避免浏览器静默忽略错误语义。\n\t\"@angular-eslint/template/valid-aria\": \"error\",\n} satisfies RuleOptions;\n","import type { RuleOptions } from \"../typegen\";\n\n/**\n * 跨 JavaScript、TypeScript 与 Vue 脚本生效的公共规则。\n *\n * 维护约定：每条本地覆写都要说明启用原因；可能造成大面积改动、采用成本或\n * 行为变化的规则使用 `[高影响]` 标记，并同步维护 `docs/rules-risk.zh.md`。\n */\nexport const commonRules = {\n\t// 要求数组回调在所有可到达分支返回值，避免 map/filter 等调用静默产生 undefined。\n\t\"array-callback-return\": \"error\",\n\t// 浏览器弹窗通常不适合生产代码；使用 warn 允许原型调试，同时确保发布前能够被发现。\n\t\"no-alert\": \"warn\",\n\t// switch 的 case 不创建词法作用域；要求用花括号包裹声明，避免跨 case 冲突。\n\t\"no-case-declarations\": \"error\",\n\t// 禁止反斜杠续行字符串，优先使用可读性更好的模板字符串。\n\t\"no-multi-str\": \"error\",\n\t// with 会让标识符解析不可预测，并且在严格模式和 ESM 中不可用。\n\t\"no-with\": \"error\",\n\t// 允许用 `void promise` 明确忽略 Promise，但禁止在普通表达式中滥用 void。\n\t\"no-void\": [\n\t\t\"error\",\n\t\t{\n\t\t\tallowAsStatement: true,\n\t\t},\n\t],\n\t// 要求严格相等；保留 `value == null` 同时判断 null/undefined 的常用写法。\n\teqeqeq: [\"error\", \"always\", { null: \"ignore\" }],\n\t// 幂运算统一使用 **，减少 Math.pow 嵌套并保持现代语法风格。\n\t\"prefer-exponentiation-operator\": \"error\",\n\t// 使用 Object.hasOwn，避免对象覆盖或缺少 hasOwnProperty 时产生异常。\n\t\"prefer-object-has-own\": \"error\",\n\n\t// [可自动修复] 声明间顺序交给 import-x；这里只排序同一 import 的成员。\n\t\"sort-imports\": [\n\t\t\"warn\",\n\t\t{\n\t\t\tignoreCase: false,\n\t\t\tignoreDeclarationSort: true,\n\t\t\tignoreMemberSort: false,\n\t\t\tmemberSyntaxSortOrder: [\"none\", \"all\", \"multiple\", \"single\"],\n\t\t\tallowSeparatedGroups: false,\n\t\t},\n\t],\n} satisfies RuleOptions;\n","import type { RuleOptions } from \"../typegen\";\n\n/** 默认启用的模块导入正确性与排序规则。 */\nexport const importRules = {\n\t// import 必须位于其他语句之前，避免模块依赖散落在执行逻辑中。\n\t\"import-x/first\": \"error\",\n\t// 合并同一模块的重复 import，避免绑定分散或副作用被误读。\n\t\"import-x/no-duplicates\": \"error\",\n\t// [高影响][可自动修复] 按来源分组并排序；带副作用的裸 import 仅报告，人工移动前必须确认执行顺序。\n\t\"import-x/order\": [\n\t\t\"error\",\n\t\t{\n\t\t\tgroups: [\n\t\t\t\t// Node.js 内置模块\n\t\t\t\t\"builtin\",\n\t\t\t\t// 第三方依赖\n\t\t\t\t\"external\",\n\t\t\t\t// 项目内部别名模块\n\t\t\t\t\"internal\",\n\t\t\t\t// 父级目录模块\n\t\t\t\t\"parent\",\n\t\t\t\t// 同级目录模块\n\t\t\t\t\"sibling\",\n\t\t\t\t// 当前目录入口模块\n\t\t\t\t\"index\",\n\t\t\t\t// TypeScript import = require() 导入\n\t\t\t\t\"object\",\n\t\t\t\t// TypeScript 类型导入\n\t\t\t\t\"type\",\n\t\t\t\t// 无法识别分类的导入\n\t\t\t\t\"unknown\",\n\t\t\t],\n\t\t\t// 不同 import 分组之间必须保留一个空行\n\t\t\t\"newlines-between\": \"always\",\n\t\t\t// 同一分组内按照模块路径字母升序排列\n\t\t\talphabetize: {\n\t\t\t\torder: \"asc\",\n\t\t\t\tcaseInsensitive: true,\n\t\t\t},\n\t\t\t// 对没有赋值给变量的副作用导入进行排序检查\n\t\t\twarnOnUnassignedImports: true,\n\t\t},\n\t],\n\t// [默认关闭] Vite/TypeScript 别名由项目解析器校验，避免共享配置绑定特定 resolver。\n\t\"import-x/no-unresolved\": \"off\",\n\t// [默认关闭] 未配置 resolver 时，namespace 导出的静态分析容易产生误报。\n\t\"import-x/namespace\": \"off\",\n\t// [默认关闭] 未配置 resolver 时，默认导出的静态分析容易产生误报。\n\t\"import-x/default\": \"off\",\n\t// [默认关闭] 不限制同时存在默认导出与相近命名导出的模块 API 风格。\n\t\"import-x/no-named-as-default\": \"off\",\n\t// [默认关闭] 不限制通过默认导入对象访问同名属性的项目 API 风格。\n\t\"import-x/no-named-as-default-member\": \"off\",\n\t// [默认关闭] 未配置 resolver 时，命名导出的静态分析容易产生误报。\n\t\"import-x/named\": \"off\",\n} satisfies RuleOptions;\n","import type { RuleOptions } from \"../typegen\";\n\n/**\n * JavaScript 本地覆写规则。\n * 高影响规则的解释与关闭方式见 `docs/rules-risk.zh.md`。\n */\nexport const javascriptRules = {\n\t// 控制台调用在应用源码中需要人工确认；warn/error 仍可用于必要的诊断输出。\n\t\"no-console\": [\n\t\t\"warn\",\n\t\t{\n\t\t\tallow: [\"warn\", \"error\"],\n\t\t},\n\t],\n\t// 防止调试断点进入发布代码并中断运行。\n\t\"no-debugger\": \"error\",\n\t// 禁止意外的恒定条件，但允许 while (true) 等有明确退出逻辑的循环。\n\t\"no-constant-condition\": [\n\t\t\"error\",\n\t\t{\n\t\t\tcheckLoops: false,\n\t\t},\n\t],\n\t// [高影响] 禁止标签语句；包含多层循环 labeled break/continue 的代码需先重构控制流。\n\t\"no-restricted-syntax\": [\"error\", \"LabeledStatement\"],\n\t// [高影响][可自动修复] 使用 let/const 替代 var；首次启用需复核循环闭包和声明提升行为。\n\t\"no-var\": \"error\",\n\t// 禁止无说明的空代码块；允许用于“忽略失败”语义的空 catch。\n\t\"no-empty\": [\n\t\t\"error\",\n\t\t{\n\t\t\tallowEmptyCatch: true,\n\t\t},\n\t],\n\t// 拒绝肉眼难以识别、可能导致解析差异的非常规空白字符。\n\t\"no-irregular-whitespace\": \"error\",\n\t// 变量和类先声明后使用；函数声明允许提升。warn 保留函数式组合和循环依赖重构空间。\n\t\"no-use-before-define\": [\n\t\t\"warn\",\n\t\t{\n\t\t\tclasses: true,\n\t\t\tfunctions: false,\n\t\t\tvariables: true,\n\t\t},\n\t],\n\t// [可自动修复] 能保持引用不变的变量优先使用 const；读取发生在赋值前时不做不可靠判断。\n\t\"prefer-const\": [\n\t\t\"warn\",\n\t\t{\n\t\t\tdestructuring: \"all\",\n\t\t\tignoreReadBeforeAssign: true,\n\t\t},\n\t],\n\t// [高影响][可自动修复] 优先箭头回调；批量修复后应复核 this/arguments 与函数名栈信息。\n\t\"prefer-arrow-callback\": [\n\t\t\"error\",\n\t\t{\n\t\t\tallowNamedFunctions: false,\n\t\t\tallowUnboundThis: true,\n\t\t},\n\t],\n\t// [可自动修复] 属性和值同名时使用对象简写，带引号键名不强制改写。\n\t\"object-shorthand\": [\n\t\t\"error\",\n\t\t\"always\",\n\t\t{\n\t\t\tignoreConstructors: false,\n\t\t\tavoidQuotes: true,\n\t\t},\n\t],\n\t// [高影响][可自动修复] 使用 ||=、&&=、??=；涉及 getter/Proxy 的代码应复核求值次数。\n\t\"logical-assignment-operators\": [\"error\", \"always\", { enforceForIfStatements: true }],\n\t// [可自动修复] 合并对象时优先展开语法，避免 Object.assign 的额外目标对象样板。\n\t\"prefer-object-spread\": \"error\",\n\t// 可变参数函数优先 rest 参数，避免依赖类数组 arguments；该规则只报告，不自动改写签名。\n\t\"prefer-rest-params\": \"error\",\n\t// 调用可迭代对象时优先 spread；该规则只报告，避免自动改变 apply 的 this 语义。\n\t\"prefer-spread\": \"error\",\n\t// [可自动修复] 字符串拼接优先模板字符串，便于阅读和多段插值。\n\t\"prefer-template\": \"error\",\n\t// 同一作用域禁止重复声明，避免后声明遮盖前声明。\n\t\"no-redeclare\": \"error\",\n} satisfies RuleOptions;\n","import type { RuleOptions } from \"../typegen\";\n\n/**\n * 统一使用 `lodash-unified` 的可选导入策略。\n *\n * 该规则只约束静态 import/export 的模块来源，不会安装依赖，也不会检查动态\n * `import()` 或 CommonJS `require()`。选择此策略的项目应自行安装 `lodash-unified`。\n */\nexport const preferLodashUnifiedRules = {\n\t// [高影响][按需启用] 禁止混用 lodash 与 lodash-es，避免同一项目维护多套等价依赖入口。\n\t\"no-restricted-imports\": [\n\t\t\"error\",\n\t\t{\n\t\t\tpaths: [\n\t\t\t\t{\n\t\t\t\t\tname: \"lodash\",\n\t\t\t\t\tmessage: 'Use \"lodash-unified\" consistently instead of \"lodash\".',\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\tname: \"lodash-es\",\n\t\t\t\t\tmessage: 'Use \"lodash-unified\" consistently instead of \"lodash-es\".',\n\t\t\t\t},\n\t\t\t],\n\t\t\tpatterns: [\n\t\t\t\t{\n\t\t\t\t\tgroup: [\"lodash/*\", \"lodash-es/*\"],\n\t\t\t\t\tmessage: 'Use exports from \"lodash-unified\" instead of Lodash subpath imports.',\n\t\t\t\t},\n\t\t\t],\n\t\t},\n\t],\n} satisfies RuleOptions;\n\n/**\n * 统一使用 `lodash` 的可选导入策略。\n *\n * 根入口和 `lodash/*` 子路径都允许使用；规则只负责避免与 `lodash-es` 或\n * `lodash-unified` 混用，不替项目决定整包导入或按方法导入。\n */\nexport const preferLodashRules = {\n\t// [高影响][按需启用] 禁止混用 lodash-es 与 lodash-unified，保持运行时和类型来源一致。\n\t\"no-restricted-imports\": [\n\t\t\"error\",\n\t\t{\n\t\t\tpaths: [\n\t\t\t\t{\n\t\t\t\t\tname: \"lodash-es\",\n\t\t\t\t\tmessage: 'Use \"lodash\" consistently instead of \"lodash-es\".',\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\tname: \"lodash-unified\",\n\t\t\t\t\tmessage: 'Use \"lodash\" consistently instead of \"lodash-unified\".',\n\t\t\t\t},\n\t\t\t],\n\t\t\tpatterns: [\n\t\t\t\t{\n\t\t\t\t\tgroup: [\"lodash-es/*\", \"lodash-unified/*\"],\n\t\t\t\t\tmessage: 'Use \"lodash\" or a \"lodash/*\" subpath consistently.',\n\t\t\t\t},\n\t\t\t],\n\t\t},\n\t],\n} satisfies RuleOptions;\n","import type { RuleOptions } from \"../typegen\";\n\n/**\n * React 本地覆写规则。\n *\n * `@eslint-react/recommended*` 负责组件、JSX、DOM 与 Web API 正确性，\n * `react-hooks/recommended` 负责 React 官方 Hooks 与 Compiler 诊断。这里关闭两套\n * 预置间的重复诊断，并补充少量明确的 DOM 安全约束。\n */\nexport const reactRules = {\n\t// React 官方 Hooks 插件提供更完整的 Error Boundary/Compiler 诊断，避免同一问题重复报告。\n\t\"@eslint-react/error-boundaries\": \"off\",\n\t// 依赖数组由 React 官方 exhaustive-deps 规则统一检查，避免重复警告。\n\t\"@eslint-react/exhaustive-deps\": \"off\",\n\t// 纯函数约束交给 React 官方 Compiler 规则维护，确保与 React 版本同步。\n\t\"@eslint-react/purity\": \"off\",\n\t// Hooks 调用顺序由 React 官方规则作为唯一来源，避免编辑器显示两个相同错误。\n\t\"@eslint-react/rules-of-hooks\": \"off\",\n\t// Effect 内同步更新状态由 React 官方 Compiler 规则判断，避免两套实现严重级别不一致。\n\t\"@eslint-react/set-state-in-effect\": \"off\",\n\t// 渲染期间更新状态由 React 官方 Compiler 规则判断，避免重复错误。\n\t\"@eslint-react/set-state-in-render\": \"off\",\n\t// 组件引用稳定性由 React 官方 Compiler 规则统一检查。\n\t\"@eslint-react/static-components\": \"off\",\n\t// Compiler 不支持的语法由 React 官方规则统一报告。\n\t\"@eslint-react/unsupported-syntax\": \"off\",\n\t// memoization 建议由 React 官方 Compiler 规则统一报告。\n\t\"@eslint-react/use-memo\": \"off\",\n\n\t// button 缺少 type 时在表单内默认为 submit，显式声明可避免意外提交。\n\t\"@eslint-react/dom-no-missing-button-type\": \"error\",\n\t// [安全关注] 未受限 iframe 权限面较大；以 warn 提醒评估可信来源和 sandbox 策略。\n\t\"@eslint-react/dom-no-missing-iframe-sandbox\": \"warn\",\n\t// JSX 属性拼写错误会被 React 忽略或错误透传到 DOM，应在提交前阻断。\n\t\"@eslint-react/dom-no-unknown-property\": \"error\",\n\t// [安全关注] target=\"_blank\" 未隔离 opener 时可能允许目标页控制来源页。\n\t\"@eslint-react/dom-no-unsafe-target-blank\": \"error\",\n} satisfies RuleOptions;\n","import type { RuleOptions } from \"../typegen\";\n\n/**\n * package.json 属性排序规则。\n *\n * `[高影响][可自动修复]`：仅在 `sortPackageJson: true` 时启用，首次修复可能重排大量字段。\n * 注意：这里故意不排序 `exports` 内部键；条件导出的键顺序具有模块解析语义。\n */\nexport const packageJsonSortRules = {\n\t// [高影响][可自动修复][按需启用] npm 的 files 清单按字母排序；数组顺序不改打包集合，但首次 diff 较大。\n\t\"jsonc/sort-array-values\": [\n\t\t\"error\",\n\t\t{\n\t\t\torder: { type: \"asc\" },\n\t\t\tpathPattern: \"^files$\",\n\t\t},\n\t],\n\t// [高影响][可自动修复][按需启用] 仅排序明确安全的 package.json 区域，不进入 exports 条件对象。\n\t\"jsonc/sort-keys\": [\n\t\t\"error\",\n\t\t// 根字段按常见阅读顺序组织，减少不同项目之间的清单噪声。\n\t\t{\n\t\t\torder: [\n\t\t\t\t\"name\",\n\t\t\t\t\"version\",\n\t\t\t\t\"private\",\n\t\t\t\t\"packageManager\",\n\t\t\t\t\"description\",\n\t\t\t\t\"type\",\n\t\t\t\t\"keywords\",\n\t\t\t\t\"license\",\n\t\t\t\t\"homepage\",\n\t\t\t\t\"bugs\",\n\t\t\t\t\"repository\",\n\t\t\t\t\"author\",\n\t\t\t\t\"contributors\",\n\t\t\t\t\"funding\",\n\t\t\t\t\"files\",\n\t\t\t\t\"main\",\n\t\t\t\t\"module\",\n\t\t\t\t\"types\",\n\t\t\t\t\"exports\",\n\t\t\t\t\"typesVersions\",\n\t\t\t\t\"sideEffects\",\n\t\t\t\t\"unpkg\",\n\t\t\t\t\"jsdelivr\",\n\t\t\t\t\"browser\",\n\t\t\t\t\"bin\",\n\t\t\t\t\"man\",\n\t\t\t\t\"directories\",\n\t\t\t\t\"publishConfig\",\n\t\t\t\t\"scripts\",\n\t\t\t\t\"peerDependencies\",\n\t\t\t\t\"peerDependenciesMeta\",\n\t\t\t\t\"optionalDependencies\",\n\t\t\t\t\"dependencies\",\n\t\t\t\t\"devDependencies\",\n\t\t\t\t\"engines\",\n\t\t\t\t\"config\",\n\t\t\t\t\"overrides\",\n\t\t\t\t\"pnpm\",\n\t\t\t\t\"husky\",\n\t\t\t\t\"lint-staged\",\n\t\t\t\t\"eslintConfig\",\n\t\t\t\t\"prettier\",\n\t\t\t],\n\t\t\tpathPattern: \"^$\",\n\t\t},\n\t\t// 各类依赖映射按包名排序，方便发现重复或异常依赖。\n\t\t{\n\t\t\torder: { type: \"asc\" },\n\t\t\tpathPattern: \"^(?:dev|peer|optional|bundled)?[Dd]ependencies(Meta)?$\",\n\t\t},\n\t\t// overrides/resolutions 只排序直接键；修改前仍应关注包管理器的模式匹配语义。\n\t\t{\n\t\t\torder: { type: \"asc\" },\n\t\t\tpathPattern: \"^(?:resolutions|overrides|pnpm.overrides)$\",\n\t\t},\n\t],\n} satisfies RuleOptions;\n","import type { RuleOptions } from \"../typegen\";\n\n/**\n * tsconfig.json 属性排序规则。\n *\n * `[高影响][可自动修复]`：仅在 `sortTsconfig: true` 时启用，首次修复会重排大量字段，\n * 但只改变 JSONC 的阅读顺序，不改变 TypeScript 编译选项值。\n */\nexport const tsconfigJsonSortRules = {\n\t// tsconfig 是 JSONC，注释用于解释不直观的编译器取舍，必须保留。\n\t\"jsonc/no-comments\": \"off\",\n\n\t// [高影响][可自动修复][按需启用] 只调整顶层和 compilerOptions 的键顺序，不改写任何选项值或数组。\n\t\"jsonc/sort-keys\": [\n\t\t\"error\",\n\t\t// 顶层按继承、选项、项目引用和文件范围的阅读顺序排列。\n\t\t{\n\t\t\torder: [\"extends\", \"compilerOptions\", \"references\", \"files\", \"include\", \"exclude\"],\n\t\t\tpathPattern: \"^$\",\n\t\t},\n\t\t// compilerOptions 的顺序跟随 TypeScript 文档主题，便于检索和代码审查。\n\t\t{\n\t\t\torder: [\n\t\t\t\t/* Projects */\n\t\t\t\t\"incremental\",\n\t\t\t\t\"composite\",\n\t\t\t\t\"tsBuildInfoFile\",\n\t\t\t\t\"disableSourceOfProjectReferenceRedirect\",\n\t\t\t\t\"disableSolutionSearching\",\n\t\t\t\t\"disableReferencedProjectLoad\",\n\t\t\t\t/* Language and Environment */\n\t\t\t\t\"target\",\n\t\t\t\t\"jsx\",\n\t\t\t\t\"jsxFactory\",\n\t\t\t\t\"jsxFragmentFactory\",\n\t\t\t\t\"jsxImportSource\",\n\t\t\t\t\"lib\",\n\t\t\t\t\"moduleDetection\",\n\t\t\t\t\"noLib\",\n\t\t\t\t\"reactNamespace\",\n\t\t\t\t\"useDefineForClassFields\",\n\t\t\t\t\"emitDecoratorMetadata\",\n\t\t\t\t\"experimentalDecorators\",\n\t\t\t\t/* Modules */\n\t\t\t\t\"baseUrl\",\n\t\t\t\t\"rootDir\",\n\t\t\t\t\"rootDirs\",\n\t\t\t\t\"customConditions\",\n\t\t\t\t\"module\",\n\t\t\t\t\"moduleResolution\",\n\t\t\t\t\"moduleSuffixes\",\n\t\t\t\t\"noResolve\",\n\t\t\t\t\"paths\",\n\t\t\t\t\"resolveJsonModule\",\n\t\t\t\t\"resolvePackageJsonExports\",\n\t\t\t\t\"resolvePackageJsonImports\",\n\t\t\t\t\"typeRoots\",\n\t\t\t\t\"types\",\n\t\t\t\t\"allowArbitraryExtensions\",\n\t\t\t\t\"allowImportingTsExtensions\",\n\t\t\t\t\"allowUmdGlobalAccess\",\n\t\t\t\t/* JavaScript Support */\n\t\t\t\t\"allowJs\",\n\t\t\t\t\"checkJs\",\n\t\t\t\t\"maxNodeModuleJsDepth\",\n\t\t\t\t/* Type Checking */\n\t\t\t\t\"strict\",\n\t\t\t\t\"strictBindCallApply\",\n\t\t\t\t\"strictFunctionTypes\",\n\t\t\t\t\"strictNullChecks\",\n\t\t\t\t\"strictPropertyInitialization\",\n\t\t\t\t\"allowUnreachableCode\",\n\t\t\t\t\"allowUnusedLabels\",\n\t\t\t\t\"alwaysStrict\",\n\t\t\t\t\"exactOptionalPropertyTypes\",\n\t\t\t\t\"noFallthroughCasesInSwitch\",\n\t\t\t\t\"noImplicitAny\",\n\t\t\t\t\"noImplicitOverride\",\n\t\t\t\t\"noImplicitReturns\",\n\t\t\t\t\"noImplicitThis\",\n\t\t\t\t\"noPropertyAccessFromIndexSignature\",\n\t\t\t\t\"noUncheckedIndexedAccess\",\n\t\t\t\t\"noUnusedLocals\",\n\t\t\t\t\"noUnusedParameters\",\n\t\t\t\t\"useUnknownInCatchVariables\",\n\t\t\t\t/* Emit */\n\t\t\t\t\"declaration\",\n\t\t\t\t\"declarationDir\",\n\t\t\t\t\"declarationMap\",\n\t\t\t\t\"downlevelIteration\",\n\t\t\t\t\"emitBOM\",\n\t\t\t\t\"emitDeclarationOnly\",\n\t\t\t\t\"importHelpers\",\n\t\t\t\t\"importsNotUsedAsValues\",\n\t\t\t\t\"inlineSourceMap\",\n\t\t\t\t\"inlineSources\",\n\t\t\t\t\"isolatedDeclarations\",\n\t\t\t\t\"mapRoot\",\n\t\t\t\t\"newLine\",\n\t\t\t\t\"noEmit\",\n\t\t\t\t\"noEmitHelpers\",\n\t\t\t\t\"noEmitOnError\",\n\t\t\t\t\"outDir\",\n\t\t\t\t\"outFile\",\n\t\t\t\t\"preserveConstEnums\",\n\t\t\t\t\"preserveValueImports\",\n\t\t\t\t\"removeComments\",\n\t\t\t\t\"sourceMap\",\n\t\t\t\t\"sourceRoot\",\n\t\t\t\t\"stripInternal\",\n\t\t\t\t/* Interop Constraints */\n\t\t\t\t\"allowSyntheticDefaultImports\",\n\t\t\t\t\"esModuleInterop\",\n\t\t\t\t\"forceConsistentCasingInFileNames\",\n\t\t\t\t\"isolatedModules\",\n\t\t\t\t\"preserveSymlinks\",\n\t\t\t\t\"verbatimModuleSyntax\",\n\t\t\t\t/* Completeness */\n\t\t\t\t\"skipDefaultLibCheck\",\n\t\t\t\t\"skipLibCheck\",\n\t\t\t],\n\t\t\tpathPattern: \"^compilerOptions$\",\n\t\t},\n\t],\n} satisfies RuleOptions;\n","import type { RuleOptions } from \"../typegen\";\n\n/**\n * TypeScript 本地覆写规则。\n * 这里补充 typescript-eslint 预置；高影响规则需同步维护风险文档。\n */\nexport const typescriptRules = {\n\t// 使用 TypeScript 版本避免核心规则误判声明合并、类型和值的同名声明。\n\t\"@typescript-eslint/no-redeclare\": \"error\",\n\t// [高影响][可自动修复] 未使用符号视为错误；以下划线开头可显式表示参数或变量被有意忽略。\n\t\"@typescript-eslint/no-unused-vars\": [\n\t\t\"error\",\n\t\t{\n\t\t\targs: \"after-used\",\n\t\t\targsIgnorePattern: \"^_\",\n\t\t\tcaughtErrors: \"all\",\n\t\t\tcaughtErrorsIgnorePattern: \"^_\",\n\t\t\tignoreRestSiblings: true,\n\t\t\tvarsIgnorePattern: \"^_\",\n\t\t},\n\t],\n\t// [默认关闭] 声明文件、全局扩展和部分 SDK 仍需要 namespace。\n\t\"@typescript-eslint/no-namespace\": \"off\",\n\t// any 会绕过类型检查，但在第三方边界和渐进式类型完善中有合理用途，因此只警告。\n\t\"@typescript-eslint/no-explicit-any\": \"warn\",\n\t// [高影响] 默认要求 ESM import；CommonJS、动态加载或工具链互操作代码可能需要按文件关闭。\n\t\"@typescript-eslint/no-require-imports\": \"error\",\n\t// 使用 TS 版本识别类型断言等语法；允许常见的短路和三元表达式调用模式。\n\t\"@typescript-eslint/no-unused-expressions\": [\n\t\t\"error\",\n\t\t{\n\t\t\tallowShortCircuit: true,\n\t\t\tallowTernary: true,\n\t\t},\n\t],\n\t// [可自动修复] 删除可由 TypeScript 明确推断的原始值类型标注，减少重复信息。\n\t\"@typescript-eslint/no-inferrable-types\": \"error\",\n\t// 非空断言可能隐藏空值缺陷；以警告提示逐步消除，避免一次性产生大量阻断错误。\n\t\"@typescript-eslint/no-non-null-assertion\": \"warn\",\n\t// 可选链之后再做非空断言逻辑矛盾，通常表示边界条件设计有误。\n\t\"@typescript-eslint/no-non-null-asserted-optional-chain\": \"error\",\n\t// [高影响][可自动修复] 类型依赖改用内联 type import；需复核仅靠 import 触发的模块副作用。\n\t\"@typescript-eslint/consistent-type-imports\": [\n\t\t\"error\",\n\t\t{\n\t\t\tdisallowTypeAnnotations: false,\n\t\t\tfixStyle: \"inline-type-imports\",\n\t\t\tprefer: \"type-imports\",\n\t\t},\n\t],\n} satisfies RuleOptions;\n","import type { RuleOptions } from \"../typegen\";\n\n/**\n * Vue SFC 本地覆写规则。\n * 上游 `flat/recommended` 已覆盖基础正确性，这里只记录项目取舍与附加约束。\n */\nexport const vueRules = {\n\t// [安全关注] v-html 可能引入 XSS；保留 warn 以兼容经过净化的富文本场景。\n\t\"vue/no-v-html\": \"warn\",\n\t// [默认关闭] TypeScript 类型 props 和 required 声明已能表达可选性，不强制每个可选 prop 提供默认值。\n\t\"vue/require-default-prop\": \"off\",\n\t// [高影响] 组件必须声明对外事件；首次启用时会暴露未建模的公共事件 API。\n\t\"vue/require-explicit-emits\": \"error\",\n\t// [默认关闭] 允许 App、Layout 等约定俗成的单词组件名。\n\t\"vue/multi-word-component-names\": \"off\",\n\t// 优先从 vue 入口导入由 Vue 重新导出的 API，避免依赖内部包边界。\n\t\"vue/prefer-import-from-vue\": \"warn\",\n\n\t// 防止 props、data、computed、methods 等组件命名空间出现冲突。\n\t\"vue/no-dupe-keys\": \"error\",\n\t// [高影响] 禁止组件直接修改 props，要求通过事件或本地状态维持单向数据流。\n\t\"vue/no-mutating-props\": \"error\",\n\t// 避免自定义组件名与 Vue 内置组件冲突。\n\t\"vue/no-reserved-component-names\": \"error\",\n\t// [安全关注] 禁止在组件节点上使用 v-text/v-html，避免覆盖组件内容和模糊数据边界。\n\t\"vue/no-v-text-v-html-on-component\": \"error\",\n\t// 统一模板与脚本中的自定义事件名称为 camelCase。\n\t\"vue/custom-event-name-casing\": [\"error\", \"camelCase\"],\n\t// [默认关闭] 允许在一个 SFC 中声明仅供当前文件使用的小型辅助组件。\n\t\"vue/one-component-per-file\": \"off\",\n\t// [高影响][可自动修复] 统一模板属性分组；首次启用可能产生大量仅排序的模板差异。\n\t\"vue/attributes-order\": [\n\t\t\"error\",\n\t\t{\n\t\t\torder: [\"DEFINITION\", \"LIST_RENDERING\", \"CONDITIONALS\", \"RENDER_MODIFIERS\", \"GLOBAL\", \"UNIQUE\", \"OTHER_ATTR\", \"EVENTS\", \"CONTENT\"],\n\t\t},\n\t],\n} satisfies RuleOptions;\n"],"mappings":"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N;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;GACD;GACA,aAAa;EACd;EAEA;GACC,OAAO,EAAE,MAAM,MAAM;GACrB,aAAa;EACd;EAEA;GACC,OAAO,EAAE,MAAM,MAAM;GACrB,aAAa;EACd;CACD;AACD;;;;;;;;;ACvEA,MAAa,wBAAwB;CAEpC,qBAAqB;CAGrB,mBAAmB;EAClB;EAEA;GACC,OAAO;IAAC;IAAW;IAAmB;IAAc;IAAS;IAAW;GAAS;GACjF,aAAa;EACd;EAEA;GACC,OAAO;IAEN;IACA;IACA;IACA;IACA;IACA;IAEA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IAEA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IAEA;IACA;IACA;IAEA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IAEA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IAEA;IACA;IACA;IACA;IACA;IACA;IAEA;IACA;GACD;GACA,aAAa;EACd;CACD;AACD;;;;;;;ACtHA,MAAa,kBAAkB;CAE9B,mCAAmC;CAEnC,qCAAqC,CACpC,SACA;EACC,MAAM;EACN,mBAAmB;EACnB,cAAc;EACd,2BAA2B;EAC3B,oBAAoB;EACpB,mBAAmB;CACpB,CACD;CAEA,mCAAmC;CAEnC,sCAAsC;CAEtC,yCAAyC;CAEzC,4CAA4C,CAC3C,SACA;EACC,mBAAmB;EACnB,cAAc;CACf,CACD;CAEA,0CAA0C;CAE1C,4CAA4C;CAE5C,0DAA0D;CAE1D,8CAA8C,CAC7C,SACA;EACC,yBAAyB;EACzB,UAAU;EACV,QAAQ;CACT,CACD;AACD;;;;;;;AC5CA,MAAa,WAAW;CAEvB,iBAAiB;CAEjB,4BAA4B;CAE5B,8BAA8B;CAE9B,kCAAkC;CAElC,8BAA8B;CAG9B,oBAAoB;CAEpB,yBAAyB;CAEzB,mCAAmC;CAEnC,qCAAqC;CAErC,gCAAgC,CAAC,SAAS,WAAW;CAErD,8BAA8B;CAE9B,wBAAwB,CACvB,SACA,EACC,OAAO;EAAC;EAAc;EAAkB;EAAgB;EAAoB;EAAU;EAAU;EAAc;EAAU;CAAS,EAClI,CACD;AACD"}

package/docs/engineering-audit.zh.md

@@ -2,20 +2,20 @@
 
 审查日期：2026-07-26
 
-审查对象：`@fast-china/eslint-config` 2.0.0 工作区
+审查对象：`@fast-china/eslint-config` 2.0.1 工作区
 
 ## 结论
 
 当前仓库已经具备完整 ESLint Flat Config 开源库所需的核心能力：稳定且精简的公共 API、明确的语言作用域、可选类型感知检查、精确规则类型、可重复构建、集成测试、CI、发布归档检查和中英文文档。
 
-默认场景面向 Vue 3 + Vite + TypeScript，同时支持 JavaScript、Node.js、JSON、JSONC、JSON5、Markdown、正则表达式和模块导入检查。所有可选能力均通过 `fastConfig(options, ...overrides)` 组合，项目覆写始终位于内置配置之后。
+默认场景面向 Vue 3 + Vite + TypeScript，同时提供按需启用的一等 React 与 Angular 集成，并支持 JavaScript、Node.js、JSON、JSONC、JSON5、Markdown、正则表达式和模块导入检查。所有可选能力均通过 `fastConfig(options, ...overrides)` 组合，项目覆写始终位于内置配置之后。
 
 ## 审查范围
 
 - npm 包元数据、ESM 入口、公开子路径与发布文件
-- TypeScript、tsup、类型生成与声明文件
+- TypeScript 6、tsdown、类型生成与声明文件
 - ESLint Flat Config 顺序、文件作用域、解析器和插件注册
-- JavaScript、TypeScript、Vue、JSON 方言、Markdown、RegExp 与 import 集成
+- JavaScript、TypeScript、Vue、React、Angular、JSON 方言、Markdown、RegExp 与 import 集成
 - 浏览器、Node.js、通用环境和项目自定义全局变量
 - Lodash 静态导入策略、清单排序与 Prettier 职责边界
 - README、规则风险说明、贡献流程、CI、测试和发布前检查
@@ -27,6 +27,8 @@
 | 公共 API       | 通过 | 根入口提供 `fastConfig`、`defaultConfigOptions`、`defineRules` 和相关类型 |
 | Flat Config    | 通过 | 所有语言和插件配置限定到明确文件范围，项目覆写最后应用                    |
 | Vue 3          | 通过 | `vue-eslint-parser` 处理 SFC，TypeScript 解析器正确嵌套                   |
+| React          | 通过 | 按需覆盖 JSX/TSX、组件、官方 Hooks、Compiler 诊断与 DOM 安全              |
+| Angular        | 通过 | 按需覆盖框架 TypeScript、外部 HTML、内联模板与模板无障碍                  |
 | TypeScript     | 通过 | 默认使用推荐规则，可选 Project Service 类型感知模式                       |
 | JavaScript     | 通过 | 应用 `@eslint/js` 推荐规则并区分应用环境与 Node.js 工程文件               |
 | 数据与文档文件 | 通过 | JSON、JSONC、JSON5 和 Markdown 分别使用对应语言配置                       |
@@ -34,7 +36,7 @@
 | Lodash 策略    | 通过 | 可选统一 `lodash` 或 `lodash-unified`，默认不限制项目依赖选择             |
 | 清单排序       | 通过 | 默认关闭；启用后不会重排 `package.json#exports` 条件键                    |
 | Prettier       | 通过 | 只关闭冲突规则，格式化由 Prettier CLI 或编辑器负责                        |
-| 构建与发布     | 通过 | tsup 生成 ESM、声明和 source map，`prepack` 执行完整质量门禁              |
+| 构建与发布     | 通过 | tsdown 生成 `.mjs`、`.d.mts` 和 source map，`prepack` 执行完整质量门禁    |
 | 自动化验证     | 通过 | 运行时测试、消费者类型测试、格式检查、静态检查和 Node.js 多版本 CI        |
 
 ## 配置组合模型
@@ -43,7 +45,7 @@
 
 1. 内置忽略项、项目附加忽略项和可选 `.gitignore`。
 2. 应用运行环境、项目全局变量和 Node.js 工程文件全局变量。
-3. JavaScript、import-x、Lodash 策略、RegExp、TypeScript、JSON 方言、Vue 和 Markdown 配置。
+3. JavaScript、import-x、Lodash 策略、RegExp、TypeScript、JSON 方言、Vue、React、Angular 和 Markdown 配置。
 4. 可选 `package.json`、`tsconfig*.json` 排序配置。
 5. Prettier 冲突关闭配置。
 6. 工厂级 `rules` 与调用方传入的文件级覆写。
@@ -56,6 +58,7 @@
 - 高影响、可自动修复、安全相关和按需启用规则使用统一标签。
 - 默认高影响规则同步记录在中英文风险指南中。
 - `src/typegen.d.ts` 由规则 schema 生成，不允许手工编辑。
+- React、Angular 插件也参与类型生成，因此框架规则名与选项可获得同样的精确自动补全。
 - ESLint 或插件升级后必须运行 `pnpm typegen` 并审查类型差异。
 - `@fast-china/eslint-config/rules` 提供有完整注释的原始规则记录，便于高级组合。
 
@@ -79,17 +82,18 @@ pnpm pack --dry-run
 5. Prettier 格式检查。
 6. 消费者类型测试和运行时集成测试。
 
-发布归档必须包含根入口和 `./rules` 子入口的 JavaScript、声明文件和 source map，且不得包含源码缓存、测试缓存或本地依赖目录。
+发布归档必须包含根入口和 `./rules` 子入口的 JavaScript 与声明文件，以及生成的 JavaScript、声明 source map；且不得包含源码缓存、测试缓存或本地依赖目录。
 
 ## CI 与发布边界
 
-GitHub Actions 在 `master`、`main` 推送和 Pull Request 上运行，覆盖 Node.js 22.13 和 24。CI 使用 pnpm 11.x、冻结锁文件安装、完整质量门禁和发布归档预览。
+GitHub Actions 在 `master`、`main` 推送和 Pull Request 上运行，覆盖 Node.js 22.18 和 24.11。CI 使用 pnpm 11.x、冻结锁文件安装、完整质量门禁和发布归档预览。
 
 CI 只验证代码和发布包，不自动发布 npm。正式发布仍由维护者确认版本、Changelog、归档内容和 npm 身份后执行。
 
 ## 剩余风险
 
 - ESLint 和插件推荐预置会随依赖升级变化，每次升级都要检查实际生效配置和生成类型差异。
+- React 与 Angular 默认关闭；启用 Angular 时必须同时启用 TypeScript，并把现代组件、变更检测、控制流和无障碍规则作为框架接入成本审查。
 - 类型感知模式依赖项目 `tsconfig.json` 覆盖被检查文件，复杂 monorepo 应显式设置 `tsconfigRootDir`。
 - 自动修复可能调整 import、模板属性、正则表达式和清单字段，应在独立提交中审查结果。
 - Lodash 策略只覆盖静态模块语法；需要限制 CommonJS 或动态导入的项目应追加自己的文件级规则或代码审查约定。