@af-mobile/eslint-plugin 2.0.4 → 2.2.0

package/rules/wc-aria-required.js

@@ -1,60 +1,60 @@
-// L3-5 af-mobile/wc-aria-required（error）
-// 检测：组件 render 输出的 DOM 缺少必需的 ARIA 角色/属性
-import { readFileSync } from 'node:fs';
-import { fileURLToPath } from 'node:url';
-import { resolve, dirname } from 'node:path';
-
-const __dirname = dirname(fileURLToPath(import.meta.url));
-const ariaPath = resolve(__dirname, '../utils/aria-requirements.json');
-const ARIA_REQ = JSON.parse(readFileSync(ariaPath, 'utf8'));
-
-export default {
-  meta: {
-    type: 'problem',
-    docs: { description: '组件必须包含声明的必需 ARIA 角色/属性' },
-    schema: [],
-    messages: {
-      missingRole: "af-{{comp}} missing role=\"{{role}}\"; required by WAI-ARIA, see aria-requirements.json",
-      missingAriaLabel: "af-{{comp}} missing aria-label; required for screen reader accessibility",
-      missingAriaLive: "af-{{comp}} missing aria-live; required for dynamic content announcements",
-      missingAriaChecked: "af-{{comp}} missing aria-checked; required for switch/checkbox state",
-    },
-  },
-  create(context) {
-    const filename = context.filename || context.getFilename();
-    if (!/src[\\/](?:(?:charts|chat)[\\/])?components[\\/].*\.js$/.test(filename)) return {};
-
-    // 从文件名提取组件名（af-xxx.js → af-xxx）
-    const m = filename.match(/(af-[a-z-]+)\.js$/);
-    if (!m) return {};
-    const compName = m[1];
-    const req = ARIA_REQ[compName];
-    if (!req) return {};
-
-    const sourceCode = context.sourceCode || context.getSourceCode();
-
-    return {
-      'Program:exit'() {
-        const source = sourceCode.getText();
-        // 识别两种形式：(a) 字面量 role="xxx" (b) setAttribute('role', 'xxx')
-        const hasRole = (r) =>
-          source.includes(`role="${r}"`) ||
-          source.includes(`role='${r}'`) ||
-          source.includes(`setAttribute('role', '${r}')`) ||
-          source.includes(`setAttribute("role", "${r}")`);
-        if (req.role && !hasRole(req.role)) {
-          context.report({ loc: { line: 1, column: 0 }, messageId: 'missingRole', data: { comp: compName, role: req.role } });
-        }
-        if (req.ariaLabel && !source.includes('aria-label') && !source.includes("ariaLabel")) {
-          context.report({ loc: { line: 1, column: 0 }, messageId: 'missingAriaLabel', data: { comp: compName } });
-        }
-        if (req.ariaLive && !source.includes('aria-live') && !source.includes("ariaLive")) {
-          context.report({ loc: { line: 1, column: 0 }, messageId: 'missingAriaLive', data: { comp: compName } });
-        }
-        if (req.ariaChecked && !source.includes('aria-checked') && !source.includes("ariaChecked")) {
-          context.report({ loc: { line: 1, column: 0 }, messageId: 'missingAriaChecked', data: { comp: compName } });
-        }
-      },
-    };
-  },
-};
+// L3-5 af-mobile/wc-aria-required（error）
+// 检测：组件 render 输出的 DOM 缺少必需的 ARIA 角色/属性
+import { readFileSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import { resolve, dirname } from 'node:path';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const ariaPath = resolve(__dirname, '../utils/aria-requirements.json');
+const ARIA_REQ = JSON.parse(readFileSync(ariaPath, 'utf8'));
+
+export default {
+  meta: {
+    type: 'problem',
+    docs: { description: '组件必须包含声明的必需 ARIA 角色/属性' },
+    schema: [],
+    messages: {
+      missingRole: "af-{{comp}} missing role=\"{{role}}\"; required by WAI-ARIA, see aria-requirements.json",
+      missingAriaLabel: "af-{{comp}} missing aria-label; required for screen reader accessibility",
+      missingAriaLive: "af-{{comp}} missing aria-live; required for dynamic content announcements",
+      missingAriaChecked: "af-{{comp}} missing aria-checked; required for switch/checkbox state",
+    },
+  },
+  create(context) {
+    const filename = context.filename || context.getFilename();
+    if (!/src[\\/](?:(?:charts|chat)[\\/])?components[\\/].*\.js$/.test(filename)) return {};
+
+    // 从文件名提取组件名（af-xxx.js → af-xxx）
+    const m = filename.match(/(af-[a-z-]+)\.js$/);
+    if (!m) return {};
+    const compName = m[1];
+    const req = ARIA_REQ[compName];
+    if (!req) return {};
+
+    const sourceCode = context.sourceCode || context.getSourceCode();
+
+    return {
+      'Program:exit'() {
+        const source = sourceCode.getText();
+        // 识别两种形式：(a) 字面量 role="xxx" (b) setAttribute('role', 'xxx')
+        const hasRole = (r) =>
+          source.includes(`role="${r}"`) ||
+          source.includes(`role='${r}'`) ||
+          source.includes(`setAttribute('role', '${r}')`) ||
+          source.includes(`setAttribute("role", "${r}")`);
+        if (req.role && !hasRole(req.role)) {
+          context.report({ loc: { line: 1, column: 0 }, messageId: 'missingRole', data: { comp: compName, role: req.role } });
+        }
+        if (req.ariaLabel && !source.includes('aria-label') && !source.includes("ariaLabel")) {
+          context.report({ loc: { line: 1, column: 0 }, messageId: 'missingAriaLabel', data: { comp: compName } });
+        }
+        if (req.ariaLive && !source.includes('aria-live') && !source.includes("ariaLive")) {
+          context.report({ loc: { line: 1, column: 0 }, messageId: 'missingAriaLive', data: { comp: compName } });
+        }
+        if (req.ariaChecked && !source.includes('aria-checked') && !source.includes("ariaChecked")) {
+          context.report({ loc: { line: 1, column: 0 }, messageId: 'missingAriaChecked', data: { comp: compName } });
+        }
+      },
+    };
+  },
+};

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

@@ -1,60 +1,60 @@
-// 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')
-export default {
-  meta: {
-    type: 'problem',
-    docs: { description: '消费端禁止穿透 Block 边界访问内部', fixable: 'manual' },
-    schema: [],
-    messages: {
-      childSelector: "querySelector('{{sel}}') penetrates Block boundary; only root tag selector allowed (e.g. 'af-auth-form')",
-      shadowRoot: "accessing .shadowRoot of Block '{{name}}' is forbidden; use props/events only",
-    },
-  },
-  create(context) {
-    const filename = context.filename || context.getFilename();
-    // 非消费端放行：库源码/单元测试/构建脚本
-    if (/src[\\/]|test[\\/]|scripts[\\/]/.test(filename)) return {};
-
-    // af-* 标签选择器（含子代/后代穿透）：af-xxx > 或 af-xxx 空格 后跟其他选择器
-    // 标签名含连字符（af-auth-form），字符类须含 - 否则匹配不到组合器
-    const PENETRATE_RE = /af-[a-z][a-z0-9-]*(?:[>+~]|\s+[^,)\]]+)/;
-
-    return {
-      CallExpression(node) {
-        const callee = node.callee;
-        // 匹配 xxx.querySelector(...) / querySelectorAll(...)
-        if (callee.type !== 'MemberExpression') return;
-        const propName = callee.property?.name;
-        if (propName !== 'querySelector' && propName !== 'querySelectorAll') return;
-
-        const selArg = node.arguments[0];
-        if (!selArg) return;
-        let sel = '';
-        if (selArg.type === 'Literal' && typeof selArg.value === 'string') sel = selArg.value;
-        else if (selArg.type === 'TemplateLiteral' && selArg.quasis.length === 1) sel = selArg.quasis[0].value.raw;
-
-        // 穿透检测：af-xxx > div / af-xxx div / af-xxx > .foo
-        if (sel && PENETRATE_RE.test(sel)) {
-          context.report({ node: selArg, messageId: 'childSelector', data: { sel } });
-        }
-      },
-      // 检测 blockInstance.shadowRoot 访问
-      MemberExpression(node) {
-        // 形如 xxx.shadowRoot
-        if (node.property?.type === 'Identifier' && node.property.name === 'shadowRoot') {
-          // 只对 af-* 开头的变量名报错（近似 Block 实例）
-          const obj = node.object;
-          let name = '';
-          if (obj.type === 'Identifier') name = obj.name;
-          else if (obj.type === 'MemberExpression' && obj.property?.name) name = obj.property.name;
-          // 启发式：变量名含 af 或块名关键词视为 Block 实例
-          if (/af|block|form|grid|card|list/i.test(name)) {
-            context.report({ node: node.property, messageId: 'shadowRoot', data: { name } });
-          }
-        }
-      },
-    };
-  },
-};
+// 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')
+export default {
+  meta: {
+    type: 'problem',
+    docs: { description: '消费端禁止穿透 Block 边界访问内部', fixable: 'manual' },
+    schema: [],
+    messages: {
+      childSelector: "querySelector('{{sel}}') penetrates Block boundary; only root tag selector allowed (e.g. 'af-auth-form')",
+      shadowRoot: "accessing .shadowRoot of Block '{{name}}' is forbidden; use props/events only",
+    },
+  },
+  create(context) {
+    const filename = context.filename || context.getFilename();
+    // 非消费端放行：库源码/单元测试/构建脚本
+    if (/src[\\/]|test[\\/]|scripts[\\/]/.test(filename)) return {};
+
+    // af-* 标签选择器（含子代/后代穿透）：af-xxx > 或 af-xxx 空格 后跟其他选择器
+    // 标签名含连字符（af-auth-form），字符类须含 - 否则匹配不到组合器
+    const PENETRATE_RE = /af-[a-z][a-z0-9-]*(?:[>+~]|\s+[^,)\]]+)/;
+
+    return {
+      CallExpression(node) {
+        const callee = node.callee;
+        // 匹配 xxx.querySelector(...) / querySelectorAll(...)
+        if (callee.type !== 'MemberExpression') return;
+        const propName = callee.property?.name;
+        if (propName !== 'querySelector' && propName !== 'querySelectorAll') return;
+
+        const selArg = node.arguments[0];
+        if (!selArg) return;
+        let sel = '';
+        if (selArg.type === 'Literal' && typeof selArg.value === 'string') sel = selArg.value;
+        else if (selArg.type === 'TemplateLiteral' && selArg.quasis.length === 1) sel = selArg.quasis[0].value.raw;
+
+        // 穿透检测：af-xxx > div / af-xxx div / af-xxx > .foo
+        if (sel && PENETRATE_RE.test(sel)) {
+          context.report({ node: selArg, messageId: 'childSelector', data: { sel } });
+        }
+      },
+      // 检测 blockInstance.shadowRoot 访问
+      MemberExpression(node) {
+        // 形如 xxx.shadowRoot
+        if (node.property?.type === 'Identifier' && node.property.name === 'shadowRoot') {
+          // 只对 af-* 开头的变量名报错（近似 Block 实例）
+          const obj = node.object;
+          let name = '';
+          if (obj.type === 'Identifier') name = obj.name;
+          else if (obj.type === 'MemberExpression' && obj.property?.name) name = obj.property.name;
+          // 启发式：变量名含 af 或块名关键词视为 Block 实例
+          if (/af|block|form|grid|card|list/i.test(name)) {
+            context.report({ node: node.property, messageId: 'shadowRoot', data: { name } });
+          }
+        }
+      },
+    };
+  },
+};

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

