@af-mobile/eslint-plugin 2.0.4 → 2.2.0

package/index.js

@@ -1,95 +1,111 @@
-// af-mobile UI —— eslint-plugin-af-mobile 入口（ESLint 9 flat config 兼容）
-// 20 条规则：L1(2) + L2(7) + L3(6) + L3.5(5)
-// （definePage 消费端 7 条规则已随 definePage 全局单例移除）
-import noTokenModification from './rules/no-token-modification.js';
-import noInlineStyle from './rules/no-inline-style.js';
-import tokenWhitelist from './rules/token-whitelist.js';
-import noRecipeBreak from './rules/no-recipe-break.js';
-import noVariantConflict from './rules/no-variant-conflict.js';
-import noArbitraryValue from './rules/no-arbitrary-value.js';
-import noTailwindSyntax from './rules/no-tailwind-syntax.js';
-import preferComponent from './rules/prefer-component.js';
-import atomicDuplicate from './rules/atomic-duplicate.js';
-import noRegisterAll from './rules/no-register-all.js';
-import wcLightNoStyle from './rules/wc-light-no-style.js';
-import wcShadowUseToken from './rules/wc-shadow-use-token.js';
-import wcPartNaming from './rules/wc-part-naming.js';
-import wcEventNaming from './rules/wc-event-naming.js';
-import wcAriaRequired from './rules/wc-aria-required.js';
-import wcCleanup from './rules/wc-cleanup.js';
-import wcBlockNoInternalRef from './rules/wc-block-no-internal-ref.js';
-import wcBlockPropsCount from './rules/wc-block-props-count.js';
-import wcBlockStates from './rules/wc-block-states.js';
-import wcBlockVariantEnum from './rules/wc-block-variant-enum.js';
-
-const plugin = {
-  meta: { name: 'eslint-plugin-af-mobile', version: '2.0.4' },
-  rules: {
-    // L1（2 条，全部 error；tokens-css-locked 由 CODEOWNERS + 分支保护，非 ESLint 规则）
-    'no-token-modification': noTokenModification,
-    'no-inline-style': noInlineStyle,
-    // L1-3 tokens-css-locked 是 CODEOWNERS + 分支保护，非 ESLint 规则
-    // L2（7 条：4 error + 3 warn）
-    'token-whitelist': tokenWhitelist,
-    'no-recipe-break': noRecipeBreak,
-    'no-variant-conflict': noVariantConflict,
-    'no-arbitrary-value': noArbitraryValue,
-    'no-tailwind-syntax': noTailwindSyntax,
-    'prefer-component': preferComponent,
-    'atomic-duplicate': atomicDuplicate,
-    // L3（6 条：4 error + 2 warn）
-    'wc-light-no-style': wcLightNoStyle,
-    'wc-shadow-use-token': wcShadowUseToken,
-    'wc-part-naming': wcPartNaming,
-    'wc-event-naming': wcEventNaming,
-    'wc-aria-required': wcAriaRequired,
-    'wc-cleanup': wcCleanup,
-    // L3.5（5 条：Block 层约束 + register 引导）
-    'no-register-all': noRegisterAll,
-    'wc-block-no-internal-ref': wcBlockNoInternalRef,
-    'wc-block-props-count': wcBlockPropsCount,
-    'wc-block-states': wcBlockStates,
-    'wc-block-variant-enum': wcBlockVariantEnum,
-  },
-  configs: {},
-};
-
-// recommended 配置：按设计文档 L4 §3.2-3.4 的 severity 启用
-Object.assign(plugin.configs, {
-  recommended: {
-    plugins: { 'af-mobile': plugin },
-    rules: {
-      // L1 error
-      'af-mobile/no-token-modification': 'error',
-      'af-mobile/no-inline-style': 'error',
-      // L2 error
-      // extraComponents: af-data 属 L3.5 Block 层数据源元素（非 L3 注册组件，不在 whitelist-v1.json），
-      // 但 AI 生成的页面代码（createPage/:bind 体系）需要能使用 <af-data>，故在规则级放行
-      'af-mobile/token-whitelist': ['error', { extraComponents: ['af-data'] }],
-      'af-mobile/no-recipe-break': 'error',
-      'af-mobile/no-arbitrary-value': 'error',
-      'af-mobile/no-tailwind-syntax': 'error',
-      // L2 warn
-      'af-mobile/no-variant-conflict': 'warn',
-      'af-mobile/prefer-component': 'warn',
-      'af-mobile/atomic-duplicate': 'warn',
-      // L3 error
-      'af-mobile/wc-light-no-style': 'error',
-      'af-mobile/wc-shadow-use-token': 'error',
-      'af-mobile/wc-event-naming': 'error',
-      'af-mobile/wc-aria-required': 'error',
-      // L3 warn
-      'af-mobile/wc-part-naming': 'warn',
-      'af-mobile/wc-cleanup': 'warn',
-      // L3.5 error（Block 层约束）
-      'af-mobile/wc-block-no-internal-ref': 'error',
-      'af-mobile/wc-block-props-count': 'error',
-      'af-mobile/wc-block-states': 'error',
-      // L3.5 error（按需引入铁律：registerAll 全量注册 = 全局引入，一律禁止）
-      'af-mobile/no-register-all': 'error',
-      'af-mobile/wc-block-variant-enum': 'warn',
-    },
-  },
-});
-
-export default plugin;
+// af-mobile UI —— eslint-plugin-af-mobile 入口（ESLint 9 flat config 兼容）
+// 24 条规则：L1(2) + L2(8) + L3(6) + L3.5(5) + k(3)
+// （definePage 消费端 7 条规则已随 definePage 全局单例移除）
+import noTokenModification from './rules/no-token-modification.js';
+import noInlineStyle from './rules/no-inline-style.js';
+import tokenWhitelist from './rules/token-whitelist.js';
+import noRecipeBreak from './rules/no-recipe-break.js';
+import noVariantConflict from './rules/no-variant-conflict.js';
+import noArbitraryValue from './rules/no-arbitrary-value.js';
+import noTailwindSyntax from './rules/no-tailwind-syntax.js';
+import preferComponent from './rules/prefer-component.js';
+import atomicDuplicate from './rules/atomic-duplicate.js';
+import noEmojiIcon from './rules/no-emoji-icon.js';
+import noRegisterAll from './rules/no-register-all.js';
+import wcLightNoStyle from './rules/wc-light-no-style.js';
+import wcShadowUseToken from './rules/wc-shadow-use-token.js';
+import wcPartNaming from './rules/wc-part-naming.js';
+import wcEventNaming from './rules/wc-event-naming.js';
+import wcAriaRequired from './rules/wc-aria-required.js';
+import wcCleanup from './rules/wc-cleanup.js';
+import wcBlockNoInternalRef from './rules/wc-block-no-internal-ref.js';
+import wcBlockPropsCount from './rules/wc-block-props-count.js';
+import wcBlockStates from './rules/wc-block-states.js';
+import wcBlockVariantEnum from './rules/wc-block-variant-enum.js';
+import kNoBareAnd from './rules/k-no-bare-and.js';
+import kNoObjectInterpolation from './rules/k-no-object-interpolation.js';
+import kForRequireKey from './rules/k-for-require-key.js';
+
+const plugin = {
+  meta: { name: 'eslint-plugin-af-mobile', version: '2.1.0' },
+  rules: {
+    // L1（2 条，全部 error；tokens-css-locked 由 CODEOWNERS + 分支保护，非 ESLint 规则）
+    'no-token-modification': noTokenModification,
+    'no-inline-style': noInlineStyle,
+    // L1-3 tokens-css-locked 是 CODEOWNERS + 分支保护，非 ESLint 规则
+    // L2（8 条：4 error + 4 warn）
+    'token-whitelist': tokenWhitelist,
+    'no-recipe-break': noRecipeBreak,
+    'no-variant-conflict': noVariantConflict,
+    'no-arbitrary-value': noArbitraryValue,
+    'no-tailwind-syntax': noTailwindSyntax,
+    'prefer-component': preferComponent,
+    'atomic-duplicate': atomicDuplicate,
+    'no-emoji-icon': noEmojiIcon,
+    // L3（6 条：4 error + 2 warn）
+    'wc-light-no-style': wcLightNoStyle,
+    'wc-shadow-use-token': wcShadowUseToken,
+    'wc-part-naming': wcPartNaming,
+    'wc-event-naming': wcEventNaming,
+    'wc-aria-required': wcAriaRequired,
+    'wc-cleanup': wcCleanup,
+    // L3.5（5 条：Block 层约束 + register 引导）
+    'no-register-all': noRegisterAll,
+    'wc-block-no-internal-ref': wcBlockNoInternalRef,
+    'wc-block-props-count': wcBlockPropsCount,
+    'wc-block-states': wcBlockStates,
+    'wc-block-variant-enum': wcBlockVariantEnum,
+    // k 层（3 条：D-001=B 应用层推广的配套约束；仅对从 @af-mobile/ui/k 导入的 html/For 生效，
+    // 主包同名 API 语义不同不受约束，规则内经 collectKImports 判定）
+    'k-no-bare-and': kNoBareAnd,
+    'k-no-object-interpolation': kNoObjectInterpolation,
+    'k-for-require-key': kForRequireKey,
+  },
+  configs: {},
+};
+
+// recommended 配置：按设计文档 L4 §3.2-3.4 的 severity 启用
+Object.assign(plugin.configs, {
+  recommended: {
+    plugins: { 'af-mobile': plugin },
+    rules: {
+      // L1 error
+      'af-mobile/no-token-modification': 'error',
+      'af-mobile/no-inline-style': 'error',
+      // L2 error
+      // extraComponents: af-data 属 L3.5 Block 层数据源元素（非 L3 注册组件，不在 whitelist-v1.json），
+      // 但 AI 生成的页面代码（createPage/:bind 体系）需要能使用 <af-data>，故在规则级放行
+      'af-mobile/token-whitelist': ['error', { extraComponents: ['af-data'] }],
+      'af-mobile/no-recipe-break': 'error',
+      'af-mobile/no-arbitrary-value': 'error',
+      'af-mobile/no-tailwind-syntax': 'error',
+      // L2 warn
+      'af-mobile/no-variant-conflict': 'warn',
+      'af-mobile/prefer-component': 'warn',
+      'af-mobile/atomic-duplicate': 'warn',
+      'af-mobile/no-emoji-icon': 'warn',
+      // L3 error
+      'af-mobile/wc-light-no-style': 'error',
+      'af-mobile/wc-shadow-use-token': 'error',
+      'af-mobile/wc-event-naming': 'error',
+      'af-mobile/wc-aria-required': 'error',
+      // L3 warn
+      'af-mobile/wc-part-naming': 'warn',
+      'af-mobile/wc-cleanup': 'warn',
+      // L3.5 error（Block 层约束）
+      'af-mobile/wc-block-no-internal-ref': 'error',
+      'af-mobile/wc-block-props-count': 'error',
+      'af-mobile/wc-block-states': 'error',
+      // L3.5 error（按需引入铁律：registerAll 全量注册 = 全局引入，一律禁止）
+      'af-mobile/no-register-all': 'error',
+      'af-mobile/wc-block-variant-enum': 'warn',
+      // k 层（k 渲染/应用层：裸 && 渲染 "false"、对象插值 "[object Object]" 是静默 bug → error；
+      // For 缺 key 对对象列表破坏 keyed 复用但原始值列表合法 → warn）
+      'af-mobile/k-no-bare-and': 'error',
+      'af-mobile/k-no-object-interpolation': 'error',
+      'af-mobile/k-for-require-key': 'warn',
+    },
+  },
+});
+
+export default plugin;

