Files
novalon-website/scripts/check-visual-grammar.mjs
T
zhangxiang d622dc2120 refactor(visual): 7 个 coding accent 降为 dataviz-only,营销面消费面收窄并做成能失败的闸
裁定(ADR-0008 决策一 + 决策一修订段):**令牌保留、消费面收窄**,不删。
依据是实测而非口味 —— Bain 全站字色只有 4 个值(#000 #FFF #CC0000 #767676)、面色 3 个;
Porsche 字色 3 个、面色 4 个,红只出现在按钮上;两家**都不用颜色给内容分类**。
而 ADR-0004 决策一当年按「编号为主 + 4px 色条为辅」把 7 枚 accent 放进令牌层,
实测真正跑起来的营销代码只消费了**一个蓝**(`accent-blue`)做装饰性图标砖与状态徽章:
成本是全站语法被稀释,收益是一处蓝。

改动:
- 10 处 `accent-blue*` 换成近单色语法(`bg-bg-tertiary` + `border-border-primary` + `text-text-primary`;
  状态签去彩色底改中性描边),涉及 products-content-v3 / solution-value / solution-service-card。
  可达营销面 accent 残留实测 **0 处**。
- `globals.css` 在 accent 声明处写明「dataviz / 工具 UI 专用」与退役理由。
- **tailwind 僵尸令牌**:`--shadow-brand/-brand-hover/-glow` 早已从 CSS 退役,
  但 `boxShadow` 里三行映射原样留着 ⇒ `shadow-brand` 类照生成、
  展开成 `box-shadow: var(--shadow-brand)` 而该属性无人声明 ⇒ **静默什么都不画**,
  不报错、不算无效。R5(令牌已退役)与 R7(业务代码零消费)当时**都是绿的**,
  因为它们各看一侧,谁都不看 tailwind↔CSS 这条缝(§5.41,与 §5.37 同族)。删映射 + 新增 R11。

新增 `scripts/check-accents.mjs`(`check:accents`):营销面不得出现 `accent-*` 类。
两条防赖设计:① 豁免**按文件名**登记,不写目录通配(通配会让新文件自动继承豁免);
② 名单里的文件命中数变 0 **同样判红**(豁免名单否则必然腐化成"没人记得为什么在这"的永久豁免)。
现读:扫 251 源文件、命中 31 处 / 3 文件,全在豁免内(admin 分类色标 16、
ui/product-card 12、ui/brand-visuals 3 —— 后两枚是不可达库存)。

**自证修好了才算这条成立**(第一版是坏的,绿灯不作数):
`--selftest` 原来把「营销面有违规」和「三条豁免全命中」两个**互斥前提**塞进同一份夹具,
于是 `stale.length === 3` 永不可能成立 ⇒ 豁免腐化那一维**从未被测到**,自证 EXIT=1。
现拆成三个各测一维的情景,并**补一个全绿情景** —— 只喂负例的话,
判据写错成恒红也会"抓到所有负例",同样通过自证。三情景现全 ✓。

R10 hover 抬升棘轮按实测**从 31 下调到 28**(19 文件),只降不升;
下调提示从 print 挪进 note —— `checkGrammar` 现在被自证反复调用,
喂合成样本时打「请把上限下调到 0」是噪声,会把人引去改坏登记值。

R11 负对照**在真树上执行**:把 `boxShadow.brand/'glow'` 两行塞回 tailwind ⇒
EXIT=1、报出 2 条悬空;还原 ⇒ 11/11 成立、引用 144 个变量、悬空 0。
写 R11 时踩了两个仪器坑(都记进 §5.40/§5.41):
豁免名单写在规则里、夹具再手抄一遍 ⇒ 改一处另一处静默失效 ⇒ 提到 module 层共用;
夹具不带那条外部所有者引用 ⇒ 「豁免腐化」先判红,把「已声明不误报」这一维污染成假红,
差点被我读成判据坏 —— **先怀疑夹具,再怀疑判据**。

`check:visual`(自证先跑,自证失败即宣布绿灯作废)并入 `test:all`,另补 `check:dead` 入口。

口径边界(必须读,否则会把它当成"视觉已达标"):本闸**只覆盖 Tailwind 类名通道**。
第二条彩色编码通道是 `hero-themes.ts` 的 `accentColor`,以内联样式进
`detail-hero.tsx:81-86`,11 个主题里 **7 个用非品牌色相**(erp #1e3a5f / crm #1e40af /
bi #0c4a6e / cms #14532d / sds #78350f / oa #4c1d95 / novavis #0f3d3e),
落在产品·方案·服务详情页 hero 徽章上。**本批不收它**:① 属"套其余模板",决策四明确推到验收之后;
② 去掉逐产品色相等于取消产品线视觉身份,是**设计裁定**不是语法收口,不该由闸顺手替决策人拍板。
这句边界已印进闸的成功输出行(措辞与被验那一维一致),并登记为 DEC-N1。

复测(全部重定向到文件后读 `$?`,不用管道):
`check:accents` EXIT=0 · `check:accents:selftest` EXIT=0 · `check:grammar` EXIT=0(11/11)·
`check:grammar:selftest` EXIT=0(R1–R9 全判红 + R10「28 不红 / 29 红」+ R11 双向)·
`check:contrast` 44/44 · `check:headings` 0 · `check:brand-token` 0 · `check:token-twins` 44/44 ·
`type-check` EXIT=0 · `lint` EXIT=0(0 error / 81 warning)· `test:unit` 141 套件 / 1747 例 ·
`npm run build` EXIT=0 · **`npm run test:all` EXIT=0**(八段,含新并入的 check:visual;
e2e:fast 59 passed / 25 skipped,那 16 个 GA4 @critical 仍在 skipped 侧,须 `test:e2e:prod` 才真断言)。

已知未闭:`check:motion` 仍 EXIT=1(**8 处**),经 `git show da9a5cb6:` 自证 1000ms 与 0.6s 两处
都是基线既有红、非本轮引入,登记 DEC-N3。
2026-10-17 01:06:42 +08:00

377 lines
23 KiB
JavaScript
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
#!/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");
const TW_CONFIG = path.join(ROOT, "tailwind.config.js");
// 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";
/**
* R10 hover 抬升的**递减棘轮上限**,登记在 module 层而非 checkGrammar 内部,
* 是为了让自证能引用它构造「+1 必须判红 / 恰好等于必须不判红」两个情景。
* 第一版把 R10 排除在自证外,理由是"喂违规样本会同时改变分母"—— 那句话把
* 「存量棘轮」和「不可自证」混为一谈了:棘轮的分母**就是**被数的东西,
* 多喂一处抬升正是它的违规形态,不是副作用。没有负例的规则等于没有规则。
*
* 现值 28 = 2026-10-17 实测(19 文件)。变多判红,变少提示下调登记值。
*/
const HOVER_LIFT_CEILING = 28;
/**
* R11 的「外部所有者」豁免:由 Radix 等运行时注入、本就不该由 globals.css 声明的变量。
* 放在 module 层而不是规则里,是因为**自证夹具也必须引用同一份名单** ——
* 名单在规则里、夹具里再手抄一遍,改一处另一处就悄悄失效(本轮真实踩到:
* 夹具没带上这条引用,豁免腐化判据把「已声明不误报」那一维污染成了假红)。
*/
const EXTERNAL_OWNED = ["--radix-accordion-content-height"];
// ---- 源码遍历(只用 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 };
}
// ---- 规则实现 ----
// 累加器必须是「每次调用各自一份」。此前 results/rule 挂在 module 层,第二次调
// checkGrammar 会往同一数组追加,而 selftest 里的 .find("R10") 取到的是**第一次**
// 那份读数 —— 于是 R10 的负对照被读成"不判红"。主流程只调一次所以毫无症状,
// 属于「仪器只在被复用时才坏」那一类,也正是自证该抓的东西。
function checkGrammar(rawText, rawFiles, twConfig = "") {
const results = [];
const rule = ({ id, name, denominator, red, note }) => {
results.push({ id, name, denominator, red, note });
};
// 闸只看代码:统一先剥注释,再交给各条规则
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 });
/**
* R10 hover 位移抬升的**递减棘轮**(上限见 module 层 HOVER_LIFT_CEILING 的注释)。
* 实测两家 hover 都不抬升(Bain 卡片靠 hairline、Porsche 靠图与留白),本批已把
* .bain-card 的 translateY(-4px) 去掉;但业务代码里还散落着 28 处 hover:-translate-y
* (19 文件),全改是又一次全站视觉改动,不该塞进 tracer-bullet。
* 所以按"当前实测数"登记上限做递减棘轮:变多判红、变少**不判红但提示下调登记值**
* (改进不该被闸挡住,那是棘轮自堵还债的老坑)。
*/
let liftCount = 0;
const liftFiles = [];
for (const [rel, f] of files) {
const n = (f.match(/hover:-translate-y/g) || []).length;
if (n > 0) { liftCount += n; liftFiles.push(`${rel}=${n}`); }
}
const r10Red = liftCount > HOVER_LIFT_CEILING
? [`hover 抬升 ${liftCount} 处 > 登记上限 ${HOVER_LIFT_CEILING}(对标实测两家 hover 都不抬升)`]
: [];
// 「实测 < 登记」的下调提示只进 note、不 print:checkGrammar 现在被自证反复调用,
// 喂合成样本时打「请把上限下调到 0」是噪声,会把人引去改坏登记值。
rule({ id: "R10", name: `hover 抬升数 ≤ ${HOVER_LIFT_CEILING}(递减棘轮)`, denominator: liftCount, red: r10Red,
note: liftCount < HOVER_LIFT_CEILING
? `实测 ${liftCount} 处 / ${liftFiles.length} 文件 < 登记 ${HOVER_LIFT_CEILING},请把上限下调到 ${liftCount}`
: `实测 ${liftCount} 处 / ${liftFiles.length} 文件` });
/**
* R11 tailwind 映射 → CSS 声明的**悬空守卫**。
* 本轮真实踩到:三枚彩色阴影令牌从 globals.css 退役后,
* `tailwind.config.js` 里的 boxShadow.brand / brand-hover / glow 三行映射**原样留着**,
* 于是 `shadow-brand` 这个类仍在被生成,只是展开成 `box-shadow: var(--shadow-brand)`,
* 而该自定义属性无人声明 ⇒ 运行时取空、静默什么都不画。
* 不报错、不判红、单测全绿 —— 属于「孪生问题」里最难发现的那类:
* **删了值但没删引用**,而闸只盯着值那一侧(R5 令牌退役、R7 业务代码零消费,两条都是绿的)。
*
* 外部所有者的变量(Radix 运行时注入)另列白名单,它们本就不该由 globals.css 声明。
* 白名单同样按名登记并做腐化检测(登记了却没被引用 = 判红),与 check-accents 一个纪律。
*/
const declared = new Set([...text.matchAll(/^\s*(--[\w-]+)\s*:/gm)].map((m) => m[1]));
const twRefs = [...new Set([...stripComments(twConfig, { line: true }).matchAll(/var\(\s*(--[\w-]+)/g)].map((m) => m[1]))];
const r11Red = [];
for (const ref of twRefs) {
if (!declared.has(ref) && !EXTERNAL_OWNED.includes(ref)) {
r11Red.push(`tailwind 映射引用 ${ref},但 globals.css 未声明 —— 该类会静默展开成空值(僵尸令牌)`);
}
}
const deadAllow = EXTERNAL_OWNED.filter((n) => !twRefs.includes(n));
if (deadAllow.length) {
r11Red.push(`外部所有者白名单已腐化:${deadAllow.join(", ")} 已不再被 tailwind 引用,请删掉这条豁免`);
}
rule({ id: "R11", name: "tailwind 映射的 var(--*) 必有 CSS 声明(僵尸令牌守卫)", denominator: twRefs.length, red: r11Red,
note: `引用 ${twRefs.length} 个变量 · 外部所有者豁免 ${EXTERNAL_OWNED.length - deadAllow.length} 条生效` });
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"'],
]);
// 第三参数是 tailwind.config 文本:给一份「引用全部已声明、且带齐外部所有者豁免」的,
// 避免 R11 的红因混进 R1–R9 的读数里(R11 有自己的两侧自证,见下)。
const RADIX_REF = `keyframes: { refs: { ${EXTERNAL_OWNED.map((v) => `x: 'var(${v})'`).join(", ")} } }`;
const r = checkGrammar(bad, files, `${RADIX_REF}\nboxShadow: { brand: 'var(--shadow-brand)' }`);
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} 条规则对已知违规均判红`);
// R11 单独两侧自证:僵尸令牌 = tailwind 引用了 CSS 没声明的变量。
// 夹具里 --shadow-glow 未声明、--shadow-brand 已声明,所以必须只抓前者;
// 若判据恒绿(抓不到)或恒红(连已声明的也报),都算仪器坏。
// 注意每个夹具都要带上 --radix-accordion-content-height:它是登记在案的外部所有者豁免,
// 不带就会额外触发「豁免腐化」那条红,把「已声明引用不误报」这一维的读数污染掉。
// (第一版正是踩在这里:把夹具写错读成了判据坏。)
const r11RedIds = (tw) => checkGrammar(bad, new Map(), `${RADIX_REF}\n${tw}`).find((x) => x.id === "R11").red;
const r11Caught = r11RedIds("boxShadow: { brand: 'var(--shadow-brand)', glow: 'var(--shadow-glow)' }");
const r11Clean = r11RedIds("boxShadow: { brand: 'var(--shadow-brand)' }");
const r11HitsGlow = r11Caught.some((m) => m.includes("--shadow-glow"));
const r11IgnoresDeclared = r11Clean.length === 0 && !r11Caught.some((m) => m.includes("--shadow-brand"));
if (!r11HitsGlow || !r11IgnoresDeclared) {
console.log(` ✗ R11 不自证:未声明的 --shadow-glow 抓到 ${r11HitsGlow}、已声明的不误报 ${r11IgnoresDeclared} ⇒ 上面所有绿灯不作数`);
return 1;
}
console.log(" ✓ R11 双向:未声明引用判红、已声明引用不误报");
// R10 单独两侧自证:它是存量棘轮,判据是「数量 > 上限」,所以负例要按数量构造。
// 用真实 globals.css 做底,避免其它规则的红因混进来干扰这一维的读数。
const cssText = existsSync(CSS) ? readFileSync(CSS, "utf8") : ":root { --radius-xs: 0px; }";
const liftCountAt = (n) =>
checkGrammar(cssText, new Map([
["src/app/(marketing)/lift.tsx", `<div className="${"hover:-translate-y-1 ".repeat(n)}" />`],
])).find((x) => x.id === "R10").red.length;
const atCeiling = liftCountAt(HOVER_LIFT_CEILING);
const overCeiling = liftCountAt(HOVER_LIFT_CEILING + 1);
if (atCeiling !== 0 || overCeiling === 0) {
console.log(` ✗ R10 棘轮不自证:上限处判红 ${atCeiling}(应 0)、上限+1 判红 ${overCeiling}(应 >0)⇒ 上面所有绿灯不作数`);
return 1;
}
console.log(` ✓ R10 棘轮双向:${HOVER_LIFT_CEILING} 处不判红、${HOVER_LIFT_CEILING + 1} 处判红`);
return 0;
}
function main() {
if (process.argv.includes("--selftest")) process.exit(selftest());
if (!existsSync(CSS)) { console.log(`未能度量:${CSS} 不存在`); process.exit(2); }
if (!existsSync(TW_CONFIG)) { console.log(`未能度量:${TW_CONFIG} 不存在 —— R11 没有引用方可查`); process.exit(2); }
const text = readFileSync(CSS, "utf8");
const twConfig = readFileSync(TW_CONFIG, "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, twConfig);
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();