/g)].map((m) => m[1]); for (const id of contractIds) { if (!pageIds.includes(id)) srcProblems.push(`${c.slug}: 契约演示 ${id} 在演示页里没有对应 data-demo 块`); if (!html.includes(`?demo=${id}`)) srcProblems.push(`${c.slug}: 演示块 ${id} 的预览帧未带 ?demo=`); /* 代码区是**转义后**的原文（
 里 " 变成 "），判据按转义形态写 */
    if (!html.includes(`data-demo="${id}"`)) {
      srcProblems.push(`${c.slug}: 演示块 ${id} 的代码区没有演示页原文（应含 data-demo="${id}"）`);
    }
  }
  for (const id of pageIds) {
    if (!contractIds.includes(id)) srcProblems.push(`${c.slug}: 演示页有 data-demo="${id}"，但契约 demos 未登记`);
  }

  /* 每个演示块要有非空代码（ 里至少 80 字符的原文） */
  const demoCodeLens = [...html.matchAll(/([\s\S]*?)<\/code><\/pre>/g)].map((m) => m[1].length);
  if (demoCodeLens.length !== contractIds.length) {
    srcProblems.push(`${c.slug}: 演示代码块 ${demoCodeLens.length} 个 ≠ 演示 ${contractIds.length} 个`);
  }
  if (demoCodeLens.some((n) => n < 80)) srcProblems.push(`${c.slug}: 存在过短的演示代码块（<80 字符）`);
}
check(srcProblems.length === 0, `E5 每端源码块 + 每个演示块的预览/原文代码齐全（${ENDS.length} 端）`, srcProblems.slice(0, 6).join('; ') || null);

/* ---------- E6 变体类名在 CSS 里真实存在 ---------- */

const clsProblems = [];
for (const c of components) {
  const ct = contracts.get(c.slug);
  const css = read(join(SRC, c.files.css));
  const vc = ct.variantClasses || {};
  Object.entries(vc).forEach(([dim, map]) => {
    Object.entries(map).forEach(([val, list]) => {
      list.forEach((token) => {
        if (token.startsWith('(')) return; /* 数据驱动的占位写法，不检查 */
        if (token.startsWith('--')) {
          if (!new RegExp(`${token}\\s*:`).test(css)) clsProblems.push(`${c.slug}: ${dim}=${val} 的变量 ${token} 未在 CSS 定义`);
        } else {
          const bare = token.replace(/^\./, '');
          if (!new RegExp(`\\.${bare}(?![\\w-])`).test(css)) clsProblems.push(`${c.slug}: ${dim}=${val} 的类 ${token} 未在 CSS 出现`);
        }
      });
    });
  });
}
check(clsProblems.length === 0, 'E6 契约 variantClasses 的类名/变量在组件 CSS 里真实存在', clsProblems.slice(0, 6).join('; ') || null);

/* ---------- E6b CSS 变量表 ↔ 组件 CSS 里定义的组件级变量（双向） ---------- */

const cssVarProblems = [];
for (const c of components) {
  const html = pageOf(c);
  const css = read(join(SRC, c.files.css));
  const defined = [...css.matchAll(/^\s*(--kole-m-[a-z0-9-]+)\s*:/gm)]
    .map((m) => m[1])
    .filter((n) => !/^--kole-m-(touch-target|navbar-height|tabbar-height|action-height|gutter|hit-slack|safe-|font-size-|duration-|ease-)/.test(n));
  for (const v of defined) {
    if (!html.includes(`${v}`)) cssVarProblems.push(`${c.slug}: CSS 变量 ${v} 未进「CSS 变量」表`);
  }
  /* 表里出现的 --kole-m-* 也必须真的是本组件定义的组件级变量（不是随便列的） */
  const tableIdx = html.indexOf('CSS 变量');
  const table = html.slice(tableIdx, tableIdx + 4000);
  for (const m of table.matchAll(/(--kole-m-[a-z0-9-]+)<\/code>/g)) {
    if (!defined.includes(m[1])) cssVarProblems.push(`${c.slug}: CSS 变量表列了未定义的 ${m[1]}`);
  }
}
check(cssVarProblems.length === 0, 'E6b CSS 变量表与组件 CSS 定义双向一致', cssVarProblems.slice(0, 6).join('; ') || null);

