vinext 0.0.54 → 0.0.55

package/dist/server/app-browser-popstate.js.map

@@ -1 +1 @@
-{"version":3,"file":"app-browser-popstate.js","names":[],"sources":["../../src/server/app-browser-popstate.ts"],"sourcesContent":["type RestoreScrollPosition = (state: unknown) => void;\ntype NavigateRsc = (\n  href: string,\n  redirectDepth?: number,\n  navigationKind?: \"navigate\" | \"traverse\" | \"refresh\",\n) => Promise<void>;\n\ntype BrowserPopstateRestoreDeps = {\n  getActiveNavigationId: () => number;\n  getPendingNavigation: () => Promise<void> | null | undefined;\n  getNavigate: () => NavigateRsc | undefined;\n  isCurrentNavigation: (navId: number) => boolean;\n  notifyAppRouterTransitionStart: (href: string) => void;\n  restorePopstateScrollPosition: RestoreScrollPosition;\n  setPendingNavigation: (pendingNavigation: Promise<void> | null) => void;\n};\n\nexport function createPopstateRestoreHandler(\n  deps: BrowserPopstateRestoreDeps,\n): (event: PopStateEvent) => void {\n  return (event) => {\n    deps.notifyAppRouterTransitionStart(window.location.href);\n    const navigate = deps.getNavigate();\n    const pendingNavigation = navigate?.(window.location.href, 0, \"traverse\") ?? Promise.resolve();\n    const popstateNavId = deps.getActiveNavigationId();\n\n    deps.setPendingNavigation(pendingNavigation);\n\n    void pendingNavigation.finally(() => {\n      if (deps.isCurrentNavigation(popstateNavId)) {\n        deps.restorePopstateScrollPosition(event.state);\n      }\n\n      if (deps.getPendingNavigation() === pendingNavigation) {\n        deps.setPendingNavigation(null);\n      }\n    });\n  };\n}\n"],"mappings":";AAiBA,SAAgB,6BACd,MACgC;CAChC,QAAQ,UAAU;EAChB,KAAK,+BAA+B,OAAO,SAAS,KAAK;EAEzD,MAAM,oBADW,KAAK,aACY,GAAG,OAAO,SAAS,MAAM,GAAG,WAAW,IAAI,QAAQ,SAAS;EAC9F,MAAM,gBAAgB,KAAK,uBAAuB;EAElD,KAAK,qBAAqB,kBAAkB;EAE5C,kBAAuB,cAAc;GACnC,IAAI,KAAK,oBAAoB,cAAc,EACzC,KAAK,8BAA8B,MAAM,MAAM;GAGjD,IAAI,KAAK,sBAAsB,KAAK,mBAClC,KAAK,qBAAqB,KAAK;IAEjC"}
+{"version":3,"file":"app-browser-popstate.js","names":[],"sources":["../../src/server/app-browser-popstate.ts"],"sourcesContent":["type RestoreScrollPosition = (\n  state: unknown,\n  options?: {\n    shouldContinue?: () => boolean;\n  },\n) => void;\ntype NavigateRsc = (\n  href: string,\n  redirectDepth?: number,\n  navigationKind?: \"navigate\" | \"traverse\" | \"refresh\",\n) => Promise<void>;\n\ntype BrowserPopstateRestoreDeps = {\n  getActiveNavigationId: () => number;\n  getPendingNavigation: () => Promise<void> | null | undefined;\n  getNavigate: () => NavigateRsc | undefined;\n  isCurrentNavigation: (navId: number) => boolean;\n  notifyAppRouterTransitionStart: (href: string) => void;\n  restorePopstateScrollPosition: RestoreScrollPosition;\n  setPendingNavigation: (pendingNavigation: Promise<void> | null) => void;\n};\n\nfunction hasSavedScrollPosition(state: unknown): boolean {\n  return Boolean(state && typeof state === \"object\" && \"__vinext_scrollY\" in state);\n}\n\nfunction scheduleAfterFrame(callback: () => void): void {\n  if (typeof window !== \"undefined\" && typeof window.requestAnimationFrame === \"function\") {\n    window.requestAnimationFrame(callback);\n    return;\n  }\n\n  queueMicrotask(callback);\n}\n\nexport function createPopstateRestoreHandler(\n  deps: BrowserPopstateRestoreDeps,\n): (event: PopStateEvent) => void {\n  return (event) => {\n    deps.notifyAppRouterTransitionStart(window.location.href);\n    const navigate = deps.getNavigate();\n    const pendingNavigation = navigate?.(window.location.href, 0, \"traverse\") ?? Promise.resolve();\n    const popstateNavId = deps.getActiveNavigationId();\n\n    deps.setPendingNavigation(pendingNavigation);\n    const shouldRestoreSavedScroll = hasSavedScrollPosition(event.state);\n    if (shouldRestoreSavedScroll) {\n      scheduleAfterFrame(() => {\n        if (deps.isCurrentNavigation(popstateNavId)) {\n          deps.restorePopstateScrollPosition(event.state, {\n            shouldContinue: () => deps.isCurrentNavigation(popstateNavId),\n          });\n        }\n      });\n    }\n\n    void pendingNavigation.finally(() => {\n      if (deps.isCurrentNavigation(popstateNavId) && !shouldRestoreSavedScroll) {\n        deps.restorePopstateScrollPosition(event.state);\n      }\n\n      if (deps.getPendingNavigation() === pendingNavigation) {\n        deps.setPendingNavigation(null);\n      }\n    });\n  };\n}\n"],"mappings":";AAsBA,SAAS,uBAAuB,OAAyB;CACvD,OAAO,QAAQ,SAAS,OAAO,UAAU,YAAY,sBAAsB,MAAM;;AAGnF,SAAS,mBAAmB,UAA4B;CACtD,IAAI,OAAO,WAAW,eAAe,OAAO,OAAO,0BAA0B,YAAY;EACvF,OAAO,sBAAsB,SAAS;EACtC;;CAGF,eAAe,SAAS;;AAG1B,SAAgB,6BACd,MACgC;CAChC,QAAQ,UAAU;EAChB,KAAK,+BAA+B,OAAO,SAAS,KAAK;EAEzD,MAAM,oBADW,KAAK,aACY,GAAG,OAAO,SAAS,MAAM,GAAG,WAAW,IAAI,QAAQ,SAAS;EAC9F,MAAM,gBAAgB,KAAK,uBAAuB;EAElD,KAAK,qBAAqB,kBAAkB;EAC5C,MAAM,2BAA2B,uBAAuB,MAAM,MAAM;EACpE,IAAI,0BACF,yBAAyB;GACvB,IAAI,KAAK,oBAAoB,cAAc,EACzC,KAAK,8BAA8B,MAAM,OAAO,EAC9C,sBAAsB,KAAK,oBAAoB,cAAc,EAC9D,CAAC;IAEJ;EAGJ,kBAAuB,cAAc;GACnC,IAAI,KAAK,oBAAoB,cAAc,IAAI,CAAC,0BAC9C,KAAK,8BAA8B,MAAM,MAAM;GAGjD,IAAI,KAAK,sBAAsB,KAAK,mBAClC,KAAK,qBAAqB,KAAK;IAEjC"}

package/dist/server/app-browser-state.js

@@ -1,6 +1,6 @@
 import { normalizePathnameForRouteMatch } from "../routing/utils.js";
 import { stripBasePath } from "../utils/base-path.js";
-import { RSC_ACTION_HEADER, VINEXT_INTERCEPTION_CONTEXT_HEADER, VINEXT_MOUNTED_SLOTS_HEADER } from "./headers.js";
+import { NEXT_ACTION_HEADER, RSC_ACTION_HEADER, VINEXT_INTERCEPTION_CONTEXT_HEADER, VINEXT_MOUNTED_SLOTS_HEADER } from "./headers.js";
 import { normalizePath } from "./normalize-path.js";
 import { AppElementsWire } from "./app-elements-wire.js";
 import { getMountedSlotIds, getMountedSlotIdsHeader } from "./app-elements.js";
