From b96d61d8f773855257b66d219e1ea2c33059fcb9 Mon Sep 17 00:00:00 2001
From: DongHyeonka
Date: Wed, 4 Nov 2026 21:49:41 +0900
Subject: [PATCH] =?UTF-8?q?feat(examples)!:=20=EC=98=88=EC=A0=9C=20?=
=?UTF-8?q?=ED=99=94=EB=A9=B4=203=EA=B0=9C=EB=A5=BC=20=EB=81=8C=20?=
=?UTF-8?q?=EC=88=98=20=EC=9E=88=EB=8A=94=20=EA=B8=B0=EB=8A=A5=EC=9C=BC?=
=?UTF-8?q?=EB=A1=9C=20=EC=98=AE=EA=B8=B4=EB=8B=A4?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
문제
/examples/ui, /examples/states, /examples/auth(와 /examples/platform)는
플랫폼 라우트 레지스트리에 고정이었다. VITE_PRODUCT_FEATURES와
FEATURE_OVERRIDES는 기능만 빼므로 제품은 이 화면을 끌 수 없었다.
릴리스 게이트 FE-GATE-028은 ROUTE_REGISTRY의 모든 라우트에 서명된
수동 접근성 기록을 요구해서, 제품은 템플릿 갤러리를 운영 메뉴에 두고
서명하거나 템플릿 파일 5개와 src/presentation/examples/를 지워야 했다.
고른 방법
- UI 갤러리·화면 상태·인증 연동을 platform-examples-feature로 옮겼다.
자기 context platform-examples-context(루트 examples/*)에 산다.
reference-context의 examples/reference-resources/*와 플랫폼 라우트
/examples/platform이 더 구체적이라 그 URL은 그대로 간다.
- 라우트 ID·경로·청크 ID·표면은 바꾸지 않았다. 시각·e2e 테스트와 a11y
기록(artifacts/tests/a11y-manual/EXAMPLES_*.md)이 그대로 이 이름을
쓴다. 기능을 빼면 a11y 목록은 ROUTE_REGISTRY에서 오므로 같이 빠진다.
- 실행부는 비어 있다(스키마·adapter·계약 기여 없음). 페이지는 context
routes에서 페이지마다 lazy로 받는다.
- 플랫폼 구성 화면(EXAMPLES_PLATFORM)은 플랫폼 라우트로 남겼다. 처음에는
같이 옮겼다. 같은 호스트·같은 부하(15~19)에서 d99301b와 번갈아 잰
lab이 기능 라우트로는 443·432 ms FAIL이었다(d99301b 133·183 ms
PASS). 기능 라우트의 첫 진입은 context routes 모듈을 받은 뒤에 페이지
청크를 받는다(요청 추적: 939 B + 177 B 다음에 5,183 B + 3개). 페이지를
routes 모듈에 정적으로 넣으면 릴리스 매니페스트의 routeChunks 계약
(페이지마다 dynamic entry)이 깨진다. 15-01의 "예산을 올리지 않는다"를
지키려고 이 한 화면은 남겼다.
- 홈 화면은 예제 라우트 ID를 적지 않는다. 내비게이션의 처음 세 화면을
"{title} 보기"로 보여 준다. 템플릿에서는 예전과 같은 세 링크(플랫폼
구성·UI 구성요소·화면 상태)가 나오고, 예제를 뺀 제품에서는 그 제품의
화면이 나온다. home.starter.platform·ui·states 키를 home.starter.open
하나로 바꿨다. VITE_PRODUCT_FEATURES=none 빌드 검사
(product-feature-selection-build)가 홈 청크의 예제 라우트 ID를 잡았다.
- 예제 화면 component 테스트는 tests/features/platform-examples-feature/로
옮겼다. 제거 드릴이 같이 지운다. runtime-adapters 테스트는 API가 있는
기능만 센다(예제 기능은 API가 없다). context-route-roots 테스트의
"플랫폼 라우트와 같은 경로" 예는 /examples/platform으로 바꿨다.
- old-tab-chunk-recovery e2e는 페이지 소스를 빌드 A의 Vite manifest에서
찾는다(기능 폴더 이름을 적지 않음). UI 갤러리가 기능 라우트라 B 탭이
잃는 청크는 그 context routes 모듈이다. 허용 패턴에 넣었다.
- 예제 화면 문구는 08-07대로 한국어 고정이다. 화면 문구 ESLint 규칙의
예외에 새 폴더를 넣었다.
- 버린 대안: 빌드 변수로 숨김(선택 장치가 하나 더 생김), 예제 화면만
제품이 지우게 둠(동기화 충돌 자리가 남음).
위험·한계
- 공개 경로가 바뀌었다. src/presentation/examples/{ui-gallery,
state-gallery,auth-example}-page.tsx, PLATFORM_ROUTE_REGISTRY·
PLATFORM_ROUTE_RUNTIME(_CONTRACT)의 EXAMPLES_UI·STATES·AUTH,
home.starter.platform/ui/states 키를 쓰던 다운스트림은 깨진다.
- 플랫폼 구성 화면은 여전히 끌 수 없고 FE-GATE-028 서명 대상이다.
- tests/e2e와 tests/visual의 여러 spec이 예제 화면을 자기 페이지로 쓴다.
예제를 뺀 제품은 그 spec을 자기 화면으로 바꾸거나 지워야 한다
(starter-experience.md에 적음). 제거 드릴은 브라우저 테스트를 돌리지
않아 이것을 보지 않는다.
- 예제 기능 제거 드릴은 16-02(빈 ciScripts로 CI 기준선 사유가 공백)
때문에 그대로는 시작하자마자 실패한다. 아래 드릴 결과는 그 한 줄을
임시로 고친 상태에서 낸 것이다(커밋하지 않음).
- 기능 라우트 첫 진입이 이 lab 조건에서 약 430 ms라는 것은 어느 게이트도
재지 않는다.
검증
- product-feature-selection-build(VITE_PRODUCT_FEATURES=none 빌드):
홈 청크의 예제 라우트 ID 3건으로 실패한 것을 확인하고 홈 화면을 고친
뒤 통과.
- test:sample-removal -- --feature=platform-examples-feature(heavy lock,
16-02 한 줄 임시 패치): PASS, 13 checks(typecheck, architecture,
registries, test:all, coverage, test-evidence, ci, home-smoke, build,
route-absent, 잔여 ID 0). 첫 시도에서는 lab-performance 단위 테스트가
측정 라우트 조회가 포트 검사보다 먼저여서 실패했다(그 뒤 이 변경에서
측정 라우트를 플랫폼에 남겨 조회 변경 자체를 뺐다).
- test:unit 2,587, test:component 253, tests/features·platform·
architecture 383 통과. check:types, lint, check:architecture,
check:i18n, check:registries(additive), verify:documentation 통과.
- test:e2e 세 엔진 187 passed, 3 skipped(Firefox SW quarantine).
old-tab-chunk-recovery 포함. test:a11y 60 passed.
- build + check:bundle: 초기 JS 201,940 / 204,800 B(+92 B).
- lab(측정 라우트를 기능으로 옮긴 시도): 443·432 ms FAIL, 같은 묶음
d99301b 133·183 ms PASS(부하 15~19). 남긴 뒤 136·134 ms PASS.
Refs: docs/reviews/2026-11-03-maturity-review/09-app-core.md 09-04
BREAKING CHANGE: 예제 라우트 EXAMPLES_UI·EXAMPLES_STATES·EXAMPLES_AUTH가
플랫폼 레지스트리에서 platform-examples-feature로 옮겨졌다. 페이지 파일은
src/features/platform-examples-feature/presentation/으로 갔고,
PLATFORM_ROUTE_REGISTRY·PLATFORM_ROUTE_RUNTIME_CONTRACT·
PLATFORM_ROUTE_RUNTIME에 이 키들이 없다. 홈 문구 키
home.starter.platform·ui·states는 home.starter.open({title})로 바뀌었다.
예제를 지운 다운스트림은 이 기능 폴더와 context를 지우면 된다.
---
.../VD-06-intl-typed-message-catalog.md | 7 +-
docs/architecture/starter-experience.md | 34 +++++--
eslint.config.ts | 13 ++-
public/release-manifest.json | 6 +-
scripts/check-i18n.ts | 5 +-
.../context-module.ts | 12 +++
src/contracts/route-runtime-contract.ts | 18 ----
src/contracts/routes.ts | 39 --------
.../context-routes.ts | 17 ++++
.../contracts/platform-examples-contract.ts | 82 +++++++++++++++
.../platform-examples-message-catalog.ts | 23 +++++
.../feature-module.ts | 27 +++++
.../feature-runtime.ts | 13 +++
.../presentation}/auth-example-page.tsx | 4 +-
.../presentation/platform-examples-runtime.ts | 17 ++++
.../presentation}/state-gallery-page.tsx | 6 +-
.../presentation}/ui-gallery-page.tsx | 2 +-
src/presentation/i18n/catalog.ts | 24 +----
src/presentation/pages/home-page.tsx | 60 ++++++-----
src/presentation/routes/route-runtime.tsx | 12 ---
.../architecture/context-route-roots.test.ts | 8 +-
tests/component/starter-pages.test.tsx | 45 ++-------
tests/e2e/old-tab-chunk-recovery.spec.ts | 99 +++++++++++++++----
.../example-pages.test.tsx | 80 +++++++++++++++
.../ui-gallery-page.test.tsx} | 8 +-
tests/unit/runtime-adapters.test.ts | 21 +++-
26 files changed, 473 insertions(+), 209 deletions(-)
create mode 100644 src/contexts/platform-examples-context/context-module.ts
create mode 100644 src/features/platform-examples-feature/context-routes.ts
create mode 100644 src/features/platform-examples-feature/contracts/platform-examples-contract.ts
create mode 100644 src/features/platform-examples-feature/contracts/platform-examples-message-catalog.ts
create mode 100644 src/features/platform-examples-feature/feature-module.ts
create mode 100644 src/features/platform-examples-feature/feature-runtime.ts
rename src/{presentation/examples => features/platform-examples-feature/presentation}/auth-example-page.tsx (93%)
create mode 100644 src/features/platform-examples-feature/presentation/platform-examples-runtime.ts
rename src/{presentation/examples => features/platform-examples-feature/presentation}/state-gallery-page.tsx (94%)
rename src/{presentation/examples => features/platform-examples-feature/presentation}/ui-gallery-page.tsx (99%)
create mode 100644 tests/features/platform-examples-feature/example-pages.test.tsx
rename tests/{component/starter-ui-gallery-page.test.tsx => features/platform-examples-feature/ui-gallery-page.test.tsx} (96%)
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 66b0a112..9268cff4 100644
--- a/docs/architecture/decisions/VD-06-intl-typed-message-catalog.md
+++ b/docs/architecture/decisions/VD-06-intl-typed-message-catalog.md
@@ -70,9 +70,10 @@ route/form/failure 의미 값
- `check:i18n`은 catalog key와 placeholder parity, backend message JSX 렌더링을
검사한다. 검사 범위는 공통 UI 디렉터리, `src/presentation/pages`, 모든
- `src/features/*/presentation`이다. 컴포넌트 갤러리 `src/presentation/examples`는
- 일부러 뺐다(`scripts/check-i18n.ts`의 `commonDirectories`,
- `featurePresentationDirectories`).
+ `src/features/*/presentation`이다. 플랫폼 구성 화면
+ `src/presentation/examples`와 예제 화면
+ `src/features/platform-examples-feature/presentation`(1103/09-04)은 화면
+ 문구 ESLint 규칙에서 일부러 뺐다(`eslint.config.ts`).
- 화면 문구가 catalog에서 오는지는 ESLint `no-restricted-syntax`가 본다
(`eslint.config.ts`의 `screenTextSelectors`, 0929/08-02). 대상은 글자가 든
`JSXText`와 표시·접근성 속성(`aria-label`, `title`, `placeholder`, `alt`,
diff --git a/docs/architecture/starter-experience.md b/docs/architecture/starter-experience.md
index bf356b57..d7775b40 100644
--- a/docs/architecture/starter-experience.md
+++ b/docs/architecture/starter-experience.md
@@ -85,14 +85,32 @@ rather than adding another independent route or data-loading convention.
### Replacing the starter screens
-`/` (`src/presentation/pages/home-page.tsx`) and `/examples/*`
-(`src/presentation/examples/`) are template content. Their own tests are the
-`tests/component/starter-*.test.tsx` files; delete them together with the
-screens. The platform's component tests (router, boundaries, shell, runtime
-tree) run on the pages of the test-only feature in
-`tests/helpers/fixture-feature.tsx` and keep passing when the starter screens
-change. Browser-level checks of the starter screens stay in `tests/e2e` and
-`tests/visual`.
+`/` (`src/presentation/pages/home-page.tsx`) is the platform's `APP_HOME`; a
+feature takes it over by declaring that route id (see "Product home and
+layouts"). Its starter links are the first three screens of the navigation.
+
+The example screens `/examples/ui`, `/examples/states` and `/examples/auth`
+are one feature, `src/features/platform-examples-feature/`, in its own context
+`src/contexts/platform-examples-context/` (1103/09-04). A product turns them
+off like any feature: leave the id out of `VITE_PRODUCT_FEATURES`, or remove
+it with `corepack pnpm test:sample-removal -- --feature=platform-examples-feature`
+as the drill. Their routes then leave the registry, the navigation, the
+bundle and the manual accessibility list (FE-GATE-028). Their component tests
+are in `tests/features/platform-examples-feature/` and go with them.
+
+The platform overview (`/examples/platform`,
+`src/presentation/examples/platform-overview-page.tsx`) stays a platform
+route. It describes the installed registries, and the lab gate (FE-GATE-026)
+times entering it: a feature route's first entry also loads its context's
+routes module before the page, a second request round the 200 ms budget does
+not fit. Its tests are the `tests/component/starter-*.test.tsx` files.
+
+The platform's component tests (router, boundaries, shell, runtime tree) run
+on the pages of the test-only feature in `tests/helpers/fixture-feature.tsx`
+and keep passing without the examples. The browser-level checks in
+`tests/e2e` and `tests/visual` use the example screens as their pages and run
+where the examples are installed: a product that leaves them out points those
+specs at its own screens or deletes them.
### Ownership declarations
diff --git a/eslint.config.ts b/eslint.config.ts
index 2e55d3c6..4d9f6f4c 100644
--- a/eslint.config.ts
+++ b/eslint.config.ts
@@ -458,8 +458,9 @@ const hookRules = {
// template literal, a ternary, an object prop such as `heading.title`) is not
// seen; review catches those. A product replaces these selectors in its own
// config, for example to allow a brand name or to drop the rule for a
-// one-locale product. The component gallery (src/presentation/examples) and
-// stories are workshop code and stay out; tests are outside these folders.
+// one-locale product. The platform overview (src/presentation/examples),
+// the example screens (src/features/platform-examples-feature/presentation)
+// and stories are workshop code and stay out; tests are outside these folders.
const screenTextDirectories = [
"src/presentation/boundaries",
"src/presentation/components",
@@ -911,7 +912,13 @@ export default [
`${directory}/**/*.tsx`,
`tests/fixtures/i18n/*/${directory}/**/*.tsx`,
]),
- ignores: ["**/*.stories.tsx"],
+ // 1103/09-04. The example screens moved from src/presentation/examples
+ // into this feature and stay workshop code: their copy is Korean in every
+ // locale on purpose (08-07).
+ ignores: [
+ "**/*.stories.tsx",
+ "src/features/platform-examples-feature/presentation/**",
+ ],
rules: {
"no-restricted-syntax": [
...commonSecurityRules["no-restricted-syntax"],
diff --git a/public/release-manifest.json b/public/release-manifest.json
index 8c0005fa..471e2dd2 100644
--- a/public/release-manifest.json
+++ b/public/release-manifest.json
@@ -10,9 +10,9 @@
"routeChunks": {
"route-home": "src/presentation/pages/home-page.tsx",
"route-examples-platform": "src/presentation/examples/platform-overview-page.tsx",
- "route-examples-ui": "src/presentation/examples/ui-gallery-page.tsx",
- "route-examples-states": "src/presentation/examples/state-gallery-page.tsx",
- "route-examples-auth": "src/presentation/examples/auth-example-page.tsx",
+ "route-examples-ui": "src/features/platform-examples-feature/presentation/ui-gallery-page.tsx",
+ "route-examples-states": "src/features/platform-examples-feature/presentation/state-gallery-page.tsx",
+ "route-examples-auth": "src/features/platform-examples-feature/presentation/auth-example-page.tsx",
"route-reference-resources": "src/features/reference-feature/presentation/reference-resource-page.tsx",
"route-reference-resource-detail": "src/features/reference-feature/presentation/reference-resource-detail-page.tsx",
"route-reference-resource-form": "src/features/reference-feature/presentation/reference-resource-form-page.tsx",
diff --git a/scripts/check-i18n.ts b/scripts/check-i18n.ts
index 438b2680..0c2c04c7 100644
--- a/scripts/check-i18n.ts
+++ b/scripts/check-i18n.ts
@@ -59,8 +59,9 @@ if (!fixtureMode) {
// from an ordinary `.message` read. Fixture mode runs the ESLint rule on the
// fixture trees too, so this one gate shows the whole i18n contract rejecting
// every forbidden file and passing the allowed one.
-// `src/presentation/examples` is the component gallery and stays out of scope
-// on purpose.
+// `src/presentation/examples` (the platform overview) and the example
+// screens (`src/features/platform-examples-feature/presentation`, 1103/09-04)
+// are workshop code and stay out of the ESLint rule's scope on purpose.
const forbiddenFixtureRoot = "tests/fixtures/i18n/forbidden";
const allowedFixtureRoot = "tests/fixtures/i18n/allowed";
const sourceRoot = fixtureMode ? forbiddenFixtureRoot : ".";
diff --git a/src/contexts/platform-examples-context/context-module.ts b/src/contexts/platform-examples-context/context-module.ts
new file mode 100644
index 00000000..7e9b32a0
--- /dev/null
+++ b/src/contexts/platform-examples-context/context-module.ts
@@ -0,0 +1,12 @@
+/**
+ * 1103/09-04. The template's example screens (UI gallery, screen states,
+ * auth integration) as one removable bounded context. A product leaves
+ * `platform-examples-feature` out of `VITE_PRODUCT_FEATURES`, or deletes it,
+ * and the three routes leave the registry, the navigation, the bundle and the
+ * manual accessibility list together. The root is `examples/*`;
+ * `reference-context` keeps the more specific `examples/reference-resources/*`.
+ */
+export const CONTEXT_MODULE_ID = "platform-examples-context";
+export const CONTEXT_APP_ID = "template-app";
+export const CONTEXT_ROUTE_PATH = "examples/*";
+export const CONTEXT_MAX_FEATURES = 1;
diff --git a/src/contracts/route-runtime-contract.ts b/src/contracts/route-runtime-contract.ts
index ddbbdfa4..11c26d8a 100644
--- a/src/contracts/route-runtime-contract.ts
+++ b/src/contracts/route-runtime-contract.ts
@@ -23,24 +23,6 @@ export const PLATFORM_ROUTE_RUNTIME_CONTRACT = Object.freeze({
paramsCodec: "none",
searchCodec: "none",
}),
- EXAMPLES_UI: runtime({
- routeId: "EXAMPLES_UI",
- moduleId: "ui-gallery-page",
- paramsCodec: "none",
- searchCodec: "none",
- }),
- EXAMPLES_STATES: runtime({
- routeId: "EXAMPLES_STATES",
- moduleId: "state-gallery-page",
- paramsCodec: "none",
- searchCodec: "none",
- }),
- EXAMPLES_AUTH: runtime({
- routeId: "EXAMPLES_AUTH",
- moduleId: "auth-example-page",
- paramsCodec: "none",
- searchCodec: "none",
- }),
NOT_FOUND: runtime({
routeId: "NOT_FOUND",
moduleId: "not-found-page",
diff --git a/src/contracts/routes.ts b/src/contracts/routes.ts
index e4bcf431..53c79862 100644
--- a/src/contracts/routes.ts
+++ b/src/contracts/routes.ts
@@ -43,45 +43,6 @@ export const PLATFORM_ROUTE_REGISTRY = Object.freeze({
navigationLabel: "플랫폼 구성",
navigationOrder: 15,
}),
- EXAMPLES_UI: route({
- routeId: "EXAMPLES_UI",
- path: "/examples/ui",
- paramsSchema: null,
- searchSchema: null,
- access: "public",
- loadingSurface: "example-page",
- errorSurface: "route-boundary",
- chunkId: "route-examples-ui",
- title: "UI 구성요소",
- navigationLabel: "UI 구성요소",
- navigationOrder: 20,
- }),
- EXAMPLES_STATES: route({
- routeId: "EXAMPLES_STATES",
- path: "/examples/states",
- paramsSchema: null,
- searchSchema: null,
- access: "public",
- loadingSurface: "example-page",
- errorSurface: "route-boundary",
- chunkId: "route-examples-states",
- title: "화면 상태",
- navigationLabel: "화면 상태",
- navigationOrder: 30,
- }),
- EXAMPLES_AUTH: route({
- routeId: "EXAMPLES_AUTH",
- path: "/examples/auth",
- paramsSchema: null,
- searchSchema: null,
- access: "public",
- loadingSurface: "example-page",
- errorSurface: "route-boundary",
- chunkId: "route-examples-auth",
- title: "인증 연동",
- navigationLabel: "인증 연동",
- navigationOrder: 40,
- }),
NOT_FOUND: route({
routeId: "NOT_FOUND",
path: "*",
diff --git a/src/features/platform-examples-feature/context-routes.ts b/src/features/platform-examples-feature/context-routes.ts
new file mode 100644
index 00000000..1e332afe
--- /dev/null
+++ b/src/features/platform-examples-feature/context-routes.ts
@@ -0,0 +1,17 @@
+import type { RouteObject } from "react-router-dom";
+
+import { PLATFORM_EXAMPLES_CONTRACT } from "./contracts/platform-examples-contract.ts";
+import { PLATFORM_EXAMPLES_ROUTE_RUNTIME } from "./presentation/platform-examples-runtime.ts";
+
+export const FEATURE_CONTEXT_ROUTES: readonly RouteObject[] = Object.freeze(
+ Object.values(PLATFORM_EXAMPLES_CONTRACT.routes).map((definition) =>
+ Object.freeze({
+ id: definition.routeId,
+ path: definition.path,
+ handle: Object.freeze({
+ routeId: definition.routeId,
+ runtime: PLATFORM_EXAMPLES_ROUTE_RUNTIME[definition.routeId],
+ }),
+ }),
+ ),
+);
diff --git a/src/features/platform-examples-feature/contracts/platform-examples-contract.ts b/src/features/platform-examples-feature/contracts/platform-examples-contract.ts
new file mode 100644
index 00000000..e98498e4
--- /dev/null
+++ b/src/features/platform-examples-feature/contracts/platform-examples-contract.ts
@@ -0,0 +1,82 @@
+export const PLATFORM_EXAMPLES_FEATURE_ID = "platform-examples-feature";
+
+/**
+ * 1103/09-04. Three of the template's example screens, formerly fixed
+ * platform routes. The platform overview (`EXAMPLES_PLATFORM`) stays a
+ * platform route: the lab gate (FE-GATE-026) times entering it, and a feature
+ * route's first entry costs a second request round (its context's routes
+ * module, then the page). Paths, chunk ids and surfaces are unchanged: the
+ * visual and e2e tests and the manual accessibility records still name them.
+ * Declaration only, so it holds data; the pages load with `context-routes.ts`.
+ */
+export const PLATFORM_EXAMPLES_CONTRACT = Object.freeze({
+ featureId: PLATFORM_EXAMPLES_FEATURE_ID,
+ routes: Object.freeze({
+ EXAMPLES_UI: Object.freeze({
+ routeId: "EXAMPLES_UI",
+ path: "/examples/ui",
+ paramsSchema: null,
+ searchSchema: null,
+ access: "public",
+ loadingSurface: "example-page",
+ errorSurface: "route-boundary",
+ chunkId: "route-examples-ui",
+ title: "UI 구성요소",
+ navigationLabel: "UI 구성요소",
+ navigationOrder: 20,
+ }),
+ EXAMPLES_STATES: Object.freeze({
+ routeId: "EXAMPLES_STATES",
+ path: "/examples/states",
+ paramsSchema: null,
+ searchSchema: null,
+ access: "public",
+ loadingSurface: "example-page",
+ errorSurface: "route-boundary",
+ chunkId: "route-examples-states",
+ title: "화면 상태",
+ navigationLabel: "화면 상태",
+ navigationOrder: 30,
+ }),
+ EXAMPLES_AUTH: Object.freeze({
+ routeId: "EXAMPLES_AUTH",
+ path: "/examples/auth",
+ paramsSchema: null,
+ searchSchema: null,
+ access: "public",
+ loadingSurface: "example-page",
+ errorSurface: "route-boundary",
+ chunkId: "route-examples-auth",
+ title: "인증 연동",
+ navigationLabel: "인증 연동",
+ navigationOrder: 40,
+ }),
+ }),
+ routeRuntimeContracts: Object.freeze({
+ EXAMPLES_UI: Object.freeze({
+ routeId: "EXAMPLES_UI",
+ moduleId: "ui-gallery-page",
+ paramsCodec: "none",
+ searchCodec: "none",
+ }),
+ EXAMPLES_STATES: Object.freeze({
+ routeId: "EXAMPLES_STATES",
+ moduleId: "state-gallery-page",
+ paramsCodec: "none",
+ searchCodec: "none",
+ }),
+ EXAMPLES_AUTH: Object.freeze({
+ routeId: "EXAMPLES_AUTH",
+ moduleId: "auth-example-page",
+ paramsCodec: "none",
+ searchCodec: "none",
+ }),
+ }),
+ invalidation: Object.freeze({
+ topics: Object.freeze([]),
+ namespaces: Object.freeze([]),
+ edges: Object.freeze([]),
+ }),
+ topicVersions: Object.freeze([]),
+ contractPackages: Object.freeze([]),
+} as const);
diff --git a/src/features/platform-examples-feature/contracts/platform-examples-message-catalog.ts b/src/features/platform-examples-feature/contracts/platform-examples-message-catalog.ts
new file mode 100644
index 00000000..310c98d4
--- /dev/null
+++ b/src/features/platform-examples-feature/contracts/platform-examples-message-catalog.ts
@@ -0,0 +1,23 @@
+/**
+ * 1103/09-04. The route titles and navigation labels the shell reads; they
+ * moved here from the platform catalog with the routes. The pages' own copy
+ * stays Korean in every locale (08-07).
+ */
+export const PLATFORM_EXAMPLES_MESSAGE_CATALOGS = Object.freeze({
+ "ko-KR": Object.freeze({
+ "route.EXAMPLES_UI.navigation": "UI 구성요소",
+ "route.EXAMPLES_UI.title": "UI 구성요소",
+ "route.EXAMPLES_STATES.navigation": "화면 상태",
+ "route.EXAMPLES_STATES.title": "화면 상태",
+ "route.EXAMPLES_AUTH.navigation": "인증 연동",
+ "route.EXAMPLES_AUTH.title": "인증 연동",
+ }),
+ "en-US": Object.freeze({
+ "route.EXAMPLES_UI.navigation": "UI components",
+ "route.EXAMPLES_UI.title": "UI components",
+ "route.EXAMPLES_STATES.navigation": "Screen states",
+ "route.EXAMPLES_STATES.title": "Screen states",
+ "route.EXAMPLES_AUTH.navigation": "Authentication",
+ "route.EXAMPLES_AUTH.title": "Authentication",
+ }),
+} as const);
diff --git a/src/features/platform-examples-feature/feature-module.ts b/src/features/platform-examples-feature/feature-module.ts
new file mode 100644
index 00000000..7d7b3fc4
--- /dev/null
+++ b/src/features/platform-examples-feature/feature-module.ts
@@ -0,0 +1,27 @@
+import { defineFeatureModule } from "../feature-module.ts";
+import {
+ PLATFORM_EXAMPLES_CONTRACT,
+ PLATFORM_EXAMPLES_FEATURE_ID,
+} from "./contracts/platform-examples-contract.ts";
+import { PLATFORM_EXAMPLES_MESSAGE_CATALOGS } from "./contracts/platform-examples-message-catalog.ts";
+
+export const FEATURE_MODULE_ID =
+ "platform-examples-feature" satisfies typeof PLATFORM_EXAMPLES_FEATURE_ID;
+/** Owning bounded context (route root and budget live in its declaration). */
+export const FEATURE_CONTEXT_ID = "platform-examples-context";
+
+/**
+ * 1103/09-04. The template's example screens as a feature, so the product's
+ * feature selection, `FEATURE_OVERRIDES`, the removal drill and the manual
+ * accessibility list apply to them like to any feature. Declaration only:
+ * the pages load with the context routes, and the runtime half is empty.
+ */
+export const PLATFORM_EXAMPLES_FEATURE_MODULE = defineFeatureModule({
+ id: FEATURE_MODULE_ID,
+ contracts: PLATFORM_EXAMPLES_CONTRACT,
+ routes: PLATFORM_EXAMPLES_CONTRACT.routes,
+ messages: PLATFORM_EXAMPLES_MESSAGE_CATALOGS,
+ loadRuntime: async () => (await import("./feature-runtime.ts")).FEATURE_RUNTIME,
+} as const);
+
+export const FEATURE_MODULE = PLATFORM_EXAMPLES_FEATURE_MODULE;
diff --git a/src/features/platform-examples-feature/feature-runtime.ts b/src/features/platform-examples-feature/feature-runtime.ts
new file mode 100644
index 00000000..7ab57e96
--- /dev/null
+++ b/src/features/platform-examples-feature/feature-runtime.ts
@@ -0,0 +1,13 @@
+import { defineFeatureRuntime } from "../feature-module.ts";
+import { PLATFORM_EXAMPLES_FEATURE_ID } from "./contracts/platform-examples-contract.ts";
+
+/**
+ * 1103/09-04. The example screens call no feature API: they show the
+ * design system and the shell's session. The runtime half is empty.
+ */
+export const FEATURE_RUNTIME = defineFeatureRuntime({
+ featureId: PLATFORM_EXAMPLES_FEATURE_ID,
+ schemas: Object.freeze({}),
+ adapters: [],
+ contractContributions: [],
+} as const);
diff --git a/src/presentation/examples/auth-example-page.tsx b/src/features/platform-examples-feature/presentation/auth-example-page.tsx
similarity index 93%
rename from src/presentation/examples/auth-example-page.tsx
rename to src/features/platform-examples-feature/presentation/auth-example-page.tsx
index f8419f2e..b7dcf908 100644
--- a/src/presentation/examples/auth-example-page.tsx
+++ b/src/features/platform-examples-feature/presentation/auth-example-page.tsx
@@ -1,8 +1,8 @@
-import { PageHeader } from "../design-system/index.ts";
+import { PageHeader } from "../../../presentation/design-system/index.ts";
import {
useSession,
useSessionAction,
-} from "../providers/session-provider.tsx";
+} from "../../../presentation/providers/session-provider.tsx";
export default function AuthExamplePage() {
const { sessionState } = useSession();
diff --git a/src/features/platform-examples-feature/presentation/platform-examples-runtime.ts b/src/features/platform-examples-feature/presentation/platform-examples-runtime.ts
new file mode 100644
index 00000000..36447dd8
--- /dev/null
+++ b/src/features/platform-examples-feature/presentation/platform-examples-runtime.ts
@@ -0,0 +1,17 @@
+import { lazy } from "react";
+
+/** One lazy chunk per example page, as when they were platform routes. */
+export const PLATFORM_EXAMPLES_ROUTE_RUNTIME = {
+ EXAMPLES_UI: Object.freeze({
+ moduleId: "ui-gallery-page",
+ Component: lazy(() => import("./ui-gallery-page.tsx")),
+ }),
+ EXAMPLES_STATES: Object.freeze({
+ moduleId: "state-gallery-page",
+ Component: lazy(() => import("./state-gallery-page.tsx")),
+ }),
+ EXAMPLES_AUTH: Object.freeze({
+ moduleId: "auth-example-page",
+ Component: lazy(() => import("./auth-example-page.tsx")),
+ }),
+} as const;
diff --git a/src/presentation/examples/state-gallery-page.tsx b/src/features/platform-examples-feature/presentation/state-gallery-page.tsx
similarity index 94%
rename from src/presentation/examples/state-gallery-page.tsx
rename to src/features/platform-examples-feature/presentation/state-gallery-page.tsx
index 24f77029..ceec9a9e 100644
--- a/src/presentation/examples/state-gallery-page.tsx
+++ b/src/features/platform-examples-feature/presentation/state-gallery-page.tsx
@@ -1,7 +1,7 @@
import { useState } from "react";
-import { deriveAsyncState } from "../../application/view-models/async-state.ts";
-import { createFailure } from "../../contracts/errors.ts";
+import { deriveAsyncState } from "../../../application/view-models/async-state.ts";
+import { createFailure } from "../../../contracts/errors.ts";
import {
AsyncSurface,
EmptySurface,
@@ -13,7 +13,7 @@ import {
Button,
Card,
PageHeader,
-} from "../design-system/index.ts";
+} from "../../../presentation/design-system/index.ts";
export default function StateGalleryPage() {
const [lastAction, setLastAction] = useState(
diff --git a/src/presentation/examples/ui-gallery-page.tsx b/src/features/platform-examples-feature/presentation/ui-gallery-page.tsx
similarity index 99%
rename from src/presentation/examples/ui-gallery-page.tsx
rename to src/features/platform-examples-feature/presentation/ui-gallery-page.tsx
index e5966beb..2a569382 100644
--- a/src/presentation/examples/ui-gallery-page.tsx
+++ b/src/features/platform-examples-feature/presentation/ui-gallery-page.tsx
@@ -19,7 +19,7 @@ import {
ToastProvider,
Tooltip,
useToast,
-} from "../design-system/index.ts";
+} from "../../../presentation/design-system/index.ts";
const COLOR_TOKENS = Object.freeze([
["Surface", "--color-surface"],
diff --git a/src/presentation/i18n/catalog.ts b/src/presentation/i18n/catalog.ts
index 7f31d496..ccbf460e 100644
--- a/src/presentation/i18n/catalog.ts
+++ b/src/presentation/i18n/catalog.ts
@@ -45,12 +45,6 @@ const PLATFORM_KO_MESSAGES = {
"route.APP_HOME.title": "Clean Architecture Frontend",
"route.EXAMPLES_PLATFORM.navigation": "플랫폼 구성",
"route.EXAMPLES_PLATFORM.title": "플랫폼 구성",
- "route.EXAMPLES_UI.navigation": "UI 구성요소",
- "route.EXAMPLES_UI.title": "UI 구성요소",
- "route.EXAMPLES_STATES.navigation": "화면 상태",
- "route.EXAMPLES_STATES.title": "화면 상태",
- "route.EXAMPLES_AUTH.navigation": "인증 연동",
- "route.EXAMPLES_AUTH.title": "인증 연동",
"route.NOT_FOUND.navigation": "찾을 수 없음",
"route.NOT_FOUND.title": "페이지를 찾을 수 없습니다.",
"async.loading": "불러오는 중",
@@ -117,10 +111,8 @@ const PLATFORM_KO_MESSAGES = {
"home.runtime.summary": "빌드 {buildId} · 릴리스 {releaseId}",
"home.starter.title": "준비된 화면 살펴보기",
"home.starter.description":
- "설치된 라우트와 계약, 런타임 능력은 플랫폼 구성 화면에서, 공통 구성요소와 비동기 화면 상태는 예제 라우트에서 확인하세요.",
- "home.starter.platform": "플랫폼 구성 보기",
- "home.starter.ui": "UI 구성요소 보기",
- "home.starter.states": "화면 상태 보기",
+ "내비게이션의 첫 화면을 바로 엽니다. 템플릿에서는 설치된 라우트·계약·런타임 능력, 공통 구성요소, 비동기 화면 상태를 보여 주는 예제 화면입니다.",
+ "home.starter.open": "{title} 보기",
"page.notFound.title": "페이지를 찾을 수 없습니다.",
"page.notFound.description":
"주소를 확인하거나 준비된 시작 화면으로 돌아가세요.",
@@ -258,12 +250,6 @@ const PLATFORM_EN_MESSAGES = {
"route.APP_HOME.title": "Clean Architecture Frontend",
"route.EXAMPLES_PLATFORM.navigation": "Platform composition",
"route.EXAMPLES_PLATFORM.title": "Platform composition",
- "route.EXAMPLES_UI.navigation": "UI components",
- "route.EXAMPLES_UI.title": "UI components",
- "route.EXAMPLES_STATES.navigation": "Screen states",
- "route.EXAMPLES_STATES.title": "Screen states",
- "route.EXAMPLES_AUTH.navigation": "Authentication",
- "route.EXAMPLES_AUTH.title": "Authentication",
"route.NOT_FOUND.navigation": "Not found",
"route.NOT_FOUND.title": "Page not found",
"async.loading": "Loading",
@@ -329,10 +315,8 @@ const PLATFORM_EN_MESSAGES = {
"home.runtime.summary": "Build {buildId} · Release {releaseId}",
"home.starter.title": "Explore the prepared screens",
"home.starter.description":
- "See installed routes, contracts and runtime capabilities on the platform composition page, and common components and async screen states on the example routes.",
- "home.starter.platform": "View platform composition",
- "home.starter.ui": "View UI components",
- "home.starter.states": "View screen states",
+ "Open the first screens of the navigation. In the template these are the example screens for installed routes, contracts and runtime capabilities, common components and async screen states.",
+ "home.starter.open": "View {title}",
"page.notFound.title": "Page not found.",
"page.notFound.description": "Check the address or return to the start page.",
"template.breadcrumb": "Current location",
diff --git a/src/presentation/pages/home-page.tsx b/src/presentation/pages/home-page.tsx
index b773916e..0a72221a 100644
--- a/src/presentation/pages/home-page.tsx
+++ b/src/presentation/pages/home-page.tsx
@@ -1,7 +1,7 @@
import { useEffect, useState } from "react";
import { Link } from "react-router-dom";
-import { routePath } from "../../features/installed-feature-contracts.ts";
+import { NAVIGATION_ROUTES } from "../../features/installed-feature-contracts.ts";
import { PageHeader } from "../design-system/index.ts";
import { useLocale } from "../i18n/index.ts";
import { useApplicationRuntime } from "../providers/application-provider.tsx";
@@ -12,9 +12,19 @@ const READINESS_ITEMS = Object.freeze([
"accessibility",
] as const);
+/**
+ * 1103/09-04. The first screens of the navigation after this page. In the
+ * template those are its example screens, a removable feature; a
+ * product that leaves them out gets its own screens here, and the page names
+ * no feature's route.
+ */
+const STARTER_ROUTES = Object.freeze(
+ NAVIGATION_ROUTES.filter((route) => route.routeId !== "APP_HOME").slice(0, 3),
+);
+
export default function HomePage() {
const runtime = useApplicationRuntime();
- const { message } = useLocale();
+ const { message, resolve } = useLocale();
const [release, setRelease] = useState<
Awaited> | "failed" | null
>(null);
@@ -59,29 +69,29 @@ export default function HomePage() {
})
: message("home.runtime.checking")}