vinext 0.0.49 → 0.0.51

package/dist/server/app-page-cache.js.map

@@ -1 +1 @@
-{"version":3,"file":"app-page-cache.js","names":[],"sources":["../../src/server/app-page-cache.ts"],"sourcesContent":["import type { CachedAppPageValue, CacheControlMetadata } from \"vinext/shims/cache\";\nimport { VINEXT_RSC_VARY_HEADER } from \"./app-rsc-cache-busting.js\";\nimport { buildCachedRevalidateCacheControl } from \"./cache-control.js\";\nimport { buildAppPageCacheValue, type ISRCacheEntry } from \"./isr-cache.js\";\nimport { readStreamAsText } from \"../utils/text-stream.js\";\n\ntype AppPageDebugLogger = (event: string, detail: string) => void;\ntype AppPageCacheGetter = (key: string) => Promise<ISRCacheEntry | null>;\ntype AppPageCacheSetter = (\n  key: string,\n  data: CachedAppPageValue,\n  revalidateSeconds: number,\n  tags: string[],\n  expireSeconds?: number,\n) => Promise<void>;\ntype AppPageBackgroundRegenerator = (key: string, renderFn: () => Promise<void>) => void;\ntype AppPageRequestCacheLife = {\n  revalidate?: number;\n  expire?: number;\n};\n\ntype AppPageCacheRenderResult = {\n  cacheControl?: CacheControlMetadata;\n  html: string;\n  rscData: ArrayBuffer;\n  tags: string[];\n};\n\ntype BuildAppPageCachedResponseOptions = {\n  cacheControl?: CacheControlMetadata;\n  cacheState: \"HIT\" | \"STALE\";\n  expireSeconds?: number;\n  isRscRequest: boolean;\n  mountedSlotsHeader?: string | null;\n  revalidateSeconds: number;\n};\n\ntype ReadAppPageCacheResponseOptions = {\n  cleanPathname: string;\n  clearRequestContext: () => void;\n  isRscRequest: boolean;\n  isrDebug?: AppPageDebugLogger;\n  isrGet: AppPageCacheGetter;\n  isrHtmlKey: (pathname: string) => string;\n  isrRscKey: (pathname: string, mountedSlotsHeader?: string | null) => string;\n  isrSet: AppPageCacheSetter;\n  mountedSlotsHeader?: string | null;\n  expireSeconds?: number;\n  revalidateSeconds: number;\n  renderFreshPageForCache: () => Promise<AppPageCacheRenderResult>;\n  scheduleBackgroundRegeneration: AppPageBackgroundRegenerator;\n};\n\ntype FinalizeAppPageHtmlCacheResponseOptions = {\n  capturedDynamicUsageBeforeContextCleanup?: () => boolean;\n  capturedRscDataPromise: Promise<ArrayBuffer> | null;\n  cleanPathname: string;\n  consumeDynamicUsage: () => boolean;\n  getPageTags: () => string[];\n  getRequestCacheLife?: () => AppPageRequestCacheLife | null;\n  isrDebug?: AppPageDebugLogger;\n  isrHtmlKey: (pathname: string) => string;\n  isrRscKey: (pathname: string, mountedSlotsHeader?: string | null) => string;\n  isrSet: AppPageCacheSetter;\n  preserveClientResponseHeaders?: boolean;\n  expireSeconds?: number;\n  revalidateSeconds: number | null;\n  waitUntil?: (promise: Promise<void>) => void;\n};\n\ntype ScheduleAppPageRscCacheWriteOptions = {\n  capturedRscDataPromise: Promise<ArrayBuffer> | null;\n  cleanPathname: string;\n  consumeDynamicUsage: () => boolean;\n  dynamicUsedDuringBuild: boolean;\n  getPageTags: () => string[];\n  getRequestCacheLife?: () => AppPageRequestCacheLife | null;\n  isrDebug?: AppPageDebugLogger;\n  isrRscKey: (pathname: string, mountedSlotsHeader?: string | null) => string;\n  isrSet: AppPageCacheSetter;\n  mountedSlotsHeader?: string | null;\n  preserveClientResponseHeaders?: boolean;\n  expireSeconds?: number;\n  revalidateSeconds: number | null;\n  waitUntil?: (promise: Promise<void>) => void;\n};\n\nconst NO_STORE_CACHE_CONTROL = \"no-store, must-revalidate\";\n\nexport function buildAppPageCacheTags(pathname: string, extraTags: readonly string[]): string[] {\n  const tags = [pathname, `_N_T_${pathname}`, \"_N_T_/layout\"];\n  const segments = pathname.split(\"/\");\n  let built = \"\";\n  for (let index = 1; index < segments.length; index++) {\n    const segment = segments[index];\n    if (segment) {\n      built += `/${segment}`;\n      tags.push(`_N_T_${built}/layout`);\n    }\n  }\n\n  tags.push(`_N_T_${built}/page`);\n  for (const tag of extraTags) {\n    if (!tags.includes(tag)) {\n      tags.push(tag);\n    }\n  }\n  return tags;\n}\n\nfunction buildAppPageCacheControl(\n  cacheState: BuildAppPageCachedResponseOptions[\"cacheState\"],\n  revalidateSeconds: number,\n  expireSeconds?: number,\n): string {\n  return buildCachedRevalidateCacheControl(cacheState, revalidateSeconds, expireSeconds);\n}\n\nfunction getCachedAppPageValue(entry: ISRCacheEntry | null): CachedAppPageValue | null {\n  return entry?.value.value && entry.value.value.kind === \"APP_PAGE\" ? entry.value.value : null;\n}\n\nfunction resolveAppPageCacheWritePolicy(options: {\n  expireSeconds?: number;\n  requestCacheLife?: AppPageRequestCacheLife | null;\n  revalidateSeconds: number | null;\n}): { expireSeconds?: number; revalidateSeconds: number } | null {\n  let revalidateSeconds = options.revalidateSeconds;\n  let expireSeconds = options.expireSeconds;\n  const requestCacheLife = options.requestCacheLife;\n\n  if (requestCacheLife?.revalidate !== undefined) {\n    revalidateSeconds =\n      revalidateSeconds === null\n        ? requestCacheLife.revalidate\n        : Math.min(revalidateSeconds, requestCacheLife.revalidate);\n  }\n  if (requestCacheLife?.expire !== undefined) {\n    expireSeconds = requestCacheLife.expire;\n  }\n\n  if (revalidateSeconds === null || revalidateSeconds <= 0 || !Number.isFinite(revalidateSeconds)) {\n    return null;\n  }\n\n  return { expireSeconds, revalidateSeconds };\n}\n\nexport function buildAppPageCachedResponse(\n  cachedValue: CachedAppPageValue,\n  options: BuildAppPageCachedResponseOptions,\n): Response | null {\n  // Preserve the legacy fallback semantics from the generated entry: invalid\n  // falsy statuses still fall back to 200 rather than being forwarded through.\n  const status = cachedValue.status || 200;\n  const revalidateSeconds = options.cacheControl?.revalidate ?? options.revalidateSeconds;\n  const expireSeconds =\n    options.cacheControl === undefined\n      ? undefined\n      : (options.cacheControl.expire ?? options.expireSeconds);\n  const headers = {\n    \"Cache-Control\": buildAppPageCacheControl(options.cacheState, revalidateSeconds, expireSeconds),\n    Vary: VINEXT_RSC_VARY_HEADER,\n    \"X-Vinext-Cache\": options.cacheState,\n  };\n\n  if (options.isRscRequest) {\n    if (!cachedValue.rscData) {\n      return null;\n    }\n\n    const rscHeaders: Record<string, string> = {\n      \"Content-Type\": \"text/x-component; charset=utf-8\",\n      ...headers,\n    };\n    if (options.mountedSlotsHeader) {\n      rscHeaders[\"X-Vinext-Mounted-Slots\"] = options.mountedSlotsHeader;\n    }\n\n    return new Response(cachedValue.rscData, {\n      status,\n      headers: rscHeaders,\n    });\n  }\n\n  if (typeof cachedValue.html !== \"string\" || cachedValue.html.length === 0) {\n    return null;\n  }\n\n  return new Response(cachedValue.html, {\n    status,\n    headers: {\n      \"Content-Type\": \"text/html; charset=utf-8\",\n      ...headers,\n    },\n  });\n}\n\nexport async function readAppPageCacheResponse(\n  options: ReadAppPageCacheResponseOptions,\n): Promise<Response | null> {\n  const isrKey = options.isRscRequest\n    ? options.isrRscKey(options.cleanPathname, options.mountedSlotsHeader)\n    : options.isrHtmlKey(options.cleanPathname);\n\n  try {\n    const cached = await options.isrGet(isrKey);\n    const cachedValue = getCachedAppPageValue(cached);\n\n    if (cachedValue && !cached?.isStale) {\n      const hitResponse = buildAppPageCachedResponse(cachedValue, {\n        cacheState: \"HIT\",\n        cacheControl: cached?.value.cacheControl,\n        expireSeconds: options.expireSeconds,\n        isRscRequest: options.isRscRequest,\n        mountedSlotsHeader: options.mountedSlotsHeader,\n        revalidateSeconds: options.revalidateSeconds,\n      });\n\n      if (hitResponse) {\n        options.isrDebug?.(\n          options.isRscRequest ? \"HIT (RSC)\" : \"HIT (HTML)\",\n          options.cleanPathname,\n        );\n        options.clearRequestContext();\n        return hitResponse;\n      }\n\n      options.isrDebug?.(\"MISS (empty cached entry)\", options.cleanPathname);\n    }\n\n    if (cached?.isStale && cachedValue) {\n      const regenerationKey = options.isRscRequest\n        ? options.isrRscKey(options.cleanPathname, options.mountedSlotsHeader)\n        : options.isrHtmlKey(options.cleanPathname);\n\n      // Preserve the legacy behavior from the inline generator: stale entries\n      // still trigger background regeneration even if this request cannot use\n      // the stale payload and will fall through to a fresh render.\n      options.scheduleBackgroundRegeneration(regenerationKey, async () => {\n        const revalidatedPage = await options.renderFreshPageForCache();\n        const revalidateSeconds =\n          revalidatedPage.cacheControl?.revalidate ?? options.revalidateSeconds;\n        const expireSeconds = revalidatedPage.cacheControl?.expire ?? options.expireSeconds;\n        const writes = [\n          options.isrSet(\n            options.isrRscKey(options.cleanPathname, options.mountedSlotsHeader),\n            buildAppPageCacheValue(\"\", revalidatedPage.rscData, 200),\n            revalidateSeconds,\n            revalidatedPage.tags,\n            expireSeconds,\n          ),\n        ];\n\n        if (!options.isRscRequest) {\n          // HTML cache is slot-state-independent (canonical), so only refresh it\n          // during HTML-triggered regens. RSC-triggered regens only update the\n          // requesting client's RSC slot variant; a stale HTML cache entry will\n          // be regenerated independently by the next full-page HTML request.\n          writes.push(\n            options.isrSet(\n              options.isrHtmlKey(options.cleanPathname),\n              buildAppPageCacheValue(revalidatedPage.html, undefined, 200),\n              revalidateSeconds,\n              revalidatedPage.tags,\n              expireSeconds,\n            ),\n          );\n        }\n\n        await Promise.all(writes);\n        options.isrDebug?.(\"regen complete\", options.cleanPathname);\n      });\n\n      const staleResponse = buildAppPageCachedResponse(cachedValue, {\n        cacheState: \"STALE\",\n        cacheControl: cached.value.cacheControl,\n        expireSeconds: options.expireSeconds,\n        isRscRequest: options.isRscRequest,\n        mountedSlotsHeader: options.mountedSlotsHeader,\n        revalidateSeconds: options.revalidateSeconds,\n      });\n\n      if (staleResponse) {\n        options.isrDebug?.(\n          options.isRscRequest ? \"STALE (RSC)\" : \"STALE (HTML)\",\n          options.cleanPathname,\n        );\n        options.clearRequestContext();\n        return staleResponse;\n      }\n\n      options.isrDebug?.(\"STALE MISS (empty stale entry)\", options.cleanPathname);\n    }\n\n    if (!cached) {\n      options.isrDebug?.(\"MISS (no cache entry)\", options.cleanPathname);\n    }\n  } catch (isrReadError) {\n    console.error(\"[vinext] ISR cache read error:\", isrReadError);\n  }\n\n  return null;\n}\n\nexport function finalizeAppPageHtmlCacheResponse(\n  response: Response,\n  options: FinalizeAppPageHtmlCacheResponseOptions,\n): Response {\n  if (!response.body) {\n    return response;\n  }\n\n  const [streamForClient, streamForCache] = response.body.tee();\n  const htmlKey = options.isrHtmlKey(options.cleanPathname);\n  const rscKey = options.isrRscKey(options.cleanPathname, null);\n  const clientHeaders = new Headers(response.headers);\n  if (options.preserveClientResponseHeaders !== true) {\n    // HTML Server Components can access request APIs while the stream is being\n    // consumed. Until that late dynamic check finishes, downstream shared caches\n    // must not cache a response whose ISR policy was known before streaming.\n    clientHeaders.set(\"Cache-Control\", NO_STORE_CACHE_CONTROL);\n    clientHeaders.set(\"X-Vinext-Cache\", \"MISS\");\n  }\n\n  const cachePromise = (async () => {\n    try {\n      const cachedHtml = await readStreamAsText(streamForCache);\n\n      if (\n        options.capturedDynamicUsageBeforeContextCleanup?.() === true ||\n        options.consumeDynamicUsage()\n      ) {\n        options.isrDebug?.(\"HTML cache write skipped (dynamic usage during render)\", htmlKey);\n        return;\n      }\n\n      const cachePolicy = resolveAppPageCacheWritePolicy({\n        expireSeconds: options.expireSeconds,\n        requestCacheLife: options.getRequestCacheLife?.(),\n        revalidateSeconds: options.revalidateSeconds,\n      });\n      if (!cachePolicy) {\n        options.isrDebug?.(\"HTML cache write skipped (no cache policy)\", htmlKey);\n        return;\n      }\n\n      const pageTags = options.getPageTags();\n      const writes = [\n        options.isrSet(\n          htmlKey,\n          buildAppPageCacheValue(cachedHtml, undefined, 200),\n          cachePolicy.revalidateSeconds,\n          pageTags,\n          cachePolicy.expireSeconds,\n        ),\n      ];\n\n      if (options.capturedRscDataPromise) {\n        writes.push(\n          options.capturedRscDataPromise.then((rscData) =>\n            options.isrSet(\n              rscKey,\n              buildAppPageCacheValue(\"\", rscData, 200),\n              cachePolicy.revalidateSeconds,\n              pageTags,\n              cachePolicy.expireSeconds,\n            ),\n          ),\n        );\n      }\n\n      await Promise.all(writes);\n      options.isrDebug?.(\"HTML cache written\", htmlKey);\n    } catch (cacheError) {\n      console.error(\"[vinext] ISR cache write error:\", cacheError);\n    }\n  })();\n\n  options.waitUntil?.(cachePromise);\n\n  return new Response(streamForClient, {\n    status: response.status,\n    statusText: response.statusText,\n    headers: clientHeaders,\n  });\n}\n\nexport function finalizeAppPageRscCacheResponse(\n  response: Response,\n  options: ScheduleAppPageRscCacheWriteOptions,\n): Response {\n  const didSchedule = scheduleAppPageRscCacheWrite(options);\n  if (!didSchedule) {\n    return response;\n  }\n\n  if (options.preserveClientResponseHeaders === true) {\n    return response;\n  }\n\n  const clientHeaders = new Headers(response.headers);\n  // RSC payloads are also streamed lazily. Until the captured stream proves no\n  // late request API was used, the client-facing MISS response must not enter a\n  // shared cache when the ISR policy was known before streaming.\n  clientHeaders.set(\"Cache-Control\", NO_STORE_CACHE_CONTROL);\n  clientHeaders.set(\"X-Vinext-Cache\", \"MISS\");\n\n  return new Response(response.body, {\n    status: response.status,\n    statusText: response.statusText,\n    headers: clientHeaders,\n  });\n}\n\nexport function scheduleAppPageRscCacheWrite(\n  options: ScheduleAppPageRscCacheWriteOptions,\n): boolean {\n  const capturedRscDataPromise = options.capturedRscDataPromise;\n  if (!capturedRscDataPromise || options.dynamicUsedDuringBuild) {\n    return false;\n  }\n\n  const rscKey = options.isrRscKey(options.cleanPathname, options.mountedSlotsHeader);\n  const cachePromise = (async () => {\n    try {\n      const rscData = await capturedRscDataPromise;\n\n      // Two-phase dynamic detection:\n      // 1. dynamicUsedDuringBuild catches searchParams-driven opt-in before the\n      //    RSC response is sent.\n      // 2. consumeDynamicUsage() here catches APIs that fire while the RSC\n      //    stream is consumed (headers(), cookies(), noStore()).\n      if (options.consumeDynamicUsage()) {\n        options.isrDebug?.(\"RSC cache write skipped (dynamic usage during render)\", rscKey);\n        return;\n      }\n\n      const cachePolicy = resolveAppPageCacheWritePolicy({\n        expireSeconds: options.expireSeconds,\n        requestCacheLife: options.getRequestCacheLife?.(),\n        revalidateSeconds: options.revalidateSeconds,\n      });\n      if (!cachePolicy) {\n        options.isrDebug?.(\"RSC cache write skipped (no cache policy)\", rscKey);\n        return;\n      }\n\n      await options.isrSet(\n        rscKey,\n        buildAppPageCacheValue(\"\", rscData, 200),\n        cachePolicy.revalidateSeconds,\n        options.getPageTags(),\n        cachePolicy.expireSeconds,\n      );\n      options.isrDebug?.(\"RSC cache written\", rscKey);\n    } catch (cacheError) {\n      console.error(\"[vinext] ISR RSC cache write error:\", cacheError);\n    }\n  })();\n\n  options.waitUntil?.(cachePromise);\n  return true;\n}\n"],"mappings":"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"}
+{"version":3,"file":"app-page-cache.js","names":[],"sources":["../../src/server/app-page-cache.ts"],"sourcesContent":["import type { CachedAppPageValue, CacheControlMetadata } from \"vinext/shims/cache\";\nimport {\n  VINEXT_RSC_CONTENT_TYPE,\n  VINEXT_RSC_VARY_HEADER,\n  applyRscCompatibilityIdHeader,\n} from \"./app-rsc-cache-busting.js\";\nimport { buildCachedRevalidateCacheControl } from \"./cache-control.js\";\nimport { VINEXT_CACHE_HEADER, VINEXT_MOUNTED_SLOTS_HEADER } from \"./headers.js\";\nimport { buildAppPageCacheValue, type ISRCacheEntry } from \"./isr-cache.js\";\nimport { mergeMiddlewareResponseHeaders } from \"./middleware-response-headers.js\";\nimport { readStreamAsText } from \"../utils/text-stream.js\";\nimport { encodeCacheTag } from \"../utils/encode-cache-tag.js\";\nimport type { AppRscRenderMode } from \"./app-rsc-render-mode.js\";\nimport {\n  createEmptyAppPageRenderObservationState,\n  type AppPageRenderObservationState,\n} from \"./app-page-render-observation.js\";\nimport type { RenderObservation } from \"./cache-proof.js\";\n\ntype AppPageDebugLogger = (event: string, detail: string) => void;\ntype AppPageCacheGetter = (key: string) => Promise<ISRCacheEntry | null>;\ntype AppPageCacheSetter = (\n  key: string,\n  data: CachedAppPageValue,\n  revalidateSeconds: number,\n  tags: string[],\n  expireSeconds?: number,\n) => Promise<void>;\ntype AppPageBackgroundRegenerator = (key: string, renderFn: () => Promise<void>) => void;\ntype AppPageRequestCacheLife = {\n  revalidate?: number;\n  expire?: number;\n};\n\ntype BuildAppPageCacheRenderObservation = (input: {\n  cacheTags: readonly string[];\n  state: AppPageRenderObservationState;\n}) => RenderObservation;\n\ntype AppPageCacheRenderResult = {\n  cacheControl?: CacheControlMetadata;\n  html: string;\n  htmlRenderObservation?: RenderObservation;\n  rscData: ArrayBuffer;\n  rscRenderObservation?: RenderObservation;\n  tags: string[];\n};\n\ntype BuildAppPageCachedResponseOptions = {\n  cacheControl?: CacheControlMetadata;\n  cacheState: \"HIT\" | \"STALE\";\n  expireSeconds?: number;\n  isRscRequest: boolean;\n  middlewareHeaders?: Headers | null;\n  middlewareStatus?: number | null;\n  mountedSlotsHeader?: string | null;\n  revalidateSeconds: number;\n};\n\ntype ReadAppPageCacheResponseOptions = {\n  cleanPathname: string;\n  clearRequestContext: () => void;\n  isRscRequest: boolean;\n  isrDebug?: AppPageDebugLogger;\n  isrGet: AppPageCacheGetter;\n  isrHtmlKey: (pathname: string) => string;\n  isrRscKey: (\n    pathname: string,\n    mountedSlotsHeader?: string | null,\n    renderMode?: AppRscRenderMode,\n  ) => string;\n  isrSet: AppPageCacheSetter;\n  middlewareHeaders?: Headers | null;\n  middlewareStatus?: number | null;\n  mountedSlotsHeader?: string | null;\n  renderMode?: AppRscRenderMode;\n  expireSeconds?: number;\n  revalidateSeconds: number;\n  renderFreshPageForCache: () => Promise<AppPageCacheRenderResult>;\n  scheduleBackgroundRegeneration: AppPageBackgroundRegenerator;\n};\n\ntype FinalizeAppPageHtmlCacheResponseOptions = {\n  capturedDynamicUsageBeforeContextCleanup?: () => boolean;\n  capturedRscDataPromise: Promise<ArrayBuffer> | null;\n  cleanPathname: string;\n  consumeDynamicUsage: () => boolean;\n  consumeRenderObservationState?: () => AppPageRenderObservationState;\n  createHtmlRenderObservation?: BuildAppPageCacheRenderObservation;\n  createRscRenderObservation?: BuildAppPageCacheRenderObservation;\n  getPageTags: () => string[];\n  getRequestCacheLife?: () => AppPageRequestCacheLife | null;\n  isrDebug?: AppPageDebugLogger;\n  isrHtmlKey: (pathname: string) => string;\n  isrRscKey: (\n    pathname: string,\n    mountedSlotsHeader?: string | null,\n    renderMode?: AppRscRenderMode,\n  ) => string;\n  isrSet: AppPageCacheSetter;\n  preserveClientResponseHeaders?: boolean;\n  expireSeconds?: number;\n  revalidateSeconds: number | null;\n  waitUntil?: (promise: Promise<void>) => void;\n};\n\ntype ScheduleAppPageRscCacheWriteOptions = {\n  capturedRscDataPromise: Promise<ArrayBuffer> | null;\n  cleanPathname: string;\n  consumeDynamicUsage: () => boolean;\n  consumeRenderObservationState?: () => AppPageRenderObservationState;\n  createRscRenderObservation?: BuildAppPageCacheRenderObservation;\n  dynamicUsedDuringBuild: boolean;\n  getPageTags: () => string[];\n  getRequestCacheLife?: () => AppPageRequestCacheLife | null;\n  isrDebug?: AppPageDebugLogger;\n  isrRscKey: (\n    pathname: string,\n    mountedSlotsHeader?: string | null,\n    renderMode?: AppRscRenderMode,\n  ) => string;\n  isrSet: AppPageCacheSetter;\n  mountedSlotsHeader?: string | null;\n  renderMode?: AppRscRenderMode;\n  preserveClientResponseHeaders?: boolean;\n  expireSeconds?: number;\n  revalidateSeconds: number | null;\n  waitUntil?: (promise: Promise<void>) => void;\n};\n\nconst NO_STORE_CACHE_CONTROL = \"no-store, must-revalidate\";\n\nexport function buildAppPageCacheTags(pathname: string, extraTags: readonly string[]): string[] {\n  const tags = [pathname, `_N_T_${pathname}`, \"_N_T_/layout\"];\n  const segments = pathname.split(\"/\");\n  let built = \"\";\n  for (let index = 1; index < segments.length; index++) {\n    const segment = segments[index];\n    if (segment) {\n      built += `/${segment}`;\n      tags.push(`_N_T_${built}/layout`);\n    }\n  }\n\n  tags.push(`_N_T_${built}/page`);\n  for (const tag of extraTags) {\n    if (!tags.includes(tag)) {\n      tags.push(tag);\n    }\n  }\n  // Canonicalise to ASCII-safe form so path-derived tags from non-ASCII\n  // pathnames match what `revalidatePath`/`revalidateTag` produce after\n  // their own encoding pass.\n  return tags.map(encodeCacheTag);\n}\n\nfunction buildAppPageCacheControl(\n  cacheState: BuildAppPageCachedResponseOptions[\"cacheState\"],\n  revalidateSeconds: number,\n  expireSeconds?: number,\n): string {\n  return buildCachedRevalidateCacheControl(cacheState, revalidateSeconds, expireSeconds);\n}\n\nfunction buildAppPageCachedHeaders(options: {\n  cacheControl: string;\n  cacheState: BuildAppPageCachedResponseOptions[\"cacheState\"];\n  contentType: string;\n  middlewareHeaders?: Headers | null;\n  mountedSlotsHeader?: string | null;\n}): Headers {\n  const headers = new Headers({\n    \"Cache-Control\": options.cacheControl,\n    \"Content-Type\": options.contentType,\n    Vary: VINEXT_RSC_VARY_HEADER,\n    [VINEXT_CACHE_HEADER]: options.cacheState,\n  });\n\n  if (options.mountedSlotsHeader) {\n    headers.set(VINEXT_MOUNTED_SLOTS_HEADER, options.mountedSlotsHeader);\n  }\n\n  mergeMiddlewareResponseHeaders(headers, options.middlewareHeaders ?? null);\n  return headers;\n}\n\nfunction getCachedAppPageValue(entry: ISRCacheEntry | null): CachedAppPageValue | null {\n  return entry?.value.value && entry.value.value.kind === \"APP_PAGE\" ? entry.value.value : null;\n}\n\nfunction resolveAppPageCacheWritePolicy(options: {\n  expireSeconds?: number;\n  requestCacheLife?: AppPageRequestCacheLife | null;\n  revalidateSeconds: number | null;\n}): { expireSeconds?: number; revalidateSeconds: number } | null {\n  let revalidateSeconds = options.revalidateSeconds;\n  let expireSeconds = options.expireSeconds;\n  const requestCacheLife = options.requestCacheLife;\n\n  if (requestCacheLife?.revalidate !== undefined) {\n    revalidateSeconds =\n      revalidateSeconds === null\n        ? requestCacheLife.revalidate\n        : Math.min(revalidateSeconds, requestCacheLife.revalidate);\n  }\n  if (requestCacheLife?.expire !== undefined) {\n    expireSeconds = requestCacheLife.expire;\n  }\n\n  if (revalidateSeconds === null || revalidateSeconds <= 0 || !Number.isFinite(revalidateSeconds)) {\n    return null;\n  }\n\n  return { expireSeconds, revalidateSeconds };\n}\n\nexport function buildAppPageCachedResponse(\n  cachedValue: CachedAppPageValue,\n  options: BuildAppPageCachedResponseOptions,\n): Response | null {\n  // Preserve the legacy fallback semantics from the generated entry: invalid\n  // falsy statuses still fall back to 200 rather than being forwarded through.\n  const status = options.middlewareStatus ?? (cachedValue.status || 200);\n  const revalidateSeconds = options.cacheControl?.revalidate ?? options.revalidateSeconds;\n  const expireSeconds =\n    options.cacheControl === undefined\n      ? undefined\n      : (options.cacheControl.expire ?? options.expireSeconds);\n  const cacheControl = buildAppPageCacheControl(\n    options.cacheState,\n    revalidateSeconds,\n    expireSeconds,\n  );\n  if (options.isRscRequest) {\n    if (!cachedValue.rscData) {\n      return null;\n    }\n\n    const rscHeaders = buildAppPageCachedHeaders({\n      cacheControl,\n      cacheState: options.cacheState,\n      contentType: VINEXT_RSC_CONTENT_TYPE,\n      middlewareHeaders: options.middlewareHeaders,\n      mountedSlotsHeader: options.mountedSlotsHeader,\n    });\n    applyRscCompatibilityIdHeader(rscHeaders);\n\n    return new Response(cachedValue.rscData, {\n      status,\n      headers: rscHeaders,\n    });\n  }\n\n  if (typeof cachedValue.html !== \"string\" || cachedValue.html.length === 0) {\n    return null;\n  }\n\n  const htmlHeaders = buildAppPageCachedHeaders({\n    cacheControl,\n    cacheState: options.cacheState,\n    contentType: \"text/html; charset=utf-8\",\n    middlewareHeaders: options.middlewareHeaders,\n  });\n\n  return new Response(cachedValue.html, {\n    status,\n    headers: htmlHeaders,\n  });\n}\n\nexport async function readAppPageCacheResponse(\n  options: ReadAppPageCacheResponseOptions,\n): Promise<Response | null> {\n  const isrKey = options.isRscRequest\n    ? options.isrRscKey(options.cleanPathname, options.mountedSlotsHeader, options.renderMode)\n    : options.isrHtmlKey(options.cleanPathname);\n\n  try {\n    const cached = await options.isrGet(isrKey);\n    const cachedValue = getCachedAppPageValue(cached);\n\n    if (cachedValue && !cached?.isStale) {\n      const hitResponse = buildAppPageCachedResponse(cachedValue, {\n        cacheState: \"HIT\",\n        cacheControl: cached?.value.cacheControl,\n        expireSeconds: options.expireSeconds,\n        isRscRequest: options.isRscRequest,\n        middlewareHeaders: options.middlewareHeaders,\n        middlewareStatus: options.middlewareStatus,\n        mountedSlotsHeader: options.mountedSlotsHeader,\n        revalidateSeconds: options.revalidateSeconds,\n      });\n\n      if (hitResponse) {\n        options.isrDebug?.(\n          options.isRscRequest ? \"HIT (RSC)\" : \"HIT (HTML)\",\n          options.cleanPathname,\n        );\n        options.clearRequestContext();\n        return hitResponse;\n      }\n\n      options.isrDebug?.(\"MISS (empty cached entry)\", options.cleanPathname);\n    }\n\n    if (cached?.isStale && cachedValue) {\n      const regenerationKey = options.isRscRequest\n        ? options.isrRscKey(options.cleanPathname, options.mountedSlotsHeader, options.renderMode)\n        : options.isrHtmlKey(options.cleanPathname);\n\n      // Preserve the legacy behavior from the inline generator: stale entries\n      // still trigger background regeneration even if this request cannot use\n      // the stale payload and will fall through to a fresh render.\n      options.scheduleBackgroundRegeneration(regenerationKey, async () => {\n        const revalidatedPage = await options.renderFreshPageForCache();\n        const revalidateSeconds =\n          revalidatedPage.cacheControl?.revalidate ?? options.revalidateSeconds;\n        const expireSeconds = revalidatedPage.cacheControl?.expire ?? options.expireSeconds;\n        const writes = [\n          options.isrSet(\n            options.isrRscKey(\n              options.cleanPathname,\n              options.mountedSlotsHeader,\n              options.renderMode,\n            ),\n            buildAppPageCacheValue(\n              \"\",\n              revalidatedPage.rscData,\n              200,\n              revalidatedPage.rscRenderObservation,\n            ),\n            revalidateSeconds,\n            revalidatedPage.tags,\n            expireSeconds,\n          ),\n        ];\n\n        if (!options.isRscRequest) {\n          // HTML cache is slot-state-independent (canonical), so only refresh it\n          // during HTML-triggered regens. RSC-triggered regens only update the\n          // requesting client's RSC slot variant; a stale HTML cache entry will\n          // be regenerated independently by the next full-page HTML request.\n          writes.push(\n            options.isrSet(\n              options.isrHtmlKey(options.cleanPathname),\n              buildAppPageCacheValue(\n                revalidatedPage.html,\n                undefined,\n                200,\n                revalidatedPage.htmlRenderObservation,\n              ),\n              revalidateSeconds,\n              revalidatedPage.tags,\n              expireSeconds,\n            ),\n          );\n        }\n\n        await Promise.all(writes);\n        options.isrDebug?.(\"regen complete\", options.cleanPathname);\n      });\n\n      const staleResponse = buildAppPageCachedResponse(cachedValue, {\n        cacheState: \"STALE\",\n        cacheControl: cached.value.cacheControl,\n        expireSeconds: options.expireSeconds,\n        isRscRequest: options.isRscRequest,\n        middlewareHeaders: options.middlewareHeaders,\n        middlewareStatus: options.middlewareStatus,\n        mountedSlotsHeader: options.mountedSlotsHeader,\n        revalidateSeconds: options.revalidateSeconds,\n      });\n\n      if (staleResponse) {\n        options.isrDebug?.(\n          options.isRscRequest ? \"STALE (RSC)\" : \"STALE (HTML)\",\n          options.cleanPathname,\n        );\n        options.clearRequestContext();\n        return staleResponse;\n      }\n\n      options.isrDebug?.(\"STALE MISS (empty stale entry)\", options.cleanPathname);\n    }\n\n    if (!cached) {\n      options.isrDebug?.(\"MISS (no cache entry)\", options.cleanPathname);\n    }\n  } catch (isrReadError) {\n    console.error(\"[vinext] ISR cache read error:\", isrReadError);\n  }\n\n  return null;\n}\n\nexport function finalizeAppPageHtmlCacheResponse(\n  response: Response,\n  options: FinalizeAppPageHtmlCacheResponseOptions,\n): Response {\n  if (!response.body) {\n    return response;\n  }\n\n  const [streamForClient, streamForCache] = response.body.tee();\n  const htmlKey = options.isrHtmlKey(options.cleanPathname);\n  const rscKey = options.isrRscKey(options.cleanPathname, null);\n  const clientHeaders = new Headers(response.headers);\n  if (options.preserveClientResponseHeaders !== true) {\n    // HTML Server Components can access request APIs while the stream is being\n    // consumed. Until that late dynamic check finishes, downstream shared caches\n    // must not cache a response whose ISR policy was known before streaming.\n    clientHeaders.set(\"Cache-Control\", NO_STORE_CACHE_CONTROL);\n    clientHeaders.set(VINEXT_CACHE_HEADER, \"MISS\");\n  }\n\n  const cachePromise = (async () => {\n    try {\n      const cachedHtml = await readStreamAsText(streamForCache);\n\n      if (\n        options.capturedDynamicUsageBeforeContextCleanup?.() === true ||\n        options.consumeDynamicUsage()\n      ) {\n        options.isrDebug?.(\"HTML cache write skipped (dynamic usage during render)\", htmlKey);\n        return;\n      }\n\n      const cachePolicy = resolveAppPageCacheWritePolicy({\n        expireSeconds: options.expireSeconds,\n        requestCacheLife: options.getRequestCacheLife?.(),\n        revalidateSeconds: options.revalidateSeconds,\n      });\n      if (!cachePolicy) {\n        options.isrDebug?.(\"HTML cache write skipped (no cache policy)\", htmlKey);\n        return;\n      }\n\n      const pageTags = options.getPageTags();\n      // This continuation is scheduled while the request ALS scope is active.\n      // It intentionally consumes observation state only after the HTML stream\n      // drains, so late Server Component request API usage is included.\n      // Consume once: HTML and captured RSC artifacts come from the same render\n      // pass, so both cache artifacts share the same observation snapshot.\n      const observationState =\n        options.consumeRenderObservationState?.() ?? createEmptyAppPageRenderObservationState();\n      const htmlRenderObservation = options.createHtmlRenderObservation?.({\n        cacheTags: pageTags,\n        state: observationState,\n      });\n      const rscRenderObservation = options.createRscRenderObservation?.({\n        cacheTags: pageTags,\n        state: observationState,\n      });\n      const writes = [\n        options.isrSet(\n          htmlKey,\n          buildAppPageCacheValue(cachedHtml, undefined, 200, htmlRenderObservation),\n          cachePolicy.revalidateSeconds,\n          pageTags,\n          cachePolicy.expireSeconds,\n        ),\n      ];\n\n      if (options.capturedRscDataPromise) {\n        writes.push(\n          options.capturedRscDataPromise.then((rscData) =>\n            options.isrSet(\n              rscKey,\n              buildAppPageCacheValue(\"\", rscData, 200, rscRenderObservation),\n              cachePolicy.revalidateSeconds,\n              pageTags,\n              cachePolicy.expireSeconds,\n            ),\n          ),\n        );\n      }\n\n      await Promise.all(writes);\n      options.isrDebug?.(\"HTML cache written\", htmlKey);\n    } catch (cacheError) {\n      console.error(\"[vinext] ISR cache write error:\", cacheError);\n    }\n  })();\n\n  options.waitUntil?.(cachePromise);\n\n  return new Response(streamForClient, {\n    status: response.status,\n    statusText: response.statusText,\n    headers: clientHeaders,\n  });\n}\n\nexport function finalizeAppPageRscCacheResponse(\n  response: Response,\n  options: ScheduleAppPageRscCacheWriteOptions,\n): Response {\n  const didSchedule = scheduleAppPageRscCacheWrite(options);\n  if (!didSchedule) {\n    return response;\n  }\n\n  if (options.preserveClientResponseHeaders === true) {\n    return response;\n  }\n\n  const clientHeaders = new Headers(response.headers);\n  // RSC payloads are also streamed lazily. Until the captured stream proves no\n  // late request API was used, the client-facing MISS response must not enter a\n  // shared cache when the ISR policy was known before streaming.\n  clientHeaders.set(\"Cache-Control\", NO_STORE_CACHE_CONTROL);\n  clientHeaders.set(VINEXT_CACHE_HEADER, \"MISS\");\n\n  return new Response(response.body, {\n    status: response.status,\n    statusText: response.statusText,\n    headers: clientHeaders,\n  });\n}\n\nexport function scheduleAppPageRscCacheWrite(\n  options: ScheduleAppPageRscCacheWriteOptions,\n): boolean {\n  const capturedRscDataPromise = options.capturedRscDataPromise;\n  if (!capturedRscDataPromise || options.dynamicUsedDuringBuild) {\n    return false;\n  }\n\n  const rscKey = options.isrRscKey(\n    options.cleanPathname,\n    options.mountedSlotsHeader,\n    options.renderMode,\n  );\n  const cachePromise = (async () => {\n    try {\n      const rscData = await capturedRscDataPromise;\n\n      // Two-phase dynamic detection:\n      // 1. dynamicUsedDuringBuild catches searchParams-driven opt-in before the\n      //    RSC response is sent.\n      // 2. consumeDynamicUsage() here catches APIs that fire while the RSC\n      //    stream is consumed (headers(), cookies(), noStore()).\n      if (options.consumeDynamicUsage()) {\n        options.isrDebug?.(\"RSC cache write skipped (dynamic usage during render)\", rscKey);\n        return;\n      }\n\n      const cachePolicy = resolveAppPageCacheWritePolicy({\n        expireSeconds: options.expireSeconds,\n        requestCacheLife: options.getRequestCacheLife?.(),\n        revalidateSeconds: options.revalidateSeconds,\n      });\n      if (!cachePolicy) {\n        options.isrDebug?.(\"RSC cache write skipped (no cache policy)\", rscKey);\n        return;\n      }\n\n      const pageTags = options.getPageTags();\n      // This continuation is scheduled while the request ALS scope is active.\n      // It intentionally consumes observation state only after the captured RSC\n      // stream resolves, so late Server Component request API usage is included.\n      const observationState =\n        options.consumeRenderObservationState?.() ?? createEmptyAppPageRenderObservationState();\n      const rscRenderObservation = options.createRscRenderObservation?.({\n        cacheTags: pageTags,\n        state: observationState,\n      });\n      await options.isrSet(\n        rscKey,\n        buildAppPageCacheValue(\"\", rscData, 200, rscRenderObservation),\n        cachePolicy.revalidateSeconds,\n        pageTags,\n        cachePolicy.expireSeconds,\n      );\n      options.isrDebug?.(\"RSC cache written\", rscKey);\n    } catch (cacheError) {\n      console.error(\"[vinext] ISR RSC cache write error:\", cacheError);\n    }\n  })();\n\n  options.waitUntil?.(cachePromise);\n  return true;\n}\n"],"mappings":"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"}

