update

tests/unit/i18n/locale-parity.test.ts

@@ -0,0 +1,61 @@
+// tests/unit/i18n/locale-parity.test.ts
+//
+// 守卫:zh-CN.json / en-US.json 顶层键结构必须严格一致。
+//   行为:把两文件扁平化到 dot 键(递归 object),两侧集合不同就 fail。
+//   目的:防止漏译 / 拼错键名 —— 双 locale 同时被引,i18next 在缺的 key 上抛
+//   警告并把 zh 当 fallback,renderer 看似正常但英文版回退中文,debug 极难。
+//
+// 已知 i18n stub:en-US 部分技术字面量(loadingDots '…')和 zh 相同是
+//   预期 —— 不因此 fail。
+//
+// 历史:audit-r156 (2026-09-?) 起一直被守;r165-hotfix 收紧"两边 dict
+//   完整性"语义后从 1 例失败拉到 1 例通过(去掉 en-US 9 个多余键)。
+import { readFileSync } from 'fs';
+import { resolve } from 'path';
+import { describe, expect, it } from 'vitest';
+
+interface LocaleJson {
+  [key: string]: unknown;
+}
+
+const LOCALES_DIR = resolve(__dirname, '../../../src/renderer/src/i18n/locales');
+
+function flatKeys(value: LocaleJson, prefix = ''): string[] {
+  const out: string[] = [];
+  for (const [k, v] of Object.entries(value)) {
+    const key = prefix ? `${prefix}.${k}` : k;
+    if (v !== null && typeof v === 'object' && !Array.isArray(v)) {
+      out.push(...flatKeys(v as LocaleJson, key));
+    } else {
+      out.push(key);
+    }
+  }
+  return out;
+}
+
+describe('i18n locale parity', () => {
+  const zhPath = resolve(LOCALES_DIR, 'zh-CN.json');
+  const enPath = resolve(LOCALES_DIR, 'en-US.json');
+  const zh = JSON.parse(readFileSync(zhPath, 'utf8')) as LocaleJson;
+  const en = JSON.parse(readFileSync(enPath, 'utf8')) as LocaleJson;
+  const zhKeys = new Set(flatKeys(zh));
+  const enKeys = new Set(flatKeys(en));
+
+  it('zh-CN.json 和 en-US.json 顶层都读得到且是合法 JSON', () => {
+    expect(typeof zh).toBe('object');
+    expect(typeof en).toBe('object');
+  });
+
+  it('两 locale 的扁平键集合严格一致', () => {
+    const onlyZh = [...zhKeys].filter((k) => !enKeys.has(k)).sort();
+    const onlyEn = [...enKeys].filter((k) => !zhKeys.has(k)).sort();
+    expect({ onlyZh, onlyEn }).toEqual({ onlyZh: [], onlyEn: [] });
+  });
+
+  it('两 locale 都有 _meta.code 字段(自我描述)', () => {
+    const zhMeta = (zh as { _meta?: { code?: string } })._meta;
+    const enMeta = (en as { _meta?: { code?: string } })._meta;
+    expect(zhMeta?.code).toBe('zh-CN');
+    expect(enMeta?.code).toBe('en-US');
+  });
+});