@fast-china/eslint-config 2.1.7 → 2.1.9

package/dist/rules/typescript.d.mts

@@ -3,19 +3,23 @@
  * TypeScript 本地覆写规则。
  *
  * @remarks
- * 普通 TS/TSX 的命名函数与公共模块边界要求显式类型，内联回调保留上下文推断；
- * strictTypeChecked 与 stylisticTypeChecked 预置负责补充类型语义和官方风格检查。
+ * `.ts`、`.mts` 与 `.cts` 导出成员视为模块公共 API，参数与返回类型必须显式声明；
+ * 内部实现和内联回调保留类型推断。TSX 由配置末尾覆写保留组件返回类型推断。
  */
 export declare const typescriptRules: {
+  /** 单独组合 `createTypeScriptConfigs()` 时也禁止用 `void` 操作符标记被忽略的 Promise。 */
   "no-void": "error";
-  "@typescript-eslint/explicit-function-return-type": ["error", {
-    allowExpressions: true;
-    allowTypedFunctionExpressions: true;
-  }];
+  /** TypeScript 重载与声明合并由扩展规则识别，关闭会把合法重载误判为重复声明的核心规则。 */
+  "no-redeclare": "off";
+  /** [默认关闭] 内部函数依赖 TypeScript 推断；公共导出边界由模块边界规则单独检查。 */
+  "@typescript-eslint/explicit-function-return-type": "off";
+  /** 导出函数和类的公共方法必须显式声明参数与返回类型，使公共 API 不依赖实现细节推断；参数不允许显式 `any`。 */
   "@typescript-eslint/explicit-module-boundary-types": ["error", {
     allowArgumentsExplicitlyTypedAsAny: false;
   }];
+  /** 使用 TypeScript 版本避免核心规则误判声明合并、类型和值的同名声明。 */
   "@typescript-eslint/no-redeclare": "error";
+  /** 未使用符号视为错误；仅参数和异常可用下划线明确表示有意忽略。 */
   "@typescript-eslint/no-unused-vars": ["error", {
     args: "after-used";
     argsIgnorePattern: string;
@@ -23,55 +27,119 @@ export declare const typescriptRules: {
     caughtErrorsIgnorePattern: string;
     ignoreRestSiblings: true;
   }];
+  /** [默认关闭] 声明文件、全局扩展和部分 SDK 仍需要 `namespace`。 */
   "@typescript-eslint/no-namespace": "off";
+  /** `any` 会绕过类型检查，但第三方边界和渐进迁移仍可能需要，因此只警告。 */
   "@typescript-eslint/no-explicit-any": "warn";
+  /** TypeScript 源码统一使用 ESM `import`；Node.js 工具文件由末尾覆写单独放开。 */
   "@typescript-eslint/no-require-imports": "error";
+  /** 禁止普通空函数，避免遗漏实现；仅允许无函数体逻辑的构造器和有意留空的重写方法。 */
   "@typescript-eslint/no-empty-function": ["error", {
     allow: ("constructors" | "overrideMethods")[];
   }];
+  /** 使用 TypeScript 版本识别类型断言等语法；允许常见的短路和三元表达式调用模式。 */
   "@typescript-eslint/no-unused-expressions": ["error", {
     allowShortCircuit: true;
     allowTernary: true;
   }];
-  "@typescript-eslint/no-inferrable-types": "error";
-  "@typescript-eslint/no-non-null-assertion": "error";
+  /** 删除局部变量中可直接推断的原始类型；参数和属性允许保留公共契约与文档信息。 */
+  "@typescript-eslint/no-inferrable-types": ["error", {
+    ignoreParameters: true;
+    ignoreProperties: true;
+  }];
+  /** [默认关闭] 已知运行时不变量可使用标准非空断言；矛盾、重复和无效断言仍由专项规则检查。 */
+  "@typescript-eslint/no-non-null-assertion": "off";
+  /** 可选链之后再做非空断言逻辑矛盾，通常表示边界条件设计有误。 */
   "@typescript-eslint/no-non-null-asserted-optional-chain": "error";
+  /** 纯类型依赖必须使用独立的 `import type`，避免生成无用运行时导入并统一导入声明结构。 */
   "@typescript-eslint/consistent-type-imports": ["error", {
     disallowTypeAnnotations: false;
     fixStyle: "separate-type-imports";
     prefer: "type-imports";
   }];
+  /** 禁止 `import { type Foo }` 产生仅用于类型的运行时导入，统一提升为独立的 `import type`。 */
   "@typescript-eslint/no-import-type-side-effects": "error";
 };
-/** 仅在 Project Service 提供完整类型信息后应用的 TypeScript 类型感知规则覆写。 */
+/**
+ * TypeScript 类型感知规则覆写。
+ *
+ * @remarks
+ * 这些规则只在 Project Service 提供完整类型信息后应用。覆写优先保留真实 Bug 与类型安全检查，
+ * 同时关闭会改变业务语义、强制单一语法形式或给通用 SDK 代码带来明显噪声的规则。
+ */
 export declare const typescriptTypeCheckedRules: {
+  /** [默认关闭] 是否等待、返回或处理 Promise 由开发者根据业务顺序和异常语义决定。 */
   "@typescript-eslint/no-floating-promises": "off";
+  /** [默认关闭] 不限制框架生命周期和事件回调的返回写法。 */
   "@typescript-eslint/strict-void-return": "off";
+  /** [默认关闭] 核心 `no-void` 已禁止全部 `void` 操作符，关闭类型感知的重复诊断。 */
   "@typescript-eslint/no-meaningless-void-operator": "off";
+  /** 保留简洁的 `() => notify()` 回调，其他容易混淆 `void` 值与返回值的用法继续检查。 */
   "@typescript-eslint/no-confusing-void-expression": ["error", {
     ignoreArrowShorthand: true;
   }];
+  /** 数字和布尔值是模板字符串的常见安全插值；对象、`any` 和空值仍需显式处理。 */
   "@typescript-eslint/restrict-template-expressions": ["error", {
+    allowBoolean: true;
     allowNumber: true;
   }];
+  /** [默认关闭] 动态删除对象字段是表单和字典的正常操作；数组 `delete` 仍由专项规则禁止。 */
   "@typescript-eslint/no-dynamic-delete": "off";
+  /** [默认关闭] 纯静态工具类可能是 SDK 的有意 API 设计，不强制改写为函数或对象。 */
   "@typescript-eslint/no-extraneous-class": "off";
+  /** 弃用 API 需要可见，但兼容多个依赖版本时不应直接阻断构建。 */
   "@typescript-eslint/no-deprecated": "warn";
-  "@typescript-eslint/no-unnecessary-condition": "warn";
+  /** [默认关闭] TypeScript 类型不一定覆盖外部输入的真实运行时，允许保留防御性条件。 */
+  "@typescript-eslint/no-unnecessary-condition": "off";
+  /** [默认关闭] 不强制使用 `interface` 或 `type` 的单一类型定义形式。 */
   "@typescript-eslint/consistent-type-definitions": "off";
+  /** [默认关闭] 不强制使用索引签名、`Record` 或映射类型中的某一种固定写法。 */
   "@typescript-eslint/consistent-indexed-object-style": "off";
+  /** [默认关闭] 不强制类的只读字面量属性改写为 getter 或字段中的某一种固定形式。 */
   "@typescript-eslint/class-literal-property-style": "off";
+  /** [默认关闭] 不强制使用 `RegExp#exec` 取代字符串匹配 API。 */
   "@typescript-eslint/prefer-regexp-exec": "off";
+  /** 纯类型导出必须使用 `export type`，避免生成或暗示不存在的运行时导出。 */
   "@typescript-eslint/consistent-type-exports": "error";
+  /** 只在构造阶段赋值且之后保持不变的私有成员应声明为 `readonly`。 */
   "@typescript-eslint/prefer-readonly": "error";
+  /** 原始类型的 `||` 与 `??` 可能承载不同业务语义，不为了风格强制互换。 */
   "@typescript-eslint/prefer-nullish-coalescing": ["error", {
     ignorePrimitives: true;
   }];
-  "@typescript-eslint/unified-signatures": ["error", {
-    ignoreDifferentlyNamedParameters: true;
-    ignoreOverloadsWithDifferentJSDoc: true;
+  /** 仅在类型明确包含 `null` 或 `undefined` 时要求使用可选链，避免改变其他假值的业务语义。 */
+  "@typescript-eslint/prefer-optional-chain": ["error", {
+    requireNullish: true;
   }];
+  /** [默认关闭] 公共重载会影响类型查询与调用契约，不为减少声明行数强制合并。 */
+  "@typescript-eslint/unified-signatures": "off";
+  /** 联合类型和枚举新增成员时，`switch` 必须覆盖全部分支或显式提供 `default`。 */
   "@typescript-eslint/switch-exhaustiveness-check": "error";
+  /** 禁止展开静态可知不可迭代或语义不匹配的值。 */
+  "@typescript-eslint/no-misused-spread": "error";
+  /** 禁止把不同类别的值混入同一枚举，避免比较和序列化语义不稳定。 */
+  "@typescript-eslint/no-mixed-enums": "error";
+  /** 非空断言与空值合并同时出现时逻辑矛盾。 */
+  "@typescript-eslint/no-non-null-asserted-nullish-coalescing": "error";
+  /** 删除不会改变条件结果的布尔字面量比较。 */
+  "@typescript-eslint/no-unnecessary-boolean-literal-compare": "error";
+  /** 删除模板字符串中没有插值语义的冗余表达式。 */
+  "@typescript-eslint/no-unnecessary-template-expression": "error";
+  /** 删除可由调用参数直接推断的显式泛型实参。 */
+  "@typescript-eslint/no-unnecessary-type-arguments": "error";
+  /** 禁止不会改变运行时值或静态类型的冗余转换。 */
+  "@typescript-eslint/no-unnecessary-type-conversion": "error";
+  /** 默认参数已经表达回退值，不再重复传入 `undefined`。 */
+  "@typescript-eslint/no-useless-default-assignment": "error";
+  /** getter 与 setter 必须使用相互兼容的类型。 */
+  "@typescript-eslint/related-getter-setter-pairs": "error";
+  /** 只在错误处理语义需要时要求 `return await`，不增加纯风格 `await`。 */
+  "@typescript-eslint/return-await": ["error", "error-handling-correctness-only"];
+  /** Promise `catch` 回调接收未知拒绝原因，使用 `unknown` 后再显式收窄。 */
+  "@typescript-eslint/use-unknown-in-catch-callback-variable": "error";
+  /** 无 `await` 的 `async` 会改变返回值和异常语义，应删除 `async` 或返回真实 Promise。 */
+  "@typescript-eslint/require-await": "error";
+  /** 允许透明转发外部 Promise 的未知拒绝原因；静态可知的 `string`、`number` 等仍会被报告。 */
   "@typescript-eslint/prefer-promise-reject-errors": ["error", {
     allowThrowingUnknown: true;
   }];

package/dist/rules/typescript.mjs

@@ -3,17 +3,21 @@
 * TypeScript 本地覆写规则。
 *
 * @remarks
-* 普通 TS/TSX 的命名函数与公共模块边界要求显式类型，内联回调保留上下文推断；
-* strictTypeChecked 与 stylisticTypeChecked 预置负责补充类型语义和官方风格检查。
+* `.ts`、`.mts` 与 `.cts` 导出成员视为模块公共 API，参数与返回类型必须显式声明；
+* 内部实现和内联回调保留类型推断。TSX 由配置末尾覆写保留组件返回类型推断。
 */
 const typescriptRules = {
+	/** 单独组合 `createTypeScriptConfigs()` 时也禁止用 `void` 操作符标记被忽略的 Promise。 */
 	"no-void": "error",
-	"@typescript-eslint/explicit-function-return-type": ["error", {
-		allowExpressions: true,
-		allowTypedFunctionExpressions: true
-	}],
+	/** TypeScript 重载与声明合并由扩展规则识别，关闭会把合法重载误判为重复声明的核心规则。 */
+	"no-redeclare": "off",
+	/** [默认关闭] 内部函数依赖 TypeScript 推断；公共导出边界由模块边界规则单独检查。 */
+	"@typescript-eslint/explicit-function-return-type": "off",
+	/** 导出函数和类的公共方法必须显式声明参数与返回类型，使公共 API 不依赖实现细节推断；参数不允许显式 `any`。 */
 	"@typescript-eslint/explicit-module-boundary-types": ["error", { allowArgumentsExplicitlyTypedAsAny: false }],
+	/** 使用 TypeScript 版本避免核心规则误判声明合并、类型和值的同名声明。 */
 	"@typescript-eslint/no-redeclare": "error",
+	/** 未使用符号视为错误；仅参数和异常可用下划线明确表示有意忽略。 */
 	"@typescript-eslint/no-unused-vars": ["error", {
 		args: "after-used",
 		argsIgnorePattern: "^_",
@@ -21,47 +25,111 @@ const typescriptRules = {
 		caughtErrorsIgnorePattern: "^_",
 		ignoreRestSiblings: true
 	}],
+	/** [默认关闭] 声明文件、全局扩展和部分 SDK 仍需要 `namespace`。 */
 	"@typescript-eslint/no-namespace": "off",
+	/** `any` 会绕过类型检查，但第三方边界和渐进迁移仍可能需要，因此只警告。 */
 	"@typescript-eslint/no-explicit-any": "warn",
+	/** TypeScript 源码统一使用 ESM `import`；Node.js 工具文件由末尾覆写单独放开。 */
 	"@typescript-eslint/no-require-imports": "error",
+	/** 禁止普通空函数，避免遗漏实现；仅允许无函数体逻辑的构造器和有意留空的重写方法。 */
 	"@typescript-eslint/no-empty-function": ["error", { allow: ["constructors", "overrideMethods"] }],
+	/** 使用 TypeScript 版本识别类型断言等语法；允许常见的短路和三元表达式调用模式。 */
 	"@typescript-eslint/no-unused-expressions": ["error", {
 		allowShortCircuit: true,
 		allowTernary: true
 	}],
-	"@typescript-eslint/no-inferrable-types": "error",
-	"@typescript-eslint/no-non-null-assertion": "error",
+	/** 删除局部变量中可直接推断的原始类型；参数和属性允许保留公共契约与文档信息。 */
+	"@typescript-eslint/no-inferrable-types": ["error", {
+		ignoreParameters: true,
+		ignoreProperties: true
+	}],
+	/** [默认关闭] 已知运行时不变量可使用标准非空断言；矛盾、重复和无效断言仍由专项规则检查。 */
+	"@typescript-eslint/no-non-null-assertion": "off",
+	/** 可选链之后再做非空断言逻辑矛盾，通常表示边界条件设计有误。 */
 	"@typescript-eslint/no-non-null-asserted-optional-chain": "error",
+	/** 纯类型依赖必须使用独立的 `import type`，避免生成无用运行时导入并统一导入声明结构。 */
 	"@typescript-eslint/consistent-type-imports": ["error", {
 		disallowTypeAnnotations: false,
 		fixStyle: "separate-type-imports",
 		prefer: "type-imports"
 	}],
+	/** 禁止 `import { type Foo }` 产生仅用于类型的运行时导入，统一提升为独立的 `import type`。 */
 	"@typescript-eslint/no-import-type-side-effects": "error"
 };
-/** 仅在 Project Service 提供完整类型信息后应用的 TypeScript 类型感知规则覆写。 */
+/**
+* TypeScript 类型感知规则覆写。
+*
+* @remarks
+* 这些规则只在 Project Service 提供完整类型信息后应用。覆写优先保留真实 Bug 与类型安全检查，
+* 同时关闭会改变业务语义、强制单一语法形式或给通用 SDK 代码带来明显噪声的规则。
+*/
 const typescriptTypeCheckedRules = {
+	/** [默认关闭] 是否等待、返回或处理 Promise 由开发者根据业务顺序和异常语义决定。 */
 	"@typescript-eslint/no-floating-promises": "off",
+	/** [默认关闭] 不限制框架生命周期和事件回调的返回写法。 */
 	"@typescript-eslint/strict-void-return": "off",
+	/** [默认关闭] 核心 `no-void` 已禁止全部 `void` 操作符，关闭类型感知的重复诊断。 */
 	"@typescript-eslint/no-meaningless-void-operator": "off",
+	/** 保留简洁的 `() => notify()` 回调，其他容易混淆 `void` 值与返回值的用法继续检查。 */
 	"@typescript-eslint/no-confusing-void-expression": ["error", { ignoreArrowShorthand: true }],
-	"@typescript-eslint/restrict-template-expressions": ["error", { allowNumber: true }],
+	/** 数字和布尔值是模板字符串的常见安全插值；对象、`any` 和空值仍需显式处理。 */
+	"@typescript-eslint/restrict-template-expressions": ["error", {
+		allowBoolean: true,
+		allowNumber: true
+	}],
+	/** [默认关闭] 动态删除对象字段是表单和字典的正常操作；数组 `delete` 仍由专项规则禁止。 */
 	"@typescript-eslint/no-dynamic-delete": "off",
+	/** [默认关闭] 纯静态工具类可能是 SDK 的有意 API 设计，不强制改写为函数或对象。 */
 	"@typescript-eslint/no-extraneous-class": "off",
+	/** 弃用 API 需要可见，但兼容多个依赖版本时不应直接阻断构建。 */
 	"@typescript-eslint/no-deprecated": "warn",
-	"@typescript-eslint/no-unnecessary-condition": "warn",
+	/** [默认关闭] TypeScript 类型不一定覆盖外部输入的真实运行时，允许保留防御性条件。 */
+	"@typescript-eslint/no-unnecessary-condition": "off",
+	/** [默认关闭] 不强制使用 `interface` 或 `type` 的单一类型定义形式。 */
 	"@typescript-eslint/consistent-type-definitions": "off",
+	/** [默认关闭] 不强制使用索引签名、`Record` 或映射类型中的某一种固定写法。 */
 	"@typescript-eslint/consistent-indexed-object-style": "off",
+	/** [默认关闭] 不强制类的只读字面量属性改写为 getter 或字段中的某一种固定形式。 */
 	"@typescript-eslint/class-literal-property-style": "off",
+	/** [默认关闭] 不强制使用 `RegExp#exec` 取代字符串匹配 API。 */
 	"@typescript-eslint/prefer-regexp-exec": "off",
+	/** 纯类型导出必须使用 `export type`，避免生成或暗示不存在的运行时导出。 */
 	"@typescript-eslint/consistent-type-exports": "error",
+	/** 只在构造阶段赋值且之后保持不变的私有成员应声明为 `readonly`。 */
 	"@typescript-eslint/prefer-readonly": "error",
+	/** 原始类型的 `||` 与 `??` 可能承载不同业务语义，不为了风格强制互换。 */
 	"@typescript-eslint/prefer-nullish-coalescing": ["error", { ignorePrimitives: true }],
-	"@typescript-eslint/unified-signatures": ["error", {
-		ignoreDifferentlyNamedParameters: true,
-		ignoreOverloadsWithDifferentJSDoc: true
-	}],
+	/** 仅在类型明确包含 `null` 或 `undefined` 时要求使用可选链，避免改变其他假值的业务语义。 */
+	"@typescript-eslint/prefer-optional-chain": ["error", { requireNullish: true }],
+	/** [默认关闭] 公共重载会影响类型查询与调用契约，不为减少声明行数强制合并。 */
+	"@typescript-eslint/unified-signatures": "off",
+	/** 联合类型和枚举新增成员时，`switch` 必须覆盖全部分支或显式提供 `default`。 */
 	"@typescript-eslint/switch-exhaustiveness-check": "error",
+	/** 禁止展开静态可知不可迭代或语义不匹配的值。 */
+	"@typescript-eslint/no-misused-spread": "error",
+	/** 禁止把不同类别的值混入同一枚举，避免比较和序列化语义不稳定。 */
+	"@typescript-eslint/no-mixed-enums": "error",
+	/** 非空断言与空值合并同时出现时逻辑矛盾。 */
+	"@typescript-eslint/no-non-null-asserted-nullish-coalescing": "error",
+	/** 删除不会改变条件结果的布尔字面量比较。 */
+	"@typescript-eslint/no-unnecessary-boolean-literal-compare": "error",
+	/** 删除模板字符串中没有插值语义的冗余表达式。 */
+	"@typescript-eslint/no-unnecessary-template-expression": "error",
+	/** 删除可由调用参数直接推断的显式泛型实参。 */
+	"@typescript-eslint/no-unnecessary-type-arguments": "error",
+	/** 禁止不会改变运行时值或静态类型的冗余转换。 */
+	"@typescript-eslint/no-unnecessary-type-conversion": "error",
+	/** 默认参数已经表达回退值，不再重复传入 `undefined`。 */
+	"@typescript-eslint/no-useless-default-assignment": "error",
+	/** getter 与 setter 必须使用相互兼容的类型。 */
+	"@typescript-eslint/related-getter-setter-pairs": "error",
+	/** 只在错误处理语义需要时要求 `return await`，不增加纯风格 `await`。 */
+	"@typescript-eslint/return-await": ["error", "error-handling-correctness-only"],
+	/** Promise `catch` 回调接收未知拒绝原因，使用 `unknown` 后再显式收窄。 */
+	"@typescript-eslint/use-unknown-in-catch-callback-variable": "error",
+	/** 无 `await` 的 `async` 会改变返回值和异常语义，应删除 `async` 或返回真实 Promise。 */
+	"@typescript-eslint/require-await": "error",
+	/** 允许透明转发外部 Promise 的未知拒绝原因；静态可知的 `string`、`number` 等仍会被报告。 */
 	"@typescript-eslint/prefer-promise-reject-errors": ["error", { allowThrowingUnknown: true }]
 };
 //#endregion

package/dist/rules/typescript.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"typescript.mjs","names":[],"sources":["../../src/rules/typescript.ts"],"sourcesContent":["import type { RuleOptions } from \"../typegen\";\n\n/**\n * TypeScript 本地覆写规则。\n *\n * @remarks\n * 普通 TS/TSX 的命名函数与公共模块边界要求显式类型，内联回调保留上下文推断；\n * strictTypeChecked 与 stylisticTypeChecked 预置负责补充类型语义和官方风格检查。\n */\nexport const typescriptRules = {\n\t// 单独组合 createTypeScriptConfigs() 时也禁止用 void 操作符标记被忽略的 Promise。\n\t\"no-void\": \"error\",\n\t// 普通 TS/TSX 函数要求显式返回类型；内联回调和已有函数类型约束的表达式继续依赖上下文推断。\n\t\"@typescript-eslint/explicit-function-return-type\": [\"error\", { allowExpressions: true, allowTypedFunctionExpressions: true }],\n\t// 导出函数和类的公共方法必须显式声明参数与返回类型，使公共 API 不依赖实现细节推断；参数不允许显式 any。\n\t\"@typescript-eslint/explicit-module-boundary-types\": [\"error\", { allowArgumentsExplicitlyTypedAsAny: false }],\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},\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// TypeScript 源码统一使用 ESM import；Node 工具文件由末尾覆写单独放开。\n\t\"@typescript-eslint/no-require-imports\": \"error\",\n\t// 禁止普通空函数，避免遗漏实现；仅允许无函数体逻辑的构造器和有意留空的重写方法。\n\t\"@typescript-eslint/no-empty-function\": [\"error\", { allow: [\"constructors\", \"overrideMethods\"] }],\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\": \"error\",\n\t// 可选链之后再做非空断言逻辑矛盾，通常表示边界条件设计有误。\n\t\"@typescript-eslint/no-non-null-asserted-optional-chain\": \"error\",\n\t// 纯类型依赖必须使用独立的 `import type`，避免生成无用运行时导入并统一导入声明结构。\n\t\"@typescript-eslint/consistent-type-imports\": [\n\t\t\"error\",\n\t\t{\n\t\t\tdisallowTypeAnnotations: false,\n\t\t\tfixStyle: \"separate-type-imports\",\n\t\t\tprefer: \"type-imports\",\n\t\t},\n\t],\n\t// 禁止 `import { type Foo }` 产生仅用于类型的运行时导入，统一提升为独立的 `import type`。\n\t\"@typescript-eslint/no-import-type-side-effects\": \"error\",\n} satisfies RuleOptions;\n\n/** 仅在 Project Service 提供完整类型信息后应用的 TypeScript 类型感知规则覆写。 */\nexport const typescriptTypeCheckedRules = {\n\t// 是否等待、返回或处理 Promise 由开发者根据业务顺序和异常语义决定。\n\t\"@typescript-eslint/no-floating-promises\": \"off\",\n\t// 不限制框架生命周期和事件回调的返回写法。\n\t\"@typescript-eslint/strict-void-return\": \"off\",\n\t// 核心 no-void 已禁止全部 void 操作符，关闭类型感知的重复诊断。\n\t\"@typescript-eslint/no-meaningless-void-operator\": \"off\",\n\t// 保留简洁的 `() => notify()` 回调，其他容易混淆 void 值与返回值的用法继续检查。\n\t\"@typescript-eslint/no-confusing-void-expression\": [\"error\", { ignoreArrowShorthand: true }],\n\t// 数字是模板字符串的常见安全插值；对象、any 和空值仍需显式处理。\n\t\"@typescript-eslint/restrict-template-expressions\": [\"error\", { allowNumber: true }],\n\t// 动态删除对象字段是表单和字典的正常操作；数组 delete 仍由 no-array-delete 禁止。\n\t\"@typescript-eslint/no-dynamic-delete\": \"off\",\n\t// 纯静态工具类可能是 SDK 的有意 API 设计，不强制改写为函数或对象。\n\t\"@typescript-eslint/no-extraneous-class\": \"off\",\n\t// 弃用 API 需要可见，但兼容多个依赖版本时不应直接阻断构建。\n\t\"@typescript-eslint/no-deprecated\": \"warn\",\n\t// TypeScript 类型不一定覆盖外部输入的真实运行时，防御性条件仅提醒审查。\n\t\"@typescript-eslint/no-unnecessary-condition\": \"warn\",\n\t// 语法形式不影响类型安全，不强制 interface/type、索引类型、字面量属性和 RegExp API 的单一写法。\n\t\"@typescript-eslint/consistent-type-definitions\": \"off\",\n\t\"@typescript-eslint/consistent-indexed-object-style\": \"off\",\n\t\"@typescript-eslint/class-literal-property-style\": \"off\",\n\t\"@typescript-eslint/prefer-regexp-exec\": \"off\",\n\t// 纯类型导出必须使用 export type，避免生成或暗示不存在的运行时导出。\n\t\"@typescript-eslint/consistent-type-exports\": \"error\",\n\t// 只在构造阶段赋值且之后保持不变的私有成员应声明为 readonly。\n\t\"@typescript-eslint/prefer-readonly\": \"error\",\n\t// 原始类型的 || 与 ?? 可能承载不同业务语义，不为了风格强制互换。\n\t\"@typescript-eslint/prefer-nullish-coalescing\": [\"error\", { ignorePrimitives: true }],\n\t// 参数名称或独立 JSDoc 属于公共重载契约；仅合并真正重复的签名。\n\t\"@typescript-eslint/unified-signatures\": [\n\t\t\"error\",\n\t\t{\n\t\t\tignoreDifferentlyNamedParameters: true,\n\t\t\tignoreOverloadsWithDifferentJSDoc: true,\n\t\t},\n\t],\n\t// 联合类型和枚举新增成员时，switch 必须覆盖全部分支或显式提供 default。\n\t\"@typescript-eslint/switch-exhaustiveness-check\": \"error\",\n\t// 允许透明转发外部 Promise 的未知拒绝原因；静态可知的 string、number 等仍会被报告。\n\t\"@typescript-eslint/prefer-promise-reject-errors\": [\"error\", { allowThrowingUnknown: true }],\n} satisfies RuleOptions;\n"],"mappings":";;;;;;;;AASA,MAAa,kBAAkB;CAE9B,WAAW;CAEX,oDAAoD,CAAC,SAAS;EAAE,kBAAkB;EAAM,+BAA+B;CAAK,CAAC;CAE7H,qDAAqD,CAAC,SAAS,EAAE,oCAAoC,MAAM,CAAC;CAE5G,mCAAmC;CAEnC,qCAAqC,CACpC,SACA;EACC,MAAM;EACN,mBAAmB;EACnB,cAAc;EACd,2BAA2B;EAC3B,oBAAoB;CACrB,CACD;CAEA,mCAAmC;CAEnC,sCAAsC;CAEtC,yCAAyC;CAEzC,wCAAwC,CAAC,SAAS,EAAE,OAAO,CAAC,gBAAgB,iBAAiB,EAAE,CAAC;CAEhG,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;CAEA,kDAAkD;AACnD;;AAGA,MAAa,6BAA6B;CAEzC,2CAA2C;CAE3C,yCAAyC;CAEzC,mDAAmD;CAEnD,mDAAmD,CAAC,SAAS,EAAE,sBAAsB,KAAK,CAAC;CAE3F,oDAAoD,CAAC,SAAS,EAAE,aAAa,KAAK,CAAC;CAEnF,wCAAwC;CAExC,0CAA0C;CAE1C,oCAAoC;CAEpC,+CAA+C;CAE/C,kDAAkD;CAClD,sDAAsD;CACtD,mDAAmD;CACnD,yCAAyC;CAEzC,8CAA8C;CAE9C,sCAAsC;CAEtC,gDAAgD,CAAC,SAAS,EAAE,kBAAkB,KAAK,CAAC;CAEpF,yCAAyC,CACxC,SACA;EACC,kCAAkC;EAClC,mCAAmC;CACpC,CACD;CAEA,kDAAkD;CAElD,mDAAmD,CAAC,SAAS,EAAE,sBAAsB,KAAK,CAAC;AAC5F"}
+{"version":3,"file":"typescript.mjs","names":[],"sources":["../../src/rules/typescript.ts"],"sourcesContent":["import type { RuleOptions } from \"../typegen\";\n\n/**\n * TypeScript 本地覆写规则。\n *\n * @remarks\n * `.ts`、`.mts` 与 `.cts` 导出成员视为模块公共 API，参数与返回类型必须显式声明；\n * 内部实现和内联回调保留类型推断。TSX 由配置末尾覆写保留组件返回类型推断。\n */\nexport const typescriptRules = {\n\t/** 单独组合 `createTypeScriptConfigs()` 时也禁止用 `void` 操作符标记被忽略的 Promise。 */\n\t\"no-void\": \"error\",\n\t/** TypeScript 重载与声明合并由扩展规则识别，关闭会把合法重载误判为重复声明的核心规则。 */\n\t\"no-redeclare\": \"off\",\n\t/** [默认关闭] 内部函数依赖 TypeScript 推断；公共导出边界由模块边界规则单独检查。 */\n\t\"@typescript-eslint/explicit-function-return-type\": \"off\",\n\t/** 导出函数和类的公共方法必须显式声明参数与返回类型，使公共 API 不依赖实现细节推断；参数不允许显式 `any`。 */\n\t\"@typescript-eslint/explicit-module-boundary-types\": [\"error\", { allowArgumentsExplicitlyTypedAsAny: false }],\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},\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/** TypeScript 源码统一使用 ESM `import`；Node.js 工具文件由末尾覆写单独放开。 */\n\t\"@typescript-eslint/no-require-imports\": \"error\",\n\t/** 禁止普通空函数，避免遗漏实现；仅允许无函数体逻辑的构造器和有意留空的重写方法。 */\n\t\"@typescript-eslint/no-empty-function\": [\"error\", { allow: [\"constructors\", \"overrideMethods\"] }],\n\t/** 使用 TypeScript 版本识别类型断言等语法；允许常见的短路和三元表达式调用模式。 */\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/** 删除局部变量中可直接推断的原始类型；参数和属性允许保留公共契约与文档信息。 */\n\t\"@typescript-eslint/no-inferrable-types\": [\"error\", { ignoreParameters: true, ignoreProperties: true }],\n\t/** [默认关闭] 已知运行时不变量可使用标准非空断言；矛盾、重复和无效断言仍由专项规则检查。 */\n\t\"@typescript-eslint/no-non-null-assertion\": \"off\",\n\t/** 可选链之后再做非空断言逻辑矛盾，通常表示边界条件设计有误。 */\n\t\"@typescript-eslint/no-non-null-asserted-optional-chain\": \"error\",\n\t/** 纯类型依赖必须使用独立的 `import type`，避免生成无用运行时导入并统一导入声明结构。 */\n\t\"@typescript-eslint/consistent-type-imports\": [\n\t\t\"error\",\n\t\t{\n\t\t\tdisallowTypeAnnotations: false,\n\t\t\tfixStyle: \"separate-type-imports\",\n\t\t\tprefer: \"type-imports\",\n\t\t},\n\t],\n\t/** 禁止 `import { type Foo }` 产生仅用于类型的运行时导入，统一提升为独立的 `import type`。 */\n\t\"@typescript-eslint/no-import-type-side-effects\": \"error\",\n} satisfies RuleOptions;\n\n/**\n * TypeScript 类型感知规则覆写。\n *\n * @remarks\n * 这些规则只在 Project Service 提供完整类型信息后应用。覆写优先保留真实 Bug 与类型安全检查，\n * 同时关闭会改变业务语义、强制单一语法形式或给通用 SDK 代码带来明显噪声的规则。\n */\nexport const typescriptTypeCheckedRules = {\n\t/** [默认关闭] 是否等待、返回或处理 Promise 由开发者根据业务顺序和异常语义决定。 */\n\t\"@typescript-eslint/no-floating-promises\": \"off\",\n\t/** [默认关闭] 不限制框架生命周期和事件回调的返回写法。 */\n\t\"@typescript-eslint/strict-void-return\": \"off\",\n\t/** [默认关闭] 核心 `no-void` 已禁止全部 `void` 操作符，关闭类型感知的重复诊断。 */\n\t\"@typescript-eslint/no-meaningless-void-operator\": \"off\",\n\t/** 保留简洁的 `() => notify()` 回调，其他容易混淆 `void` 值与返回值的用法继续检查。 */\n\t\"@typescript-eslint/no-confusing-void-expression\": [\"error\", { ignoreArrowShorthand: true }],\n\t/** 数字和布尔值是模板字符串的常见安全插值；对象、`any` 和空值仍需显式处理。 */\n\t\"@typescript-eslint/restrict-template-expressions\": [\"error\", { allowBoolean: true, allowNumber: true }],\n\t/** [默认关闭] 动态删除对象字段是表单和字典的正常操作；数组 `delete` 仍由专项规则禁止。 */\n\t\"@typescript-eslint/no-dynamic-delete\": \"off\",\n\t/** [默认关闭] 纯静态工具类可能是 SDK 的有意 API 设计，不强制改写为函数或对象。 */\n\t\"@typescript-eslint/no-extraneous-class\": \"off\",\n\t/** 弃用 API 需要可见，但兼容多个依赖版本时不应直接阻断构建。 */\n\t\"@typescript-eslint/no-deprecated\": \"warn\",\n\t/** [默认关闭] TypeScript 类型不一定覆盖外部输入的真实运行时，允许保留防御性条件。 */\n\t\"@typescript-eslint/no-unnecessary-condition\": \"off\",\n\t/** [默认关闭] 不强制使用 `interface` 或 `type` 的单一类型定义形式。 */\n\t\"@typescript-eslint/consistent-type-definitions\": \"off\",\n\t/** [默认关闭] 不强制使用索引签名、`Record` 或映射类型中的某一种固定写法。 */\n\t\"@typescript-eslint/consistent-indexed-object-style\": \"off\",\n\t/** [默认关闭] 不强制类的只读字面量属性改写为 getter 或字段中的某一种固定形式。 */\n\t\"@typescript-eslint/class-literal-property-style\": \"off\",\n\t/** [默认关闭] 不强制使用 `RegExp#exec` 取代字符串匹配 API。 */\n\t\"@typescript-eslint/prefer-regexp-exec\": \"off\",\n\t/** 纯类型导出必须使用 `export type`，避免生成或暗示不存在的运行时导出。 */\n\t\"@typescript-eslint/consistent-type-exports\": \"error\",\n\t/** 只在构造阶段赋值且之后保持不变的私有成员应声明为 `readonly`。 */\n\t\"@typescript-eslint/prefer-readonly\": \"error\",\n\t/** 原始类型的 `||` 与 `??` 可能承载不同业务语义，不为了风格强制互换。 */\n\t\"@typescript-eslint/prefer-nullish-coalescing\": [\"error\", { ignorePrimitives: true }],\n\t/** 仅在类型明确包含 `null` 或 `undefined` 时要求使用可选链，避免改变其他假值的业务语义。 */\n\t\"@typescript-eslint/prefer-optional-chain\": [\"error\", { requireNullish: true }],\n\t/** [默认关闭] 公共重载会影响类型查询与调用契约，不为减少声明行数强制合并。 */\n\t\"@typescript-eslint/unified-signatures\": \"off\",\n\t/** 联合类型和枚举新增成员时，`switch` 必须覆盖全部分支或显式提供 `default`。 */\n\t\"@typescript-eslint/switch-exhaustiveness-check\": \"error\",\n\t/** 禁止展开静态可知不可迭代或语义不匹配的值。 */\n\t\"@typescript-eslint/no-misused-spread\": \"error\",\n\t/** 禁止把不同类别的值混入同一枚举，避免比较和序列化语义不稳定。 */\n\t\"@typescript-eslint/no-mixed-enums\": \"error\",\n\t/** 非空断言与空值合并同时出现时逻辑矛盾。 */\n\t\"@typescript-eslint/no-non-null-asserted-nullish-coalescing\": \"error\",\n\t/** 删除不会改变条件结果的布尔字面量比较。 */\n\t\"@typescript-eslint/no-unnecessary-boolean-literal-compare\": \"error\",\n\t/** 删除模板字符串中没有插值语义的冗余表达式。 */\n\t\"@typescript-eslint/no-unnecessary-template-expression\": \"error\",\n\t/** 删除可由调用参数直接推断的显式泛型实参。 */\n\t\"@typescript-eslint/no-unnecessary-type-arguments\": \"error\",\n\t/** 禁止不会改变运行时值或静态类型的冗余转换。 */\n\t\"@typescript-eslint/no-unnecessary-type-conversion\": \"error\",\n\t/** 默认参数已经表达回退值，不再重复传入 `undefined`。 */\n\t\"@typescript-eslint/no-useless-default-assignment\": \"error\",\n\t/** getter 与 setter 必须使用相互兼容的类型。 */\n\t\"@typescript-eslint/related-getter-setter-pairs\": \"error\",\n\t/** 只在错误处理语义需要时要求 `return await`，不增加纯风格 `await`。 */\n\t\"@typescript-eslint/return-await\": [\"error\", \"error-handling-correctness-only\"],\n\t/** Promise `catch` 回调接收未知拒绝原因，使用 `unknown` 后再显式收窄。 */\n\t\"@typescript-eslint/use-unknown-in-catch-callback-variable\": \"error\",\n\t/** 无 `await` 的 `async` 会改变返回值和异常语义，应删除 `async` 或返回真实 Promise。 */\n\t\"@typescript-eslint/require-await\": \"error\",\n\t/** 允许透明转发外部 Promise 的未知拒绝原因；静态可知的 `string`、`number` 等仍会被报告。 */\n\t\"@typescript-eslint/prefer-promise-reject-errors\": [\"error\", { allowThrowingUnknown: true }],\n} satisfies RuleOptions;\n"],"mappings":";;;;;;;;AASA,MAAa,kBAAkB;;CAE9B,WAAW;;CAEX,gBAAgB;;CAEhB,oDAAoD;;CAEpD,qDAAqD,CAAC,SAAS,EAAE,oCAAoC,MAAM,CAAC;;CAE5G,mCAAmC;;CAEnC,qCAAqC,CACpC,SACA;EACC,MAAM;EACN,mBAAmB;EACnB,cAAc;EACd,2BAA2B;EAC3B,oBAAoB;CACrB,CACD;;CAEA,mCAAmC;;CAEnC,sCAAsC;;CAEtC,yCAAyC;;CAEzC,wCAAwC,CAAC,SAAS,EAAE,OAAO,CAAC,gBAAgB,iBAAiB,EAAE,CAAC;;CAEhG,4CAA4C,CAC3C,SACA;EACC,mBAAmB;EACnB,cAAc;CACf,CACD;;CAEA,0CAA0C,CAAC,SAAS;EAAE,kBAAkB;EAAM,kBAAkB;CAAK,CAAC;;CAEtG,4CAA4C;;CAE5C,0DAA0D;;CAE1D,8CAA8C,CAC7C,SACA;EACC,yBAAyB;EACzB,UAAU;EACV,QAAQ;CACT,CACD;;CAEA,kDAAkD;AACnD;;;;;;;;AASA,MAAa,6BAA6B;;CAEzC,2CAA2C;;CAE3C,yCAAyC;;CAEzC,mDAAmD;;CAEnD,mDAAmD,CAAC,SAAS,EAAE,sBAAsB,KAAK,CAAC;;CAE3F,oDAAoD,CAAC,SAAS;EAAE,cAAc;EAAM,aAAa;CAAK,CAAC;;CAEvG,wCAAwC;;CAExC,0CAA0C;;CAE1C,oCAAoC;;CAEpC,+CAA+C;;CAE/C,kDAAkD;;CAElD,sDAAsD;;CAEtD,mDAAmD;;CAEnD,yCAAyC;;CAEzC,8CAA8C;;CAE9C,sCAAsC;;CAEtC,gDAAgD,CAAC,SAAS,EAAE,kBAAkB,KAAK,CAAC;;CAEpF,4CAA4C,CAAC,SAAS,EAAE,gBAAgB,KAAK,CAAC;;CAE9E,yCAAyC;;CAEzC,kDAAkD;;CAElD,wCAAwC;;CAExC,qCAAqC;;CAErC,8DAA8D;;CAE9D,6DAA6D;;CAE7D,yDAAyD;;CAEzD,oDAAoD;;CAEpD,qDAAqD;;CAErD,oDAAoD;;CAEpD,kDAAkD;;CAElD,mCAAmC,CAAC,SAAS,iCAAiC;;CAE9E,6DAA6D;;CAE7D,oCAAoC;;CAEpC,mDAAmD,CAAC,SAAS,EAAE,sBAAsB,KAAK,CAAC;AAC5F"}

package/dist/rules/vue.d.mts

@@ -1,33 +1,88 @@
 //#region src/rules/vue.d.ts
 /**
- * Vue SFC 本地覆写规则。
+ * Vue 组件脚本语义规则。
  *
  * @remarks
- * 上游 `flat/recommended` 负责 Vue 3 正确性与模板约定；本记录补充事件、属性命名和
- * 闭合标签规则。Vue Web、Admin 与 UniApp 使用同一套严重级别。
+ * 这些规则可以检查 SFC 脚本以及使用 `defineComponent()`、Options API 或 `setup()` 的
+ * 独立 JSX/TSX 组件。纯模板语法规则由 {@link vueTemplateRules} 单独维护。
  */
-export declare const vueRules: {
-  "vue/no-v-html": "warn";
+export declare const vueScriptRules: {
+  /** [默认关闭] TypeScript 类型 props 和 `required` 声明已能表达可选性，不强制每个可选 prop 提供默认值。 */
   "vue/require-default-prop": "off";
+  /** 组件事件必须显式声明，形成可检查的对外事件契约。 */
   "vue/require-explicit-emits": "error";
+  /** [默认关闭] 允许 `App`、`Layout` 等约定俗成的单词组件名。 */
   "vue/multi-word-component-names": "off";
+  /** [默认关闭] 允许直接使用 Vue 子包入口，兼容编译器与运行时等明确子模块导入。 */
   "vue/prefer-import-from-vue": "off";
-  "vue/attribute-hyphenation": ["error", "always"];
+  /** `props`、`data`、`computed`、`methods` 等选项中禁止同名键，避免成员互相遮蔽。 */
   "vue/no-dupe-keys": "error";
+  /** Props 属于父组件只读输入，子组件应通过 emit 或本地状态更新。 */
   "vue/no-mutating-props": "error";
+  /** `setup` 中直接解构 props 会丢失响应性，要求保留 props 引用或使用 `toRefs` 等响应式转换。 */
   "vue/no-setup-props-reactivity-loss": "error";
+  /** 禁止以会丢失响应性的方式解构或传递 ref 对象，确保后续更新仍能被 Vue 追踪。 */
   "vue/no-ref-object-reactivity-loss": "error";
+  /** 组件名不能占用 Vue 内置组件或平台保留名称。 */
   "vue/no-reserved-component-names": "error";
-  "vue/no-v-text-v-html-on-component": "error";
+  /** `emit`、`emits` 和事件处理引用中的自定义事件名称统一使用 camelCase，原生 DOM 事件不受影响。 */
   "vue/custom-event-name-casing": ["error", "camelCase"];
+  /** [默认关闭] 允许在一个 SFC 中声明仅供当前文件使用的小型辅助组件。 */
   "vue/one-component-per-file": "off";
-  "vue/html-closing-bracket-newline": ["error", {
-    multiline: "always";
-    singleline: "never";
+};
+/**
+ * Vue 模板语法规则。
+ *
+ * @remarks
+ * 这些规则依赖 `vue-eslint-parser` 生成的模板节点，只应用于 `.vue` 与 `.nvue`。
+ * JSX 属性遵循 JavaScript 标识符和运行时约定，不能套用模板的 kebab-case 与属性排序。
+ */
+export declare const vueTemplateRules: {
+  /** `v-html` 可能引入 XSS；保留警告以兼容经过净化的富文本场景。 */
+  "vue/no-v-html": "warn";
+  /** 自定义组件的模板属性统一使用 kebab-case；脚本中的 Props 与 JSX 属性仍使用 camelCase。 */
+  "vue/attribute-hyphenation": ["error", "always"];
+  /** 禁止在组件节点使用 `v-text` 或 `v-html`，避免覆盖组件内容并模糊数据边界。 */
+  "vue/no-v-text-v-html-on-component": "error";
+  /** 模板属性按定义、循环、条件、修饰、唯一属性、全局属性、普通属性、事件和内容排序。 */
+  "vue/attributes-order": ["error", {
+    order: ("DEFINITION" | "LIST_RENDERING" | "CONDITIONALS" | "RENDER_MODIFIERS" | "GLOBAL" | "UNIQUE" | "OTHER_ATTR" | "EVENTS" | "CONTENT")[];
   }];
+};
+/** Vue SFC 同时使用组件脚本语义规则与模板语法规则。 */
+export declare const vueRules: {
+  /** `v-html` 可能引入 XSS；保留警告以兼容经过净化的富文本场景。 */
+  "vue/no-v-html": "warn";
+  /** 自定义组件的模板属性统一使用 kebab-case；脚本中的 Props 与 JSX 属性仍使用 camelCase。 */
+  "vue/attribute-hyphenation": ["error", "always"];
+  /** 禁止在组件节点使用 `v-text` 或 `v-html`，避免覆盖组件内容并模糊数据边界。 */
+  "vue/no-v-text-v-html-on-component": "error";
+  /** 模板属性按定义、循环、条件、修饰、唯一属性、全局属性、普通属性、事件和内容排序。 */
   "vue/attributes-order": ["error", {
     order: ("DEFINITION" | "LIST_RENDERING" | "CONDITIONALS" | "RENDER_MODIFIERS" | "GLOBAL" | "UNIQUE" | "OTHER_ATTR" | "EVENTS" | "CONTENT")[];
   }];
+  /** [默认关闭] TypeScript 类型 props 和 `required` 声明已能表达可选性，不强制每个可选 prop 提供默认值。 */
+  "vue/require-default-prop": "off";
+  /** 组件事件必须显式声明，形成可检查的对外事件契约。 */
+  "vue/require-explicit-emits": "error";
+  /** [默认关闭] 允许 `App`、`Layout` 等约定俗成的单词组件名。 */
+  "vue/multi-word-component-names": "off";
+  /** [默认关闭] 允许直接使用 Vue 子包入口，兼容编译器与运行时等明确子模块导入。 */
+  "vue/prefer-import-from-vue": "off";
+  /** `props`、`data`、`computed`、`methods` 等选项中禁止同名键，避免成员互相遮蔽。 */
+  "vue/no-dupe-keys": "error";
+  /** Props 属于父组件只读输入，子组件应通过 emit 或本地状态更新。 */
+  "vue/no-mutating-props": "error";
+  /** `setup` 中直接解构 props 会丢失响应性，要求保留 props 引用或使用 `toRefs` 等响应式转换。 */
+  "vue/no-setup-props-reactivity-loss": "error";
+  /** 禁止以会丢失响应性的方式解构或传递 ref 对象，确保后续更新仍能被 Vue 追踪。 */
+  "vue/no-ref-object-reactivity-loss": "error";
+  /** 组件名不能占用 Vue 内置组件或平台保留名称。 */
+  "vue/no-reserved-component-names": "error";
+  /** `emit`、`emits` 和事件处理引用中的自定义事件名称统一使用 camelCase，原生 DOM 事件不受影响。 */
+  "vue/custom-event-name-casing": ["error", "camelCase"];
+  /** [默认关闭] 允许在一个 SFC 中声明仅供当前文件使用的小型辅助组件。 */
+  "vue/one-component-per-file": "off";
 };
 //#endregion
 //# sourceMappingURL=vue.d.mts.map

package/dist/rules/vue.mjs

@@ -1,43 +1,70 @@
 //#region src/rules/vue.ts
 /**
-* Vue SFC 本地覆写规则。
+* Vue 组件脚本语义规则。
 *
 * @remarks
-* 上游 `flat/recommended` 负责 Vue 3 正确性与模板约定；本记录补充事件、属性命名和
-* 闭合标签规则。Vue Web、Admin 与 UniApp 使用同一套严重级别。
+* 这些规则可以检查 SFC 脚本以及使用 `defineComponent()`、Options API 或 `setup()` 的
+* 独立 JSX/TSX 组件。纯模板语法规则由 {@link vueTemplateRules} 单独维护。
 */
-const vueRules = {
-	"vue/no-v-html": "warn",
+const vueScriptRules = {
+	/** [默认关闭] TypeScript 类型 props 和 `required` 声明已能表达可选性，不强制每个可选 prop 提供默认值。 */
 	"vue/require-default-prop": "off",
+	/** 组件事件必须显式声明，形成可检查的对外事件契约。 */
 	"vue/require-explicit-emits": "error",
+	/** [默认关闭] 允许 `App`、`Layout` 等约定俗成的单词组件名。 */
 	"vue/multi-word-component-names": "off",
+	/** [默认关闭] 允许直接使用 Vue 子包入口，兼容编译器与运行时等明确子模块导入。 */
 	"vue/prefer-import-from-vue": "off",
-	"vue/attribute-hyphenation": ["error", "always"],
+	/** `props`、`data`、`computed`、`methods` 等选项中禁止同名键，避免成员互相遮蔽。 */
 	"vue/no-dupe-keys": "error",
+	/** Props 属于父组件只读输入，子组件应通过 emit 或本地状态更新。 */
 	"vue/no-mutating-props": "error",
+	/** `setup` 中直接解构 props 会丢失响应性，要求保留 props 引用或使用 `toRefs` 等响应式转换。 */
 	"vue/no-setup-props-reactivity-loss": "error",
+	/** 禁止以会丢失响应性的方式解构或传递 ref 对象，确保后续更新仍能被 Vue 追踪。 */
 	"vue/no-ref-object-reactivity-loss": "error",
+	/** 组件名不能占用 Vue 内置组件或平台保留名称。 */
 	"vue/no-reserved-component-names": "error",
-	"vue/no-v-text-v-html-on-component": "error",
+	/** `emit`、`emits` 和事件处理引用中的自定义事件名称统一使用 camelCase，原生 DOM 事件不受影响。 */
 	"vue/custom-event-name-casing": ["error", "camelCase"],
-	"vue/one-component-per-file": "off",
-	"vue/html-closing-bracket-newline": ["error", {
-		multiline: "always",
-		singleline: "never"
-	}],
+	/** [默认关闭] 允许在一个 SFC 中声明仅供当前文件使用的小型辅助组件。 */
+	"vue/one-component-per-file": "off"
+};
+/**
+* Vue 模板语法规则。
+*
+* @remarks
+* 这些规则依赖 `vue-eslint-parser` 生成的模板节点，只应用于 `.vue` 与 `.nvue`。
+* JSX 属性遵循 JavaScript 标识符和运行时约定，不能套用模板的 kebab-case 与属性排序。
+*/
+const vueTemplateRules = {
+	/** `v-html` 可能引入 XSS；保留警告以兼容经过净化的富文本场景。 */
+	"vue/no-v-html": "warn",
+	/** 自定义组件的模板属性统一使用 kebab-case；脚本中的 Props 与 JSX 属性仍使用 camelCase。 */
+	"vue/attribute-hyphenation": ["error", "always"],
+	/** 禁止在组件节点使用 `v-text` 或 `v-html`，避免覆盖组件内容并模糊数据边界。 */
+	"vue/no-v-text-v-html-on-component": "error",
+	/** 模板属性按定义、循环、条件、修饰、唯一属性、全局属性、普通属性、事件和内容排序。 */
 	"vue/attributes-order": ["error", { order: [
 		"DEFINITION",
 		"LIST_RENDERING",
 		"CONDITIONALS",
 		"RENDER_MODIFIERS",
-		"GLOBAL",
 		"UNIQUE",
+		"GLOBAL",
 		"OTHER_ATTR",
 		"EVENTS",
 		"CONTENT"
 	] }]
 };
+/** Vue SFC 同时使用组件脚本语义规则与模板语法规则。 */
+const vueRules = {
+	/** 复用可在 SFC 与独立 JSX/TSX 中检查的 Vue 组件脚本语义规则。 */
+	...vueScriptRules,
+	/** 叠加仅对 Vue 模板节点有效的语法规则。 */
+	...vueTemplateRules
+};
 //#endregion
-export { vueRules };
+export { vueRules, vueScriptRules, vueTemplateRules };
 
 //# sourceMappingURL=vue.mjs.map

package/dist/rules/vue.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"vue.mjs","names":[],"sources":["../../src/rules/vue.ts"],"sourcesContent":["import type { RuleOptions } from \"../typegen\";\n\n/**\n * Vue SFC 本地覆写规则。\n *\n * @remarks\n * 上游 `flat/recommended` 负责 Vue 3 正确性与模板约定；本记录补充事件、属性命名和\n * 闭合标签规则。Vue Web、Admin 与 UniApp 使用同一套严重级别。\n */\nexport const vueRules = {\n\t// v-html 可能引入 XSS；保留警告以兼容经过净化的富文本场景。\n\t\"vue/no-v-html\": \"warn\",\n\t// [默认关闭] TypeScript 类型 props 和 required 声明已能表达可选性，不强制每个可选 prop 提供默认值。\n\t\"vue/require-default-prop\": \"off\",\n\t// 组件对外事件必须通过 emits 显式声明，使事件 API 可检查，并避免事件名拼写错误被静默透传。\n\t\"vue/require-explicit-emits\": \"error\",\n\t// [默认关闭] 允许 App、Layout 等约定俗成的单词组件名。\n\t\"vue/multi-word-component-names\": \"off\",\n\t// 允许直接使用 Vue 子包入口，兼容编译器与运行时等明确子模块导入。\n\t\"vue/prefer-import-from-vue\": \"off\",\n\t// 自定义组件的模板属性统一使用 kebab-case；脚本中的 Props 声明仍使用 camelCase。\n\t\"vue/attribute-hyphenation\": [\"error\", \"always\"],\n\n\t// props、data、computed、methods 等选项中禁止同名键，避免成员互相遮蔽或解析到错误来源。\n\t\"vue/no-dupe-keys\": \"error\",\n\t// Props 属于父组件传入的只读数据，子组件应通过 emit 或本地状态更新，不能直接修改。\n\t\"vue/no-mutating-props\": \"error\",\n\t// setup 中直接解构 props 会丢失响应性，要求保留 props 引用或使用 toRefs 等响应式转换。\n\t\"vue/no-setup-props-reactivity-loss\": \"error\",\n\t// 禁止以会丢失响应性的方式解构或传递 ref 对象，确保后续更新仍能被 Vue 追踪。\n\t\"vue/no-ref-object-reactivity-loss\": \"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// emit、emits 和事件处理引用中的自定义事件名称统一使用 camelCase，原生 DOM 事件不受影响。\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/html-closing-bracket-newline\": [\"error\", { multiline: \"always\", singleline: \"never\" }],\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":";;;;;;;;AASA,MAAa,WAAW;CAEvB,iBAAiB;CAEjB,4BAA4B;CAE5B,8BAA8B;CAE9B,kCAAkC;CAElC,8BAA8B;CAE9B,6BAA6B,CAAC,SAAS,QAAQ;CAG/C,oBAAoB;CAEpB,yBAAyB;CAEzB,sCAAsC;CAEtC,qCAAqC;CAErC,mCAAmC;CAEnC,qCAAqC;CAErC,gCAAgC,CAAC,SAAS,WAAW;CAErD,8BAA8B;CAE9B,oCAAoC,CAAC,SAAS;EAAE,WAAW;EAAU,YAAY;CAAQ,CAAC;CAE1F,wBAAwB,CACvB,SACA,EACC,OAAO;EAAC;EAAc;EAAkB;EAAgB;EAAoB;EAAU;EAAU;EAAc;EAAU;CAAS,EAClI,CACD;AACD"}
+{"version":3,"file":"vue.mjs","names":[],"sources":["../../src/rules/vue.ts"],"sourcesContent":["import type { RuleOptions } from \"../typegen\";\n\n/**\n * Vue 组件脚本语义规则。\n *\n * @remarks\n * 这些规则可以检查 SFC 脚本以及使用 `defineComponent()`、Options API 或 `setup()` 的\n * 独立 JSX/TSX 组件。纯模板语法规则由 {@link vueTemplateRules} 单独维护。\n */\nexport const vueScriptRules = {\n\t/** [默认关闭] TypeScript 类型 props 和 `required` 声明已能表达可选性，不强制每个可选 prop 提供默认值。 */\n\t\"vue/require-default-prop\": \"off\",\n\t/** 组件事件必须显式声明，形成可检查的对外事件契约。 */\n\t\"vue/require-explicit-emits\": \"error\",\n\t/** [默认关闭] 允许 `App`、`Layout` 等约定俗成的单词组件名。 */\n\t\"vue/multi-word-component-names\": \"off\",\n\t/** [默认关闭] 允许直接使用 Vue 子包入口，兼容编译器与运行时等明确子模块导入。 */\n\t\"vue/prefer-import-from-vue\": \"off\",\n\t/** `props`、`data`、`computed`、`methods` 等选项中禁止同名键，避免成员互相遮蔽。 */\n\t\"vue/no-dupe-keys\": \"error\",\n\t/** Props 属于父组件只读输入，子组件应通过 emit 或本地状态更新。 */\n\t\"vue/no-mutating-props\": \"error\",\n\t/** `setup` 中直接解构 props 会丢失响应性，要求保留 props 引用或使用 `toRefs` 等响应式转换。 */\n\t\"vue/no-setup-props-reactivity-loss\": \"error\",\n\t/** 禁止以会丢失响应性的方式解构或传递 ref 对象，确保后续更新仍能被 Vue 追踪。 */\n\t\"vue/no-ref-object-reactivity-loss\": \"error\",\n\t/** 组件名不能占用 Vue 内置组件或平台保留名称。 */\n\t\"vue/no-reserved-component-names\": \"error\",\n\t/** `emit`、`emits` 和事件处理引用中的自定义事件名称统一使用 camelCase，原生 DOM 事件不受影响。 */\n\t\"vue/custom-event-name-casing\": [\"error\", \"camelCase\"],\n\t/** [默认关闭] 允许在一个 SFC 中声明仅供当前文件使用的小型辅助组件。 */\n\t\"vue/one-component-per-file\": \"off\",\n} satisfies RuleOptions;\n\n/**\n * Vue 模板语法规则。\n *\n * @remarks\n * 这些规则依赖 `vue-eslint-parser` 生成的模板节点，只应用于 `.vue` 与 `.nvue`。\n * JSX 属性遵循 JavaScript 标识符和运行时约定，不能套用模板的 kebab-case 与属性排序。\n */\nexport const vueTemplateRules = {\n\t/** `v-html` 可能引入 XSS；保留警告以兼容经过净化的富文本场景。 */\n\t\"vue/no-v-html\": \"warn\",\n\t/** 自定义组件的模板属性统一使用 kebab-case；脚本中的 Props 与 JSX 属性仍使用 camelCase。 */\n\t\"vue/attribute-hyphenation\": [\"error\", \"always\"],\n\t/** 禁止在组件节点使用 `v-text` 或 `v-html`，避免覆盖组件内容并模糊数据边界。 */\n\t\"vue/no-v-text-v-html-on-component\": \"error\",\n\t/** 模板属性按定义、循环、条件、修饰、唯一属性、全局属性、普通属性、事件和内容排序。 */\n\t\"vue/attributes-order\": [\n\t\t\"error\",\n\t\t{\n\t\t\torder: [\"DEFINITION\", \"LIST_RENDERING\", \"CONDITIONALS\", \"RENDER_MODIFIERS\", \"UNIQUE\", \"GLOBAL\", \"OTHER_ATTR\", \"EVENTS\", \"CONTENT\"],\n\t\t},\n\t],\n} satisfies RuleOptions;\n\n/** Vue SFC 同时使用组件脚本语义规则与模板语法规则。 */\nexport const vueRules = {\n\t/** 复用可在 SFC 与独立 JSX/TSX 中检查的 Vue 组件脚本语义规则。 */\n\t...vueScriptRules,\n\t/** 叠加仅对 Vue 模板节点有效的语法规则。 */\n\t...vueTemplateRules,\n} satisfies RuleOptions;\n"],"mappings":";;;;;;;;AASA,MAAa,iBAAiB;;CAE7B,4BAA4B;;CAE5B,8BAA8B;;CAE9B,kCAAkC;;CAElC,8BAA8B;;CAE9B,oBAAoB;;CAEpB,yBAAyB;;CAEzB,sCAAsC;;CAEtC,qCAAqC;;CAErC,mCAAmC;;CAEnC,gCAAgC,CAAC,SAAS,WAAW;;CAErD,8BAA8B;AAC/B;;;;;;;;AASA,MAAa,mBAAmB;;CAE/B,iBAAiB;;CAEjB,6BAA6B,CAAC,SAAS,QAAQ;;CAE/C,qCAAqC;;CAErC,wBAAwB,CACvB,SACA,EACC,OAAO;EAAC;EAAc;EAAkB;EAAgB;EAAoB;EAAU;EAAU;EAAc;EAAU;CAAS,EAClI,CACD;AACD;;AAGA,MAAa,WAAW;;CAEvB,GAAG;;CAEH,GAAG;AACJ"}