aurora-admin/tools/verify-brand-mark.mjs

#!/usr/bin/env node
/**
 * verify-brand-mark.mjs — 项目品牌图标静态门禁。
 * 组件 Icon registry 是另一套系统，本脚本只检查 favicon 与文档站品牌标记。
 */
import fs from 'node:fs';
import path from 'node:path';
import { collectPublishSet } from './lib/publish-set.mjs';
import {
  generatedData,
  readBrandSpec,
  renderFaviconSvg,
  renderMonoSvg,
  validateBrandSpec,
  BRAND_ASSET_REL,
  BRAND_DATA_REL,
  BRAND_MONO_REL,
  BRAND_SPEC_REL,
} from './lib/brand-mark.mjs';

const ROOT = process.cwd();
const read = (rel) => fs.readFileSync(path.join(ROOT, rel), 'utf8').replace(/^\uFEFF/, '');
const exists = (rel) => fs.existsSync(path.join(ROOT, rel));
let pass = 0;
const failures = [];
function check(ok, label, detail = '') {
  if (ok) {
    pass++;
    console.log(`  PASS  ${label}${detail ? ` — ${detail}` : ''}`);
  } else {
    failures.push(`${label}${detail ? ` — ${detail}` : ''}`);
    console.log(`  FAIL  ${label}${detail ? ` — ${detail}` : ''}`);
  }
}

console.log('Kole UI 项目品牌图标门禁');
check(exists(BRAND_SPEC_REL), 'B1 品牌规格存在', BRAND_SPEC_REL);
check(exists(BRAND_ASSET_REL), 'B2 favicon SVG 存在', BRAND_ASSET_REL);
check(exists(BRAND_MONO_REL), 'B3 单色 SVG 存在', BRAND_MONO_REL);
check(exists(BRAND_DATA_REL), 'B4 生成数据存在', BRAND_DATA_REL);

const spec = readBrandSpec(ROOT);
const specErrors = validateBrandSpec(spec);
check(specErrors.length === 0, 'B5 品牌规格结构有效', specErrors.join('；'));

