diff --git a/.gitea/workflows/quality-gates.yml b/.gitea/workflows/quality-gates.yml
index 9542cd79..3841d543 100644
--- a/.gitea/workflows/quality-gates.yml
+++ b/.gitea/workflows/quality-gates.yml
@@ -67,7 +67,9 @@ jobs:
corepack pnpm install --frozen-lockfile --ignore-scripts
- name: Install Playwright browsers
if: ${{ matrix.browser }}
- run: corepack pnpm exec playwright install --with-deps chromium firefox webkit
+ run: |
+ corepack pnpm exec playwright install --with-deps chromium firefox webkit
+ $(command -v sudo || true) apt-get install -y fonts-noto-core fonts-noto-cjk fonts-noto-cjk-extra fonts-liberation
- name: Run blocking gate
run: corepack pnpm ci:gate -- ${{ matrix.gate }}
- name: Upload merge gate evidence
@@ -104,7 +106,9 @@ jobs:
corepack pnpm install --frozen-lockfile --ignore-scripts
- name: Install Playwright browsers
if: ${{ matrix.browser }}
- run: corepack pnpm exec playwright install --with-deps chromium firefox webkit
+ run: |
+ corepack pnpm exec playwright install --with-deps chromium firefox webkit
+ $(command -v sudo || true) apt-get install -y fonts-noto-core fonts-noto-cjk fonts-noto-cjk-extra fonts-liberation
- name: Run blocking gate
run: corepack pnpm ci:gate -- ${{ matrix.gate }}
- name: Upload release gate evidence
diff --git a/docs/accessibility/manual-checklist.md b/docs/accessibility/manual-checklist.md
index 8dad35c9..2e4158db 100644
--- a/docs/accessibility/manual-checklist.md
+++ b/docs/accessibility/manual-checklist.md
@@ -68,8 +68,13 @@ What the automated run scans:
never lands on the app shell's loading surface
(`tests/e2e/accessibility.spec.ts`). A public route's `h1` must equal its
catalog title.
-- Protected routes after the demo sign-in, never the sign-in prompt. Their API
- calls answer an empty list there.
+- Protected routes after the demo sign-in, never the sign-in prompt. A list
+ read answers an empty list in the frame its descriptor declares (inside the
+ Envelope for `responseEnvelope: "ENVELOPE_V1"`), and the scan runs only once
+ no alert box is on screen, so a list page is scanned in its empty state. A
+ read of one resource (a detail page) has no generic answer: that route is
+ scanned in its failure state and the run records an `a11y-data-state`
+ annotation.
- The reference sample's list in its success, empty and error states, its
detail, its form with submit errors and its status page, each after that
state is on screen (`tests/e2e/reference-form.spec.ts`, removed with the
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/frontend-application-foundation.md b/docs/architecture/frontend-application-foundation.md
index 1143ac7a..b1fae3da 100644
--- a/docs/architecture/frontend-application-foundation.md
+++ b/docs/architecture/frontend-application-foundation.md
@@ -119,8 +119,8 @@ Central installed catalogs are aggregation points only:
registry the HTTP executor resolves against, filled as features load
- `installed-feature-runtime-registries.ts`: loads every runtime half and
composes the contract contributions, the FE-REG-API rows projected from
- them and the FE-REG-SCHEMA registry; the platform overview route calls it
- before it renders, the boot never does
+ them and the FE-REG-SCHEMA registry; the platform overview page calls it
+ after it draws its title (1103/15-01), the boot never does
- `loaded-feature-runtimes.ts`: the same registries as module constants (top-
level await) for Node scripts, tests and registry governance; nothing under
`src` may import it (`boot-does-not-load-every-feature-runtime`)
diff --git a/docs/architecture/starter-experience.md b/docs/architecture/starter-experience.md
index 256b7bca..69f45b68 100644
--- a/docs/architecture/starter-experience.md
+++ b/docs/architecture/starter-experience.md
@@ -97,14 +97,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
@@ -198,7 +216,7 @@ Files outside the feature directory. Everything else a feature needs is in
| `src/contexts//context-module.ts` | the feature needs a new context | `generate:feature-index`: `Feature belongs to undeclared context ` |
| `src/contexts//context-layout.tsx` | the context needs its own frame instead of `AppShell` (see "Product home and layouts" below) | nothing: without it the context renders in `AppShell` |
| `artifacts/tests/a11y-manual/.md` | every route the feature adds. Copy a record and reset it to `Status: pending-manual-review` | `test:unit` (`tests/unit/manual-a11y-evidence.test.ts`), `verify:documentation` (names the route IDs) and FE-GATE-009 (`review:a11y-manual -- --format-only`). FE-GATE-028 requires the signed review at release |
-| `tests/e2e/accessibility.spec.ts` | a route path has a parameter other than `:resourceId`, or a protected page cannot render while every API answers `[]` | `test:a11y` (FE-GATE-009): the spec fills in only `:resourceId` and answers every API with `[]` |
+| `tests/e2e/accessibility.spec.ts` | never per feature (1103/16-03): it fills every path parameter with one value and answers each API request from the installed descriptor, a list read with an empty list in its `responseEnvelope` frame. Edit it only for a protected page that sends something other than an installed GET before it renders | `test:a11y` (FE-GATE-009): a request no installed GET declares fails the route; so does an alert box (`role="alert"`) on a page that read only lists |
| `src/features/product-capabilities.ts` (product-owned) | `needs` names a capability the template does not build: type it in `ProductFeaturePlatformCapabilities`. `FeaturePlatformCapabilities` extends it, so the app, scripts and tests typecheck programs all see the key (an augmentation inside `product-composition.ts` is not seen by the scripts' program) | `check:types`: `Type '""' is not assignable to type 'keyof FeaturePlatformCapabilities'` in the feature |
| `src/bootstrap/product-composition.ts` (product-owned) | `needs` names a capability the template does not build: return the capability here, typed in `product-capabilities.ts`. `indexedDb` is built as in `recipes/frontend-capabilities/indexeddb-feature-capability.ts`. Credentials for a product auth profile are returned here too. A product that owns the session (a BFF's httpOnly cookie) returns its session owner from `composeProductSessionOwner` instead of installing it on the host global before boot | `check:types`; at runtime `feature needs , which the host did not provide`. Without the session owner, `AUTH_MODE: "external"` boots with the session `integration-failed` |
| `src/contracts/product-contracts.ts` (product-owned) | a product auth profile, or a product runtime-config key and its FE-REG-ENV row (`PRODUCT_ENV_REGISTRY`) | auth profile: every gate that loads the operation, with `Installed contract contribution is not composable: /: unknown authProfileId `. Config key: `check:types` where it is read. Give the key a `.default()` or make it `.optional()`: template tests build their config with `tests/helpers/runtime-config.ts`, which fills the product's defaults, and a required key without a default fails them. FE-REG-ENV row: `check:registries` checks its fields, and `tests/unit/env-registry-coverage.test.ts` (`test:unit`) requires a row for every key, with the schema's `required` and `defaultValue` |
diff --git a/docs/manual/01-add-a-feature.md b/docs/manual/01-add-a-feature.md
index 481909bf..2b565262 100644
--- a/docs/manual/01-add-a-feature.md
+++ b/docs/manual/01-add-a-feature.md
@@ -390,20 +390,12 @@ projectRequest: (input) => Object.freeze({
- 상세 경로는 목록 경로 뒤에 `/items/:`을 붙인다. 예: `/notice/items/:noticeId`. `/notice/:noticeId`로 두지 않는다.
- 라우터(React Router)는 같은 자리에서 정적 경로를 먼저 고른다. 작성 폼 `/notice/new`가 있으면 id가 `new`인 공지는 `/notice/:noticeId`로 열 수 없다.
- `items/`를 끼우면 정적 경로와 겹치지 않는다. 참조 기능도 이렇게 한다(`/examples/reference-resources/items/:resourceId`).
-- 경로 파라미터 이름이 `:resourceId`가 아니면 `tests/e2e/accessibility.spec.ts`의 치환 줄에 `.replace`를 하나 잇는다.
-
- ```ts
- // 지금
- : definition.path.replace(":resourceId", "reference-1");
- // 예: 공지 기능의 /notice/items/:noticeId
- : definition.path.replace(":resourceId", "reference-1").replace(":noticeId", "notice-1");
- ```
-
- - 이 spec은 등록된 모든 라우트를 열어 axe로 검사한다. 경로 파라미터는 `:resourceId`만 실제 값으로 바꾼다.
- - 안 고치면 `:noticeId`라는 글자가 그대로 id로 들어간다. 파라미터 스키마가 그 값을 거부하면 기능 페이지 대신 잘못된 경로 화면을 검사한다.
- - 값은 아무 문자열이나 된다. 이 spec은 모든 API에 `[]`로 답해서 상세 페이지는 실패 상태로 그려진다.
+- `tests/e2e/accessibility.spec.ts`는 기능마다 고치지 않는다(1103/16-03).
+ - 이 spec은 등록된 모든 라우트를 열어 axe로 검사한다. 경로 파라미터는 이름과 상관없이 모두 `a11y-1`로 바꾼다. 파라미터 스키마가 이 값을 거부하면 기능 페이지 대신 잘못된 경로 화면을 검사하므로, id 스키마는 짧은 영문·숫자 문자열을 받게 둔다.
+ - API 요청은 설치된 descriptor에서 method와 `pathTemplate`으로 찾아 답한다. 목록 조회에는 빈 목록을 그 operation의 모양(`responseEnvelope: "ENVELOPE_V1"`이면 Envelope)으로 답한다. 그 뒤 경고 상자(`role="alert"`)가 없는지 본다. 그래서 목록 페이지는 빈 상태로 검사된다.
+ - 한 자원을 읽는 조회(경로 파라미터가 있고 빈 목록을 받지 않는 GET)에는 빈 목록 말고 답할 것이 없다. 그래서 상세 페이지는 실패 상태로 그려지고, 테스트 결과에 `a11y-data-state` annotation이 남는다.
+ - 설치된 GET이 아닌 요청을 그리기 전에 보내면 spec이 실패한다(`requests no installed list or single-resource read answers`).
- spec은 h1이 보일 때까지 기다린다. 그래서 상세 페이지는 데이터가 없을 때도 h1을 그린다. 예: `heading={{ title: notice?.title ?? message("notice.detail.titlePending") }}`처럼 데이터가 없으면 고정 제목("공지")을 쓴다.
- - 이 줄은 기능 ID를 담지 않는다. 그래서 제거 드릴(11단계)이 잡지 못한다. 기능을 지울 때 손으로 지운다([03 문서](03-outside-feature-folder.md#기능을-지울-때)).
- 기능이 앱 홈(`/`)을 대신하려면 route ID `APP_HOME`을 쓴다. `docs/architecture/starter-experience.md`의 "Product home and layouts" 절을 본다.
③ **잡는 검사 / 못 잡는 것**
@@ -610,7 +602,7 @@ corepack pnpm test:sample-removal -- --feature=invoice-feature
- 남은 파일이 기능 ID나 폴더 이름을 담고 있으면 실패한다.
- 메시지: ` removal failed:` 다음 줄 `fixture-id-residue: residue: `
-- **못 잡음**: 기능 ID를 담지 않은 폴더 밖 파일. 예: route ID만 적은 e2e spec, `tests/e2e/accessibility.spec.ts`에 더한 파라미터 치환(6단계), `artifacts/tests/a11y-manual/.md`. 드릴은 `src`와 `tests`만 찾고, a11y 기록은 남아도 검사가 실패하지 않는다.
+- **못 잡음**: 기능 ID를 담지 않은 폴더 밖 파일. 예: route ID만 적은 e2e spec, `artifacts/tests/a11y-manual/.md`. 드릴은 `src`와 `tests`만 찾고, a11y 기록은 남아도 검사가 실패하지 않는다.
④ **쓸 스킬**: `documentation-and-adrs`, `deprecation-and-migration`
diff --git a/docs/manual/03-outside-feature-folder.md b/docs/manual/03-outside-feature-folder.md
index 6395af69..2079a1f8 100644
--- a/docs/manual/03-outside-feature-folder.md
+++ b/docs/manual/03-outside-feature-folder.md
@@ -101,7 +101,7 @@ release admission refused for staging:
언제와 실패 메시지는 정본 표에 있다. 여기에는 무엇을 위해 고치는지만 적는다.
- `src/contexts//context-layout.tsx`: context가 `AppShell` 대신 자기 틀을 쓸 때. 예제: `tests/helpers/fixture-layout-product.tsx`.
-- `tests/e2e/accessibility.spec.ts`: 경로 파라미터가 `:resourceId`가 아닐 때, 또는 모든 API가 `[]`를 답하면 그려지지 않는 보호 페이지일 때. 치환 줄 고치는 법은 [01 문서 6단계](01-add-a-feature.md#6단계-라우트).
+- `tests/e2e/accessibility.spec.ts`: 기능마다 고치지 않는다. 경로 파라미터와 API 응답을 설치된 라우트·descriptor에서 만든다. 보호 페이지가 설치된 GET이 아닌 요청을 그리기 전에 보낼 때만 손본다. 자세한 동작은 [01 문서 6단계](01-add-a-feature.md#6단계-라우트).
- `src/features/product-capabilities.ts`: `needs`에 템플릿이 만들지 않는 capability를 적었을 때. 그 capability의 타입을 `ProductFeaturePlatformCapabilities`에 적는다.
- `product-composition.ts` 안에서 `FeaturePlatformCapabilities`를 보강(`declare module`)하면 `check:types:node`가 그 키를 보지 못한다.
- `src/bootstrap/product-composition.ts`: 위 capability의 값을 돌려줄 때. 제품 인증 프로필의 자격 증명도 여기서 준다.
@@ -177,8 +177,6 @@ src/features/product-capabilities.ts (SERVICE_WORKER = ACTIVE)
- `artifacts/tests/a11y-manual/.md` (라우트마다)
- 남아도 검사는 실패하지 않는다. 검사는 등록된 라우트의 기록만 읽는다. 그래서 잊기 쉽다.
- 기능 전용 `tests/e2e/` spec
-- `tests/e2e/accessibility.spec.ts`에 더한 `.replace(":<파라미터>", "<값>")`
- - 기능 ID를 담지 않아 제거 드릴이 잡지 못한다. 남아도 어떤 검사도 실패하지 않는다.
- `config/runtime/.json`의 `FEATURE_OVERRIDES` 키
- `config/testing/risk-coverage.json`에서 그 기능을 가리키는 행
- 그 기능만 쓰던 제품 capability, 제품 인증 프로필, 계약 패키지 의존성
diff --git a/docs/manual/reference/create-feature.md b/docs/manual/reference/create-feature.md
index 326292b0..ee822ffd 100644
--- a/docs/manual/reference/create-feature.md
+++ b/docs/manual/reference/create-feature.md
@@ -73,7 +73,7 @@ corepack pnpm create:feature [--context ] [--package @scope/nam
- GET 1개: `SAFE`, `EXTERNAL_BEARER`, 응답은 항목 배열.
- 쿼리 1개: `LIST_STANDARD` profile.
- 무효화 topic 1개, namespace 1개, edge 1개.
-- 빈 배열 응답은 공유 빈 상태 화면으로 그린다. `tests/e2e/accessibility.spec.ts`가 모든 API에 `[]`를 답하기 때문이다.
+- 빈 배열 응답은 공유 빈 상태 화면으로 그린다. `tests/e2e/accessibility.spec.ts`는 이 목록 조회에 빈 목록을 Envelope 모양으로 답하고, 경고 상자가 없는지 본 뒤 axe를 돌린다. 그래서 생성한 라우트는 빈 상태 화면으로 검사된다.
한도·마감 같은 숫자는 `scripts/create-feature.ts`의 템플릿이 정본이다.
diff --git a/docs/testing/frontend-platform-testing-strategy.md b/docs/testing/frontend-platform-testing-strategy.md
index f0ea21ab..e262a2ae 100644
--- a/docs/testing/frontend-platform-testing-strategy.md
+++ b/docs/testing/frontend-platform-testing-strategy.md
@@ -955,7 +955,10 @@ Playwright `toHaveScreenshot()`을 사용한다.
- browser 버전과 viewport·scale은 `playwright.visual.config.ts`로, 글꼴은
`tests/visual/fonts.conf`로 고정(Linux 전용). 러너에는
`fonts-noto-core fonts-noto-cjk fonts-noto-cjk-extra fonts-liberation`
- 패키지가 필요하고, 없으면 `visual-fonts` 검사가 설치 명령을 보여 주며 실패한다
+ 패키지가 필요하고, 없으면 `visual-fonts` 검사가 설치 명령을 보여 주며 실패한다.
+ CI의 브라우저 설치 단계가 같은 패키지를 설치한다. 목록은
+ `scripts/lib/visual-test-fonts.ts` 한 곳에 있고 생성기와 `visual-fonts` 검사가
+ 같이 읽는다(1103/11-02)
- animation/caret 비활성화
- clock/random/network fixture 고정
- 개인정보와 동적 ID mask
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/scripts/generate-ci-workflow.ts b/scripts/generate-ci-workflow.ts
index b37d8b58..66e68ddb 100644
--- a/scripts/generate-ci-workflow.ts
+++ b/scripts/generate-ci-workflow.ts
@@ -23,6 +23,7 @@ import {
assertSafePublishLeaf,
ensureSafePublishDirectory,
} from "./lib/ci-gate-log.ts";
+import { VISUAL_TEST_FONT_INSTALL_ARGUMENTS } from "./lib/visual-test-fonts.ts";
export type GenerateCiWorkflowOptions = Readonly<{
root: string;
@@ -196,7 +197,12 @@ function renderStep(
return [
" - name: Install Playwright browsers",
...(job.kind === "gate-matrix" ? [" if: ${{ matrix.browser }}"] : []),
- " run: corepack pnpm exec playwright install --with-deps chromium firefox webkit",
+ " run: |",
+ " corepack pnpm exec playwright install --with-deps chromium firefox webkit",
+ // 1103/11-02. The visual goldens' faces (tests/visual/fonts.conf) are
+ // not among Playwright's dependencies. `--with-deps` has refreshed the
+ // package lists; sudo only where the runner is not root.
+ ` $(command -v sudo || true) ${VISUAL_TEST_FONT_INSTALL_ARGUMENTS}`,
];
case "run-gate": {
if (job.kind === "gate-matrix") {
diff --git a/scripts/lib/visual-test-fonts.ts b/scripts/lib/visual-test-fonts.ts
new file mode 100644
index 00000000..f689f3fa
--- /dev/null
+++ b/scripts/lib/visual-test-fonts.ts
@@ -0,0 +1,16 @@
+/**
+ * 1103/11-02. The Debian/Ubuntu packages that hold the four faces the visual
+ * goldens were captured with. `tests/visual/fonts.conf` shows Chromium only
+ * their directories, Playwright's `--with-deps` does not install them, and
+ * `tests/visual/fonts.setup.ts` fails with this list when one is missing. The
+ * CI browser step (`scripts/generate-ci-workflow.ts`) installs the same list,
+ * so the hint and the runner cannot name different packages.
+ */
+export const VISUAL_TEST_FONT_PACKAGES = Object.freeze([
+ "fonts-noto-core",
+ "fonts-noto-cjk",
+ "fonts-noto-cjk-extra",
+ "fonts-liberation",
+] as const);
+
+export const VISUAL_TEST_FONT_INSTALL_ARGUMENTS = `apt-get install -y ${VISUAL_TEST_FONT_PACKAGES.join(" ")}`;
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/installed-feature-runtime-registries.ts b/src/features/installed-feature-runtime-registries.ts
index 1404c147..7c02ea78 100644
--- a/src/features/installed-feature-runtime-registries.ts
+++ b/src/features/installed-feature-runtime-registries.ts
@@ -22,8 +22,10 @@ import { INSTALLED_PRODUCT_FEATURE_MODULES } from "./installed-product-manifest.
*
* The app boot never calls this: at runtime the composition root loads one
* feature at a time when its routes are entered (`installed-feature-adapters.ts`).
- * The platform overview route calls it before it renders, and Node scripts and
- * tests read the same result through `loaded-feature-runtimes.ts`.
+ * The platform overview page calls it after it draws its title (1103/15-01:
+ * awaiting it in the route module added a request round to entering the
+ * route), and Node scripts and tests read the same result through
+ * `loaded-feature-runtimes.ts`.
*/
export async function loadInstalledFeatureRuntimeRegistries() {
const runtimes = Object.freeze(
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/examples/platform-overview-page.tsx b/src/presentation/examples/platform-overview-page.tsx
index 86d5250b..1cf80f90 100644
--- a/src/presentation/examples/platform-overview-page.tsx
+++ b/src/presentation/examples/platform-overview-page.tsx
@@ -1,4 +1,4 @@
-import { type ComponentType, useEffect, useState } from "react";
+import { Suspense, use, useEffect, useState } from "react";
import {
HTTP_EXECUTION_CEILINGS,
@@ -11,7 +11,6 @@ import {
import { SERVER_STATE_PROFILES } from "../../contracts/server-state.ts";
import { EXPECTED_CONTRACT_SET_PACKAGES } from "../../features/installed-contract-contributions.ts";
import { ROUTE_REGISTRY } from "../../features/installed-feature-contracts.ts";
-import { loadInstalledFeatureRuntimeRegistries } from "../../features/installed-feature-runtime-registries.ts";
import type {
RuntimeCapabilityId,
RuntimeCapabilityStatus,
@@ -21,6 +20,7 @@ import {
Card,
DataTable,
EmptySurface,
+ LoadingSurface,
PageHeader,
type DataTableColumn,
} from "../design-system/index.ts";
@@ -309,14 +309,71 @@ function buildOperationRows(
);
}
+const CONTRACTS_LOADING = "기능 실행부를 불러오고 있습니다.";
+
+/** The summary counts that only the features' runtime halves know. */
+function ContractMetrics({
+ contracts,
+}: Readonly<{ contracts: Promise }>) {
+ const composed = use(contracts);
+ const fixtureContributions = composed.contributions.filter(
+ (contribution) => contribution.source.kind === "TEMPLATE_FIXTURE",
+ ).length;
+ return (
+ <>
+
+
+ >
+ );
+}
+
+function ContractTables({
+ contracts,
+}: Readonly<{ contracts: Promise }>) {
+ const composed = use(contracts);
+ return (
+ <>
+ row.operationId}
+ empty={
+
+ }
+ />
+ {/* 1101/07-03. Drawn only when a contract skips validation by name. */}
+ `${row.contractId}.${row.validator}`}
+ empty={null}
+ />
+ >
+ );
+}
+
/**
* 15-01. The page lists every installed HTTP operation, which lives in the
- * features' runtime halves. Its route loads them all before it renders
- * (`loadPlatformOverviewPage`); the boot never does.
+ * features' runtime halves; the boot never loads them. 1103/15-01: only the
+ * parts that read them wait (`contracts`). The title and everything the
+ * declarations know draw at once, so entering the route costs the page chunk
+ * alone, not a second request round for every feature's runtime.
*/
export function PlatformOverviewPage({
contracts,
-}: Readonly<{ contracts: ComposedContractContributions }>) {
+}: Readonly<{ contracts: Promise }>) {
const runtime = useApplicationRuntime();
const [release, setRelease] = useState<
Awaited> | "failed" | null
@@ -338,16 +395,11 @@ export function PlatformOverviewPage({
}, [runtime]);
const routes = Object.values(ROUTE_REGISTRY);
- const operations = buildOperationRows(contracts);
const capabilities = runtime.getCapabilitySnapshot();
const features = runtime.getFeatureSnapshot();
const activeCapabilityCount = capabilities.filter(
(status) => status.active > 0,
).length;
- const fixtureContributions =
- contracts.contributions.filter(
- (contribution) => contribution.source.kind === "TEMPLATE_FIXTURE",
- ).length;
return (
// 08-07. Example copy is Korean in every locale (outside the catalog).
@@ -413,12 +465,19 @@ export function PlatformOverviewPage({
-
-
+
+
+
+ >
+ }
+ >
+
+
- row.operationId}
- empty={
-
- }
- />
- {/* 1101/07-03. Drawn only when a contract skips validation by name. */}
- `${row.contractId}.${row.validator}`}
- empty={null}
- />
+ }>
+
+
-> {
- const registries = await loadInstalledFeatureRuntimeRegistries();
- const contracts = registries.composedContractContributions;
- return Object.freeze({
- default: function InstalledPlatformOverviewPage() {
- return ;
- },
- });
+let installedContracts: Promise | undefined;
+
+/**
+ * One load shared by both waiting parts and by later visits. The composer is
+ * imported here too, so its code is not in the page chunk the title waits
+ * for. A duplicate across features rejects here and reaches the route
+ * boundary, as it did when the route awaited it; a failed load is dropped so
+ * the next visit retries.
+ */
+function loadInstalledContracts(): Promise {
+ if (installedContracts === undefined) {
+ const loading = import(
+ "../../features/installed-feature-runtime-registries.ts"
+ )
+ .then((module) => module.loadInstalledFeatureRuntimeRegistries())
+ .then((registries) => registries.composedContractContributions);
+ loading.catch(() => {
+ if (installedContracts === loading) installedContracts = undefined;
+ });
+ installedContracts = loading;
+ }
+ return installedContracts;
+}
+
+/** The route module: the page bound to the installed registries. */
+export default function InstalledPlatformOverviewPage() {
+ return ;
}
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")}