package/package.json

@@ -1,31 +1,35 @@
-{
-  "name": "@af-mobile/eslint-plugin",
-  "version": "2.0.4",
-  "description": "af-mobile UI ESLint plugin — 27 rules (L1/L2/L3/L3.5) enforcing design-system + Web Component constraints",
-  "type": "module",
-  "main": "./index.js",
-  "module": "./index.js",
-  "exports": {
-    ".": "./index.js"
-  },
-  "files": [
-    "index.js",
-    "rules/",
-    "utils/"
-  ],
-  "dependencies": {
-    "postcss": "^8.4.0"
-  },
-  "peerDependencies": {
-    "eslint": ">=9.0.0"
-  },
-  "keywords": [
-    "eslint",
-    "eslintplugin",
-    "eslint-plugin",
-    "web-components",
-    "design-system",
-    "af-mobile"
-  ],
-  "license": "MIT"
-}
+{
+  "name": "@af-mobile/eslint-plugin",
+  "version": "2.2.0",
+  "description": "af-mobile UI ESLint plugin — 24 rules (L1/L2/L3/L3.5/k) enforcing design-system + Web Component + k-layer constraints",
+  "type": "module",
+  "main": "./index.js",
+  "module": "./index.js",
+  "exports": {
+    ".": "./index.js"
+  },
+  "files": [
+    "index.js",
+    "rules/",
+    "utils/"
+  ],
+  "dependencies": {
+    "postcss": "^8.4.0"
+  },
+  "peerDependencies": {
+    "eslint": ">=9.0.0"
+  },
+  "keywords": [
+    "eslint",
+    "eslintplugin",
+    "eslint-plugin",
+    "web-components",
+    "design-system",
+    "af-mobile"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/soulor8908/af-mobile.git"
+  }
+}