const expectedFavicon = renderFaviconSvg(spec) + '\n';
const expectedMono = renderMonoSvg(spec) + '\n';
const expectedData = JSON.stringify(generatedData(spec), null, 2) + '\n';
const favicon = exists(BRAND_ASSET_REL) ? read(BRAND_ASSET_REL) : '';
const mono = exists(BRAND_MONO_REL) ? read(BRAND_MONO_REL) : '';
const data = exists(BRAND_DATA_REL) ? read(BRAND_DATA_REL) : '';
check(favicon === expectedFavicon, 'B6 favicon 是规格生成物');
check(mono === expectedMono, 'B7 单色标记是规格生成物');
check(data === expectedData, 'B8 generated JSON 是规格生成物');
check(!/<image\b|(?:href|src)=["']https?:\/\//i.test(favicon + mono), 'B9 品牌 SVG 不含外部资源');
check((favicon.match(/<path\b/g) || []).length === spec.geometry.paths.length, 'B10 favicon 完整包含全部几何路径', `${spec.geometry.paths.length} 条`);
check((mono.match(/<path\b/g) || []).length === spec.geometry.paths.length, 'B11 单色标记完整包含全部几何路径', `${spec.geometry.paths.length} 条`);
const faviconPaint = spec.geometry.mode === 'fill' ? `fill="${spec.favicon.foreground}"` : `stroke="${spec.favicon.foreground}"`;
check(favicon.includes(`fill="${spec.favicon.background}"`) && favicon.includes(faviconPaint), 'B12 favicon 颜色固定');
const monoPaint = spec.geometry.mode === 'fill' ? 'fill="#000000"' : 'stroke="#000000"';
check(mono.includes(monoPaint) && !mono.includes(`fill="${spec.favicon.background}"`), 'B13 单色标记透明背景');

const pc = read('site/index.html');
const mobileBuilder = read('tools/build-mobile.mjs');
const mobileStyle = read('site/m/style.css');
check(pc.includes('href="assets/kole-mark.svg"'), 'B14 PC 使用 favicon 资产');
check(pc.includes('class="logo-mark"') && pc.includes('data-brand-mark="mono"'), 'B15 PC 顶栏使用单色品牌标记');
check(!pc.includes('M7 5.5V18.5'), 'B16 PC 不再内联旧几何路径');
check(mobileBuilder.includes("readBrandSpec(ROOT)"), 'B17 移动端构建读取品牌规格');
check(!mobileBuilder.includes('const BRAND_PATHS ='), 'B18 移动端构建不重复维护几何路径');
check(mobileStyle.includes('data-brand-mark="mono"') || mobileStyle.includes('kole-mark-mono.svg'), 'B19 移动端样式声明单色品牌资产');
check((pc.match(/theme-color/g) || []).length >= 2, 'B20 PC theme-color 保留亮暗两态');

const mobileIndex = JSON.parse(read('.design_library/kole-ui-mobile/components/index.json'));
const mobilePages = [
  ...['index', 'guide', 'design', 'faq', 'changelog', 'platform'].map((name) => `site/m/${name}.html`),
  ...mobileIndex.components.map((component) => `site/m/component/${component.slug}.html`),
];
const pageProblems = [];
for (const rel of mobilePages) {
  if (!exists(rel)) { pageProblems.push(`${rel}: 文件缺失`); continue; }
  const html = read(rel);
  const head = (html.match(/<head\b[^>]*>([\s\S]*?)<\/head>/i) || [])[1] || '';
  const icons = [...head.matchAll(/<link\b[^>]*rel="icon"[^>]*>/g)];
  const href = icons.length === 1 ? (icons[0][0].match(/\bhref="([^"]+)"/) || [])[1] : '';
  if (!href || path.posix.normalize(path.posix.join(path.posix.dirname(rel), href)) !== BRAND_ASSET_REL) {
    pageProblems.push(`${rel}: favicon 未指向统一资产`);
  }
  const header = (html.match(/<header class="m-top">([\s\S]*?)<\/header>/) || [])[1] || '';
  if (!header.includes('<span class="m-logo-mark" data-brand-mark="mono" aria-hidden="true"></span>')) {
    pageProblems.push(`${rel}: 顶栏标记或装饰性语义缺失`);
  }
  if (header.includes('M7 5.5V18.5') || (head.match(/name="theme-color"/g) || []).length !== 2) {
    pageProblems.push(`${rel}: 旧几何残留或 theme-color 缺失`);
  }
}
check(pageProblems.length === 0, 'B21 移动端全部生成页使用统一品牌资产', pageProblems.slice(0, 5).join('；') || `${mobilePages.length} 页`);
const pcStyle = read('site/style.css');
const pcMask = (pcStyle.match(/\.logo-mark\[data-brand-mark="mono"\]::before\s*\{([^}]+)\}/) || [])[1] || '';
const mobileMask = (mobileStyle.match(/\.m-logo-mark\[data-brand-mark="mono"\]::before\s*\{([^}]+)\}/) || [])[1] || '';
check(pcMask.includes('background: currentColor') && pcMask.includes("url('assets/kole-mark-mono.svg')")
  && mobileMask.includes('background: currentColor') && mobileMask.includes("url('../assets/kole-mark-mono.svg')"),
'B22 两端 mask 路径同源且继承 currentColor');
const published = new Set(collectPublishSet(ROOT).kept);
check([BRAND_ASSET_REL, BRAND_MONO_REL, BRAND_DATA_REL].every((rel) => published.has(rel)), 'B23 发布集包含全部品牌产物');
const scripts = JSON.parse(read('package.json')).scripts;
check(scripts['build:brand'] === 'node tools/build-brand-mark.mjs'
  && scripts['verify:brand'] === 'node tools/verify-brand-mark.mjs'
  && scripts.build.startsWith('node tools/build-brand-mark.mjs && '), 'B24 品牌构建与门禁入口完整');

if (failures.length) {
  console.error(`\n[FAIL] ${failures.length} 条品牌图标断言失败（通过 ${pass} 条）`);
  failures.forEach((failure) => console.error('  - ' + failure));
  process.exit(1);
}
console.log(`\n[OK] 品牌图标门禁全部通过（${pass} 条断言）`);