diff --git a/docs/architecture/frontend-application-foundation.md b/docs/architecture/frontend-application-foundation.md
index d9fe275e..d722cb20 100644
--- a/docs/architecture/frontend-application-foundation.md
+++ b/docs/architecture/frontend-application-foundation.md
@@ -119,7 +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 V2 API registries and contract contributions; the platform
- overview route calls it before it renders, the boot never does
+ 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/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/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/routes/route-runtime.tsx b/src/presentation/routes/route-runtime.tsx
index 69dfb550..8ae93a40 100644
--- a/src/presentation/routes/route-runtime.tsx
+++ b/src/presentation/routes/route-runtime.tsx
@@ -24,10 +24,9 @@ function runtime(
export const PLATFORM_ROUTE_RUNTIME = {
APP_HOME: runtime("APP_HOME", () => import("../pages/home-page.tsx")),
- EXAMPLES_PLATFORM: runtime("EXAMPLES_PLATFORM", () =>
- import("../examples/platform-overview-page.tsx").then((module) =>
- module.loadPlatformOverviewPage(),
- ),
+ EXAMPLES_PLATFORM: runtime(
+ "EXAMPLES_PLATFORM",
+ () => import("../examples/platform-overview-page.tsx"),
),
EXAMPLES_UI: runtime(
"EXAMPLES_UI",
diff --git a/tests/component/starter-platform-overview-page.test.tsx b/tests/component/starter-platform-overview-page.test.tsx
index 1c043b16..3484238c 100644
--- a/tests/component/starter-platform-overview-page.test.tsx
+++ b/tests/component/starter-platform-overview-page.test.tsx
@@ -1,9 +1,12 @@
// @vitest-environment jsdom
-import { render, screen, waitFor, within } from "@testing-library/react";
+import { act, render, screen, waitFor, within } from "@testing-library/react";
import { describe, expect, it } from "vitest";
-import { composeContractContributions } from "../../src/contracts/external-contract-runtime.ts";
+import {
+ composeContractContributions,
+ type ComposedContractContributions,
+} from "../../src/contracts/external-contract-runtime.ts";
import { unvalidatedPayload } from "../../src/contracts/unvalidated-payload.ts";
import { SERVER_STATE_PROFILES } from "../../src/contracts/server-state.ts";
import { COMPOSED_CONTRACT_CONTRIBUTIONS } from "../../src/features/loaded-feature-runtimes.ts";
@@ -24,14 +27,31 @@ import { createRuntimeCapabilitiesStub } from "../helpers/runtime-capabilities-s
* template that removes its sample feature still satisfies this suite.
*/
-function renderPage() {
- return render(
-
-
-
-
- ,
- );
+/**
+ * 1103/15-01. The contract tables wait for the features' runtime halves
+ * behind their own Suspense boundary; `act` lets the given promise settle.
+ */
+async function renderPage(
+ options: Readonly<{
+ application?: ReturnType;
+ contracts?: ComposedContractContributions;
+ }> = {},
+) {
+ await act(async () => {
+ render(
+
+
+
+
+ ,
+ );
+ });
}
function tableByCaption(caption: string): HTMLElement {
@@ -48,8 +68,8 @@ function metricByLabel(scope: HTMLElement, label: string): HTMLElement {
}
describe("platform overview page", () => {
- it("renders one route row per installed route registry entry", () => {
- renderPage();
+ it("renders one route row per installed route registry entry", async () => {
+ await renderPage();
const table = tableByCaption("설치된 라우트 목록");
const dataRows = within(table).getAllByRole("row").slice(1);
@@ -62,11 +82,11 @@ describe("platform overview page", () => {
}
});
- it("renders one operation row per installed HTTP contract", () => {
+ it("renders one operation row per installed HTTP contract", async () => {
const operationIds = [
...COMPOSED_CONTRACT_CONTRIBUTIONS.httpByOperationId.keys(),
];
- renderPage();
+ await renderPage();
if (operationIds.length === 0) {
expect(
@@ -87,7 +107,7 @@ describe("platform overview page", () => {
});
// 1101/07-03. A skipped validation is shown, not just composed.
- it("lists the operations that skip runtime validation, with the reason", () => {
+ it("lists the operations that skip runtime validation, with the reason", async () => {
const [listRow, ...rest] = TEST_CONTRACT_CONTRIBUTION.http;
const contracts = composeContractContributions([
Object.freeze({
@@ -107,13 +127,7 @@ describe("platform overview page", () => {
]),
}),
]);
- render(
-
-
-
-
- ,
- );
+ await renderPage({ contracts });
const table = tableByCaption("런타임 검증을 생략한 계약");
const [row, ...others] = within(table).getAllByRole("row").slice(1);
@@ -122,16 +136,16 @@ describe("platform overview page", () => {
expect(within(row!).getByText("typed by the package")).toBeVisible();
});
- it("shows no skipped-validation list when every operation validates", () => {
- renderPage();
+ it("shows no skipped-validation list when every operation validates", async () => {
+ await renderPage();
expect(
screen.queryByRole("table", { name: "런타임 검증을 생략한 계약" }),
).toBeNull();
});
- it("renders every fixed server-state profile with its own budget", () => {
- renderPage();
+ it("renders every fixed server-state profile with its own budget", async () => {
+ await renderPage();
const table = tableByCaption("서버 상태 프로파일");
for (const profile of Object.values(SERVER_STATE_PROFILES)) {
@@ -142,8 +156,8 @@ describe("platform overview page", () => {
);
});
- it("labels a capability that was never selected as unselected", () => {
- renderPage();
+ it("labels a capability that was never selected as unselected", async () => {
+ await renderPage();
const region = screen.getByRole("region", { name: "선택적 런타임 능력" });
@@ -151,21 +165,15 @@ describe("platform overview page", () => {
expect(within(region).queryByText("운영자가 비활성화함")).toBeNull();
});
- it("separates an operator disable from a capability that was never selected", () => {
- render(
-
-
-
-
- ,
- );
+ it("separates an operator disable from a capability that was never selected", async () => {
+ await renderPage({
+ application: createTestApplication({
+ runtimeCapabilities: createRuntimeCapabilitiesStub({
+ SERVICE_WORKER: { selected: 1, active: 0, override: "DISABLED" },
+ OFFLINE_COMMANDS: { selected: 1, active: 1 },
+ }),
+ }),
+ });
const region = screen.getByRole("region", { name: "선택적 런타임 능력" });
@@ -174,11 +182,11 @@ describe("platform overview page", () => {
expect(within(region).getAllByText("미선택")).toHaveLength(2);
});
- it("counts installed contract packages separately from template fixtures", () => {
+ it("counts installed contract packages separately from template fixtures", async () => {
const fixtures = COMPOSED_CONTRACT_CONTRIBUTIONS.contributions.filter(
(contribution) => contribution.source.kind === "TEMPLATE_FIXTURE",
).length;
- renderPage();
+ await renderPage();
const summary = screen.getByRole("region", { name: "설치 요약" });
const packages = metricByLabel(summary, "외부 계약 패키지");
@@ -199,7 +207,7 @@ describe("platform overview page", () => {
});
it("renders the verified release identity once the runtime resolves it", async () => {
- renderPage();
+ await renderPage();
const region = screen.getByRole("region", { name: "릴리스 신원" });
await waitFor(() =>
@@ -213,24 +221,18 @@ describe("platform overview page", () => {
});
it("stops the release metrics from loading forever", async () => {
- render(
- {
- throw new Error("manifest unavailable");
- },
- refresh: async () => {
- throw new Error("manifest unavailable");
- },
+ await renderPage({
+ application: createTestApplication({
+ releaseInfo: {
+ getCurrent: async () => {
+ throw new Error("manifest unavailable");
},
- })}
- >
-
-
-
- ,
- );
+ refresh: async () => {
+ throw new Error("manifest unavailable");
+ },
+ },
+ }),
+ });
await waitFor(() =>
expect(
screen.getByText("런타임 정보를 확인하지 못했습니다."),
diff --git a/tests/component/starter-platform-overview-route.test.tsx b/tests/component/starter-platform-overview-route.test.tsx
new file mode 100644
index 00000000..a6fad087
--- /dev/null
+++ b/tests/component/starter-platform-overview-route.test.tsx
@@ -0,0 +1,54 @@
+// @vitest-environment jsdom
+
+import { render, screen, within } from "@testing-library/react";
+import { Suspense } from "react";
+import { describe, expect, it, vi } from "vitest";
+
+import { ROUTE_REGISTRY } from "../../src/features/installed-feature-contracts.ts";
+import { LocaleProvider } from "../../src/presentation/i18n/index.ts";
+import { ApplicationProvider } from "../../src/presentation/providers/application-provider.tsx";
+import { PLATFORM_ROUTE_RUNTIME } from "../../src/presentation/routes/route-runtime.tsx";
+import { createTestApplication } from "../helpers/create-test-application.ts";
+
+// The feature runtimes never arrive: the route must not wait for them.
+vi.mock("../../src/features/installed-feature-runtime-registries.ts", () => ({
+ loadInstalledFeatureRuntimeRegistries: () => new Promise(() => {}),
+}));
+
+/**
+ * 1103/15-01. The lab gate (FE-GATE-026) times this route from the click to
+ * its heading. Its route module used to await every installed feature's
+ * runtime half first, which added a second request round to the click.
+ */
+describe("platform overview route module", () => {
+ it("draws the title and the declared routes before the feature runtimes load", async () => {
+ const Page = PLATFORM_ROUTE_RUNTIME.EXAMPLES_PLATFORM.Component;
+ render(
+
+
+ route chunk
}>
+
+
+
+ ,
+ );
+
+ expect(
+ await screen.findByRole("heading", { level: 1, name: "플랫폼 구성" }),
+ ).toBeVisible();
+ const routes = screen.getByRole("table", { name: "설치된 라우트 목록" });
+ expect(within(routes).getAllByRole("row").slice(1)).toHaveLength(
+ Object.keys(ROUTE_REGISTRY).length,
+ );
+ // Only the part read from the runtime halves waits.
+ const contracts = screen.getByRole("region", {
+ name: "계약과 HTTP 오퍼레이션",
+ });
+ expect(
+ within(contracts).getByLabelText("기능 실행부를 불러오고 있습니다."),
+ ).toBeVisible();
+ expect(
+ screen.queryByRole("table", { name: "설치된 HTTP 오퍼레이션" }),
+ ).toBeNull();
+ });
+});