package/rules/atomic-duplicate.js

@@ -1,60 +1,68 @@
-// L2-7 af-mobile/atomic-duplicate（warn，可自动修）
-// 检测：同一 class 属性内出现两个同属性原子（如 p-4 p-2），保留最后一个
-import { extractAllClassLists } from '../utils/helpers.js';
-
-// 属性前缀映射：p-* → padding, m-* → margin, t-* → font-size, r-* → border-radius
-function getPropPrefix(cls) {
-  const m = cls.match(/^([pmtr])-(.+)$/);
-  return m ? m[1] : null;
-}
-
-const PROP_LABELS = { p: 'padding', m: 'margin', t: 'font-size', r: 'border-radius' };
-
-export default {
-  meta: {
-    type: 'suggestion',
-    docs: { description: '检测同属性原子类重复，保留最后一个' },
-    schema: [],
-    messages: {
-      duplicate: "Duplicate {{prop}}: '{{a}}' is overwritten by '{{b}}'. Keep only '{{b}}'",
-    },
-    fixable: 'code',
-  },
-  create(context) {
-    function checkClasses(classes, node, raw) {
-      const seen = new Map(); // prefix → { cls, index }
-      for (let i = 0; i < classes.length; i++) {
-        const cls = classes[i];
-        const prefix = getPropPrefix(cls);
-        if (!prefix) continue;
-        if (seen.has(prefix)) {
-          const prev = seen.get(prefix);
-          context.report({
-            node,
-            messageId: 'duplicate',
-            data: { prop: PROP_LABELS[prefix] || prefix, a: prev.cls, b: cls },
-            fix(fixer) {
-              // 删除被覆盖的 class + 其后的空格（保留的类在后面，必有空格可吃）
-              const sourceCode = context.sourceCode || context.getSourceCode();
-              const text = sourceCode.getText(node);
-              const idx = text.indexOf(raw);
-              if (idx < 0) return null;
-              const classIdx = idx + raw.indexOf(prev.cls);
-              const before = text.slice(0, classIdx);
-              const after = text.slice(classIdx + prev.cls.length).replace(/^\s+/, '');
-              return fixer.replaceText(node, before + after);
-            },
-          });
-        }
-        seen.set(prefix, { cls, index: i });
-      }
-    }
-    function checkString(str, node) {
-      for (const { classes, raw } of extractAllClassLists(str)) checkClasses(classes, node, raw);
-    }
-    return {
-      Literal(node) { if (typeof node.value === 'string') checkString(node.value, node); },
-      TemplateElement(node) { if (node.value?.raw) checkString(node.value.raw, node); },
-    };
-  },
-};
+// L2-7 af-mobile/atomic-duplicate（warn，可自动修）
+// 检测：同一 class 属性内出现两个同属性原子（如 p-4 p-2），保留最后一个
+import { extractAllClassLists } from '../utils/helpers.js';
+
+// 字重类与字号类共享 t- 前缀但作用于不同属性（font-weight vs font-size），必须分桶判定：
+// t-xl t-b 是"大字号+粗体"的合法排版组合，不是字号重复
+// （v1.6.1 修复：旧前缀正则曾把两者混为 font-size，autofix 直接删掉字号类，破坏视觉强调）
+const FONT_SIZE = new Set(['t-display', 't-xs', 't-sm', 't-md', 't-lg', 't-xl']);
+const FONT_WEIGHT = new Set(['t-b', 't-m', 't-semibold']);
+
+// 属性桶：p-* → padding, m-* → margin, t-* → font-size, r-* → border-radius, 字重类 → font-weight
+function getPropPrefix(cls) {
+  if (FONT_WEIGHT.has(cls)) return 'fw';
+  if (FONT_SIZE.has(cls)) return 't';
+  const m = cls.match(/^([pmtr])-(.+)$/);
+  return m ? m[1] : null;
+}
+
+const PROP_LABELS = { p: 'padding', m: 'margin', t: 'font-size', r: 'border-radius', fw: 'font-weight' };
+
+export default {
+  meta: {
+    type: 'suggestion',
+    docs: { description: '检测同属性原子类重复，保留最后一个' },
+    schema: [],
+    messages: {
+      duplicate: "Duplicate {{prop}}: '{{a}}' is overwritten by '{{b}}'. Keep only '{{b}}'",
+    },
+    fixable: 'code',
+  },
+  create(context) {
+    function checkClasses(classes, node, raw) {
+      const seen = new Map(); // prefix → { cls, index }
+      for (let i = 0; i < classes.length; i++) {
+        const cls = classes[i];
+        const prefix = getPropPrefix(cls);
+        if (!prefix) continue;
+        if (seen.has(prefix)) {
+          const prev = seen.get(prefix);
+          context.report({
+            node,
+            messageId: 'duplicate',
+            data: { prop: PROP_LABELS[prefix] || prefix, a: prev.cls, b: cls },
+            fix(fixer) {
+              // 删除被覆盖的 class + 其后的空格（保留的类在后面，必有空格可吃）
+              const sourceCode = context.sourceCode || context.getSourceCode();
+              const text = sourceCode.getText(node);
+              const idx = text.indexOf(raw);
+              if (idx < 0) return null;
+              const classIdx = idx + raw.indexOf(prev.cls);
+              const before = text.slice(0, classIdx);
+              const after = text.slice(classIdx + prev.cls.length).replace(/^\s+/, '');
+              return fixer.replaceText(node, before + after);
+            },
+          });
+        }
+        seen.set(prefix, { cls, index: i });
+      }
+    }
+    function checkString(str, node) {
+      for (const { classes, raw } of extractAllClassLists(str)) checkClasses(classes, node, raw);
+    }
+    return {
+      Literal(node) { if (typeof node.value === 'string') checkString(node.value, node); },
+      TemplateElement(node) { if (node.value?.raw) checkString(node.value.raw, node); },
+    };
+  },
+};

