// tests/audit-mockup-html-conformance.test.ts
// -----------------------------------------------------------------------------
// `scripts/audit-mockup-html-conformance.mjs`（npm key `audit:mockup-html-conformance`）的
// **整脚本**回归面。
//
// 🔴 **为什么是这一条**（第四十七轮按量具现取挑的，⛔ 不按印象）：它在 `package.json` 的
// `files[]` 白名单里（经 `scripts/audit-mockup-*.mjs` 那条 glob）⇒ **随 npm 包发到每个
// consumer**；且它是 blocking，挂 **L4** `.husky/pre-commit` + **L5**
// `.gitea/workflows/pr-checks.yml`（该 workflow 的 `on:` 含 push:master ⇒ owner 直推也拦）。
// ⇒ 它的假绿会随下一个版本分发到所有下游产品，其余闸的假绿只影响本仓。
//
// 🔴 **本文件同时是「P3=TREE ⇒ 走不了 fixture-root」这条转述的反证。** 量具
// `gate-regression-face-inventory` 第 40 行写的是「递归走大目录树 = 造 fixture **成本**
// 反超抽 lib」—— 那是**成本**信号，不是封路，而该估算隐含「必须复刻真仓库那棵树」。
// 实际只需放进够让判据开火的两三个文件：本闸的 `DEFAULT_MOCKUP_GLOBS` 只有一个目录
// （`docs/internal/_demos`），下方 fixture 里 `walkHtml` 走的是 1-3 个文件。
// ⇒ 按「P2 干净 + P3 非 TREE」筛随包面得 **0** 条；去掉 TREE 那一半，得这一条。
//
// 此前它的回归面是 `I` 类 —— `tests/mockup-html-conformance.test.ts` 的 8 条只 import 了
// 纯函数 `lintMockupHtml`。闸本体有 CLI entry guard，**import 时刻意不跑 CLI** ⇒ 那份测试
// 结构上碰不到：argv 解析（`--all` / staged 显式文件 / `--warnings-as-errors`）、`walkHtml`
// 的递归与 `.html` 过滤、severity→退出码映射、以及**三个进程出口**（nothing-to-lint 0 /
// 全绿 0 / 有 error 1）。摘掉任一出口的接线，那 8 条全绿。
//
// ⛔ **闸本体一行没改。**
// ⛔ 散文里提别的闸时**去掉 `.mjs` 后缀** —— 带后缀会让量具把那条闸误报成「已覆盖」。
//
// 🔴 **顺带是 `is-cli-entry` 的第二个端到端见证**：macOS `os.tmpdir()` 返回 `/var/folders/…`
// 而 `/var` 自己就是 symlink ⇒ 这批 fixture **全程跑在 symlink 布局下**。上一轮修掉的那类
// 假绿（entry guard 在 symlink 下恒假 ⇒ 整程序不执行、exit 0、stdout/stderr 双空）在这里会
// 表现为**每条绿档当场失败**（拿不到 fixture 自己的读数）。⇒ 下方每条绿档都钉了「只有真
// 跑过才有的读数」，⛔ 别把任何一条降级成只看退出码。
// ⇒ 也因此 `linkDirs` **必须走 harness 默认的 `['scripts/lib']`**（闸 import
// `./lib/is-cli-entry`）—— ⛔ 别写 `linkDirs: []`，那会让闸在 fixture 里 ENOENT 崩掉，
// 而崩溃也是非零退出 ⇒ 红得理由不对。
//
// 覆盖：绿档非空过（fixture 自己的文件数 + 文件名回显 + **对真仓库 `_demos` 的反向钉**，
// 反向钉自带非空前提检查）· 三条 error 规则各经 CLI 开火一次 · 两条 warn 规则不改退出码
// · `--warnings-as-errors` 把 warn 升成 error（**只存在于 CLI 块，纯函数完全不知道它**）
// · `walkHtml` 递归子目录 · 非 `.html` 不进分母 · 文件级 suppression 经 CLI 生效
// · 显式传不存在的文件 ⇒ fail-closed · staged 显式文件那一路挂载
// · 🔴 **一条如实登记的 fail-open**（`_demos` 空 ⇒ nothing-to-lint 且 exit 0），
// ⛔ 不是背书 —— 是把闸头注释自己登记的那条诚实边界钉住，防它被静默改掉、
// 也防后来人把本闸读成「无条件」。
// -----------------------------------------------------------------------------
import { describe, it, expect, afterEach } from 'vitest'
import { readdirSync } from 'node:fs'
import { join } from 'node:path'
import {
REPO_ROOT,
createGateFixture,
runGate,
expectGateRed,
expectGateGreen,
cleanupGateFixtures,
} from './lib/gate-fixture-root'
const GATE = 'scripts/audit-mockup-html-conformance.mjs'
/** 闸的 `DEFAULT_MOCKUP_GLOBS` 唯一那一项。 */
const DEMOS = 'docs/internal/_demos'
afterEach(() => {
cleanupGateFixtures()
})
// ---------------------------------------------------------------------------
// fixture 构造
// ---------------------------------------------------------------------------
/** 在 fixture 的 `docs/internal/_demos/` 下写这些文件（key = 该目录内的相对路径）。 */
function build(files: Record): string {
return createGateFixture({
gate: GATE,
prefix: 'fx-mockup-html-conf',
// 目录先建出来：即使 files 为空也要有它，才能复现「被清空」而不是「不存在」
dirs: [DEMOS],
files: Object.fromEntries(Object.entries(files).map(([rel, c]) => [`${DEMOS}/${rel}`, c])),
// linkDirs 刻意不传 ⇒ 用默认 ['scripts/lib']，理由见文件头
})
}
/** 零违例。`#000` 是闸的 NEUTRAL_HEX_ALLOW 成员 ⇒ 顺带走一遍 allow-list 那条分支。 */
const CLEAN = [
'',
'fx clean',
'',
'fx clean mockup
',
'',
].join('\n')
/** 只触发 popupbox-for-confirm：确认词在窗口内，且无 FORM_FIELDS（`