@af-mobile/eslint-plugin 2.0.1 → 2.0.4

package/index.js

@@ -1,4 +1,4 @@
-// AIFlow UI —— eslint-plugin-aiflow 入口（ESLint 9 flat config 兼容）
+// 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';
@@ -23,7 +23,7 @@ import wcBlockStates from './rules/wc-block-states.js';
 import wcBlockVariantEnum from './rules/wc-block-variant-enum.js';
 
 const plugin = {
-  meta: { name: 'eslint-plugin-aiflow', version: '2.0.1' },
+  meta: { name: 'eslint-plugin-af-mobile', version: '2.0.4' },
   rules: {
     // L1（2 条，全部 error；tokens-css-locked 由 CODEOWNERS + 分支保护，非 ESLint 规则）
     'no-token-modification': noTokenModification,
@@ -57,37 +57,37 @@ const plugin = {
 // recommended 配置：按设计文档 L4 §3.2-3.4 的 severity 启用
 Object.assign(plugin.configs, {
   recommended: {
-    plugins: { aiflow: plugin },
+    plugins: { 'af-mobile': plugin },
     rules: {
       // L1 error
-      'aiflow/no-token-modification': 'error',
-      'aiflow/no-inline-style': '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>，故在规则级放行
-      'aiflow/token-whitelist': ['error', { extraComponents: ['af-data'] }],
-      'aiflow/no-recipe-break': 'error',
-      'aiflow/no-arbitrary-value': 'error',
-      'aiflow/no-tailwind-syntax': 'error',
+      '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
-      'aiflow/no-variant-conflict': 'warn',
-      'aiflow/prefer-component': 'warn',
-      'aiflow/atomic-duplicate': 'warn',
+      'af-mobile/no-variant-conflict': 'warn',
+      'af-mobile/prefer-component': 'warn',
+      'af-mobile/atomic-duplicate': 'warn',
       // L3 error
-      'aiflow/wc-light-no-style': 'error',
-      'aiflow/wc-shadow-use-token': 'error',
-      'aiflow/wc-event-naming': 'error',
-      'aiflow/wc-aria-required': '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
-      'aiflow/wc-part-naming': 'warn',
-      'aiflow/wc-cleanup': 'warn',
+      'af-mobile/wc-part-naming': 'warn',
+      'af-mobile/wc-cleanup': 'warn',
       // L3.5 error（Block 层约束）
-      'aiflow/wc-block-no-internal-ref': 'error',
-      'aiflow/wc-block-props-count': 'error',
-      'aiflow/wc-block-states': 'error',
-      // L3.5 warn（引导性/启发式）
-      'aiflow/no-register-all': 'warn',
-      'aiflow/wc-block-variant-enum': 'warn',
+      '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',
     },
   },
 });

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@af-mobile/eslint-plugin",
-  "version": "2.0.1",
-  "description": "AIFlow UI ESLint plugin — 27 rules (L1/L2/L3/L3.5) enforcing design-system + Web Component constraints",
+  "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",
@@ -25,7 +25,7 @@
     "eslint-plugin",
     "web-components",
     "design-system",
-    "aiflow"
+    "af-mobile"
   ],
   "license": "MIT"
 }

package/rules/atomic-duplicate.js

@@ -1,4 +1,4 @@
-// L2-7 aiflow/atomic-duplicate（warn，可自动修）
+// L2-7 af-mobile/atomic-duplicate（warn，可自动修）
 // 检测：同一 class 属性内出现两个同属性原子（如 p-4 p-2），保留最后一个
 import { extractAllClassLists } from '../utils/helpers.js';
 
@@ -34,15 +34,15 @@ export default {
             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);
-              const trimmedBefore = before.replace(/\s+$/, '');
-              return fixer.replaceText(node, trimmedBefore + after);
+              const after = text.slice(classIdx + prev.cls.length).replace(/^\s+/, '');
+              return fixer.replaceText(node, before + after);
             },
           });
         }

package/rules/no-arbitrary-value.js

@@ -1,10 +1,10 @@
-// L2-4 aiflow/no-arbitrary-value（error，部分可自动修）
-// 检测：class 含 [xxx] 任意值语法 / 档位越界（如 p-7）
+// 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', '8', '10'],
+  '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'],

package/rules/no-inline-style.js

