Files
aurora-admin/tools/verify-theme.mjs
T
aurora-admin eb25feedaf feat(S6-P21): 组件族参数化(13族/44成员/导航族15文件同源/79→48概念组件)
【本次核心 · S6-P21】
- 族层数据:families.json + 44 份契约注入 family/familyRole/familyParams;
  data.json / data.js / site/details 同步。13 族 / 44 成员 / 35 独立 → 概念组件 79→48。
- 79 个 slug 全保留、集合逐一不变(铁律 5 对外承诺未破);frameworks 仍 395 文件、薄壳仍 79。
- 归族判据为契约中可核对字段(semanticTypeCandidates 重叠 / anatomy 为同一骨架子集 /
  变体维度同构 / doNotInvent 显式从属声明),每族 mergeBasis 写明依据,不按名字猜。
- 实现层合并(导航族端到端切片):tools/gen-family-impl.mjs 从 5 端模板生成
  TopMenu / SideMenu / MixedNavigation 共 15 文件,参数 direction=top|side|mixed;
  三份 CSS md5 完全相同 = 一份样式表服务三个组件。
- 新增 tools/gen-families.mjs、tools/gen-family-impl.mjs、tools/verify-families.mjs、
  tools/lib/family-model.mjs、tools/lib/family-impl/nav-menu/*.tpl。

【同时清掉此前已完成但未提交的批次】
生成物(data.json / data.js / site/sources / site/components 薄壳 / sitemap.xml / tests 报告)
跨阶段交织,无法拆成互相自洽的多个提交,故按既有批量风格合并提交:
- Package:三端可 import(S5-P18)+ 发布到私有 npm 源
- Docs site:导航语言改下拉(S5-P19)、详情页代码块默认展开、中英切换完整性
- Security:生产部署链审计修复(2026-09-19)+ 线上部署
- Theme modes 日间/夜间/自动;S1-P4 data.js 瘦身;S2-P5 暗色;S2-P6 跨端一致性;
  S2-P7 行为断言;S2-P9 FAQ;S3-P8 RTL;S3-P9 契约缺口解释层;S4-P12 发布流程
- 补入 tools/pack-deploy.mjs、run-site-smoke.mjs、verify-*.mjs,.dockerignore、
  安全审计修复与待决策项.md

【验收】
- node tools/verify-families.mjs → OK: 族层端到端一致(13 族 / 44 成员 / 79 组件不变 / 395 文件不变)
- node tools/verify-cross-platform.mjs → 79/79 identical(HEAD 基线 high 44)
- node tools/run-regression.mjs → 100%(79/79 页,1017/1017 断言,N/A 34),连跑 8 次一致,0 超时
- 逐页实测:topmenu / sidemenu / mixednavigation 各 13/13,帧内 direction 参数正确,0 JS 错误
- 零运行时依赖 OK;build-site.ps1 ASCII-only OK

【未纳入】site/components/<slug>/ 平台薄壳 316 个 —— 历史从未跟踪且属构建产物,保持现状。
2026-09-20 03:32:31 +08:00

94 lines
4.8 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
/* 三态主题专项验证:日间 / 夜间 / 自动 + iframe 同步。 */
import { readFileSync } from 'fs';
import { join } from 'path';
const ROOT = process.cwd();
const BASE = process.env.REG_BASE || 'http://127.0.0.1:3311';
let fail = 0;
const ok = (condition, message) => {
console.log((condition ? 'PASS' : 'FAIL') + ' ' + message);
if (!condition) fail++;
};
const app = readFileSync(join(ROOT, 'site/app.js'), 'utf8');
const index = readFileSync(join(ROOT, 'site/index.html'), 'utf8');
const css = readFileSync(join(ROOT, '.design_library/aurora-admin/colors_and_type.css'), 'utf8');
ok(/prefers-color-scheme/.test(app), '静态:支持 prefers-color-scheme');
ok(/localStorage\.setItem\(['"]aa-mode/.test(app), '静态:持久化 aa-mode');
ok(/data-mode="auto"/.test(index), '静态:站点包含自动模式选项');
ok(/html\.aa-dark/.test(css), '静态:暗色令牌入口存在');
let chromium;
try {
({ chromium } = await import('playwright'));
} catch {
console.error('[FATAL] 未安装 playwright');
process.exit(2);
}
const browser = await chromium.launch();
try {
async function siteCase(colorScheme, storedMode, expectedDark, label) {
const page = await browser.newPage({ colorScheme });
await page.addInitScript((mode) => localStorage.setItem('aa-mode', mode), storedMode);
await page.goto(BASE + '/site/index.html', { waitUntil: 'load', timeout: 15000 });
await page.waitForTimeout(150);
const result = await page.evaluate(() => ({
dark: document.documentElement.classList.contains('aa-dark'),
stored: localStorage.getItem('aa-mode'),
menu: document.querySelectorAll('#mode-menu [role="radio"]').length,
auto: document.querySelector('#mode-menu [data-mode="auto"]')?.getAttribute('aria-checked'),
iframe: Array.from(document.querySelectorAll('iframe')).every((f) => {
try { return f.contentDocument?.documentElement.classList.contains('aa-dark') === document.documentElement.classList.contains('aa-dark'); } catch { return true; }
})
}));
ok(result.dark === expectedDark, `${label}:aa-dark=${result.dark}`);
ok(result.stored === storedMode, `${label}:aa-mode=${result.stored}`);
ok(result.menu === 3 && result.auto === (storedMode === 'auto' ? 'true' : 'false'), `${label}:模式菜单 ARIA`);
ok(result.iframe, `${label}:iframe 主题同步`);
await page.close();
}
await siteCase('light', 'auto', false, '自动 + 系统日间');
await siteCase('dark', 'auto', true, '自动 + 系统夜间');
await siteCase('dark', 'light', false, '手动日间覆盖系统夜间');
await siteCase('light', 'dark', true, '手动夜间覆盖系统日间');
const changing = await browser.newPage({ colorScheme: 'light' });
await changing.addInitScript(() => localStorage.setItem('aa-mode', 'auto'));
await changing.goto(BASE + '/site/index.html', { waitUntil: 'load', timeout: 15000 });
await changing.waitForTimeout(100);
await changing.emulateMedia({ colorScheme: 'dark' });
await changing.waitForTimeout(100);
ok(await changing.locator('html').evaluate((el) => el.classList.contains('aa-dark')), '自动模式:系统切换到夜间即时生效');
await changing.emulateMedia({ colorScheme: 'light' });
await changing.waitForTimeout(100);
ok(!(await changing.locator('html').evaluate((el) => el.classList.contains('aa-dark'))), '自动模式:系统切换到日间即时生效');
await changing.close();
const menuPage = await browser.newPage({ colorScheme: 'light' });
await menuPage.addInitScript(() => localStorage.removeItem('aa-mode'));
await menuPage.goto(BASE + '/site/index.html', { waitUntil: 'load', timeout: 15000 });
await menuPage.locator('#fab-mode').click();
await menuPage.locator('#mode-menu [data-mode="dark"]').click();
ok(await menuPage.evaluate(() => localStorage.getItem('aa-mode') === 'dark' && document.documentElement.classList.contains('aa-dark')), '菜单选择夜间模式');
await menuPage.close();
const switcher = await browser.newPage({ colorScheme: 'light' });
await switcher.addInitScript(() => localStorage.removeItem('aa-mode'));
await switcher.goto(BASE + '/frameworks/ThemeSwitcher.html', { waitUntil: 'load', timeout: 15000 });
const modes = await switcher.locator('.aa-themesw-opt').count();
ok(modes === 3, 'ThemeSwitcher H5:三种模式');
await switcher.locator('[data-mode="dark"]').click();
ok(await switcher.locator('html').evaluate((el) => el.classList.contains('aa-dark')), 'ThemeSwitcher H5:夜间模式生效');
await switcher.locator('[data-mode="auto"]').click();
ok(await switcher.locator('[data-mode="auto"]').getAttribute('aria-checked') === 'true', 'ThemeSwitcher H5:自动模式 ARIA');
await switcher.close();
} finally {
await browser.close();
}
console.log(fail ? `THEME VERIFY FAIL (${fail})` : 'THEME VERIFY OK');
process.exit(fail ? 1 : 0);