aurora-admin
eb25feedaf
【本次核心 · 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 个 —— 历史从未跟踪且属构建产物，保持现状。
70 lines
3.7 KiB
JavaScript
70 lines
3.7 KiB
JavaScript
#!/usr/bin/env node
|
|
/**
|
|
* verify-i18n.mjs — static checks for the documentation site's zh-CN/en switch.
|
|
* No runtime dependencies; exits non-zero when a source key is missing or a
|
|
* module-level translated value can go stale after a language change.
|
|
*/
|
|
import { readFileSync, existsSync } from 'node:fs';
|
|
import { join } from 'node:path';
|
|
|
|
const ROOT = join(import.meta.dirname, '..');
|
|
const appPath = join(ROOT, 'site', 'app.js');
|
|
const i18nPath = join(ROOT, 'site', 'i18n.js');
|
|
const indexPath = join(ROOT, 'site', 'index.html');
|
|
const app = readFileSync(appPath, 'utf8');
|
|
const i18n = readFileSync(i18nPath, 'utf8');
|
|
const index = readFileSync(indexPath, 'utf8');
|
|
|
|
const failures = [];
|
|
const checks = [];
|
|
function check(name, ok, detail = '') {
|
|
checks.push({ name, ok, detail });
|
|
if (!ok) failures.push(`${name}${detail ? `: ${detail}` : ''}`);
|
|
}
|
|
|
|
check('dictionary exists', /var\s+EN\s*=\s*\{/.test(i18n));
|
|
check('language storage key', /LANG_KEY\s*=\s*['"]aa-lang['"]/.test(i18n));
|
|
check('language values', /saved\s*===\s*['"]en['"]/.test(i18n) && /saved\s*===\s*['"]zh['"]/.test(i18n));
|
|
check('HTML lang sync', /setAttribute\(['"]lang['"],\s*lang\s*===\s*['"]en['"]\s*\?\s*['"]en['"]\s*:\s*['"]zh-CN['"]/.test(i18n));
|
|
check('language select markup', /id="lang-trigger"/.test(index) && /id="lang-menu"/.test(index)
|
|
&& /role="listbox"/.test(index) && /class="lang-opt"[^>]*data-lang="zh"/.test(index) && /class="lang-opt"[^>]*data-lang="en"/.test(index));
|
|
check('language select binding', /function\s+bindLangSelect\s*\(/.test(app)
|
|
&& /function\s+applyLang\(next\)[\s\S]*?I18N\.setLang\(next\)/.test(app)
|
|
&& /applyLang\(opt\.getAttribute\(['"]data-lang['"]\)\)/.test(app));
|
|
check('no legacy lang toggle left', !/lang-toggle/.test(index) && !/bindLangToggle/.test(app) && !/\.lang-zh\b/.test(index));
|
|
check('English document title', /Aurora Admin · Component Library/.test(app));
|
|
check('source-key navigation map', /var\s+NAV_KEY\s*=\s*\{[^}]*home:\s*['"]首页['"]/.test(app));
|
|
check('search stores category key', /return\s*\{\s*c:\s*c,[\s\S]*?category:\s*c\.category\s*\}/.test(app));
|
|
check('related translations evaluated at render', /why:\s*T\(rule\.why\)/.test(app));
|
|
check('theme labels evaluated at render', /function\s+themeMeta\s*\(\)[\s\S]*?T\(m\[1\]\)/.test(app));
|
|
check('theme presets evaluated at render', /function\s+themePresets\s*\(\)[\s\S]*?T\(p\.label\)/.test(app));
|
|
const relatedDecl = app.match(/var\s+RELATED_MAP\s*=\s*\[[\s\S]*?\n\s*\];/);
|
|
const themeDecl = app.match(/var\s+THEME_META_KEYS\s*=\s*\[[\s\S]*?\n\s*\];/);
|
|
check('no stale module-level translated caches', !(relatedDecl && /\bT\s*\(/.test(relatedDecl[0])) && !(themeDecl && /\bT\s*\(/.test(themeDecl[0])));
|
|
|
|
const dictBlock = i18n.match(/var\s+EN\s*=\s*\{([\s\S]*?)\n\s*\};/);
|
|
const dictionaryKeys = new Set();
|
|
if (dictBlock) {
|
|
for (const match of dictBlock[1].matchAll(/^\s*(['"])((?:\\.|(?!\1)[\s\S])*?)\1\s*:/gm)) {
|
|
dictionaryKeys.add(match[2].replace(/\\(['"])/g, '$1'));
|
|
}
|
|
}
|
|
const sourceKeys = new Set();
|
|
for (const match of app.matchAll(/\bT\(\s*(['"])((?:\\.|(?!\1)[\s\S])*?)\1\s*\)/g)) {
|
|
sourceKeys.add(match[2].replace(/\\(['"])/g, '$1'));
|
|
}
|
|
const missing = [...sourceKeys].filter((key) => !dictionaryKeys.has(key));
|
|
check('literal T() coverage', missing.length === 0, missing.length ? missing.join(' | ') : `${sourceKeys.size} keys covered`);
|
|
|
|
const detailDir = join(ROOT, 'site', 'details');
|
|
check('detail payload directory', existsSync(detailDir));
|
|
|
|
for (const result of checks) {
|
|
console.log(`[i18n] ${result.ok ? 'OK' : 'FAIL'} ${result.name}${result.detail ? ` — ${result.detail}` : ''}`);
|
|
}
|
|
if (failures.length) {
|
|
console.error(`\n[i18n] ${failures.length} check(s) failed`);
|
|
process.exit(1);
|
|
}
|
|
console.log(`\n[i18n] OK — ${checks.length} checks passed`);
|