package/rules/k-for-require-key.js

@@ -0,0 +1,33 @@
+// k-3 af-mobile/k-for-require-key（warn）
+// For 省略 key 时以项本身为键：原始值列表语义正确；对象列表以引用为键——
+// 数据源每次 set 新数组即整行重建，keyed 复用失效（src/k/README.md 词表卡 key 边界）
+// 修正：显式传 key: 'id'（稳定字段名）；纯原始值列表可显式关闭本规则
+// 仅对从 k 入口（@af-mobile/ui/k）导入的 For 生效
+import { collectKImports } from '../utils/helpers.js';
+
+export default {
+  meta: {
+    type: 'suggestion',
+    docs: { description: 'k For 建议显式传 key（对象项省略 key 以引用为键，引用变则整行重建）' },
+    schema: [],
+    messages: {
+      forKeyMissing: 'For is missing "key" — object items are keyed by reference when omitted, so every source change rebuilds all rows; pass key: "id" (primitive lists may disable this rule)',
+    },
+  },
+  create(context) {
+    const kNames = collectKImports(context.sourceCode.ast.body);
+    if (kNames.For.size === 0) return {};
+    return {
+      CallExpression(node) {
+        if (node.callee.type !== 'Identifier' || !kNames.For.has(node.callee.name)) return;
+        const arg = node.arguments[0];
+        if (!arg || arg.type !== 'ObjectExpression') return;
+        const hasKey = arg.properties.some((p) => p.type === 'Property' && (
+          (p.key.type === 'Identifier' && p.key.name === 'key')
+          || (p.key.type === 'Literal' && p.key.value === 'key')
+        ));
+        if (!hasKey) context.report({ node: arg, messageId: 'forKeyMissing' });
+      },
+    };
+  },
+};

