문제 라우트 레이아웃 표(tech-log-route-runtime.tsx)가 StudioShell을 정적으로 가져와, 공개 화면의 초기 JS에 StudioProvider·Studio 머리말·문서 server state가 들어갔다. 고른 방법 - STUDIO 레이아웃은 lazy StudioShell을 Suspense와 ChunkRecoveryBoundary로 감싼다. 청크를 못 받으면 라우트 청크와 같은 recoverChunk가 한 번 새로 읽기를 정한다(chunkId `tech-log-studio-shell`). - tests/features/tech-log/boot-graph.test.ts가 부팅 그래프(main.tsx, 그 정적 import, 진입점이 바로 동적으로 읽는 boot·render-boot-failure)를 빌드 없이 따라가, MOCK 소스·정적 콘텐츠·Studio 화면·HTTP Studio gateway가 다시 들어오지 않는지 본다. 공개 셸과 기능 입력 조립이 그래프에 있는지도 봐서 빈 결과로 통과하지 않는다. 버린 대안 - 템플릿 소유 app-router.tsx에서 레이아웃 route에 lazy를 거는 것: 템플릿 파일을 고치게 되고, 자식 화면 청크는 여전히 셸 뒤에 받는다. 위험·한계 - /studio 첫 진입은 셸 청크를 받은 뒤 화면 청크를 받는다(직렬 왕복 하나). Studio는 작성자 한 사람이 쓰는 화면이다. - 셸을 받는 동안 LoadingSurface가 보인다. 검증 - desktop CI env 빌드: 앞 커밋과 함께 초기 JS 300,869 → 232,337 B. - boot-graph.test.ts 통과.
333 lines
8.8 KiB
TypeScript
333 lines
8.8 KiB
TypeScript
import {
|
|
lazy,
|
|
Suspense,
|
|
type ComponentType,
|
|
type LazyExoticComponent,
|
|
type ReactNode,
|
|
} from "react";
|
|
import { Outlet } from "react-router-dom";
|
|
|
|
import { ChunkRecoveryBoundary } from "../../../presentation/boundaries/chunk-recovery-boundary.tsx";
|
|
import { LoadingSurface } from "../../../presentation/design-system/index.ts";
|
|
import { useApplicationRecovery } from "../../../presentation/providers/application-provider.tsx";
|
|
import {
|
|
TECH_LOG_ROUTE_RUNTIME_CONTRACT,
|
|
type TechLogRouteId,
|
|
} from "../contracts/tech-log-route-contract.ts";
|
|
import { PublicShell } from "./public/public-shell.tsx";
|
|
|
|
/*
|
|
Studio 셸은 공개 화면을 읽는 사람에게 필요 없다. 정적으로 가져오면 셸이 끌고 오는
|
|
StudioProvider·Studio 머리말·문서 server state 가 모든 첫 화면의 초기 JS 에 들어갔다
|
|
(FE-GATE-012). /studio 에 들어갈 때 받는다. 라우트 청크와 같이 청크를 못 받으면
|
|
ChunkRecoveryBoundary 가 한 번 새로 읽기를 정한다.
|
|
*/
|
|
const StudioShell = lazy(async () => {
|
|
const module = await import("./studio/studio-shell.tsx");
|
|
return { default: module.StudioShell };
|
|
});
|
|
|
|
function DeferredStudioShell({ children }: Readonly<{ children: ReactNode }>) {
|
|
const recovery = useApplicationRecovery();
|
|
return (
|
|
<ChunkRecoveryBoundary
|
|
chunkId="tech-log-studio-shell"
|
|
recover={recovery.recoverChunk}
|
|
>
|
|
<Suspense fallback={<LoadingSurface />}>
|
|
<StudioShell>{children}</StudioShell>
|
|
</Suspense>
|
|
</ChunkRecoveryBoundary>
|
|
);
|
|
}
|
|
|
|
type RouteRuntime = Readonly<{
|
|
moduleId: string;
|
|
Component: LazyExoticComponent<ComponentType>;
|
|
}>;
|
|
|
|
function runtime(
|
|
routeId: TechLogRouteId,
|
|
load: () => Promise<{ default: ComponentType }>,
|
|
): RouteRuntime {
|
|
return Object.freeze({
|
|
moduleId: TECH_LOG_ROUTE_RUNTIME_CONTRACT[routeId].moduleId,
|
|
Component: lazy(load),
|
|
});
|
|
}
|
|
|
|
function routeModule<Module, Key extends keyof Module>(
|
|
load: () => Promise<Module>,
|
|
key: Key,
|
|
): () => Promise<{ default: Extract<Module[Key], ComponentType> }> {
|
|
return async () => {
|
|
const module = await load();
|
|
return { default: module[key] as Extract<Module[Key], ComponentType> };
|
|
};
|
|
}
|
|
|
|
export const TECH_LOG_ROUTE_RUNTIME = Object.freeze({
|
|
TECH_LOG_HOME: runtime(
|
|
"TECH_LOG_HOME",
|
|
routeModule(() => import("./public/pages/home-page.tsx"), "HomePage"),
|
|
),
|
|
TECH_LOG_EXPLORE: runtime(
|
|
"TECH_LOG_EXPLORE",
|
|
routeModule(
|
|
() => import("./public/pages/explore-page.tsx"),
|
|
"ExplorePage",
|
|
),
|
|
),
|
|
TECH_LOG_EXPLORE_KIND: runtime(
|
|
"TECH_LOG_EXPLORE_KIND",
|
|
routeModule(
|
|
() => import("./public/pages/explore-kind-page.tsx"),
|
|
"ExploreKindPage",
|
|
),
|
|
),
|
|
TECH_LOG_CASE: runtime(
|
|
"TECH_LOG_CASE",
|
|
routeModule(() => import("./public/pages/case-page.tsx"), "CasePage"),
|
|
),
|
|
TECH_LOG_REFERENCE: runtime(
|
|
"TECH_LOG_REFERENCE",
|
|
routeModule(
|
|
() => import("./public/pages/reference-page.tsx"),
|
|
"ReferencePage",
|
|
),
|
|
),
|
|
TECH_LOG_CONCEPT: runtime(
|
|
"TECH_LOG_CONCEPT",
|
|
routeModule(
|
|
() => import("./public/pages/concept-page.tsx"),
|
|
"ConceptPage",
|
|
),
|
|
),
|
|
TECH_LOG_SETUP: runtime(
|
|
"TECH_LOG_SETUP",
|
|
routeModule(
|
|
() => import("./public/pages/setup-page.tsx"),
|
|
"SetupPage",
|
|
),
|
|
),
|
|
TECH_LOG_QUESTION: runtime(
|
|
"TECH_LOG_QUESTION",
|
|
routeModule(
|
|
() => import("./public/pages/question-page.tsx"),
|
|
"QuestionPage",
|
|
),
|
|
),
|
|
TECH_LOG_TOPICS: runtime(
|
|
"TECH_LOG_TOPICS",
|
|
routeModule(
|
|
() => import("./public/pages/topics-page.tsx"),
|
|
"TopicsPage",
|
|
),
|
|
),
|
|
TECH_LOG_TOPIC: runtime(
|
|
"TECH_LOG_TOPIC",
|
|
routeModule(() => import("./public/pages/topic-page.tsx"), "TopicPage"),
|
|
),
|
|
TECH_LOG_TOPIC_VARIANT: runtime(
|
|
"TECH_LOG_TOPIC_VARIANT",
|
|
routeModule(
|
|
() => import("./public/pages/topic-variant-page.tsx"),
|
|
"TopicVariantPage",
|
|
),
|
|
),
|
|
TECH_LOG_PROJECTS: runtime(
|
|
"TECH_LOG_PROJECTS",
|
|
routeModule(
|
|
() => import("./public/pages/projects-page.tsx"),
|
|
"ProjectsPage",
|
|
),
|
|
),
|
|
TECH_LOG_PROJECT: runtime(
|
|
"TECH_LOG_PROJECT",
|
|
routeModule(
|
|
() => import("./public/pages/project-overview-page.tsx"),
|
|
"ProjectOverviewPage",
|
|
),
|
|
),
|
|
TECH_LOG_PROJECT_RECORDS: runtime(
|
|
"TECH_LOG_PROJECT_RECORDS",
|
|
routeModule(
|
|
() => import("./public/pages/project-records-page.tsx"),
|
|
"ProjectRecordsPage",
|
|
),
|
|
),
|
|
TECH_LOG_PROJECT_DECISIONS: runtime(
|
|
"TECH_LOG_PROJECT_DECISIONS",
|
|
routeModule(
|
|
() => import("./public/pages/project-decisions-page.tsx"),
|
|
"ProjectDecisionsPage",
|
|
),
|
|
),
|
|
TECH_LOG_PROJECT_ACTIVITY: runtime(
|
|
"TECH_LOG_PROJECT_ACTIVITY",
|
|
routeModule(
|
|
() => import("./public/pages/project-activity-page.tsx"),
|
|
"ProjectActivityPage",
|
|
),
|
|
),
|
|
TECH_LOG_RELEASES: runtime(
|
|
"TECH_LOG_RELEASES",
|
|
routeModule(
|
|
() => import("./public/pages/releases-page.tsx"),
|
|
"ReleasesPage",
|
|
),
|
|
),
|
|
TECH_LOG_RELEASE: runtime(
|
|
"TECH_LOG_RELEASE",
|
|
routeModule(
|
|
() => import("./public/pages/release-page.tsx"),
|
|
"ReleasePage",
|
|
),
|
|
),
|
|
TECH_LOG_PROFILE: runtime(
|
|
"TECH_LOG_PROFILE",
|
|
routeModule(
|
|
() => import("./public/pages/profile-page.tsx"),
|
|
"ProfilePage",
|
|
),
|
|
),
|
|
TECH_LOG_SEARCH: runtime(
|
|
"TECH_LOG_SEARCH",
|
|
routeModule(() => import("./public/pages/search-page.tsx"), "SearchPage"),
|
|
),
|
|
TECH_LOG_STUDIO_HOME: runtime(
|
|
"TECH_LOG_STUDIO_HOME",
|
|
routeModule(
|
|
() => import("./studio/pages/studio-home-page.tsx"),
|
|
"StudioHomePage",
|
|
),
|
|
),
|
|
TECH_LOG_STUDIO_DOCUMENTS: runtime(
|
|
"TECH_LOG_STUDIO_DOCUMENTS",
|
|
routeModule(
|
|
() => import("./studio/pages/documents-page.tsx"),
|
|
"DocumentsPage",
|
|
),
|
|
),
|
|
TECH_LOG_STUDIO_DOCUMENT_NEW: runtime(
|
|
"TECH_LOG_STUDIO_DOCUMENT_NEW",
|
|
routeModule(
|
|
() => import("./studio/pages/new-document-page.tsx"),
|
|
"NewDocumentPage",
|
|
),
|
|
),
|
|
TECH_LOG_STUDIO_DOCUMENT_EDIT: runtime(
|
|
"TECH_LOG_STUDIO_DOCUMENT_EDIT",
|
|
routeModule(
|
|
() => import("./studio/pages/document-edit-page.tsx"),
|
|
"DocumentEditPage",
|
|
),
|
|
),
|
|
TECH_LOG_STUDIO_DOCUMENT_VALIDATION: runtime(
|
|
"TECH_LOG_STUDIO_DOCUMENT_VALIDATION",
|
|
routeModule(
|
|
() => import("./studio/pages/document-validation-page.tsx"),
|
|
"DocumentValidationPage",
|
|
),
|
|
),
|
|
TECH_LOG_STUDIO_DOCUMENT_PREVIEW: runtime(
|
|
"TECH_LOG_STUDIO_DOCUMENT_PREVIEW",
|
|
routeModule(
|
|
() => import("./studio/pages/document-preview-page.tsx"),
|
|
"DocumentPreviewPage",
|
|
),
|
|
),
|
|
TECH_LOG_STUDIO_DOCUMENT_PUBLISH: runtime(
|
|
"TECH_LOG_STUDIO_DOCUMENT_PUBLISH",
|
|
routeModule(
|
|
() => import("./studio/pages/document-publish-page.tsx"),
|
|
"DocumentPublishPage",
|
|
),
|
|
),
|
|
TECH_LOG_STUDIO_PUBLICATIONS: runtime(
|
|
"TECH_LOG_STUDIO_PUBLICATIONS",
|
|
routeModule(
|
|
() => import("./studio/pages/publications-page.tsx"),
|
|
"PublicationsPage",
|
|
),
|
|
),
|
|
TECH_LOG_STUDIO_PUBLICATION_PREVIEW: runtime(
|
|
"TECH_LOG_STUDIO_PUBLICATION_PREVIEW",
|
|
routeModule(
|
|
() => import("./studio/pages/publication-preview-page.tsx"),
|
|
"PublicationPreviewPage",
|
|
),
|
|
),
|
|
TECH_LOG_STUDIO_ASSETS: runtime(
|
|
"TECH_LOG_STUDIO_ASSETS",
|
|
routeModule(
|
|
() => import("./studio/pages/assets-page.tsx"),
|
|
"AssetsPage",
|
|
),
|
|
),
|
|
TECH_LOG_STUDIO_TAXONOMY: runtime(
|
|
"TECH_LOG_STUDIO_TAXONOMY",
|
|
routeModule(
|
|
() => import("./studio/pages/taxonomy-page.tsx"),
|
|
"TaxonomyPage",
|
|
),
|
|
),
|
|
TECH_LOG_STUDIO_PROJECT_EDIT: runtime(
|
|
"TECH_LOG_STUDIO_PROJECT_EDIT",
|
|
routeModule(
|
|
() => import("./studio/pages/project-edit-page.tsx"),
|
|
"ProjectEditPage",
|
|
),
|
|
),
|
|
TECH_LOG_STUDIO_TOPIC_EDIT: runtime(
|
|
"TECH_LOG_STUDIO_TOPIC_EDIT",
|
|
routeModule(
|
|
() => import("./studio/pages/topic-edit-page.tsx"),
|
|
"TopicEditPage",
|
|
),
|
|
),
|
|
TECH_LOG_STUDIO_RELEASES: runtime(
|
|
"TECH_LOG_STUDIO_RELEASES",
|
|
routeModule(
|
|
() => import("./studio/pages/releases-page.tsx"),
|
|
"StudioReleasesPage",
|
|
),
|
|
),
|
|
TECH_LOG_STUDIO_RELEASE_EDIT: runtime(
|
|
"TECH_LOG_STUDIO_RELEASE_EDIT",
|
|
routeModule(
|
|
() => import("./studio/pages/release-edit-page.tsx"),
|
|
"ReleaseEditPage",
|
|
),
|
|
),
|
|
TECH_LOG_STUDIO_NOT_FOUND: runtime(
|
|
"TECH_LOG_STUDIO_NOT_FOUND",
|
|
routeModule(
|
|
() => import("./studio/pages/studio-not-found-page.tsx"),
|
|
"StudioNotFoundPage",
|
|
),
|
|
),
|
|
NOT_FOUND: runtime(
|
|
"NOT_FOUND",
|
|
routeModule(
|
|
() => import("./public/pages/public-not-found-page.tsx"),
|
|
"PublicNotFoundPage",
|
|
),
|
|
),
|
|
}) satisfies Readonly<Record<TechLogRouteId, RouteRuntime>>;
|
|
|
|
export const TECH_LOG_ROUTE_LAYOUTS: Readonly<
|
|
Record<"PUBLIC" | "STUDIO", ReactNode>
|
|
> = Object.freeze({
|
|
PUBLIC: (
|
|
<PublicShell>
|
|
<Outlet />
|
|
</PublicShell>
|
|
),
|
|
STUDIO: (
|
|
<DeferredStudioShell>
|
|
<Outlet />
|
|
</DeferredStudioShell>
|
|
),
|
|
});
|