@@ -1,48 +1,48 @@
-// L3.5 af-mobile/wc-block-props-count（error）
-// 检测：Block 类的 AfElement.defineProp 调用数必须在 2-5 之间
-// 适用：src/blocks/**/*.js
-export default {
-  meta: {
-    type: 'problem',
-    docs: { description: 'Block props 数必须在 2-5' },
-    schema: [],
-    messages: {
-      tooFew: "Block '{{name}}' has {{n}} prop(s); minimum is 2 (合并到现有 Block 或补充必要 props)",
-      tooMany: "Block '{{name}}' has {{n}} props; maximum is 5 (拆分为多个 Block)",
-    },
-  },
-  create(context) {
-    const filename = context.filename || context.getFilename();
-    if (!/src[\\/]blocks[\\/].*\.js$/.test(filename)) return {};
-
-    const MIN = 2, MAX = 5;
-    let definePropCalls = 0;
-    let className = 'unknown';
-
-    return {
-      ClassDeclaration(node) {
-        if (node.id?.name) className = node.id.name;
-      },
-      CallExpression(node) {
-        // 匹配 AfElement.defineProp(...) 或 this.constructor.defineProp(...)
-        const callee = node.callee;
-        const isDefineProp =
-          (callee.type === 'MemberExpression' &&
-           callee.property?.type === 'Identifier' &&
-           callee.property.name === 'defineProp') ||
-          (callee.type === 'MemberExpression' &&
-           callee.object?.type === 'MemberExpression' &&
-           callee.object.property?.name === 'constructor' &&
-           callee.property?.name === 'defineProp');
-        if (isDefineProp) definePropCalls++;
-      },
-      'Program:exit'() {
-        if (definePropCalls > 0 && definePropCalls < MIN) {
-          context.report({ loc: { line: 1, column: 0 }, messageId: 'tooFew', data: { name: className, n: definePropCalls } });
-        } else if (definePropCalls > MAX) {
-          context.report({ loc: { line: 1, column: 0 }, messageId: 'tooMany', data: { name: className, n: definePropCalls } });
-        }
-      },
-    };
-  },
-};
+// L3.5 af-mobile/wc-block-props-count（error）
+// 检测：Block 类的 AfElement.defineProp 调用数必须在 2-5 之间
+// 适用：src/blocks/**/*.js
+export default {
+  meta: {
+    type: 'problem',
+    docs: { description: 'Block props 数必须在 2-5' },
+    schema: [],
+    messages: {
+      tooFew: "Block '{{name}}' has {{n}} prop(s); minimum is 2 (合并到现有 Block 或补充必要 props)",
+      tooMany: "Block '{{name}}' has {{n}} props; maximum is 5 (拆分为多个 Block)",
+    },
+  },
+  create(context) {
+    const filename = context.filename || context.getFilename();
+    if (!/src[\\/]blocks[\\/].*\.js$/.test(filename)) return {};
+
+    const MIN = 2, MAX = 5;
+    let definePropCalls = 0;
+    let className = 'unknown';
+
+    return {
+      ClassDeclaration(node) {
+        if (node.id?.name) className = node.id.name;
+      },
+      CallExpression(node) {
+        // 匹配 AfElement.defineProp(...) 或 this.constructor.defineProp(...)
+        const callee = node.callee;
+        const isDefineProp =
+          (callee.type === 'MemberExpression' &&
+           callee.property?.type === 'Identifier' &&
+           callee.property.name === 'defineProp') ||
+          (callee.type === 'MemberExpression' &&
+           callee.object?.type === 'MemberExpression' &&
+           callee.object.property?.name === 'constructor' &&
+           callee.property?.name === 'defineProp');
+        if (isDefineProp) definePropCalls++;
+      },
+      'Program:exit'() {
+        if (definePropCalls > 0 && definePropCalls < MIN) {
+          context.report({ loc: { line: 1, column: 0 }, messageId: 'tooFew', data: { name: className, n: definePropCalls } });
+        } else if (definePropCalls > MAX) {
+          context.report({ loc: { line: 1, column: 0 }, messageId: 'tooMany', data: { name: className, n: definePropCalls } });
+        }
+      },
+    };
+  },
+};