@@ -57,6 +57,7 @@ function resolveInterceptionContextFromPreviousNextUrl(previousNextUrl, basePath
 function resolveServerActionRequestState(options) {
 	const headers = createRscRequestHeaders();
 	headers.set(RSC_ACTION_HEADER, options.actionId);
+	headers.set(NEXT_ACTION_HEADER, options.actionId);
 	const interceptionContext = resolveInterceptionContextFromPreviousNextUrl(options.previousNextUrl, options.basePath);
 	if (interceptionContext !== null) headers.set(VINEXT_INTERCEPTION_CONTEXT_HEADER, interceptionContext);
 	const mountedSlotsHeader = getMountedSlotIdsHeader(options.elements);

package/dist/server/app-browser-state.js.map

@@ -1 +1 @@
-{"version":3,"file":"app-browser-state.js","names":["_exhaustive"],"sources":["../../src/server/app-browser-state.ts"],"sourcesContent":["import { stripBasePath } from \"../utils/base-path.js\";\nimport type { RouteManifest } from \"../routing/app-route-graph.js\";\nimport {\n  AppElementsWire,\n  getMountedSlotIds,\n  getMountedSlotIdsHeader,\n  type AppElements,\n  type AppElementsInterception,\n  type AppElementsSlotBinding,\n  type LayoutFlags,\n} from \"./app-elements.js\";\nimport { createRscRequestHeaders } from \"./app-rsc-cache-busting.js\";\nimport {\n  RSC_ACTION_HEADER,\n  VINEXT_INTERCEPTION_CONTEXT_HEADER,\n  VINEXT_MOUNTED_SLOTS_HEADER,\n} from \"./headers.js\";\nimport {\n  NavigationTraceReasonCodes,\n  createNavigationLifecycleTraceFields,\n  createNavigationTrace,\n  type NavigationTrace,\n  type NavigationTraceFields,\n} from \"./navigation-trace.js\";\nimport { createCacheEntryReuseProof, type CacheEntryReuseProof } from \"./cache-proof.js\";\nimport {\n  navigationPlanner,\n  type MountedParallelSlotSnapshotV0,\n  type NavigationDecisionV0,\n  type OperationLane,\n  type OperationToken,\n  type RouteSnapshotV0,\n} from \"./navigation-planner.js\";\nimport type { ClientNavigationRenderSnapshot } from \"vinext/shims/navigation\";\nimport { normalizePathnameForRouteMatch } from \"../routing/utils.js\";\nimport { normalizePath } from \"./normalize-path.js\";\nexport {\n  createHistoryStateWithNavigationMetadata,\n  createHistoryStateWithPreviousNextUrl,\n  readHistoryStatePreviousNextUrl,\n  readHistoryStateTraversalIndex,\n  resolveHistoryTraversalIntent,\n  type HistoryTraversalIntent,\n} from \"./app-history-state.js\";\n\nexport type { OperationLane } from \"./navigation-planner.js\";\n\ntype OperationRecordBase = {\n  id: number;\n  lane: OperationLane;\n  startedVisibleCommitVersion: number;\n};\n\nexport type PendingOperationRecord = OperationRecordBase & {\n  state: \"pending\";\n};\n\nexport type CommittedOperationRecord = OperationRecordBase & {\n  state: \"committed\";\n  visibleCommitVersion: number;\n};\n\nexport type OperationRecord = PendingOperationRecord | CommittedOperationRecord;\n\nexport type AppRouterState = {\n  activeOperation: OperationRecord | null;\n  elements: AppElements;\n  interception: AppElementsInterception | null;\n  interceptionContext: string | null;\n  layoutFlags: LayoutFlags;\n  layoutIds: readonly string[];\n  previousNextUrl: string | null;\n  renderId: number;\n  navigationSnapshot: ClientNavigationRenderSnapshot;\n  rootLayoutTreePath: string | null;\n  routeId: string;\n  slotBindings: readonly AppElementsSlotBinding[];\n  visibleCommitVersion: number;\n};\n\nexport type AppRouterAction = {\n  cacheEntryReuseProof?: CacheEntryReuseProof;\n  elements: AppElements;\n  interception: AppElementsInterception | null;\n  interceptionContext: string | null;\n  layoutFlags: LayoutFlags;\n  layoutIds: readonly string[];\n  navigationSnapshot: ClientNavigationRenderSnapshot;\n  operation: PendingOperationRecord;\n  previousNextUrl: string | null;\n  renderId: number;\n  rootLayoutTreePath: string | null;\n  routeId: string;\n  slotBindings: readonly AppElementsSlotBinding[];\n  type: \"navigate\" | \"replace\" | \"traverse\";\n};\n\nexport type PendingNavigationCommit = {\n  action: AppRouterAction;\n  cacheEntryReuseProof?: CacheEntryReuseProof;\n  interception: AppElementsInterception | null;\n  interceptionContext: string | null;\n  previousNextUrl: string | null;\n  rootLayoutTreePath: string | null;\n  routeId: string;\n};\n\nexport type AppNavigationPayloadOrigin = Readonly<\n  { origin: \"fresh\" } | { origin: \"visited-cache\" }\n>;\n\nexport const FRESH_APP_NAVIGATION_PAYLOAD_ORIGIN: AppNavigationPayloadOrigin = {\n  origin: \"fresh\",\n};\nexport const VISITED_CACHE_APP_NAVIGATION_PAYLOAD_ORIGIN: AppNavigationPayloadOrigin = {\n  origin: \"visited-cache\",\n};\n\ntype PendingNavigationCommitDisposition = \"dispatch\" | \"hard-navigate\" | \"skip\";\ntype CacheRestorableAppPayloadMetadata = Readonly<{\n  cacheEntryReuseProof?: CacheEntryReuseProof;\n}>;\ntype DispatchPendingNavigationCommitDispositionDecision = {\n  disposition: \"dispatch\";\n  preserveAbsentSlots: boolean;\n  preserveElementIds: readonly string[];\n  preservePreviousSlotIds: readonly string[];\n  trace: NavigationTrace;\n};\ntype NonDispatchPendingNavigationCommitDispositionDecision = {\n  disposition: Exclude<PendingNavigationCommitDisposition, \"dispatch\">;\n  preserveElementIds: readonly [];\n  trace: NavigationTrace;\n};\ntype PendingNavigationCommitDispositionDecision =\n  | DispatchPendingNavigationCommitDispositionDecision\n  | NonDispatchPendingNavigationCommitDispositionDecision;\nfunction createOperationRecord(options: {\n  id: number;\n  lane: OperationLane;\n  startedVisibleCommitVersion: number;\n}): PendingOperationRecord {\n  return {\n    id: options.id,\n    lane: options.lane,\n    startedVisibleCommitVersion: options.startedVisibleCommitVersion,\n    state: \"pending\",\n  };\n}\n\nexport function isCacheRestorableAppPayloadMetadata(\n  metadata: CacheRestorableAppPayloadMetadata,\n): metadata is CacheRestorableAppPayloadMetadata & { cacheEntryReuseProof: CacheEntryReuseProof } {\n  return metadata.cacheEntryReuseProof !== undefined;\n}\n\nfunction requiresCacheEntryReuseProof(origin: AppNavigationPayloadOrigin): boolean {\n  switch (origin.origin) {\n    case \"fresh\":\n      return false;\n    case \"visited-cache\":\n      return true;\n    default: {\n      const _exhaustive: never = origin;\n      throw new Error(\"[vinext] Unknown App Router payload origin: \" + String(_exhaustive));\n    }\n  }\n}\n\nfunction normalizeNavigationSnapshotMatchedUrl(pathname: string): string {\n  return normalizePath(normalizePathnameForRouteMatch(pathname));\n}\n\nfunction createRouteSnapshotRouteId(options: {\n  interception: AppElementsInterception | null;\n  routeId: string;\n}): string {\n  if (options.interception !== null) return options.routeId;\n\n  const parsed = AppElementsWire.parseElementKey(options.routeId);\n  if (parsed?.kind !== \"route\" || parsed.interceptionContext === null) {\n    return options.routeId;\n  }\n\n  // A context suffix keeps AppElements render keys partitioned, but without\n  // explicit interception proof it is not semantic route authority.\n  return AppElementsWire.encodeRouteId(parsed.path, null);\n}\n\nexport function resolveInterceptionContextFromPreviousNextUrl(\n  previousNextUrl: string | null,\n  basePath: string = \"\",\n): string | null {\n  if (previousNextUrl === null) {\n    return null;\n  }\n\n  const parsedUrl = new URL(previousNextUrl, \"http://localhost\");\n  return stripBasePath(parsedUrl.pathname, basePath);\n}\n\ntype ResolveServerActionRequestStateOptions = {\n  actionId: string;\n  basePath: string;\n  elements: AppElements;\n  previousNextUrl: string | null;\n};\n\ntype ResolveServerActionRequestStateResult = {\n  headers: Headers;\n};\n\n/**\n * Pure: builds the fetch Headers for a server-action POST. Carries the same\n * interception-context and mounted-slots headers the refresh path already\n * sends, so the server-action re-render can rebuild the intercepted tree\n * instead of replacing it with the direct route.\n *\n * Next.js sends `Next-URL: state.previousNextUrl || state.nextUrl` on action\n * POSTs when `hasInterceptionRouteInCurrentTree(state.tree)`. Vinext's\n * X-Vinext-Interception-Context is the equivalent signal for the server-side\n * `findIntercept` lookup.\n */\nexport function resolveServerActionRequestState(\n  options: ResolveServerActionRequestStateOptions,\n): ResolveServerActionRequestStateResult {\n  const headers = createRscRequestHeaders();\n  headers.set(RSC_ACTION_HEADER, options.actionId);\n\n  const interceptionContext = resolveInterceptionContextFromPreviousNextUrl(\n    options.previousNextUrl,\n    options.basePath,\n  );\n  if (interceptionContext !== null) {\n    headers.set(VINEXT_INTERCEPTION_CONTEXT_HEADER, interceptionContext);\n  }\n\n  const mountedSlotsHeader = getMountedSlotIdsHeader(options.elements);\n  if (mountedSlotsHeader !== null) {\n    headers.set(VINEXT_MOUNTED_SLOTS_HEADER, mountedSlotsHeader);\n  }\n\n  return { headers };\n}\n\nexport function resolvePendingNavigationCommitDispositionDecision(options: {\n  activeNavigationId: number;\n  currentState: AppRouterState;\n  pending: PendingNavigationCommit;\n  routeManifest?: RouteManifest | null;\n  startedNavigationId: number;\n  targetHref?: string;\n}): PendingNavigationCommitDispositionDecision {\n  const traceFields = createPendingNavigationTraceFields(options);\n\n  if (\n    options.startedNavigationId !== options.activeNavigationId ||\n    options.pending.action.operation.startedVisibleCommitVersion !==\n      options.currentState.visibleCommitVersion\n  ) {\n    return {\n      disposition: \"skip\",\n      preserveElementIds: [],\n      trace: createNavigationTrace(NavigationTraceReasonCodes.staleOperation, traceFields),\n    };\n  }\n\n  return mapNavigationDecisionToPendingDisposition(\n    planPendingRootBoundaryFlightResponse({\n      currentState: options.currentState,\n      pending: options.pending,\n      routeManifest: options.routeManifest ?? null,\n      targetHref: options.targetHref,\n      traceFields,\n    }),\n  );\n}\n\nfunction createPendingNavigationTraceFields(options: {\n  activeNavigationId: number;\n  currentState: AppRouterState;\n  pending: PendingNavigationCommit;\n  startedNavigationId: number;\n  targetHref?: string;\n}): NavigationTraceFields {\n  return {\n    ...createNavigationLifecycleTraceFields({\n      activeNavigationId: options.activeNavigationId,\n      currentRootLayoutTreePath: options.currentState.rootLayoutTreePath,\n      currentVisibleCommitVersion: options.currentState.visibleCommitVersion,\n      nextRootLayoutTreePath: options.pending.rootLayoutTreePath,\n      startedNavigationId: options.startedNavigationId,\n      startedVisibleCommitVersion: options.pending.action.operation.startedVisibleCommitVersion,\n    }),\n    ...(options.targetHref !== undefined ? { targetHref: options.targetHref } : {}),\n  };\n}\n\nfunction createNavigationSnapshotUrl(snapshot: ClientNavigationRenderSnapshot): string {\n  const query = snapshot.searchParams.toString();\n  return query === \"\" ? snapshot.pathname : `${snapshot.pathname}?${query}`;\n}\n\nfunction createMountedParallelSlotSnapshots(\n  elements: AppElements,\n): readonly MountedParallelSlotSnapshotV0[] {\n  const snapshots: MountedParallelSlotSnapshotV0[] = [];\n  for (const slotId of getMountedSlotIds(elements)) {\n    const parsed = AppElementsWire.parseElementKey(slotId);\n    if (parsed?.kind !== \"slot\") continue;\n    snapshots.push({\n      ownerLayoutId: AppElementsWire.encodeLayoutId(parsed.treePath),\n      slotId,\n    });\n  }\n  return snapshots;\n}\n\nfunction createVisibleRouteSnapshot(state: AppRouterState): RouteSnapshotV0 {\n  const displayUrl = createNavigationSnapshotUrl(state.navigationSnapshot);\n  const matchedUrl = normalizeNavigationSnapshotMatchedUrl(state.navigationSnapshot.pathname);\n  return {\n    displayUrl,\n    interception: state.interception,\n    interceptionContext: state.interceptionContext,\n    layoutIds: state.layoutIds,\n    // `displayUrl` preserves the browser-visible URL for decisions and traces.\n    // `matchedUrl` uses the route-state canonical pathname, matching the\n    // server's segment-decoded representation without changing user-facing\n    // navigation state such as usePathname().\n    matchedUrl,\n    mountedParallelSlots: createMountedParallelSlotSnapshots(state.elements),\n    rootBoundaryId: state.rootLayoutTreePath,\n    routeId: createRouteSnapshotRouteId({\n      interception: state.interception,\n      routeId: state.routeId,\n    }),\n    slotBindings: state.slotBindings,\n  };\n}\n\nfunction createPendingRouteSnapshot(pending: PendingNavigationCommit): RouteSnapshotV0 {\n  const displayUrl = createNavigationSnapshotUrl(pending.action.navigationSnapshot);\n  const matchedUrl = normalizeNavigationSnapshotMatchedUrl(\n    pending.action.navigationSnapshot.pathname,\n  );\n  return {\n    displayUrl,\n    interception: pending.action.interception,\n    interceptionContext: pending.action.interceptionContext,\n    layoutIds: pending.action.layoutIds,\n    // See createVisibleRouteSnapshot: matchedUrl intentionally models the route\n    // identity, not the address bar URL.\n    matchedUrl,\n    mountedParallelSlots: createMountedParallelSlotSnapshots(pending.action.elements),\n    rootBoundaryId: pending.rootLayoutTreePath,\n    routeId: createRouteSnapshotRouteId({\n      interception: pending.action.interception,\n      routeId: pending.routeId,\n    }),\n    slotBindings: pending.action.slotBindings,\n  };\n}\n\nfunction createPendingNavigationOperationToken(options: {\n  pending: PendingNavigationCommit;\n  routeManifest: RouteManifest | null;\n  targetSnapshot: RouteSnapshotV0;\n}): OperationToken {\n  return {\n    baseVisibleCommitVersion: options.pending.action.operation.startedVisibleCommitVersion,\n    deploymentVersion: null,\n    graphVersion: options.routeManifest?.graphVersion ?? null,\n    lane: options.pending.action.operation.lane,\n    operationId: options.pending.action.operation.id,\n    targetSnapshotFingerprint: createRootBoundarySnapshotFingerprint(options.targetSnapshot),\n  };\n}\n\nfunction createRootBoundarySnapshotFingerprint(snapshot: RouteSnapshotV0): string {\n  return `${snapshot.routeId}|root:${snapshot.rootBoundaryId ?? \"unknown\"}`;\n}\n\nfunction planPendingRootBoundaryFlightResponse(options: {\n  currentState: AppRouterState;\n  pending: PendingNavigationCommit;\n  routeManifest: RouteManifest | null;\n  targetHref?: string;\n  traceFields: NavigationTraceFields;\n}): NavigationDecisionV0 {\n  const targetSnapshot = createPendingRouteSnapshot(options.pending);\n  const token = createPendingNavigationOperationToken({\n    pending: options.pending,\n    routeManifest: options.routeManifest,\n    targetSnapshot,\n  });\n  const cacheEntryReuseProof = options.pending.cacheEntryReuseProof;\n\n  // #726-CORE-07/08 keeps the browser state layer as the lifecycle gate and\n  // only translates committed AppElements metadata into planner snapshots.\n  // RouteManifest now supplies graph-owned route topology while snapshots\n  // continue to carry runtime state such as visible slot content.\n  return navigationPlanner.plan({\n    routeManifest: options.routeManifest,\n    state: {\n      nextOperationToken: token,\n      traceFields: options.traceFields,\n      visibleCommitVersion: options.currentState.visibleCommitVersion,\n      visibleSnapshot: createVisibleRouteSnapshot(options.currentState),\n    },\n    event: {\n      kind: \"flightResponseArrived\",\n      result: {\n        ...(cacheEntryReuseProof ? { cacheEntryReuseProof } : {}),\n        // Approval call sites must pass the executor's targetHref so the\n        // planner trace and future hard-nav executor agree with the browser\n        // URL. The fallback remains for lower-level tests and direct disposition\n        // callers that exercise only snapshot-derived planner semantics.\n        href: options.targetHref ?? targetSnapshot.displayUrl,\n        targetSnapshot,\n      },\n      token,\n    },\n  });\n}\n\nfunction mapNavigationDecisionToPendingDisposition(\n  decision: NavigationDecisionV0,\n): PendingNavigationCommitDispositionDecision {\n  switch (decision.kind) {\n    case \"proposeCommit\":\n      return {\n        disposition: \"dispatch\",\n        preserveAbsentSlots: decision.proposal.preserveAbsentSlots,\n        preserveElementIds: decision.proposal.preserveElementIds,\n        preservePreviousSlotIds: decision.proposal.preservePreviousSlotIds,\n        trace: decision.trace,\n      };\n    case \"hardNavigate\":\n      return { disposition: \"hard-navigate\", preserveElementIds: [], trace: decision.trace };\n    case \"noCommit\":\n      return { disposition: \"skip\", preserveElementIds: [], trace: decision.trace };\n    case \"requestWork\":\n      throw new Error(\n        `[vinext] Root-boundary commit planning returned requestWork (${decision.work.kind}); flightResponseArrived should never request work`,\n      );\n    default: {\n      const _exhaustive: never = decision;\n      throw new Error(\"[vinext] Unknown navigation decision: \" + String(_exhaustive));\n    }\n  }\n}\n\nexport async function createPendingNavigationCommit(options: {\n  currentState: AppRouterState;\n  nextElements: Promise<AppElements>;\n  navigationSnapshot: ClientNavigationRenderSnapshot;\n  operationLane: OperationLane;\n  payloadOrigin: AppNavigationPayloadOrigin;\n  // Advisory: non-intercepted responses clear this even when callers pass the\n  // current visible previousNextUrl.\n  previousNextUrl?: string | null;\n  renderId: number;\n  type: \"navigate\" | \"replace\" | \"traverse\";\n}): Promise<PendingNavigationCommit> {\n  const elements = await options.nextElements;\n  const metadata = AppElementsWire.readMetadata(elements);\n  const cacheEntryReuseProof =\n    metadata.cacheEntryReuseProof ??\n    (requiresCacheEntryReuseProof(options.payloadOrigin)\n      ? createCacheEntryReuseProof(null)\n      : undefined);\n  const requestedPreviousNextUrl =\n    options.previousNextUrl !== undefined\n      ? options.previousNextUrl\n      : options.currentState.previousNextUrl;\n  const previousNextUrl = metadata.interception === null ? null : requestedPreviousNextUrl;\n\n  return {\n    action: {\n      ...(cacheEntryReuseProof ? { cacheEntryReuseProof } : {}),\n      elements,\n      interception: metadata.interception,\n      interceptionContext: metadata.interceptionContext,\n      layoutIds: metadata.layoutIds,\n      layoutFlags: metadata.layoutFlags,\n      slotBindings: metadata.slotBindings,\n      navigationSnapshot: options.navigationSnapshot,\n      operation: createOperationRecord({\n        id: options.renderId,\n        lane: options.operationLane,\n        startedVisibleCommitVersion: options.currentState.visibleCommitVersion,\n      }),\n      previousNextUrl,\n      renderId: options.renderId,\n      rootLayoutTreePath: metadata.rootLayoutTreePath,\n      routeId: metadata.routeId,\n      type: options.type,\n    },\n    // Convenience aliases — always equal their action.* counterparts.\n    ...(cacheEntryReuseProof ? { cacheEntryReuseProof } : {}),\n    interception: metadata.interception,\n    interceptionContext: metadata.interceptionContext,\n    previousNextUrl,\n    rootLayoutTreePath: metadata.rootLayoutTreePath,\n    routeId: metadata.routeId,\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"app-browser-state.js","names":["_exhaustive"],"sources":["../../src/server/app-browser-state.ts"],"sourcesContent":["import { stripBasePath } from \"../utils/base-path.js\";\nimport type { RouteManifest } from \"../routing/app-route-graph.js\";\nimport {\n  AppElementsWire,\n  getMountedSlotIds,\n  getMountedSlotIdsHeader,\n  type AppElements,\n  type AppElementsInterception,\n  type AppElementsSlotBinding,\n  type LayoutFlags,\n} from \"./app-elements.js\";\nimport { createRscRequestHeaders } from \"./app-rsc-cache-busting.js\";\nimport {\n  NEXT_ACTION_HEADER,\n  RSC_ACTION_HEADER,\n  VINEXT_INTERCEPTION_CONTEXT_HEADER,\n  VINEXT_MOUNTED_SLOTS_HEADER,\n} from \"./headers.js\";\nimport {\n  NavigationTraceReasonCodes,\n  createNavigationLifecycleTraceFields,\n  createNavigationTrace,\n  type NavigationTrace,\n  type NavigationTraceFields,\n} from \"./navigation-trace.js\";\nimport { createCacheEntryReuseProof, type CacheEntryReuseProof } from \"./cache-proof.js\";\nimport {\n  navigationPlanner,\n  type MountedParallelSlotSnapshotV0,\n  type NavigationDecisionV0,\n  type OperationLane,\n  type OperationToken,\n  type RouteSnapshotV0,\n} from \"./navigation-planner.js\";\nimport type { ClientNavigationRenderSnapshot } from \"vinext/shims/navigation\";\nimport { normalizePathnameForRouteMatch } from \"../routing/utils.js\";\nimport { normalizePath } from \"./normalize-path.js\";\nexport {\n  createHistoryStateWithNavigationMetadata,\n  createHistoryStateWithPreviousNextUrl,\n  readHistoryStatePreviousNextUrl,\n  readHistoryStateTraversalIndex,\n  resolveHistoryTraversalIntent,\n  type HistoryTraversalIntent,\n} from \"./app-history-state.js\";\n\nexport type { OperationLane } from \"./navigation-planner.js\";\n\ntype OperationRecordBase = {\n  id: number;\n  lane: OperationLane;\n  startedVisibleCommitVersion: number;\n};\n\nexport type PendingOperationRecord = OperationRecordBase & {\n  state: \"pending\";\n};\n\nexport type CommittedOperationRecord = OperationRecordBase & {\n  state: \"committed\";\n  visibleCommitVersion: number;\n};\n\nexport type OperationRecord = PendingOperationRecord | CommittedOperationRecord;\n\nexport type AppRouterState = {\n  activeOperation: OperationRecord | null;\n  elements: AppElements;\n  interception: AppElementsInterception | null;\n  interceptionContext: string | null;\n  layoutFlags: LayoutFlags;\n  layoutIds: readonly string[];\n  previousNextUrl: string | null;\n  renderId: number;\n  navigationSnapshot: ClientNavigationRenderSnapshot;\n  rootLayoutTreePath: string | null;\n  routeId: string;\n  slotBindings: readonly AppElementsSlotBinding[];\n  visibleCommitVersion: number;\n};\n\nexport type AppRouterAction = {\n  cacheEntryReuseProof?: CacheEntryReuseProof;\n  elements: AppElements;\n  interception: AppElementsInterception | null;\n  interceptionContext: string | null;\n  layoutFlags: LayoutFlags;\n  layoutIds: readonly string[];\n  navigationSnapshot: ClientNavigationRenderSnapshot;\n  operation: PendingOperationRecord;\n  previousNextUrl: string | null;\n  renderId: number;\n  rootLayoutTreePath: string | null;\n  routeId: string;\n  slotBindings: readonly AppElementsSlotBinding[];\n  type: \"navigate\" | \"replace\" | \"traverse\";\n};\n\nexport type PendingNavigationCommit = {\n  action: AppRouterAction;\n  cacheEntryReuseProof?: CacheEntryReuseProof;\n  interception: AppElementsInterception | null;\n  interceptionContext: string | null;\n  previousNextUrl: string | null;\n  rootLayoutTreePath: string | null;\n  routeId: string;\n};\n\nexport type AppNavigationPayloadOrigin = Readonly<\n  { origin: \"fresh\" } | { origin: \"visited-cache\" }\n>;\n\nexport const FRESH_APP_NAVIGATION_PAYLOAD_ORIGIN: AppNavigationPayloadOrigin = {\n  origin: \"fresh\",\n};\nexport const VISITED_CACHE_APP_NAVIGATION_PAYLOAD_ORIGIN: AppNavigationPayloadOrigin = {\n  origin: \"visited-cache\",\n};\n\ntype PendingNavigationCommitDisposition = \"dispatch\" | \"hard-navigate\" | \"skip\";\ntype CacheRestorableAppPayloadMetadata = Readonly<{\n  cacheEntryReuseProof?: CacheEntryReuseProof;\n}>;\ntype DispatchPendingNavigationCommitDispositionDecision = {\n  disposition: \"dispatch\";\n  preserveAbsentSlots: boolean;\n  preserveElementIds: readonly string[];\n  preservePreviousSlotIds: readonly string[];\n  trace: NavigationTrace;\n};\ntype NonDispatchPendingNavigationCommitDispositionDecision = {\n  disposition: Exclude<PendingNavigationCommitDisposition, \"dispatch\">;\n  preserveElementIds: readonly [];\n  trace: NavigationTrace;\n};\ntype PendingNavigationCommitDispositionDecision =\n  | DispatchPendingNavigationCommitDispositionDecision\n  | NonDispatchPendingNavigationCommitDispositionDecision;\nfunction createOperationRecord(options: {\n  id: number;\n  lane: OperationLane;\n  startedVisibleCommitVersion: number;\n}): PendingOperationRecord {\n  return {\n    id: options.id,\n    lane: options.lane,\n    startedVisibleCommitVersion: options.startedVisibleCommitVersion,\n    state: \"pending\",\n  };\n}\n\nexport function isCacheRestorableAppPayloadMetadata(\n  metadata: CacheRestorableAppPayloadMetadata,\n): metadata is CacheRestorableAppPayloadMetadata & { cacheEntryReuseProof: CacheEntryReuseProof } {\n  return metadata.cacheEntryReuseProof !== undefined;\n}\n\nfunction requiresCacheEntryReuseProof(origin: AppNavigationPayloadOrigin): boolean {\n  switch (origin.origin) {\n    case \"fresh\":\n      return false;\n    case \"visited-cache\":\n      return true;\n    default: {\n      const _exhaustive: never = origin;\n      throw new Error(\"[vinext] Unknown App Router payload origin: \" + String(_exhaustive));\n    }\n  }\n}\n\nfunction normalizeNavigationSnapshotMatchedUrl(pathname: string): string {\n  return normalizePath(normalizePathnameForRouteMatch(pathname));\n}\n\nfunction createRouteSnapshotRouteId(options: {\n  interception: AppElementsInterception | null;\n  routeId: string;\n}): string {\n  if (options.interception !== null) return options.routeId;\n\n  const parsed = AppElementsWire.parseElementKey(options.routeId);\n  if (parsed?.kind !== \"route\" || parsed.interceptionContext === null) {\n    return options.routeId;\n  }\n\n  // A context suffix keeps AppElements render keys partitioned, but without\n  // explicit interception proof it is not semantic route authority.\n  return AppElementsWire.encodeRouteId(parsed.path, null);\n}\n\nexport function resolveInterceptionContextFromPreviousNextUrl(\n  previousNextUrl: string | null,\n  basePath: string = \"\",\n): string | null {\n  if (previousNextUrl === null) {\n    return null;\n  }\n\n  const parsedUrl = new URL(previousNextUrl, \"http://localhost\");\n  return stripBasePath(parsedUrl.pathname, basePath);\n}\n\ntype ResolveServerActionRequestStateOptions = {\n  actionId: string;\n  basePath: string;\n  elements: AppElements;\n  previousNextUrl: string | null;\n};\n\ntype ResolveServerActionRequestStateResult = {\n  headers: Headers;\n};\n\n/**\n * Pure: builds the fetch Headers for a server-action POST. Carries the same\n * interception-context and mounted-slots headers the refresh path already\n * sends, so the server-action re-render can rebuild the intercepted tree\n * instead of replacing it with the direct route.\n *\n * Next.js sends `Next-URL: state.previousNextUrl || state.nextUrl` on action\n * POSTs when `hasInterceptionRouteInCurrentTree(state.tree)`. Vinext's\n * X-Vinext-Interception-Context is the equivalent signal for the server-side\n * `findIntercept` lookup.\n */\nexport function resolveServerActionRequestState(\n  options: ResolveServerActionRequestStateOptions,\n): ResolveServerActionRequestStateResult {\n  const headers = createRscRequestHeaders();\n  headers.set(RSC_ACTION_HEADER, options.actionId);\n  headers.set(NEXT_ACTION_HEADER, options.actionId);\n\n  const interceptionContext = resolveInterceptionContextFromPreviousNextUrl(\n    options.previousNextUrl,\n    options.basePath,\n  );\n  if (interceptionContext !== null) {\n    headers.set(VINEXT_INTERCEPTION_CONTEXT_HEADER, interceptionContext);\n  }\n\n  const mountedSlotsHeader = getMountedSlotIdsHeader(options.elements);\n  if (mountedSlotsHeader !== null) {\n    headers.set(VINEXT_MOUNTED_SLOTS_HEADER, mountedSlotsHeader);\n  }\n\n  return { headers };\n}\n\nexport function resolvePendingNavigationCommitDispositionDecision(options: {\n  activeNavigationId: number;\n  currentState: AppRouterState;\n  pending: PendingNavigationCommit;\n  routeManifest?: RouteManifest | null;\n  startedNavigationId: number;\n  targetHref?: string;\n}): PendingNavigationCommitDispositionDecision {\n  const traceFields = createPendingNavigationTraceFields(options);\n\n  if (\n    options.startedNavigationId !== options.activeNavigationId ||\n    options.pending.action.operation.startedVisibleCommitVersion !==\n      options.currentState.visibleCommitVersion\n  ) {\n    return {\n      disposition: \"skip\",\n      preserveElementIds: [],\n      trace: createNavigationTrace(NavigationTraceReasonCodes.staleOperation, traceFields),\n    };\n  }\n\n  return mapNavigationDecisionToPendingDisposition(\n    planPendingRootBoundaryFlightResponse({\n      currentState: options.currentState,\n      pending: options.pending,\n      routeManifest: options.routeManifest ?? null,\n      targetHref: options.targetHref,\n      traceFields,\n    }),\n  );\n}\n\nfunction createPendingNavigationTraceFields(options: {\n  activeNavigationId: number;\n  currentState: AppRouterState;\n  pending: PendingNavigationCommit;\n  startedNavigationId: number;\n  targetHref?: string;\n}): NavigationTraceFields {\n  return {\n    ...createNavigationLifecycleTraceFields({\n      activeNavigationId: options.activeNavigationId,\n      currentRootLayoutTreePath: options.currentState.rootLayoutTreePath,\n      currentVisibleCommitVersion: options.currentState.visibleCommitVersion,\n      nextRootLayoutTreePath: options.pending.rootLayoutTreePath,\n      startedNavigationId: options.startedNavigationId,\n      startedVisibleCommitVersion: options.pending.action.operation.startedVisibleCommitVersion,\n    }),\n    ...(options.targetHref !== undefined ? { targetHref: options.targetHref } : {}),\n  };\n}\n\nfunction createNavigationSnapshotUrl(snapshot: ClientNavigationRenderSnapshot): string {\n  const query = snapshot.searchParams.toString();\n  return query === \"\" ? snapshot.pathname : `${snapshot.pathname}?${query}`;\n}\n\nfunction createMountedParallelSlotSnapshots(\n  elements: AppElements,\n): readonly MountedParallelSlotSnapshotV0[] {\n  const snapshots: MountedParallelSlotSnapshotV0[] = [];\n  for (const slotId of getMountedSlotIds(elements)) {\n    const parsed = AppElementsWire.parseElementKey(slotId);\n    if (parsed?.kind !== \"slot\") continue;\n    snapshots.push({\n      ownerLayoutId: AppElementsWire.encodeLayoutId(parsed.treePath),\n      slotId,\n    });\n  }\n  return snapshots;\n}\n\nfunction createVisibleRouteSnapshot(state: AppRouterState): RouteSnapshotV0 {\n  const displayUrl = createNavigationSnapshotUrl(state.navigationSnapshot);\n  const matchedUrl = normalizeNavigationSnapshotMatchedUrl(state.navigationSnapshot.pathname);\n  return {\n    displayUrl,\n    interception: state.interception,\n    interceptionContext: state.interceptionContext,\n    layoutIds: state.layoutIds,\n    // `displayUrl` preserves the browser-visible URL for decisions and traces.\n    // `matchedUrl` uses the route-state canonical pathname, matching the\n    // server's segment-decoded representation without changing user-facing\n    // navigation state such as usePathname().\n    matchedUrl,\n    mountedParallelSlots: createMountedParallelSlotSnapshots(state.elements),\n    rootBoundaryId: state.rootLayoutTreePath,\n    routeId: createRouteSnapshotRouteId({\n      interception: state.interception,\n      routeId: state.routeId,\n    }),\n    slotBindings: state.slotBindings,\n  };\n}\n\nfunction createPendingRouteSnapshot(pending: PendingNavigationCommit): RouteSnapshotV0 {\n  const displayUrl = createNavigationSnapshotUrl(pending.action.navigationSnapshot);\n  const matchedUrl = normalizeNavigationSnapshotMatchedUrl(\n    pending.action.navigationSnapshot.pathname,\n  );\n  return {\n    displayUrl,\n    interception: pending.action.interception,\n    interceptionContext: pending.action.interceptionContext,\n    layoutIds: pending.action.layoutIds,\n    // See createVisibleRouteSnapshot: matchedUrl intentionally models the route\n    // identity, not the address bar URL.\n    matchedUrl,\n    mountedParallelSlots: createMountedParallelSlotSnapshots(pending.action.elements),\n    rootBoundaryId: pending.rootLayoutTreePath,\n    routeId: createRouteSnapshotRouteId({\n      interception: pending.action.interception,\n      routeId: pending.routeId,\n    }),\n    slotBindings: pending.action.slotBindings,\n  };\n}\n\nfunction createPendingNavigationOperationToken(options: {\n  pending: PendingNavigationCommit;\n  routeManifest: RouteManifest | null;\n  targetSnapshot: RouteSnapshotV0;\n}): OperationToken {\n  return {\n    baseVisibleCommitVersion: options.pending.action.operation.startedVisibleCommitVersion,\n    deploymentVersion: null,\n    graphVersion: options.routeManifest?.graphVersion ?? null,\n    lane: options.pending.action.operation.lane,\n    operationId: options.pending.action.operation.id,\n    targetSnapshotFingerprint: createRootBoundarySnapshotFingerprint(options.targetSnapshot),\n  };\n}\n\nfunction createRootBoundarySnapshotFingerprint(snapshot: RouteSnapshotV0): string {\n  return `${snapshot.routeId}|root:${snapshot.rootBoundaryId ?? \"unknown\"}`;\n}\n\nfunction planPendingRootBoundaryFlightResponse(options: {\n  currentState: AppRouterState;\n  pending: PendingNavigationCommit;\n  routeManifest: RouteManifest | null;\n  targetHref?: string;\n  traceFields: NavigationTraceFields;\n}): NavigationDecisionV0 {\n  const targetSnapshot = createPendingRouteSnapshot(options.pending);\n  const token = createPendingNavigationOperationToken({\n    pending: options.pending,\n    routeManifest: options.routeManifest,\n    targetSnapshot,\n  });\n  const cacheEntryReuseProof = options.pending.cacheEntryReuseProof;\n\n  // #726-CORE-07/08 keeps the browser state layer as the lifecycle gate and\n  // only translates committed AppElements metadata into planner snapshots.\n  // RouteManifest now supplies graph-owned route topology while snapshots\n  // continue to carry runtime state such as visible slot content.\n  return navigationPlanner.plan({\n    routeManifest: options.routeManifest,\n    state: {\n      nextOperationToken: token,\n      traceFields: options.traceFields,\n      visibleCommitVersion: options.currentState.visibleCommitVersion,\n      visibleSnapshot: createVisibleRouteSnapshot(options.currentState),\n    },\n    event: {\n      kind: \"flightResponseArrived\",\n      result: {\n        ...(cacheEntryReuseProof ? { cacheEntryReuseProof } : {}),\n        // Approval call sites must pass the executor's targetHref so the\n        // planner trace and future hard-nav executor agree with the browser\n        // URL. The fallback remains for lower-level tests and direct disposition\n        // callers that exercise only snapshot-derived planner semantics.\n        href: options.targetHref ?? targetSnapshot.displayUrl,\n        targetSnapshot,\n      },\n      token,\n    },\n  });\n}\n\nfunction mapNavigationDecisionToPendingDisposition(\n  decision: NavigationDecisionV0,\n): PendingNavigationCommitDispositionDecision {\n  switch (decision.kind) {\n    case \"proposeCommit\":\n      return {\n        disposition: \"dispatch\",\n        preserveAbsentSlots: decision.proposal.preserveAbsentSlots,\n        preserveElementIds: decision.proposal.preserveElementIds,\n        preservePreviousSlotIds: decision.proposal.preservePreviousSlotIds,\n        trace: decision.trace,\n      };\n    case \"hardNavigate\":\n      return { disposition: \"hard-navigate\", preserveElementIds: [], trace: decision.trace };\n    case \"noCommit\":\n      return { disposition: \"skip\", preserveElementIds: [], trace: decision.trace };\n    case \"requestWork\":\n      throw new Error(\n        `[vinext] Root-boundary commit planning returned requestWork (${decision.work.kind}); flightResponseArrived should never request work`,\n      );\n    default: {\n      const _exhaustive: never = decision;\n      throw new Error(\"[vinext] Unknown navigation decision: \" + String(_exhaustive));\n    }\n  }\n}\n\nexport async function createPendingNavigationCommit(options: {\n  currentState: AppRouterState;\n  nextElements: Promise<AppElements>;\n  navigationSnapshot: ClientNavigationRenderSnapshot;\n  operationLane: OperationLane;\n  payloadOrigin: AppNavigationPayloadOrigin;\n  // Advisory: non-intercepted responses clear this even when callers pass the\n  // current visible previousNextUrl.\n  previousNextUrl?: string | null;\n  renderId: number;\n  type: \"navigate\" | \"replace\" | \"traverse\";\n}): Promise<PendingNavigationCommit> {\n  const elements = await options.nextElements;\n  const metadata = AppElementsWire.readMetadata(elements);\n  const cacheEntryReuseProof =\n    metadata.cacheEntryReuseProof ??\n    (requiresCacheEntryReuseProof(options.payloadOrigin)\n      ? createCacheEntryReuseProof(null)\n      : undefined);\n  const requestedPreviousNextUrl =\n    options.previousNextUrl !== undefined\n      ? options.previousNextUrl\n      : options.currentState.previousNextUrl;\n  const previousNextUrl = metadata.interception === null ? null : requestedPreviousNextUrl;\n\n  return {\n    action: {\n      ...(cacheEntryReuseProof ? { cacheEntryReuseProof } : {}),\n      elements,\n      interception: metadata.interception,\n      interceptionContext: metadata.interceptionContext,\n      layoutIds: metadata.layoutIds,\n      layoutFlags: metadata.layoutFlags,\n      slotBindings: metadata.slotBindings,\n      navigationSnapshot: options.navigationSnapshot,\n      operation: createOperationRecord({\n        id: options.renderId,\n        lane: options.operationLane,\n        startedVisibleCommitVersion: options.currentState.visibleCommitVersion,\n      }),\n      previousNextUrl,\n      renderId: options.renderId,\n      rootLayoutTreePath: metadata.rootLayoutTreePath,\n      routeId: metadata.routeId,\n      type: options.type,\n    },\n    // Convenience aliases — always equal their action.* counterparts.\n    ...(cacheEntryReuseProof ? { cacheEntryReuseProof } : {}),\n    interception: metadata.interception,\n    interceptionContext: metadata.interceptionContext,\n    previousNextUrl,\n    rootLayoutTreePath: metadata.rootLayoutTreePath,\n    routeId: metadata.routeId,\n  };\n}\n"],"mappings":"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"}

package/dist/server/app-layout-param-observation.d.ts

@@ -0,0 +1,30 @@
+import { RenderRequestApiKind } from "./cache-proof.js";
+import { UnstableCacheObservation } from "../shims/cache.js";
+import { ThenableParamsObserver } from "../shims/thenable-params.js";
+
+//#region src/server/app-layout-param-observation.d.ts
+type AppLayoutParamAccessObservation = Readonly<{
+  cacheLifeObserved: boolean;
+  cacheTags: readonly string[];
+  cacheableFetchCount: number;
+  completeness: "complete" | "unknown";
+  dynamicFetchCount: number;
+  finiteRevalidateSeconds: number | null;
+  keys: readonly string[];
+  observed: boolean;
+  paramScopeKeys: readonly string[];
+  requestApis: readonly RenderRequestApiKind[];
+  unstableCaches: readonly UnstableCacheObservation[];
+}>;
+type AppLayoutParamAccessTracker = Readonly<{
+  createThenableParamsObserver: (layoutId: string) => ThenableParamsObserver;
+  getLayoutObservation: (layoutId: string) => AppLayoutParamAccessObservation;
+  recordLayoutFiniteRevalidate: (layoutId: string, revalidateSeconds: number) => void;
+  recordLayoutParamScope: (layoutId: string, paramScopeKeys: readonly string[]) => void;
+  runLayoutProbe: (layoutId: string, probe: () => unknown) => unknown;
+}>;
+declare function isAppLayoutObservationUnsafeForStaticReuse(observation: AppLayoutParamAccessObservation): boolean;
+declare function createAppLayoutParamAccessTracker(): AppLayoutParamAccessTracker;
+//#endregion
+export { AppLayoutParamAccessObservation, AppLayoutParamAccessTracker, createAppLayoutParamAccessTracker, isAppLayoutObservationUnsafeForStaticReuse };
+//# sourceMappingURL=app-layout-param-observation.d.ts.map

package/dist/server/app-layout-param-observation.js

@@ -0,0 +1,130 @@
+import { isInsideUnifiedScope, runWithUnifiedStateMutation } from "../shims/unified-request-context.js";
+import { peekRenderRequestApiUsage } from "../shims/headers.js";
+import { _peekRequestScopedCacheLife, _peekUnstableCacheObservations } from "../shims/cache.js";
+import { getCollectedFetchTags, peekCacheableFetchObservations, peekDynamicFetchObservations } from "../shims/fetch-cache.js";
+//#region src/server/app-layout-param-observation.ts
+function isAppLayoutObservationUnsafeForStaticReuse(observation) {
+	return observation.completeness !== "complete" || observation.paramScopeKeys.length > 0 || observation.observed || observation.requestApis.length > 0 || observation.finiteRevalidateSeconds !== null || observation.cacheLifeObserved || observation.cacheTags.length > 0 || observation.cacheableFetchCount > 0 || observation.dynamicFetchCount > 0 || observation.unstableCaches.length > 0;
+}
+function isPromiseLike(value) {
+	return Boolean(value && (typeof value === "object" || typeof value === "function") && "then" in value && typeof value.then === "function");
+}
+function createAppLayoutParamAccessTracker() {
+	const observations = /* @__PURE__ */ new Map();
+	const ensureObservation = (layoutId) => {
+		const existing = observations.get(layoutId);
+		if (existing) return existing;
+		const created = {
+			cacheLifeObserved: false,
+			cacheTags: /* @__PURE__ */ new Set(),
+			cacheableFetches: /* @__PURE__ */ new Set(),
+			dynamicFetches: /* @__PURE__ */ new Set(),
+			finiteRevalidateSeconds: null,
+			keys: /* @__PURE__ */ new Set(),
+			observed: false,
+			paramScopeKeys: /* @__PURE__ */ new Set(),
+			probeComplete: false,
+			requestApis: /* @__PURE__ */ new Set(),
+			unstableCaches: /* @__PURE__ */ new Map()
+		};
+		observations.set(layoutId, created);
+		return created;
+	};
+	const markObserved = (layoutId, keys) => {
+		const observation = ensureObservation(layoutId);
+		observation.observed = true;
+		for (const key of keys) observation.keys.add(key);
+	};
+	const markProbeComplete = (layoutId) => {
+		ensureObservation(layoutId).probeComplete = true;
+	};
+	const runWithIsolatedProbeDependencies = (probe) => {
+		if (!isInsideUnifiedScope()) return probe();
+		return runWithUnifiedStateMutation((ctx) => {
+			ctx.cacheableFetchUrls = /* @__PURE__ */ new Set();
+			ctx.currentRequestTags = [];
+			ctx.currentFetchSoftTags = [];
+			ctx.dynamicFetchUrls = /* @__PURE__ */ new Set();
+			ctx.dynamicUsageDetected = false;
+			ctx.renderRequestApiUsage = /* @__PURE__ */ new Set();
+			ctx.requestScopedCacheLife = null;
+			ctx.unstableCacheObservations = /* @__PURE__ */ new Map();
+		}, probe);
+	};
+	const recordProbeDependencies = (layoutId) => {
+		const observation = ensureObservation(layoutId);
+		if (_peekRequestScopedCacheLife() !== null) observation.cacheLifeObserved = true;
+		for (const tag of getCollectedFetchTags()) observation.cacheTags.add(tag);
+		for (const url of peekCacheableFetchObservations()) observation.cacheableFetches.add(url);
+		for (const url of peekDynamicFetchObservations()) observation.dynamicFetches.add(url);
+		for (const requestApi of peekRenderRequestApiUsage()) observation.requestApis.add(requestApi);
+		for (const unstableCache of _peekUnstableCacheObservations()) observation.unstableCaches.set(unstableCache.keyHash, unstableCache);
+	};
+	return {
+		createThenableParamsObserver(layoutId) {
+			return { observeParamAccess(keys) {
+				markObserved(layoutId, keys);
+			} };
+		},
+		getLayoutObservation(layoutId) {
+			const observation = observations.get(layoutId);
+			if (!observation) return {
+				cacheLifeObserved: false,
+				cacheTags: [],
+				cacheableFetchCount: 0,
+				completeness: "unknown",
+				dynamicFetchCount: 0,
+				finiteRevalidateSeconds: null,
+				keys: [],
+				observed: false,
+				paramScopeKeys: [],
+				requestApis: [],
+				unstableCaches: []
+			};
+			return {
+				cacheLifeObserved: observation.cacheLifeObserved,
+				cacheTags: [...observation.cacheTags].sort(),
+				cacheableFetchCount: observation.cacheableFetches.size,
+				completeness: observation.probeComplete ? "complete" : "unknown",
+				dynamicFetchCount: observation.dynamicFetches.size,
+				finiteRevalidateSeconds: observation.finiteRevalidateSeconds,
+				keys: [...observation.keys].sort(),
+				observed: observation.observed,
+				paramScopeKeys: [...observation.paramScopeKeys].sort(),
+				requestApis: [...observation.requestApis].sort(),
+				unstableCaches: [...observation.unstableCaches.values()].sort((a, b) => a.keyHash.localeCompare(b.keyHash))
+			};
+		},
+		recordLayoutFiniteRevalidate(layoutId, revalidateSeconds) {
+			if (!Number.isFinite(revalidateSeconds) || revalidateSeconds <= 0) return;
+			const observation = ensureObservation(layoutId);
+			observation.finiteRevalidateSeconds = observation.finiteRevalidateSeconds === null ? revalidateSeconds : Math.min(observation.finiteRevalidateSeconds, revalidateSeconds);
+		},
+		recordLayoutParamScope(layoutId, paramScopeKeys) {
+			const observation = ensureObservation(layoutId);
+			for (const key of paramScopeKeys) observation.paramScopeKeys.add(key);
+		},
+		runLayoutProbe(layoutId, probe) {
+			return runWithIsolatedProbeDependencies(() => {
+				const result = probe();
+				if (!isPromiseLike(result)) {
+					recordProbeDependencies(layoutId);
+					markProbeComplete(layoutId);
+					return result;
+				}
+				return Promise.resolve(result).then((resolved) => {
+					recordProbeDependencies(layoutId);
+					markProbeComplete(layoutId);
+					return resolved;
+				}, (error) => {
+					recordProbeDependencies(layoutId);
+					throw error;
+				});
+			});
+		}
+	};
+}
+//#endregion
+export { createAppLayoutParamAccessTracker, isAppLayoutObservationUnsafeForStaticReuse };
+
+//# sourceMappingURL=app-layout-param-observation.js.map

package/dist/server/app-layout-param-observation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-layout-param-observation.js","names":[],"sources":["../../src/server/app-layout-param-observation.ts"],"sourcesContent":["import type { ThenableParamsObserver } from \"vinext/shims/thenable-params\";\nimport {\n  _peekRequestScopedCacheLife,\n  _peekUnstableCacheObservations,\n  type UnstableCacheObservation,\n} from \"vinext/shims/cache\";\nimport {\n  getCollectedFetchTags,\n  peekCacheableFetchObservations,\n  peekDynamicFetchObservations,\n} from \"vinext/shims/fetch-cache\";\nimport { peekRenderRequestApiUsage } from \"vinext/shims/headers\";\nimport {\n  isInsideUnifiedScope,\n  runWithUnifiedStateMutation,\n} from \"vinext/shims/unified-request-context\";\nimport type { RenderRequestApiKind } from \"./cache-proof.js\";\n\nexport type AppLayoutParamAccessObservation = Readonly<{\n  cacheLifeObserved: boolean;\n  cacheTags: readonly string[];\n  cacheableFetchCount: number;\n  completeness: \"complete\" | \"unknown\";\n  dynamicFetchCount: number;\n  finiteRevalidateSeconds: number | null;\n  keys: readonly string[];\n  observed: boolean;\n  paramScopeKeys: readonly string[];\n  requestApis: readonly RenderRequestApiKind[];\n  unstableCaches: readonly UnstableCacheObservation[];\n}>;\n\nexport type AppLayoutParamAccessTracker = Readonly<{\n  createThenableParamsObserver: (layoutId: string) => ThenableParamsObserver;\n  getLayoutObservation: (layoutId: string) => AppLayoutParamAccessObservation;\n  recordLayoutFiniteRevalidate: (layoutId: string, revalidateSeconds: number) => void;\n  recordLayoutParamScope: (layoutId: string, paramScopeKeys: readonly string[]) => void;\n  runLayoutProbe: (layoutId: string, probe: () => unknown) => unknown;\n}>;\n\nexport function isAppLayoutObservationUnsafeForStaticReuse(\n  observation: AppLayoutParamAccessObservation,\n): boolean {\n  return (\n    observation.completeness !== \"complete\" ||\n    observation.paramScopeKeys.length > 0 ||\n    observation.observed ||\n    observation.requestApis.length > 0 ||\n    observation.finiteRevalidateSeconds !== null ||\n    observation.cacheLifeObserved ||\n    observation.cacheTags.length > 0 ||\n    observation.cacheableFetchCount > 0 ||\n    observation.dynamicFetchCount > 0 ||\n    observation.unstableCaches.length > 0\n  );\n}\n\ntype MutableLayoutParamAccessObservation = {\n  cacheLifeObserved: boolean;\n  cacheTags: Set<string>;\n  cacheableFetches: Set<string>;\n  dynamicFetches: Set<string>;\n  finiteRevalidateSeconds: number | null;\n  keys: Set<string>;\n  observed: boolean;\n  paramScopeKeys: Set<string>;\n  probeComplete: boolean;\n  requestApis: Set<RenderRequestApiKind>;\n  unstableCaches: Map<string, UnstableCacheObservation>;\n};\n\nfunction isPromiseLike(value: unknown): value is PromiseLike<unknown> {\n  return Boolean(\n    value &&\n    (typeof value === \"object\" || typeof value === \"function\") &&\n    \"then\" in value &&\n    typeof value.then === \"function\",\n  );\n}\n\nexport function createAppLayoutParamAccessTracker(): AppLayoutParamAccessTracker {\n  const observations = new Map<string, MutableLayoutParamAccessObservation>();\n\n  const ensureObservation = (layoutId: string): MutableLayoutParamAccessObservation => {\n    const existing = observations.get(layoutId);\n    if (existing) return existing;\n\n    const created: MutableLayoutParamAccessObservation = {\n      cacheLifeObserved: false,\n      cacheTags: new Set(),\n      cacheableFetches: new Set(),\n      dynamicFetches: new Set(),\n      finiteRevalidateSeconds: null,\n      keys: new Set(),\n      observed: false,\n      paramScopeKeys: new Set(),\n      probeComplete: false,\n      requestApis: new Set(),\n      unstableCaches: new Map(),\n    };\n    observations.set(layoutId, created);\n    return created;\n  };\n\n  const markObserved = (layoutId: string, keys: readonly string[]) => {\n    const observation = ensureObservation(layoutId);\n    observation.observed = true;\n    for (const key of keys) {\n      observation.keys.add(key);\n    }\n  };\n\n  const markProbeComplete = (layoutId: string) => {\n    ensureObservation(layoutId).probeComplete = true;\n  };\n\n  const runWithIsolatedProbeDependencies = (probe: () => unknown): unknown => {\n    if (!isInsideUnifiedScope()) {\n      return probe();\n    }\n    return runWithUnifiedStateMutation((ctx) => {\n      ctx.cacheableFetchUrls = new Set();\n      ctx.currentRequestTags = [];\n      ctx.currentFetchSoftTags = [];\n      ctx.dynamicFetchUrls = new Set();\n      ctx.dynamicUsageDetected = false;\n      ctx.renderRequestApiUsage = new Set();\n      ctx.requestScopedCacheLife = null;\n      ctx.unstableCacheObservations = new Map();\n    }, probe);\n  };\n\n  const recordProbeDependencies = (layoutId: string) => {\n    const observation = ensureObservation(layoutId);\n    if (_peekRequestScopedCacheLife() !== null) {\n      observation.cacheLifeObserved = true;\n    }\n    for (const tag of getCollectedFetchTags()) {\n      observation.cacheTags.add(tag);\n    }\n    for (const url of peekCacheableFetchObservations()) {\n      observation.cacheableFetches.add(url);\n    }\n    for (const url of peekDynamicFetchObservations()) {\n      observation.dynamicFetches.add(url);\n    }\n    for (const requestApi of peekRenderRequestApiUsage()) {\n      observation.requestApis.add(requestApi);\n    }\n    for (const unstableCache of _peekUnstableCacheObservations()) {\n      observation.unstableCaches.set(unstableCache.keyHash, unstableCache);\n    }\n  };\n\n  return {\n    createThenableParamsObserver(layoutId) {\n      return {\n        observeParamAccess(keys) {\n          markObserved(layoutId, keys);\n        },\n      };\n    },\n    getLayoutObservation(layoutId) {\n      const observation = observations.get(layoutId);\n      if (!observation) {\n        return {\n          cacheLifeObserved: false,\n          cacheTags: [],\n          cacheableFetchCount: 0,\n          completeness: \"unknown\",\n          dynamicFetchCount: 0,\n          finiteRevalidateSeconds: null,\n          keys: [],\n          observed: false,\n          paramScopeKeys: [],\n          requestApis: [],\n          unstableCaches: [],\n        };\n      }\n\n      return {\n        cacheLifeObserved: observation.cacheLifeObserved,\n        cacheTags: [...observation.cacheTags].sort(),\n        cacheableFetchCount: observation.cacheableFetches.size,\n        completeness: observation.probeComplete ? \"complete\" : \"unknown\",\n        dynamicFetchCount: observation.dynamicFetches.size,\n        finiteRevalidateSeconds: observation.finiteRevalidateSeconds,\n        keys: [...observation.keys].sort(),\n        observed: observation.observed,\n        paramScopeKeys: [...observation.paramScopeKeys].sort(),\n        requestApis: [...observation.requestApis].sort(),\n        unstableCaches: [...observation.unstableCaches.values()].sort((a, b) =>\n          a.keyHash.localeCompare(b.keyHash),\n        ),\n      };\n    },\n    recordLayoutFiniteRevalidate(layoutId, revalidateSeconds) {\n      if (!Number.isFinite(revalidateSeconds) || revalidateSeconds <= 0) return;\n      const observation = ensureObservation(layoutId);\n      observation.finiteRevalidateSeconds =\n        observation.finiteRevalidateSeconds === null\n          ? revalidateSeconds\n          : Math.min(observation.finiteRevalidateSeconds, revalidateSeconds);\n    },\n    recordLayoutParamScope(layoutId, paramScopeKeys) {\n      const observation = ensureObservation(layoutId);\n      for (const key of paramScopeKeys) {\n        observation.paramScopeKeys.add(key);\n      }\n    },\n    runLayoutProbe(layoutId, probe) {\n      return runWithIsolatedProbeDependencies(() => {\n        const result = probe();\n        if (!isPromiseLike(result)) {\n          recordProbeDependencies(layoutId);\n          markProbeComplete(layoutId);\n          return result;\n        }\n\n        return Promise.resolve(result).then(\n          (resolved) => {\n            recordProbeDependencies(layoutId);\n            markProbeComplete(layoutId);\n            return resolved;\n          },\n          (error: unknown) => {\n            // Record whatever dependencies we observed before the failure\n            // so the layout's dependency snapshot is as complete as possible.\n            // Deliberately do NOT call markProbeComplete here: a failed probe\n            // leaves completeness as \"unknown\", which makes the planner fall\n            // back to render-and-send — the safe default for any probe error.\n            recordProbeDependencies(layoutId);\n            throw error;\n          },\n        );\n      });\n    },\n  };\n}\n"],"mappings":"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"}

