From ade1fc4a7150bdbb6fdefbde9675d93765980f0a Mon Sep 17 00:00:00 2001 From: DongHyeonka Date: Fri, 13 Nov 2026 19:30:39 +0900 Subject: [PATCH] =?UTF-8?q?fix(i18n):=20=EC=A0=9C=ED=92=88=EC=9D=B4=20?= =?UTF-8?q?=ED=99=94=EB=A9=B4=20=EC=96=B8=EC=96=B4=EB=A5=BC=20=EC=9E=90?= =?UTF-8?q?=EA=B8=B0=20=ED=8C=8C=EC=9D=BC=EC=97=90=EC=84=9C=20=EC=84=A0?= =?UTF-8?q?=EC=96=B8=ED=95=9C=EB=8B=A4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 문제: 지원 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 --- docs/manual/03-outside-feature-folder.md | 5 +- scripts/check-i18n.ts | 6 +- src/contracts/product-contracts.ts | 15 +++ src/features/installed-feature-messages.ts | 13 +++ src/presentation/i18n/catalog.ts | 33 ++++++- src/presentation/i18n/index.ts | 4 + src/presentation/i18n/locale-provider.tsx | 6 +- src/presentation/i18n/message-contract.ts | 96 +++++++++++++++---- src/presentation/layouts/app-shell.tsx | 34 ++++--- .../providers/preference-providers.tsx | 4 +- tests/component/locale-platform.test.tsx | 4 +- tests/component/render-boundary.test.tsx | 4 +- tests/unit/i18n-contract.test.ts | 44 +++++---- tests/unit/product-locales.test.ts | 50 ++++++++++ 14 files changed, 250 insertions(+), 68 deletions(-) create mode 100644 tests/unit/product-locales.test.ts diff --git a/docs/manual/03-outside-feature-folder.md b/docs/manual/03-outside-feature-folder.md index 16e92bd7..6f114e97 100644 --- a/docs/manual/03-outside-feature-folder.md +++ b/docs/manual/03-outside-feature-folder.md @@ -123,10 +123,13 @@ release admission refused for staging: - `close`가 던지면 scope가 `FAILED`에 머물고 모든 서버 요청이 `SCOPE_FENCED`로 막힌다. 진단 `cache.operation.failed`에 `reason: PARTICIPANT_FAILED`와 `scope_participant: