diff --git a/docs/architecture/decisions/VD-06-intl-typed-message-catalog.md b/docs/architecture/decisions/VD-06-intl-typed-message-catalog.md index 2b994271..c9e02cf4 100644 --- a/docs/architecture/decisions/VD-06-intl-typed-message-catalog.md +++ b/docs/architecture/decisions/VD-06-intl-typed-message-catalog.md @@ -21,9 +21,11 @@ JavaScript에 분산돼 있었다. 날짜는 일부 application mapper에서 고 2. `MessageKey`는 한국어 canonical catalog에서 도출하며 영어와 RTL smoke catalog는 `satisfies Record`으로 compile-time parity를 강제한다. -3. 보간이 필요한 key는 `MessageParameters`에 key별 parameter object를 - 선언한다. 잘못된 key, 누락·초과 parameter는 TypeScript negative fixture가 - 거절한다. +3. 보간 parameter는 catalog 문자열의 `{이름}`에서 도출한다(0929/08-03). + 값 타입은 `string | number`다. 값 타입을 좁히고 싶은 key만 + `MessageParameters`에 key별 parameter object를 선언한다. 기능 catalog의 + key도 같은 규칙을 쓰므로 기능이 이 파일을 고치지 않는다. 잘못된 key, + 누락·초과 parameter는 TypeScript negative fixture가 거절한다. 4. 기본 locale은 `ko-KR`, fallback locale도 `ko-KR`이다. 알려지지 않은 locale은 language fallback 후 `ko-KR`로 정규화한다. 알려지지 않은 key와 누락 보간은 raw key나 외부 값을 출력하지 않고 안전한 공통 fallback을 반환한다. diff --git a/src/features/reference-feature/presentation/reference-resource-page.tsx b/src/features/reference-feature/presentation/reference-resource-page.tsx index 16b04572..997345c6 100644 --- a/src/features/reference-feature/presentation/reference-resource-page.tsx +++ b/src/features/reference-feature/presentation/reference-resource-page.tsx @@ -5,16 +5,13 @@ import { Button, CollectionPage, } from "../../../presentation/design-system/index.ts"; -import { - resolveMessage, - useLocale, -} from "../../../presentation/i18n/index.ts"; +import { useLocale } from "../../../presentation/i18n/index.ts"; import { useReferenceFailureAction } from "./use-reference-failure-action.ts"; import { useReferenceFeature } from "./use-reference-feature.ts"; export default function ReferenceResourcePage() { const navigate = useNavigate(); - const { locale, message } = useLocale(); + const { message } = useLocale(); const { filters, query } = useReferenceFeature(); const failureAction = useReferenceFailureAction(query.state.failure); @@ -45,10 +42,9 @@ export default function ReferenceResourcePage() { } resultCount={ // 08-09. Counted only from a settled result: a loading, idle or - // failed list has nothing to count. Feature keys carry no parameter - // types, so the count goes through the untyped resolver. + // failed list has nothing to count. query.state.base === "success" || query.state.base === "empty" - ? resolveMessage(locale, "reference.list.resultCount", { + ? message("reference.list.resultCount", { count: query.data?.length ?? 0, }) : null diff --git a/src/presentation/i18n/message-contract.ts b/src/presentation/i18n/message-contract.ts index fe0b9c18..db656bb4 100644 --- a/src/presentation/i18n/message-contract.ts +++ b/src/presentation/i18n/message-contract.ts @@ -14,6 +14,26 @@ export const SUPPORTED_LOCALES = Object.freeze([ export type SupportedLocale = (typeof SUPPORTED_LOCALES)[number]; export type TextDirection = "ltr" | "rtl"; +/** + * 0929/08-03. The `{name}` placeholders of a catalog string literal. The + * catalogs are `as const`, so platform and feature keys share this one rule + * and a feature never edits this file to type its own messages. The ko-KR + * template is the source; the locale parity test keeps the others equal. + */ +type TemplatePlaceholder