@foundbyte/eslint-plugin 1.0.8 → 1.1.0

package/README.md

@@ -23,6 +23,7 @@ module.exports = {
   rules: {
     // 启用所有推荐的规则
     '@foundbyte/arrow-function-padding': 'error',
+    '@foundbyte/no-initial-as-assertion': 'error',
     '@foundbyte/hooks-arrow-function-only': 'error',
     '@foundbyte/type-comment-requirement': ['error', {
       minCommentsPerGroup: 1,
@@ -48,6 +49,35 @@ module.exports = {
 
 ## 规则列表与配置示例
 
+### no-initial-as-assertion
+
+禁止在初始变量定义时使用 `as` 类型断言，强制使用显式类型注解。
+
+**配置示例：**
+```javascript
+'@foundbyte/no-initial-as-assertion': 'error' // 禁止在变量声明时使用 as 类型断言
+```
+
+**示例：**
+```typescript
+// ✅ 正确 - 使用显式类型注解
+const a: Ref<string> = ref()
+const b: ComputedRef<number> = computed(() => {})
+const c = ref() // 没有类型断言
+const d: Ref<{ a: string }> = ref({}) // 使用显式类型注解
+
+// ❌ 错误 - 在变量声明时使用 as 类型断言
+const a = ref() as Ref<string>
+const b = computed(() => {}) as ComputedRef<number>
+const c = reactive({}) as Reactive<object>
+const d = ref({} as { a: string }) // 嵌套的类型断言也会被检测到
+```
+
+**注意：**
+- 该规则检查变量声明时的所有类型断言，包括嵌套在函数调用参数中的类型断言
+- 推荐使用显式类型注解，因为类型断言会绕过 TypeScript 的类型检查
+- 对于函数调用返回值的类型断言，该规则不会报错
+
 ### arrow-function-padding
 
 要求函数体之间必须空行。

package/lib/rules/no-initial-as-assertion.js

@@ -28,13 +28,32 @@ module.exports = {
             node.declarations.forEach(declaration => {
                 // 检查是否有初始化表达式
                 if (declaration.init) {
-                    // 检查初始化表达式是否是类型断言表达式
+                    // 检查初始化表达式是否直接是类型断言
                     if (declaration.init.type === 'TSAsExpression') {
+                        // 对于直接的类型断言，应该限制
+                        // 例如：const a = 1 as number, const a = {} as { s: string }
                         context.report({
-                            node: declaration,
+                            node: declaration.init,
                             messageId: 'noInitialAsAssertion',
                         });
                     }
+                    // 检查函数调用的参数中是否包含类型断言
+                    else if (declaration.init.type === 'CallExpression') {
+                        // 检查函数调用的参数
+                        if (declaration.init.arguments && declaration.init.arguments.length > 0) {
+                            for (const arg of declaration.init.arguments) {
+                                if (arg.type === 'TSAsExpression') {
+                                    // 对于函数参数中的类型断言，应该限制
+                                    // 例如：ref({} as string) 中的 {} as string
+                                    context.report({
+                                        node: arg,
+                                        messageId: 'noInitialAsAssertion',
+                                    });
+                                    break; // 只报告第一个找到的类型断言
+                                }
+                            }
+                        }
+                    }
                 }
             });
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@foundbyte/eslint-plugin",
-  "version": "1.0.8",
+  "version": "1.1.0",
   "description": "ESLint plugin for enforcing code style rules including arrow function padding, Vue script lines limit, and TypeScript type comment requirements",
   "main": "index.js",
   "types": "index.d.ts",