/* ---------- E6c 相似组件表引用的 slug 必须存在 ---------- */

const relProblems = [];
const allSlugs = new Set(components.map((c) => c.slug));
for (const c of components) {
  const ct = contracts.get(c.slug);
  const list = ct.related || [];
  if (!list.length) relProblems.push(`${c.slug}: 相似组件表为空`);
  for (const r of list) {
    if (!allSlugs.has(r.slug)) relProblems.push(`${c.slug}: 相似组件 ${r.slug} 不存在`);
    if (!r.why || r.why.length < 8) relProblems.push(`${c.slug}: 相似组件 ${r.slug} 缺少「何时使用」说明`);
  }
}
check(relProblems.length === 0, 'E6c 相似组件表引用真实组件且有区分说明', relProblems.slice(0, 6).join('; ') || null);

/* ---------- E7 页面壳与交互 ---------- */

const shellProblems = [];
const allPages = [...rootPages, ...components.map((c) => `component/${c.slug}.html`)];
for (const p of allPages) {
  const html = read(join(SITE, p));
  /* 平台切换已从顶栏移除（重复入口，见 E3 注释）：这里改为断言它在左栏存在，
     防的是「去重时把两个入口都删了」这种反向缺陷。注意类名是
     class="m-side-link m-side-platform" —— 别按 class="m-side-platform" 匹配（不成立）。 */
  if (!html.includes('m-side-platform')) shellProblems.push(`${p}: 左栏缺平台入口`);
  if (!html.includes("closest('.m-copy')")) shellProblems.push(`${p}: 缺复制脚本`);
  if (!html.includes('class="m-body"')) shellProblems.push(`${p}: 缺两列布局容器`);
  if (/__[A-Z_]+__/.test(html)) {
    const left = [...new Set(html.match(/__[A-Z_]+__/g) || [])].join(',');
    shellProblems.push(`${p}: 未替换占位符 ${left}`);
  }
}
check(shellProblems.length === 0, 'E7 页面壳完整（左栏平台入口 / 复制脚本 / 无残留占位符）', shellProblems.slice(0, 6).join('; ') || null);

/* ---------- E8 站内文件链接全部可解析 ----------
   实测价值：把 tokens.html 改名成 design.html 后，快速开始卡片与页脚还指向旧路径；
   更新日志页的测试链接少退一级（../ 应为 ../../）。这两类都只有"点进去才发现"，
   静态断言能一次性抓完。排除项：模板（_*.html，路径按生成后的目录算）、代码块内容
   （ 里的 href="…" 是示例文本）、无扩展名地址（SPA 路由，交给 nginx 回落）。 */

const linkProblems = [];
{
  const SITE_DIR = SITE;
  const pages = [
    ...readdirSync(SITE_DIR).filter((x) => x.endsWith('.html') && !x.startsWith('_')),
    ...readdirSync(join(SITE_DIR, 'component')).map((x) => 'component/' + x),
  ];
  let checked = 0;
  for (const f of pages) {
    const abs = join(SITE_DIR, f);
    const html = read(abs).replace(//g, '');
    for (const m of html.matchAll(/(?:href|src)="([^"]+)"/g)) {
      const raw = m[1];
      if (/^(https?:|data:|#|mailto:)/.test(raw)) continue;
      const clean = raw.split(/[?#]/)[0];
      if (!clean || !/\.[a-z0-9]+$/i.test(clean)) continue;
      checked++;
      if (!existsSync(resolve(dirname(abs), clean))) linkProblems.push(`${f} → ${raw}`);
    }
  }
  check(linkProblems.length === 0, `E8 站内文件链接全部可解析（${checked} 条）`, linkProblems.slice(0, 6).join('; ') || null);
}

console.log('\n────────────────────────────');
if (failures.length) {
  console.error(`[FAIL] ${failures.length} 条文档完整性断言失败（通过 ${pass} 条）：`);
  failures.forEach((f) => console.error('  - ' + f));
  process.exit(1);
}
console.log(`[OK] 文档完整性门禁全部通过（${pass} 条断言 · ${allPages.length} 页）`);
${title}
