@fluojs/react 0.1.0 → 0.2.0

package/README.ko.md

@@ -4,19 +4,31 @@
 
 fluo 애플리케이션을 위한 런타임 중립 React 통합입니다.
 
+Coordinated Node 24 릴리스를 준비한다면 패키지 업그레이드 전에 [소비자 마이그레이션 가이드](../../docs/getting-started/migrate-node24.ko.md)를 따르세요. React는 `0.x`의 `minor` 릴리스를 유지하며 `1.0`으로 승격하지 않습니다.
+
 ## 목차
 
 - [설치](#설치)
 - [사용 시점](#사용-시점)
+- [Zero-to-First-Page Workflow](#zero-to-first-page-workflow)
 - [Stable SSR Mental Model](#stable-ssr-mental-model)
+- [React 사용자 개념 번역](#react-사용자-개념-번역)
 - [런타임 및 피어 계약](#런타임-및-피어-계약)
 - [Phase Boundaries](#phase-boundaries)
 - [ReactModule Registration](#reactmodule-registration)
+- [Application Page Renderer](#application-page-renderer)
+- [Render Policy Decorators](#render-policy-decorators)
+- [SSR Diagnostic Phases](#ssr-diagnostic-phases)
+- [HTTP Error Documents](#http-error-documents)
 - [Router 및 Path Decorators](#router-및-path-decorators)
+- [Bootstrap-Resolved Page Catalog](#bootstrap-resolved-page-catalog)
+- [Path-Only Page Type Generation](#path-only-page-type-generation)
+- [Consumer Testing Loop](#consumer-testing-loop)
 - [Web Streams SSR](#web-streams-ssr)
 - [Hydration Asset Contract](#hydration-asset-contract)
 - [Vite Asset Manifest Integration](#vite-asset-manifest-integration)
 - [Client Navigation Runtime](#client-navigation-runtime)
+- [Native Form Mutations](#native-form-mutations)
 - [Experimental RSC Prototype](#experimental-rsc-prototype)
 - [Experimental Server Functions](#experimental-server-functions)
 - [RSC Graduation Policy](#rsc-graduation-policy)
@@ -27,8 +39,8 @@ fluo 애플리케이션을 위한 런타임 중립 React 통합입니다.
 
 ## 설치
 
-이 패키지의 첫 공개 릴리스 목표는 `0.1.0`입니다. manifest는 `0.0.0`에서 시작해
-Changesets가 표준 릴리스 워크플로를 통해 초기 `0.1.0` 버전을 게시할 수 있게 합니다.
+이 패키지는 초기 `0.1.0` 릴리스를 완료했으며 더 이상 `0.0.0` bootstrap placeholder를 사용하지
+않습니다. 이후 버전은 commit된 Changeset으로 기록하고 canonical release workflow를 통해서만 게시합니다.
 
 패키지가 게시되면 React와 React DOM을 peer로 함께 설치합니다.
 
@@ -44,6 +56,35 @@ router를 일반 module controller metadata에 배치하고, `@Router(...)`와 `
 controller 및 `GET` route metadata 위의 React facade이므로 request DTO binding, versioning,
 guards, interceptors, headers, route validation, matching, dispatch는 계속 HTTP runtime contract를 사용합니다.
 
+## Zero-to-First-Page Workflow
+
+첫 page를 편집하기 전에 모든 stable seam을 직접 조립하지 않고 streamed SSR, hydration, Vite asset을
+사용하려면 공식 generated composition으로 시작하세요.
+
+```bash
+fluo new my-react-app --starter react-vite-ssr
+cd my-react-app
+pnpm dev
+```
+
+`/products/sku-42?preview=true`를 열고 `src/page.tsx`를 편집합니다. 명시적인
+`@Router(...)` / `@Path(...)` handler는 `src/app.ts`에 남아 `createElement(ProductPage)`를 하나의
+`ReactElement`로 반환하므로 matching, DTO binding/validation, middleware, guard, interceptor, request scope,
+not-found behavior는 계속 `@fluojs/http`가 소유합니다.
+
+Generated wiring은 첫 편집에 부수적인 작업을 다음 application file로 이동합니다.
+
+- `src/entry-server.tsx`는 교체 가능한 `ReactPageRenderer`를 소유하고, application이 로드한 manifest를
+  `@fluojs/react/vite`로 parse하며, `createReactServerEntry(...)`로 `ReactServerEntry`를 반환합니다.
+- `src/react-app.tsx`는 server rendering과 hydration에 하나의 document,
+  `ReactClientRouterProvider`, route snapshot, stylesheet composition을 제공합니다.
+- `src/entry-client.tsx`는 같은 tree를 hydrate하고, `src/main.ts`와 `src/load-manifest.ts`는
+  filesystem loading 및 actionable build-output failure를 Node.js application boundary에 유지합니다.
+
+Advanced application은 generated renderer를 교체하거나 `createReactServerEntry(...)`에 명시적인
+hydration option을 전달할 수 있으며 아래 stable API도 그대로 사용할 수 있습니다. Runtime-neutral root
+export는 Node.js, Vite, browser code를 import하지 않고, starter는 별도 route matcher를 추가하지 않습니다.
+
 ## Stable SSR Mental Model
 
 안정 `0.1.0` 모델은 HTTP-first React SSR입니다. `@Router(...)`와 `@Path(...)`는
@@ -56,8 +97,17 @@ guards, interceptors, headers, module middleware, request scope, request lifecyc
 따라서 이 패키지는 Next.js App Router clone, React Server Components framework, TanStack route tree,
 Angular `Routes[]` table, file-route scanner, primary React-owned `routes: []` configuration model이
 **아닙니다**. React router는 page 형태를 가진 HTTP handler로 이해하세요. Route discovery와 dispatch는
-기존 fluo module/controller pipeline에 남아 있고, page handler는 일반 값을 반환하거나 streamed HTML이
-필요할 때 `createReactServerEntry(...)`를 반환합니다.
+기존 fluo module/controller pipeline에 남아 있습니다. Page handler는 일반 HTTP 값을 반환하거나,
+configured application page renderer가 처리할 유효한 `ReactElement` 하나를 반환하거나, route별 SSR option이
+필요할 때 `createReactServerEntry(...)`를 명시적으로 반환할 수 있습니다.
+
+## React 사용자 개념 번역
+
+Page, layout, loader, action, navigation, pending UI, metadata, hydration, build asset 용어에서
+출발한다면 간결한 [fluo의 React 개념 가이드](../../docs/guides/react-user-concepts.ko.md)를 사용하세요.
+이 가이드는 shipped equivalent, intentionally different behavior, experimental surface, unsupported
+concept를 구분하고, `@Router(...)`/`@Path(...)`에서 application renderer, Vite asset, hydration,
+client navigation, native form mutation으로 이어지는 실행 가능한 path 하나를 따라갑니다.
 
 ## 런타임 및 피어 계약
 
@@ -129,8 +179,275 @@ class AppModule {}
 source가 되므로 `createHandlerMapping(...)`과 `Dispatcher`가 계속 duplicate route detection,
 module-level middleware, request scope 생성, guard 및 interceptor 실행, route versioning을 담당합니다.
 
+## Application Page Renderer
+
+모든 page가 같은 document shell, provider, hydration asset, route snapshot wiring,
+recoverable-render policy를 공유해야 한다면 application-owned `renderPage` callback 하나를 등록하세요.
+Callback은 `ReactPageRenderer`를 구현하고 하나의 `ReactElement`와 활성 `ReactRenderContext`를 받아
+`ReactServerEntry`를 반환해야 합니다. `ReactModule.forRoot(...)`는 callback을
+`REACT_PAGE_RENDERER`로 등록하고 export하므로 router는 별도 response path를 만들지 않고 callback을
+inject할 수 있습니다.
+
+```tsx
+import { Module } from '@fluojs/core';
+import {
+  Path,
+  ReactModule,
+  Router,
+  createReactServerEntry,
+  type ReactPageRenderer,
+  type ReactRenderContext,
+} from '@fluojs/react';
+import {
+  ReactClientRouterProvider,
+  createReactRouteSnapshot,
+} from '@fluojs/react/client';
+
+const hydrationOptions = {
+  assetMap: { 'client.js': '/assets/client.123.js' },
+  bootstrapModules: ['/assets/client.123.js'],
+} as const;
+
+const renderPage: ReactPageRenderer = (page, context) => {
+  const initialSnapshot = createReactRouteSnapshot({
+    params: context.request.params,
+    url: context.request.url,
+  });
+
+  return createReactServerEntry(
+    <html lang="ko">
+      <body>
+        <ReactClientRouterProvider initialSnapshot={initialSnapshot}>
+          {page}
+        </ReactClientRouterProvider>
+      </body>
+    </html>,
+    hydrationOptions,
+  );
+};
+
+@Router('/products')
+class ProductRouter {
+  @Path('/:id')
+  show(_input: undefined, context: ReactRenderContext) {
+    return <main>Product {context.request.params.id}</main>;
+  }
+}
+
+@Module({
+  imports: [ReactModule.forRoot({ controllers: [ProductRouter], renderPage })],
+})
+class AppModule {}
+```
+
+Root package는 `@fluojs/react/client`나 `@fluojs/react/vite`를 import하지 않습니다. 애플리케이션은 위와
+같이 client helper를 명시적으로 compose할 수 있고, 이미 로드한 manifest를
+`createReactViteAssetManifest(...)`로 처리해 얻은 hydration option을 callback closure에서 사용할 수
+있습니다. Renderer는 manifest discovery, bundle generation, route matching을 수행하지 않으며 DTO
+binding, middleware, guard, interceptor, request scope, abort propagation, shell failure handling,
+recoverable streaming behavior를 우회하지 않습니다.
+
+`renderPage`가 configured 상태라면 `@Path(...)` request의 최종 값 중 React
+`isValidElement(...)`가 단일 `ReactElement`로 판별한 값만 callback에 전달합니다. Plain object, string,
+array, `null`, 그 밖의 일반 값은 기존 HTTP response path를 유지합니다. 명시적인 `ReactServerEntry`는
+그대로 유지되고 configured callback을 통과하지 않습니다. 다른 application provider가 같은 renderer를
+명시적으로 호출해야 할 때는 `REACT_PAGE_RENDERER` token을 계속 사용할 수 있습니다.
+
+`renderPage`를 설정하지 않고 `ReactElement`를 반환하면 response commit 전에
+`ReactSsrDiagnosticError`가 발생합니다. Code는 `react-ssr-missing-page-renderer`이고 해결 방법을 포함한
+message를 제공합니다. `ReactModule.forRoot({ ..., renderPage })`를 설정하거나
+`createReactServerEntry(...)`를 명시적으로 반환하세요.
+
+## Render Policy Decorators
+
+React router class 또는 `@Path(...)` method 하나에 route-local composition이 필요하지만 application은
+하나의 `renderPage` callback을 유지해야 할 때 `@PageLayout(...)`, `@SuspenseFallback(...)`,
+`@PageMetadata(...)`를 사용하세요. Layout과 fallback decorator는 미리 생성한 JSX element가 아니라
+component reference를 받고, `PageMetadata`는 synchronous request-aware factory를 받습니다. Metadata는 HTTP
+matching 이후 resolve되어 application page renderer에만 전달되며 path, matching precedence, param, error,
+not-found behavior를 변경하지 않습니다.
+
+```tsx
+import { Suspense, createElement, type ReactElement } from 'react';
+import {
+  PageLayout,
+  PageMetadata,
+  Path,
+  ReactModule,
+  Router,
+  SuspenseFallback,
+  createReactPageMetadataElements,
+  createReactServerEntry,
+  resolveReactPageMetadata,
+  type ReactPageLayoutProps,
+  type ReactPageRenderer,
+  type ReactSuspenseFallbackProps,
+} from '@fluojs/react';
+
+function ShopLayout({ children, context }: ReactPageLayoutProps) {
+  return <section data-request-path={context.request.path}>{children}</section>;
+}
+
+function ProductFallback({ context }: ReactSuspenseFallbackProps) {
+  return <p>Loading {context.request.params.id}…</p>;
+}
+
+const renderPage: ReactPageRenderer = (page, context, policies) => {
+  const metadata = resolveReactPageMetadata(policies, context);
+  const pageBoundary = policies.suspenseFallback === undefined
+    ? page
+    : createElement(Suspense, {
+        fallback: createElement(policies.suspenseFallback, { context }),
+      }, page);
+  const composedPage = policies.layouts.reduceRight<ReactElement>(
+    (children, Layout) => createElement(Layout, { children, context }),
+    pageBoundary,
+  );
+
+  return createReactServerEntry(
+    <html lang="ko">
+      <head>{createReactPageMetadataElements(metadata)}</head>
+      <body>{composedPage}</body>
+    </html>,
+  );
+};
+
+@PageLayout(ShopLayout)
+@Router('/products')
+class ProductRouter {
+  @PageMetadata(({ request }) => ({
+    meta: [{ content: `Product ${request.params.id}`, name: 'description' }],
+    title: `Product ${request.params.id}`,
+  }))
+  @SuspenseFallback(ProductFallback)
+  @Path('/:id')
+  show() {
+    return <ProductPage />;
+  }
+}
+
+ReactModule.forRoot({ controllers: [ProductRouter], renderPage });
+```
+
+Resolved layout은 outermost에서 innermost 순서로 base class, derived class, base method, derived method를
+따릅니다. Layout은 inheritance 전체에서 compose됩니다. 가장 가까운 fallback이 우선하므로 method
+fallback은 class fallback을 대체하고 derived declaration은 base declaration을 대체합니다. Class 또는
+method site는 각 policy kind를 한 번만 선언할 수 있으며 같은 site의 duplicate는 bootstrap 중 실패합니다.
+
+Metadata factory는 같은 broad-to-specific class/method order를 사용합니다. 가장 가까운 defined title이
+우선합니다. Later `<meta>` descriptor는 같은 `name` 또는 `property` identity의 earlier descriptor를
+대체하고, later `<link>` descriptor는 정확히 같은 `rel`과 `href` pair를 대체합니다. 관련 없는 descriptor는
+declaration order를 유지합니다. `resolveReactPageMetadata(...)`는 freeze된 bounded snapshot을 반환하고,
+`createReactPageMetadataElements(...)`는 ordinary React title, meta, link element를 만들어 text와 attribute
+escaping을 React에 맡깁니다. 두 helper 모두 Vite asset을 discover하거나 script tag를 만들거나 raw HTML을
+허용하거나 임의 inline data를 serialize하지 않습니다.
+
+`ReactRenderContext`는 활성 request-scope `container`를 포함합니다. Policy component는 이 context를
+명시적인 prop으로 받지만 fluo가 React component를 DI로 instantiate하거나 token을 대신 resolve하지는
+않습니다. `renderPage` 없는 policy, `@Router(...)` 밖의 class policy, `@Path(...)` 밖의 method policy는
+`ReactRenderPolicyConfigurationError`와 `REACT_RENDER_POLICY_DIAGNOSTIC_CODES`의 stable value로
+bootstrap을 실패시킵니다.
+
+Metadata factory는 active `request`, optional `requestId`, handler 및 renderer와 같은 request-scope
+`container` identity를 가진 `ReactPageMetadataContext`를 받습니다. 이 context는 의도적으로 `response`를
+제외하므로 metadata가 status, header, commit timing을 바꿀 수 없습니다. fluo는 factory를 DI로
+instantiate하거나 token을 대신 resolve하지 않습니다. Async data는 page composition 전에 matched HTTP
+handler에서 load해야 하며 metadata factory는 synchronous로 유지됩니다.
+
+`@SuspenseFallback(...)`은 SSR 중 suspend하는 descendant를 위한 ordinary React Suspense fallback을
+제공합니다. Handler `await`, effect, event handler, native form submission, full-document/client navigation
+pending state는 관찰하지 않습니다. HTTP pipeline error, not-found/404 response, pre-commit shell failure,
+request abort, post-shell recoverable error는 기존의 별도 phase를 유지합니다. 전체 ordering, inheritance,
+duplicate, phase 결정은 [React render policy decorator decision](../../docs/architecture/react-render-policy-decorators.ko.md)에
+기록되어 있습니다. 후속 [React page render policy decision](../../docs/architecture/react-page-render-policies.ko.md)은
+metadata를 채택하지만 generic error-presentation decorator와 page-local not-found presentation은 거부합니다.
+HTTP pipeline failure, shell failure, post-shell recoverable error, request abort, client React error, unmatched
+route, handler-thrown `NotFoundException` outcome은 기존 owner를 유지합니다. Placeholder error 또는
+not-found export는 제공하지 않습니다.
+
+## SSR Diagnostic Phases
+
+Application logging이나 diagnostics tooling이 HTTP 및 React rendering boundary 전체에서 하나의 안정된 event
+shape를 사용해야 한다면 `ReactModule.forRoot(...)`에 `onDiagnostic`을 등록하세요.
+
+```tsx
+ReactModule.forRoot({
+  controllers: [ProductRouter],
+  renderPage,
+  onDiagnostic(diagnostic) {
+    applicationDiagnostics.report(diagnostic);
+  },
+});
+```
+
+각 `ReactSsrDiagnostic`은 `code`, `phase`, 원본 `error`, 활성 `request`, optional `requestId`를
+포함합니다. Callback은 observational contract입니다. Callback이 throw해도 request outcome을 대체하지
+않습니다. Stable phase와 code는 다음과 같습니다.
+
+| Phase | Code | Boundary |
+| --- | --- | --- |
+| `http-pipeline` | `react-ssr-http-pipeline-failure` | React shell rendering 전 DTO binding, middleware, guard, interceptor, handler 및 기타 HTTP pipeline failure입니다. |
+| `http-pipeline` | `react-ssr-missing-page-renderer` | 유효한 `ReactElement`가 `renderPage` 설정 없이 `@Path(...)` response에 도달했습니다. |
+| `pre-commit-shell` | `react-ssr-pre-commit-shell-failure` | Response commit 전 React shell 생성 또는 buffered stream collection이 실패했습니다. 원본 throw된 `Error` identity를 보존합니다. |
+| `request-abort` | `react-ssr-request-abort` | Request signal 또는 abort probe가 React rendering을 중단했습니다. 기존 no-commit 또는 committed-stream abort behavior는 바뀌지 않습니다. |
+| `post-shell-recoverable` | `react-ssr-post-shell-recoverable-error` | Shell을 쓸 수 있게 된 뒤 React가 recoverable render error를 보고했습니다. Status와 header를 다시 쓰지 않습니다. |
+
+`REACT_SSR_DIAGNOSTIC_PHASES`와 `REACT_SSR_DIAGNOSTIC_CODES`는 비교에 사용할 수 있는 이 값을
+노출합니다. 기존 entry `onRecoverableError` hook도 `ReactRecoverableErrorContext`의 `code`와 `phase`를
+받습니다.
+
+## HTTP Error Documents
+
+Application이 HTTP error representation contract가 선택한 optional HTML byte를 React로 만들고 싶다면
+`createReactErrorRepresentationProvider(...)`를 사용한다.
+
+```tsx
+import { bootstrapApplication } from '@fluojs/runtime';
+import {
+  createReactErrorRepresentationProvider,
+  createReactServerEntry,
+} from '@fluojs/react';
+
+const html = createReactErrorRepresentationProvider({
+  renderDocument({ json }) {
+    return createReactServerEntry(
+      <html lang="ko">
+        <body><main>{json.error.status}: {json.error.message}</main></body>
+      </html>,
+    );
+  },
+});
+
+const app = await bootstrapApplication({
+  errorRepresentation: { html },
+  rootModule: AppModule,
+});
+```
+
+`@fluojs/http`가 adapter 실행 전에 route-miss conversion과 `Accept` negotiation을 수행한다. Callback은
+canonical JSON과 active request-scope container를 포함한 `HttpErrorRepresentationContext`를 받지만 response
+mutation authority는 받지 않는다. React entry는 HTTP가 status, `Content-Type`, `Vary`, `HEAD` suppression,
+commit을 적용하기 전에 완전히 buffer된다.
+
+예제의 `json.error.message`는 JSX text child이므로 React가 escape한다. 그래도 complete trusted-HTML document
+contract는 application이 소유한다. Request-derived 또는 error-derived content를 application이 승인한 sanitizer나
+동등한 trusted-content boundary 없이 `dangerouslySetInnerHTML`로 옮기면 안 된다.
+
+이 path에서는 `ReactServerEntry.status`와 `ReactServerEntry.headers`를 무시한다. Helper는
+`ReactPageRenderer`, `PageLayout`, `PageMetadata`, `SuspenseFallback`, page catalog를 호출하지 않고 URL도
+match하지 않는다. Render failure는 HTTP의 one-shot canonical JSON fallback으로 전달된다. Matched-page
+pre-commit shell failure는 별도 React SSR diagnostic phase로 남으며 provider를 호출하지 않는다. 자세한 계약은
+[HTTP error representation decision](../../docs/architecture/http-error-representations.ko.md)을 참고한다.
+
 ## Router 및 Path Decorators
 
+`@Path()`와 `@Path(undefined)`는 `''`를 사용하므로 `@Router('/cats')`에서는 GET `/cats`,
+`@Router()`에서는 GET `/`을 처리합니다. 명시적 `'/'`는 유효 route가 같지만 raw path가
+다르며 prefix를 무시하지 않습니다. Options를 생략하면 React metadata의 `options` 속성을
+만들지 않습니다. `Path(undefined, options)`는 명시적 options를 기록합니다. HTTP, React,
+inspection metadata와 route 충돌/grammar 거부 계약은 유지하며, `PageLayout`,
+`SuspenseFallback`, `PageMetadata`에는 계속 값이 필요합니다.
+
 `@Router(basePath)`는 class를 React router로 표시하고 `@Controller(basePath)`와 동등한 HTTP
 controller metadata를 기록합니다. 또한 diagnostics 및 향후 rendering integration을 위해
 `getReactRouterMetadata(...)`로 읽을 수 있는 React router marker metadata를 저장합니다.
@@ -172,9 +489,151 @@ regex-like token, `user-:id` 같은 mixed literal/parameter segment, `:id.json`
 wildcard 도입을 유예합니다. React는 자체 syntax를 추가하지 않습니다. Page handler는 명시적인 server
 route를 유지해야 하며, 향후 catch-all은 먼저 승인된 `@fluojs/http` contract가 되어야 합니다.
 
+## Bootstrap-Resolved Page Catalog
+
+Tooling에서 React page의 read-only 목록이 필요하면 HTTP handler compilation 이후
+`createReactPageCatalog(...)`를 사용합니다. `createHandlerMapping(...)` 또는
+`app.dispatcher.describeRoutes()`가 제공하는 authoritative `HandlerDescriptor[]`를 넘기세요. 결과에는
+`@Router(...)`와 `@Path(...)` marker를 모두 가진 handler만 descriptor registration order로 포함됩니다.
+
+```ts
+import { createHandlerMapping } from '@fluojs/http';
+import { createReactPageCatalog } from '@fluojs/react';
+
+const mapping = createHandlerMapping([{ controllerToken: ProductRouter }]);
+const pages = createReactPageCatalog(mapping.descriptors);
+
+console.log(pages[0]);
+// {
+//   kind: 'react-page', method: 'GET', path: '/v2/products/:productId',
+//   version: '2', params: ['productId'], router: 'ProductRouter', handler: 'show'
+// }
+```
+
+`getReactRouterMetadata(...)`와 `getReactPathMetadata(...)`는 router base path, relative page path,
+React option처럼 decorator site에 작성된 static 값을 노출합니다. Catalog는 다릅니다. Method, path,
+version, params, module, router, handler field는 bootstrap-resolved HTTP descriptor에서 project되므로
+controller composition과 URI versioning이 이미 반영되어 있습니다. 반환 array, entry, `params` array는
+모두 freeze된 defensive snapshot입니다.
+
+Catalog 생성은 관찰 전용입니다. HTTP matcher를 호출하거나 대체하지 않으며 route conflict detection,
+request dispatch, not-found behavior, non-React handler에 관여하지 않습니다. Route tree, client manifest,
+relative-route model, prefetch layer, cache도 만들지 않습니다.
+
+## Path-Only Page Type Generation
+
+`fluo typegen`은 application module을 bootstrap하고 compiled React page catalog를 project한 뒤
+application-owned TypeScript route helper를 작성합니다. 출력은 전용 `@fluojs/react/typegen` subpath에서
+생성되며 runtime-neutral package root는 generator를 export하지 않습니다.
+
+```bash
+fluo typegen ./src/app.ts --output ./src/generated/react-pages.ts
+fluo typegen ./src/admin.ts --export AdminModule --output ./src/generated/admin-pages.ts
+fluo typegen ./src/app.ts --output ./src/generated/react-pages.ts --check
+fluo typegen ./src/app.ts --output ./src/generated/react-pages.ts --watch
+```
+
+명령은 필요하면 output directory를 만들고 stale output을 deterministic하게 덮어쓰며 `CREATE`,
+`UPDATE`, `UNCHANGED` 중 하나를 보고합니다. Atomic replacement는 partial publication을 막고 byte-identical
+run은 파일을 다시 쓰지 않습니다. `--check`는 write 없이 exact generated byte를 비교하며 structure가
+손상된 현재-version body를 stale이 아닌 malformed로 분류합니다. `--watch`는 startup generation 전에
+application-module watcher를 설치하고, 해당 generation 중 관찰된 change를 readiness 전에 한 번 rerun한
+뒤 coalesced change를 serialize하며 generation failure 뒤에도 마지막 valid artifact를 보존합니다. 각
+generation은 native `.js`와 `.mjs` dependency를 현재 module graph에서 평가합니다. 모든 run은
+`app.dispatcher.describeRoutes()`를 읽은 뒤 bootstrap한 application을 닫습니다. 생성 artifact는
+application code에서 import합니다.
+
+```ts
+import {
+  reactPageRoutes,
+  type ReactPageParams,
+  type ReactPagePath,
+  type ReactPageRouteId,
+} from './generated/react-pages.js';
+
+const productHref = reactPageRoutes['GET /products/:productId ProductRouter show'].href({
+  productId: 'desk/chair',
+});
+// /products/desk%2Fchair
+```
+
+생성 route id는 stable catalog `id`를 사용합니다. Static builder는 parameter를 받지 않고 dynamic
+builder는 모든 catalog path parameter를 요구하며 각 값을 `encodeURIComponent(...)`로 encode합니다.
+Artifact는 `ReactPagePathById`, `ReactPageParamsById`, `ReactPagePath<RouteId>`,
+`ReactPageParams<RouteId>`, `ReactPageRoute`, `ReactPageLinkProps`, `ReactPageNavigator`도 export합니다.
+
+각 generated route는 같은 href builder를 declarative `Link`와 programmatic `push`/`replace` authoring에도
+연결합니다. `link(...)`는 기존 real-anchor `Link`에 전달할 일반 `{ href: string }` object를 반환하고,
+`push(router, ...)`와 `replace(router, ...)`는 같은 absolute href를 resolve한 뒤 기존 `ReactRouter` string
+overload를 호출합니다. 따라서 두 번째 runtime route table 없이 route identity와 정확한 param이 callsite에
+계속 드러납니다.
+
+```tsx
+import { Link, useRouter } from '@fluojs/react/client';
+import { reactPageRoutes } from './generated/react-pages.js';
+
+const productsRoute = reactPageRoutes['GET /products ProductRouter index'];
+const productRoute = reactPageRoutes['GET /products/:productId ProductRouter show'];
+
+function ProductNavigation({ productId }: { readonly productId: string }) {
+  const router = useRouter();
+
+  return (
+    <nav>
+      <Link {...productsRoute.link()}>Products</Link>
+      <Link {...productRoute.link({ productId })}>Current product</Link>
+      <button type="button" onClick={() => productRoute.push(router, { productId })}>Open</button>
+      <button type="button" onClick={() => productRoute.replace(router, { productId })}>Replace</button>
+    </nav>
+  );
+}
+```
+
+Static `link`, `push`, `replace` method는 param을 받지 않고 parameterized method는 모든 path param을
+요구하며 누락되거나 추가된 key를 거부합니다. 기존 generated `href(...)` builder,
+`<Link href={stringOrUrl}>`, `router.push(...)` / `router.replace(...)`의 string 또는 `URL` 호출은 계속
+지원됩니다. Generated method는 absolute href string을 생성하거나 기존 API에 전달할 뿐이므로 real-anchor
+fallback, full-document HTTP navigation, matching, DTO binding, guard, interceptor, not-found behavior는 현재
+owner를 그대로 유지합니다.
+
+이 contract는 의도적으로 path-only입니다. Query string, fragment, relative route, optional parameter,
+client route tree를 생성하지 않습니다. Typegen은 `version`이 있는 모든 catalog entry를 거부합니다.
+Compiled catalog만으로는 version selection이 URI, header, media type, custom strategy 중 어디에서
+왔는지 구분할 수 없으므로 하나의 absolute href를 생성하면 실제와 다른 URL contract를 약속할 수
+있기 때문입니다.
+
+## Consumer Testing Loop
+
+기존 React, HTTP, testing, TypeScript, browser seam을 하나의 layered consumer loop로 사용하세요. 반복 setup은
+일반 fixture로 이미 격리할 수 있고 request test의 대상은 real dispatcher여야 하므로 React-specific testing
+helper를 추가할 필요가 없습니다.
+
+1. **Render-policy unit**: Pure policy 및 metadata helper를 직접 호출합니다. Browser bootstrap 없이
+   broad-to-specific layout order, nearest fallback 또는 metadata precedence, configuration diagnostic을 검증합니다.
+2. **Request dispatch**: 작성한 module을 `createTestApp({ rootModule })`로 만들고 explicit `@Path(...)` route를
+   `app.request(...).send()`로 요청한 뒤 `finally`에서 app을 닫습니다. Direct `ReactElement` return과
+   missing-renderer diagnostic을 포함해 real HTTP dispatcher, request scope, response ownership, application
+   renderer를 함께 검증합니다.
+3. **Generated-route compilation**: Bootstrapped `HandlerDescriptor` catalog에서 generate하고 positive/negative
+   consumer fixture에 TypeScript를 실행하며 CI에서 `fluo typegen ... --check`를 실행합니다. Positive fixture는
+   known route id와 complete param을 사용하고 negative fixture는 unknown id, missing/extra param 및 stale,
+   malformed, missing, unsupported-version artifact를 검증합니다.
+4. **Hydration**: 같은 application component를 server에서 render하고 `hydrateRoot(...)`로 hydrate합니다.
+   Positive fixture는 diagnostic 없이 interaction이 동작해야 합니다. 의도적으로 mismatch한 fixture는
+   `onRecoverableError`를 capture해 mismatch reporting 자체의 regression을 막습니다.
+5. **Production browser 및 progressive enhancement**: Build asset을 대상으로 Playwright를 실행하고
+   console/page error에서 실패하게 합니다. 별도 `javaScriptEnabled: false` context에서 native form을 일반
+   `POST` → `303` → `GET` flow로 submit합니다.
+
+Executable reference는 `src/render-policy.test.ts`, `src/direct-page-return.test.ts`,
+`../cli/src/commands/typegen-navigation.test.ts`, `../../examples/react-vite-ssr/src/app.test.ts`,
+`../../examples/react-vite-ssr/src/hydration.test.ts`,
+`../../examples/react-vite-ssr/tests/production-hydration.spec.ts`입니다.
+
 ## Web Streams SSR
 
-React page handler에서 `createReactServerEntry(...)`를 반환하면 기존 fluo HTTP dispatcher를 통해 HTML을
+Configured application page renderer를 통해 `ReactElement` 하나를 반환하거나
+`createReactServerEntry(...)`를 명시적으로 반환하면 기존 fluo HTTP dispatcher를 통해 HTML을
 streaming합니다. Guard, interceptor, module middleware, route header, `@HttpCode(...)`, DTO binding,
 request scope, duplicate route detection은 모두 `renderReactResponse(...)`가 HTML response를 finalize하기
 전에 실행됩니다.
@@ -212,6 +671,9 @@ Renderer는 기본적으로 `react-dom/server`의 `renderToReadableStream(...)`
 throw합니다. Recoverable Suspense error는 `onRecoverableError`로 보고되며 이미 committed된 status를 다시
 쓰지 않습니다. Handler가 entry를 dispatcher에 반환하지 않고 직접 response를 finalize해야 할 때만
 `renderReactResponse(entry, requestContext)`를 호출하세요.
+Streaming host에서는 response sink가 일찍 닫히거나 `write(...)` / `waitForDrain()`이 실패하면 완료되지
+않은 React reader를 정확히 한 번 cancel하고 lock을 해제합니다. Sink failure는 reader cancellation cleanup에
+의해 대체되지 않고 원래 failure로 보고됩니다.
 
 ## Hydration Asset Contract
 
@@ -407,6 +869,82 @@ server는 명시적인 `@Path(...)`/HTTP route를 match하거나 정상적인 no
 의도적인 deployment-level document rewrite를 별도로 설정할 수 있지만, 이는 React route grammar를 만들거나
 server DTO validation을 변경하지 않습니다.
 
+## Native Form Mutations
+
+React page mutation이 hydration 전이나 client JavaScript disabled 환경에서도 동작해야 한다면 native HTML
+form을 사용하세요. React-owned action transport를 만들지 말고 일반 `@Post(...)` route로 제출합니다. 실행 가능한
+`examples/react-vite-ssr/` slice는 `multipart/form-data`를 사용합니다. Browser가 multipart boundary를
+제공하면 기존 adapter와 `@RequestDto(...)` body-binding path가 field를 materialize합니다.
+
+```tsx
+function ProductForm({ name, sku }: { readonly name: string; readonly sku: string }) {
+  return (
+    <form action={`/products/${encodeURIComponent(sku)}`} encType="multipart/form-data" method="post">
+      <label htmlFor="product-name">Product name</label>
+      <input defaultValue={name} id="product-name" minLength={3} name="name" required />
+      <button type="submit">Save product</button>
+    </form>
+  );
+}
+```
+
+Target은 일반 HTTP handler로 남습니다. DTO binding과 validation은 request boundary에서 한 번 실행되고,
+module middleware, guard, interceptor, request-scoped provider, observer, adapter response writing은 일반
+HTTP pipeline의 ordering과 ownership을 그대로 유지합니다.
+
+```ts
+import {
+  FromBody,
+  FromPath,
+  Post,
+  RequestDto,
+  type RequestContext,
+  UseGuards,
+  UseInterceptors,
+} from '@fluojs/http';
+import { Router } from '@fluojs/react';
+import { IsString, MinLength } from '@fluojs/validation';
+
+class RenameProductRequest {
+  @MinLength(3, {
+    code: 'PRODUCT_NAME_TOO_SHORT',
+    message: 'Product name must contain at least 3 characters.',
+  })
+  @IsString()
+  @FromBody('name')
+  name = '';
+
+  @IsString()
+  @FromPath('sku')
+  sku = '';
+}
+
+@Router('/products')
+class ProductRouter {
+  @Post('/:sku')
+  @RequestDto(RenameProductRequest)
+  @UseGuards(EditorGuard)
+  @UseInterceptors(MutationAuditInterceptor)
+  rename(input: RenameProductRequest, context: RequestContext) {
+    productCatalog.rename(input.sku, input.name);
+    context.response.redirect(303, `/products/${encodeURIComponent(input.sku)}?updated=true`);
+  }
+}
+```
+
+잘못된 제출은 canonical HTTP `400` validation envelope를 유지합니다. `details` entry에는 안전한 field,
+source, code, application-authored validation message만 포함하고 제출 값, stack, internal exception은 노출하지
+않습니다. 성공한 mutation은 `303 See Other`를 사용하므로 browser가 `GET`으로 후속 요청을 보내고, destination은
+일반 HTTP dispatcher를 통해 다시 match됩니다. Authorization과 CSRF policy는 애플리케이션 책임입니다.
+Non-React route와 같은 session/cookie, guard, middleware policy를 사용하세요.
+
+이 recipe는 React Router action/fetcher, Astro Actions, Next.js Server Actions와 의도적으로 다릅니다. fluo는
+function reference를 compile하거나, route matching을 소유하거나, loader/client cache를 revalidate하거나,
+document response를 교체하지 않습니다. Experimental fluo Server Functions transport와도 별개입니다. Native
+form이 이미 완전한 fallback을 제공하고 `@fluojs/react/client`가 mutation route나 cache invalidation을 소유하지
+않으므로 이 phase에서는 stable submit-state helper를 추가하지 않습니다. Application은 실제 form action과
+native submission을 유지하는 경우에만 hydration 이후 local pending UI를 추가할 수 있습니다.
+
 ## Experimental RSC Prototype
 
 > **Experimental contract:** `@fluojs/react/experimental/rsc`는 명시적인 graduation issue가 RSC API를
@@ -474,6 +1012,10 @@ Flight encoding도 애플리케이션이 소유합니다. 선택한 renderer가
 interceptor, request scope, error, adapter response writing을 계속 소유합니다. Helper는 고정된
 `text/x-component; charset=utf-8` content type만 추가하며 별도 router를 만들지 않습니다.
 
+Streamed Flight payload도 stable SSR과 같은 lifecycle guarantee를 사용합니다. Response sink가 일찍 닫히거나
+write/drain이 실패하면 완료되지 않은 reader를 정확히 한 번 cancel하고 lock을 해제하며, sink failure는 일반
+HTTP error pipeline에 그대로 전달합니다.
+
 ```ts
 import { Controller, Get } from '@fluojs/http';
 import { createReactFlightResponse } from '@fluojs/react/experimental/rsc';
@@ -624,9 +1166,15 @@ stable subpath를 추가하지 않고 deprecation window도 시작하지 않습
 - Next.js App Router, TanStack route tree, Angular `Routes[]`, file-route scanner, React-owned
   `routes: []` table
 - 자동 client bundle 생성
+- versioned React page의 href 생성. Catalog가 URI versioning과 non-path version strategy를 구분할 수
+  있을 때까지 path-only typegen은 versioned catalog entry를 거부합니다.
 - filesystem scanning 또는 자동 manifest file discovery. 이미 로드한 manifest 값을 `@fluojs/react/vite`에 넘기세요.
 - `bootstrapScriptContent`로 임의 data를 자동 serialize하는 기능
 - `renderToPipeableStream(...)` 같은 Node 전용 `react-dom/server` pipeable stream root API
+- Next.js-style segment `loading`, `error`, `notFound`, template 또는 layout ancestry semantic.
+  `@SuspenseFallback(...)`은 SSR-descendant Suspense metadata만 제공합니다.
+- generic page error-presentation policy 또는 page-local not-found renderer. Optional HTML은
+  global/application HTTP representation이며 page ancestry나 matching semantic을 추가하지 않습니다.
 
 ## Public API
 
@@ -634,16 +1182,55 @@ stable subpath를 추가하지 않고 deprecation window도 시작하지 않습
 - `Path` — HTTP `GET` route metadata와 React render metadata를 함께 기록하는 method decorator입니다.
 - `getReactRouterMetadata` — router class에서 React router marker metadata를 읽습니다.
 - `getReactPathMetadata` — router method에서 React render metadata를 읽습니다.
+- `createReactPageCatalog` — matching이나 dispatch에 관여하지 않고 authoritative compiled HTTP
+  descriptor에서 freeze된 read-only React page catalog를 만듭니다.
+- `ReactPageCatalogEntry` — effective HTTP method/path/version/params와 originating router/handler를
+  담는 type-only bootstrap-resolved page descriptor입니다.
+- `@fluojs/react/typegen` subpath — package root를 넓히거나 runtime route table을 추가하지 않고
+  deterministic path-only declaration, versioned artifact check, absolute href builder, route-bound `Link` prop,
+  typed `push`/`replace` method를 제공하는 `generateReactPageTypes(...)`,
+  `inspectReactPageTypeArtifact(...)`, `REACT_PAGE_TYPEGEN_ARTIFACT_VERSION`,
+  `ReactPageTypeArtifactInspection`, `ReactPageTypegenError`, `REACT_PAGE_TYPEGEN_ERROR_CODES`,
+  `ReactPageTypegenErrorCode`를 제공합니다.
 - `ReactModule` — `forRoot(...)`가 기존 fluo module/controller metadata path를 통해 React router를
   등록하는 런타임 중립 module facade입니다.
+- `REACT_PAGE_RENDERER` — `ReactModule.forRoot({ renderPage })`가 등록하는 application page renderer의
+  dependency-injection token입니다.
+- `ReactPageRenderer` — `ReactElement`와 활성 `ReactRenderContext`를 기존 `ReactServerEntry`로 compose하는
+  과정에 resolved `ReactRenderPolicies`도 전달받는 type-only application callback입니다.
+- `PageLayout`, `SuspenseFallback`, `PageMetadata` — renderer-only component reference 또는 synchronous
+  metadata factory 하나를 기록하는 class-or-method decorator입니다.
+- `resolveReactPageMetadata` — response mutation authority를 노출하지 않고 active request의 ordered metadata
+  factory를 compose합니다.
+- `createReactPageMetadataElements` — resolved metadata snapshot에서 ordinary escaped React title, meta, link
+  element를 생성합니다.
+- `getReactRenderPolicies` — inherited class/method policy를 outer-to-inner order로 resolve합니다.
+- `REACT_RENDER_POLICY_DIAGNOSTIC_CODES` 및 `ReactRenderPolicyConfigurationError` — duplicate,
+  invalid-target, invalid-reference, missing-renderer policy declaration을 위한 stable bootstrap diagnostic입니다.
+- `ReactPageLayout`, `ReactPageLayoutProps`, `ReactSuspenseFallback`,
+  `ReactSuspenseFallbackProps`, `ReactRenderPolicies`, `ReactRenderPolicyDiagnosticCode` — type-only
+  render-policy composition contract입니다.
+- `ReactPageMetadata`, `ReactPageMetadataFactory`, `ReactPageMetadataContext`, `ReactPageMeta`,
+  `ReactPageLink` — type-only bounded page metadata contract입니다.
+- `REACT_SSR_DIAGNOSTIC_PHASES` 및 `REACT_SSR_DIAGNOSTIC_CODES` — stable machine-readable SSR
+  lifecycle phase 및 diagnostic code constant입니다.
+- `ReactSsrDiagnosticError` — stable `code`와 `phase` metadata를 가진 typed pre-commit
+  configuration/render failure입니다.
+- `ReactSsrDiagnostic`, `ReactSsrDiagnosticCode`, `ReactSsrDiagnosticErrorOptions`,
+  `ReactSsrDiagnosticHandler`, `ReactSsrDiagnosticPhase` — application diagnostics tooling을 위한
+  type-only contract입니다.
+- `createReactErrorRepresentationProvider` — application React error document renderer를 HTTP-owned HTML
+  provider seam에 adapt하고 commit 전에 buffer합니다.
+- `ReactErrorDocumentRenderer`, `ReactErrorRepresentationProviderOptions` — application callback, optional
+  availability constraint, renderer override를 위한 type-only contract입니다.
 - `createReactServerEntry` — page handler가 Web Streams SSR을 위해 반환하는 runtime-neutral React server
   entry를 생성합니다.
 - `renderReactResponse` — lazy `react-dom/server` loading으로 React server entry 하나를 fluo HTML
   response에 렌더링합니다.
 - `ReactAssetMap`, `ReactBootstrapAsset`, `ReactBootstrapScriptDescriptor` — build-produced asset map 및
   React DOM bootstrap script/module entry를 위한 type-only contract입니다.
-- `ReactModuleOptions` — `controllers`, `imports`, `providers`, `exports`, module-level `middleware`를 포함하는
-  `ReactModule.forRoot(...)` option입니다.
+- `ReactModuleOptions` — `controllers`, `imports`, `providers`, `exports`, module-level `middleware`, optional
+  `renderPage` registration을 포함하는 `ReactModule.forRoot(...)` option입니다.
 - `ReactServerEntry`, `ReactServerEntryOptions`, `ReactServerEntryHeaders`,
   `ReactRecoverableErrorHandler`, `ReactRecoverableErrorContext`, `ReactRenderContext`,
   `ReactReadableStream`, `ReactReadableStreamRenderer`, `ReactReadableStreamRenderOptions`,
@@ -653,25 +1240,42 @@ stable subpath를 추가하지 않고 deprecation window도 시작하지 않습
   integration을 위한 type-only metadata contract입니다.
 - `@fluojs/react/vite` subpath — Vite manifest를 root에서 Vite를 import하지 않고 안정 hydration asset contract로
   파싱하는 `createReactViteAssetManifest(...)`, `ReactViteBuildManifest`, `ReactViteBuildManifestChunk`,
-  `ReactViteManifestOptions`, `ReactViteManifestDiagnostic`, `ReactViteAssetManifest`,
+  `ReactViteManifestEntries`, `ReactViteManifestOptions`, `ReactViteManifestDiagnostic`,
+  `ReactViteManifestDiagnosticCode`, `ReactViteAssetManifest`, `ReactViteAssetManifestResult`,
   `ReactViteHydrationOptions`, `ReactViteJavaScriptAssets`, `ReactViteBootstrapData`,
   `ReactViteResolvedEntry`를 제공합니다.
 - `@fluojs/react/client` subpath — root package를 넓히거나 client route grammar를 추가하지 않고
   progressive HTTP-first browser navigation을 제공하는 `Link`, `ReactClientRouterProvider`,
-  `createReactRouteSnapshot(...)`, `useRouter()`, `usePathname()`, `useParams()`,
-  `useSearchParams()`, `useNavigation()`, `useRouterState()`를 제공합니다.
-- `@fluojs/react/experimental/rsc` subpath — root re-export 없이 `inspectReactRscEnvironment(...)`,
-  `createReactRscManifest(...)`, `createReactFlightResponse(...)`, exact-version 및 Flight content type
-  constant, diagnostic, client-reference/server-module mapping type, signed
-  `createReactServerFunctionRegistry(...)`, 명시적인 `createReactServerFunctionClient(...)`, stable Server
-  Function error code와 관련 transport type을 제공하며 root나 stable-client에서 re-export하지 않습니다.
+  `ReactClientNavigationError`, `ReactClientRouterContextError`, `createReactRouteSnapshot(...)`,
+  `useRouter()`, `usePathname()`, `useParams()`, `useSearchParams()`, `useNavigation()`,
+  `useRouterState()`를 제공합니다. Type export는 `LinkProps`, `ReactClientNavigationErrorCode`,
+  `ReactClientRouterProviderProps`, `ReactNavigationSnapshot`, `ReactNavigationStatus`,
+  `ReactNavigationType`, `ReactReadonlySearchParams`, `ReactRouteSnapshot`,
+  `ReactRouteSnapshotInput`, `ReactRouter`입니다.
+- `@fluojs/react/experimental/rsc` subpath — runtime export는 `REACT_RSC_DIAGNOSTIC_CODES`,
+  `REACT_RSC_FLIGHT_CONTENT_TYPE`, `REACT_RSC_SUPPORTED_VERSION`,
+  `REACT_SERVER_FUNCTION_ERROR_CODES`, `REACT_SERVER_FUNCTION_REQUEST_HEADER`,
+  `ReactServerFunctionClientError`, `ReactServerFunctionConfigurationError`,
+  `createReactFlightResponse(...)`, `createReactRscManifest(...)`,
+  `createReactServerFunctionClient(...)`, `createReactServerFunctionRegistry(...)`,
+  `inspectReactRscEnvironment(...)`입니다. Type export는 `ReactFlightPayload`, `ReactFlightResponse`,
+  `ReactFlightResponseHeaders`, `ReactFlightResponseOptions`, `ReactRscBuildCapabilities`,
+  `ReactRscClientReference`, `ReactRscClientReferenceManifest`, `ReactRscDiagnostic`,
+  `ReactRscDiagnosticCode`, `ReactRscEnvironmentOptions`, `ReactRscManifest`,
+  `ReactRscManifestInput`, `ReactRscManifestResult`, `ReactRscRuntimeCapabilities`,
+  `ReactRscServerClientModuleMap`, `ReactRscSupportResult`, `ReactServerFunctionClient`,
+  `ReactServerFunctionClientOptions`, `ReactServerFunctionErrorCode`, `ReactServerFunctionFetch`,
+  `ReactServerFunctionHandler`, `ReactServerFunctionReference`, `ReactServerFunctionRegistry`,
+  `ReactServerFunctionRegistryOptions`, `ReactServerFunctionResponse`,
+  `ReactServerFunctionValue`이며 root나 stable client subpath에서 re-export하지 않습니다.
 
 ## 관련 패키지
 
 - `@fluojs/core`: 스캐폴드가 사용하는 standard `@Module` decorator를 제공합니다.
 - `@fluojs/http`: `@Router(...)`와 `@Path(...)`가 재사용하는 controller, route, DTO, guard,
   interceptor, header, version metadata pipeline을 제공합니다.
-- `@fluojs/runtime`: 향후 React 통합 작업은 root import boundary를 넓히지 않고 runtime bootstrap contract와 합성될 예정입니다.
+- `@fluojs/runtime`: React root import boundary를 넓히지 않고 기존 application bootstrap contract와 함께
+  optional HTTP error representation을 등록합니다.
 - `@fluojs/vite`: Vite TC39 decorator transform boundary를 소유합니다. React hydration manifest를 파싱하지
   않으므로 React server/client asset mapping에는 `@fluojs/react/vite`를 사용하세요.
 - Application-selected Flight renderer: RSC payload를 encode하고 renderer-specific build manifest를
@@ -688,6 +1292,7 @@ stable subpath를 추가하지 않고 deprecation window도 시작하지 않습
 - `packages/react/src/experimental/rsc.test.ts`
 - `packages/react/src/experimental/rsc-diagnostics.test.ts`
 - `packages/react/src/experimental/rsc-flight.test.ts`
+- `packages/react/src/experimental/rsc-flight-stream-lifecycle.test.ts`
 - `packages/react/src/experimental/rsc-manifest.test.ts`
 - `packages/react/src/experimental/server-functions-server.ts`
 - `packages/react/src/experimental/server-functions-client.ts`
@@ -698,7 +1303,15 @@ stable subpath를 추가하지 않고 deprecation window도 시작하지 않습
 - `packages/react/src/decorators.ts`
 - `packages/react/src/server-entry.ts`
 - `packages/react/src/render.ts`
+- `packages/react/src/error-representation.ts`
+- `packages/react/src/error-representation.test.ts`
 - `packages/react/src/module.ts`
+- `packages/react/src/page-renderer.ts`
+- `packages/react/src/render-policy.ts`
+- `packages/react/src/render-policy-metadata.ts`
+- `packages/react/src/render-policy.test.ts`
+- `packages/react/src/page-metadata.ts`
+- `packages/react/src/page-metadata.test.ts`
 - `packages/react/src/render.test.ts`
 - `packages/react/src/dispatcher-ssr.test.ts`
 - `packages/react/src/hydration-assets.test.ts`