fix(i18n): 제품이 화면 언어를 자기 파일에서 선언한다

문제: 지원 locale 목록, 언어 대체, 글 방향, 문구 표, 셸의 언어
선택지가 템플릿 파일 다섯 곳에 손으로 적혀 있다. 한 언어 제품은 가짜
en-US 문구를 만들거나 템플릿 파일을 고쳐야 하고, 운영 셸 메뉴에
Pseudo·RTL 시험 locale이 보인다(0929/08-01).

고른 방법(1101 결정 (가), 템플릿이 확장 지점을 연다):
- 제품 소유 src/contracts/product-contracts.ts에 PRODUCT_LOCALES
  (기본 ko-KR, en-US)와 DEV_LOCALES(기본 en-XA, ar-EG)를 둔다.
- message-contract가 둘에서 SUPPORTED_LOCALES, 언어 대체(같은 언어의
  첫 선언 locale, 없으면 첫 제품 locale), 글 방향(RTL 언어 집합),
  DEFAULT_LOCALE을 만든다. 시험 locale은 en-US 문구를, en-US가 없으면 첫
  제품 locale 문구를 보인다.
- catalog.ts는 선언한 제품 locale마다 문구 표 하나를 둔다. en-US 표는
  en-US를 선언했을 때만 모든 키를 요구한다.
- 셸 언어 선택지는 선언에서 나오고, locale이 하나면 선택을 그리지 않는다.
  템플릿 문구에 없는 locale은 Intl.DisplayNames의 자기 이름으로 적는다.
버린 대안: 운영 환경(APP_ENV)에서 시험 locale을 자동으로 숨기기 —
presentation이 실행 환경을 읽는 포트가 없고, e2e가 production 빌드로
시험 locale을 고른다. 제품이 DEV_LOCALES를 비우는 쪽이 명시적이다.

위험·한계: ko-KR은 다른 표를 대조하는 원본이라 남겨야 한다. 템플릿에
없는 언어를 선언하면 그 문구 표가 catalog.ts에 있어야 한다(타입 오류로
알린다). 시험 locale을 빼는 것은 제품이 DEV_LOCALES를 비울 때다.

검증: desktop 결과는 PR 본문.

Refs: 0929/08-01
This commit is contained in:
DongHyeonka
2026-11-13 21:16:40 +09:00
parent 5aac37e676
commit ade1fc4a71
14 changed files with 250 additions and 68 deletions
+4 -2
View File
@@ -5,6 +5,7 @@ import { writeValidatedJsonArtifact } from "./lib/validated-json-artifact.ts";
import path from "node:path";
import { EN_MESSAGES, KO_MESSAGES, MESSAGE_CATALOGS } from "../src/presentation/i18n/catalog.ts";
import { SUPPORTED_LOCALES } from "../src/presentation/i18n/message-contract.ts";
const fixtureMode = process.argv.includes("--fixture");
const failures: string[] = [];
@@ -46,7 +47,8 @@ if (!fixtureMode) {
}
}
}
if (Object.keys(EN_MESSAGES).length !== canonicalKeys.length) {
// 0929/08-01. Only a product that ships en-US needs every key in it.
if (Object.hasOwn(MESSAGE_CATALOGS, "en-US") && Object.keys(EN_MESSAGES).length !== canonicalKeys.length) {
failures.push("en-US catalog key count does not match ko-KR");
}
}
@@ -136,7 +138,7 @@ const allowedFixtureFailures = fixtureMode
const report = i18nReportArtifactSchema.parse({
schemaVersion: 1,
mode: fixtureMode ? "negative-fixture" : "source",
localeCount: Object.keys(MESSAGE_CATALOGS).length + 1,
localeCount: SUPPORTED_LOCALES.length,
messageKeyCount: Object.keys(KO_MESSAGES).length,
checkedFiles: sources.length,
failures,