package/rules/k-no-bare-and.js

@@ -0,0 +1,31 @@
+// k-1 af-mobile/k-no-bare-and（error）
+// k 的 html`` 子位渲染 String(val)：裸 && 在假值时把字面量 "false" 渲染成文本节点
+// （JSX `cond && <X/>` 的幻觉写法；k 无"假值不渲染"语义）
+// 修正：三元 `${cond ? x : null}`（null → 空串）或 Show({ when, kids })
+// 仅对从 k 入口（@af-mobile/ui/k）导入的 html 生效；主包 html``（字符串拼接）不受约束
+import { collectKImports } from '../utils/helpers.js';
+
+export default {
+  meta: {
+    type: 'problem',
+    docs: { description: 'k html`` 子位禁止裸 && 表达式（假值渲染 "false" 文本）' },
+    schema: [],
+    messages: {
+      bareAnd: 'Bare && in k html`` renders literal text "false" when falsy — use a ternary `${cond ? x : null}` or Show({ when, kids })',
+    },
+  },
+  create(context) {
+    const kNames = collectKImports(context.sourceCode.ast.body);
+    if (kNames.html.size === 0) return {};
+    return {
+      TaggedTemplateExpression(node) {
+        if (node.tag.type !== 'Identifier' || !kNames.html.has(node.tag.name)) return;
+        for (const expr of node.quasi.expressions) {
+          if (expr.type === 'LogicalExpression' && expr.operator === '&&') {
+            context.report({ node: expr, messageId: 'bareAnd' });
+          }
+        }
+      },
+    };
+  },
+};

