裁定(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。
377 lines
23 KiB
JavaScript
377 lines
23 KiB
JavaScript
#!/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();
|