update

tests/unit/main/menu-label-i18n-keys.test.ts

@@ -0,0 +1,167 @@
+// tests/unit/main/menu-label-i18n-keys.test.ts
+//
+// 守卫(r206,2026-10-20):**主进程 i18n 字典 T 的完整性 + 无死键**。
+//
+// 背景:主进程有一套**独立于 renderer** 的最小 i18n ——
+//   src/main/i18n-dict.ts 里的 `T: { key: { 'zh-CN':…, 'en-US':… } }`,
+//   由 src/main/i18n.ts 的 t(key, lang) / tr(key) 解析。
+//   它跟 renderer 那套 i18next(JSON 文件)是**两套不相干的系统**,各有各的坑:
+//
+//   ① **key 拼错 / 漏建 ⇒ 菜单栏露出裸 key**。resolveT 查不到就 `return key`,
+//      所以 `t('menu.file.newNotee', lang)` 会把 "menu.file.newNotee" 直接
+//      印在应用菜单上 —— 用户看到一串点号,不是文案。TS 不会报:key 是
+//      纯 string。
+//   ② **双语缺一侧 ⇒ 切语言后文案不换**(fallback zh-CN)。
+//   ③ **两侧占位符不一致 ⇒ 切语言后少一段**(与 renderer 侧同款问题,
+//      参见 tests/unit/i18n/placeholder-contract.test.ts)。
+//   ④ **死键堆积** —— 特性下线后没人删的文案条目,躺在字典里误导后来人
+//      「这个 key 好像还在用」。r206 实测 T 有 **13 条零引用**条目:
+//      虚拟文件夹域 folder.*(7,随 migration 0008 drop_folders 退役)、
+//      diskFolder.{notFound,moveFailed,invalidRelPath}(3)、
+//      library.fileNotFoundPath / notes.dbSyncFailed /
+//      common.menuActionFailed(后者与 renderer locale 同名 = 第二个真相源)。
+//      本轮已删,并加本守卫防复涨。
+//
+// 与 renderer 侧守卫的分工:renderer 守「JSON 嵌套 locale + 复数变体」,
+// 这里守「主进程扁平 T 字典」。两套系统结构不同,守卫也分开。
+import { readFileSync, readdirSync, statSync } from 'fs';
+import { join } from 'path';
+import { describe, expect, it } from 'vitest';
+import { T, resolveT } from '@main/i18n-dict';
+
+const ROOT = process.cwd();
+const MAIN_DIR = join(ROOT, 'src/main');
+const DICT_FILE = 'src/main/i18n-dict.ts';
+const LANGS = ['zh-CN', 'en-US'] as const;
+
+const PLACEHOLDER_RE = /\{([A-Za-z0-9_]+)\}/g;
+
+function placeholdersOf(text: string): Set<string> {
+  const out = new Set<string>();
+  PLACEHOLDER_RE.lastIndex = 0;
+  let m: RegExpExecArray | null;
+  while ((m = PLACEHOLDER_RE.exec(text)) !== null) out.add(m[1]);
+  return out;
+}
+
+function walkTs(dir: string): string[] {
+  const out: string[] = [];
+  for (const entry of readdirSync(dir)) {
+    const full = join(dir, entry);
+    if (statSync(full).isDirectory()) out.push(...walkTs(full));
+    else if (/\.tsx?$/.test(entry) && !entry.endsWith('.d.ts')) out.push(full);
+  }
+  return out;
+}
+
+/** src/main 下(除字典文件本身)出现过的所有字符串字面量 */
+function stringLiteralsInMain(): Set<string> {
+  const out = new Set<string>();
+  for (const file of walkTs(MAIN_DIR)) {
+    const rel = file.slice(ROOT.length + 1).replaceAll('\\', '/');
+    if (rel === DICT_FILE) continue;
+    const src = readFileSync(file, 'utf8');
+    for (const m of src.matchAll(/'([A-Za-z0-9_.]+)'/g)) out.add(m[1]);
+    for (const m of src.matchAll(/"([A-Za-z0-9_.]+)"/g)) out.add(m[1]);
+  }
+  return out;
+}
+
+/** 找出 t('x', lang) / tr('x') 形式引用了但 T 里没有的 key */
+function missingKeysInCallSites(): string[] {
+  const bad: string[] = [];
+  const re = /\b(?:t|tr)\(\s*'([A-Za-z0-9_.]+)'/g;
+  for (const file of walkTs(MAIN_DIR)) {
+    const rel = file.slice(ROOT.length + 1).replaceAll('\\', '/');
+    if (rel === DICT_FILE) continue;
+    const src = readFileSync(file, 'utf8');
+    src.split('\n').forEach((line, i) => {
+      for (const m of line.matchAll(re)) {
+        const key = m[1];
+        if (!(key in T)) bad.push(`  ${rel}:${i + 1} → ${key}`);
+      }
+    });
+  }
+  return bad;
+}
+
+describe('主进程 i18n 字典(r206)', () => {
+  const dictKeys = Object.keys(T);
+
+  it('字典非空,且每个条目两种语言都有值', () => {
+    expect(dictKeys.length).toBeGreaterThan(0);
+    const bad: string[] = [];
+    for (const [key, entry] of Object.entries(T)) {
+      for (const lang of LANGS) {
+        const v = entry[lang];
+        if (typeof v !== 'string' || v.length === 0) {
+          bad.push(`  ${key} 缺 ${lang}`);
+        }
+      }
+    }
+    expect(bad.join('\n')).toBe('');
+  });
+
+  it('同一 key 的 zh-CN / en-US 占位符集合一致', () => {
+    const bad: string[] = [];
+    for (const [key, entry] of Object.entries(T)) {
+      const a = placeholdersOf(entry['zh-CN'] ?? '');
+      const b = placeholdersOf(entry['en-US'] ?? '');
+      if (a.size !== b.size || [...a].some((x) => !b.has(x))) {
+        bad.push(`  ${key}: zh=[${[...a].sort()}] en=[${[...b].sort()}]`);
+      }
+    }
+    expect(bad.join('\n')).toBe('');
+  });
+
+  it('调用点引用的 key 必须在 T 里(否则菜单/对话框露出裸 key)', () => {
+    const bad = missingKeysInCallSites();
+    expect(bad.join('\n')).toBe('');
+  });
+
+  it('T 里不许出现零引用死键', () => {
+    const literals = stringLiteralsInMain();
+    const dead = dictKeys.filter((k) => !literals.has(k));
+    expect(
+      dead,
+      `以下字典条目在 src/main 里零引用(特性下线后的遗留),请删除或接线:\n${dead.join('\n')}`,
+    ).toEqual([]);
+  });
+
+  it('resolveT 行为:未知 key 原样返回 key 自身', () => {
+    // 这条是上面「菜单露出裸 key」风险的**根因** —— 显式钉住,
+    // 免得有人把 resolveT 改成抛错/返回空串,把风险从"难看"变成"崩"。
+    expect(resolveT('definitely.not.a.key', 'zh-CN')).toBe('definitely.not.a.key');
+    expect(resolveT('definitely.not.a.key', 'en-US')).toBe('definitely.not.a.key');
+  });
+
+  it('resolveT 行为:占位符按 params 替换', () => {
+    expect(resolveT('validation.noteFilenameInvalidChars', 'zh-CN', { name: 'a/b' })).toContain(
+      'a/b',
+    );
+    expect(resolveT('validation.noteFilenameInvalidChars', 'zh-CN', { name: 'a/b' })).not.toContain(
+      '{name}',
+    );
+    // 少传参数 ⇒ 占位符原样留着(这正是调用点契约要拦的现象)
+    expect(resolveT('validation.noteFilenameInvalidChars', 'zh-CN')).toContain('{name}');
+  });
+
+  it('menu.ts 里用到的每个 label key 都在 T 里', () => {
+    const src = readFileSync(join(MAIN_DIR, 'menu.ts'), 'utf8');
+    const bad: string[] = [];
+    for (const m of src.matchAll(/\bt\(\s*'([A-Za-z0-9_.]+)'\s*,\s*lang\s*\)/g)) {
+      const key = m[1];
+      if (!(key in T)) bad.push(`  ${key}`);
+    }
+    expect(bad.join('\n')).toBe('');
+  });
+
+  it('扫描器非空转:至少扫到若干调用点与字典条目', () => {
+    // 探针:防止上面几条因为「正则一个都没匹配上」而空过。
+    const src = readFileSync(join(MAIN_DIR, 'menu.ts'), 'utf8');
+    const hits = [...src.matchAll(/\bt\(\s*'([A-Za-z0-9_.]+)'\s*,\s*lang\s*\)/g)].map((m) => m[1]);
+    expect(hits.length).toBeGreaterThan(3);
+    expect(hits.every((k) => k in T)).toBe(true);
+    expect(dictKeys.length).toBeGreaterThan(50);
+  });
+});