@open-dy/vibecoding-cli 0.1.2-beta.1 → 0.1.3-beta.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@open-dy/vibecoding-cli",
-  "version": "0.1.2-beta.1",
+  "version": "0.1.3-beta.0",
   "description": "Command orchestration, validation and packaging for Douyin vibecoding Taro and OpenCard projects.",
   "type": "module",
   "bin": {

package/release-provenance.json

@@ -2,14 +2,14 @@
   "schema": 1,
   "producer": "vibecoding-cli",
   "packageName": "@open-dy/vibecoding-cli",
-  "version": "0.1.2-beta.1",
+  "version": "0.1.3-beta.0",
   "source": {
-    "digest": "sha256-6b812fa08287f7d4a12c2860bde38d250bf1eb5b5e2b7290b8d4e57a609d72d8",
-    "files": 85
+    "digest": "sha256-e2426706a5198bfc5976645370f423b3386a34ee5f9f4576ee1b9cdeb2c66d2e",
+    "files": 83
   },
-  "payload": "sha256-1c97a68ebc392239626d9c9e75cdf3b416ed3b4bcd2596a3ffe471d8a6fa5c05",
+  "payload": "sha256-a5ecb30328c97db117197412eb22f8a65b7f77e958d78d7dfad60238b47c9b00",
   "toolchain": {
-    "node": "v22.18.0",
+    "node": "v22.23.1",
     "packageManager": null
   }
 }

package/src/adapters/interest-card/opencard/lint-lynx-css.mjs

@@ -13,6 +13,8 @@ import {
   lintAtRule,
   lintDeclaration,
   lintSelector,
+  normalizeValue,
+  toKebab,
 } from './lynx-css-rules.mjs';
 
 const __dirname = path.join(process.env.VIBECODING_OPENCARD_ROOT || process.cwd(), 'scripts');
@@ -417,6 +419,32 @@ function collectTextClassesRegex(source) {
   return classes;
 }
 