package/rules/wc-block-states.js

@@ -1,64 +1,64 @@
-// L3.5 af-mobile/wc-block-states（error）
-// 检测：Block 类的 mounted/render/_render 方法必须包含 loading/error/empty 分支
-// 五态：idle（默认）/ loading / error / empty / success
-// 检测策略：源码文本扫描，找 loading / error / empty 三个关键词至少各出现一次（在条件分支中）
-// 适用：src/blocks/**/*.js
-export default {
-  meta: {
-    type: 'problem',
-    docs: { description: 'Block 必须实现 loading/error/empty 三态分支' },
-    schema: [],
-    messages: {
-      missing: "Block '{{name}}' missing state '{{state}}'; must implement loading/error/empty branches in render",
-    },
-  },
-  create(context) {
-    const filename = context.filename || context.getFilename();
-    if (!/src[\\/]blocks[\\/].*\.js$/.test(filename)) return {};
-
-    const REQUIRED = ['loading', 'error', 'empty'];
-    const found = new Set();
-    let className = 'unknown';
-
-    return {
-      ClassDeclaration(node) {
-        if (node.id?.name) className = node.id.name;
-      },
-      // 检测 this.loading / this._error / this._data?.length（empty 分支）
-      // 检测 if (this.loading) / if (this._error) / if (!this._data?.length)
-      MemberExpression(node) {
-        const propName = node.property?.name;
-        if (propName === 'loading') found.add('loading');
-        if (propName === '_error' || propName === 'error') found.add('error');
-      },
-      // 检测字符串中的 loading/error/empty（模板、注释、class 名）
-      Literal(node) {
-        if (typeof node.value === 'string' && /(loading|error|empty)/.test(node.value)) {
-          for (const s of REQUIRED) {
-            if (node.value.includes(s)) found.add(s);
-          }
-        }
-      },
-      TemplateElement(node) {
-        const raw = node.value?.raw || '';
-        for (const s of REQUIRED) {
-          if (raw.includes(s)) found.add(s);
-        }
-      },
-      Identifier(node) {
-        // _renderLoading / _renderError / _renderEmpty 方法名
-        const name = node.name || '';
-        if (/loading/i.test(name)) found.add('loading');
-        if (/error/i.test(name)) found.add('error');
-        if (/empty/i.test(name)) found.add('empty');
-      },
-      'Program:exit'() {
-        for (const s of REQUIRED) {
-          if (!found.has(s)) {
-            context.report({ loc: { line: 1, column: 0 }, messageId: 'missing', data: { name: className, state: s } });
-          }
-        }
-      },
-    };
-  },
-};
+// L3.5 af-mobile/wc-block-states（error）
+// 检测：Block 类的 mounted/render/_render 方法必须包含 loading/error/empty 分支
+// 五态：idle（默认）/ loading / error / empty / success
+// 检测策略：源码文本扫描，找 loading / error / empty 三个关键词至少各出现一次（在条件分支中）
+// 适用：src/blocks/**/*.js
+export default {
+  meta: {
+    type: 'problem',
+    docs: { description: 'Block 必须实现 loading/error/empty 三态分支' },
+    schema: [],
+    messages: {
+      missing: "Block '{{name}}' missing state '{{state}}'; must implement loading/error/empty branches in render",
+    },
+  },
+  create(context) {
+    const filename = context.filename || context.getFilename();
+    if (!/src[\\/]blocks[\\/].*\.js$/.test(filename)) return {};
+
+    const REQUIRED = ['loading', 'error', 'empty'];
+    const found = new Set();
+    let className = 'unknown';
+
+    return {
+      ClassDeclaration(node) {
+        if (node.id?.name) className = node.id.name;
+      },
+      // 检测 this.loading / this._error / this._data?.length（empty 分支）
+      // 检测 if (this.loading) / if (this._error) / if (!this._data?.length)
+      MemberExpression(node) {
+        const propName = node.property?.name;
+        if (propName === 'loading') found.add('loading');
+        if (propName === '_error' || propName === 'error') found.add('error');
+      },
+      // 检测字符串中的 loading/error/empty（模板、注释、class 名）
+      Literal(node) {
+        if (typeof node.value === 'string' && /(loading|error|empty)/.test(node.value)) {
+          for (const s of REQUIRED) {
+            if (node.value.includes(s)) found.add(s);
+          }
+        }
+      },
+      TemplateElement(node) {
+        const raw = node.value?.raw || '';
+        for (const s of REQUIRED) {
+          if (raw.includes(s)) found.add(s);
+        }
+      },
+      Identifier(node) {
+        // _renderLoading / _renderError / _renderEmpty 方法名
+        const name = node.name || '';
+        if (/loading/i.test(name)) found.add('loading');
+        if (/error/i.test(name)) found.add('error');
+        if (/empty/i.test(name)) found.add('empty');
+      },
+      'Program:exit'() {
+        for (const s of REQUIRED) {
+          if (!found.has(s)) {
+            context.report({ loc: { line: 1, column: 0 }, messageId: 'missing', data: { name: className, state: s } });
+          }
+        }
+      },
+    };
+  },
+};

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

