#!/usr/bin/env node // 视觉语法闸:把「对标实测出来的语法」钉成机器判据。 // // 为什么要有它(实测,非口味): // Bain & Company(archive 快照 2026-08-31,1600×846)与 Porsche Consulting(live 国际站) // 两家 getComputedStyle 抽样结果是同一条:**全站 border-radius 为 0**,且面/字色近乎单色 // (Bain 字色仅 #000/#FFF/#CC0000/#767676;Porsche 仅 #000/#FFF/#B6B5BA,面色 #FFF/#000/#D6001D/#F2F2F2)。 // 本仓此前是 --radius-xs..3xl = 3..32px + 三枚彩色阴影(--shadow-brand/-brand-hover/-glow) // + .bain-card 的 translateY(-4px) hover 抬升 —— 即「软边 + 彩晕 + 抬升」三件全是对标没有的。 // 2026-06-29 的 ADR-0004 把「关键数字超大字号 + 品牌色」当成 Bain 心法,实测 Bain 的成果数字是 // 40px / 字重 500 / 纯黑,故该判据已被证伪;语法层由本闸接管。 // // 判据设计上的两条自律: // 1) --radius-full 必须**保持** 9999px。rounded-full 在本仓承载真圆(avatar/switch/slider/ // radio-group/progress/scroll-area/skeleton),把它一并归零会方角化所有旋钮与头像 —— // 这是「语法收口」最容易犯的自伤,所以单独一条正向守卫。 // 2) 每条规则都报分母。**分母为 0 = 判据没有目标 = 未能度量(exit 2),不算通过。** // // 退出码分档(避免「闸自身崩溃」与「判红」共用 exit 1,那会吞掉同批已算好的打印): // 0 成立 / 1 预期红(真违规)/ 2 未能度量(文件缺失、解析目标为 0) import { readFileSync, existsSync, readdirSync } from "node:fs"; import path from "node:path"; import { fileURLToPath } from "node:url"; const ROOT = path.join(path.dirname(fileURLToPath(import.meta.url)), ".."); const CSS = path.join(ROOT, "src/app/globals.css"); // R4 管的「编辑类 CTA 表面」。button.tsx **不在**这里 —— 它的 icon 档与涟漪点是功能性的圆, // 由 R9 双向管(文字档必须直角、icon 档必须保持圆)。 const CTA_SURFACES = [ "src/components/ui/cta-button.tsx", "src/components/ui/badge.tsx", ]; const BUTTON_FILE = "src/components/ui/button.tsx"; // ---- 源码遍历(只用 node 内置,避开第三方)---- function walk(dir, out = []) { let ents; try { ents = readdirSync(dir, { withFileTypes: true }); } catch { return out; } for (const e of ents) { if (e.name === "node_modules" || e.name === ".git" || e.name === "dist") continue; const p = path.join(dir, e.name); if (e.isDirectory()) walk(p, out); else if (/\.(tsx?|css)$/.test(e.name)) out.push(p); } return out; } // ---- 剥注释 ---- // 必要性(本轮真实踩到):不剥的话,解释「为什么退出 rounded-full」的文档注释本身会被判红, // 于是只剩两条出路 —— 要么改措辞去绕闸(应试,闸就此失去解释力),要么把闸调瞎。 // 正确做法是让闸只看代码。CSS 与 TS/TSX 各自的注释语法分别处理。 function stripComments(src, { line = false } = {}) { // 块注释:整段替换成**等量换行**,否则后面的行号会集体上移, // 闸报出来的 L### 就指不到真正的那一行(判据不可行动 = 半个假绿)。 let out = src.replace(/\/\*[\s\S]*?\*\//g, (m) => "\n".repeat((m.match(/\n/g) || []).length)); if (line) out = out.replace(/(^|[^:'"`\\])\/\/[^\n]*/g, "$1"); return out; } // ---- 解析 :root 里的 --radius-*(按 selector 块配对,同 check-token-twins 的教训: // 跨块配对会把明暗两套主题误当成一对)---- function parseRadii(text) { const lines = text.split("\n"); const blocks = []; let cur = null; for (let i = 0; i < lines.length; i++) { const st = lines[i].trim(); if (st.endsWith("{") && !st.startsWith("@")) { cur = {}; blocks.push(cur); continue; } if (st === "}") { cur = null; continue; } if (!cur) continue; const m = /^\s*(--radius-[a-z0-9]+)\s*:\s*([-\d.]+)(px|rem|em|%)?\s*;/.exec(lines[i]); if (m) cur[m[1]] = { raw: `${m[2]}${m[3] || "px"}`, value: Number.parseFloat(m[2]), unit: m[3] || "px", line: i + 1 }; } // :root 取第一个块(globals.css 的 :root 在最前) const rootBlock = blocks.find((b) => Object.keys(b).some((k) => k.startsWith("--radius-"))) || {}; return { blocks: blocks.length, radii: rootBlock }; } // ---- 规则实现 ---- const results = []; function rule({ id, name, denominator, red, note }) { results.push({ id, name, denominator, red, note }); } function checkGrammar(rawText, rawFiles) { // 闸只看代码:统一先剥注释,再交给各条规则 const text = stripComments(rawText); const files = new Map([...rawFiles].map(([k, v]) => [k, stripComments(v, { line: true })])); const { radii } = parseRadii(text); const names = Object.keys(radii); // R1 radius 记档:除 full / cta 外,一律 0–4px const register = names.filter((n) => n !== "--radius-full" && n !== "--radius-cta"); const r1Red = []; for (const n of register) { const v = radii[n]; // rem/em/% 一律视为未收口(本仓 html{font-size} 随断点变 16/17/18,rem 圆角等于不可预测) if (v.unit !== "px") r1Red.push(`${n} = ${v.raw} (L${v.line}) 非 px —— rem 圆角随断点漂移`); else if (v.value > 4) r1Red.push(`${n} = ${v.raw} (L${v.line}) > 4px,超出 0–4 记档`); } rule({ id: "R1", name: "radius 记档 0–4px", denominator: register.length, red: r1Red }); // R2 --radius-full 必须活着且仍是真圆(正向守卫,防「一并归零」的自伤) const full = radii["--radius-full"]; const r2Red = []; if (!full) r2Red.push("--radius-full 不存在 —— 会方角化 avatar/switch/slider/radio/progress/scroll-area/skeleton"); else if (full.value < 9999) r2Red.push(`--radius-full = ${full.raw} < 9999px —— 真圆承载被破坏`); rule({ id: "R2", name: "--radius-full 仍为真圆(负对照维度)", denominator: 1, red: r2Red }); // R3 --radius-cta 必须存在且为 0 const cta = radii["--radius-cta"]; const r3Red = []; if (!cta) r3Red.push("--radius-cta 不存在 —— 两轨 CTA 无专用直角档"); else if (cta.value !== 0) r3Red.push(`--radius-cta = ${cta.raw} ≠ 0px —— CTA 未直角化`); rule({ id: "R3", name: "--radius-cta 存在且为 0", denominator: 1, red: r3Red }); // R4 编辑类 CTA 表面不得再用 rounded-full(胶囊是本轮要退出的语法) // 注意范围**只含** cta-button 与 badge:button.tsx 的 icon 档与涟漪点是「功能性的圆」, // 由 R9 单独管,硬塞进 R4 会逼着把圆形控件也方角化(那正是 R2 要防的自伤)。 const r4Red = []; let r4Den = 0; for (const rel of CTA_SURFACES) { const f = files.get(rel); if (f === undefined) { r4Red.push(`${rel} 读不到 —— 判据失去目标`); continue; } const hits = (f.match(/rounded-full/g) || []).length; r4Den += 1; if (hits > 0) r4Red.push(`${rel} 有 ${hits} 处 rounded-full(应走 rounded-cta)`); } rule({ id: "R4", name: "CTA/badge 表面零 rounded-full", denominator: r4Den, red: r4Red }); // R5 彩色阴影:令牌不得仍在 :root 里定义(对标两家的面全是无彩阴影或无阴影) const colorShadowTokens = ["--shadow-brand", "--shadow-brand-hover", "--shadow-glow"] .filter((t) => new RegExp(`^\\s*${t}\\s*:`, "m").test(text)); const r5Red = colorShadowTokens.map((t) => `${t} 仍定义于 globals.css —— 彩色阴影是对标没有的语法`); rule({ id: "R5", name: "彩色阴影令牌已退役", denominator: 3, red: r5Red }); // R6 .bain-card:hover 不得有位移抬升(两家 hover 只改 hairline→rule,不 lift) const cardHover = /\.bain-card:hover\s*\{([^}]*)\}/s.exec(text); const r6Den = cardHover ? 1 : 0; const r6Red = []; if (!cardHover) r6Red.push("找不到 .bain-card:hover 块 —— 无法判定 lift 是否已去"); else if (/translate[3d]?Y|transform\s*:/.test(cardHover[1])) r6Red.push(".bain-card:hover 仍有 transform/translateY 抬升"); rule({ id: "R6", name: ".bain-card hover 无位移抬升", denominator: r6Den, red: r6Red }); // R7 弱口径防护:彩色阴影即使令牌删了,工具类引用也不能残留在业务代码 const r7Red = []; let r7Den = 0; for (const [rel, f] of files) { if (rel === "src/app/globals.css") continue; const hits = (f.match(/\bshadow-(brand-hover|brand|glow)\b/g) || []).length; if (hits > 0) { r7Den += 1; r7Red.push(`${rel} 仍消费彩色阴影 ${hits} 处`); } } rule({ id: "R7", name: "业务代码零彩色阴影消费", denominator: r7Den, red: r7Red, note: "分母为「仍在消费的文件数」,0 = 已清零(成立),非「未度量」" }); // R8 组件级圆角令牌必须落进记档 —— R4 只扫工具类,会漏掉 --badge-radius: var(--radius-full) // 这类「走令牌而不是走 class」的路径(本轮实测确实漏了 badge,故补此条)。 // 例外:--avatar-radius 承载真圆,必须指向 --radius-full。 const CIRCLE_TOKENS = new Set(["--avatar-radius"]); const compTokens = [...text.matchAll(/^\s*(--[a-z0-9-]*(?:radius)[a-z0-9-]*)\s*:\s*([^;]+);/gm)] .map((m) => ({ name: m[1], value: m[2].trim() })) .filter((t) => t.name !== "--radius-xs" && !/^--radius-/.test(t.name)); const r8Red = []; for (const t of compTokens) { const ref = /var\(\s*(--radius-[a-z0-9]+)\s*\)/.exec(t.value); const lit = /^[-\d.]+(px|rem|em|%)?$/.test(t.value) ? t.value : null; if (ref) { const target = ref[1]; if (CIRCLE_TOKENS.has(t.name)) { if (target !== "--radius-full") r8Red.push(`${t.name} = var(${target}) —— 真圆承载被改走,应指回 --radius-full`); } else if (target === "--radius-full") { r8Red.push(`${t.name} = var(--radius-full) —— 胶囊语法未退出,应指 var(--radius-cta)`); } } else if (lit && /px$/.test(lit) && Number.parseFloat(lit) > 4 && !CIRCLE_TOKENS.has(t.name)) { r8Red.push(`${t.name} = ${lit} > 4px,超出记档`); } else if (!ref && !lit) { r8Red.push(`${t.name} = "${t.value}" —— 既非记档字面量也非 var() 引用,无法判定`); } } rule({ id: "R8", name: "组件级圆角令牌落进记档(补 R4 的令牌路径盲区)", denominator: compTokens.length, red: r8Red }); // R9 button.tsx 尺寸档:文字按钮走 rounded-cta,icon 档**必须**保持 rounded-full。 // 这一条同时是正例与反例:文字档出现胶囊 ⇒ 判红;icon 档被一起归零 ⇒ 也判红 // (圆形图标钮是功能形状,与 avatar/开关钮同类,不该被"语法收口"顺手带走)。 const btn = files.get(BUTTON_FILE); const r9Red = []; let r9Den = 0; if (btn === undefined) { r9Red.push(`${BUTTON_FILE} 读不到 —— 判据失去目标`); } else { const sizeBlock = /size:\s*\{([\s\S]*?)\n\s*\},/.exec(btn); if (!sizeBlock) { r9Red.push("找不到 button.tsx 的 size 变体块 —— 无法判定,不算通过"); } else { const body = sizeBlock[1]; for (const key of ["sm", "default", "lg", "xl"]) { const m = new RegExp(`^\\s*${key}:\\s*'([^']*)'`, "m").exec(body); if (!m) { r9Red.push(`size.${key} 未找到 —— 判据失去目标`); continue; } r9Den += 1; if (/rounded-full/.test(m[1])) r9Red.push(`size.${key} 仍是 rounded-full(应走 rounded-cta):${m[1]}`); else if (!/rounded-cta/.test(m[1])) r9Red.push(`size.${key} 未声明 rounded-cta:${m[1]}`); } const icon = /^\s*icon:\s*'([^']*)'/m.exec(body); if (!icon) r9Red.push("size.icon 未找到 —— 无法确认圆形控件未被方角化"); else { r9Den += 1; if (!/rounded-full/.test(icon[1])) r9Red.push(`size.icon 丢了 rounded-full —— 圆形图标钮被方角化(功能形状,非装饰圆角):${icon[1]}`); } } } rule({ id: "R9", name: "按钮尺寸档直角、icon 档保持圆(双向)", denominator: r9Den, red: r9Red }); return results; } // ---- 自证(负例):喂一批明知违规的样本,不判红就宣布上面全部不作数 ---- function selftest() { const bad = `:root {\n --radius-xs: 3px;\n --radius-sm: 6px;\n --radius-full: 0px;\n --shadow-brand: 0 6px 24px rgba(196,30,58,.22);\n --badge-radius: var(--radius-full);\n}\n.bain-card:hover { transform: translateY(-4px); }\n`; const files = new Map([ ["src/app/globals.css", bad], ["src/components/ui/cta-button.tsx", 'className="rounded-full"'], // R9 双向都要被抓到:文字档仍是胶囊 **且** icon 档被方角化 ["src/components/ui/button.tsx", "shadow-brand\n size: {\n sm: 'h-9 rounded-full px-3',\n default: 'h-11 rounded-full px-5',\n lg: 'h-12 rounded-cta px-6',\n xl: 'h-14 rounded-cta px-8',\n icon: 'h-11 w-11 rounded-cta',\n },"], ["src/components/ui/badge.tsx", 'className="rounded-full"'], ["src/app/(marketing)/x.tsx", 'className="shadow-brand-hover"'], ]); const r = checkGrammar(bad, files); const redIds = r.filter((x) => x.red.length > 0).map((x) => x.id); const expect = ["R1", "R2", "R3", "R4", "R5", "R6", "R7", "R8", "R9"]; const missing = expect.filter((id) => !redIds.includes(id)); console.log("自证(负例必须全部被抓红):"); console.log(` 被抓红 ${redIds.join(",") || "(无)"}`); if (missing.length) { console.log(` ✗ 未被抓到:${missing.join(",")} ⇒ 这些规则没有约束力,上面所有绿灯都不作数`); return 1; } console.log(` ✓ ${expect.length}/${expect.length} 条规则对已知违规均判红`); return 0; } function main() { if (process.argv.includes("--selftest")) process.exit(selftest()); if (!existsSync(CSS)) { console.log(`未能度量:${CSS} 不存在`); process.exit(2); } const text = readFileSync(CSS, "utf8"); const files = new Map(); for (const p of walk(path.join(ROOT, "src"))) files.set(path.relative(ROOT, p), readFileSync(p, "utf8")); const r = checkGrammar(text, files); const unmeasurable = r.filter((x) => x.denominator === 0 && x.id !== "R7"); const red = r.filter((x) => x.red.length > 0); console.log("视觉语法对账(Bain 2026-08-31 快照 + Porsche live 实测语法)"); for (const x of r) console.log(` ${x.red.length ? "✗" : "✓"} ${x.id} ${x.name}|分母 ${x.denominator}|违规 ${x.red.length}${x.note ? `|${x.note}` : ""}`); if (unmeasurable.length) { console.log(`\n未能度量:${unmeasurable.map((x) => x.id).join(",")} 分母为 0 —— 判据没有目标,不算通过`); process.exit(2); } for (const x of red) for (const m of x.red) console.log(" ✗ " + x.id + " " + m); if (red.length) { console.log(`\n不成立:${red.length} 条规则违规`); process.exit(1); } console.log(`\n成立:${r.length}/${r.length} 条语法判据通过`); } main();