@@ -1,4 +1,4 @@
-// L1-2 aiflow/no-inline-style（error，部分可自动修）
+// L1-2 af-mobile/no-inline-style（error，部分可自动修）
 // 检测：style="" 中设置 forbiddenInlineStyle 列表内的属性
 // 例外：display/transform/z-index/width/height 等布局属性放行；skeleton class 元素内 width/height 放行
 // 适用：HTML/JS 文件中所有字符串字面量（含 template literal），覆盖组件 innerHTML 赋值场景

package/rules/no-recipe-break.js

@@ -1,12 +1,14 @@
-// L2-2 aiflow/no-recipe-break（error，3 子规则）
-// a: .cell + f/fc 原子 → 布局冲突
+// L2-2 af-mobile/no-recipe-break（error，4 子规则）
+// a: .cell + f/fi/fc 原子 → 布局冲突
 // b: .btn（非 .btn-ghost）+ text-brand/text-danger/text-success → 对比度问题
 // c: .input + t-sm/t-xs → iOS 焦点缩放
+// d: .btn（非 .btn-ghost）+ bg-card/bg-muted → 背景覆盖破坏 onbrand 对比度
 import { extractAllClassLists } from '../utils/helpers.js';
 
-const FLEX_ATOMS = new Set(['f', 'fc']);
+const FLEX_ATOMS = new Set(['f', 'fi', 'fc']);
 const COLORED_TEXT = new Set(['text-brand', 'text-danger', 'text-success']);
 const SMALL_FONT = new Set(['t-sm', 't-xs']);