+function collectTextParentClassesRegex(source) {
+  const classes = new Set();
+  const stack = [];
+  const tagPattern = /<(\/?)([A-Za-z][\w.]*)\b([^<>]*?)(\/?)>/g;
+  for (const match of source.matchAll(tagPattern)) {
+    const [, closing, tagName, attributes, selfClosing] = match;
+    if (closing) {
+      const index = stack.findLastIndex((entry) => entry.tagName === tagName);
+      if (index >= 0) stack.splice(index);
+      continue;
+    }
+    if (tagName === 'Text') {
+      for (const ancestor of stack) {
+        for (const className of ancestor.classes) classes.add(className);
+      }
+    }
+    if (!selfClosing) {
+      const tagClasses = new Set();
+      const className = /className\s*=\s*(?:\{\s*)?(["'`])([^"'`]+)\1/.exec(match[0]);
+      if (className) addClassTokens(tagClasses, className[2].replace(/\$\{[^}]*\}/g, ' '));
+      stack.push({ tagName, classes: tagClasses });
+    }
+  }
+  return classes;
+}
+
 export function collectTextClassesFromTsx(source) {
   const babel = loadBabel();
   if (!babel) return collectTextClassesRegex(source);
@@ -445,6 +473,39 @@ export function collectTextClassesFromTsx(source) {
   return classes;
 }
 
+export function collectTextParentClassesFromTsx(source) {
+  const babel = loadBabel();
+  if (!babel) return collectTextParentClassesRegex(source);
+  let ast;
+  try {
+    ast = babel.parser.parse(source, {
+      sourceType: 'module',
+      plugins: ['jsx', 'typescript'],
+    });
+  } catch {
+    return collectTextParentClassesRegex(source);
+  }
+  const classes = new Set();
+  babel.traverse(ast, {
+    JSXOpeningElement(pathNode) {
+      const name = pathNode.node.name;
+      if (name.type !== 'JSXIdentifier' || name.name !== 'Text') return;
+      let ancestor = pathNode.parentPath?.parentPath;
+      while (ancestor) {
+        if (ancestor.isJSXElement?.()) {
+          const openingElement = ancestor.node.openingElement;
+          for (const attr of openingElement.attributes) {
+            if (attr.type !== 'JSXAttribute' || attr.name?.name !== 'className') continue;
+            for (const chunk of collectStaticStrings(attr.value)) addClassTokens(classes, chunk);
+          }
+        }
+        ancestor = ancestor.parentPath;
+      }
+    },
+  });
+  return classes;
+}
+
 function listFiles(dir, test, acc = []) {
   if (!fs.existsSync(dir)) return acc;
   for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
@@ -455,8 +516,73 @@ function listFiles(dir, test, acc = []) {
   return acc;
 }
 
-function rel(file) {
-  return path.relative(ROOT, file).replace(/\\/g, '/');
+function cssImportsFromSource(source, importer) {
+  const imports = new Set();
+  const patterns = [
+    /\bimport\s+(?:[^'"]+\s+from\s+)?["']([^"']+\.css)["']/g,
+    /\brequire\(\s*["']([^"']+\.css)["']\s*\)/g,
+    /@import\s+(?:url\(\s*)?["']([^"']+\.css)["']\s*\)?\s*;/g,
+  ];
+  for (const pattern of patterns) {
+    for (const match of source.matchAll(pattern)) {
+      imports.add(path.resolve(path.dirname(importer), match[1]));
+    }
+  }
+  return imports;
+}
+
+function addClasses(target, source) {
+  for (const className of source) target.add(className);
+}
+
+function classUsageByCss(tsxFiles, cssFiles) {
+  const usage = new Map(
+    cssFiles.map((file) => [
+      file,
+      { textClasses: new Set(), textParentClasses: new Set() },
+    ]),
+  );
+  const allTextClasses = new Set();
+  const allTextParentClasses = new Set();
+  for (const file of tsxFiles) {
+    const source = fs.readFileSync(file, 'utf8');
+    const textClasses = collectTextClassesFromTsx(source);
+    const textParentClasses = collectTextParentClassesFromTsx(source);
+    addClasses(allTextClasses, textClasses);
+    addClasses(allTextParentClasses, textParentClasses);
+    for (const cssFile of cssImportsFromSource(source, file)) {
+      const entry = usage.get(cssFile);
+      if (!entry) continue;
+      addClasses(entry.textClasses, textClasses);
+      addClasses(entry.textParentClasses, textParentClasses);
+    }
+  }
+
+  for (const file of cssFiles) {
+    if (path.basename(file) !== 'app.css') continue;
+    addClasses(usage.get(file).textClasses, allTextClasses);
+    addClasses(usage.get(file).textParentClasses, allTextParentClasses);
+  }
+
+  let changed = true;
+  while (changed) {
+    changed = false;
+    for (const file of cssFiles) {
+      const entry = usage.get(file);
+      if (entry.textClasses.size === 0 && entry.textParentClasses.size === 0) continue;
+      const source = fs.readFileSync(file, 'utf8');
+      for (const importedFile of cssImportsFromSource(source, file)) {
+        const importedEntry = usage.get(importedFile);
+        if (!importedEntry) continue;
+        const before = importedEntry.textClasses.size + importedEntry.textParentClasses.size;
+        addClasses(importedEntry.textClasses, entry.textClasses);
+        addClasses(importedEntry.textParentClasses, entry.textParentClasses);
+        const after = importedEntry.textClasses.size + importedEntry.textParentClasses.size;
+        if (after > before) changed = true;
+      }
+    }
+  }
+  return usage;
 }
 
 function lintTextContainerUsage(rules, textClasses, filename, extraFindings) {
@@ -481,32 +607,70 @@ function lintTextContainerUsage(rules, textClasses, filename, extraFindings) {
   }
 }
 
-export function lintProject(srcDir = SRC) {
+function lintHiddenTextParentUsage(rules, textParentClasses, filename, extraFindings) {
+  if (textParentClasses.size === 0) return;
+  for (const rule of rules) {
+    const subjects = lastCompoundSelector(rule.selector);
+    const hitsTextParent = subjects.some((compound) =>
+      classesInCompound(compound).some((name) => textParentClasses.has(name)),
+    );
+    if (!hitsTextParent) continue;
+    const displayNone = rule.decls.find(
+      (decl) =>
+        toKebab(decl.prop) === 'display' &&
+        normalizeValue(decl.value).toLowerCase() === 'none',
+    );
+    if (!displayNone) continue;
+    const clipsHiddenText = rule.decls.some(
+      (decl) =>
+        toKebab(decl.prop) === 'overflow' &&
+        normalizeValue(decl.value).toLowerCase() === 'hidden',
+    );
+    if (clipsHiddenText) continue;
+    extraFindings.push({
+      id: 'hidden-text-parent-overflow',
+      message:
+        '隐藏包含 Text 的父级时，请在同一个隐藏 selector 中同时写 ' +
+        'display: none 与 overflow: hidden，避免 Lynx 残留文字。',
+      line: displayNone.line,
+      column: displayNone.column,
+      selector: rule.selector,
+      file: filename,
+    });
+  }
+}
+
+export function lintProject(
+  srcDir = SRC,
+  { projectRoot = path.resolve(srcDir, '..') } = {},
+) {
   const cssFiles = listFiles(srcDir, (name) => name.endsWith('.css'));
   const tsxFiles = listFiles(srcDir, (name) => /\.[jt]sx$/.test(name));
-  const textClasses = new Set();
-  for (const file of tsxFiles) {
-    for (const name of collectTextClassesFromTsx(fs.readFileSync(file, 'utf8'))) {
-      textClasses.add(name);
-    }
-  }
+  const usage = classUsageByCss(tsxFiles, cssFiles);
 
   const reports = [];
   const allRules = [];
   for (const file of cssFiles) {
-    const filename = rel(file);
+    const filename = path.relative(projectRoot, file).replace(/\\/g, '/');
     const { findings, rules } = lintCssText(fs.readFileSync(file, 'utf8'), { filename });
     for (const item of findings) reports.push({ ...item, file: filename });
     for (const rule of rules) allRules.push({ ...rule, file: filename });
   }
   for (const file of cssFiles) {
-    const filename = rel(file);
+    const filename = path.relative(projectRoot, file).replace(/\\/g, '/');
     const subset = allRules.filter((rule) => rule.file === filename);
+    const { textClasses, textParentClasses } = usage.get(file);
     lintTextContainerUsage(subset, textClasses, filename, reports);
+    lintHiddenTextParentUsage(subset, textParentClasses, filename, reports);
   }
   return reports;
 }
 
+export function lintOpenCardProject(projectRoot) {
+  const root = path.resolve(projectRoot);
+  return lintProject(path.join(root, 'src'), { projectRoot: root });
+}
+
 function printReports(reports) {
   for (const item of reports) {
     console.error(formatFinding(item.file, item.line, item.column, item.message));
@@ -649,6 +813,84 @@ function assertSelfTest() {
     failures.push({ css: textCss, expected: 'text-container', actual: extra.map((f) => f.id) });
   }
 
+  const ordinaryTextCss = '.label { display: block; } .label.is-hidden { display: none; }';
+  const ordinaryTextRules = lintCssText(ordinaryTextCss, { filename: 'src/pages/x.css' }).rules;
+  const ordinaryTextFindings = [];
+  lintTextContainerUsage(
+    ordinaryTextRules,
+    new Set(['label']),
+    'src/pages/x.css',
+    ordinaryTextFindings,
+  );
+  if (ordinaryTextFindings.length > 0) {
+    failures.push({
+      css: ordinaryTextCss,
+      expected: null,
+      actual: ordinaryTextFindings.map((finding) => finding.id),
+    });
+  }
+
+  const hiddenParentCases = [
+    {
+      css: '.panel { display: none; }',
+      expected: 'hidden-text-parent-overflow',
+    },
+    {
+      css: '.panel { display: none; overflow: hidden; }',
+      expected: null,
+    },
+    {
+      css: '.icon-wrap { display: none; }',
+      expected: null,
+      textParentClasses: new Set(),
+    },
+  ];
+  const hiddenTextParents = collectTextParentClassesFromTsx(
+    '<View className="panel"><Text className="label">文字</Text></View>',
+  );
+  for (const item of hiddenParentCases) {
+    const hiddenRules = lintCssText(item.css, { filename: 'src/pages/x.css' }).rules;
+    const hiddenFindings = [];
+    lintHiddenTextParentUsage(
+      hiddenRules,
+      item.textParentClasses ?? hiddenTextParents,
+      'src/pages/x.css',
+      hiddenFindings,
+    );
+    const hit = hiddenFindings.some((finding) => finding.id === item.expected);
+    const ok = item.expected === null ? hiddenFindings.length === 0 : hit;
+    if (!ok) {
+      failures.push({
+        css: item.css,
+        expected: item.expected,
+        actual: hiddenFindings.map((finding) => finding.id),
+      });
+    }
+  }
+
+  const fixture = fs.mkdtempSync(path.join(process.cwd(), '.lynx-css-test-'));
+  try {
+    fs.writeFileSync(
+      path.join(fixture, 'index.tsx'),
+      'import "./index.css";\n<View className="panel"><Text className="label">文字</Text></View>',
+    );
+    fs.writeFileSync(
+      path.join(fixture, 'index.css'),
+      '.panel { display: none; overflow: hidden; }',
+    );
+    fs.writeFileSync(path.join(fixture, 'unrelated.css'), '.panel { display: none; }');
+    const crossFileReports = lintProject(fixture);
+    if (crossFileReports.length > 0) {
+      failures.push({
+        css: '.panel { display: none; } in unimported CSS',
+        expected: null,
+        actual: crossFileReports.map((finding) => finding.id),
+      });
+    }
+  } finally {
+    fs.rmSync(fixture, { recursive: true, force: true });
+  }
+
   if (failures.length) {
     console.error(`[lynx-css self-test] ${failures.length} failed`);
     for (const fail of failures) {
@@ -657,7 +899,7 @@ function assertSelfTest() {
     }
     process.exit(1);
   }
-  console.log(`[lynx-css self-test] ${cases.length + 1} passed`);
+  console.log(`[lynx-css self-test] ${cases.length + 6} passed`);
 }
 
 export function main() {

package/src/commands/lint.mjs

@@ -2,7 +2,7 @@ import { existsSync, mkdirSync } from 'node:fs'
 import path from 'node:path'
 import { CliError } from '../core/errors.mjs'
 import { resolveProjectBinary, runCaptured, runProcess, runTasks } from '../core/runner.mjs'
-import { lintOpenCardProject } from '../lint/lint-lynx-css.mjs'
+import { lintOpenCardProject } from '../adapters/interest-card/opencard/lint-lynx-css.mjs'
 import { validateNonEmptyTaro } from '../validators/empty-project.mjs'
 import { validateOpenCardStructure } from '../validators/opencard-structure.mjs'
 import { validateSqlQueries } from '../validators/sql.mjs'

package/src/lint/lint-lynx-css.mjs

@@ -1,244 +0,0 @@
-#!/usr/bin/env node
-/**
- * OpenCard Lynx CSS 静态检查：扫 src 下 CSS，并复用同一规则检查 Text class。
- */
-import fs from 'node:fs';
-import path from 'node:path';
-import { pathToFileURL } from 'node:url';
-import {
-  formatFinding,
-  isTextContainerDeclaration,
-  lintAtRule,
-  lintDeclaration,
-  lintSelector,
-} from './lynx-css-rules.mjs';
-
-// Keep string literals intact: comment delimiters inside quoted URLs are data.
-function scanComments(source) {
-  const chars = source.split('');
-  const errors = [];
-  let quote = '';
-  for (let i = 0; i < source.length; i += 1) {
-    if (quote) {
-      if (source[i] === '\\') i += 1;
-      else if (source[i] === quote) quote = '';
-      continue;
-    }
-    if (source[i] === '"' || source[i] === "'") {
-      quote = source[i];
-      continue;
-    }
-    if (source.slice(i, i + 2) === '*/') {
-      errors.push({ index: i, message: '孤立的 CSS 注释结束符 */；检查文件是否缺失开头。' });
-      i += 1;
-    } else if (source.slice(i, i + 2) === '/*') {
-      const end = source.indexOf('*/', i + 2);
-      if (end < 0) errors.push({ index: i, message: 'CSS 注释未闭合，缺少 */。' });
-      const stop = end < 0 ? source.length : end + 2;
-      for (let j = i; j < stop; j += 1) {
-        if (chars[j] !== '\n') chars[j] = ' ';
-      }
-      i = stop - 1;
-    }
-  }
-  return { content: chars.join(''), errors };
-}
-
-export function stripCommentsPreservingLines(source) {
-  return scanComments(source).content;
-}
-
-function lineAt(source, index) {
-  const before = source.slice(0, index);
-  return {
-    line: before.split('\n').length,
-    column: index - before.lastIndexOf('\n'),
-  };
-}
-
-function splitTopLevel(source, delimiter) {
-  const parts = [];
-  let current = '';
-  let depth = 0;
-  let quote = '';
-  for (const char of source) {
-    if (quote) {
-      current += char;
-      if (char === quote) quote = '';
-      continue;
-    }
-    if (char === '"' || char === "'") {
-      quote = char;
-      current += char;
-      continue;
-    }
-    if (char === '(') depth += 1;
-    if (char === ')') depth = Math.max(0, depth - 1);
-    if (char === delimiter && depth === 0) {
-      parts.push(current);
-      current = '';
-      continue;
-    }
-    current += char;
-  }
-  if (current) parts.push(current);
-  return parts;
-}
-
-function walkRules(source, onRule, offset = 0) {
-  let index = 0;
-  while (index < source.length) {
-    const open = source.indexOf('{', index);
-    if (open < 0) break;
-    const selector = source.slice(index, open).trim();
-    let depth = 1;
-    let cursor = open + 1;
-    while (cursor < source.length && depth > 0) {
-      if (source[cursor] === '{') depth += 1;
-      if (source[cursor] === '}') depth -= 1;
-      cursor += 1;
-    }
-    const bodyEnd = depth === 0 ? cursor - 1 : source.length;
-    const body = source.slice(open + 1, bodyEnd);
-    onRule({ selector, body, selectorOffset: offset + index, bodyOffset: offset + open + 1 });
-    index = cursor;
-  }
-}
-
-function listFiles(directory, predicate, files = []) {
-  if (!fs.existsSync(directory)) return files;
-  for (const entry of fs.readdirSync(directory, { withFileTypes: true })) {
-    const target = path.join(directory, entry.name);
-    if (entry.isDirectory()) {
-      listFiles(target, predicate, files);
-    } else if (predicate(target)) {
-      files.push(target);
-    }
-  }
-  return files;
-}
-
-function textClassTokensFromTsx(source) {
-  const names = new Set();
-  for (const match of source.matchAll(/<Text\b[^>]*\bclassName\s*=\s*(?:"([^"]+)"|'([^']+)')/g)) {
-    const value = match[1] ?? match[2] ?? '';
-    for (const className of value.split(/\s+/)) {
-      if (className) names.add(className);
-    }
-  }
-  return names;
-}
-
-export function lintCssText(source, { filename = 'input.css' } = {}) {
-  const { content, errors } = scanComments(source);
-  const findings = errors.map(({ index, message }) => ({
-    file: filename, ...lineAt(source, index), message,
-  }));
-  const textClassRules = new Map();
-
-  walkRules(content, ({ selector, body, selectorOffset, bodyOffset }) => {
-    const selectorLocation = lineAt(content, selectorOffset);
-    if (selector.startsWith('@')) {
-      const name = selector.split(/\s|\{/)[0];
-      for (const item of lintAtRule(name)) {
-        findings.push({ file: filename, ...selectorLocation, message: item.message });
-      }
-      return;
-    }
-
-    const allowRoot = filename.replace(/\\/g, '/').endsWith('/src/app.css') || filename === 'src/app.css';
-    for (const item of lintSelector(selector, { allowRoot })) {
-      findings.push({ file: filename, ...selectorLocation, message: item.message });
-    }
-
-    const classNames = [...selector.matchAll(/\.([A-Za-z0-9_-]+)/g)].map((match) => match[1]);
-    const declarations = [];
-    let consumed = 0;
-    for (const fragment of splitTopLevel(body, ';')) {
-      const colon = fragment.indexOf(':');
-      if (colon < 0) {
-        consumed += fragment.length + 1;
-        continue;
-      }
-      const property = fragment.slice(0, colon).trim();
-      const value = fragment.slice(colon + 1).trim();
-      if (!property || !value) {
-        consumed += fragment.length + 1;
-        continue;
-      }
-      const location = lineAt(content, bodyOffset + consumed);
-      declarations.push({ property, value, location });
-      for (const item of lintDeclaration(property, value)) {
-        findings.push({ file: filename, ...location, message: item.message });
-      }
-      consumed += fragment.length + 1;
-    }
-
-    for (const className of classNames) {
-      textClassRules.set(className, declarations);
-    }
-  });
-
-  return { findings, textClassRules };
-}
-
-export function lintProject(
-  sourceDirectory = path.join(process.cwd(), 'src'),
-  { projectRoot = path.resolve(sourceDirectory, '..') } = {},
-) {
-  const reports = [];
-  const textClasses = new Set();
-  const cssFiles = listFiles(sourceDirectory, (file) => file.endsWith('.css'));
-  const tsxFiles = listFiles(sourceDirectory, (file) => /\.(?:tsx|jsx)$/.test(file));
-  const ruleMap = new Map();
-
-  for (const file of tsxFiles) {
-    for (const className of textClassTokensFromTsx(fs.readFileSync(file, 'utf8'))) {
-      textClasses.add(className);
-    }
-  }
-
-  for (const file of cssFiles) {
-    const relative = path.relative(projectRoot, file).replace(/\\/g, '/');
-    const result = lintCssText(fs.readFileSync(file, 'utf8'), { filename: relative });
-    reports.push(...result.findings);
-    for (const [className, declarations] of result.textClassRules) {
-      ruleMap.set(className, { declarations, filename: relative });
-    }
-  }
-
-  for (const [className, rule] of ruleMap) {
-    if (!textClasses.has(className)) continue;
-    for (const declaration of rule.declarations) {
-      if (!isTextContainerDeclaration(declaration.property)) continue;
-      reports.push({
-        file: rule.filename,
-        ...declaration.location,
-        message: `Text 不是 Flex/Grid 容器，不要写 ${declaration.property}: ${declaration.value}。多个节点的排列由外层 View 承担。`,
-      });
-    }
-  }
-
-  return reports;
-}
-
-export function lintOpenCardProject(projectRoot) {
-  const root = path.resolve(projectRoot);
-  return lintProject(path.join(root, 'src'), { projectRoot: root });
-}
-
-function main() {
-  const reports = lintOpenCardProject(process.cwd());
-  if (reports.length === 0) return;
-  console.error(`ERROR: OpenCard Lynx CSS 检查失败（${reports.length}）`);
-  for (const report of reports) {
-    console.error(formatFinding(report.file, report.line, report.column, report.message));
-  }
-  process.exit(1);
-}
-
-const invoked =
-  process.argv[1] &&
-  import.meta.url === pathToFileURL(path.resolve(process.argv[1])).href;
-
-if (invoked) main();

package/src/lint/lynx-css-rules.mjs

@@ -1,138 +0,0 @@
-/**
- * OpenCard Lynx CSS 机械检查规则。
- *
- * CLI 自己执行 OpenCard lint，因此这里不依赖 SDK；SDK 暴露给项目 ESLint 配置的
- * 规则仍独立维护在 SDK 内。
- */
-
-export const HINT = '见 references/opencard/rendering.md';
-
-const FORBIDDEN_AT_RULES = new Set(['media', 'supports', 'layer', 'namespace']);
-
-const FORBIDDEN_PROPERTIES = new Map([
-  ['float', '不要用 float。改用 Flex / Grid。'],
-  ['clear', '不要用 clear。改用 Flex / Grid。'],
-  ['pointer-events', 'Lynx 不支持 pointer-events。用条件渲染或事件层级。'],
-  ['cursor', 'Lynx 不支持 cursor。不要生成。'],
-  ['resize', 'Lynx 不支持 resize。用组件状态或 JS 调尺寸。'],
-  ['scroll-behavior', 'Lynx 不支持 scroll-behavior。不要生成。'],
-  ['overscroll-behavior', '不要用 overscroll-behavior 承接滚动。'],
-  ['content', '不能用伪元素生成内容。增加真实 Taro 节点。'],
-  ['list-style', '列表 marker 不可用。用真实节点表达。'],
-  ['list-style-type', '列表 marker 不可用。用真实节点表达。'],
-  ['word-break', 'Lynx 不支持 word-break。控制文本节点宽度。'],
-  ['overflow-wrap', 'Lynx 不支持 overflow-wrap。控制文本节点宽度。'],
-  ['word-wrap', 'Lynx 不支持 word-wrap。控制文本节点宽度。'],
-  ['-webkit-line-clamp', '不要迁移 -webkit-line-clamp。收敛内容或使用单行省略。'],
-  ['-webkit-box-orient', '不要迁移 -webkit-box。'],
-]);
-
-const TEXT_CONTAINER_PROPS = new Set([
-  'flex-direction',
-  'flex-wrap',
-  'flex-flow',
-  'justify-content',
-  'align-items',
-  'align-content',
-  'gap',
-  'row-gap',
-  'column-gap',
-]);
-
-export function toKebab(value) {
-  return String(value ?? '')
-    .trim()
-    .replace(/[A-Z]/g, (char) => `-${char.toLowerCase()}`)
-    .toLowerCase();
-}
-
-export function formatFinding(file, line, column, message) {
-  return `${file}:${line}:${column} ${message}`;
-}
-
-function issue(message) {
-  return { message: `${message} ${HINT}` };
-}
-
-export function lintAtRule(name) {
-  const normalized = String(name ?? '').trim().replace(/^@/, '').toLowerCase();
-  if (!FORBIDDEN_AT_RULES.has(normalized)) {
-    return [];
-  }
-  if (normalized === 'media') {
-    return [issue('Lynx 的 @media 不生效。容器用 flex、vw/vh 适配。')];
-  }
-  return [issue(`Lynx 不支持 @${normalized}。使用常规 CSS 或运行时 class。`)];
-}
-
-export function lintSelector(selector, { allowRoot = false } = {}) {
-  const normalized = String(selector ?? '');
-  const findings = [];
-  if (/::(?:before|after|first-line|first-letter|marker|backdrop)\b/i.test(normalized)) {
-    findings.push(issue('不要使用 CSS 伪元素。需要内容时增加真实节点。'));
-  }
-  if (/:?(?:first-child|last-child|only-child|nth-child|nth-of-type|has)\b/i.test(normalized)) {
-    findings.push(issue('不要依赖结构伪类。为对应节点添加显式 class。'));
-  }
-  if (!allowRoot && /(?:^|[^A-Za-z0-9_-]):root(?![A-Za-z0-9_-])/i.test(normalized)) {
-    findings.push(issue(':root 只允许出现在 src/app.css。页面和组件变量写在局部 class。'));
-  }
-  return findings;
-}
-
-export function isTextContainerDeclaration(prop) {
-  return TEXT_CONTAINER_PROPS.has(toKebab(prop));
-}
-
-export function lintDeclaration(prop, rawValue) {
-  const property = toKebab(prop);
-  const value = String(rawValue ?? '').trim();
-  const normalized = value.toLowerCase();
-  const findings = [];
-
-  if (property.startsWith('--')) {
-    return findings;
-  }
-
-  const propertyMessage = FORBIDDEN_PROPERTIES.get(property);
-  if (propertyMessage) {
-    findings.push(issue(propertyMessage));
-  }
-
-  if (property.startsWith('scroll-snap-')) {
-    findings.push(issue('Lynx 不支持 scroll-snap。横向轮播使用 Swiper。'));
-  }
-
-  if (property === 'display' && /(?:^|\s)(?:inline|inline-block|table|contents|list-item)(?:\s|$)/i.test(normalized)) {
-    findings.push(issue('不要依赖 inline、table、contents 或 list-item 布局。使用 Flex / Grid。'));
-  }
-
-  if (property === 'position' && /^(?:static|sticky)$/i.test(normalized)) {
-    findings.push(issue(`不要使用 position: ${normalized}。改用普通布局或 fixed / absolute。`));
-  }
-
-  if (
-    (property === 'overflow' || property === 'overflow-y') &&
-    /(?:^|\s)(?:auto|scroll)(?:\s|$)/i.test(normalized)
-  ) {
-    findings.push(issue('固定 widget 不允许纵向滚动。减项、摘要化或切换局部状态。'));
-  }
-
-  if (property === 'white-space' && /(?:pre|pre-wrap|pre-line|break-spaces)/i.test(normalized)) {
-    findings.push(issue('不要使用预格式 white-space。收敛文案并控制节点尺寸。'));
-  }
-
-  if (property === 'flex' && /^\s*\d+(?:\.\d+)?\s*$/i.test(normalized)) {
-    findings.push(issue('不要写 flex: 1。使用完整三值 flex: 1 1 0，并显式设置 min-height / min-width。'));
-  }
-
-  if (/\b(?:min|max|clamp)\s*\(/i.test(value)) {
-    findings.push(issue('Lynx 不支持 min()、max()、clamp()。用 flex、vw/vh 或明确尺寸。'));
-  }
-
-  if (/(?:^|[^\w-])(?:cm|mm|in|pt|pc|ch|ex)(?:$|[^\w-])/i.test(value)) {
-    findings.push(issue('不要使用 cm/mm/in/pt/pc/ch/ex 单位。使用 px、rem、vw 或 vh。'));
-  }
-
-  return findings;
-}