package/dist/server/app-page-dispatch.d.ts

@@ -4,10 +4,12 @@ import { AppOutgoingElements } from "./app-elements-wire.js";
 import { AppPageFontPreload, LayoutClassificationOptions } from "./app-page-execution.js";
 import { AppPageMiddlewareContext } from "./app-page-response.js";
 import { AppPageSsrHandler } from "./app-page-stream.js";
+import { AppRscRenderMode } from "./app-rsc-render-mode.js";
 import { ISRCacheEntry } from "./isr-cache.js";
 import { FetchCacheMode } from "../shims/fetch-cache.js";
 import { ValidateAppPageDynamicParamsOptions } from "./app-page-request.js";
 import { ReactNode } from "react";
+import { ReactFormState } from "react-dom/client";
 
 //#region src/server/app-page-dispatch.d.ts
 type AppPageParams = Record<string, string | string[]>;
@@ -27,6 +29,7 @@ type AppPageDispatchIntercept<TPage = unknown> = {
   interceptLayouts?: readonly AppPageModule[] | null;
   matchedParams: AppPageParams;
   page: TPage;
+  slotId?: string | null;
   slotKey: string;
   sourceRouteIndex: number;
 };
@@ -35,7 +38,9 @@ type AppPageDispatchInterceptOptions<TPage = unknown> = {
   interceptLayouts?: readonly AppPageModule[] | null;
   interceptPage: TPage;
   interceptParams: AppPageParams;
+  interceptSlotId?: string | null;
   interceptSlotKey: string;
+  interceptSourceMatchedUrl?: string | null;
 };
 type AppPageModule = {
   default?: unknown;
@@ -67,6 +72,9 @@ type DispatchAppPageOptions<TRoute extends AppPageDispatchRoute> = {
   dynamicParamsConfig?: boolean;
   fetchCache?: FetchCacheMode | null;
   findIntercept: (pathname: string) => AppPageDispatchIntercept | null;
+  formState?: ReactFormState | null;
+  actionError?: unknown;
+  actionFailed?: boolean;
   generateStaticParams?: ValidateAppPageDynamicParamsOptions["generateStaticParams"];
   getFontLinks: () => string[];
   getFontPreloads: () => AppPageFontPreload[];
@@ -78,12 +86,13 @@ type DispatchAppPageOptions<TRoute extends AppPageDispatchRoute> = {
   hasPageModule: boolean;
   handlerStart: number;
   interceptionContext: string | null;
+  isProgressiveActionRender?: boolean;
   isProduction: boolean;
   isRscRequest: boolean;
   isrDebug?: AppPageDebugLogger;
   isrGet: AppPageCacheGetter;
   isrHtmlKey: (pathname: string) => string;
-  isrRscKey: (pathname: string, mountedSlotsHeader?: string | null) => string;
+  isrRscKey: (pathname: string, mountedSlotsHeader?: string | null, renderMode?: AppRscRenderMode) => string;
   isrSet: AppPageCacheSetter;
   loadSsrHandler: () => Promise<AppPageSsrHandler>;
   middlewareContext: AppPageMiddlewareContext;
@@ -117,6 +126,7 @@ type DispatchAppPageOptions<TRoute extends AppPageDispatchRoute> = {
     pathname: string;
     searchParams: URLSearchParams;
   }) => void;
+  renderMode?: AppRscRenderMode;
 };
 declare function dispatchAppPage<TRoute extends AppPageDispatchRoute>(options: DispatchAppPageOptions<TRoute>): Promise<Response>;
 //#endregion

package/dist/server/app-page-dispatch.js

@@ -1,15 +1,17 @@
 import { createRequestContext, runWithRequestContext } from "../shims/unified-request-context.js";
 import { getRequestExecutionContext } from "../shims/request-context.js";
-import { consumeDynamicUsage, consumeInvalidDynamicUsageError, getAndClearPendingCookies, getDraftModeCookieHeader, markDynamicUsage, setHeadersContext } from "../shims/headers.js";
+import { consumeDynamicUsage, consumeInvalidDynamicUsageError, consumeRenderRequestApiUsage, getAndClearPendingCookies, getDraftModeCookieHeader, isDraftModeRequest, markDynamicUsage, peekRenderRequestApiUsage, setHeadersContext } from "../shims/headers.js";
 import { _consumeRequestScopedCacheLife, _peekRequestScopedCacheLife } from "../shims/cache.js";
-import { ensureFetchPatch, getCollectedFetchTags, setCurrentFetchCacheMode, setCurrentFetchSoftTags } from "../shims/fetch-cache.js";
+import { shouldSuppressLoadingBoundaries } from "./app-rsc-render-mode.js";
+import { consumeDynamicFetchObservations, ensureFetchPatch, getCollectedFetchTags, peekDynamicFetchObservations, runWithFetchDedupe, setCurrentFetchCacheMode, setCurrentFetchSoftTags } from "../shims/fetch-cache.js";
 import { AppElementsWire } from "./app-elements-wire.js";
 import "./app-elements.js";
-import { VINEXT_RSC_VARY_HEADER } from "./app-rsc-cache-busting.js";
+import { VINEXT_RSC_CONTENT_TYPE, VINEXT_RSC_VARY_HEADER, applyRscCompatibilityIdHeader } from "./app-rsc-cache-busting.js";
 import { createAppPageTreePath } from "./app-page-route-wiring.js";
 import { mergeMiddlewareResponseHeaders } from "./middleware-response-headers.js";
 import { resolveAppPageParentHttpAccessBoundaryModule } from "./app-page-boundary.js";
 import { readStreamAsText } from "../utils/text-stream.js";
+import { createAppPageHtmlOutputScope, createAppPageRenderObservation, createAppPageRscOutputScope } from "./app-page-render-observation.js";
 import { readAppPageCacheResponse } from "./app-page-cache.js";
 import { buildAppPageSpecialErrorResponse, resolveAppPageSpecialError, teeAppPageRscStreamForCapture } from "./app-page-execution.js";
 import { resolveAppPageMethodResponse } from "./app-page-method.js";
@@ -20,7 +22,7 @@ import { createStaticGenerationHeadersContext } from "./app-static-generation.js
 import { buildPageCacheTags } from "./implicit-tags.js";
 //#region src/server/app-page-dispatch.ts
 function shouldReadAppPageCache(options) {
-	return options.isProduction && !options.isForceDynamic && (options.isRscRequest || !options.scriptNonce) && (options.revalidateSeconds === null || options.revalidateSeconds > 0 && options.revalidateSeconds !== Infinity);
+	return options.isProduction && !options.isProgressiveActionRender && !options.isDraftMode && !options.isForceDynamic && (options.isRscRequest || !options.scriptNonce) && (options.revalidateSeconds === null || options.revalidateSeconds > 0);
 }
 function buildAppPageTags(cleanPathname, extraTags, routeSegments) {
 	return buildPageCacheTags(cleanPathname, extraTags, [...routeSegments], "page");
@@ -43,7 +45,7 @@ async function runAppPageRevalidationContext(options, renderFn) {
 			searchParams: new URLSearchParams(),
 			params: options.params
 		});
-		return renderFn();
+		return await runWithFetchDedupe(renderFn);
 	});
 }
 function getCapturedRscDataPromise(capturedRscDataPromise) {
@@ -56,16 +58,22 @@ function toInterceptOptions(interceptionContext, intercept) {
 		interceptLayouts: intercept.interceptLayouts,
 		interceptPage: intercept.page,
 		interceptParams: intercept.matchedParams,
-		interceptSlotKey: intercept.slotKey
+		interceptSlotId: intercept.slotId ?? null,
+		interceptSlotKey: intercept.slotKey,
+		interceptSourceMatchedUrl: interceptionContext
 	};
 }
 async function dispatchAppPage(options) {
+	return await runWithFetchDedupe(() => dispatchAppPageInner(options));
+}
+async function dispatchAppPageInner(options) {
 	const route = options.route;
 	const dynamicConfig = options.dynamicConfig;
 	const currentRevalidateSeconds = options.revalidateSeconds;
 	const isForceStatic = dynamicConfig === "force-static";
 	const isDynamicError = dynamicConfig === "error";
 	const isForceDynamic = dynamicConfig === "force-dynamic";
+	const isDraftMode = isDraftModeRequest(options.request);
 	setCurrentFetchSoftTags(buildAppPageTags(options.cleanPathname, [], route.routeSegments));
 	setCurrentFetchCacheMode(options.fetchCache ?? null);
 	if (options.hasPageModule && !options.hasPageDefaultExport) {
@@ -84,7 +92,7 @@ async function dispatchAppPage(options) {
 		options.clearRequestContext();
 		return methodResponse;
 	}
-	if (isForceStatic || isDynamicError) {
+	if ((isForceStatic || isDynamicError) && !isDraftMode) {
 		setHeadersContext(createStaticGenerationHeadersContext({
 			dynamicConfig,
 			routeKind: "page",
@@ -97,7 +105,9 @@ async function dispatchAppPage(options) {
 		});
 	}
 	if (shouldReadAppPageCache({
+		isDraftMode,
 		isForceDynamic,
+		isProgressiveActionRender: options.isProgressiveActionRender === true,
 		isProduction: options.isProduction,
 		isRscRequest: options.isRscRequest,
 		revalidateSeconds: currentRevalidateSeconds,
@@ -112,7 +122,10 @@ async function dispatchAppPage(options) {
 			isrHtmlKey: options.isrHtmlKey,
 			isrRscKey: options.isrRscKey,
 			isrSet: options.isrSet,
+			middlewareHeaders: options.middlewareContext.headers,
+			middlewareStatus: options.middlewareContext.status,
 			mountedSlotsHeader: options.mountedSlotsHeader,
+			renderMode: options.renderMode,
 			expireSeconds: options.expireSeconds,
 			revalidateSeconds: currentRevalidateSeconds ?? 0,
 			renderFreshPageForCache: async () => runAppPageRevalidationContext({
@@ -133,17 +146,56 @@ async function dispatchAppPage(options) {
 					links: options.getFontLinks(),
 					styles: options.getFontStyles(),
 					preloads: options.getFontPreloads()
-				}, revalidatedRscCapture.sideStream ? {
-					sideStream: revalidatedRscCapture.sideStream,
-					capturedRscDataRef: revalidatedCapturedRscRef
-				} : void 0));
+				}, {
+					basePath: options.basePath,
+					...revalidatedRscCapture.sideStream ? {
+						sideStream: revalidatedRscCapture.sideStream,
+						capturedRscDataRef: revalidatedCapturedRscRef
+					} : {}
+				}));
 				const rscData = await getCapturedRscDataPromise(revalidatedCapturedRscRef.value);
 				const cacheLife = _consumeRequestScopedCacheLife();
 				options.clearRequestContext();
+				const tags = buildAppPageTags(options.cleanPathname, getCollectedFetchTags(), route.routeSegments);
+				const observationState = {
+					dynamicFetches: consumeDynamicFetchObservations(),
+					requestApis: consumeRenderRequestApiUsage()
+				};
 				return {
 					html,
+					htmlRenderObservation: createAppPageRenderObservation({
+						boundaryOutcome: { kind: "success" },
+						cacheability: "public",
+						cacheTags: tags,
+						cleanPathname: options.cleanPathname,
+						completeness: "complete",
+						output: createAppPageHtmlOutputScope({
+							element: revalidatedElement,
+							renderEpoch: null,
+							rootBoundaryId: null,
+							routePattern: route.pattern
+						}),
+						params: options.params,
+						state: observationState
+					}),
 					rscData,
-					tags: buildAppPageTags(options.cleanPathname, getCollectedFetchTags(), route.routeSegments),
+					rscRenderObservation: createAppPageRenderObservation({
+						boundaryOutcome: { kind: "success" },
+						cacheability: "public",
+						cacheTags: tags,
+						cleanPathname: options.cleanPathname,
+						completeness: "complete",
+						output: createAppPageRscOutputScope({
+							element: revalidatedElement,
+							mountedSlotsHeader: options.mountedSlotsHeader,
+							renderEpoch: null,
+							rootBoundaryId: null,
+							routePattern: route.pattern
+						}),
+						params: options.params,
+						state: observationState
+					}),
+					tags,
 					cacheControl: typeof cacheLife?.revalidate === "number" ? {
 						revalidate: cacheLife.revalidate,
 						expire: cacheLife.expire
@@ -189,10 +241,11 @@ async function dispatchAppPage(options) {
 			const interceptOnError = options.createRscOnErrorHandler(options.cleanPathname, sourceRoute.pattern);
 			const interceptStream = options.renderToReadableStream(interceptElement, { onError: interceptOnError });
 			const interceptHeaders = new Headers({
-				"Content-Type": "text/x-component; charset=utf-8",
+				"Content-Type": VINEXT_RSC_CONTENT_TYPE,
 				Vary: VINEXT_RSC_VARY_HEADER
 			});
 			mergeMiddlewareResponseHeaders(interceptHeaders, options.middlewareContext.headers);
+			applyRscCompatibilityIdHeader(interceptHeaders);
 			return new Response(interceptStream, {
 				status: options.middlewareContext.status ?? 200,
 				headers: interceptHeaders
@@ -207,6 +260,7 @@ async function dispatchAppPage(options) {
 	if (interceptResult.response) return interceptResult.response;
 	const pageBuildResult = await buildAppPageElement({
 		buildPageElement() {
+			if (options.actionFailed) throw options.actionError;
 			return options.buildPageElement(route, options.params, interceptResult.interceptOpts, options.searchParams);
 		},
 		renderErrorBoundaryPage(buildError) {
@@ -219,10 +273,17 @@ async function dispatchAppPage(options) {
 	});
 	if (pageBuildResult.response) return pageBuildResult.response;
 	return renderAppPageLifecycle({
+		basePath: options.basePath,
 		cleanPathname: options.cleanPathname,
 		clearRequestContext: options.clearRequestContext,
 		consumeDynamicUsage,
 		consumeInvalidDynamicUsageError,
+		consumeRenderObservationState() {
+			return {
+				dynamicFetches: consumeDynamicFetchObservations(),
+				requestApis: consumeRenderRequestApiUsage()
+			};
+		},
 		createRscOnErrorHandler(pathname, routePath) {
 			return options.createRscOnErrorHandler(pathname, routePath);
 		},
@@ -242,8 +303,11 @@ async function dispatchAppPage(options) {
 			return _peekRequestScopedCacheLife();
 		},
 		handlerStart: options.handlerStart,
-		hasLoadingBoundary: Boolean(route.loading?.default),
+		hasLoadingBoundary: shouldSuppressLoadingBoundaries(options.renderMode ?? "navigation") ? false : Boolean(route.loading?.default),
+		formState: options.formState ?? null,
+		isProgressiveActionRender: options.isProgressiveActionRender === true,
 		isDynamicError,
+		isDraftMode,
 		isForceDynamic,
 		isForceStatic,
 		isPrerender: process.env.VINEXT_PRERENDER === "1",
@@ -258,6 +322,12 @@ async function dispatchAppPage(options) {
 		loadSsrHandler: options.loadSsrHandler,
 		middlewareContext: options.middlewareContext,
 		params: options.params,
+		peekRenderObservationState() {
+			return {
+				dynamicFetches: peekDynamicFetchObservations(),
+				requestApis: peekRenderRequestApiUsage()
+			};
+		},
 		probeLayoutAt(layoutIndex) {
 			return options.probeLayoutAt(layoutIndex);
 		},
@@ -287,6 +357,7 @@ async function dispatchAppPage(options) {
 		},
 		revalidateSeconds: currentRevalidateSeconds,
 		mountedSlotsHeader: options.mountedSlotsHeader,
+		renderMode: options.renderMode ?? "navigation",
 		renderErrorBoundaryResponse(renderError) {
 			return options.renderErrorBoundaryPage(renderError);
 		},

package/dist/server/app-page-dispatch.js.map

@@ -1 +1 @@
-{"version":3,"file":"app-page-dispatch.js","names":[],"sources":["../../src/server/app-page-dispatch.ts"],"sourcesContent":["import type { ReactNode } from \"react\";\nimport type { ClassificationReason } from \"../build/layout-classification-types.js\";\nimport {\n  _consumeRequestScopedCacheLife,\n  _peekRequestScopedCacheLife,\n  type CachedAppPageValue,\n} from \"vinext/shims/cache\";\nimport {\n  consumeDynamicUsage,\n  consumeInvalidDynamicUsageError,\n  getAndClearPendingCookies,\n  getDraftModeCookieHeader,\n  markDynamicUsage,\n  setHeadersContext,\n} from \"vinext/shims/headers\";\nimport { getRequestExecutionContext } from \"vinext/shims/request-context\";\nimport { createRequestContext, runWithRequestContext } from \"vinext/shims/unified-request-context\";\nimport {\n  ensureFetchPatch,\n  type FetchCacheMode,\n  getCollectedFetchTags,\n  setCurrentFetchCacheMode,\n  setCurrentFetchSoftTags,\n} from \"vinext/shims/fetch-cache\";\nimport { AppElementsWire, type AppOutgoingElements } from \"./app-elements.js\";\nimport { readAppPageCacheResponse } from \"./app-page-cache.js\";\nimport { resolveAppPageParentHttpAccessBoundaryModule } from \"./app-page-boundary.js\";\nimport { readStreamAsText } from \"../utils/text-stream.js\";\nimport {\n  buildAppPageSpecialErrorResponse,\n  resolveAppPageSpecialError,\n  teeAppPageRscStreamForCapture,\n  type AppPageFontPreload,\n  type AppPageSpecialError,\n  type LayoutClassificationOptions,\n} from \"./app-page-execution.js\";\nimport { resolveAppPageMethodResponse } from \"./app-page-method.js\";\nimport {\n  buildAppPageElement,\n  resolveAppPageIntercept,\n  validateAppPageDynamicParams,\n  type ValidateAppPageDynamicParamsOptions,\n} from \"./app-page-request.js\";\nimport { renderAppPageLifecycle } from \"./app-page-render.js\";\nimport {\n  mergeMiddlewareResponseHeaders,\n  type AppPageMiddlewareContext,\n} from \"./app-page-response.js\";\nimport { VINEXT_RSC_VARY_HEADER } from \"./app-rsc-cache-busting.js\";\nimport { createAppPageTreePath } from \"./app-page-route-wiring.js\";\nimport type { AppPageSsrHandler } from \"./app-page-stream.js\";\nimport { createStaticGenerationHeadersContext } from \"./app-static-generation.js\";\nimport { buildPageCacheTags } from \"./implicit-tags.js\";\nimport type { ISRCacheEntry } from \"./isr-cache.js\";\n\ntype AppPageParams = Record<string, string | string[]>;\ntype AppPageElement = ReactNode | Readonly<Record<string, ReactNode>>;\ntype AppPageRenderableElement = ReactNode | AppOutgoingElements;\ntype AppPageBoundaryOnError = (\n  error: unknown,\n  requestInfo: unknown,\n  errorContext: unknown,\n) => unknown;\ntype AppPageDebugLogger = (event: string, detail: string) => void;\ntype AppPageCacheSetter = (\n  key: string,\n  data: CachedAppPageValue,\n  revalidateSeconds: number,\n  tags: string[],\n  expireSeconds?: number,\n) => Promise<void>;\ntype AppPageCacheGetter = (key: string) => Promise<ISRCacheEntry | null>;\ntype AppPageBackgroundRegenerationErrorContext = {\n  routerKind: \"App Router\";\n  routePath: string;\n  routeType: \"render\";\n};\ntype AppPageBackgroundRegenerator = (\n  key: string,\n  renderFn: () => Promise<void>,\n  errorContext?: AppPageBackgroundRegenerationErrorContext,\n) => void;\n\ntype AppPageDispatchIntercept<TPage = unknown> = {\n  interceptLayouts?: readonly AppPageModule[] | null;\n  matchedParams: AppPageParams;\n  page: TPage;\n  slotKey: string;\n  sourceRouteIndex: number;\n};\n\ntype AppPageDispatchInterceptOptions<TPage = unknown> = {\n  interceptionContext: string | null;\n  interceptLayouts?: readonly AppPageModule[] | null;\n  interceptPage: TPage;\n  interceptParams: AppPageParams;\n  interceptSlotKey: string;\n};\n\ntype AppPageModule = {\n  default?: unknown;\n};\n\ntype AppPageDispatchRoute = {\n  __buildTimeClassifications?: LayoutClassificationOptions[\"buildTimeClassifications\"];\n  __buildTimeReasons?: LayoutClassificationOptions[\"buildTimeReasons\"];\n  error?: AppPageModule | null;\n  errors?: readonly (AppPageModule | null | undefined)[];\n  forbiddens?: readonly (AppPageModule | null | undefined)[];\n  isDynamic: boolean;\n  layouts: readonly AppPageModule[];\n  layoutTreePositions?: readonly number[];\n  loading?: AppPageModule | null;\n  notFounds?: readonly (AppPageModule | null | undefined)[];\n  params: readonly string[];\n  pattern: string;\n  routeSegments: readonly string[];\n  unauthorizeds?: readonly (AppPageModule | null | undefined)[];\n};\n\ntype DispatchAppPageOptions<TRoute extends AppPageDispatchRoute> = {\n  /** Configured basePath (e.g. \"/blog\"). Used to prefix redirect Locations. */\n  basePath?: string;\n  buildPageElement: (\n    route: TRoute,\n    params: AppPageParams,\n    opts: AppPageDispatchInterceptOptions | undefined,\n    searchParams: URLSearchParams,\n  ) => Promise<AppPageElement>;\n  cleanPathname: string;\n  clearRequestContext: () => void;\n  createRscOnErrorHandler: (pathname: string, routePath: string) => AppPageBoundaryOnError;\n  debugClassification?: (layoutId: string, reason: ClassificationReason) => void;\n  dynamicConfig?: string;\n  dynamicParamsConfig?: boolean;\n  fetchCache?: FetchCacheMode | null;\n  findIntercept: (pathname: string) => AppPageDispatchIntercept | null;\n  generateStaticParams?: ValidateAppPageDynamicParamsOptions[\"generateStaticParams\"];\n  getFontLinks: () => string[];\n  getFontPreloads: () => AppPageFontPreload[];\n  getFontStyles: () => string[];\n  getNavigationContext: () => unknown;\n  getSourceRoute: (sourceRouteIndex: number) => TRoute | undefined;\n  hasGenerateStaticParams: boolean;\n  hasPageDefaultExport: boolean;\n  hasPageModule: boolean;\n  handlerStart: number;\n  interceptionContext: string | null;\n  isProduction: boolean;\n  isRscRequest: boolean;\n  isrDebug?: AppPageDebugLogger;\n  isrGet: AppPageCacheGetter;\n  isrHtmlKey: (pathname: string) => string;\n  isrRscKey: (pathname: string, mountedSlotsHeader?: string | null) => string;\n  isrSet: AppPageCacheSetter;\n  loadSsrHandler: () => Promise<AppPageSsrHandler>;\n  middlewareContext: AppPageMiddlewareContext;\n  mountedSlotsHeader?: string | null;\n  params: AppPageParams;\n  probeLayoutAt: (layoutIndex: number) => unknown;\n  probePage: () => unknown;\n  expireSeconds?: number;\n  renderErrorBoundaryPage: (error: unknown) => Promise<Response | null>;\n  renderHttpAccessFallbackPage: (\n    statusCode: number,\n    opts: {\n      boundaryComponent?: unknown;\n      layouts?: readonly AppPageModule[];\n      matchedParams: AppPageParams;\n    },\n    middlewareContext: AppPageMiddlewareContext | null,\n  ) => Promise<Response | null>;\n  renderToReadableStream: (\n    element: AppPageRenderableElement,\n    options: { onError: AppPageBoundaryOnError },\n  ) => ReadableStream<Uint8Array>;\n  request: Request;\n  revalidateSeconds: number | null;\n  resolveRouteFetchCacheMode?: (route: TRoute) => FetchCacheMode | null;\n  rootForbiddenModule?: AppPageModule | null;\n  rootNotFoundModule?: AppPageModule | null;\n  rootUnauthorizedModule?: AppPageModule | null;\n  route: TRoute;\n  runWithSuppressedHookWarning<T>(probe: () => Promise<T>): Promise<T>;\n  scheduleBackgroundRegeneration: AppPageBackgroundRegenerator;\n  scriptNonce?: string;\n  searchParams: URLSearchParams;\n  setNavigationContext: (context: {\n    params: AppPageParams;\n    pathname: string;\n    searchParams: URLSearchParams;\n  }) => void;\n};\n\nfunction shouldReadAppPageCache(options: {\n  isForceDynamic: boolean;\n  isProduction: boolean;\n  isRscRequest: boolean;\n  revalidateSeconds: number | null;\n  scriptNonce?: string;\n}): boolean {\n  return (\n    options.isProduction &&\n    !options.isForceDynamic &&\n    (options.isRscRequest || !options.scriptNonce) &&\n    (options.revalidateSeconds === null ||\n      (options.revalidateSeconds > 0 && options.revalidateSeconds !== Infinity))\n  );\n}\n\nfunction buildAppPageTags(\n  cleanPathname: string,\n  extraTags: string[],\n  routeSegments: readonly string[],\n): string[] {\n  return buildPageCacheTags(cleanPathname, extraTags, [...routeSegments], \"page\");\n}\n\nasync function runAppPageRevalidationContext(\n  options: {\n    cleanPathname: string;\n    currentFetchCacheMode?: FetchCacheMode | null;\n    dynamicConfig?: string;\n    params: AppPageParams;\n    routePattern: string;\n    routeSegments: readonly string[];\n    setNavigationContext: DispatchAppPageOptions<AppPageDispatchRoute>[\"setNavigationContext\"];\n  },\n  renderFn: () => Promise<{\n    html: string;\n    rscData: ArrayBuffer;\n    tags: string[];\n  }>,\n): Promise<{\n  html: string;\n  rscData: ArrayBuffer;\n  tags: string[];\n}> {\n  const headersContext = createStaticGenerationHeadersContext({\n    dynamicConfig: options.dynamicConfig,\n    routeKind: \"page\",\n    routePattern: options.routePattern,\n  });\n  const requestContext = createRequestContext({\n    headersContext,\n    currentFetchCacheMode: options.currentFetchCacheMode ?? null,\n    executionContext: getRequestExecutionContext(),\n    unstableCacheRevalidation: \"foreground\",\n  });\n\n  return runWithRequestContext(requestContext, async () => {\n    ensureFetchPatch();\n    setCurrentFetchSoftTags(buildAppPageTags(options.cleanPathname, [], options.routeSegments));\n    options.setNavigationContext({\n      pathname: options.cleanPathname,\n      searchParams: new URLSearchParams(),\n      params: options.params,\n    });\n    return renderFn();\n  });\n}\n\nfunction getCapturedRscDataPromise(\n  capturedRscDataPromise: Promise<ArrayBuffer> | null,\n): Promise<ArrayBuffer> {\n  if (!capturedRscDataPromise) {\n    throw new Error(\n      \"[vinext] Expected captured RSC data while regenerating an app page cache entry\",\n    );\n  }\n\n  return capturedRscDataPromise;\n}\n\nfunction toInterceptOptions(\n  interceptionContext: string | null,\n  intercept: AppPageDispatchIntercept,\n): AppPageDispatchInterceptOptions {\n  return {\n    interceptionContext,\n    interceptLayouts: intercept.interceptLayouts,\n    interceptPage: intercept.page,\n    interceptParams: intercept.matchedParams,\n    interceptSlotKey: intercept.slotKey,\n  };\n}\n\nexport async function dispatchAppPage<TRoute extends AppPageDispatchRoute>(\n  options: DispatchAppPageOptions<TRoute>,\n): Promise<Response> {\n  const route = options.route;\n  const dynamicConfig = options.dynamicConfig;\n  const currentRevalidateSeconds = options.revalidateSeconds;\n  const isForceStatic = dynamicConfig === \"force-static\";\n  const isDynamicError = dynamicConfig === \"error\";\n  const isForceDynamic = dynamicConfig === \"force-dynamic\";\n\n  setCurrentFetchSoftTags(buildAppPageTags(options.cleanPathname, [], route.routeSegments));\n  setCurrentFetchCacheMode(options.fetchCache ?? null);\n\n  if (options.hasPageModule && !options.hasPageDefaultExport) {\n    options.clearRequestContext();\n    return new Response(\"Page has no default export\", { status: 500 });\n  }\n\n  const methodResponse = resolveAppPageMethodResponse({\n    dynamicConfig,\n    hasGenerateStaticParams: options.hasGenerateStaticParams,\n    isDynamicRoute: route.isDynamic,\n    middlewareHeaders: options.middlewareContext.headers,\n    request: options.request,\n    revalidateSeconds: currentRevalidateSeconds,\n  });\n  if (methodResponse) {\n    options.clearRequestContext();\n    return methodResponse;\n  }\n\n  if (isForceStatic || isDynamicError) {\n    setHeadersContext(\n      createStaticGenerationHeadersContext({\n        dynamicConfig,\n        routeKind: \"page\",\n        routePattern: route.pattern,\n      }),\n    );\n    options.setNavigationContext({\n      pathname: options.cleanPathname,\n      searchParams: new URLSearchParams(),\n      params: options.params,\n    });\n  }\n\n  if (\n    shouldReadAppPageCache({\n      isForceDynamic,\n      isProduction: options.isProduction,\n      isRscRequest: options.isRscRequest,\n      revalidateSeconds: currentRevalidateSeconds,\n      scriptNonce: options.scriptNonce,\n    })\n  ) {\n    const cachedPageResponse = await readAppPageCacheResponse({\n      cleanPathname: options.cleanPathname,\n      clearRequestContext: options.clearRequestContext,\n      isRscRequest: options.isRscRequest,\n      isrDebug: options.isrDebug,\n      isrGet: options.isrGet,\n      isrHtmlKey: options.isrHtmlKey,\n      isrRscKey: options.isrRscKey,\n      isrSet: options.isrSet,\n      mountedSlotsHeader: options.mountedSlotsHeader,\n      expireSeconds: options.expireSeconds,\n      // cacheLife-only routes discover their actual revalidate during the\n      // fresh render; this seed only gets them into the cache read path.\n      revalidateSeconds: currentRevalidateSeconds ?? 0,\n      renderFreshPageForCache: async () =>\n        runAppPageRevalidationContext(\n          {\n            cleanPathname: options.cleanPathname,\n            currentFetchCacheMode: options.fetchCache ?? null,\n            dynamicConfig,\n            params: options.params,\n            routePattern: route.pattern,\n            routeSegments: route.routeSegments,\n            setNavigationContext: options.setNavigationContext,\n          },\n          async () => {\n            const revalidatedElement = await options.buildPageElement(\n              route,\n              options.params,\n              undefined,\n              new URLSearchParams(),\n            );\n            const revalidatedOnError = options.createRscOnErrorHandler(\n              options.cleanPathname,\n              route.pattern,\n            );\n            const revalidatedRscStream = options.renderToReadableStream(revalidatedElement, {\n              onError: revalidatedOnError,\n            });\n            const revalidatedRscCapture = teeAppPageRscStreamForCapture(revalidatedRscStream, true);\n            const revalidatedSsrEntry = await options.loadSsrHandler();\n            const revalidatedCapturedRscRef: { value: Promise<ArrayBuffer> | null } = {\n              value: null,\n            };\n            const revalidatedHtmlStream = await revalidatedSsrEntry.handleSsr(\n              revalidatedRscCapture.ssrStream,\n              options.getNavigationContext(),\n              {\n                links: options.getFontLinks(),\n                styles: options.getFontStyles(),\n                preloads: options.getFontPreloads(),\n              },\n              revalidatedRscCapture.sideStream\n                ? {\n                    sideStream: revalidatedRscCapture.sideStream,\n                    capturedRscDataRef: revalidatedCapturedRscRef,\n                  }\n                : undefined,\n            );\n            const html = await readStreamAsText(revalidatedHtmlStream);\n            const rscData = await getCapturedRscDataPromise(revalidatedCapturedRscRef.value);\n            const cacheLife = _consumeRequestScopedCacheLife();\n            options.clearRequestContext();\n            const tags = buildAppPageTags(\n              options.cleanPathname,\n              getCollectedFetchTags(),\n              route.routeSegments,\n            );\n            return {\n              html,\n              rscData,\n              tags,\n              cacheControl:\n                typeof cacheLife?.revalidate === \"number\"\n                  ? { revalidate: cacheLife.revalidate, expire: cacheLife.expire }\n                  : undefined,\n            };\n          },\n        ),\n      scheduleBackgroundRegeneration(key, renderFn) {\n        options.scheduleBackgroundRegeneration(key, renderFn, {\n          routerKind: \"App Router\",\n          routePath: route.pattern,\n          routeType: \"render\",\n        });\n      },\n    });\n    if (cachedPageResponse) {\n      return cachedPageResponse;\n    }\n  }\n\n  const dynamicParamsResponse = await validateAppPageDynamicParams({\n    clearRequestContext: options.clearRequestContext,\n    enforceStaticParamsOnly: options.dynamicParamsConfig === false,\n    generateStaticParams: options.generateStaticParams,\n    isDynamicRoute: route.isDynamic,\n    params: options.params,\n  });\n  if (dynamicParamsResponse) {\n    return dynamicParamsResponse;\n  }\n\n  const interceptResult = await resolveAppPageIntercept<\n    TRoute,\n    unknown,\n    AppPageDispatchInterceptOptions,\n    AppPageElement\n  >({\n    buildPageElement(interceptRoute, interceptParams, interceptOpts, interceptSearchParams) {\n      setCurrentFetchCacheMode(options.resolveRouteFetchCacheMode?.(interceptRoute) ?? null);\n      return options.buildPageElement(\n        interceptRoute,\n        interceptParams,\n        interceptOpts,\n        interceptSearchParams,\n      );\n    },\n    cleanPathname: options.cleanPathname,\n    currentRoute: route,\n    findIntercept(pathname) {\n      return options.findIntercept(pathname);\n    },\n    getRouteParamNames(sourceRoute) {\n      return sourceRoute.params;\n    },\n    getSourceRoute(sourceRouteIndex) {\n      return options.getSourceRoute(sourceRouteIndex);\n    },\n    isRscRequest: options.isRscRequest,\n    renderInterceptResponse(sourceRoute, interceptElement) {\n      const interceptOnError = options.createRscOnErrorHandler(\n        options.cleanPathname,\n        sourceRoute.pattern,\n      );\n      const interceptStream = options.renderToReadableStream(interceptElement, {\n        onError: interceptOnError,\n      });\n      const interceptHeaders = new Headers({\n        \"Content-Type\": \"text/x-component; charset=utf-8\",\n        Vary: VINEXT_RSC_VARY_HEADER,\n      });\n      mergeMiddlewareResponseHeaders(interceptHeaders, options.middlewareContext.headers);\n      return new Response(interceptStream, {\n        status: options.middlewareContext.status ?? 200,\n        headers: interceptHeaders,\n      });\n    },\n    searchParams: options.searchParams,\n    setNavigationContext: options.setNavigationContext,\n    toInterceptOpts(intercept) {\n      return toInterceptOptions(options.interceptionContext, intercept);\n    },\n  });\n  if (interceptResult.response) {\n    return interceptResult.response;\n  }\n\n  const pageBuildResult = await buildAppPageElement({\n    buildPageElement() {\n      return options.buildPageElement(\n        route,\n        options.params,\n        interceptResult.interceptOpts,\n        options.searchParams,\n      );\n    },\n    renderErrorBoundaryPage(buildError) {\n      return options.renderErrorBoundaryPage(buildError);\n    },\n    renderSpecialError(specialError) {\n      return renderPageSpecialError(options, specialError);\n    },\n    resolveSpecialError: resolveAppPageSpecialError,\n  });\n  if (pageBuildResult.response) {\n    return pageBuildResult.response;\n  }\n\n  return renderAppPageLifecycle({\n    cleanPathname: options.cleanPathname,\n    clearRequestContext: options.clearRequestContext,\n    consumeDynamicUsage,\n    consumeInvalidDynamicUsageError,\n    createRscOnErrorHandler(pathname, routePath) {\n      return options.createRscOnErrorHandler(pathname, routePath);\n    },\n    element: pageBuildResult.element,\n    getDraftModeCookieHeader,\n    getFontLinks: options.getFontLinks,\n    getFontPreloads: options.getFontPreloads,\n    getFontStyles: options.getFontStyles,\n    getNavigationContext: options.getNavigationContext,\n    getPageTags() {\n      return buildAppPageTags(options.cleanPathname, getCollectedFetchTags(), route.routeSegments);\n    },\n    getRequestCacheLife() {\n      return _consumeRequestScopedCacheLife();\n    },\n    peekRequestCacheLife() {\n      return _peekRequestScopedCacheLife();\n    },\n    handlerStart: options.handlerStart,\n    hasLoadingBoundary: Boolean(route.loading?.default),\n    isDynamicError,\n    isForceDynamic,\n    isForceStatic,\n    isPrerender: process.env.VINEXT_PRERENDER === \"1\",\n    isProduction: options.isProduction,\n    isRscRequest: options.isRscRequest,\n    isrDebug: options.isrDebug,\n    isrHtmlKey: options.isrHtmlKey,\n    isrRscKey: options.isrRscKey,\n    isrSet: options.isrSet,\n    expireSeconds: options.expireSeconds,\n    layoutCount: route.layouts.length,\n    loadSsrHandler: options.loadSsrHandler,\n    middlewareContext: options.middlewareContext,\n    params: options.params,\n    probeLayoutAt(layoutIndex) {\n      return options.probeLayoutAt(layoutIndex);\n    },\n    probePage() {\n      return options.probePage();\n    },\n    classification: {\n      getLayoutId(index) {\n        const treePosition = route.layoutTreePositions?.[index] ?? 0;\n        return AppElementsWire.encodeLayoutId(\n          createAppPageTreePath([...route.routeSegments], treePosition),\n        );\n      },\n      buildTimeClassifications: route.__buildTimeClassifications,\n      buildTimeReasons: route.__buildTimeReasons,\n      debugClassification: options.debugClassification,\n      async runWithIsolatedDynamicScope(fn) {\n        const priorDynamic = consumeDynamicUsage();\n        try {\n          const result = await fn();\n          const dynamicDetected = consumeDynamicUsage();\n          return { result, dynamicDetected };\n        } finally {\n          consumeDynamicUsage();\n          if (priorDynamic) markDynamicUsage();\n        }\n      },\n    },\n    revalidateSeconds: currentRevalidateSeconds,\n    mountedSlotsHeader: options.mountedSlotsHeader,\n    renderErrorBoundaryResponse(renderError) {\n      return options.renderErrorBoundaryPage(renderError);\n    },\n    renderLayoutSpecialError(specialError, layoutIndex) {\n      return renderLayoutSpecialError(options, specialError, layoutIndex);\n    },\n    renderPageSpecialError(specialError) {\n      return renderPageSpecialError(options, specialError);\n    },\n    renderToReadableStream: options.renderToReadableStream,\n    routeHasLocalBoundary: Boolean(\n      route.error?.default || route.errors?.some((errorModule) => errorModule?.default),\n    ),\n    routePattern: route.pattern,\n    runWithSuppressedHookWarning(probe) {\n      return options.runWithSuppressedHookWarning(probe);\n    },\n    scriptNonce: options.scriptNonce,\n    waitUntil(cachePromise) {\n      getRequestExecutionContext()?.waitUntil(cachePromise);\n    },\n  });\n}\n\nasync function renderLayoutSpecialError<TRoute extends AppPageDispatchRoute>(\n  options: DispatchAppPageOptions<TRoute>,\n  specialError: AppPageSpecialError,\n  layoutIndex: number,\n): Promise<Response> {\n  return buildAppPageSpecialErrorResponse({\n    basePath: options.basePath,\n    clearRequestContext: options.clearRequestContext,\n    getAndClearPendingCookies,\n    isRscRequest: options.isRscRequest,\n    middlewareContext: options.middlewareContext,\n    renderFallbackPage(statusCode) {\n      const parentBoundary = resolveAppPageParentHttpAccessBoundaryModule({\n        layoutIndex,\n        rootForbiddenModule: options.rootForbiddenModule,\n        rootNotFoundModule: options.rootNotFoundModule,\n        rootUnauthorizedModule: options.rootUnauthorizedModule,\n        routeForbiddenModules: options.route.forbiddens,\n        routeNotFoundModules: options.route.notFounds,\n        routeUnauthorizedModules: options.route.unauthorizeds,\n        statusCode,\n      })?.default;\n      return options.renderHttpAccessFallbackPage(\n        statusCode,\n        {\n          boundaryComponent: parentBoundary,\n          layouts: options.route.layouts.slice(0, layoutIndex),\n          matchedParams: options.params,\n        },\n        null,\n      );\n    },\n    request: options.request,\n    specialError,\n  });\n}\n\nasync function renderPageSpecialError<TRoute extends AppPageDispatchRoute>(\n  options: DispatchAppPageOptions<TRoute>,\n  specialError: AppPageSpecialError,\n): Promise<Response> {\n  return buildAppPageSpecialErrorResponse({\n    basePath: options.basePath,\n    clearRequestContext: options.clearRequestContext,\n    getAndClearPendingCookies,\n    isRscRequest: options.isRscRequest,\n    middlewareContext: options.middlewareContext,\n    renderFallbackPage(statusCode) {\n      return options.renderHttpAccessFallbackPage(\n        statusCode,\n        { matchedParams: options.params },\n        null,\n      );\n    },\n    request: options.request,\n    specialError,\n  });\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAkMA,SAAS,uBAAuB,SAMpB;AACV,QACE,QAAQ,gBACR,CAAC,QAAQ,mBACR,QAAQ,gBAAgB,CAAC,QAAQ,iBACjC,QAAQ,sBAAsB,QAC5B,QAAQ,oBAAoB,KAAK,QAAQ,sBAAsB;;AAItE,SAAS,iBACP,eACA,WACA,eACU;AACV,QAAO,mBAAmB,eAAe,WAAW,CAAC,GAAG,cAAc,EAAE,OAAO;;AAGjF,eAAe,8BACb,SASA,UASC;AAaD,QAAO,sBAPgB,qBAAqB;EAC1C,gBANqB,qCAAqC;GAC1D,eAAe,QAAQ;GACvB,WAAW;GACX,cAAc,QAAQ;GACvB,CAAC;EAGA,uBAAuB,QAAQ,yBAAyB;EACxD,kBAAkB,4BAA4B;EAC9C,2BAA2B;EAC5B,CAAC,EAE2C,YAAY;AACvD,oBAAkB;AAClB,0BAAwB,iBAAiB,QAAQ,eAAe,EAAE,EAAE,QAAQ,cAAc,CAAC;AAC3F,UAAQ,qBAAqB;GAC3B,UAAU,QAAQ;GAClB,cAAc,IAAI,iBAAiB;GACnC,QAAQ,QAAQ;GACjB,CAAC;AACF,SAAO,UAAU;GACjB;;AAGJ,SAAS,0BACP,wBACsB;AACtB,KAAI,CAAC,uBACH,OAAM,IAAI,MACR,iFACD;AAGH,QAAO;;AAGT,SAAS,mBACP,qBACA,WACiC;AACjC,QAAO;EACL;EACA,kBAAkB,UAAU;EAC5B,eAAe,UAAU;EACzB,iBAAiB,UAAU;EAC3B,kBAAkB,UAAU;EAC7B;;AAGH,eAAsB,gBACpB,SACmB;CACnB,MAAM,QAAQ,QAAQ;CACtB,MAAM,gBAAgB,QAAQ;CAC9B,MAAM,2BAA2B,QAAQ;CACzC,MAAM,gBAAgB,kBAAkB;CACxC,MAAM,iBAAiB,kBAAkB;CACzC,MAAM,iBAAiB,kBAAkB;AAEzC,yBAAwB,iBAAiB,QAAQ,eAAe,EAAE,EAAE,MAAM,cAAc,CAAC;AACzF,0BAAyB,QAAQ,cAAc,KAAK;AAEpD,KAAI,QAAQ,iBAAiB,CAAC,QAAQ,sBAAsB;AAC1D,UAAQ,qBAAqB;AAC7B,SAAO,IAAI,SAAS,8BAA8B,EAAE,QAAQ,KAAK,CAAC;;CAGpE,MAAM,iBAAiB,6BAA6B;EAClD;EACA,yBAAyB,QAAQ;EACjC,gBAAgB,MAAM;EACtB,mBAAmB,QAAQ,kBAAkB;EAC7C,SAAS,QAAQ;EACjB,mBAAmB;EACpB,CAAC;AACF,KAAI,gBAAgB;AAClB,UAAQ,qBAAqB;AAC7B,SAAO;;AAGT,KAAI,iBAAiB,gBAAgB;AACnC,oBACE,qCAAqC;GACnC;GACA,WAAW;GACX,cAAc,MAAM;GACrB,CAAC,CACH;AACD,UAAQ,qBAAqB;GAC3B,UAAU,QAAQ;GAClB,cAAc,IAAI,iBAAiB;GACnC,QAAQ,QAAQ;GACjB,CAAC;;AAGJ,KACE,uBAAuB;EACrB;EACA,cAAc,QAAQ;EACtB,cAAc,QAAQ;EACtB,mBAAmB;EACnB,aAAa,QAAQ;EACtB,CAAC,EACF;EACA,MAAM,qBAAqB,MAAM,yBAAyB;GACxD,eAAe,QAAQ;GACvB,qBAAqB,QAAQ;GAC7B,cAAc,QAAQ;GACtB,UAAU,QAAQ;GAClB,QAAQ,QAAQ;GAChB,YAAY,QAAQ;GACpB,WAAW,QAAQ;GACnB,QAAQ,QAAQ;GAChB,oBAAoB,QAAQ;GAC5B,eAAe,QAAQ;GAGvB,mBAAmB,4BAA4B;GAC/C,yBAAyB,YACvB,8BACE;IACE,eAAe,QAAQ;IACvB,uBAAuB,QAAQ,cAAc;IAC7C;IACA,QAAQ,QAAQ;IAChB,cAAc,MAAM;IACpB,eAAe,MAAM;IACrB,sBAAsB,QAAQ;IAC/B,EACD,YAAY;IACV,MAAM,qBAAqB,MAAM,QAAQ,iBACvC,OACA,QAAQ,QACR,KAAA,GACA,IAAI,iBAAiB,CACtB;IACD,MAAM,qBAAqB,QAAQ,wBACjC,QAAQ,eACR,MAAM,QACP;IAID,MAAM,wBAAwB,8BAHD,QAAQ,uBAAuB,oBAAoB,EAC9E,SAAS,oBACV,CAAC,EACgF,KAAK;IACvF,MAAM,sBAAsB,MAAM,QAAQ,gBAAgB;IAC1D,MAAM,4BAAoE,EACxE,OAAO,MACR;IAgBD,MAAM,OAAO,MAAM,iBAfW,MAAM,oBAAoB,UACtD,sBAAsB,WACtB,QAAQ,sBAAsB,EAC9B;KACE,OAAO,QAAQ,cAAc;KAC7B,QAAQ,QAAQ,eAAe;KAC/B,UAAU,QAAQ,iBAAiB;KACpC,EACD,sBAAsB,aAClB;KACE,YAAY,sBAAsB;KAClC,oBAAoB;KACrB,GACD,KAAA,EACL,CACyD;IAC1D,MAAM,UAAU,MAAM,0BAA0B,0BAA0B,MAAM;IAChF,MAAM,YAAY,gCAAgC;AAClD,YAAQ,qBAAqB;AAM7B,WAAO;KACL;KACA;KACA,MARW,iBACX,QAAQ,eACR,uBAAuB,EACvB,MAAM,cACP;KAKC,cACE,OAAO,WAAW,eAAe,WAC7B;MAAE,YAAY,UAAU;MAAY,QAAQ,UAAU;MAAQ,GAC9D,KAAA;KACP;KAEJ;GACH,+BAA+B,KAAK,UAAU;AAC5C,YAAQ,+BAA+B,KAAK,UAAU;KACpD,YAAY;KACZ,WAAW,MAAM;KACjB,WAAW;KACZ,CAAC;;GAEL,CAAC;AACF,MAAI,mBACF,QAAO;;CAIX,MAAM,wBAAwB,MAAM,6BAA6B;EAC/D,qBAAqB,QAAQ;EAC7B,yBAAyB,QAAQ,wBAAwB;EACzD,sBAAsB,QAAQ;EAC9B,gBAAgB,MAAM;EACtB,QAAQ,QAAQ;EACjB,CAAC;AACF,KAAI,sBACF,QAAO;CAGT,MAAM,kBAAkB,MAAM,wBAK5B;EACA,iBAAiB,gBAAgB,iBAAiB,eAAe,uBAAuB;AACtF,4BAAyB,QAAQ,6BAA6B,eAAe,IAAI,KAAK;AACtF,UAAO,QAAQ,iBACb,gBACA,iBACA,eACA,sBACD;;EAEH,eAAe,QAAQ;EACvB,cAAc;EACd,cAAc,UAAU;AACtB,UAAO,QAAQ,cAAc,SAAS;;EAExC,mBAAmB,aAAa;AAC9B,UAAO,YAAY;;EAErB,eAAe,kBAAkB;AAC/B,UAAO,QAAQ,eAAe,iBAAiB;;EAEjD,cAAc,QAAQ;EACtB,wBAAwB,aAAa,kBAAkB;GACrD,MAAM,mBAAmB,QAAQ,wBAC/B,QAAQ,eACR,YAAY,QACb;GACD,MAAM,kBAAkB,QAAQ,uBAAuB,kBAAkB,EACvE,SAAS,kBACV,CAAC;GACF,MAAM,mBAAmB,IAAI,QAAQ;IACnC,gBAAgB;IAChB,MAAM;IACP,CAAC;AACF,kCAA+B,kBAAkB,QAAQ,kBAAkB,QAAQ;AACnF,UAAO,IAAI,SAAS,iBAAiB;IACnC,QAAQ,QAAQ,kBAAkB,UAAU;IAC5C,SAAS;IACV,CAAC;;EAEJ,cAAc,QAAQ;EACtB,sBAAsB,QAAQ;EAC9B,gBAAgB,WAAW;AACzB,UAAO,mBAAmB,QAAQ,qBAAqB,UAAU;;EAEpE,CAAC;AACF,KAAI,gBAAgB,SAClB,QAAO,gBAAgB;CAGzB,MAAM,kBAAkB,MAAM,oBAAoB;EAChD,mBAAmB;AACjB,UAAO,QAAQ,iBACb,OACA,QAAQ,QACR,gBAAgB,eAChB,QAAQ,aACT;;EAEH,wBAAwB,YAAY;AAClC,UAAO,QAAQ,wBAAwB,WAAW;;EAEpD,mBAAmB,cAAc;AAC/B,UAAO,uBAAuB,SAAS,aAAa;;EAEtD,qBAAqB;EACtB,CAAC;AACF,KAAI,gBAAgB,SAClB,QAAO,gBAAgB;AAGzB,QAAO,uBAAuB;EAC5B,eAAe,QAAQ;EACvB,qBAAqB,QAAQ;EAC7B;EACA;EACA,wBAAwB,UAAU,WAAW;AAC3C,UAAO,QAAQ,wBAAwB,UAAU,UAAU;;EAE7D,SAAS,gBAAgB;EACzB;EACA,cAAc,QAAQ;EACtB,iBAAiB,QAAQ;EACzB,eAAe,QAAQ;EACvB,sBAAsB,QAAQ;EAC9B,cAAc;AACZ,UAAO,iBAAiB,QAAQ,eAAe,uBAAuB,EAAE,MAAM,cAAc;;EAE9F,sBAAsB;AACpB,UAAO,gCAAgC;;EAEzC,uBAAuB;AACrB,UAAO,6BAA6B;;EAEtC,cAAc,QAAQ;EACtB,oBAAoB,QAAQ,MAAM,SAAS,QAAQ;EACnD;EACA;EACA;EACA,aAAa,QAAQ,IAAI,qBAAqB;EAC9C,cAAc,QAAQ;EACtB,cAAc,QAAQ;EACtB,UAAU,QAAQ;EAClB,YAAY,QAAQ;EACpB,WAAW,QAAQ;EACnB,QAAQ,QAAQ;EAChB,eAAe,QAAQ;EACvB,aAAa,MAAM,QAAQ;EAC3B,gBAAgB,QAAQ;EACxB,mBAAmB,QAAQ;EAC3B,QAAQ,QAAQ;EAChB,cAAc,aAAa;AACzB,UAAO,QAAQ,cAAc,YAAY;;EAE3C,YAAY;AACV,UAAO,QAAQ,WAAW;;EAE5B,gBAAgB;GACd,YAAY,OAAO;IACjB,MAAM,eAAe,MAAM,sBAAsB,UAAU;AAC3D,WAAO,gBAAgB,eACrB,sBAAsB,CAAC,GAAG,MAAM,cAAc,EAAE,aAAa,CAC9D;;GAEH,0BAA0B,MAAM;GAChC,kBAAkB,MAAM;GACxB,qBAAqB,QAAQ;GAC7B,MAAM,4BAA4B,IAAI;IACpC,MAAM,eAAe,qBAAqB;AAC1C,QAAI;AAGF,YAAO;MAAE,QAFM,MAAM,IAAI;MAER,iBADO,qBAAqB;MACX;cAC1B;AACR,0BAAqB;AACrB,SAAI,aAAc,mBAAkB;;;GAGzC;EACD,mBAAmB;EACnB,oBAAoB,QAAQ;EAC5B,4BAA4B,aAAa;AACvC,UAAO,QAAQ,wBAAwB,YAAY;;EAErD,yBAAyB,cAAc,aAAa;AAClD,UAAO,yBAAyB,SAAS,cAAc,YAAY;;EAErE,uBAAuB,cAAc;AACnC,UAAO,uBAAuB,SAAS,aAAa;;EAEtD,wBAAwB,QAAQ;EAChC,uBAAuB,QACrB,MAAM,OAAO,WAAW,MAAM,QAAQ,MAAM,gBAAgB,aAAa,QAAQ,CAClF;EACD,cAAc,MAAM;EACpB,6BAA6B,OAAO;AAClC,UAAO,QAAQ,6BAA6B,MAAM;;EAEpD,aAAa,QAAQ;EACrB,UAAU,cAAc;AACtB,+BAA4B,EAAE,UAAU,aAAa;;EAExD,CAAC;;AAGJ,eAAe,yBACb,SACA,cACA,aACmB;AACnB,QAAO,iCAAiC;EACtC,UAAU,QAAQ;EAClB,qBAAqB,QAAQ;EAC7B;EACA,cAAc,QAAQ;EACtB,mBAAmB,QAAQ;EAC3B,mBAAmB,YAAY;GAC7B,MAAM,iBAAiB,6CAA6C;IAClE;IACA,qBAAqB,QAAQ;IAC7B,oBAAoB,QAAQ;IAC5B,wBAAwB,QAAQ;IAChC,uBAAuB,QAAQ,MAAM;IACrC,sBAAsB,QAAQ,MAAM;IACpC,0BAA0B,QAAQ,MAAM;IACxC;IACD,CAAC,EAAE;AACJ,UAAO,QAAQ,6BACb,YACA;IACE,mBAAmB;IACnB,SAAS,QAAQ,MAAM,QAAQ,MAAM,GAAG,YAAY;IACpD,eAAe,QAAQ;IACxB,EACD,KACD;;EAEH,SAAS,QAAQ;EACjB;EACD,CAAC;;AAGJ,eAAe,uBACb,SACA,cACmB;AACnB,QAAO,iCAAiC;EACtC,UAAU,QAAQ;EAClB,qBAAqB,QAAQ;EAC7B;EACA,cAAc,QAAQ;EACtB,mBAAmB,QAAQ;EAC3B,mBAAmB,YAAY;AAC7B,UAAO,QAAQ,6BACb,YACA,EAAE,eAAe,QAAQ,QAAQ,EACjC,KACD;;EAEH,SAAS,QAAQ;EACjB;EACD,CAAC"}
+{"version":3,"file":"app-page-dispatch.js","names":[],"sources":["../../src/server/app-page-dispatch.ts"],"sourcesContent":["import type { ReactNode } from \"react\";\nimport type { ReactFormState } from \"react-dom/client\";\nimport type { ClassificationReason } from \"../build/layout-classification-types.js\";\nimport {\n  _consumeRequestScopedCacheLife,\n  _peekRequestScopedCacheLife,\n  type CachedAppPageValue,\n} from \"vinext/shims/cache\";\nimport {\n  consumeDynamicUsage,\n  consumeInvalidDynamicUsageError,\n  consumeRenderRequestApiUsage,\n  getAndClearPendingCookies,\n  getDraftModeCookieHeader,\n  isDraftModeRequest,\n  markDynamicUsage,\n  peekRenderRequestApiUsage,\n  setHeadersContext,\n} from \"vinext/shims/headers\";\nimport { getRequestExecutionContext } from \"vinext/shims/request-context\";\nimport { createRequestContext, runWithRequestContext } from \"vinext/shims/unified-request-context\";\nimport {\n  ensureFetchPatch,\n  consumeDynamicFetchObservations,\n  type FetchCacheMode,\n  getCollectedFetchTags,\n  peekDynamicFetchObservations,\n  runWithFetchDedupe,\n  setCurrentFetchCacheMode,\n  setCurrentFetchSoftTags,\n} from \"vinext/shims/fetch-cache\";\nimport { AppElementsWire, type AppOutgoingElements } from \"./app-elements.js\";\nimport { readAppPageCacheResponse } from \"./app-page-cache.js\";\nimport { resolveAppPageParentHttpAccessBoundaryModule } from \"./app-page-boundary.js\";\nimport { readStreamAsText } from \"../utils/text-stream.js\";\nimport {\n  buildAppPageSpecialErrorResponse,\n  resolveAppPageSpecialError,\n  teeAppPageRscStreamForCapture,\n  type AppPageFontPreload,\n  type AppPageSpecialError,\n  type LayoutClassificationOptions,\n} from \"./app-page-execution.js\";\nimport { resolveAppPageMethodResponse } from \"./app-page-method.js\";\nimport {\n  buildAppPageElement,\n  resolveAppPageIntercept,\n  validateAppPageDynamicParams,\n  type ValidateAppPageDynamicParamsOptions,\n} from \"./app-page-request.js\";\nimport { renderAppPageLifecycle } from \"./app-page-render.js\";\nimport {\n  createAppPageHtmlOutputScope,\n  createAppPageRenderObservation,\n  createAppPageRscOutputScope,\n} from \"./app-page-render-observation.js\";\nimport {\n  mergeMiddlewareResponseHeaders,\n  type AppPageMiddlewareContext,\n} from \"./app-page-response.js\";\nimport {\n  VINEXT_RSC_CONTENT_TYPE,\n  VINEXT_RSC_VARY_HEADER,\n  applyRscCompatibilityIdHeader,\n} from \"./app-rsc-cache-busting.js\";\nimport {\n  APP_RSC_RENDER_MODE_NAVIGATION,\n  shouldSuppressLoadingBoundaries,\n  type AppRscRenderMode,\n} from \"./app-rsc-render-mode.js\";\nimport { createAppPageTreePath } from \"./app-page-route-wiring.js\";\nimport type { AppPageSsrHandler } from \"./app-page-stream.js\";\nimport { createStaticGenerationHeadersContext } from \"./app-static-generation.js\";\nimport { buildPageCacheTags } from \"./implicit-tags.js\";\nimport type { ISRCacheEntry } from \"./isr-cache.js\";\n\ntype AppPageParams = Record<string, string | string[]>;\ntype AppPageElement = ReactNode | Readonly<Record<string, ReactNode>>;\ntype AppPageRenderableElement = ReactNode | AppOutgoingElements;\ntype AppPageBoundaryOnError = (\n  error: unknown,\n  requestInfo: unknown,\n  errorContext: unknown,\n) => unknown;\ntype AppPageDebugLogger = (event: string, detail: string) => void;\ntype AppPageCacheSetter = (\n  key: string,\n  data: CachedAppPageValue,\n  revalidateSeconds: number,\n  tags: string[],\n  expireSeconds?: number,\n) => Promise<void>;\ntype AppPageCacheGetter = (key: string) => Promise<ISRCacheEntry | null>;\ntype AppPageBackgroundRegenerationErrorContext = {\n  routerKind: \"App Router\";\n  routePath: string;\n  routeType: \"render\";\n};\ntype AppPageBackgroundRegenerator = (\n  key: string,\n  renderFn: () => Promise<void>,\n  errorContext?: AppPageBackgroundRegenerationErrorContext,\n) => void;\n\ntype AppPageDispatchIntercept<TPage = unknown> = {\n  interceptLayouts?: readonly AppPageModule[] | null;\n  matchedParams: AppPageParams;\n  page: TPage;\n  slotId?: string | null;\n  slotKey: string;\n  sourceRouteIndex: number;\n};\n\ntype AppPageDispatchInterceptOptions<TPage = unknown> = {\n  interceptionContext: string | null;\n  interceptLayouts?: readonly AppPageModule[] | null;\n  interceptPage: TPage;\n  interceptParams: AppPageParams;\n  interceptSlotId?: string | null;\n  interceptSlotKey: string;\n  interceptSourceMatchedUrl?: string | null;\n};\n\ntype AppPageModule = {\n  default?: unknown;\n};\n\ntype AppPageDispatchRoute = {\n  __buildTimeClassifications?: LayoutClassificationOptions[\"buildTimeClassifications\"];\n  __buildTimeReasons?: LayoutClassificationOptions[\"buildTimeReasons\"];\n  error?: AppPageModule | null;\n  errors?: readonly (AppPageModule | null | undefined)[];\n  forbiddens?: readonly (AppPageModule | null | undefined)[];\n  isDynamic: boolean;\n  layouts: readonly AppPageModule[];\n  layoutTreePositions?: readonly number[];\n  loading?: AppPageModule | null;\n  notFounds?: readonly (AppPageModule | null | undefined)[];\n  params: readonly string[];\n  pattern: string;\n  routeSegments: readonly string[];\n  unauthorizeds?: readonly (AppPageModule | null | undefined)[];\n};\n\ntype DispatchAppPageOptions<TRoute extends AppPageDispatchRoute> = {\n  /** Configured basePath (e.g. \"/blog\"). Used to prefix redirect Locations. */\n  basePath?: string;\n  buildPageElement: (\n    route: TRoute,\n    params: AppPageParams,\n    opts: AppPageDispatchInterceptOptions | undefined,\n    searchParams: URLSearchParams,\n  ) => Promise<AppPageElement>;\n  cleanPathname: string;\n  clearRequestContext: () => void;\n  createRscOnErrorHandler: (pathname: string, routePath: string) => AppPageBoundaryOnError;\n  debugClassification?: (layoutId: string, reason: ClassificationReason) => void;\n  dynamicConfig?: string;\n  dynamicParamsConfig?: boolean;\n  fetchCache?: FetchCacheMode | null;\n  findIntercept: (pathname: string) => AppPageDispatchIntercept | null;\n  formState?: ReactFormState | null;\n  actionError?: unknown;\n  actionFailed?: boolean;\n  generateStaticParams?: ValidateAppPageDynamicParamsOptions[\"generateStaticParams\"];\n  getFontLinks: () => string[];\n  getFontPreloads: () => AppPageFontPreload[];\n  getFontStyles: () => string[];\n  getNavigationContext: () => unknown;\n  getSourceRoute: (sourceRouteIndex: number) => TRoute | undefined;\n  hasGenerateStaticParams: boolean;\n  hasPageDefaultExport: boolean;\n  hasPageModule: boolean;\n  handlerStart: number;\n  interceptionContext: string | null;\n  isProgressiveActionRender?: boolean;\n  isProduction: boolean;\n  isRscRequest: boolean;\n  isrDebug?: AppPageDebugLogger;\n  isrGet: AppPageCacheGetter;\n  isrHtmlKey: (pathname: string) => string;\n  isrRscKey: (\n    pathname: string,\n    mountedSlotsHeader?: string | null,\n    renderMode?: AppRscRenderMode,\n  ) => string;\n  isrSet: AppPageCacheSetter;\n  loadSsrHandler: () => Promise<AppPageSsrHandler>;\n  middlewareContext: AppPageMiddlewareContext;\n  mountedSlotsHeader?: string | null;\n  params: AppPageParams;\n  probeLayoutAt: (layoutIndex: number) => unknown;\n  probePage: () => unknown;\n  expireSeconds?: number;\n  renderErrorBoundaryPage: (error: unknown) => Promise<Response | null>;\n  renderHttpAccessFallbackPage: (\n    statusCode: number,\n    opts: {\n      boundaryComponent?: unknown;\n      layouts?: readonly AppPageModule[];\n      matchedParams: AppPageParams;\n    },\n    middlewareContext: AppPageMiddlewareContext | null,\n  ) => Promise<Response | null>;\n  renderToReadableStream: (\n    element: AppPageRenderableElement,\n    options: { onError: AppPageBoundaryOnError },\n  ) => ReadableStream<Uint8Array>;\n  request: Request;\n  revalidateSeconds: number | null;\n  resolveRouteFetchCacheMode?: (route: TRoute) => FetchCacheMode | null;\n  rootForbiddenModule?: AppPageModule | null;\n  rootNotFoundModule?: AppPageModule | null;\n  rootUnauthorizedModule?: AppPageModule | null;\n  route: TRoute;\n  runWithSuppressedHookWarning<T>(probe: () => Promise<T>): Promise<T>;\n  scheduleBackgroundRegeneration: AppPageBackgroundRegenerator;\n  scriptNonce?: string;\n  searchParams: URLSearchParams;\n  setNavigationContext: (context: {\n    params: AppPageParams;\n    pathname: string;\n    searchParams: URLSearchParams;\n  }) => void;\n  renderMode?: AppRscRenderMode;\n};\n\nfunction shouldReadAppPageCache(options: {\n  isProgressiveActionRender: boolean;\n  isDraftMode: boolean;\n  isForceDynamic: boolean;\n  isProduction: boolean;\n  isRscRequest: boolean;\n  revalidateSeconds: number | null;\n  scriptNonce?: string;\n}): boolean {\n  return (\n    options.isProduction &&\n    !options.isProgressiveActionRender &&\n    !options.isDraftMode &&\n    !options.isForceDynamic &&\n    (options.isRscRequest || !options.scriptNonce) &&\n    (options.revalidateSeconds === null || options.revalidateSeconds > 0)\n  );\n}\n\nfunction buildAppPageTags(\n  cleanPathname: string,\n  extraTags: string[],\n  routeSegments: readonly string[],\n): string[] {\n  return buildPageCacheTags(cleanPathname, extraTags, [...routeSegments], \"page\");\n}\n\nasync function runAppPageRevalidationContext<\n  TResult extends {\n    html: string;\n    rscData: ArrayBuffer;\n    tags: string[];\n  },\n>(\n  options: {\n    cleanPathname: string;\n    currentFetchCacheMode?: FetchCacheMode | null;\n    dynamicConfig?: string;\n    params: AppPageParams;\n    routePattern: string;\n    routeSegments: readonly string[];\n    setNavigationContext: DispatchAppPageOptions<AppPageDispatchRoute>[\"setNavigationContext\"];\n  },\n  renderFn: () => Promise<TResult>,\n): Promise<TResult> {\n  const headersContext = createStaticGenerationHeadersContext({\n    dynamicConfig: options.dynamicConfig,\n    routeKind: \"page\",\n    routePattern: options.routePattern,\n  });\n  const requestContext = createRequestContext({\n    headersContext,\n    currentFetchCacheMode: options.currentFetchCacheMode ?? null,\n    executionContext: getRequestExecutionContext(),\n    unstableCacheRevalidation: \"foreground\",\n  });\n\n  return runWithRequestContext(requestContext, async () => {\n    ensureFetchPatch();\n    setCurrentFetchSoftTags(buildAppPageTags(options.cleanPathname, [], options.routeSegments));\n    options.setNavigationContext({\n      pathname: options.cleanPathname,\n      searchParams: new URLSearchParams(),\n      params: options.params,\n    });\n    return await runWithFetchDedupe(renderFn);\n  });\n}\n\nfunction getCapturedRscDataPromise(\n  capturedRscDataPromise: Promise<ArrayBuffer> | null,\n): Promise<ArrayBuffer> {\n  if (!capturedRscDataPromise) {\n    throw new Error(\n      \"[vinext] Expected captured RSC data while regenerating an app page cache entry\",\n    );\n  }\n\n  return capturedRscDataPromise;\n}\n\nfunction toInterceptOptions(\n  interceptionContext: string | null,\n  intercept: AppPageDispatchIntercept,\n): AppPageDispatchInterceptOptions {\n  return {\n    interceptionContext,\n    interceptLayouts: intercept.interceptLayouts,\n    interceptPage: intercept.page,\n    interceptParams: intercept.matchedParams,\n    interceptSlotId: intercept.slotId ?? null,\n    interceptSlotKey: intercept.slotKey,\n    interceptSourceMatchedUrl: interceptionContext,\n  };\n}\n\nexport async function dispatchAppPage<TRoute extends AppPageDispatchRoute>(\n  options: DispatchAppPageOptions<TRoute>,\n): Promise<Response> {\n  return await runWithFetchDedupe(() => dispatchAppPageInner(options));\n}\n\nasync function dispatchAppPageInner<TRoute extends AppPageDispatchRoute>(\n  options: DispatchAppPageOptions<TRoute>,\n): Promise<Response> {\n  const route = options.route;\n  const dynamicConfig = options.dynamicConfig;\n  const currentRevalidateSeconds = options.revalidateSeconds;\n  const isForceStatic = dynamicConfig === \"force-static\";\n  const isDynamicError = dynamicConfig === \"error\";\n  const isForceDynamic = dynamicConfig === \"force-dynamic\";\n  const isDraftMode = isDraftModeRequest(options.request);\n\n  setCurrentFetchSoftTags(buildAppPageTags(options.cleanPathname, [], route.routeSegments));\n  setCurrentFetchCacheMode(options.fetchCache ?? null);\n\n  if (options.hasPageModule && !options.hasPageDefaultExport) {\n    options.clearRequestContext();\n    return new Response(\"Page has no default export\", { status: 500 });\n  }\n\n  const methodResponse = resolveAppPageMethodResponse({\n    dynamicConfig,\n    hasGenerateStaticParams: options.hasGenerateStaticParams,\n    isDynamicRoute: route.isDynamic,\n    middlewareHeaders: options.middlewareContext.headers,\n    request: options.request,\n    revalidateSeconds: currentRevalidateSeconds,\n  });\n  if (methodResponse) {\n    options.clearRequestContext();\n    return methodResponse;\n  }\n\n  if ((isForceStatic || isDynamicError) && !isDraftMode) {\n    setHeadersContext(\n      createStaticGenerationHeadersContext({\n        dynamicConfig,\n        routeKind: \"page\",\n        routePattern: route.pattern,\n      }),\n    );\n    options.setNavigationContext({\n      pathname: options.cleanPathname,\n      searchParams: new URLSearchParams(),\n      params: options.params,\n    });\n  }\n\n  if (\n    shouldReadAppPageCache({\n      isDraftMode,\n      isForceDynamic,\n      isProgressiveActionRender: options.isProgressiveActionRender === true,\n      isProduction: options.isProduction,\n      isRscRequest: options.isRscRequest,\n      revalidateSeconds: currentRevalidateSeconds,\n      scriptNonce: options.scriptNonce,\n    })\n  ) {\n    const cachedPageResponse = await readAppPageCacheResponse({\n      cleanPathname: options.cleanPathname,\n      clearRequestContext: options.clearRequestContext,\n      isRscRequest: options.isRscRequest,\n      isrDebug: options.isrDebug,\n      isrGet: options.isrGet,\n      isrHtmlKey: options.isrHtmlKey,\n      isrRscKey: options.isrRscKey,\n      isrSet: options.isrSet,\n      middlewareHeaders: options.middlewareContext.headers,\n      middlewareStatus: options.middlewareContext.status,\n      mountedSlotsHeader: options.mountedSlotsHeader,\n      renderMode: options.renderMode,\n      expireSeconds: options.expireSeconds,\n      // cacheLife-only routes discover their actual revalidate during the\n      // fresh render; this seed only gets them into the cache read path.\n      revalidateSeconds: currentRevalidateSeconds ?? 0,\n      renderFreshPageForCache: async () =>\n        runAppPageRevalidationContext(\n          {\n            cleanPathname: options.cleanPathname,\n            currentFetchCacheMode: options.fetchCache ?? null,\n            dynamicConfig,\n            params: options.params,\n            routePattern: route.pattern,\n            routeSegments: route.routeSegments,\n            setNavigationContext: options.setNavigationContext,\n          },\n          async () => {\n            const revalidatedElement = await options.buildPageElement(\n              route,\n              options.params,\n              undefined,\n              new URLSearchParams(),\n            );\n            const revalidatedOnError = options.createRscOnErrorHandler(\n              options.cleanPathname,\n              route.pattern,\n            );\n            // No inner runWithFetchDedupe here: this renderFn is already\n            // wrapped in runWithFetchDedupe by runAppPageRevalidationContext.\n            const revalidatedRscStream = options.renderToReadableStream(revalidatedElement, {\n              onError: revalidatedOnError,\n            });\n            const revalidatedRscCapture = teeAppPageRscStreamForCapture(revalidatedRscStream, true);\n            const revalidatedSsrEntry = await options.loadSsrHandler();\n            const revalidatedCapturedRscRef: { value: Promise<ArrayBuffer> | null } = {\n              value: null,\n            };\n            const revalidatedHtmlStream = await revalidatedSsrEntry.handleSsr(\n              revalidatedRscCapture.ssrStream,\n              options.getNavigationContext(),\n              {\n                links: options.getFontLinks(),\n                styles: options.getFontStyles(),\n                preloads: options.getFontPreloads(),\n              },\n              {\n                basePath: options.basePath,\n                ...(revalidatedRscCapture.sideStream\n                  ? {\n                      sideStream: revalidatedRscCapture.sideStream,\n                      capturedRscDataRef: revalidatedCapturedRscRef,\n                    }\n                  : {}),\n              },\n            );\n            const html = await readStreamAsText(revalidatedHtmlStream);\n            const rscData = await getCapturedRscDataPromise(revalidatedCapturedRscRef.value);\n            const cacheLife = _consumeRequestScopedCacheLife();\n            options.clearRequestContext();\n            const tags = buildAppPageTags(\n              options.cleanPathname,\n              getCollectedFetchTags(),\n              route.routeSegments,\n            );\n            // Consume once: HTML and RSC artifacts are produced by the same\n            // regeneration render and should carry the same observation set.\n            const observationState = {\n              dynamicFetches: consumeDynamicFetchObservations(),\n              requestApis: consumeRenderRequestApiUsage(),\n            };\n            return {\n              html,\n              htmlRenderObservation: createAppPageRenderObservation({\n                boundaryOutcome: { kind: \"success\" },\n                cacheability: \"public\",\n                cacheTags: tags,\n                cleanPathname: options.cleanPathname,\n                completeness: \"complete\",\n                output: createAppPageHtmlOutputScope({\n                  element: revalidatedElement,\n                  renderEpoch: null,\n                  rootBoundaryId: null,\n                  routePattern: route.pattern,\n                }),\n                params: options.params,\n                state: observationState,\n              }),\n              rscData,\n              rscRenderObservation: createAppPageRenderObservation({\n                boundaryOutcome: { kind: \"success\" },\n                cacheability: \"public\",\n                cacheTags: tags,\n                cleanPathname: options.cleanPathname,\n                completeness: \"complete\",\n                output: createAppPageRscOutputScope({\n                  element: revalidatedElement,\n                  mountedSlotsHeader: options.mountedSlotsHeader,\n                  renderEpoch: null,\n                  rootBoundaryId: null,\n                  routePattern: route.pattern,\n                }),\n                params: options.params,\n                state: observationState,\n              }),\n              tags,\n              cacheControl:\n                typeof cacheLife?.revalidate === \"number\"\n                  ? { revalidate: cacheLife.revalidate, expire: cacheLife.expire }\n                  : undefined,\n            };\n          },\n        ),\n      scheduleBackgroundRegeneration(key, renderFn) {\n        options.scheduleBackgroundRegeneration(key, renderFn, {\n          routerKind: \"App Router\",\n          routePath: route.pattern,\n          routeType: \"render\",\n        });\n      },\n    });\n    if (cachedPageResponse) {\n      return cachedPageResponse;\n    }\n  }\n\n  const dynamicParamsResponse = await validateAppPageDynamicParams({\n    clearRequestContext: options.clearRequestContext,\n    enforceStaticParamsOnly: options.dynamicParamsConfig === false,\n    generateStaticParams: options.generateStaticParams,\n    isDynamicRoute: route.isDynamic,\n    params: options.params,\n  });\n  if (dynamicParamsResponse) {\n    return dynamicParamsResponse;\n  }\n\n  const interceptResult = await resolveAppPageIntercept<\n    TRoute,\n    unknown,\n    AppPageDispatchInterceptOptions,\n    AppPageElement\n  >({\n    buildPageElement(interceptRoute, interceptParams, interceptOpts, interceptSearchParams) {\n      setCurrentFetchCacheMode(options.resolveRouteFetchCacheMode?.(interceptRoute) ?? null);\n      return options.buildPageElement(\n        interceptRoute,\n        interceptParams,\n        interceptOpts,\n        interceptSearchParams,\n      );\n    },\n    cleanPathname: options.cleanPathname,\n    currentRoute: route,\n    findIntercept(pathname) {\n      return options.findIntercept(pathname);\n    },\n    getRouteParamNames(sourceRoute) {\n      return sourceRoute.params;\n    },\n    getSourceRoute(sourceRouteIndex) {\n      return options.getSourceRoute(sourceRouteIndex);\n    },\n    isRscRequest: options.isRscRequest,\n    renderInterceptResponse(sourceRoute, interceptElement) {\n      const interceptOnError = options.createRscOnErrorHandler(\n        options.cleanPathname,\n        sourceRoute.pattern,\n      );\n      // No inner runWithFetchDedupe here: dispatchAppPage already activated\n      // dedupe at line 294, and this callback runs inside dispatchAppPageInner.\n      const interceptStream = options.renderToReadableStream(interceptElement, {\n        onError: interceptOnError,\n      });\n      const interceptHeaders = new Headers({\n        \"Content-Type\": VINEXT_RSC_CONTENT_TYPE,\n        Vary: VINEXT_RSC_VARY_HEADER,\n      });\n      mergeMiddlewareResponseHeaders(interceptHeaders, options.middlewareContext.headers);\n      applyRscCompatibilityIdHeader(interceptHeaders);\n      return new Response(interceptStream, {\n        status: options.middlewareContext.status ?? 200,\n        headers: interceptHeaders,\n      });\n    },\n    searchParams: options.searchParams,\n    setNavigationContext: options.setNavigationContext,\n    toInterceptOpts(intercept) {\n      return toInterceptOptions(options.interceptionContext, intercept);\n    },\n  });\n  if (interceptResult.response) {\n    return interceptResult.response;\n  }\n\n  const pageBuildResult = await buildAppPageElement({\n    buildPageElement() {\n      if (options.actionFailed) {\n        throw options.actionError;\n      }\n      return options.buildPageElement(\n        route,\n        options.params,\n        interceptResult.interceptOpts,\n        options.searchParams,\n      );\n    },\n    renderErrorBoundaryPage(buildError) {\n      return options.renderErrorBoundaryPage(buildError);\n    },\n    renderSpecialError(specialError) {\n      return renderPageSpecialError(options, specialError);\n    },\n    resolveSpecialError: resolveAppPageSpecialError,\n  });\n  if (pageBuildResult.response) {\n    return pageBuildResult.response;\n  }\n\n  return renderAppPageLifecycle({\n    basePath: options.basePath,\n    cleanPathname: options.cleanPathname,\n    clearRequestContext: options.clearRequestContext,\n    consumeDynamicUsage,\n    consumeInvalidDynamicUsageError,\n    consumeRenderObservationState() {\n      return {\n        dynamicFetches: consumeDynamicFetchObservations(),\n        requestApis: consumeRenderRequestApiUsage(),\n      };\n    },\n    createRscOnErrorHandler(pathname, routePath) {\n      return options.createRscOnErrorHandler(pathname, routePath);\n    },\n    element: pageBuildResult.element,\n    getDraftModeCookieHeader,\n    getFontLinks: options.getFontLinks,\n    getFontPreloads: options.getFontPreloads,\n    getFontStyles: options.getFontStyles,\n    getNavigationContext: options.getNavigationContext,\n    getPageTags() {\n      return buildAppPageTags(options.cleanPathname, getCollectedFetchTags(), route.routeSegments);\n    },\n    getRequestCacheLife() {\n      return _consumeRequestScopedCacheLife();\n    },\n    peekRequestCacheLife() {\n      return _peekRequestScopedCacheLife();\n    },\n    handlerStart: options.handlerStart,\n    hasLoadingBoundary: shouldSuppressLoadingBoundaries(\n      options.renderMode ?? APP_RSC_RENDER_MODE_NAVIGATION,\n    )\n      ? false\n      : Boolean(route.loading?.default),\n    formState: options.formState ?? null,\n    isProgressiveActionRender: options.isProgressiveActionRender === true,\n    isDynamicError,\n    isDraftMode,\n    isForceDynamic,\n    isForceStatic,\n    isPrerender: process.env.VINEXT_PRERENDER === \"1\",\n    isProduction: options.isProduction,\n    isRscRequest: options.isRscRequest,\n    isrDebug: options.isrDebug,\n    isrHtmlKey: options.isrHtmlKey,\n    isrRscKey: options.isrRscKey,\n    isrSet: options.isrSet,\n    expireSeconds: options.expireSeconds,\n    layoutCount: route.layouts.length,\n    loadSsrHandler: options.loadSsrHandler,\n    middlewareContext: options.middlewareContext,\n    params: options.params,\n    peekRenderObservationState() {\n      return {\n        dynamicFetches: peekDynamicFetchObservations(),\n        requestApis: peekRenderRequestApiUsage(),\n      };\n    },\n    probeLayoutAt(layoutIndex) {\n      return options.probeLayoutAt(layoutIndex);\n    },\n    probePage() {\n      return options.probePage();\n    },\n    classification: {\n      getLayoutId(index) {\n        const treePosition = route.layoutTreePositions?.[index] ?? 0;\n        return AppElementsWire.encodeLayoutId(\n          createAppPageTreePath([...route.routeSegments], treePosition),\n        );\n      },\n      buildTimeClassifications: route.__buildTimeClassifications,\n      buildTimeReasons: route.__buildTimeReasons,\n      debugClassification: options.debugClassification,\n      async runWithIsolatedDynamicScope(fn) {\n        const priorDynamic = consumeDynamicUsage();\n        try {\n          const result = await fn();\n          const dynamicDetected = consumeDynamicUsage();\n          return { result, dynamicDetected };\n        } finally {\n          consumeDynamicUsage();\n          if (priorDynamic) markDynamicUsage();\n        }\n      },\n    },\n    revalidateSeconds: currentRevalidateSeconds,\n    mountedSlotsHeader: options.mountedSlotsHeader,\n    renderMode: options.renderMode ?? APP_RSC_RENDER_MODE_NAVIGATION,\n    renderErrorBoundaryResponse(renderError) {\n      return options.renderErrorBoundaryPage(renderError);\n    },\n    renderLayoutSpecialError(specialError, layoutIndex) {\n      return renderLayoutSpecialError(options, specialError, layoutIndex);\n    },\n    renderPageSpecialError(specialError) {\n      return renderPageSpecialError(options, specialError);\n    },\n    renderToReadableStream: options.renderToReadableStream,\n    routeHasLocalBoundary: Boolean(\n      route.error?.default || route.errors?.some((errorModule) => errorModule?.default),\n    ),\n    routePattern: route.pattern,\n    runWithSuppressedHookWarning(probe) {\n      return options.runWithSuppressedHookWarning(probe);\n    },\n    scriptNonce: options.scriptNonce,\n    waitUntil(cachePromise) {\n      getRequestExecutionContext()?.waitUntil(cachePromise);\n    },\n  });\n}\n\nasync function renderLayoutSpecialError<TRoute extends AppPageDispatchRoute>(\n  options: DispatchAppPageOptions<TRoute>,\n  specialError: AppPageSpecialError,\n  layoutIndex: number,\n): Promise<Response> {\n  return buildAppPageSpecialErrorResponse({\n    basePath: options.basePath,\n    clearRequestContext: options.clearRequestContext,\n    getAndClearPendingCookies,\n    isRscRequest: options.isRscRequest,\n    middlewareContext: options.middlewareContext,\n    renderFallbackPage(statusCode) {\n      const parentBoundary = resolveAppPageParentHttpAccessBoundaryModule({\n        layoutIndex,\n        rootForbiddenModule: options.rootForbiddenModule,\n        rootNotFoundModule: options.rootNotFoundModule,\n        rootUnauthorizedModule: options.rootUnauthorizedModule,\n        routeForbiddenModules: options.route.forbiddens,\n        routeNotFoundModules: options.route.notFounds,\n        routeUnauthorizedModules: options.route.unauthorizeds,\n        statusCode,\n      })?.default;\n      return options.renderHttpAccessFallbackPage(\n        statusCode,\n        {\n          boundaryComponent: parentBoundary,\n          layouts: options.route.layouts.slice(0, layoutIndex),\n          matchedParams: options.params,\n        },\n        null,\n      );\n    },\n    request: options.request,\n    specialError,\n  });\n}\n\nasync function renderPageSpecialError<TRoute extends AppPageDispatchRoute>(\n  options: DispatchAppPageOptions<TRoute>,\n  specialError: AppPageSpecialError,\n): Promise<Response> {\n  return buildAppPageSpecialErrorResponse({\n    basePath: options.basePath,\n    clearRequestContext: options.clearRequestContext,\n    getAndClearPendingCookies,\n    isRscRequest: options.isRscRequest,\n    middlewareContext: options.middlewareContext,\n    renderFallbackPage(statusCode) {\n      return options.renderHttpAccessFallbackPage(\n        statusCode,\n        { matchedParams: options.params },\n        null,\n      );\n    },\n    request: options.request,\n    specialError,\n  });\n}\n"],"mappings":"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"}

package/dist/server/app-page-element-builder.d.ts

@@ -1,6 +1,7 @@
 import { MetadataFileRoute } from "./metadata-routes.js";
 import { AppElements } from "./app-elements-wire.js";
 import { AppPageParams } from "./app-page-boundary.js";
+import { AppRscRenderMode } from "./app-rsc-render-mode.js";
 import { AppPageErrorModule, AppPageModule, AppPageRouteWiringRoute } from "./app-page-route-wiring.js";
 
 //#region src/server/app-page-element-builder.d.ts
@@ -19,14 +20,17 @@ type AppPageInterceptOptions<TModule extends AppPageModule = AppPageModule> = {
   interceptLayouts?: readonly (TModule | null | undefined)[] | null;
   interceptPage?: TModule | null;
   interceptParams?: AppPageParams | null;
+  interceptSlotId?: string | null;
   interceptSlotKey?: string | null;
+  interceptSourceMatchedUrl?: string | null;
 };
 type AppPagePageRequest<TModule extends AppPageModule = AppPageModule> = {
   /** Interception context from current-route navigation (null for direct visits). */opts?: AppPageInterceptOptions<TModule> | null; /** URL search params from the incoming request (null when unavailable). */
   searchParams?: URLSearchParams | null; /** Whether the incoming request is an RSC (client-side navigation) request. */
   isRscRequest: boolean; /** The incoming HTTP request (available but unused by this module). */
   request: Request; /** Normalized x-vinext-mounted-slots header value. */
-  mountedSlotsHeader: string | null;
+  mountedSlotsHeader: string | null; /** Semantic RSC payload mode for this page render. */
+  renderMode?: AppRscRenderMode;
 };
 type BuildPageElementsOptions<TModule extends AppPageModule = AppPageModule, TErrorModule extends AppPageErrorModule = AppPageErrorModule> = {
   route: AppPageBuildRoute<TModule, TErrorModule>;
@@ -38,6 +42,11 @@ type BuildPageElementsOptions<TModule extends AppPageModule = AppPageModule, TEr
   rootForbiddenModule?: TModule | null; /** Root-level unauthorized.tsx module. Present when the app defines this file. */
   rootUnauthorizedModule?: TModule | null; /** File-based metadata routes (favicon, manifest, sitemap, etc.). */
   metadataRoutes: readonly MetadataFileRoute[];
+  /**
+   * Configured next.config `basePath`. Threaded through `resolveAppPageHead`
+   * so file-based metadata route URLs emitted in <head> are prefixed.
+   */
+  basePath?: string;
 };
 /**
  * Build the App Router element tree for a matched route.