+const BROKEN_BG = new Set(['bg-card', 'bg-muted']);
 
 export default {
   meta: {
@@ -16,13 +18,14 @@ export default {
     messages: {
       cellFlex: ".cell has built-in display:flex, adding 'f'/'fc' may break layout",
       btnColor: ".btn background uses --c-brand, text color must keep --c-onbrand contrast. Use .btn-ghost instead for colored text",
-      inputFont: ".input font-size must be 16px (--t-md) to prevent iOS focus zoom. Put help text in <label> or .form-err instead",
+      inputFont: "form control (.input/.textarea/.search-input) font-size must be 16px (--t-input) to prevent iOS focus zoom. Put help text in <label> or .form-err instead",
+      btnBg: ".btn background is --c-brand with white text; overriding background with 'bg-card'/'bg-muted' breaks contrast. Use .btn-ghost instead",
     },
   },
   create(context) {
     function checkClasses(classes, node) {
       const set = new Set(classes);
-      // a: .cell + f/fc
+      // a: .cell + f/fi/fc
       if (set.has('cell')) {
         for (const a of FLEX_ATOMS) {
           if (set.has(a)) { context.report({ node, messageId: 'cellFlex' }); break; }
@@ -33,9 +36,13 @@ export default {
         for (const a of COLORED_TEXT) {
           if (set.has(a)) { context.report({ node, messageId: 'btnColor' }); break; }
         }
+        // d: 背景覆盖同样破坏 onbrand 对比度
+        for (const a of BROKEN_BG) {
+          if (set.has(a)) { context.report({ node, messageId: 'btnBg' }); break; }
+        }
       }
-      // c: .input + t-sm/t-xs
-      if (set.has('input')) {
+      // c: 表单控件 + t-sm/t-xs（.input/.textarea/.search-input 均为 --t-input 16px 基准）
+      if (set.has('input') || set.has('textarea') || set.has('search-input')) {
         for (const a of SMALL_FONT) {
           if (set.has(a)) { context.report({ node, messageId: 'inputFont' }); break; }
         }

package/rules/no-register-all.js

@@ -1,5 +1,5 @@
-// L3 aiflow/no-register-all（error）
-// 检测：registerAll() 调用（已废弃，诱导全量加载，失去 Tree Shaking）
+// L3 af-mobile/no-register-all（error）
+// 检测：registerAll() 调用（已废弃/已移除，诱导全量加载，失去 Tree Shaking）
 // 正确：register('af-list', 'af-dialog') 显式列名，配合 Tree Shaking 按需打包
 export default {
   meta: {
@@ -7,13 +7,15 @@ export default {
     docs: { description: '禁止 registerAll()，改用 register(...names) 显式列名', fixable: 'ai-rewrite' },
     schema: [],
     messages: {
-      registerAll: "registerAll() 已废弃（诱导全量加载，失去 Tree Shaking），改用 register(...names) 显式列名",
+      registerAll: "registerAll() 已废弃/已移除（全量注册 = 全局引入），改用 register(...names) 显式列名",
     },
   },
   create(context) {
     const filename = context.filename || context.getFilename();
-    // 非消费端放行：库源码（index.js 导出 registerAll）/单元测试/构建脚本（build.mjs 全量入口）
-    if (/src[\\/]|test[\\/]|scripts[\\/]/.test(filename)) return {};
+    // 非消费端放行：单元测试夹具 / 构建脚本
+    // 注意：原正则含 `src[\\/]` 会误伤消费端 src/main.js——消费端恰恰是要约束的对象。
+    // 库源码 src/ 不在此 skip 也安全：库源码已移除 registerAll（按需引入铁律）。
+    if (/test[\\/]|scripts[\\/]/.test(filename)) return {};
     return {
       CallExpression(node) {
         const callee = node.callee;

package/rules/no-tailwind-syntax.js

@@ -1,4 +1,4 @@
-// L2-5 aiflow/no-tailwind-syntax（error）
+// L2-5 af-mobile/no-tailwind-syntax（error）
 // 检测：class 含 sm:/md:/lg:/xl:/hover:/focus:/active:/dark: 前缀
 import { extractAllClassLists } from '../utils/helpers.js';
 

package/rules/no-token-modification.js

@@ -1,4 +1,4 @@
-// L1-1 aiflow/no-token-modification（error）
+// L1-1 af-mobile/no-token-modification（error）
 // 检测：非 tokens.css / tokens.project.css 文件内，重定义 --(c|s|r|t|lh|fw|shadow|z|ease|dur)-* 变量
 // 例外：路径匹配 **/tokens.css 或 **/tokens.project.css
 import postcss from 'postcss';

package/rules/no-variant-conflict.js

@@ -1,4 +1,4 @@
-// L2-3 aiflow/no-variant-conflict（warn，可自动修）
+// L2-3 af-mobile/no-variant-conflict（warn，可自动修）
 // 检测：同属性互斥变体对同时出现，自动修：保留最后一个
 import { extractAllClassLists } from '../utils/helpers.js';
 
@@ -9,7 +9,13 @@ const CONFLICT_GROUPS = [
   // 圆角类
   ['r-s', 'r-m', 'r-l', 'r-f'],
   // padding 类
-  ['p-0', 'p-1', 'p-2', 'p-3', 'p-4', 'p-5', 'p-6', 'p-8', 'p-10'],
+  ['p-0', 'p-1', 'p-2', 'p-3', 'p-4', 'p-5', 'p-6', 'p-7', 'p-8', 'p-10'],
+  // display 类（同为 display 属性）
+  ['f', 'fi', 'fc'],
+  // 行高类
+  ['lh-tight', 'lh-normal'],
+  // 背景类
+  ['bg-brand', 'bg-card', 'bg-muted'],
 ];
 
 export default {
@@ -39,19 +45,15 @@ export default {
             messageId: 'conflict',
             data: { a: r, b: keep },
             fix(fixer) {
-              // 删除 class 名（含前导空格）
+              // 删除 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(r);
-              // 删除 " r" 或 "r " 或 "r"
               const before = text.slice(0, classIdx);
-              const after = text.slice(classIdx + r.length);
-              // 如果前面有空格，连空格一起删
-              const trimmedBefore = before.replace(/\s+$/, '');
-              const newText = trimmedBefore + after;
-              return fixer.replaceText(node, newText);
+              const after = text.slice(classIdx + r.length).replace(/^\s+/, '');
+              return fixer.replaceText(node, before + after);
             },
           });
         }

package/rules/prefer-component.js

@@ -1,4 +1,4 @@
-// L2-6 aiflow/prefer-component（warn）
+// L2-6 af-mobile/prefer-component（warn）
 // 检测：(a) .toast class + setTimeout / (b) .sheet class vs <af-action-sheet> / (c) .list class + scroll 监听
 import { extractAllClassLists } from '../utils/helpers.js';
 

package/rules/token-whitelist.js

@@ -1,6 +1,7 @@
-// L2-1 aiflow/token-whitelist（error）
+// L2-1 af-mobile/token-whitelist（error）
 // 检测：class="" 中的 class / 自定义元素 tagName → 与 whitelist + extraClass/extraComponents 对比
-import { ALL_CLASSES, ALL_COMPONENTS, extractAllClassLists, extractCustomElements } from '../utils/helpers.js';
+// 模板插值 class（btn-${type}）无法静态解析 → 单独报 interpolatedClass（伪报为"不在白名单"会误导修法）
+import { ALL_CLASSES, ALL_COMPONENTS, extractAllClassLists, extractCustomElements, suggestNearest } from '../utils/helpers.js';
 
 export default {
   meta: {
@@ -15,28 +16,33 @@ export default {
       additionalProperties: false,
     }],
     messages: {
-      unknownClass: "Class '{{name}}' not in whitelist. Use recipe/atomic or register in 'aiflow/token-whitelist' rule's extraClass",
-      unknownComponent: "Component '{{name}}' not in whitelist. Register in 'aiflow/token-whitelist' rule's extraComponents",
+      unknownClass: "Class '{{name}}' not in whitelist.{{suggest}} Use recipe/atomic, or paste into eslint.config.js: 'af-mobile/token-whitelist': ['error', { extraClass: ['{{name}}'] }]",
+      unknownComponent: "Component '{{name}}' not in whitelist.{{suggest}} Paste into eslint.config.js: 'af-mobile/token-whitelist': ['error', { extraComponents: ['{{name}}'] }]",
+      interpolatedClass: "Class '{{name}}' contains template interpolation and cannot be checked statically. Use static whitelist classes plus data-* attributes, or a ternary switching between whitelisted classes",
     },
   },
   create(context) {
     const options = context.options[0] || {};
     const allowClass = new Set([...ALL_CLASSES, ...(options.extraClass || [])]);
     const allowComp = new Set([...ALL_COMPONENTS, ...(options.extraComponents || [])]);
+    const extraClasses = [...allowClass];
+    const extraComps = [...allowComp];
 
     function checkString(str, node) {
       // class 检查
       for (const { classes } of extractAllClassLists(str)) {
         for (const cls of classes) {
-          if (!allowClass.has(cls)) {
-            context.report({ node, messageId: 'unknownClass', data: { name: cls } });
+          if (cls.includes('${')) {
+            context.report({ node, messageId: 'interpolatedClass', data: { name: cls } });
+          } else if (!allowClass.has(cls)) {
+            context.report({ node, messageId: 'unknownClass', data: { name: cls, suggest: suggestNearest(cls, extraClasses) } });
           }
         }
       }
       // 自定义元素检查
       for (const tag of extractCustomElements(str)) {
         if (!allowComp.has(tag)) {
-          context.report({ node, messageId: 'unknownComponent', data: { name: tag } });
+          context.report({ node, messageId: 'unknownComponent', data: { name: tag, suggest: suggestNearest(tag, extraComps) } });
         }
       }
     }
@@ -56,7 +62,7 @@ export default {
           if (arg.type === 'Literal' && typeof arg.value === 'string') {
             for (const cls of arg.value.split(/\s+/).filter(Boolean)) {
               if (!allowClass.has(cls)) {
-                context.report({ node: arg, messageId: 'unknownClass', data: { name: cls } });
+                context.report({ node: arg, messageId: 'unknownClass', data: { name: cls, suggest: suggestNearest(cls, extraClasses) } });
               }
             }
           }
@@ -65,7 +71,7 @@ export default {
               if (el?.type === 'Literal' && typeof el.value === 'string') {
                 for (const cls of el.value.split(/\s+/).filter(Boolean)) {
                   if (!allowClass.has(cls)) {
-                    context.report({ node: el, messageId: 'unknownClass', data: { name: cls } });
+                    context.report({ node: el, messageId: 'unknownClass', data: { name: cls, suggest: suggestNearest(cls, extraClasses) } });
                   }
                 }
               }

package/rules/wc-aria-required.js

@@ -1,4 +1,4 @@
-// L3-5 aiflow/wc-aria-required（error）
+// L3-5 af-mobile/wc-aria-required（error）
 // 检测：组件 render 输出的 DOM 缺少必需的 ARIA 角色/属性
 import { readFileSync } from 'node:fs';
 import { fileURLToPath } from 'node:url';
@@ -22,7 +22,7 @@ export default {
   },
   create(context) {
     const filename = context.filename || context.getFilename();
-    if (!/src[\\/](?:charts[\\/])?components[\\/].*\.js$/.test(filename)) return {};
+    if (!/src[\\/](?:(?:charts|chat)[\\/])?components[\\/].*\.js$/.test(filename)) return {};
 
     // 从文件名提取组件名（af-xxx.js → af-xxx）
     const m = filename.match(/(af-[a-z-]+)\.js$/);

package/rules/wc-block-no-internal-ref.js

@@ -1,4 +1,4 @@
-// L3.5 aiflow/wc-block-no-internal-ref（error）
+// L3.5 af-mobile/wc-block-no-internal-ref（error）
 // 检测：消费端代码（非 src/）禁止穿透 Block 边界访问内部
 // 反例：querySelector('af-auth-form > div') / blockInstance.shadowRoot.querySelector(...)
 // 正例：document.querySelector('af-auth-form').setAttribute('loading', 'true')
@@ -18,7 +18,8 @@ export default {
     if (/src[\\/]|test[\\/]|scripts[\\/]/.test(filename)) return {};
 
     // af-* 标签选择器（含子代/后代穿透）：af-xxx > 或 af-xxx 空格 后跟其他选择器
-    const PENETRATE_RE = /af-[a-z]+(?:[>+~]|\s+[^,)\]]+)/;
+    // 标签名含连字符（af-auth-form），字符类须含 - 否则匹配不到组合器
+    const PENETRATE_RE = /af-[a-z][a-z0-9-]*(?:[>+~]|\s+[^,)\]]+)/;
 
     return {
       CallExpression(node) {

package/rules/wc-block-props-count.js

@@ -1,4 +1,4 @@
-// L3.5 aiflow/wc-block-props-count（error）
+// L3.5 af-mobile/wc-block-props-count（error）
 // 检测：Block 类的 AfElement.defineProp 调用数必须在 2-5 之间
 // 适用：src/blocks/**/*.js
 export default {

package/rules/wc-block-states.js

@@ -1,4 +1,4 @@
-// L3.5 aiflow/wc-block-states（error）
+// L3.5 af-mobile/wc-block-states（error）
 // 检测：Block 类的 mounted/render/_render 方法必须包含 loading/error/empty 分支
 // 五态：idle（默认）/ loading / error / empty / success
 // 检测策略：源码文本扫描，找 loading / error / empty 三个关键词至少各出现一次（在条件分支中）

package/rules/wc-block-variant-enum.js

@@ -1,4 +1,4 @@
-// L3.5 aiflow/wc-block-variant-enum（warn）
+// L3.5 af-mobile/wc-block-variant-enum（warn）
 // 检测：Block 类的 variant 属性必须在 defineProp 时声明枚举值，或在 onAttributeChange 中校验
 // 策略：检测 defineProp(proto, 'variant', { ... }) 调用，检查是否有 enum / values / 一行注释枚举
 // 或：onAttributeChange 内有 variant 的 if/switch 校验
@@ -64,6 +64,15 @@ export default {
           variantEnumDeclared = true;
         }
       },
+      // 赋值形式：AfFoo.prototype.onAttributeChange = function (name) { ... }
+      AssignmentExpression(node) {
+        const left = node.left;
+        if (left?.type !== 'MemberExpression' || left.property?.name !== 'onAttributeChange') return;
+        const bodyText = sourceCode.getText(node.right);
+        if (/variant/.test(bodyText) && /(if|switch)/.test(bodyText)) {
+          variantEnumDeclared = true;
+        }
+      },
       'Program:exit'() {
         if (hasVariantProp && !variantEnumDeclared) {
           context.report({ loc: { line: 1, column: 0 }, messageId: 'noEnum' });

package/rules/wc-cleanup.js

@@ -1,4 +1,4 @@
-// L3-6 aiflow/wc-cleanup（warn）
+// L3-6 af-mobile/wc-cleanup（warn）
 // 检测两类资源泄漏（覆盖 src/components 与 src/blocks）：
 // 1) addEventListener 未通过 this._listen() 登记（传 signal 选项的原生自动解绑除外）
 //    —— 基类 disconnectedCallback 统一解绑 _listeners，绕过登记即泄漏

package/rules/wc-event-naming.js

@@ -1,4 +1,4 @@
-// L3-4 aiflow/wc-event-naming（error，可自动修）
+// L3-4 af-mobile/wc-event-naming（error，可自动修）
 // 检测：emit('xxx') 调用名不匹配 /^af-[a-z0-9]+:[a-z]+$/
 const EVENT_RE = /^af-[a-z0-9-]+:[a-z]+$/;
 
@@ -32,13 +32,18 @@ export default {
           .toLowerCase();
         // 如果不含冒号，尝试在组件名后插入冒号
         if (!fixed.includes(':')) {
-          // 检测 af- 前缀
           if (fixed.startsWith('af-')) {
-            // 在 af-xxx 后插入 : （xxx 是第一个单词）
-            fixed = fixed.replace(/^af-([a-z0-9]+)/, 'af-$1:');
+            // af-xxx-yyy → af-xxx:yyy（首个 - 起视为动作；动作段的 - 去除，保证 [a-z]+ 格式）
+            const rest = fixed.slice(3);
+            const dash = rest.indexOf('-');
+            if (dash > 0) {
+              fixed = `af-${rest.slice(0, dash)}:${rest.slice(dash + 1).replace(/-/g, '')}`;
+            } else {
+              fixed = 'af-component:' + rest;
+            }
           } else {
             // 无 af- 前缀，添加 af- 前缀 + 冒号
-            fixed = 'af-component:' + fixed;
+            fixed = 'af-component:' + fixed.replace(/-/g, '');
           }
         }
         context.report({

package/rules/wc-light-no-style.js

@@ -1,4 +1,4 @@
-// L3-1 aiflow/wc-light-no-style（error）
+// L3-1 af-mobile/wc-light-no-style（error）
 // 检测：Light 组件（useShadow=false）中 .style.xxx 赋值 / innerHTML 含 <style> 标签 / innerHTML 含 style="..." 属性
 export default {
   meta: {

package/rules/wc-part-naming.js

@@ -1,4 +1,4 @@
-// L3-3 aiflow/wc-part-naming（warn）
+// L3-3 af-mobile/wc-part-naming（warn）
 // 检测：part="xxx" 属性名非 kebab-case
 const KEBAB_RE = /^[a-z]+(-[a-z0-9]+)*$/;
 

package/rules/wc-shadow-use-token.js

@@ -1,4 +1,4 @@
-// L3-2 aiflow/wc-shadow-use-token（error）
+// L3-2 af-mobile/wc-shadow-use-token（error）
 // 检测：Shadow 组件 CSS 字符串中颜色/间距/字号/圆角硬编码（非 var(--*)）
 // 例外：backdrop 遮罩半透明黑
 import postcss from 'postcss';

package/utils/aria-requirements.json

@@ -39,6 +39,15 @@
     "role": "listbox",
     "description": "选择器列需要 role=listbox"
   },
+  "af-number-keyboard": {
+    "role": "dialog",
+    "ariaLabel": true,
+    "description": "数字键盘弹层需要 role=dialog 和 aria-label；按键为原生 button 天然支持键盘操作"
+  },
+  "af-password-input": {
+    "ariaLabel": true,
+    "description": "密码格子容器需要 aria-label（含输入进度播报）"
+  },
   "af-img": {
     "description": "图片组件无强制 ARIA 要求"
   },
@@ -83,5 +92,10 @@
     "role": "img",
     "ariaLabel": true,
     "description": "漏斗图 svg 需要 role=img 和 aria-label 摘要（全量数据由 sr-table 提供）"
+  },
+  "af-chat": {
+    "role": "log",
+    "ariaLive": true,
+    "description": "对话记录容器需要 role=log 和 aria-live=polite（流式文本 aria-hidden，完成时 sr-only 一次性播报）"
   }
 }

package/utils/helpers.js

@@ -1,4 +1,4 @@
-// AIFlow UI —— ESLint 规则共享工具
+// af-mobile UI —— ESLint 规则共享工具
 import { readFileSync } from 'node:fs';
 import { fileURLToPath } from 'node:url';
 import { resolve, dirname } from 'node:path';
@@ -53,3 +53,32 @@ export function extractCustomElements(str) {
   while ((m = re.exec(str))) results.push(m[1]);
   return results;
 }
+
+// 编辑距离（Levenshtein）：最近邻建议用，候选集小（<200）无需提前剪枝
+function levenshtein(a, b) {
+  const dp = Array.from({ length: a.length + 1 }, (_, i) => [i, ...Array(b.length).fill(0)]);
+  for (let j = 0; j <= b.length; j++) dp[0][j] = j;
+  for (let i = 1; i <= a.length; i++) {
+    for (let j = 1; j <= b.length; j++) {
+      dp[i][j] = Math.min(
+        dp[i - 1][j] + 1,
+        dp[i][j - 1] + 1,
+        dp[i - 1][j - 1] + (a[i - 1] === b[j - 1] ? 0 : 1),
+      );
+    }
+  }
+  return dp[a.length][b.length];
+}
+
+// 最近邻建议：返回 " Did you mean 'xxx'?" 或 ''（无足够接近的候选）
+// 阈值随长度放宽：≤3 字符允许 1 距离，更长允许 2
+export function suggestNearest(name, candidates) {
+  const max = name.length <= 3 ? 1 : 2;
+  let best = null, bestDist = max + 1;
+  for (const c of candidates) {
+    if (Math.abs(c.length - name.length) > max) continue;
+    const d = levenshtein(name, c);
+    if (d < bestDist) { best = c; bestDist = d; }
+  }
+  return best ? ` Did you mean '${best}'?` : '';
+}

package/utils/whitelist-v1.json

@@ -1,6 +1,6 @@
 {
   "version": "v1",
-  "aiflowVersion": "1.0.0",
+  "af-mobileVersion": "1.5.2",
   "classes": {
     "recipe": [
       "actions",
@@ -12,6 +12,9 @@
       "btn-danger",
       "btn-ghost",
       "btn-lg",
+      "btn-mini",
+      "btn-plain",
+      "btn-round",
       "btn-sm",
       "btn-success",
       "caption",
@@ -20,29 +23,33 @@
       "center",
       "checkbox",
       "checkbox-sm",
-      "checkout-bar",
-      "collapse",
-      "collapse-content",
-      "collapse-summary",
+      "clp",
+      "clp-ct",
+      "clp-sum",
+      "cob",
+      "cob-fx",
+      "display",
       "divider",
       "empty",
+      "eyebrow",
       "form-err",
       "form-row",
       "form-row-h",
       "hero",
       "input",
       "input-bar",
+      "input-bar-fx",
       "input-err",
       "label",
       "list",
       "list-item",
-      "list-item-compact",
+      "list-item-cp",
       "meta",
       "navbar",
       "navbar-fixed",
       "notice",
-      "notice-scroll",
-      "notice-text",
+      "notice-scr",
+      "notice-tx",
       "page",
       "page-col",
       "price",
@@ -56,28 +63,32 @@
       "radio-sm",
       "rate",
       "rate-lg",
-      "rate-readonly",
+      "rate-ro",
       "rate-sm",
       "rate-star",
+      "safe-bottom",
+      "safe-top",
+      "sb-clear",
+      "sb-icon",
+      "sb-wrap",
       "scroll-y",
-      "search-bar-clear",
-      "search-bar-icon",
-      "search-bar-wrap",
       "search-input",
-      "segmented",
-      "segmented-block",
-      "segmented-item",
+      "section",
+      "section-tt",
+      "seg",
+      "seg-blk",
+      "seg-it",
       "sheet",
-      "skeleton",
-      "skeleton-block",
-      "skeleton-block-h-md",
-      "skeleton-block-h-sm",
-      "skeleton-circle",
-      "skeleton-line",
-      "skeleton-page",
-      "skeleton-w-40",
-      "skeleton-w-60",
-      "skeleton-w-80",
+      "sk",
+      "sk-blk",
+      "sk-blk-h-md",
+      "sk-blk-h-sm",
+      "sk-cir",
+      "sk-ln",
+      "sk-pg",
+      "sk-w-40",
+      "sk-w-60",
+      "sk-w-80",
       "spinner",
       "spinner-lg",
       "spinner-sm",
@@ -90,44 +101,61 @@
       "steps",
       "subtitle",
       "switch",
-      "switch-loading",
+      "switch-ldg",
       "switch-on",
       "switch-sm",
-      "switch-thumb",
+      "switch-th",
       "tab-item",
       "tabbar",
       "tabbar-fixed",
       "tag",
       "tag-danger",
+      "tag-lg",
+      "tag-md",
       "tag-ok",
+      "tag-plain",
       "tag-warn",
       "textarea",
       "thumb",
       "title",
       "toast",
-      "upload-grid",
-      "upload-trigger"
+      "toast-error",
+      "toast-success",
+      "toast-warning",
+      "upload-gd",
+      "upload-tg"
     ],
     "atomic": [
       "aic",
       "bg-brand",
+      "bg-card",
       "bg-muted",
+      "ellipsis",
+      "ellipsis-2",
       "f",
       "fc",
+      "fi",
       "flex-1",
       "g-0",
       "g-1",
       "g-2",
       "g-3",
       "g-4",
+      "hl-b",
+      "hl-t",
       "jcc",
       "jce",
       "jcsb",
+      "lh-normal",
+      "lh-tight",
+      "list",
       "m-0",
       "m-1",
       "m-2",
       "m-3",
       "m-4",
+      "m-5",
+      "navbar",
       "p-0",
       "p-1",
       "p-10",
@@ -136,6 +164,7 @@
       "p-4",
       "p-5",
       "p-6",
+      "p-7",
       "p-8",
       "r-0",
       "r-f",
@@ -145,13 +174,16 @@
       "shadow-lg",
       "shadow-md",
       "shadow-sm",
+      "shrink-0",
       "t-b",
       "t-center",
+      "t-display",
       "t-left",
       "t-lg",
       "t-m",
       "t-md",
       "t-right",
+      "t-semibold",
       "t-sm",
       "t-xl",
       "t-xs",
@@ -174,6 +206,7 @@
     "af-chart-line",
     "af-chart-pie",
     "af-chart-radar",
+    "af-chat",
     "af-countdown",
     "af-dialog",
     "af-dropdown",
@@ -182,6 +215,8 @@
     "af-list",
     "af-navbar",
     "af-notice-bar",
+    "af-number-keyboard",
+    "af-password-input",
     "af-picker",
     "af-progress",
     "af-pull-refresh",
@@ -202,11 +237,22 @@
     "--c-bg",
     "--c-border",
     "--c-brand",
+    "--c-brand-soft",
+    "--c-brand-strong",
     "--c-card",
     "--c-danger",
+    "--c-gray-1",
+    "--c-gray-2",
+    "--c-gray-3",
+    "--c-gray-4",
+    "--c-gray-5",
+    "--c-gray-6",
+    "--c-gray-7",
+    "--c-gray-8",
     "--c-muted",
     "--c-muted-bg",
     "--c-onbrand",
+    "--c-onwarn",
     "--c-success",
     "--c-text",
     "--c-warn",
@@ -218,17 +264,32 @@
     "--fw-bold",
     "--fw-medium",
     "--fw-normal",
+    "--fw-semibold",
+    "--lh-display",
     "--lh-normal",
     "--lh-tight",
+    "--ls-caption",
+    "--ls-display",
     "--palette-bg",
     "--palette-border",
     "--palette-brand",
+    "--palette-brand-soft",
+    "--palette-brand-strong",
     "--palette-card",
     "--palette-color-scheme",
     "--palette-danger",
+    "--palette-gray-1",
+    "--palette-gray-2",
+    "--palette-gray-3",
+    "--palette-gray-4",
+    "--palette-gray-5",
+    "--palette-gray-6",
+    "--palette-gray-7",
+    "--palette-gray-8",
     "--palette-muted",
     "--palette-muted-bg",
     "--palette-onbrand",
+    "--palette-onwarn",
     "--palette-shadow-lg",
     "--palette-shadow-md",
     "--palette-shadow-sm",
@@ -239,20 +300,28 @@
     "--r-l",
     "--r-m",
     "--r-s",
+    "--r-xs",
+    "--ring-focus",
     "--s-1",
     "--s-2",
     "--s-3",
     "--s-4",
     "--s-5",
     "--s-6",
+    "--s-7",
+    "--s-8",
+    "--shadow-brand",
     "--shadow-lg",
     "--shadow-md",
     "--shadow-sm",
+    "--t-display",
+    "--t-input",
     "--t-lg",
     "--t-md",
     "--t-sm",
     "--t-xl",
     "--t-xs",
+    "--tabbar-h",
     "--z-base",
     "--z-dropdown",
     "--z-modal",