@fast-china/eslint-config 2.1.5 → 2.1.7

package/dist/typegen.d.mts

@@ -1,6 +1,6 @@
 import { Linter } from "eslint";
 //#region src/typegen.d.ts
-interface RuleOptions {
+export interface RuleOptions {
   /**
    * Classes decorated with @Component must have suffix "Component" (or custom) in their name. Note: As of v20, this is no longer recommended by the Angular Team.
    * @see https://github.com/angular-eslint/angular-eslint/blob/main/packages/eslint-plugin/docs/rules/component-class-suffix.md
@@ -50,7 +50,7 @@ interface RuleOptions {
    * Requires inject() calls to be declared at the top of the class, before any other member
    * @see https://github.com/angular-eslint/angular-eslint/blob/main/packages/eslint-plugin/docs/rules/inject-at-top.md
    */
-  '@angular-eslint/inject-at-top'?: Linter.RuleEntry<[]>;
+  '@angular-eslint/inject-at-top'?: Linter.RuleEntry<AngularEslintInjectAtTop>;
   /**
    * Angular Lifecycle methods should not be async. Angular does not wait for async lifecycle but the code incorrectly suggests it does.
    * @see https://github.com/angular-eslint/angular-eslint/blob/main/packages/eslint-plugin/docs/rules/no-async-lifecycle-method.md
@@ -165,7 +165,7 @@ interface RuleOptions {
    * Ensures components do not opt out of the default `ChangeDetectionStrategy.OnPush` change detection strategy
    * @see https://github.com/angular-eslint/angular-eslint/blob/main/packages/eslint-plugin/docs/rules/prefer-on-push-component-change-detection.md
    */
-  '@angular-eslint/prefer-on-push-component-change-detection'?: Linter.RuleEntry<[]>;
+  '@angular-eslint/prefer-on-push-component-change-detection'?: Linter.RuleEntry<AngularEslintPreferOnPushComponentChangeDetection>;
   /**
    * Use `OutputEmitterRef` instead of `@Output()`
    * @see https://github.com/angular-eslint/angular-eslint/blob/main/packages/eslint-plugin/docs/rules/prefer-output-emitter-ref.md
@@ -185,7 +185,7 @@ interface RuleOptions {
    * Use `model` instead of `input` and `output` for two-way bindings
    * @see https://github.com/angular-eslint/angular-eslint/blob/main/packages/eslint-plugin/docs/rules/prefer-signal-model.md
    */
-  '@angular-eslint/prefer-signal-model'?: Linter.RuleEntry<[]>;
+  '@angular-eslint/prefer-signal-model'?: Linter.RuleEntry<AngularEslintPreferSignalModel>;
   /**
    * Use readonly signals instead of `@Input()`, `@ViewChild()` and other legacy decorators
    * @see https://github.com/angular-eslint/angular-eslint/blob/main/packages/eslint-plugin/docs/rules/prefer-signals.md
@@ -196,6 +196,11 @@ interface RuleOptions {
    * @see https://github.com/angular-eslint/angular-eslint/blob/main/packages/eslint-plugin/docs/rules/prefer-standalone.md
    */
   '@angular-eslint/prefer-standalone'?: Linter.RuleEntry<[]>;
+  /**
+   * Ensures that reactive contexts such as computed(), linkedSignal() and effect() read at least one reactive value (a signal). A reactive context with no reactive dependencies never re-runs, which is almost always a mistake.
+   * @see https://github.com/angular-eslint/angular-eslint/blob/main/packages/eslint-plugin/docs/rules/reactive-context-must-read-signal.md
+   */
+  '@angular-eslint/reactive-context-must-read-signal'?: Linter.RuleEntry<AngularEslintReactiveContextMustReadSignal>;
   /**
    * The ./ and ../ prefix is standard syntax for relative URLs; don't depend on Angular's current ability to do without that prefix.
    * @see https://github.com/angular-eslint/angular-eslint/blob/main/packages/eslint-plugin/docs/rules/relative-url-prefix.md
@@ -217,7 +222,7 @@ interface RuleOptions {
    */
   '@angular-eslint/runtime-localize'?: Linter.RuleEntry<[]>;
   /**
-   * Ensures that keys in type decorators (Component, Directive, NgModule, Pipe) are sorted in a consistent order
+   * Ensures that keys in type decorators (Component, Directive, Injectable, NgModule, Pipe) are sorted in a consistent order
    * @see https://github.com/angular-eslint/angular-eslint/blob/main/packages/eslint-plugin/docs/rules/sort-keys-in-type-decorator.md
    */
   '@angular-eslint/sort-keys-in-type-decorator'?: Linter.RuleEntry<AngularEslintSortKeysInTypeDecorator>;
@@ -401,6 +406,11 @@ interface RuleOptions {
    * @see https://github.com/angular-eslint/angular-eslint/blob/main/packages/eslint-plugin-template/docs/rules/prefer-static-string-properties.md
    */
   '@angular-eslint/template/prefer-static-string-properties'?: Linter.RuleEntry<AngularEslintTemplatePreferStaticStringProperties>;
+  /**
+   * Suggests using [style] bindings over ngStyle where applicable
+   * @see https://github.com/angular-eslint/angular-eslint/blob/main/packages/eslint-plugin-template/docs/rules/prefer-style-binding.md
+   */
+  '@angular-eslint/template/prefer-style-binding'?: Linter.RuleEntry<[]>;
   /**
    * Ensure that template literals are used instead of concatenating strings or expressions.
    * @see https://github.com/angular-eslint/angular-eslint/blob/main/packages/eslint-plugin-template/docs/rules/prefer-template-literal.md
@@ -552,7 +562,7 @@ interface RuleOptions {
    */
   '@eslint-react/globals'?: Linter.RuleEntry<[]>;
   /**
-   * Validates against passing functions that mutate captured local variables into frozen contexts such as JSX props, hook arguments, and hook return values.
+   * Validates against mutating props, state, and other immutable values, including through functions passed into frozen contexts such as JSX props, hook arguments, and hook return values.
    * @see https://eslint-react.xyz/docs/rules/immutability
    */
   '@eslint-react/immutability'?: Linter.RuleEntry<[]>;
@@ -907,7 +917,7 @@ interface RuleOptions {
    */
   '@eslint-react/x-globals'?: Linter.RuleEntry<[]>;
   /**
-   * Validates against passing functions that mutate captured local variables into frozen contexts such as JSX props, hook arguments, and hook return values.
+   * Validates against mutating props, state, and other immutable values, including through functions passed into frozen contexts such as JSX props, hook arguments, and hook return values.
    * @see https://eslint-react.xyz/docs/rules/immutability
    */
   '@eslint-react/x-immutability'?: Linter.RuleEntry<[]>;
@@ -1367,6 +1377,11 @@ interface RuleOptions {
    * @see https://typescript-eslint.io/rules/no-for-in-array
    */
   '@typescript-eslint/no-for-in-array'?: Linter.RuleEntry<[]>;
+  /**
+   * Disallow type operations that resolve to the "empty object" type
+   * @see https://typescript-eslint.io/rules/no-generated-empty-object-type
+   */
+  '@typescript-eslint/no-generated-empty-object-type'?: Linter.RuleEntry<[]>;
   /**
    * Disallow the use of `eval()`-like functions
    * @see https://typescript-eslint.io/rules/no-implied-eval
@@ -3499,7 +3514,7 @@ interface RuleOptions {
    * Disallow unmodified loop conditions
    * @see https://eslint.org/docs/latest/rules/no-unmodified-loop-condition
    */
-  'no-unmodified-loop-condition'?: Linter.RuleEntry<[]>;
+  'no-unmodified-loop-condition'?: Linter.RuleEntry<NoUnmodifiedLoopCondition>;
   /**
    * Disallow ternary operators when simpler alternatives exist
    * @see https://eslint.org/docs/latest/rules/no-unneeded-ternary
@@ -5150,6 +5165,11 @@ interface RuleOptions {
    * @see https://eslint.vuejs.org/rules/no-setup-props-reactivity-loss.html
    */
   'vue/no-setup-props-reactivity-loss'?: Linter.RuleEntry<[]>;
+  /**
+   * disallow the use of event names that collide with native web event names
+   * @see https://eslint.vuejs.org/rules/no-shadow-native-events.html
+   */
+  'vue/no-shadow-native-events'?: Linter.RuleEntry<[]>;
   /**
    * enforce component's data property to be a function
    * @see https://eslint.vuejs.org/rules/no-shared-component-data.html
@@ -5826,6 +5846,10 @@ type AngularEslintDirectiveSelector = [] | [({
   prefix?: (string | unknown[]);
   style: ("camelCase" | "kebab-case");
 }])];
+// ----- @angular-eslint/inject-at-top -----
+type AngularEslintInjectAtTop = [] | [{
+  additionalInjectFunctions?: string[];
+}];
 // ----- @angular-eslint/no-input-prefix -----
 type AngularEslintNoInputPrefix = [] | [{
   prefixes?: string[];
@@ -5838,6 +5862,14 @@ type AngularEslintNoInputRename = [] | [{
 type AngularEslintPipePrefix = [] | [{
   prefixes?: string[];
 }];
+// ----- @angular-eslint/prefer-on-push-component-change-detection -----
+type AngularEslintPreferOnPushComponentChangeDetection = [] | [{
+  allowExplicitOnPush?: boolean;
+}];
+// ----- @angular-eslint/prefer-signal-model -----
+type AngularEslintPreferSignalModel = [] | [{
+  useTypeChecking?: boolean;
+}];
 // ----- @angular-eslint/prefer-signals -----
 type AngularEslintPreferSignals = [] | [{
   preferReadonlySignalProperties?: boolean;
@@ -5846,6 +5878,10 @@ type AngularEslintPreferSignals = [] | [{
   useTypeChecking?: boolean;
   additionalSignalCreationFunctions?: string[];
 }];
+// ----- @angular-eslint/reactive-context-must-read-signal -----
+type AngularEslintReactiveContextMustReadSignal = [] | [{
+  checkResources?: boolean;
+}];
 // ----- @angular-eslint/require-localize-metadata -----
 type AngularEslintRequireLocalizeMetadata = [] | [{
   requireDescription?: boolean;
@@ -5856,8 +5892,10 @@ type AngularEslintRequireLocalizeMetadata = [] | [{
 type AngularEslintSortKeysInTypeDecorator = [] | [{
   Component?: string[];
   Directive?: string[];
+  Injectable?: string[];
   NgModule?: string[];
   Pipe?: string[];
+  allowUnconfiguredProperties?: boolean;
 }];
 // ----- @angular-eslint/template/attributes-order -----
 type AngularEslintTemplateAttributesOrder = [] | [{
@@ -5871,6 +5909,8 @@ type AngularEslintTemplateButtonHasType = [] | [{
 // ----- @angular-eslint/template/click-events-have-key-events -----
 type AngularEslintTemplateClickEventsHaveKeyEvents = [] | [{
   ignoreWithDirectives?: string[];
+  requireKeyCode?: boolean;
+  allowedKeyCodes?: string[];
 }];
 // ----- @angular-eslint/template/conditional-complexity -----
 type AngularEslintTemplateConditionalComplexity = [] | [{
@@ -5929,8 +5969,8 @@ type AngularEslintTemplateNoDuplicateAttributes = [] | [{
 }];
 // ----- @angular-eslint/template/no-inline-styles -----
 type AngularEslintTemplateNoInlineStyles = [] | [{
-  allowNgStyle?: boolean;
-  allowBindToStyle?: boolean;
+  allowNgStyle?: (boolean | "dynamic");
+  allowBindToStyle?: (boolean | "dynamic");
 }];
 // ----- @angular-eslint/template/no-interpolation-in-attributes -----
 type AngularEslintTemplateNoInterpolationInAttributes = [] | [{
@@ -5963,6 +6003,7 @@ type AngularEslintTemplateUseTrackByFunction = [] | [{
 // ----- @angular-eslint/use-injectable-provided-in -----
 type AngularEslintUseInjectableProvidedIn = [] | [{
   ignoreClassNamePattern?: string;
+  allowProvidedInNull?: boolean;
 }];
 // ----- @eslint-react/dom-no-unknown-property -----
 type EslintReactDomNoUnknownProperty = [] | [{
@@ -6593,7 +6634,9 @@ type TypescriptEslintNoMeaninglessVoidOperator = [] | [{
 }];
 // ----- @typescript-eslint/no-misused-promises -----
 type TypescriptEslintNoMisusedPromises = [] | [{
-  checksConditionals?: boolean;
+  checksConditionals?: (boolean | {
+    flagUnions?: ("all" | "strict" | "none");
+  });
   checksSpreads?: boolean;
   checksVoidReturn?: (boolean | {
     arguments?: boolean;
@@ -7745,15 +7788,19 @@ type JsoncSortKeys = ([{
   hasProperties?: string[];
   order: ((string | {
     keyPattern?: string;
-    order?: {
+    order?: ({
       type?: ("asc" | "desc");
       caseSensitive?: boolean;
       natural?: boolean;
-    };
+    } | {
+      type: "ignore";
+    });
   })[] | {
     type?: ("asc" | "desc");
     caseSensitive?: boolean;
     natural?: boolean;
+  } | {
+    type: "ignore";
   });
   minKeys?: number;
   allowLineSeparatedGroups?: boolean;
@@ -7762,15 +7809,19 @@ type JsoncSortKeys = ([{
   hasProperties?: string[];
   order: ((string | {
     keyPattern?: string;
-    order?: {
+    order?: ({
       type?: ("asc" | "desc");
       caseSensitive?: boolean;
       natural?: boolean;
-    };
+    } | {
+      type: "ignore";
+    });
   })[] | {
     type?: ("asc" | "desc");
     caseSensitive?: boolean;
     natural?: boolean;
+  } | {
+    type: "ignore";
   });
   minKeys?: number;
   allowLineSeparatedGroups?: boolean;
@@ -8694,6 +8745,10 @@ type NoUnderscoreDangle = [] | [{
   allowInArrayDestructuring?: boolean;
   allowInObjectDestructuring?: boolean;
 }];
+// ----- no-unmodified-loop-condition -----
+type NoUnmodifiedLoopCondition = [] | [{
+  checkConditionalExpressions?: boolean;
+}];
 // ----- no-unneeded-ternary -----
 type NoUnneededTernary = [] | [{
   defaultAssignment?: boolean;
@@ -10006,7 +10061,7 @@ type VueNoDeprecatedSlotAttribute = [] | [{
 }];
 // ----- vue/no-dupe-keys -----
 type VueNoDupeKeys = [] | [{
-  groups?: unknown[];
+  groups?: string[];
 }];
 // ----- vue/no-duplicate-attr-inheritance -----
 type VueNoDuplicateAttrInheritance = [] | [{
@@ -10129,8 +10184,8 @@ type VueNoReservedComponentNames = [] | [{
 }];
 // ----- vue/no-reserved-keys -----
 type VueNoReservedKeys = [] | [{
-  reserved?: unknown[];
-  groups?: unknown[];
+  reserved?: string[];
+  groups?: string[];
 }];
 // ----- vue/no-reserved-props -----
 type VueNoReservedProps = [] | [{
@@ -10218,7 +10273,7 @@ type VueNoTemplateTargetBlank = [] | [{
 }];
 // ----- vue/no-undef-components -----
 type VueNoUndefComponents = [] | [{
-  ignorePatterns?: unknown[];
+  ignorePatterns?: string[];
 }];
 // ----- vue/no-undef-directives -----
 type VueNoUndefDirectives = [] | [{
@@ -10325,7 +10380,7 @@ type VueOperatorLinebreak = [] | [("after" | "before" | "none" | null)] | [("aft
 }];
 // ----- vue/order-in-components -----
 type VueOrderInComponents = [] | [{
-  order?: unknown[];
+  order?: (string | string[])[];
 }];
 // ----- vue/padding-line-between-blocks -----
 type VuePaddingLineBetweenBlocks = [] | [("never" | "always")];
@@ -10414,8 +10469,8 @@ type VueSlotNameCasing = [] | [("camelCase" | "kebab-case" | "singleword")];
 // ----- vue/sort-keys -----
 type VueSortKeys = [] | [("asc" | "desc")] | [("asc" | "desc"), {
   caseSensitive?: boolean;
-  ignoreChildrenOf?: unknown[];
-  ignoreGrandchildrenOf?: unknown[];
+  ignoreChildrenOf?: string[];
+  ignoreGrandchildrenOf?: string[];
   minKeys?: number;
   natural?: boolean;
   allowLineSeparatedGroups?: boolean;
@@ -10474,7 +10529,7 @@ type VueValidVFor = [] | [{
 }];
 // ----- vue/valid-v-on -----
 type VueValidVOn = [] | [{
-  modifiers?: unknown[];
+  modifiers?: string[];
 }];
 // ----- vue/valid-v-slot -----
 type VueValidVSlot = [] | [{
@@ -10495,5 +10550,4 @@ type Yoda = [] | [("always" | "never")] | [("always" | "never"), {
   onlyEquality?: boolean;
 }];
 //#endregion
-export { RuleOptions };
 //# sourceMappingURL=typegen.d.mts.map

package/docs/engineering-audit.zh.md

@@ -13,7 +13,7 @@
 - JavaScript、TypeScript、Import 和 RegExp 只有一套共享规则。
 - `@/**` 根别名归入 internal；类型导入位于所有其他非样式导入之后，并在 type 总分组内按来源层级排序。
 - 样式导入由独立规则约束为最后一个连续分组，不参与普通 import 字母排序，也不提供自动修复。
-- TypeScript、Vue 和 React TypeScript 始终使用 `recommendedTypeChecked` 与 Project Service。
+- TypeScript、Vue 和 React TypeScript 始终使用 `strictTypeChecked`、`stylisticTypeChecked` 与 Project Service。
 - Vue 使用 `flat/recommended`，并叠加事件声明、kebab-case 属性、闭合标签和排序规则。
 - RegExp 使用显式审查过的正确性与安全规则，不继承完整偏好型推荐集合。
 - React 使用 `@eslint-react` 推荐预置和 React 官方 Hooks Recommended，并关闭重复实现。
@@ -38,7 +38,7 @@
 | ------------- | ---- | -------------------------------------------------- |
 | 公共 API      | 通过 | 根入口固定、其他能力由独立子路径组合               |
 | JavaScript    | 通过 | 核心 recommended + 统一现代语法规则                |
-| TypeScript    | 通过 | 固定 `recommendedTypeChecked` 与 Project Service   |
+| TypeScript    | 通过 | 固定严格、风格类型感知预置与 Project Service       |
 | Vue 3         | 通过 | `vue-eslint-parser` + `flat/recommended`           |
 | UniApp        | 通过 | 默认 `.nvue`、globals、清单注释和 `unpackage` 忽略 |
 | React         | 通过 | 显式组合 JSX/TSX、Hooks Recommended 与 DOM 安全    |

package/docs/rules-risk.md

@@ -1,6 +1,6 @@
 # Default Rules and Risk Guide
 
-This document describes the current 2.1.5 configuration model, major rules, and migration risks. Source comments explain current intent only; historical changes belong in `CHANGELOG.md`.
+This document describes the current 2.1.7 configuration model, major rules, and migration risks. Source comments explain current intent only; historical changes belong in `CHANGELOG.md`.
 
 ## Configuration model
 
@@ -21,23 +21,25 @@ The root entry is a fixed Vue 3 + TypeScript + UniApp preset:
 
 ## Preset sources
 
-| Domain     | Preset or implementation                                                   |
-| ---------- | -------------------------------------------------------------------------- |
-| JavaScript | `@eslint/js` recommended plus local rules                                  |
-| TypeScript | typescript-eslint `recommendedTypeChecked` plus Project Service            |
-| Vue        | `eslint-plugin-vue` `flat/recommended` plus type-aware TypeScript          |
-| React      | `@eslint-react` recommended/type-checked plus React Hooks Flat Recommended |
-| Angular    | Angular ESLint TypeScript, template, and accessibility recommended presets |
-| JSON       | `eslint-plugin-jsonc` recommended presets for three dialects               |
-| Import     | `eslint-plugin-import-x` recommended plus a fixed ordering policy          |
-| RegExp     | Explicit correctness, safety, and super-linear backtracking rules          |
-| Prettier   | `eslint-config-prettier` conflict disabling                                |
+| Domain     | Preset or implementation                                                      |
+| ---------- | ----------------------------------------------------------------------------- |
+| JavaScript | `@eslint/js` recommended plus local rules                                     |
+| TypeScript | typescript-eslint strict and stylistic type-checked presets + Project Service |
+| Vue        | `eslint-plugin-vue` `flat/recommended` plus type-aware TypeScript             |
+| React      | `@eslint-react` recommended/type-checked plus React Hooks Flat Recommended    |
+| Angular    | Angular ESLint TypeScript, template, and accessibility recommended presets    |
+| JSON       | `eslint-plugin-jsonc` recommended presets for three dialects                  |
+| Import     | `eslint-plugin-import-x` recommended plus a fixed ordering policy             |
+| RegExp     | Explicit correctness, safety, and super-linear backtracking rules             |
+| Prettier   | `eslint-config-prettier` conflict disabling                                   |
 
 ## Major rules
 
 ### JavaScript
 
-- `camelcase: ["error", { properties: "never" }]`
+- `camelcase: ["error", { properties: "never" }]` requires camelCase variables and types while preserving external protocol property names.
+- `no-empty` allows intentionally empty catches and still reports other empty blocks.
+- `no-eval` and `no-void` are errors; `curly: ["error", "multi-line", "consistent"]` applies, and an existing `default` branch must come last.
 - `no-debugger: "error"`
 - `no-use-before-define` warns; classes and variables must be declared first while function declarations may be hoisted.
 - `prefer-arrow-callback`, `logical-assignment-operators`, and `prefer-object-spread` are errors.
@@ -48,14 +50,22 @@ The root entry is a fixed Vue 3 + TypeScript + UniApp preset:
 
 ### TypeScript
 
-- `recommendedTypeChecked` and `projectService: true` are always enabled; TypeScript, TSX, Vue, and NVue share `extraFileExtensions: [".vue", ".nvue"]` to prevent Project Service reloads during mixed-file linting.
+- `strictTypeChecked`, `stylisticTypeChecked`, and `projectService: true` are always enabled; TypeScript, TSX, Vue, and NVue share `extraFileExtensions: [".vue", ".nvue"]` to prevent Project Service reloads during mixed-file linting.
+- `no-floating-promises` and `strict-void-return` are disabled so Promise waiting follows business semantics; `no-void` rejects `void promise` workarounds. `no-misused-promises`, `await-thenable`, `require-await`, and the unsafe-type rules remain strict, while Promise-returning handlers are allowed in Vue templates and TSX attributes.
+- Named TypeScript and TSX functions require explicit return types, except inline callbacks and already typed function expressions; exported module boundaries still require explicit types.
+- Vue/NVue SFCs disable function-return and module-boundary annotations and unused parameter checks, while unused variables and imports remain errors. Templates do not infer parameter types back into standalone script handlers, so those parameters still require explicit annotations.
 - `explicit-module-boundary-types` is an error and does not allow explicitly typed `any` arguments as an escape hatch.
-- `explicit-function-return-type` is not additionally enabled, so internal functions and callbacks can rely on inference.
 - `no-explicit-any` warns.
-- `no-unused-vars` is an error; an `_` prefix marks intentional omissions and rest siblings are ignored.
+- Regular TS/TSX parameters and caught errors can use an `_` prefix to mark intentional omissions; ordinary variables cannot use that prefix to evade the check.
 - `no-empty-function` only allows empty constructors and override methods.
-- `consistent-type-imports` fixes type-only dependencies as separate `import type` declarations.
+- `consistent-type-imports` fixes type-only dependencies as separate `import type` declarations, and `no-import-type-side-effects` rejects runtime imports containing only inline type specifiers.
 - `no-non-null-assertion` is an error.
+- `switch-exhaustiveness-check` is an error; `no-deprecated` and `no-unnecessary-condition` warn.
+- Numeric template interpolation and concise void arrow callbacks are allowed; dynamic object deletion and static-only utility classes are not forcibly rewritten.
+- `consistent-type-exports` and `prefer-readonly` are errors; primitive values are not forced from `||` to `??`.
+- `no-eval`, `no-implied-eval`, and `no-new-func` reject direct or indirect dynamic string execution; `no-promise-executor-return` rejects ignored executor returns, and Vue setup props or refs cannot be used in ways that lose reactivity.
+- `unified-signatures` preserves public overloads with different parameter names or standalone JSDoc; the stricter core `no-void` replaces `no-meaningless-void-operator`.
+- `consistent-type-definitions`, `consistent-indexed-object-style`, `class-literal-property-style`, and `prefer-regexp-exec` are disabled as syntax-only preferences.
 
 ### Vue
 

package/docs/rules-risk.zh.md

@@ -1,6 +1,6 @@
 # 默认规则与风险指南
 
-本文说明 2.1.5 当前配置模型、主要规则和迁移风险。规则源码注释只解释现行意图；历史差异统一记录在 `CHANGELOG.md`。
+本文说明 2.1.7 当前配置模型、主要规则和迁移风险。规则源码注释只解释现行意图；历史差异统一记录在 `CHANGELOG.md`。
 
 ## 配置模型
 
@@ -24,7 +24,7 @@ SDK、OA、Admin、Vue Web 与 UniApp 客户端共享同一套 JavaScript、Type
 | 领域       | 预置或实现                                                              |
 | ---------- | ----------------------------------------------------------------------- |
 | JavaScript | `@eslint/js` recommended + 本地规则                                     |
-| TypeScript | typescript-eslint `recommendedTypeChecked` + Project Service            |
+| TypeScript | typescript-eslint 严格与风格类型感知预置 + Project Service              |
 | Vue        | `eslint-plugin-vue` `flat/recommended` + 类型感知 TypeScript            |
 | React      | `@eslint-react` recommended/type-checked + React Hooks Flat Recommended |
 | Angular    | Angular ESLint TypeScript、模板及无障碍 recommended                     |
@@ -37,7 +37,9 @@ SDK、OA、Admin、Vue Web 与 UniApp 客户端共享同一套 JavaScript、Type
 
 ### JavaScript
 
-- `camelcase: ["error", { properties: "never" }]`
+- `camelcase: ["error", { properties: "never" }]`：变量和类型使用 camelCase，对象属性允许沿用外部协议字段名。
+- `no-empty` 允许明确忽略失败的空 catch，其他空代码块仍报错。
+- `no-eval` 与 `no-void` 为 `error`；`curly: ["error", "multi-line", "consistent"]`，已有的 `default` 分支必须位于最后。
 - `no-debugger: "error"`
 - `no-use-before-define` 为 `warn`；类和变量必须先声明，函数声明允许提升。
 - `prefer-arrow-callback`、`logical-assignment-operators`、`prefer-object-spread` 为 `error`。
@@ -48,14 +50,22 @@ SDK、OA、Admin、Vue Web 与 UniApp 客户端共享同一套 JavaScript、Type
 
 ### TypeScript
 
-- 始终启用 `recommendedTypeChecked` 与 `projectService: true`；TypeScript、TSX、Vue 与 NVue 统一使用 `extraFileExtensions: [".vue", ".nvue"]`，避免混合检查时 Project Service 重载项目。
+- 始终启用 `strictTypeChecked`、`stylisticTypeChecked` 与 `projectService: true`；TypeScript、TSX、Vue 与 NVue 统一使用 `extraFileExtensions: [".vue", ".nvue"]`，避免混合检查时 Project Service 重载项目。
+- `no-floating-promises` 与 `strict-void-return` 关闭，Promise 是否等待由业务语义决定；`no-void` 禁止用 `void promise` 规避检查。`no-misused-promises`、`await-thenable`、`require-await` 和 unsafe 类型规则保持严格，但 Vue 模板与 TSX 属性允许 Promise 返回的事件处理函数。
+- TypeScript 与 TSX 的命名函数要求显式返回类型，内联回调和已有函数类型约束的表达式除外；模块导出边界仍要求显式类型。
+- Vue/NVue SFC 关闭函数返回类型与模块边界类型要求，并关闭形参和 catch 形参的未使用检查；普通未使用变量和导入仍报错。模板不会反向推断独立处理函数的参数类型，这类参数仍需显式标注。
 - `explicit-module-boundary-types` 为 `error`，模块导出边界必须显式声明类型，不允许用显式 `any` 参数规避。
-- `explicit-function-return-type` 不额外启用，内部函数和回调可以依赖推断。
 - `no-explicit-any` 为 `warn`。
-- `no-unused-vars` 为 `error`；`_` 前缀表示有意忽略，rest siblings 不误报。
+- 普通 TS/TSX 的未使用参数和异常可用 `_` 前缀明确忽略；未使用普通变量不能用该前缀规避。
 - `no-empty-function` 仅允许空构造函数和空覆写方法。
-- `consistent-type-imports` 使用独立 `import type` 修复形式。
+- `consistent-type-imports` 使用独立 `import type` 修复形式，`no-import-type-side-effects` 禁止仅含内联类型说明符的运行时导入。
 - `no-non-null-assertion` 为 `error`。
+- `switch-exhaustiveness-check` 为 `error`；`no-deprecated` 与 `no-unnecessary-condition` 为 `warn`。
+- 模板字符串允许数字插值，箭头简写允许直接返回 void；动态对象字段删除和纯静态工具类不强制改写。
+- `consistent-type-exports` 与 `prefer-readonly` 为 `error`；原始类型不强制将 `||` 改成 `??`。
+- `no-eval`、`no-implied-eval` 与 `no-new-func` 禁止直接或间接动态执行字符串代码；`no-promise-executor-return` 禁止误用 Promise executor 返回值；Vue setup props 和 ref 禁止以丢失响应性的方式使用。
+- `unified-signatures` 保留参数名不同或具有独立 JSDoc 的公共重载；`no-meaningless-void-operator` 由更严格的核心 `no-void` 替代。
+- `consistent-type-definitions`、`consistent-indexed-object-style`、`class-literal-property-style`、`prefer-regexp-exec` 关闭，避免纯语法偏好阻断构建。
 
 ### Vue
 

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@fast-china/eslint-config",
-	"version": "2.1.5",
+	"version": "2.1.7",
 	"description": "Practical, typed ESLint Flat Config for Vue 3, UniApp, React, Angular, Vite, TypeScript, JavaScript, and Node.js.",
 	"type": "module",
 	"keywords": [
@@ -91,31 +91,31 @@
 		"typescript": "^6.0.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.1",
-		"@eslint/js": "^10.0.0",
+		"@angular-eslint/eslint-plugin": "^22.5.0",
+		"@angular-eslint/eslint-plugin-template": "^22.5.0",
+		"@angular-eslint/template-parser": "^22.5.0",
+		"@eslint-react/eslint-plugin": "^5.19.0",
+		"@eslint/js": "^10.0.1",
 		"@eslint/markdown": "^8.0.3",
-		"eslint-config-flat-gitignore": "^2.0.0",
-		"eslint-config-prettier": "^10.0.0",
+		"eslint-config-flat-gitignore": "^2.4.0",
+		"eslint-config-prettier": "^10.1.8",
 		"eslint-plugin-import-x": "^4.17.1",
-		"eslint-plugin-jsonc": "^3.3.0",
+		"eslint-plugin-jsonc": "^3.4.2",
 		"eslint-plugin-react-hooks": "^7.1.1",
-		"eslint-plugin-regexp": "^3.1.1",
-		"eslint-plugin-vue": "^10.10.0",
-		"globals": "^17.8.0",
-		"typescript-eslint": "^8.65.0",
+		"eslint-plugin-regexp": "^3.3.0",
+		"eslint-plugin-vue": "^10.11.0",
+		"globals": "^17.12.0",
+		"typescript-eslint": "^8.70.0",
 		"vue-eslint-parser": "^10.4.1"
 	},
 	"devDependencies": {
-		"@eslint/config-inspector": "^3.1.1",
-		"@types/node": "^24.13.3",
-		"eslint": "^10.8.0",
+		"@eslint/config-inspector": "^3.4.1",
+		"@types/node": "^24.13.4",
+		"eslint": "^10.10.0",
 		"eslint-typegen": "^2.3.1",
 		"prettier": "^3.9.6",
-		"tsdown": "^0.22.14",
-		"tsx": "^4.23.1",
+		"tsdown": "^0.23.0",
+		"tsx": "^4.23.13",
 		"typescript": "^6.0.3"
 	},
 	"engines": {