From d42ad073ee2cb36480146ba766f536a5a358f8a4 Mon Sep 17 00:00:00 2001 From: DongHyeonka Date: Fri, 13 Nov 2026 18:40:13 +0900 Subject: [PATCH] =?UTF-8?q?fix(i18n):=20=EC=83=81=ED=83=9C=20=ED=99=94?= =?UTF-8?q?=EB=A9=B4=20=EB=AC=B8=EA=B5=AC=EB=A5=BC=20=EC=B5=9C=EC=A2=85=20?= =?UTF-8?q?=EC=82=AC=EC=9A=A9=EC=9E=90=20=EB=A7=90=EB=A1=9C=20=EC=93=B0?= =?UTF-8?q?=EA=B3=A0=20=EC=88=AB=EC=9E=90=C2=B7=EB=8B=A8=EC=88=98=ED=98=95?= =?UTF-8?q?=C2=B7=EB=AC=B8=EC=9E=A5=20=EC=A1=B0=EB=A6=BD=EC=9D=84=20catalo?= =?UTF-8?q?g=EC=97=90=20=EB=A7=A1=EA=B8=B4=EB=8B=A4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 화면 문구 셋이 어긋난다. - 상태 화면 문구가 템플릿 개발자용이다(04-01). 생성 기능은 모두 `session-required`라 로그인 전 최종 사용자에게 "이 화면은 인증 연동 지점을 확인하기 위한 보호 라우트입니다."가 보인다. 끈 기능 화면은 "코드에는 포함되어 있으며 운영자가 다시 켤 수 있습니다.", 연동 실패 화면은 "외부 인증 소유자가 연결되면…"이다. - 숫자를 locale formatter 없이 그린다(04-03). 생성 목록이 "총 12345개 항목"을 그리고, TextArea는 en에서 남은 1자도 "1 characters remaining"이다. - ko·en 뜻이 다르다(04-07). en `form.conflict`에 "최신 상태를 확인해 주세요"가 없고, en 문서 제목 "Page not found"와 h1 "Page not found."가 다르다. ErrorSummary가 번역 문장 사이에 JSX 글자 ": "를 넣는다. 고른 방법: 세 설명을 사용자 말("이 화면을 보려면 로그인해 주세요." 등)로 바꾸고 운영 설명은 뺐다. 생성 목록은 `useLocale().number(total)`을 넘긴다. TextArea는 `plural`로 `form.remaining.one`(en 단수)과 `form.remaining`을 고른다. en 충돌 문구에 행동을 더하고 not-found 제목을 h1과 같게 했다. 오류 요약 항목은 `form.errorSummary.item` "{label}: {message}"로 잇는다. 연동 실패 화면의 제목 "로그인 연동이 필요합니다."는 짝 백엔드 매뉴얼이 그 글자로 가리켜 그대로 뒀다. 검증 V4가 반박한 부분(세 화면에 행동 버튼이 없다, ProgressBar `%`)은 고치지 않았다: 셸 탐색이 늘 있고, `%`는 ko·en 결과가 같다. 위험·한계: 다운스트림이 이 키의 옛 문장을 시험으로 고정했으면 문장을 바꾼다. 이미 생성한 기능의 목록 페이지는 `count: query.data.total`을 그대로 갖는다. `number(query.data.total)`로 바꾸면 된다(생성 명령의 새 출력과 같다). 검증: `tests/unit/i18n-contract.test.ts`(개발자 낱말, not-found 제목, 항목 문장), `tests/component/design-system-a11y.test.tsx`(en 단수·복수), `tests/unit/create-feature.test.ts`(생성 목록의 `number(`)가 고치기 전에 실패하고 고친 뒤 통과한다. 생성 기능 시험의 total 12345 → "총 12,345개 항목"은 FE-GATE-005가 돌린다(desktop, PR 본문). Refs: 1112/04-01, 1112/04-03, 1112/04-07 --- scripts/create-feature.ts | 11 ++++--- .../design-system/primitives/text-area.tsx | 7 ++-- src/presentation/forms/form-components.tsx | 7 ++-- src/presentation/i18n/catalog.ts | 20 +++++++----- src/presentation/i18n/message-contract.ts | 1 + tests/component/design-system-a11y.test.tsx | 24 ++++++++++++++ tests/component/router.test.tsx | 2 +- tests/unit/create-feature.test.ts | 5 +-- tests/unit/i18n-contract.test.ts | 32 +++++++++++++++++++ 9 files changed, 90 insertions(+), 19 deletions(-) diff --git a/scripts/create-feature.ts b/scripts/create-feature.ts index a68fe5a2..5d4c39bf 100644 --- a/scripts/create-feature.ts +++ b/scripts/create-feature.ts @@ -1182,7 +1182,7 @@ ${write ? `import { ${camel}RouteUrl } from "./${base}-routes.ts";\n` : ""}impor * the page heading. */ export default function ${pascal}ListPage() { - const { message } = useLocale(); + const { message, number } = useLocale(); const query = use${pascal}Items(); return ( @@ -1348,13 +1350,14 @@ describe("${names.id} list page through the router", () => { HttpResponse.json({ success: true, data: [{ id: "item-1", name: "First item" }], - meta: { page: { number: 0, size: 20, total: 41, sort: null } }, + meta: { page: { number: 0, size: 20, total: 12345, sort: null } }, }), ), ); await openList(); - expect(await screen.findByText("총 41개 항목")).toBeVisible(); + // 1112/04-03. The count is a locale-formatted number. + expect(await screen.findByText("총 12,345개 항목")).toBeVisible(); }); // The backend answers an empty list as \`data: []\`, never by dropping \`data\`. diff --git a/src/presentation/design-system/primitives/text-area.tsx b/src/presentation/design-system/primitives/text-area.tsx index 99e4beac..e31d4dc7 100644 --- a/src/presentation/design-system/primitives/text-area.tsx +++ b/src/presentation/design-system/primitives/text-area.tsx @@ -27,7 +27,7 @@ export const TextArea = forwardRef( }, ref, ) { - const { message } = useLocale(); + const { message, plural } = useLocale(); const [uncontrolledValue, setUncontrolledValue] = useState( String(defaultValue ?? ""), ); @@ -55,7 +55,10 @@ export const TextArea = forwardRef( ? null : maxLengthMessage ? maxLengthMessage(remaining) - : message("form.remaining", { count: remaining }); + : plural(remaining, { + one: message("form.remaining.one", { count: remaining }), + other: message("form.remaining", { count: remaining }), + }); return ( <>