@foundbyte/eslint-plugin 1.0.8 → 1.0.9

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

@@ -14,6 +14,44 @@ module.exports = {
     },
 
     create(context) {
+        /**
+         * 递归检查 AST 节点中是否包含类型断言
+         * @param {Object} node AST节点
+         * @param {Set} visited 已访问的节点集合，用于避免循环引用
+         * @returns {boolean} 是否包含类型断言
+         */
+        function containsTypeAssertion(node, visited = new Set()) {
+            if (!node || typeof node !== 'object') return false;
+            
+            // 避免循环引用
+            if (visited.has(node)) return false;
+            visited.add(node);
+            
+            // 如果当前节点是类型断言，返回 true
+            if (node.type === 'TSAsExpression') {
+                return true;
+            }
+            
+            // 递归检查子节点，只检查 AST 相关的属性
+            const astKeys = ['init', 'expression', 'body', 'declarations', 'arguments', 'callee', 'left', 'right'];
+            
+            for (const key of astKeys) {
+                if (node[key]) {
+                    if (Array.isArray(node[key])) {
+                        for (const child of node[key]) {
+                            if (containsTypeAssertion(child, visited)) {
+                                return true;
+                            }
+                        }
+                    } else if (containsTypeAssertion(node[key], visited)) {
+                        return true;
+                    }
+                }
+            }
+            
+            return false;
+        }
+
         /**
          * 检查变量声明是否使用了 as 类型断言
          * @param {Object} node AST节点
@@ -28,8 +66,8 @@ module.exports = {
             node.declarations.forEach(declaration => {
                 // 检查是否有初始化表达式
                 if (declaration.init) {
-                    // 检查初始化表达式是否是类型断言表达式
-                    if (declaration.init.type === 'TSAsExpression') {
+                    // 检查初始化表达式是否包含类型断言
+                    if (containsTypeAssertion(declaration.init)) {
                         context.report({
                             node: declaration,
                             messageId: 'noInitialAsAssertion',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@foundbyte/eslint-plugin",
-  "version": "1.0.8",
+  "version": "1.0.9",
   "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",