第11章 - 中英双语实现

/** 界面文案表。典故本身的文字在内容 JSON 里，不在这里。 */
export const messages = {
  'zh-CN': {
    'app.title': '中国历史典故',
    'nav.hall': '典故馆',
    'nav.album': '我的图鉴',
    'nav.switchTo': 'English',
    'hall.start': '开始玩',
    'scene.story': '看故事',
    'scene.reward': '典故卡',
    'reward.accept': '收下',
    /* ... 全部界面标签 */
  },
  en: {
    'app.title': 'Chinese Tales',
    'nav.hall': 'Stories',
    'nav.switchTo': '中文',
    'hall.start': 'Play',
    /* ... */
  },
} as const;

export type MessageKey = keyof (typeof messages)['zh-CN'];

/** 编译期保证英文表不缺键：缺一个就类型报错 */
const englishCompleteness: Record<MessageKey, string> = messages.en;
void englishCompleteness;

/** 取词器；缺键时回落到中文，最后回落到键名本身（永不抛错、永不空白） */
export function createTranslator(locale: Locale): Translator {
  const table = messages[locale] ?? messages[DEFAULT_LOCALE];
  return (key: MessageKey): string => table[key] ?? messages[DEFAULT_LOCALE][key] ?? key;
}

/** 从 URL 的 ?lang= 读语言，用于分享与自动化测试 */
export function localeFromSearch(search: string): Locale | null {
  const value = new URLSearchParams(search).get('lang');
  if (!value) return null;
  const lower = value.toLowerCase();
  if (lower === 'en' || lower.startsWith('en-')) return 'en';
  if (lower === 'zh' || lower.startsWith('zh-')) return 'zh-CN';
  return null;
}

/**
 * 用翻译补丁覆盖基础内容（基础内容用中文写，翻译单独放，避免把 JSON 写成双语大杂烩）。
 * - 对象：递归合并
 * - 数组：按下标逐个合并（翻译文件必须与原文等长，由 content:check 保证）
 * - 其余：补丁优先
 */
export function mergeLocalized<T>(base: T, patch: Json): T { /* ... */ }

/** 把某个典故翻译成目标语言（没有译文就原样返回） */
export function localizedAllusion(content: AllusionContent, locale: Locale): AllusionContent {
  if (locale === DEFAULT_LOCALE) return content;
  const patch = patchFor(locale, content.id);
  return patch === undefined ? content : mergeLocalized(content, patch);
}

export const patches: Partial<Record<Locale, Record<string, unknown>>> = {
  en: {
    'caochong-elephant': enCaochong,
    pangu: enPangu,
    /* ... 共 12 个 */
  },
};

export function patchFor(locale: Locale, id: string): unknown {
  return patches[locale]?.[id];
}

export function validatePatch(base: Json, patch: Json, path = ''): PatchIssue[] {
  // 数组：长度不一致 → "数组长度不一致：原文 2 项，译文 3 项"
  // 对象：原文里没有这个字段 → "原文里没有这个字段"
  // ...
}

// 只查内容 schema 是不够的：game.stages[].levelScript 在内容 schema 里是 unknown，
// 英文译文把 unit 写成 "baskets" 就绕过了所有检查，直到玩家打开游戏才报错。
for (const [index, stage] of merged.data.game.stages.entries()) {
  const schema = templateSchemas[stage.template];
  const result = schema.safeParse(stage.levelScript);
  /* 失败即 fail */
}

/** 中日韩字符：英文版里出现它，就说明这个字段漏翻了 */
const CJK = /[\u3400-\u9FFF\uF900-\uFAFF]/;

test('中英文切换：界面与典故内容都跟着变，并且记得住选择', async ({ page }) => {
  await page.goto('/?lang=en');
  await expect(page.getByRole('heading', { name: 'Story Hall' })).toBeVisible();
  await expect(page.getByText('Cao Chong Weighs the Elephant')).toBeVisible();

  // 用英文内容玩一局，典故卡也应是英文
  await page.goto('/?lang=en&autoplay=1#/play/pangu');
  /* ... 通关后检查图鉴里的英文卡片、Source 标签 ... */
});