@@ -1,83 +1,83 @@
-// L3.5 af-mobile/wc-block-variant-enum（warn）
-// 检测：Block 类的 variant 属性必须在 defineProp 时声明枚举值，或在 onAttributeChange 中校验
-// 策略：检测 defineProp(proto, 'variant', { ... }) 调用，检查是否有 enum / values / 一行注释枚举
-// 或：onAttributeChange 内有 variant 的 if/switch 校验
-// 适用：src/blocks/**/*.js
-export default {
-  meta: {
-    type: 'suggestion',
-    docs: { description: 'variant 属性必须限制枚举值' },
-    schema: [],
-    messages: {
-      noEnum: "Block variant property has no enum constraint; declare allowed values via comment or validate in onAttributeChange",
-    },
-  },
-  create(context) {
-    const filename = context.filename || context.getFilename();
-    if (!/src[\\/]blocks[\\/].*\.js$/.test(filename)) return {};
-
-    const sourceCode = context.sourceCode || context.getSourceCode();
-    const source = sourceCode.getText();
-    let hasVariantProp = false;
-    let variantEnumDeclared = false;
-
-    return {
-      CallExpression(node) {
-        const callee = node.callee;
-        if (callee.type !== 'MemberExpression' || callee.property?.name !== 'defineProp') return;
-        const arg = node.arguments[1];
-        if (arg?.type !== 'Literal' || arg.value !== 'variant') return;
-        hasVariantProp = true;
-
-        // 检查 defineProp 第三参数是否有 enum/values 字段
-        const optsArg = node.arguments[2];
-        if (optsArg?.type === 'ObjectExpression') {
-          for (const prop of optsArg.properties) {
-            if (prop.type === 'Property' && (prop.key?.name === 'enum' || prop.key?.name === 'values')) {
-              variantEnumDeclared = true;
-              return;
-            }
-          }
-        }
-        // 检查上方注释是否含枚举值（// variant: phone-code / password / sms）
-        const line = node.loc.start.line;
-        const commentLines = [];
-        for (let i = line - 1; i >= 1; i--) {
-          const l = sourceCode.lines[i - 1];
-          if (l.trim() === '') break;
-          if (/\bvariant\b.*\//.test(l) || /variant\s*:/i.test(l)) {
-            commentLines.push(l);
-            break;
-          }
-          if (l.trim().startsWith('//')) { commentLines.push(l); break; }
-          break;
-        }
-        if (commentLines.some(l => /variant\s*:?\s*[a-z-]+(\s*\/\s*[a-z-]+)+/i.test(l))) {
-          variantEnumDeclared = true;
-        }
-      },
-      // 检测 onAttributeChange 内是否校验 variant
-      MethodDefinition(node) {
-        if (node.key?.name !== 'onAttributeChange') return;
-        const bodyText = sourceCode.getText(node.value);
-        if (/variant/.test(bodyText) && /(if|switch)/.test(bodyText)) {
-          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' });
-        }
-      },
-    };
-  },
-};
+// L3.5 af-mobile/wc-block-variant-enum（warn）
+// 检测：Block 类的 variant 属性必须在 defineProp 时声明枚举值，或在 onAttributeChange 中校验
+// 策略：检测 defineProp(proto, 'variant', { ... }) 调用，检查是否有 enum / values / 一行注释枚举
+// 或：onAttributeChange 内有 variant 的 if/switch 校验
+// 适用：src/blocks/**/*.js
+export default {
+  meta: {
+    type: 'suggestion',
+    docs: { description: 'variant 属性必须限制枚举值' },
+    schema: [],
+    messages: {
+      noEnum: "Block variant property has no enum constraint; declare allowed values via comment or validate in onAttributeChange",
+    },
+  },
+  create(context) {
+    const filename = context.filename || context.getFilename();
+    if (!/src[\\/]blocks[\\/].*\.js$/.test(filename)) return {};
+
+    const sourceCode = context.sourceCode || context.getSourceCode();
+    const source = sourceCode.getText();
+    let hasVariantProp = false;
+    let variantEnumDeclared = false;
+
+    return {
+      CallExpression(node) {
+        const callee = node.callee;
+        if (callee.type !== 'MemberExpression' || callee.property?.name !== 'defineProp') return;
+        const arg = node.arguments[1];
+        if (arg?.type !== 'Literal' || arg.value !== 'variant') return;
+        hasVariantProp = true;
+
+        // 检查 defineProp 第三参数是否有 enum/values 字段
+        const optsArg = node.arguments[2];
+        if (optsArg?.type === 'ObjectExpression') {
+          for (const prop of optsArg.properties) {
+            if (prop.type === 'Property' && (prop.key?.name === 'enum' || prop.key?.name === 'values')) {
+              variantEnumDeclared = true;
+              return;
+            }
+          }
+        }
+        // 检查上方注释是否含枚举值（// variant: phone-code / password / sms）
+        const line = node.loc.start.line;
+        const commentLines = [];
+        for (let i = line - 1; i >= 1; i--) {
+          const l = sourceCode.lines[i - 1];
+          if (l.trim() === '') break;
+          if (/\bvariant\b.*\//.test(l) || /variant\s*:/i.test(l)) {
+            commentLines.push(l);
+            break;
+          }
+          if (l.trim().startsWith('//')) { commentLines.push(l); break; }
+          break;
+        }
+        if (commentLines.some(l => /variant\s*:?\s*[a-z-]+(\s*\/\s*[a-z-]+)+/i.test(l))) {
+          variantEnumDeclared = true;
+        }
+      },
+      // 检测 onAttributeChange 内是否校验 variant
+      MethodDefinition(node) {
+        if (node.key?.name !== 'onAttributeChange') return;
+        const bodyText = sourceCode.getText(node.value);
+        if (/variant/.test(bodyText) && /(if|switch)/.test(bodyText)) {
+          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' });
+        }
+      },
+    };
+  },
+};