package/dist/server/app-page-boundary-render.js

@@ -146,9 +146,9 @@ async function renderAppPageHttpAccessFallback(options) {
 		charSet: "utf-8",
 		key: "charset"
 	}), createElement("meta", {
-		content: "noindex",
 		key: "robots",
-		name: "robots"
+		name: "robots",
+		content: "noindex"
 	})];
 	if (metadata) headElements.push(createElement(MetadataHead, {
 		key: "metadata",

package/dist/server/app-page-boundary-render.js.map

@@ -1 +1 @@
-{"version":3,"file":"app-page-boundary-render.js","names":[],"sources":["../../src/server/app-page-boundary-render.ts"],"sourcesContent":["import { Fragment, createElement, type ComponentType, type ReactNode } from \"react\";\nimport { buildClientHookErrorMessage } from \"vinext/shims/client-hook-error\";\nimport { ErrorBoundary } from \"vinext/shims/error-boundary\";\nimport { LayoutSegmentProvider } from \"vinext/shims/layout-segment-context\";\nimport { MetadataHead, ViewportHead } from \"vinext/shims/metadata\";\nimport type { AppPageFontPreload } from \"./app-page-execution.js\";\nimport type { AppPageMiddlewareContext } from \"./app-page-response.js\";\nimport type { MetadataFileRoute } from \"./metadata-routes.js\";\nimport { resolveAppPageHead } from \"./app-page-head.js\";\nimport {\n  renderAppPageBoundaryResponse,\n  resolveAppPageErrorBoundary,\n  resolveAppPageHttpAccessBoundaryComponent,\n  wrapAppPageBoundaryElement,\n  type AppPageParams,\n} from \"./app-page-boundary.js\";\nimport {\n  createAppPageFontData,\n  renderAppPageHtmlResponse,\n  type AppPageSsrHandler,\n} from \"./app-page-stream.js\";\nimport { AppElementsWire, type AppElements } from \"./app-elements.js\";\nimport { createAppPageLayoutEntries } from \"./app-page-route-wiring.js\";\n\n// oxlint-disable-next-line @typescript-eslint/no-explicit-any\ntype AppPageComponent = ComponentType<any>;\ntype AppPageModule = Record<string, unknown> & {\n  default?: AppPageComponent | null | undefined;\n};\ntype AppPageBoundaryOnError = (\n  error: unknown,\n  requestInfo: unknown,\n  errorContext: unknown,\n) => unknown;\n\ntype AppPageBoundaryRscPayloadOptions<TModule extends AppPageModule = AppPageModule> = {\n  element: ReactNode;\n  layoutModules: readonly (TModule | null | undefined)[];\n  pathname: string;\n  route?: AppPageBoundaryRoute<TModule> | null;\n};\n\ntype AppPageBoundaryLayoutEntry = {\n  id: string;\n  treePath: string;\n};\n\nexport type AppPageBoundaryRoute<TModule extends AppPageModule = AppPageModule> = {\n  error?: TModule | null;\n  errorPaths?: readonly TModule[] | null;\n  errors?: readonly (TModule | null | undefined)[] | null;\n  forbidden?: TModule | null;\n  layoutTreePositions?: readonly number[] | null;\n  layouts?: readonly (TModule | null | undefined)[];\n  notFound?: TModule | null;\n  params?: AppPageParams;\n  pattern?: string;\n  routeSegments?: readonly string[];\n  unauthorized?: TModule | null;\n};\n\ntype AppPageBoundaryRenderCommonOptions<TModule extends AppPageModule = AppPageModule> = {\n  buildFontLinkHeader: (preloads: readonly AppPageFontPreload[] | null | undefined) => string;\n  clearRequestContext: () => void;\n  createRscOnErrorHandler: (pathname: string, routePath: string) => AppPageBoundaryOnError;\n  getFontLinks: () => string[];\n  getFontPreloads: () => AppPageFontPreload[];\n  getFontStyles: () => string[];\n  getNavigationContext: () => unknown;\n  globalErrorModule?: TModule | null;\n  isEdgeRuntime?: boolean;\n  isRscRequest: boolean;\n  loadSsrHandler: () => Promise<AppPageSsrHandler>;\n  makeThenableParams: (params: AppPageParams) => unknown;\n  middlewareContext: AppPageMiddlewareContext;\n  metadataRoutes: MetadataFileRoute[];\n  /** Configured next.config `basePath`, threaded into file-based metadata href emission. */\n  basePath?: string;\n  renderToReadableStream: (\n    element: ReactNode | AppElements,\n    options: { onError: AppPageBoundaryOnError },\n  ) => ReadableStream<Uint8Array>;\n  requestUrl: string;\n  resolveChildSegments: (\n    routeSegments: readonly string[],\n    treePosition: number,\n    params: AppPageParams,\n  ) => string[];\n  rootLayouts: readonly (TModule | null | undefined)[];\n  scriptNonce?: string;\n};\n\ntype RenderAppPageHttpAccessFallbackOptions<TModule extends AppPageModule = AppPageModule> = {\n  boundaryComponent?: AppPageComponent | null;\n  layoutModules?: readonly (TModule | null | undefined)[] | null;\n  matchedParams: AppPageParams;\n  rootForbiddenModule?: TModule | null;\n  rootNotFoundModule?: TModule | null;\n  rootUnauthorizedModule?: TModule | null;\n  route?: AppPageBoundaryRoute<TModule> | null;\n  /**\n   * When true, the resolved boundary is rendered without wrapping it in the\n   * route's layouts. Used by `global-not-found.tsx`, which provides its own\n   * `<html>`/`<body>` and intentionally replaces the root layout.\n   * Mirrors Next.js's `createNotFoundLoaderTree` behavior for `hasGlobalNotFound`.\n   * @see https://github.com/vercel/next.js/blob/canary/packages/next/src/server/app-render/app-render.tsx#L495-L520\n   */\n  skipLayoutWrapping?: boolean;\n  statusCode: number;\n} & AppPageBoundaryRenderCommonOptions<TModule>;\n\ntype RenderAppPageErrorBoundaryOptions<TModule extends AppPageModule = AppPageModule> = {\n  error: unknown;\n  matchedParams?: AppPageParams | null;\n  route?: AppPageBoundaryRoute<TModule> | null;\n  sanitizeErrorForClient: (error: Error) => Error;\n} & AppPageBoundaryRenderCommonOptions<TModule>;\n\nfunction getDefaultExport<TModule extends AppPageModule>(\n  module: TModule | null | undefined,\n): AppPageComponent | null {\n  return module?.default ?? null;\n}\n\nfunction wrapRenderedBoundaryElement<TModule extends AppPageModule>(\n  options: Pick<\n    AppPageBoundaryRenderCommonOptions<TModule>,\n    \"globalErrorModule\" | \"isRscRequest\" | \"makeThenableParams\" | \"resolveChildSegments\"\n  > & {\n    element: ReactNode;\n    includeGlobalErrorBoundary: boolean;\n    layoutModules: readonly (TModule | null | undefined)[];\n    layoutTreePositions?: readonly number[] | null;\n    matchedParams: AppPageParams;\n    routeSegments?: readonly string[];\n    skipLayoutWrapping?: boolean;\n  },\n): ReactNode {\n  return wrapAppPageBoundaryElement({\n    element: options.element,\n    getDefaultExport,\n    globalErrorComponent: getDefaultExport(options.globalErrorModule),\n    includeGlobalErrorBoundary: options.includeGlobalErrorBoundary,\n    isRscRequest: options.isRscRequest,\n    layoutModules: options.layoutModules,\n    layoutTreePositions: options.layoutTreePositions,\n    makeThenableParams: options.makeThenableParams,\n    matchedParams: options.matchedParams,\n    renderErrorBoundary(GlobalErrorComponent, children) {\n      return createElement(ErrorBoundary, {\n        fallback: GlobalErrorComponent,\n        // oxlint-disable-next-line react/no-children-prop\n        children,\n      });\n    },\n    renderLayout(LayoutComponent, children, asyncParams) {\n      return createElement(LayoutComponent as AppPageComponent, {\n        // oxlint-disable-next-line react/no-children-prop\n        children,\n        params: asyncParams,\n      });\n    },\n    renderLayoutSegmentProvider(segmentMap, children) {\n      return createElement(\n        // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n        LayoutSegmentProvider as ComponentType<any>,\n        { segmentMap },\n        children,\n      );\n    },\n    resolveChildSegments: options.resolveChildSegments,\n    routeSegments: options.routeSegments ?? [],\n    skipLayoutWrapping: options.skipLayoutWrapping,\n  });\n}\n\nfunction createAppPageBoundaryLayoutEntries<TModule extends AppPageModule>(\n  route: AppPageBoundaryRoute<TModule> | null | undefined,\n  layoutModules: readonly (TModule | null | undefined)[],\n): readonly AppPageBoundaryLayoutEntry[] {\n  if (!route || layoutModules.length === 0) return [];\n\n  return createAppPageLayoutEntries({\n    errors: route.errors,\n    layoutTreePositions: route.layoutTreePositions,\n    layouts: layoutModules,\n    notFounds: null,\n    routeSegments: route.routeSegments,\n  });\n}\n\nfunction resolveHttpAccessFallbackHeadRouteSegments<TModule extends AppPageModule>(\n  route: AppPageBoundaryRoute<TModule> | null | undefined,\n  layoutModules: readonly (TModule | null | undefined)[],\n): readonly string[] | undefined {\n  if (!route?.routeSegments) {\n    return undefined;\n  }\n\n  if (!route.layouts || layoutModules.length >= route.layouts.length) {\n    return route.routeSegments;\n  }\n\n  const lastIncludedLayoutIndex = layoutModules.length - 1;\n  if (lastIncludedLayoutIndex < 0) {\n    return [];\n  }\n\n  const segmentCount = route.layoutTreePositions?.[lastIncludedLayoutIndex] ?? 0;\n  return route.routeSegments.slice(0, segmentCount);\n}\n\nfunction resolveHttpAccessFallbackHeadLayoutTreePositions<TModule extends AppPageModule>(\n  route: AppPageBoundaryRoute<TModule> | null | undefined,\n  layoutModules: readonly (TModule | null | undefined)[],\n): readonly number[] | null | undefined {\n  if (!route?.layouts || layoutModules.length >= route.layouts.length) {\n    return route?.layoutTreePositions;\n  }\n\n  return route.layoutTreePositions?.slice(0, layoutModules.length);\n}\n\nfunction createAppPageBoundaryRscPayload<TModule extends AppPageModule>(\n  options: AppPageBoundaryRscPayloadOptions<TModule>,\n): AppElements {\n  const routeId = AppElementsWire.encodeRouteId(options.pathname, null);\n  const layoutEntries = createAppPageBoundaryLayoutEntries(options.route, options.layoutModules);\n\n  return {\n    ...AppElementsWire.createMetadataEntries({\n      interceptionContext: null,\n      layoutIds: layoutEntries.map((entry) => entry.id),\n      rootLayoutTreePath: layoutEntries[0]?.treePath ?? null,\n      routeId,\n    }),\n    [routeId]: options.element,\n  };\n}\n\nasync function renderAppPageBoundaryElementResponse<TModule extends AppPageModule>(\n  options: AppPageBoundaryRenderCommonOptions<TModule> & {\n    element: ReactNode;\n    layoutModules: readonly (TModule | null | undefined)[];\n    route?: AppPageBoundaryRoute<TModule> | null;\n    routePattern?: string;\n    status: number;\n  },\n): Promise<Response> {\n  const pathname = new URL(options.requestUrl).pathname;\n  const payload = createAppPageBoundaryRscPayload({\n    element: options.element,\n    layoutModules: options.layoutModules,\n    pathname,\n    route: options.route,\n  });\n\n  return renderAppPageBoundaryResponse({\n    async createHtmlResponse(rscStream, responseStatus) {\n      const fontData = createAppPageFontData({\n        getLinks: options.getFontLinks,\n        getPreloads: options.getFontPreloads,\n        getStyles: options.getFontStyles,\n      });\n      const ssrHandler = await options.loadSsrHandler();\n      return renderAppPageHtmlResponse({\n        clearRequestContext: options.clearRequestContext,\n        fontData,\n        fontLinkHeader: options.buildFontLinkHeader(fontData.preloads),\n        isEdgeRuntime: options.isEdgeRuntime,\n        middlewareHeaders: options.middlewareContext.headers,\n        navigationContext: options.getNavigationContext(),\n        rscStream,\n        scriptNonce: options.scriptNonce,\n        ssrHandler,\n        status: responseStatus,\n      });\n    },\n    createRscOnErrorHandler() {\n      return options.createRscOnErrorHandler(pathname, options.routePattern ?? pathname);\n    },\n    element: payload,\n    isEdgeRuntime: options.isEdgeRuntime,\n    isRscRequest: options.isRscRequest,\n    middlewareHeaders: options.middlewareContext.headers,\n    renderToReadableStream: options.renderToReadableStream,\n    status: options.status,\n  });\n}\n\nexport async function renderAppPageHttpAccessFallback<TModule extends AppPageModule>(\n  options: RenderAppPageHttpAccessFallbackOptions<TModule>,\n): Promise<Response | null> {\n  const boundaryComponent =\n    options.boundaryComponent ??\n    resolveAppPageHttpAccessBoundaryComponent({\n      getDefaultExport,\n      rootForbiddenModule: options.rootForbiddenModule,\n      rootNotFoundModule: options.rootNotFoundModule,\n      rootUnauthorizedModule: options.rootUnauthorizedModule,\n      routeForbiddenModule: options.route?.forbidden,\n      routeNotFoundModule: options.route?.notFound,\n      routeUnauthorizedModule: options.route?.unauthorized,\n      statusCode: options.statusCode,\n    });\n  if (!boundaryComponent) {\n    return null;\n  }\n\n  const layoutModules = options.layoutModules ?? options.route?.layouts ?? options.rootLayouts;\n  const pathname = new URL(options.requestUrl).pathname;\n  const routeSegments = resolveHttpAccessFallbackHeadRouteSegments(options.route, layoutModules);\n  const { metadata, viewport } = await resolveAppPageHead({\n    basePath: options.basePath ?? \"\",\n    layoutModules,\n    layoutTreePositions: resolveHttpAccessFallbackHeadLayoutTreePositions(\n      options.route,\n      layoutModules,\n    ),\n    metadataRoutes: options.metadataRoutes,\n    params: options.matchedParams,\n    routePath: options.route?.pattern ?? pathname,\n    routeSegments,\n  });\n\n  const headElements: ReactNode[] = [\n    createElement(\"meta\", { charSet: \"utf-8\", key: \"charset\" }),\n    createElement(\"meta\", { content: \"noindex\", key: \"robots\", name: \"robots\" }),\n  ];\n  if (metadata) {\n    headElements.push(createElement(MetadataHead, { key: \"metadata\", metadata, pathname }));\n  }\n  headElements.push(createElement(ViewportHead, { key: \"viewport\", viewport }));\n\n  const skipLayoutWrapping = options.skipLayoutWrapping ?? false;\n  const element = wrapRenderedBoundaryElement({\n    element: createElement(Fragment, null, ...headElements, createElement(boundaryComponent)),\n    globalErrorModule: options.globalErrorModule,\n    includeGlobalErrorBoundary: true,\n    isRscRequest: options.isRscRequest,\n    layoutModules,\n    layoutTreePositions: options.route?.layoutTreePositions,\n    makeThenableParams: options.makeThenableParams,\n    matchedParams: options.matchedParams,\n    resolveChildSegments: options.resolveChildSegments,\n    routeSegments: options.route?.routeSegments,\n    skipLayoutWrapping,\n  });\n\n  return renderAppPageBoundaryElementResponse({\n    ...options,\n    // When global-not-found owns the document, no layouts should contribute to\n    // the RSC payload's layout entries either — otherwise the SSR pipeline\n    // would expect a root-layout tree path that doesn't exist in the markup.\n    element,\n    layoutModules: skipLayoutWrapping ? [] : layoutModules,\n    route: skipLayoutWrapping ? null : options.route,\n    routePattern: options.route?.pattern,\n    status: options.statusCode,\n  });\n}\n\nexport async function renderAppPageErrorBoundary<TModule extends AppPageModule>(\n  options: RenderAppPageErrorBoundaryOptions<TModule>,\n): Promise<Response | null> {\n  const errorBoundary = resolveAppPageErrorBoundary({\n    getDefaultExport,\n    errorModules: options.route?.errorPaths,\n    globalErrorModule: options.globalErrorModule,\n    layoutErrorModules: options.route?.errors,\n    pageErrorModule: options.route?.error,\n  });\n  if (!errorBoundary.component) {\n    return null;\n  }\n\n  const rawError =\n    options.error instanceof Error ? options.error : new Error(String(options.error));\n  rewriteClientHookError(rawError);\n  const errorObject = options.sanitizeErrorForClient(rawError);\n  const matchedParams = options.matchedParams ?? options.route?.params ?? {};\n  const layoutModules = options.route?.layouts ?? options.rootLayouts;\n  const pathname = new URL(options.requestUrl).pathname;\n\n  const headElements: ReactNode[] = [createElement(\"meta\", { charSet: \"utf-8\", key: \"charset\" })];\n  if (!errorBoundary.isGlobalError) {\n    try {\n      const { metadata, viewport } = await resolveAppPageHead({\n        basePath: options.basePath ?? \"\",\n        fallbackOnFileMetadataError: true,\n        layoutModules,\n        layoutTreePositions: options.route?.layoutTreePositions,\n        metadataRoutes: options.metadataRoutes,\n        params: matchedParams,\n        routePath: options.route?.pattern ?? pathname,\n        routeSegments: options.route?.routeSegments,\n      });\n      if (metadata) {\n        headElements.push(createElement(MetadataHead, { key: \"metadata\", metadata, pathname }));\n      }\n      headElements.push(createElement(ViewportHead, { key: \"viewport\", viewport }));\n    } catch (error) {\n      console.error(\n        `[vinext] App page error boundary head resolution failed for ${options.route?.pattern ?? pathname}:`,\n        error,\n      );\n    }\n  }\n\n  const element = wrapRenderedBoundaryElement({\n    element: createElement(\n      Fragment,\n      null,\n      ...headElements,\n      createElement(errorBoundary.component, {\n        error: errorObject,\n      }),\n    ),\n    globalErrorModule: options.globalErrorModule,\n    includeGlobalErrorBoundary: !errorBoundary.isGlobalError,\n    isRscRequest: options.isRscRequest,\n    layoutModules,\n    layoutTreePositions: options.route?.layoutTreePositions,\n    makeThenableParams: options.makeThenableParams,\n    matchedParams,\n    resolveChildSegments: options.resolveChildSegments,\n    routeSegments: options.route?.routeSegments,\n    skipLayoutWrapping: errorBoundary.isGlobalError,\n  });\n\n  return renderAppPageBoundaryElementResponse({\n    ...options,\n    element,\n    layoutModules,\n    route: options.route,\n    routePattern: options.route?.pattern,\n    status: 200,\n  });\n}\n\n// React client-only hooks that are absent from the `react-server` export\n// condition. When called in a Server Component they produce a TypeError like\n// \"useState is not a function\". Rewrite into an actionable message matching\n// the format used by the next/navigation shims (see client-hook-error.ts).\nconst _clientHookPattern =\n  /\\b(useState|useEffect|useReducer|useRef|useContext|useLayoutEffect|useInsertionEffect|useSyncExternalStore|useTransition|useImperativeHandle|useDeferredValue|useActionState|useOptimistic|useEffectEvent)\\b.*is not a function/;\n\nfunction rewriteClientHookError(error: Error): void {\n  const match = error.message.match(_clientHookPattern);\n  if (match) {\n    error.message = buildClientHookErrorMessage(`${match[1]}()`);\n  }\n}\n"],"mappings":";;;;;;;;;;;;AAsHA,SAAS,iBACP,QACyB;CACzB,OAAO,QAAQ,WAAW;;AAG5B,SAAS,4BACP,SAYW;CACX,OAAO,2BAA2B;EAChC,SAAS,QAAQ;EACjB;EACA,sBAAsB,iBAAiB,QAAQ,kBAAkB;EACjE,4BAA4B,QAAQ;EACpC,cAAc,QAAQ;EACtB,eAAe,QAAQ;EACvB,qBAAqB,QAAQ;EAC7B,oBAAoB,QAAQ;EAC5B,eAAe,QAAQ;EACvB,oBAAoB,sBAAsB,UAAU;GAClD,OAAO,cAAc,eAAe;IAClC,UAAU;IAEV;IACD,CAAC;;EAEJ,aAAa,iBAAiB,UAAU,aAAa;GACnD,OAAO,cAAc,iBAAqC;IAExD;IACA,QAAQ;IACT,CAAC;;EAEJ,4BAA4B,YAAY,UAAU;GAChD,OAAO,cAEL,uBACA,EAAE,YAAY,EACd,SACD;;EAEH,sBAAsB,QAAQ;EAC9B,eAAe,QAAQ,iBAAiB,EAAE;EAC1C,oBAAoB,QAAQ;EAC7B,CAAC;;AAGJ,SAAS,mCACP,OACA,eACuC;CACvC,IAAI,CAAC,SAAS,cAAc,WAAW,GAAG,OAAO,EAAE;CAEnD,OAAO,2BAA2B;EAChC,QAAQ,MAAM;EACd,qBAAqB,MAAM;EAC3B,SAAS;EACT,WAAW;EACX,eAAe,MAAM;EACtB,CAAC;;AAGJ,SAAS,2CACP,OACA,eAC+B;CAC/B,IAAI,CAAC,OAAO,eACV;CAGF,IAAI,CAAC,MAAM,WAAW,cAAc,UAAU,MAAM,QAAQ,QAC1D,OAAO,MAAM;CAGf,MAAM,0BAA0B,cAAc,SAAS;CACvD,IAAI,0BAA0B,GAC5B,OAAO,EAAE;CAGX,MAAM,eAAe,MAAM,sBAAsB,4BAA4B;CAC7E,OAAO,MAAM,cAAc,MAAM,GAAG,aAAa;;AAGnD,SAAS,iDACP,OACA,eACsC;CACtC,IAAI,CAAC,OAAO,WAAW,cAAc,UAAU,MAAM,QAAQ,QAC3D,OAAO,OAAO;CAGhB,OAAO,MAAM,qBAAqB,MAAM,GAAG,cAAc,OAAO;;AAGlE,SAAS,gCACP,SACa;CACb,MAAM,UAAU,gBAAgB,cAAc,QAAQ,UAAU,KAAK;CACrE,MAAM,gBAAgB,mCAAmC,QAAQ,OAAO,QAAQ,cAAc;CAE9F,OAAO;EACL,GAAG,gBAAgB,sBAAsB;GACvC,qBAAqB;GACrB,WAAW,cAAc,KAAK,UAAU,MAAM,GAAG;GACjD,oBAAoB,cAAc,IAAI,YAAY;GAClD;GACD,CAAC;GACD,UAAU,QAAQ;EACpB;;AAGH,eAAe,qCACb,SAOmB;CACnB,MAAM,WAAW,IAAI,IAAI,QAAQ,WAAW,CAAC;CAQ7C,OAAO,8BAA8B;EACnC,MAAM,mBAAmB,WAAW,gBAAgB;GAClD,MAAM,WAAW,sBAAsB;IACrC,UAAU,QAAQ;IAClB,aAAa,QAAQ;IACrB,WAAW,QAAQ;IACpB,CAAC;GACF,MAAM,aAAa,MAAM,QAAQ,gBAAgB;GACjD,OAAO,0BAA0B;IAC/B,qBAAqB,QAAQ;IAC7B;IACA,gBAAgB,QAAQ,oBAAoB,SAAS,SAAS;IAC9D,eAAe,QAAQ;IACvB,mBAAmB,QAAQ,kBAAkB;IAC7C,mBAAmB,QAAQ,sBAAsB;IACjD;IACA,aAAa,QAAQ;IACrB;IACA,QAAQ;IACT,CAAC;;EAEJ,0BAA0B;GACxB,OAAO,QAAQ,wBAAwB,UAAU,QAAQ,gBAAgB,SAAS;;EAEpF,SA/Bc,gCAAgC;GAC9C,SAAS,QAAQ;GACjB,eAAe,QAAQ;GACvB;GACA,OAAO,QAAQ;GAChB,CA0BiB;EAChB,eAAe,QAAQ;EACvB,cAAc,QAAQ;EACtB,mBAAmB,QAAQ,kBAAkB;EAC7C,wBAAwB,QAAQ;EAChC,QAAQ,QAAQ;EACjB,CAAC;;AAGJ,eAAsB,gCACpB,SAC0B;CAC1B,MAAM,oBACJ,QAAQ,qBACR,0CAA0C;EACxC;EACA,qBAAqB,QAAQ;EAC7B,oBAAoB,QAAQ;EAC5B,wBAAwB,QAAQ;EAChC,sBAAsB,QAAQ,OAAO;EACrC,qBAAqB,QAAQ,OAAO;EACpC,yBAAyB,QAAQ,OAAO;EACxC,YAAY,QAAQ;EACrB,CAAC;CACJ,IAAI,CAAC,mBACH,OAAO;CAGT,MAAM,gBAAgB,QAAQ,iBAAiB,QAAQ,OAAO,WAAW,QAAQ;CACjF,MAAM,WAAW,IAAI,IAAI,QAAQ,WAAW,CAAC;CAC7C,MAAM,gBAAgB,2CAA2C,QAAQ,OAAO,cAAc;CAC9F,MAAM,EAAE,UAAU,aAAa,MAAM,mBAAmB;EACtD,UAAU,QAAQ,YAAY;EAC9B;EACA,qBAAqB,iDACnB,QAAQ,OACR,cACD;EACD,gBAAgB,QAAQ;EACxB,QAAQ,QAAQ;EAChB,WAAW,QAAQ,OAAO,WAAW;EACrC;EACD,CAAC;CAEF,MAAM,eAA4B,CAChC,cAAc,QAAQ;EAAE,SAAS;EAAS,KAAK;EAAW,CAAC,EAC3D,cAAc,QAAQ;EAAE,SAAS;EAAW,KAAK;EAAU,MAAM;EAAU,CAAC,CAC7E;CACD,IAAI,UACF,aAAa,KAAK,cAAc,cAAc;EAAE,KAAK;EAAY;EAAU;EAAU,CAAC,CAAC;CAEzF,aAAa,KAAK,cAAc,cAAc;EAAE,KAAK;EAAY;EAAU,CAAC,CAAC;CAE7E,MAAM,qBAAqB,QAAQ,sBAAsB;CACzD,MAAM,UAAU,4BAA4B;EAC1C,SAAS,cAAc,UAAU,MAAM,GAAG,cAAc,cAAc,kBAAkB,CAAC;EACzF,mBAAmB,QAAQ;EAC3B,4BAA4B;EAC5B,cAAc,QAAQ;EACtB;EACA,qBAAqB,QAAQ,OAAO;EACpC,oBAAoB,QAAQ;EAC5B,eAAe,QAAQ;EACvB,sBAAsB,QAAQ;EAC9B,eAAe,QAAQ,OAAO;EAC9B;EACD,CAAC;CAEF,OAAO,qCAAqC;EAC1C,GAAG;EAIH;EACA,eAAe,qBAAqB,EAAE,GAAG;EACzC,OAAO,qBAAqB,OAAO,QAAQ;EAC3C,cAAc,QAAQ,OAAO;EAC7B,QAAQ,QAAQ;EACjB,CAAC;;AAGJ,eAAsB,2BACpB,SAC0B;CAC1B,MAAM,gBAAgB,4BAA4B;EAChD;EACA,cAAc,QAAQ,OAAO;EAC7B,mBAAmB,QAAQ;EAC3B,oBAAoB,QAAQ,OAAO;EACnC,iBAAiB,QAAQ,OAAO;EACjC,CAAC;CACF,IAAI,CAAC,cAAc,WACjB,OAAO;CAGT,MAAM,WACJ,QAAQ,iBAAiB,QAAQ,QAAQ,QAAQ,IAAI,MAAM,OAAO,QAAQ,MAAM,CAAC;CACnF,uBAAuB,SAAS;CAChC,MAAM,cAAc,QAAQ,uBAAuB,SAAS;CAC5D,MAAM,gBAAgB,QAAQ,iBAAiB,QAAQ,OAAO,UAAU,EAAE;CAC1E,MAAM,gBAAgB,QAAQ,OAAO,WAAW,QAAQ;CACxD,MAAM,WAAW,IAAI,IAAI,QAAQ,WAAW,CAAC;CAE7C,MAAM,eAA4B,CAAC,cAAc,QAAQ;EAAE,SAAS;EAAS,KAAK;EAAW,CAAC,CAAC;CAC/F,IAAI,CAAC,cAAc,eACjB,IAAI;EACF,MAAM,EAAE,UAAU,aAAa,MAAM,mBAAmB;GACtD,UAAU,QAAQ,YAAY;GAC9B,6BAA6B;GAC7B;GACA,qBAAqB,QAAQ,OAAO;GACpC,gBAAgB,QAAQ;GACxB,QAAQ;GACR,WAAW,QAAQ,OAAO,WAAW;GACrC,eAAe,QAAQ,OAAO;GAC/B,CAAC;EACF,IAAI,UACF,aAAa,KAAK,cAAc,cAAc;GAAE,KAAK;GAAY;GAAU;GAAU,CAAC,CAAC;EAEzF,aAAa,KAAK,cAAc,cAAc;GAAE,KAAK;GAAY;GAAU,CAAC,CAAC;UACtE,OAAO;EACd,QAAQ,MACN,+DAA+D,QAAQ,OAAO,WAAW,SAAS,IAClG,MACD;;CAIL,MAAM,UAAU,4BAA4B;EAC1C,SAAS,cACP,UACA,MACA,GAAG,cACH,cAAc,cAAc,WAAW,EACrC,OAAO,aACR,CAAC,CACH;EACD,mBAAmB,QAAQ;EAC3B,4BAA4B,CAAC,cAAc;EAC3C,cAAc,QAAQ;EACtB;EACA,qBAAqB,QAAQ,OAAO;EACpC,oBAAoB,QAAQ;EAC5B;EACA,sBAAsB,QAAQ;EAC9B,eAAe,QAAQ,OAAO;EAC9B,oBAAoB,cAAc;EACnC,CAAC;CAEF,OAAO,qCAAqC;EAC1C,GAAG;EACH;EACA;EACA,OAAO,QAAQ;EACf,cAAc,QAAQ,OAAO;EAC7B,QAAQ;EACT,CAAC;;AAOJ,MAAM,qBACJ;AAEF,SAAS,uBAAuB,OAAoB;CAClD,MAAM,QAAQ,MAAM,QAAQ,MAAM,mBAAmB;CACrD,IAAI,OACF,MAAM,UAAU,4BAA4B,GAAG,MAAM,GAAG,IAAI"}
+{"version":3,"file":"app-page-boundary-render.js","names":[],"sources":["../../src/server/app-page-boundary-render.ts"],"sourcesContent":["import { Fragment, createElement, type ComponentType, type ReactNode } from \"react\";\nimport { buildClientHookErrorMessage } from \"vinext/shims/client-hook-error\";\nimport { ErrorBoundary } from \"vinext/shims/error-boundary\";\nimport { LayoutSegmentProvider } from \"vinext/shims/layout-segment-context\";\nimport { MetadataHead, ViewportHead } from \"vinext/shims/metadata\";\nimport type { AppPageFontPreload } from \"./app-page-execution.js\";\nimport type { AppPageMiddlewareContext } from \"./app-page-response.js\";\nimport type { MetadataFileRoute } from \"./metadata-routes.js\";\nimport { resolveAppPageHead } from \"./app-page-head.js\";\nimport {\n  renderAppPageBoundaryResponse,\n  resolveAppPageErrorBoundary,\n  resolveAppPageHttpAccessBoundaryComponent,\n  wrapAppPageBoundaryElement,\n  type AppPageParams,\n} from \"./app-page-boundary.js\";\nimport {\n  createAppPageFontData,\n  renderAppPageHtmlResponse,\n  type AppPageSsrHandler,\n} from \"./app-page-stream.js\";\nimport { AppElementsWire, type AppElements } from \"./app-elements.js\";\nimport { createAppPageLayoutEntries } from \"./app-page-route-wiring.js\";\n\n// oxlint-disable-next-line @typescript-eslint/no-explicit-any\ntype AppPageComponent = ComponentType<any>;\ntype AppPageModule = Record<string, unknown> & {\n  default?: AppPageComponent | null | undefined;\n};\ntype AppPageBoundaryOnError = (\n  error: unknown,\n  requestInfo: unknown,\n  errorContext: unknown,\n) => unknown;\n\ntype AppPageBoundaryRscPayloadOptions<TModule extends AppPageModule = AppPageModule> = {\n  element: ReactNode;\n  layoutModules: readonly (TModule | null | undefined)[];\n  pathname: string;\n  route?: AppPageBoundaryRoute<TModule> | null;\n};\n\ntype AppPageBoundaryLayoutEntry = {\n  id: string;\n  treePath: string;\n};\n\nexport type AppPageBoundaryRoute<TModule extends AppPageModule = AppPageModule> = {\n  error?: TModule | null;\n  errorPaths?: readonly TModule[] | null;\n  errors?: readonly (TModule | null | undefined)[] | null;\n  forbidden?: TModule | null;\n  layoutTreePositions?: readonly number[] | null;\n  layouts?: readonly (TModule | null | undefined)[];\n  notFound?: TModule | null;\n  params?: AppPageParams;\n  pattern?: string;\n  routeSegments?: readonly string[];\n  unauthorized?: TModule | null;\n};\n\ntype AppPageBoundaryRenderCommonOptions<TModule extends AppPageModule = AppPageModule> = {\n  buildFontLinkHeader: (preloads: readonly AppPageFontPreload[] | null | undefined) => string;\n  clearRequestContext: () => void;\n  createRscOnErrorHandler: (pathname: string, routePath: string) => AppPageBoundaryOnError;\n  getFontLinks: () => string[];\n  getFontPreloads: () => AppPageFontPreload[];\n  getFontStyles: () => string[];\n  getNavigationContext: () => unknown;\n  globalErrorModule?: TModule | null;\n  isEdgeRuntime?: boolean;\n  isRscRequest: boolean;\n  loadSsrHandler: () => Promise<AppPageSsrHandler>;\n  makeThenableParams: (params: AppPageParams) => unknown;\n  middlewareContext: AppPageMiddlewareContext;\n  metadataRoutes: MetadataFileRoute[];\n  /** Configured next.config `basePath`, threaded into file-based metadata href emission. */\n  basePath?: string;\n  renderToReadableStream: (\n    element: ReactNode | AppElements,\n    options: { onError: AppPageBoundaryOnError },\n  ) => ReadableStream<Uint8Array>;\n  requestUrl: string;\n  resolveChildSegments: (\n    routeSegments: readonly string[],\n    treePosition: number,\n    params: AppPageParams,\n  ) => string[];\n  rootLayouts: readonly (TModule | null | undefined)[];\n  scriptNonce?: string;\n};\n\ntype RenderAppPageHttpAccessFallbackOptions<TModule extends AppPageModule = AppPageModule> = {\n  boundaryComponent?: AppPageComponent | null;\n  layoutModules?: readonly (TModule | null | undefined)[] | null;\n  matchedParams: AppPageParams;\n  rootForbiddenModule?: TModule | null;\n  rootNotFoundModule?: TModule | null;\n  rootUnauthorizedModule?: TModule | null;\n  route?: AppPageBoundaryRoute<TModule> | null;\n  /**\n   * When true, the resolved boundary is rendered without wrapping it in the\n   * route's layouts. Used by `global-not-found.tsx`, which provides its own\n   * `<html>`/`<body>` and intentionally replaces the root layout.\n   * Mirrors Next.js's `createNotFoundLoaderTree` behavior for `hasGlobalNotFound`.\n   * @see https://github.com/vercel/next.js/blob/canary/packages/next/src/server/app-render/app-render.tsx#L495-L520\n   */\n  skipLayoutWrapping?: boolean;\n  statusCode: number;\n} & AppPageBoundaryRenderCommonOptions<TModule>;\n\ntype RenderAppPageErrorBoundaryOptions<TModule extends AppPageModule = AppPageModule> = {\n  error: unknown;\n  matchedParams?: AppPageParams | null;\n  route?: AppPageBoundaryRoute<TModule> | null;\n  sanitizeErrorForClient: (error: Error) => Error;\n} & AppPageBoundaryRenderCommonOptions<TModule>;\n\nfunction getDefaultExport<TModule extends AppPageModule>(\n  module: TModule | null | undefined,\n): AppPageComponent | null {\n  return module?.default ?? null;\n}\n\nfunction wrapRenderedBoundaryElement<TModule extends AppPageModule>(\n  options: Pick<\n    AppPageBoundaryRenderCommonOptions<TModule>,\n    \"globalErrorModule\" | \"isRscRequest\" | \"makeThenableParams\" | \"resolveChildSegments\"\n  > & {\n    element: ReactNode;\n    includeGlobalErrorBoundary: boolean;\n    layoutModules: readonly (TModule | null | undefined)[];\n    layoutTreePositions?: readonly number[] | null;\n    matchedParams: AppPageParams;\n    routeSegments?: readonly string[];\n    skipLayoutWrapping?: boolean;\n  },\n): ReactNode {\n  return wrapAppPageBoundaryElement({\n    element: options.element,\n    getDefaultExport,\n    globalErrorComponent: getDefaultExport(options.globalErrorModule),\n    includeGlobalErrorBoundary: options.includeGlobalErrorBoundary,\n    isRscRequest: options.isRscRequest,\n    layoutModules: options.layoutModules,\n    layoutTreePositions: options.layoutTreePositions,\n    makeThenableParams: options.makeThenableParams,\n    matchedParams: options.matchedParams,\n    renderErrorBoundary(GlobalErrorComponent, children) {\n      return createElement(ErrorBoundary, {\n        fallback: GlobalErrorComponent,\n        // oxlint-disable-next-line react/no-children-prop\n        children,\n      });\n    },\n    renderLayout(LayoutComponent, children, asyncParams) {\n      return createElement(LayoutComponent as AppPageComponent, {\n        // oxlint-disable-next-line react/no-children-prop\n        children,\n        params: asyncParams,\n      });\n    },\n    renderLayoutSegmentProvider(segmentMap, children) {\n      return createElement(\n        // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n        LayoutSegmentProvider as ComponentType<any>,\n        { segmentMap },\n        children,\n      );\n    },\n    resolveChildSegments: options.resolveChildSegments,\n    routeSegments: options.routeSegments ?? [],\n    skipLayoutWrapping: options.skipLayoutWrapping,\n  });\n}\n\nfunction createAppPageBoundaryLayoutEntries<TModule extends AppPageModule>(\n  route: AppPageBoundaryRoute<TModule> | null | undefined,\n  layoutModules: readonly (TModule | null | undefined)[],\n): readonly AppPageBoundaryLayoutEntry[] {\n  if (!route || layoutModules.length === 0) return [];\n\n  return createAppPageLayoutEntries({\n    errors: route.errors,\n    layoutTreePositions: route.layoutTreePositions,\n    layouts: layoutModules,\n    notFounds: null,\n    routeSegments: route.routeSegments,\n  });\n}\n\nfunction resolveHttpAccessFallbackHeadRouteSegments<TModule extends AppPageModule>(\n  route: AppPageBoundaryRoute<TModule> | null | undefined,\n  layoutModules: readonly (TModule | null | undefined)[],\n): readonly string[] | undefined {\n  if (!route?.routeSegments) {\n    return undefined;\n  }\n\n  if (!route.layouts || layoutModules.length >= route.layouts.length) {\n    return route.routeSegments;\n  }\n\n  const lastIncludedLayoutIndex = layoutModules.length - 1;\n  if (lastIncludedLayoutIndex < 0) {\n    return [];\n  }\n\n  const segmentCount = route.layoutTreePositions?.[lastIncludedLayoutIndex] ?? 0;\n  return route.routeSegments.slice(0, segmentCount);\n}\n\nfunction resolveHttpAccessFallbackHeadLayoutTreePositions<TModule extends AppPageModule>(\n  route: AppPageBoundaryRoute<TModule> | null | undefined,\n  layoutModules: readonly (TModule | null | undefined)[],\n): readonly number[] | null | undefined {\n  if (!route?.layouts || layoutModules.length >= route.layouts.length) {\n    return route?.layoutTreePositions;\n  }\n\n  return route.layoutTreePositions?.slice(0, layoutModules.length);\n}\n\nfunction createAppPageBoundaryRscPayload<TModule extends AppPageModule>(\n  options: AppPageBoundaryRscPayloadOptions<TModule>,\n): AppElements {\n  const routeId = AppElementsWire.encodeRouteId(options.pathname, null);\n  const layoutEntries = createAppPageBoundaryLayoutEntries(options.route, options.layoutModules);\n\n  return {\n    ...AppElementsWire.createMetadataEntries({\n      interceptionContext: null,\n      layoutIds: layoutEntries.map((entry) => entry.id),\n      rootLayoutTreePath: layoutEntries[0]?.treePath ?? null,\n      routeId,\n    }),\n    [routeId]: options.element,\n  };\n}\n\nasync function renderAppPageBoundaryElementResponse<TModule extends AppPageModule>(\n  options: AppPageBoundaryRenderCommonOptions<TModule> & {\n    element: ReactNode;\n    layoutModules: readonly (TModule | null | undefined)[];\n    route?: AppPageBoundaryRoute<TModule> | null;\n    routePattern?: string;\n    status: number;\n  },\n): Promise<Response> {\n  const pathname = new URL(options.requestUrl).pathname;\n  const payload = createAppPageBoundaryRscPayload({\n    element: options.element,\n    layoutModules: options.layoutModules,\n    pathname,\n    route: options.route,\n  });\n\n  return renderAppPageBoundaryResponse({\n    async createHtmlResponse(rscStream, responseStatus) {\n      const fontData = createAppPageFontData({\n        getLinks: options.getFontLinks,\n        getPreloads: options.getFontPreloads,\n        getStyles: options.getFontStyles,\n      });\n      const ssrHandler = await options.loadSsrHandler();\n      return renderAppPageHtmlResponse({\n        clearRequestContext: options.clearRequestContext,\n        fontData,\n        fontLinkHeader: options.buildFontLinkHeader(fontData.preloads),\n        isEdgeRuntime: options.isEdgeRuntime,\n        middlewareHeaders: options.middlewareContext.headers,\n        navigationContext: options.getNavigationContext(),\n        rscStream,\n        scriptNonce: options.scriptNonce,\n        ssrHandler,\n        status: responseStatus,\n      });\n    },\n    createRscOnErrorHandler() {\n      return options.createRscOnErrorHandler(pathname, options.routePattern ?? pathname);\n    },\n    element: payload,\n    isEdgeRuntime: options.isEdgeRuntime,\n    isRscRequest: options.isRscRequest,\n    middlewareHeaders: options.middlewareContext.headers,\n    renderToReadableStream: options.renderToReadableStream,\n    status: options.status,\n  });\n}\n\nexport async function renderAppPageHttpAccessFallback<TModule extends AppPageModule>(\n  options: RenderAppPageHttpAccessFallbackOptions<TModule>,\n): Promise<Response | null> {\n  const boundaryComponent =\n    options.boundaryComponent ??\n    resolveAppPageHttpAccessBoundaryComponent({\n      getDefaultExport,\n      rootForbiddenModule: options.rootForbiddenModule,\n      rootNotFoundModule: options.rootNotFoundModule,\n      rootUnauthorizedModule: options.rootUnauthorizedModule,\n      routeForbiddenModule: options.route?.forbidden,\n      routeNotFoundModule: options.route?.notFound,\n      routeUnauthorizedModule: options.route?.unauthorized,\n      statusCode: options.statusCode,\n    });\n  if (!boundaryComponent) {\n    return null;\n  }\n\n  const layoutModules = options.layoutModules ?? options.route?.layouts ?? options.rootLayouts;\n  const pathname = new URL(options.requestUrl).pathname;\n  const routeSegments = resolveHttpAccessFallbackHeadRouteSegments(options.route, layoutModules);\n  const { metadata, viewport } = await resolveAppPageHead({\n    basePath: options.basePath ?? \"\",\n    layoutModules,\n    layoutTreePositions: resolveHttpAccessFallbackHeadLayoutTreePositions(\n      options.route,\n      layoutModules,\n    ),\n    metadataRoutes: options.metadataRoutes,\n    params: options.matchedParams,\n    routePath: options.route?.pattern ?? pathname,\n    routeSegments,\n  });\n\n  const headElements: ReactNode[] = [\n    createElement(\"meta\", { charSet: \"utf-8\", key: \"charset\" }),\n    createElement(\"meta\", { key: \"robots\", name: \"robots\", content: \"noindex\" }),\n  ];\n  if (metadata) {\n    headElements.push(createElement(MetadataHead, { key: \"metadata\", metadata, pathname }));\n  }\n  headElements.push(createElement(ViewportHead, { key: \"viewport\", viewport }));\n\n  const skipLayoutWrapping = options.skipLayoutWrapping ?? false;\n  const element = wrapRenderedBoundaryElement({\n    element: createElement(Fragment, null, ...headElements, createElement(boundaryComponent)),\n    globalErrorModule: options.globalErrorModule,\n    includeGlobalErrorBoundary: true,\n    isRscRequest: options.isRscRequest,\n    layoutModules,\n    layoutTreePositions: options.route?.layoutTreePositions,\n    makeThenableParams: options.makeThenableParams,\n    matchedParams: options.matchedParams,\n    resolveChildSegments: options.resolveChildSegments,\n    routeSegments: options.route?.routeSegments,\n    skipLayoutWrapping,\n  });\n\n  return renderAppPageBoundaryElementResponse({\n    ...options,\n    // When global-not-found owns the document, no layouts should contribute to\n    // the RSC payload's layout entries either — otherwise the SSR pipeline\n    // would expect a root-layout tree path that doesn't exist in the markup.\n    element,\n    layoutModules: skipLayoutWrapping ? [] : layoutModules,\n    route: skipLayoutWrapping ? null : options.route,\n    routePattern: options.route?.pattern,\n    status: options.statusCode,\n  });\n}\n\nexport async function renderAppPageErrorBoundary<TModule extends AppPageModule>(\n  options: RenderAppPageErrorBoundaryOptions<TModule>,\n): Promise<Response | null> {\n  const errorBoundary = resolveAppPageErrorBoundary({\n    getDefaultExport,\n    errorModules: options.route?.errorPaths,\n    globalErrorModule: options.globalErrorModule,\n    layoutErrorModules: options.route?.errors,\n    pageErrorModule: options.route?.error,\n  });\n  if (!errorBoundary.component) {\n    return null;\n  }\n\n  const rawError =\n    options.error instanceof Error ? options.error : new Error(String(options.error));\n  rewriteClientHookError(rawError);\n  const errorObject = options.sanitizeErrorForClient(rawError);\n  const matchedParams = options.matchedParams ?? options.route?.params ?? {};\n  const layoutModules = options.route?.layouts ?? options.rootLayouts;\n  const pathname = new URL(options.requestUrl).pathname;\n\n  const headElements: ReactNode[] = [createElement(\"meta\", { charSet: \"utf-8\", key: \"charset\" })];\n  if (!errorBoundary.isGlobalError) {\n    try {\n      const { metadata, viewport } = await resolveAppPageHead({\n        basePath: options.basePath ?? \"\",\n        fallbackOnFileMetadataError: true,\n        layoutModules,\n        layoutTreePositions: options.route?.layoutTreePositions,\n        metadataRoutes: options.metadataRoutes,\n        params: matchedParams,\n        routePath: options.route?.pattern ?? pathname,\n        routeSegments: options.route?.routeSegments,\n      });\n      if (metadata) {\n        headElements.push(createElement(MetadataHead, { key: \"metadata\", metadata, pathname }));\n      }\n      headElements.push(createElement(ViewportHead, { key: \"viewport\", viewport }));\n    } catch (error) {\n      console.error(\n        `[vinext] App page error boundary head resolution failed for ${options.route?.pattern ?? pathname}:`,\n        error,\n      );\n    }\n  }\n\n  const element = wrapRenderedBoundaryElement({\n    element: createElement(\n      Fragment,\n      null,\n      ...headElements,\n      createElement(errorBoundary.component, {\n        error: errorObject,\n      }),\n    ),\n    globalErrorModule: options.globalErrorModule,\n    includeGlobalErrorBoundary: !errorBoundary.isGlobalError,\n    isRscRequest: options.isRscRequest,\n    layoutModules,\n    layoutTreePositions: options.route?.layoutTreePositions,\n    makeThenableParams: options.makeThenableParams,\n    matchedParams,\n    resolveChildSegments: options.resolveChildSegments,\n    routeSegments: options.route?.routeSegments,\n    skipLayoutWrapping: errorBoundary.isGlobalError,\n  });\n\n  return renderAppPageBoundaryElementResponse({\n    ...options,\n    element,\n    layoutModules,\n    route: options.route,\n    routePattern: options.route?.pattern,\n    status: 200,\n  });\n}\n\n// React client-only hooks that are absent from the `react-server` export\n// condition. When called in a Server Component they produce a TypeError like\n// \"useState is not a function\". Rewrite into an actionable message matching\n// the format used by the next/navigation shims (see client-hook-error.ts).\nconst _clientHookPattern =\n  /\\b(useState|useEffect|useReducer|useRef|useContext|useLayoutEffect|useInsertionEffect|useSyncExternalStore|useTransition|useImperativeHandle|useDeferredValue|useActionState|useOptimistic|useEffectEvent)\\b.*is not a function/;\n\nfunction rewriteClientHookError(error: Error): void {\n  const match = error.message.match(_clientHookPattern);\n  if (match) {\n    error.message = buildClientHookErrorMessage(`${match[1]}()`);\n  }\n}\n"],"mappings":"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"}

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

@@ -7,8 +7,8 @@ import { shouldSuppressLoadingBoundaries } from "./app-rsc-render-mode.js";
 import "./app-elements.js";
 import { consumeDynamicFetchObservations, ensureFetchPatch, getCollectedFetchTags, peekDynamicFetchObservations, runWithFetchDedupe, setCurrentFetchCacheMode, setCurrentFetchSoftTags } from "../shims/fetch-cache.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 { readStreamAsText } from "../utils/text-stream.js";
+import { createAppPageTreePath } from "./app-page-route-wiring.js";
 import { mergeMiddlewareResponseHeaders } from "./middleware-response-headers.js";
 import "./app-page-response.js";
 import { buildAppPageSpecialErrorResponse, resolveAppPageSpecialError, teeAppPageRscStreamForCapture } from "./app-page-execution.js";

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

@@ -2,7 +2,8 @@ import { AppPageParams } from "./app-page-boundary.js";
 
 //#region src/server/app-page-params.d.ts
 declare function getAppPageSegmentParamName(segment: string): string | null;
+declare function resolveAppPageSegmentParamScopeKeys(routeSegments: readonly string[] | null | undefined, treePosition: number): readonly string[];
 declare function resolveAppPageSegmentParams(routeSegments: readonly string[] | null | undefined, treePosition: number, matchedParams: AppPageParams): AppPageParams;
 //#endregion
-export { getAppPageSegmentParamName, resolveAppPageSegmentParams };
+export { getAppPageSegmentParamName, resolveAppPageSegmentParamScopeKeys, resolveAppPageSegmentParams };
 //# sourceMappingURL=app-page-params.d.ts.map

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

@@ -8,6 +8,19 @@ function getAppPageSegmentParamName(segment) {
 function isEmptyOptionalCatchAll(segment, paramValue) {
 	return segment.startsWith("[[...") && Array.isArray(paramValue) && paramValue.length === 0;
 }
+function resolveAppPageSegmentParamScopeKeys(routeSegments, treePosition) {
+	const paramNames = [];
+	const seen = /* @__PURE__ */ new Set();
+	const segments = routeSegments ?? [];
+	const end = Math.min(Math.max(treePosition, 0), segments.length);
+	for (let index = 0; index < end; index++) {
+		const paramName = getAppPageSegmentParamName(segments[index]);
+		if (!paramName || seen.has(paramName)) continue;
+		seen.add(paramName);
+		paramNames.push(paramName);
+	}
+	return paramNames;
+}
 function resolveAppPageSegmentParams(routeSegments, treePosition, matchedParams) {
 	const segmentParams = {};
 	const segments = routeSegments ?? [];
@@ -23,6 +36,6 @@ function resolveAppPageSegmentParams(routeSegments, treePosition, matchedParams)
 	return segmentParams;
 }
 //#endregion
-export { getAppPageSegmentParamName, resolveAppPageSegmentParams };
+export { getAppPageSegmentParamName, resolveAppPageSegmentParamScopeKeys, resolveAppPageSegmentParams };
 
 //# sourceMappingURL=app-page-params.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"app-page-params.js","names":[],"sources":["../../src/server/app-page-params.ts"],"sourcesContent":["import type { AppPageParams } from \"./app-page-boundary.js\";\n\nexport function getAppPageSegmentParamName(segment: string): string | null {\n  if (segment.startsWith(\"[[...\") && segment.endsWith(\"]]\") && segment.length > 7) {\n    return segment.slice(5, -2);\n  }\n\n  if (segment.startsWith(\"[...\") && segment.endsWith(\"]\") && segment.length > 5) {\n    return segment.slice(4, -1);\n  }\n\n  if (\n    segment.startsWith(\"[\") &&\n    segment.endsWith(\"]\") &&\n    !segment.includes(\".\") &&\n    segment.length > 2\n  ) {\n    return segment.slice(1, -1);\n  }\n\n  return null;\n}\n\nfunction isEmptyOptionalCatchAll(segment: string, paramValue: string | string[]): boolean {\n  return segment.startsWith(\"[[...\") && Array.isArray(paramValue) && paramValue.length === 0;\n}\n\nexport function resolveAppPageSegmentParams(\n  routeSegments: readonly string[] | null | undefined,\n  treePosition: number,\n  matchedParams: AppPageParams,\n): AppPageParams {\n  const segmentParams: AppPageParams = {};\n  const segments = routeSegments ?? [];\n  const end = Math.min(Math.max(treePosition, 0), segments.length);\n\n  for (let index = 0; index < end; index++) {\n    const segment = segments[index];\n    const paramName = getAppPageSegmentParamName(segment);\n    if (!paramName) {\n      continue;\n    }\n\n    const paramValue = matchedParams[paramName];\n    if (paramValue === undefined || isEmptyOptionalCatchAll(segment, paramValue)) {\n      continue;\n    }\n\n    segmentParams[paramName] = paramValue;\n  }\n\n  return segmentParams;\n}\n"],"mappings":";AAEA,SAAgB,2BAA2B,SAAgC;CACzE,IAAI,QAAQ,WAAW,QAAQ,IAAI,QAAQ,SAAS,KAAK,IAAI,QAAQ,SAAS,GAC5E,OAAO,QAAQ,MAAM,GAAG,GAAG;CAG7B,IAAI,QAAQ,WAAW,OAAO,IAAI,QAAQ,SAAS,IAAI,IAAI,QAAQ,SAAS,GAC1E,OAAO,QAAQ,MAAM,GAAG,GAAG;CAG7B,IACE,QAAQ,WAAW,IAAI,IACvB,QAAQ,SAAS,IAAI,IACrB,CAAC,QAAQ,SAAS,IAAI,IACtB,QAAQ,SAAS,GAEjB,OAAO,QAAQ,MAAM,GAAG,GAAG;CAG7B,OAAO;;AAGT,SAAS,wBAAwB,SAAiB,YAAwC;CACxF,OAAO,QAAQ,WAAW,QAAQ,IAAI,MAAM,QAAQ,WAAW,IAAI,WAAW,WAAW;;AAG3F,SAAgB,4BACd,eACA,cACA,eACe;CACf,MAAM,gBAA+B,EAAE;CACvC,MAAM,WAAW,iBAAiB,EAAE;CACpC,MAAM,MAAM,KAAK,IAAI,KAAK,IAAI,cAAc,EAAE,EAAE,SAAS,OAAO;CAEhE,KAAK,IAAI,QAAQ,GAAG,QAAQ,KAAK,SAAS;EACxC,MAAM,UAAU,SAAS;EACzB,MAAM,YAAY,2BAA2B,QAAQ;EACrD,IAAI,CAAC,WACH;EAGF,MAAM,aAAa,cAAc;EACjC,IAAI,eAAe,KAAA,KAAa,wBAAwB,SAAS,WAAW,EAC1E;EAGF,cAAc,aAAa;;CAG7B,OAAO"}
+{"version":3,"file":"app-page-params.js","names":[],"sources":["../../src/server/app-page-params.ts"],"sourcesContent":["import type { AppPageParams } from \"./app-page-boundary.js\";\n\nexport function getAppPageSegmentParamName(segment: string): string | null {\n  if (segment.startsWith(\"[[...\") && segment.endsWith(\"]]\") && segment.length > 7) {\n    return segment.slice(5, -2);\n  }\n\n  if (segment.startsWith(\"[...\") && segment.endsWith(\"]\") && segment.length > 5) {\n    return segment.slice(4, -1);\n  }\n\n  if (\n    segment.startsWith(\"[\") &&\n    segment.endsWith(\"]\") &&\n    !segment.includes(\".\") &&\n    segment.length > 2\n  ) {\n    return segment.slice(1, -1);\n  }\n\n  return null;\n}\n\nfunction isEmptyOptionalCatchAll(segment: string, paramValue: string | string[]): boolean {\n  return segment.startsWith(\"[[...\") && Array.isArray(paramValue) && paramValue.length === 0;\n}\n\nexport function resolveAppPageSegmentParamScopeKeys(\n  routeSegments: readonly string[] | null | undefined,\n  treePosition: number,\n): readonly string[] {\n  const paramNames: string[] = [];\n  const seen = new Set<string>();\n  const segments = routeSegments ?? [];\n  const end = Math.min(Math.max(treePosition, 0), segments.length);\n\n  for (let index = 0; index < end; index++) {\n    const paramName = getAppPageSegmentParamName(segments[index]);\n    if (!paramName || seen.has(paramName)) {\n      continue;\n    }\n\n    seen.add(paramName);\n    paramNames.push(paramName);\n  }\n\n  return paramNames;\n}\n\nexport function resolveAppPageSegmentParams(\n  routeSegments: readonly string[] | null | undefined,\n  treePosition: number,\n  matchedParams: AppPageParams,\n): AppPageParams {\n  const segmentParams: AppPageParams = {};\n  const segments = routeSegments ?? [];\n  const end = Math.min(Math.max(treePosition, 0), segments.length);\n\n  for (let index = 0; index < end; index++) {\n    const segment = segments[index];\n    const paramName = getAppPageSegmentParamName(segment);\n    if (!paramName) {\n      continue;\n    }\n\n    const paramValue = matchedParams[paramName];\n    if (paramValue === undefined || isEmptyOptionalCatchAll(segment, paramValue)) {\n      continue;\n    }\n\n    segmentParams[paramName] = paramValue;\n  }\n\n  return segmentParams;\n}\n"],"mappings":";AAEA,SAAgB,2BAA2B,SAAgC;CACzE,IAAI,QAAQ,WAAW,QAAQ,IAAI,QAAQ,SAAS,KAAK,IAAI,QAAQ,SAAS,GAC5E,OAAO,QAAQ,MAAM,GAAG,GAAG;CAG7B,IAAI,QAAQ,WAAW,OAAO,IAAI,QAAQ,SAAS,IAAI,IAAI,QAAQ,SAAS,GAC1E,OAAO,QAAQ,MAAM,GAAG,GAAG;CAG7B,IACE,QAAQ,WAAW,IAAI,IACvB,QAAQ,SAAS,IAAI,IACrB,CAAC,QAAQ,SAAS,IAAI,IACtB,QAAQ,SAAS,GAEjB,OAAO,QAAQ,MAAM,GAAG,GAAG;CAG7B,OAAO;;AAGT,SAAS,wBAAwB,SAAiB,YAAwC;CACxF,OAAO,QAAQ,WAAW,QAAQ,IAAI,MAAM,QAAQ,WAAW,IAAI,WAAW,WAAW;;AAG3F,SAAgB,oCACd,eACA,cACmB;CACnB,MAAM,aAAuB,EAAE;CAC/B,MAAM,uBAAO,IAAI,KAAa;CAC9B,MAAM,WAAW,iBAAiB,EAAE;CACpC,MAAM,MAAM,KAAK,IAAI,KAAK,IAAI,cAAc,EAAE,EAAE,SAAS,OAAO;CAEhE,KAAK,IAAI,QAAQ,GAAG,QAAQ,KAAK,SAAS;EACxC,MAAM,YAAY,2BAA2B,SAAS,OAAO;EAC7D,IAAI,CAAC,aAAa,KAAK,IAAI,UAAU,EACnC;EAGF,KAAK,IAAI,UAAU;EACnB,WAAW,KAAK,UAAU;;CAG5B,OAAO;;AAGT,SAAgB,4BACd,eACA,cACA,eACe;CACf,MAAM,gBAA+B,EAAE;CACvC,MAAM,WAAW,iBAAiB,EAAE;CACpC,MAAM,MAAM,KAAK,IAAI,KAAK,IAAI,cAAc,EAAE,EAAE,SAAS,OAAO;CAEhE,KAAK,IAAI,QAAQ,GAAG,QAAQ,KAAK,SAAS;EACxC,MAAM,UAAU,SAAS;EACzB,MAAM,YAAY,2BAA2B,QAAQ;EACrD,IAAI,CAAC,WACH;EAGF,MAAM,aAAa,cAAc;EACjC,IAAI,eAAe,KAAA,KAAa,wBAAwB,SAAS,WAAW,EAC1E;EAGF,cAAc,aAAa;;CAG7B,OAAO"}

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

@@ -2,6 +2,17 @@ import { LayoutFlags } from "./app-elements-wire.js";
 import { AppPageSpecialError, LayoutClassificationOptions } from "./app-page-execution.js";
 
 //#region src/server/app-page-probe.d.ts
+type ProbeReactServerSubtreeOptions = Readonly<{
+  maxDepth?: number;
+  maxNodes?: number;
+}>;
+/**
+ * Invokes server-component children returned by a layout probe so per-layout
+ * skip eligibility observes data dependencies created below the layout's
+ * immediate function body. The real RSC render remains authoritative; probe
+ * failures only make static-layout skip fall back to render-and-send.
+ */
+declare function probeReactServerSubtree(node: unknown, options?: ProbeReactServerSubtreeOptions): Promise<void>;
 /**
  * Build a probePage() invocation for the App Router request lifecycle.
  *
@@ -41,5 +52,5 @@ type ProbeAppPageBeforeRenderOptions = {
 };
 declare function probeAppPageBeforeRender(options: ProbeAppPageBeforeRenderOptions): Promise<ProbeAppPageBeforeRenderResult>;
 //#endregion
-export { probeAppPage, probeAppPageBeforeRender };
+export { probeAppPage, probeAppPageBeforeRender, probeReactServerSubtree };
 //# sourceMappingURL=app-page-probe.d.ts.map