package/rules/k-no-object-interpolation.js

@@ -0,0 +1,31 @@
+// k-2 af-mobile/k-no-object-interpolation（error）
+// k 的 html`` 插值经 String(val)：对象字面量渲染成 "[object Object]" 文本
+// 典型来源：主包 html`` 的可信 HTML 语法 `${{ raw: '<b>x</b>' }}` 在 k 不存在（JSX/主包双重幻觉）
+// 修正：插 signal/getter、字符串或 DOM 节点；数组合法（bindKids 展开为多节点）不报
+// 仅对从 k 入口（@af-mobile/ui/k）导入的 html 生效；主包 html`` 的 { raw } 语法不受约束
+import { collectKImports } from '../utils/helpers.js';
+
+export default {
+  meta: {
+    type: 'problem',
+    docs: { description: 'k html`` 插值禁止对象字面量（渲染 "[object Object]"；k 无 { raw } 语法）' },
+    schema: [],
+    messages: {
+      objectInterpolation: 'Object literal in k html`` renders "[object Object]" — k has no { raw } syntax; interpolate a signal/getter, string, or DOM node instead (arrays are legal, they expand to multiple nodes)',
+    },
+  },
+  create(context) {
+    const kNames = collectKImports(context.sourceCode.ast.body);
+    if (kNames.html.size === 0) return {};
+    return {
+      TaggedTemplateExpression(node) {
+        if (node.tag.type !== 'Identifier' || !kNames.html.has(node.tag.name)) return;
+        for (const expr of node.quasi.expressions) {
+          if (expr.type === 'ObjectExpression') {
+            context.report({ node: expr, messageId: 'objectInterpolation' });
+          }
+        }
+      },
+    };
+  },
+};

package/rules/no-arbitrary-value.js

