@ai0x0/utils 0.0.32 → 0.0.33

package/eslint-rules/no-hardcoded-style.js

@@ -187,41 +187,52 @@ for (const key of TOKEN_KEYS) {
 }
 
 function isTokenExpr(node) {
-  if (!node) return false;
+  if (!node) {
+    return false;
+  }
   if (
     node.type === "MemberExpression" &&
     node.object.type === "Identifier" &&
     node.object.name === "token"
-  )
+  ) {
     return true;
+  }
   if (
     node.type === "CallExpression" &&
     node.callee.type === "Identifier" &&
     ["token", "calc", "max", "min", "clamp"].includes(node.callee.name)
-  )
+  ) {
     return true;
+  }
   return false;
 }
 
 function isAllowedValue(node) {
-  if (!node) return true;
-  if (isTokenExpr(node)) return true;
-  if (node.type === "Literal" && (node.value === 0 || node.value === "0"))
+  if (!node) {
+    return true;
+  }
+  if (isTokenExpr(node)) {
+    return true;
+  }
+  if (node.type === "Literal" && (node.value === 0 || node.value === "0")) {
     return true;
+  }
   if (
     node.type === "Literal" &&
     typeof node.value === "string" &&
     ALLOWED_LITERALS.has(node.value)
-  )
+  ) {
     return true;
+  }
   if (
     node.type === "Literal" &&
     typeof node.value === "string" &&
     /^(\d+(\.\d+)?(px|em|rem|%|vh|vw|vmin|vmax|ex|ch|cm|mm|in|pt|pc)|\d+(\.\d+)?\s+(px|em|rem)\s+(solid|dashed|dotted)|\d+\.?\d*%)$/.test(
       node.value,
     )
-  )
+  ) {
     return true;
+  }
   if (
     [
       "ConditionalExpression",
@@ -233,25 +244,33 @@ function isAllowedValue(node) {
       "Identifier",
       "SpreadElement",
     ].includes(node.type)
-  )
+  ) {
     return true;
-  if (node.type === "ObjectExpression" || node.type === "ArrayExpression")
+  }
+  if (node.type === "ObjectExpression" || node.type === "ArrayExpression") {
     return true;
+  }
   return false;
 }
 
 function checkStyleObject(context, objExpr) {
   for (const prop of objExpr.properties) {
-    if (prop.type !== "Property") continue;
+    if (prop.type !== "Property") {
+      continue;
+    }
     const key =
       prop.key.type === "Identifier"
         ? prop.key.name
         : prop.key.type === "Literal"
           ? prop.key.value
           : null;
-    if (!key || !TOKEN_KEYS.has(key)) continue;
+    if (!key || !TOKEN_KEYS.has(key)) {
+      continue;
+    }
     const val = prop.value;
-    if (isAllowedValue(val)) continue;
+    if (isAllowedValue(val)) {
+      continue;
+    }
     const valText = context.getSourceCode().getText(val);
     context.report({
       node: prop,
@@ -270,7 +289,9 @@ function checkCssTemplate(context, node) {
   let fullText = "";
   for (let i = 0; i < quasis.length; i++) {
     fullText += quasis[i].value.raw;
-    if (i < expressions.length) fullText += "${EXPR}";
+    if (i < expressions.length) {
+      fullText += "${EXPR}";
+    }
   }
 
   // 按行分割，逐行检查
@@ -278,7 +299,9 @@ function checkCssTemplate(context, node) {
   for (const line of lines) {
     // 简单解析：找冒号分割的 property: value
     const colonIdx = line.indexOf(":");
-    if (colonIdx === -1) continue;
+    if (colonIdx === -1) {
+      continue;
+    }
 
     const rawProp = line.slice(0, colonIdx).trim();
     const rawVal = line
@@ -292,29 +315,42 @@ function checkCssTemplate(context, node) {
       rawProp.startsWith("&") ||
       rawProp.startsWith("@") ||
       rawProp.startsWith("//")
-    )
+    ) {
       continue;
+    }
 
     // 匹配 camelCase 或 kebab-case 属性
     const camelProp = TOKEN_KEYS.has(rawProp)
       ? rawProp
       : KEBAB_TO_CAMEL[rawProp];
-    if (!camelProp) continue;
+    if (!camelProp) {
+      continue;
+    }
 
     // 值包含 ${EXPR} → 被插值打断或完全由表达式提供 → 跳过
-    if (rawVal.includes("${EXPR}")) continue;
+    if (rawVal.includes("${EXPR}")) {
+      continue;
+    }
 
     // 0 值
-    if (rawVal === "0" || rawVal === "0px") continue;
+    if (rawVal === "0" || rawVal === "0px") {
+      continue;
+    }
 
     // CSS 关键字白名单
-    if (ALLOWED_LITERALS.has(rawVal)) continue;
+    if (ALLOWED_LITERALS.has(rawVal)) {
+      continue;
+    }
 
     // 纯百分比 → 允许（布局常用）
-    if (/^\d+\.?\d*%$/.test(rawVal)) continue;
+    if (/^\d+\.?\d*%$/.test(rawVal)) {
+      continue;
+    }
 
     // 100vh / 100vw → 允许（全屏布局）
-    if (/^100(vh|vw)$/.test(rawVal)) continue;
+    if (/^100(vh|vw)$/.test(rawVal)) {
+      continue;
+    }
 
     // 百分比 / 带单位字符串 → 硬编码（token 体系也有 sizeStep/sizeUnit）
     if (
@@ -339,6 +375,10 @@ function checkCssTemplate(context, node) {
   }
 }
 
+// ==============================================================================
+// ESLint 规则
+// ==============================================================================
+
 /** @type {import('eslint').Rule.RuleModule} */
 const rule = {
   meta: {
@@ -350,15 +390,19 @@ const rule = {
     schema: [],
     messages: {
       noHardcoded:
-        "禁止硬编码 `{{ {{key}}: {{value}} }}`。请使用 antd token（如 `token.marginSM`、`token.colorPrimary`）。可参考 .codex/skills/ant-design/SKILL.md 了解 token 体系。",
+        "禁止硬编码 `{{ {{key}}: {{value}} }}`。请使用 antd token（如 `token.marginSM`、`token.colorPrimary`）。可参考 node_modules/@ai0x0/utils/.agents/skills/antd/SKILL.md 了解 token 体系。",
     },
   },
   create(context) {
     return {
       JSXAttribute(node) {
-        if (node.name.name !== "style") return;
+        if (node.name.name !== "style") {
+          return;
+        }
         const expr = node.value?.expression;
-        if (!expr || expr.type !== "ObjectExpression") return;
+        if (!expr || expr.type !== "ObjectExpression") {
+          return;
+        }
         checkStyleObject(context, expr);
       },
 
@@ -372,40 +416,54 @@ const rule = {
         if (
           node.callee.type !== "Identifier" ||
           node.callee.name !== "createStyles"
-        )
+        ) {
           return;
+        }
         const arg = node.arguments[0];
-        if (!arg) return;
+        if (!arg) {
+          return;
+        }
 
         if (arg.type === "ObjectExpression") {
           for (const prop of arg.properties) {
-            if (prop.type !== "Property") continue;
-            if (prop.value.type === "ObjectExpression")
+            if (prop.type !== "Property") {
+              continue;
+            }
+            if (prop.value.type === "ObjectExpression") {
               checkStyleObject(context, prop.value);
-            else if (
+            } else if (
               prop.value.type === "TaggedTemplateExpression" &&
               prop.value.tag.name === "css"
-            )
+            ) {
               checkCssTemplate(context, prop.value);
+            }
           }
           return;
         }
 
         let body = null;
-        if (arg.type === "ArrowFunctionExpression") body = arg.body;
-        else if (arg.type === "FunctionExpression") body = arg.body;
-        if (!body) return;
+        if (arg.type === "ArrowFunctionExpression") {
+          body = arg.body;
+        } else if (arg.type === "FunctionExpression") {
+          body = arg.body;
+        }
+        if (!body) {
+          return;
+        }
 
         if (body.type === "ObjectExpression") {
           for (const prop of body.properties) {
-            if (prop.type !== "Property") continue;
-            if (prop.value.type === "ObjectExpression")
+            if (prop.type !== "Property") {
+              continue;
+            }
+            if (prop.value.type === "ObjectExpression") {
               checkStyleObject(context, prop.value);
-            else if (
+            } else if (
               prop.value.type === "TaggedTemplateExpression" &&
               prop.value.tag.name === "css"
-            )
+            ) {
               checkCssTemplate(context, prop.value);
+            }
           }
           return;
         }
@@ -417,14 +475,17 @@ const rule = {
               stmt.argument?.type === "ObjectExpression"
             ) {
               for (const prop of stmt.argument.properties) {
-                if (prop.type !== "Property") continue;
-                if (prop.value.type === "ObjectExpression")
+                if (prop.type !== "Property") {
+                  continue;
+                }
+                if (prop.value.type === "ObjectExpression") {
                   checkStyleObject(context, prop.value);
-                else if (
+                } else if (
                   prop.value.type === "TaggedTemplateExpression" &&
                   prop.value.tag.name === "css"
-                )
+                ) {
                   checkCssTemplate(context, prop.value);
+                }
               }
             }
           }

package/eslint-rules/require-section-divider.js

@@ -9,7 +9,7 @@
  *   - 550 ~ 749 行：至少 3 个分区块
  *   以此类推，每 200 行增加 1 个分区块。
  *
- * 分隔注释块格式（见 .agents/skills/dev-style/SKILL.md）：
+ * 分隔注释块格式（见 node_modules/@ai0x0/utils/.agents/skills/nextjs/SKILL.md）：
  *
  *   // ==============================================================================
  *   // <中文标题>
@@ -22,24 +22,39 @@ const DIVIDER_EQ = /^\s*={4,}\s*$/;
 
 /** 相邻两行注释 + 之间中间一行文字：判定一个三行注释块为分隔块。 */
 function isDividerBlock(commentA, commentB, commentC) {
-  if (!commentA || !commentB || !commentC) return false;
+  if (!commentA || !commentB || !commentC) {
+    return false;
+  }
   if (
     commentA.type !== "Line" ||
     commentB.type !== "Line" ||
     commentC.type !== "Line"
-  )
+  ) {
+    return false;
+  }
+  if (!DIVIDER_EQ.test(commentA.value)) {
+    return false;
+  }
+  if (!DIVIDER_EQ.test(commentC.value)) {
+    return false;
+  }
+  if (!commentB.value.trim()) {
     return false;
-  if (!DIVIDER_EQ.test(commentA.value)) return false;
-  if (!DIVIDER_EQ.test(commentC.value)) return false;
-  if (!commentB.value.trim()) return false;
-  if (commentA.loc.end.line + 1 !== commentB.loc.start.line) return false;
-  if (commentB.loc.end.line + 1 !== commentC.loc.start.line) return false;
+  }
+  if (commentA.loc.end.line + 1 !== commentB.loc.start.line) {
+    return false;
+  }
+  if (commentB.loc.end.line + 1 !== commentC.loc.start.line) {
+    return false;
+  }
   return true;
 }
 
 /** 计算文件需要多少个分区块（每 150 行 1 个，从 150 行起）。 */
 function requiredDividers(totalLines, minLines) {
-  if (totalLines < minLines) return 0;
+  if (totalLines < minLines) {
+    return 0;
+  }
   // 150-299: 1个, 300-449: 2个, 依此类推
   return Math.floor(totalLines / minLines);
 }
@@ -74,10 +89,14 @@ const rule = {
     return {
       Program(program) {
         const totalLines = program.loc.end.line;
-        if (totalLines < minLines) return;
+        if (totalLines < minLines) {
+          return;
+        }
 
         const required = requiredDividers(totalLines, minLines);
-        if (required <= 0) return;
+        if (required <= 0) {
+          return;
+        }
 
         const allComments = sourceCode.getAllComments();
 

package/eslint-rules/require-use-form.js

@@ -23,7 +23,7 @@ const rule = {
     schema: [],
     messages: {
       useFormRequired:
-        "检测到表单场景使用了 useState/useSetState 管理字段值。请改用 Form.useForm() 或 rc-field-form 的 useForm。详见 .agents/skills/form-convention/SKILL.md。",
+        "检测到表单场景使用了 useState/useSetState 管理字段值。请改用 Form.useForm() 或 rc-field-form 的 useForm。详见 node_modules/@ai0x0/utils/.agents/skills/antd/SKILL.md。",
     },
   },
   create(context) {
@@ -39,16 +39,23 @@ const rule = {
 
     return {
       JSXOpeningElement(node) {
-        if (hasFormPattern) return;
+        if (hasFormPattern) {
+          return;
+        }
 
         let hasValue = false;
         let hasOnChange = false;
 
         for (const attr of node.attributes) {
-          if (attr.type !== "JSXAttribute" || !attr.name) continue;
+          if (attr.type !== "JSXAttribute" || !attr.name) {
+            continue;
+          }
           const attrName = attr.name.name;
-          if (attrName === "value") hasValue = true;
-          else if (attrName === "onChange") hasOnChange = true;
+          if (attrName === "value") {
+            hasValue = true;
+          } else if (attrName === "onChange") {
+            hasOnChange = true;
+          }
 
           if (hasValue && hasOnChange) {
             hasFormPattern = true;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai0x0/utils",
-  "version": "0.0.32",
+  "version": "0.0.33",
   "description": "AI0x0 utils",
   "keywords": [
     "ai0x0"
@@ -24,6 +24,7 @@
     "lib",
     "eslint-config",
     "eslint-rules",
+    ".agents",
     "SKILL.md"
   ],
   "scripts": {