Files
aurora-admin/tools/verify-i18n.mjs
T
aurora-admin f1fbfc2ddb
Regression / regression (push) Canceled after 0s
feat(品牌标识): 几何 K 图标(favicon/顶栏标记/theme-color) + 并行会话成果入库
## 品牌标识(本次会话)

起因:品牌此前没有任何图形标识 —— 唯一 favicon 是内联 data-URI 里的字母「A」,
那是 v2.0.0「Aurora Admin → Kole UI」改名漏掉的一处(PC 顶栏也是「A」,
移动端站已是「K」;移动端文档站则完全没有 favicon)。

- 几何:24 网格三个互不接触的笔画(竖 + 两斜),圆头描边;
  描边 2.25 → 16px 标签页尺寸下正好 1.5px = 规范原文「描边1.5px」
- 取色分两套(刻意):favicon 硬编码品牌蓝/白(渲染在浏览器标签栏,不继承 kole-dark);
  顶栏标记走 currentColor(实测暗色下自动转 rgb(20,22,28))
- 新增 theme-color 双条(light #FFFFFF / dark #1C1F26,取 --kole-color-card-bg)
- 修 site/app.js hero 标语 KOLE ADMIN → KOLE UI(改名变形残留)
- 移动端 7 个模板补 favicon(此前计数 0)

验收:门禁 9 条全 OK(site-routing/site-routes/mobile-docs/mobile-site/isolation/
theme/nav/i18n/icons);PC 回归 1464/1464 · 移动端 807/807,各连跑 8 次一致;
两端 favicon 405 字节逐字节一致;PC 站控制台错误 1→0。

## 并行会话成果(本次一并入库)

- 图标系统:2576 图标(TDesign/Element Plus,MIT)+ 11 端注入 + 5 个构建门禁工具
  + IconPreview 预览页 + ICON-SPEC.md 冻结规格
- 移动端平台:47 组件 × 6 端 + 文档站 53 页 + 隔离门禁
- PC 组件:103 个大后台组件 / 组件11 批次
- uni-app:PC 端试点 + 移动端端实现 + 真实编译验证

## 工程

- .gitignore 补 .scratch/ 与 .zcode-preexisting-*.txt(会话中间产物,实测 9.1MB,不入库)
- CHANGELOG 补品牌标识条目
- ROADMAP 登 S8-P4(品牌标识任务包 + og:image/apple-touch-icon 未做部分)
2026-09-21 10:05:48 +08:00

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*['"]kole-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', /Kole UI · 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`);