@@ -1,52 +1,52 @@
-// L2-4 af-mobile/no-arbitrary-value（error，部分可自动修）
-// 检测：class 含 [xxx] 任意值语法 / 档位越界（如 p-9）
-import { extractAllClassLists, ALL_CLASSES } from '../utils/helpers.js';
-
-// 合法档位
-const RANGES = {
-  'p': ['0', '1', '2', '3', '4', '5', '6', '7', '8', '10'],
-  'm': ['0', '1', '2', '3', '4', '5', '6'],
-  't': ['xs', 'sm', 'md', 'lg', 'xl'],
-  'r': ['s', 'm', 'l', 'f'],
-};
-
-export default {
-  meta: {
-    type: 'problem',
-    docs: { description: '禁止任意值语法和档位越界' },
-    schema: [],
-    messages: {
-      arbitrary: "'{{name}}' arbitrary value syntax forbidden; use closest atomic or extend recipes.project.css",
-      outOfRange: "'{{name}}' out of range ({{valid}}); use closest atomic",
-    },
-  },
-  create(context) {
-    function checkClass(cls, node) {
-      // 白名单内的 class 直接放行（如 t-center/t-b 是合法原子类，非档位）
-      if (ALL_CLASSES.has(cls)) return;
-      // [xxx] 任意值
-      if (/[\[\]]/.test(cls)) {
-        context.report({ node, messageId: 'arbitrary', data: { name: cls } });
-        return;
-      }
-      // 档位越界：前缀-档位
-      const m = cls.match(/^([pmtr])-(.+)$/);
-      if (m) {
-        const [, prefix, val] = m;
-        const valid = RANGES[prefix.toUpperCase()] || RANGES[prefix];
-        if (valid && !valid.includes(val)) {
-          context.report({ node, messageId: 'outOfRange', data: { name: cls, valid: valid.join('/') } });
-        }
-      }
-    }
-    function checkString(str, node) {
-      for (const { classes } of extractAllClassLists(str)) {
-        for (const cls of classes) checkClass(cls, node);
-      }
-    }
-    return {
-      Literal(node) { if (typeof node.value === 'string') checkString(node.value, node); },
-      TemplateElement(node) { if (node.value?.raw) checkString(node.value.raw, node); },
-    };
-  },
-};
+// L2-4 af-mobile/no-arbitrary-value（error，部分可自动修）
+// 检测：class 含 [xxx] 任意值语法 / 档位越界（如 p-9）
+import { extractAllClassLists, ALL_CLASSES } from '../utils/helpers.js';
+
+// 合法档位
+const RANGES = {
+  'p': ['0', '1', '2', '3', '4', '5', '6', '7', '8', '10'],
+  'm': ['0', '1', '2', '3', '4', '5', '6'],
+  't': ['xs', 'sm', 'md', 'lg', 'xl'],
+  'r': ['s', 'm', 'l', 'f'],
+};
+
+export default {
+  meta: {
+    type: 'problem',
+    docs: { description: '禁止任意值语法和档位越界' },
+    schema: [],
+    messages: {
+      arbitrary: "'{{name}}' arbitrary value syntax forbidden; use closest atomic or extend recipes.project.css",
+      outOfRange: "'{{name}}' out of range ({{valid}}); use closest atomic",
+    },
+  },
+  create(context) {
+    function checkClass(cls, node) {
+      // 白名单内的 class 直接放行（如 t-center/t-b 是合法原子类，非档位）
+      if (ALL_CLASSES.has(cls)) return;
+      // [xxx] 任意值
+      if (/[\[\]]/.test(cls)) {
+        context.report({ node, messageId: 'arbitrary', data: { name: cls } });
+        return;
+      }
+      // 档位越界：前缀-档位
+      const m = cls.match(/^([pmtr])-(.+)$/);
+      if (m) {
+        const [, prefix, val] = m;
+        const valid = RANGES[prefix.toUpperCase()] || RANGES[prefix];
+        if (valid && !valid.includes(val)) {
+          context.report({ node, messageId: 'outOfRange', data: { name: cls, valid: valid.join('/') } });
+        }
+      }
+    }
+    function checkString(str, node) {
+      for (const { classes } of extractAllClassLists(str)) {
+        for (const cls of classes) checkClass(cls, node);
+      }
+    }
+    return {
+      Literal(node) { if (typeof node.value === 'string') checkString(node.value, node); },
+      TemplateElement(node) { if (node.value?.raw) checkString(node.value.raw, node); },
+    };
+  },
+};