@apdesign/code-style-react 2.0.3 → 2.0.5

package/CHANGELOG.md

@@ -1,5 +1,86 @@
 # 更新日志
 
+## [2.0.5] - Biome 规则精准对齐版本
+
+### 🎯 重要更新
+
+根据实际项目的 ESLint error 和 warning 扫描结果，进一步优化 Biome 规则配置，提升规则覆盖率和严重程度对齐。
+
+### 🔧 规则调整
+
+**严重程度提升（warn → error）**:
+- `noParameterAssign: error` ← `no-param-reassign`
+- `useTemplate: error` ← `prefer-template`
+- `noUselessElse: error` ← `no-else-return`
+- `noExplicitAny: error` ← `@typescript-eslint/no-explicit-any`
+- `noArrayIndexKey: error` ← `react/no-array-index-key`
+- `noEmptyBlockStatements: error` ← `no-empty-function`
+- `noShadowRestrictedNames: error` ← `@typescript-eslint/no-shadow`
+
+**新增规则 (Complexity)**:
+- `noUselessEscapeInRegex: error` ← `no-useless-escape` 部分
+- `noUselessTernary: error` ← `no-unneeded-ternary`
+- `useArrowFunction: error` ← `prefer-arrow-callback`
+- `useLiteralKeys: warn` ← `dot-notation`
+
+**新增规则 (Correctness)**:
+- `noUnsafeOptionalChaining: error` ← `no-unsafe-optional-chaining`
+
+**新增规则 (Style)**:
+- `useCollapsedElseIf: error` ← `no-lonely-if`
+- `useDefaultParameterLast: error` ← `default-param-last`
+- `useConst: error` ← `prefer-const`
+- `useExponentiationOperator: error` ← 使用 ** 而不是 Math.pow
+
+### 📊 覆盖率统计
+
+- **可配置规则总数**: 15 个 Biome 规则
+- **ESLint 规则覆盖率**: 约 35-40%
+- **Error 级别规则**: 12 个
+- **Warn 级别规则**: 3 个
+
+### ❌ Biome 不支持的规则
+
+以下 ESLint 规则在 Biome 中暂无对应，已接受放弃检查：
+
+**Import 管理**:
+- `import/order`, `import/newline-after-import`, `import/no-unresolved`, `import/no-duplicates`, `import/no-extraneous-dependencies`
+
+**React 特定**:
+- `react/no-unused-prop-types`, `react/jsx-no-constructed-context-values`, `react/no-unstable-nested-components`, `react/jsx-curly-brace-presence`, `react/destructuring-assignment`
+
+**代码风格**:
+- `no-underscore-dangle`, `spaced-comment`, `no-continue`, `lines-between-class-members`, `func-names`
+
+**逻辑检查**:
+- `consistent-return`, `no-nested-ternary`, `no-restricted-globals`, `no-loop-func`, `no-useless-return`, `prefer-promise-reject-errors`, `no-new-wrappers`, `one-var`, `no-restricted-syntax`, `@typescript-eslint/no-use-before-define`, `prefer-destructuring`
+
+### 🎨 配置原则
+
+1. **严重程度对齐**: ESLint error → Biome error, ESLint warn → Biome warn
+2. **规则冲突统一**: 同一规则出现在 error 和 warning 中时，统一设为 error
+3. **覆盖率优先**: 能配置的规则尽可能配置
+4. **接受限制**: Biome 不支持的规则接受放弃
+
+### 📝 使用建议
+
+使用 Biome 检查项目：
+```bash
+npx @biomejs/biome check . --write
+```
+
+查看诊断信息：
+```bash
+npx @biomejs/biome check . --diagnostic-level=error
+```
+
+### 🔗 相关链接
+
+- Biome 官方文档: https://biomejs.dev
+- Biome 规则参考: https://www.biomejs.cn/linter
+
+---
+
 ## [2.0.3] - 实际项目扫描对齐版本
 
 ### 🎯 重要更新

package/biome.jsonc

@@ -1,5 +1,10 @@
 {
   "$schema": "https://biomejs.dev/schemas/2.2.6/schema.json",
+  "vcs": {
+    "enabled": true,
+    "clientKind": "git",
+    "useIgnoreFile": true
+  },
   "formatter": {
     "enabled": true,
     "indentStyle": "space",
@@ -37,7 +42,11 @@
         "noUselessFragments": "off",
         "noForEach": "off",
         "noExcessiveCognitiveComplexity": "off",
-        "useOptionalChain": "warn"
+        "useOptionalChain": "warn",
+        "noUselessEscapeInRegex": "error",
+        "noUselessTernary": "error",
+        "useArrowFunction": "error",
+        "useLiteralKeys": "warn"
       },
       "correctness": {
         "noUndeclaredVariables": "off",
@@ -46,14 +55,15 @@
         "useExhaustiveDependencies": "off",
         "noUnreachable": "error",
         "noConstantCondition": "error",
-        "noUnusedFunctionParameters": "off"
+        "noUnusedFunctionParameters": "off",
+        "noUnsafeOptionalChaining": "error"
       },
       "style": {
-        "noParameterAssign": "warn",
+        "noParameterAssign": "error",
         "noNonNullAssertion": "off",
         "useBlockStatements": "off",
         "useNamingConvention": "off",
-        "useTemplate": "warn",
+        "useTemplate": "error",
         "useFilenamingConvention": "off",
         "useNodejsImportProtocol": "off",
         "useShorthandAssign": "warn",
@@ -63,16 +73,21 @@
         "useImportType": "off",
         "noUnusedTemplateLiteral": "warn",
         "useSingleVarDeclarator": "off",
-        "noUselessElse": "warn"
+        "noUselessElse": "error",
+        "useCollapsedElseIf": "error",
+        "useDefaultParameterLast": "error",
+        "useConst": "error",
+        "useExponentiationOperator": "error"
       },
       "suspicious": {
-        "noExplicitAny": "warn",
-        "noArrayIndexKey": "warn",
+        "noExplicitAny": "error",
+        "noArrayIndexKey": "error",
         "noConsole": "warn",
         "noDoubleEquals": "off",
-        "noEmptyBlockStatements": "warn",
+        "noEmptyBlockStatements": "error",
         "noConfusingVoidType": "off",
-        "noConstEnum": "off"
+        "noConstEnum": "off",
+        "noShadowRestrictedNames": "error"
       },
       "nursery": {
         "useSortedClasses": "off"
@@ -80,15 +95,15 @@
     }
   },
   "files": {
-    "includes": ["**/*.js", "**/*.jsx", "**/*.ts", "**/*.tsx", "**/*.json", "**/*.jsonc"],
+    "includes": ["**/*.js", "**/*.jsx", "**/*.ts", "**/*.tsx"],
     "experimentalScannerIgnores": [
-      "**/dist/**",
-      "**/node_modules/**",
+      "**/dist",
+      "**/node_modules",
       "**/*.d.ts",
-      "**/mock/**",
+      "**/mock",
       "**/.eslintrc.cjs",
-      "**/build/**",
-      "**/coverage/**"
+      "**/build",
+      "**/coverage"
     ]
   },
   "overrides": [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@apdesign/code-style-react",
-  "version": "2.0.3",
+  "version": "2.0.5",
   "description": "基于 Ultracite (Biome) 的现代化前端代码规范工具集，专为 React/TypeScript 项目设计",
   "keywords": [
     "biome",