vinext 0.0.51 → 0.0.53

package/dist/server/app-browser-navigation-controller.js.map

@@ -1 +1 @@
-{"version":3,"file":"app-browser-navigation-controller.js","names":[],"sources":["../../src/server/app-browser-navigation-controller.ts"],"sourcesContent":["import { startTransition, useLayoutEffect, type Dispatch, type ReactNode } from \"react\";\nimport {\n  activateNavigationSnapshot,\n  clearPendingPathname,\n  commitClientNavigationState,\n} from \"vinext/shims/navigation\";\nimport type { ClientNavigationRenderSnapshot } from \"vinext/shims/navigation\";\nimport type { RouteManifest } from \"../routing/app-route-graph.js\";\nimport {\n  createPendingNavigationCommit,\n  type AppRouterState,\n  type OperationLane,\n} from \"./app-browser-state.js\";\nimport {\n  applyApprovedVisibleCommit,\n  approveHmrVisibleCommit,\n  approvePendingNavigationCommit,\n  resolveAndClassifyNavigationCommit,\n  type ApprovedVisibleCommit,\n} from \"./app-browser-visible-commit.js\";\nimport {\n  shouldScheduleRefreshForDiscardedServerAction,\n  type ServerActionRevalidationKind,\n} from \"./app-browser-action-result.js\";\nimport type { AppElements } from \"./app-elements.js\";\n\nexport type HistoryUpdateMode = \"push\" | \"replace\";\n\nexport type PendingBrowserRouterState = {\n  promise: Promise<AppRouterState>;\n  resolve: (state: AppRouterState) => void;\n  settled: boolean;\n};\nexport type NavigationPayloadOutcome = \"committed\" | \"no-commit\" | \"hard-navigate\";\ntype HardNavigationMode = \"assign\" | \"replace\";\n\ntype BrowserNavigationCommitEffectFactory = (options: {\n  href: string;\n  historyUpdateMode: HistoryUpdateMode | undefined;\n  navId: number;\n  params: Record<string, string | string[]>;\n  previousNextUrl: string | null;\n  targetHistoryIndex?: number | null;\n}) => () => void;\n\ntype BrowserRouterStateRef = {\n  current: AppRouterState;\n};\n\ntype SameUrlServerActionLifecycleOptions = {\n  onDiscardedRevalidation?: () => void;\n  revalidation?: ServerActionRevalidationKind;\n  startedNavigationId?: number;\n  targetHref?: string;\n};\n\ntype BrowserNavigationControllerDeps = {\n  commitClientNavigationState?: typeof commitClientNavigationState;\n  performHardNavigation?: (href: string, mode?: HardNavigationMode) => boolean;\n  getRouteManifest?: () => RouteManifest | null;\n  syncHistoryStatePreviousNextUrl?: (previousNextUrl: string | null) => void;\n};\n\ntype BrowserNavigationController = {\n  beginNavigation(): number;\n  getActiveNavigationId(): number;\n  hasBrowserRouterState(): boolean;\n  getBrowserRouterState(): AppRouterState;\n  isCurrentNavigation(navId: number): boolean;\n  waitForBrowserRouterStateReady(): Promise<void>;\n  attachBrowserRouterState(\n    setter: Dispatch<AppRouterState | Promise<AppRouterState>>,\n    stateRef: BrowserRouterStateRef,\n  ): () => void;\n  beginPendingBrowserRouterState(): PendingBrowserRouterState;\n  finalizeNavigation(navId: number, pending: PendingBrowserRouterState | null | undefined): void;\n  renderNavigationPayload(options: {\n    actionType: \"navigate\" | \"replace\" | \"traverse\";\n    createNavigationCommitEffect: BrowserNavigationCommitEffectFactory;\n    historyUpdateMode: HistoryUpdateMode | undefined;\n    navigationSnapshot: ClientNavigationRenderSnapshot;\n    nextElements: Promise<AppElements>;\n    operationLane: OperationLane;\n    params: Record<string, string | string[]>;\n    pendingRouterState: PendingBrowserRouterState | null;\n    previousNextUrl: string | null;\n    targetHistoryIndex?: number | null;\n    targetHref: string;\n    navId: number;\n  }): Promise<NavigationPayloadOutcome>;\n  commitSameUrlNavigatePayload(\n    nextElements: Promise<AppElements>,\n    navigationSnapshot: ClientNavigationRenderSnapshot,\n    returnValue?: { ok: boolean; data: unknown },\n    actionInitiationState?: AppRouterState,\n    lifecycleOptions?: SameUrlServerActionLifecycleOptions,\n  ): Promise<unknown>;\n  hmrReplaceTree(\n    nextElements: Promise<AppElements>,\n    navigationSnapshot: ClientNavigationRenderSnapshot,\n  ): Promise<void>;\n  /**\n   * Force-drain the queued pre-paint effect for the given renderId without\n   * waiting for NavigationCommitSignal to commit. Used by the dev recovery\n   * boundary in app-browser-entry.ts: when a render error replaces\n   * NavigationCommitSignal with the boundary's null fallback, its\n   * useLayoutEffect never fires, so the URL update for the in-flight\n   * navigation would otherwise be lost.\n   */\n  drainPrePaintEffects(renderId: number): void;\n  NavigationCommitSignal(\n    this: void,\n    {\n      renderId,\n      children,\n    }: {\n      renderId: number;\n      children?: ReactNode;\n    },\n  ): ReactNode;\n};\n\nconst HARD_NAVIGATION_LOOP_GUARD_KEY = \"__vinext_hard_navigation_target__\";\n\nfunction normalizeBrowserHref(href: string): string {\n  try {\n    return new URL(href, window.location.href).href;\n  } catch {\n    return href;\n  }\n}\n\nfunction readHardNavigationLoopGuard(): string | null {\n  try {\n    return window.sessionStorage.getItem(HARD_NAVIGATION_LOOP_GUARD_KEY);\n  } catch {\n    return null;\n  }\n}\n\nfunction writeHardNavigationLoopGuard(targetHref: string): boolean {\n  try {\n    window.sessionStorage.setItem(HARD_NAVIGATION_LOOP_GUARD_KEY, targetHref);\n    return window.sessionStorage.getItem(HARD_NAVIGATION_LOOP_GUARD_KEY) === targetHref;\n  } catch {\n    return false;\n  }\n}\n\nexport function clearHardNavigationLoopGuard(): void {\n  try {\n    window.sessionStorage.removeItem(HARD_NAVIGATION_LOOP_GUARD_KEY);\n  } catch {}\n}\n\nfunction performHardNavigationWithLoopGuard(\n  href: string,\n  mode: HardNavigationMode = \"assign\",\n): boolean {\n  const targetHref = normalizeBrowserHref(href);\n  const currentHref = normalizeBrowserHref(window.location.href);\n\n  if (readHardNavigationLoopGuard() === targetHref && currentHref === targetHref) {\n    clearHardNavigationLoopGuard();\n    console.error(\n      `[vinext] Prevented repeated hard navigation to ${targetHref}; ` +\n        \"leaving the current document in place to avoid a reload loop.\",\n    );\n    return false;\n  }\n\n  const guardPersisted = writeHardNavigationLoopGuard(targetHref);\n  if (!guardPersisted && currentHref === targetHref) {\n    console.error(\n      `[vinext] Hard navigation to ${targetHref} requires a reload-loop guard, ` +\n        \"but sessionStorage is unavailable; leaving the current document in place.\",\n    );\n    return false;\n  }\n  // If storage is unavailable but the target is a different URL, the browser\n  // can still make forward progress. Only same-target reloads need a persisted\n  // guard because they can re-enter this exact recovery path indefinitely.\n\n  if (mode === \"replace\") {\n    window.location.replace(href);\n  } else {\n    window.location.assign(href);\n  }\n  return true;\n}\n\nexport function createAppBrowserNavigationController(\n  deps: BrowserNavigationControllerDeps = {},\n): BrowserNavigationController {\n  const commitClientNavigationStateImpl =\n    deps.commitClientNavigationState ?? commitClientNavigationState;\n  const performHardNavigation = deps.performHardNavigation ?? performHardNavigationWithLoopGuard;\n  const getRouteManifest = deps.getRouteManifest ?? (() => null);\n  const syncHistoryStatePreviousNextUrl = deps.syncHistoryStatePreviousNextUrl ?? (() => {});\n\n  // These are plain module-level variables (inside the controller closure),\n  // unlike ClientNavigationState which uses Symbol.for to survive multiple\n  // Vite module instances. The browser entry is loaded exactly once (via the\n  // RSC plugin's generated bootstrap), so the controller running in a single\n  // module instance is safe. If that assumption ever changes, these should be\n  // migrated to a Symbol.for-backed global.\n  //\n  // The most severe consequence of multiple instances would be Map fragmentation:\n  // pendingNavigationCommits and pendingNavigationPrePaintEffects would split\n  // across instances, so drainPrePaintEffects in one instance could never drain\n  // effects queued by the other, permanently leaking navigationSnapshotActiveCount\n  // and causing hooks to prefer stale snapshot values indefinitely.\n  let nextNavigationRenderId = 0;\n  let activeNavigationId = 0;\n  const pendingNavigationCommits = new Map<number, () => void>();\n  const pendingNavigationPrePaintEffects = new Map<number, () => void>();\n\n  let setBrowserRouterState: Dispatch<AppRouterState | Promise<AppRouterState>> | null = null;\n  let browserRouterStateRef: BrowserRouterStateRef | null = null;\n  let activePendingBrowserRouterState: PendingBrowserRouterState | null = null;\n  let resolveBrowserRouterStateReady: (() => void) | null = null;\n  let browserRouterStateReadyPromise: Promise<void> | null = null;\n  let browserRouterStateHasCommitted = false;\n\n  function getBrowserRouterStateSetter(): Dispatch<AppRouterState | Promise<AppRouterState>> {\n    if (!setBrowserRouterState) {\n      throw new Error(\"[vinext] Browser router state setter is not initialized\");\n    }\n    return setBrowserRouterState;\n  }\n\n  function getBrowserRouterState(): AppRouterState {\n    if (!browserRouterStateRef) {\n      throw new Error(\"[vinext] Browser router state is not initialized\");\n    }\n    return browserRouterStateRef.current;\n  }\n\n  function waitForBrowserRouterStateReady(): Promise<void> {\n    if (browserRouterStateRef || browserRouterStateHasCommitted) {\n      return Promise.resolve();\n    }\n\n    if (!browserRouterStateReadyPromise) {\n      browserRouterStateReadyPromise = new Promise((resolve) => {\n        resolveBrowserRouterStateReady = resolve;\n      });\n    }\n\n    return browserRouterStateReadyPromise;\n  }\n\n  function markBrowserRouterStateReady(): void {\n    browserRouterStateHasCommitted = true;\n    const resolveReady = resolveBrowserRouterStateReady;\n    resolveBrowserRouterStateReady = null;\n    browserRouterStateReadyPromise = null;\n    resolveReady?.();\n  }\n\n  function beginNavigation(): number {\n    activeNavigationId += 1;\n    return activeNavigationId;\n  }\n\n  function getActiveNavigationId(): number {\n    return activeNavigationId;\n  }\n\n  function allocateRenderId(): number {\n    nextNavigationRenderId += 1;\n    return nextNavigationRenderId;\n  }\n\n  function hasBrowserRouterState(): boolean {\n    return browserRouterStateRef !== null;\n  }\n\n  function isCurrentNavigation(navId: number): boolean {\n    return navId === activeNavigationId;\n  }\n\n  function beginPendingBrowserRouterState(): PendingBrowserRouterState {\n    const setter = getBrowserRouterStateSetter();\n\n    if (activePendingBrowserRouterState && !activePendingBrowserRouterState.settled) {\n      activePendingBrowserRouterState.settled = true;\n      activePendingBrowserRouterState.resolve(getBrowserRouterState());\n    }\n\n    let resolvePending: ((state: AppRouterState) => void) | undefined;\n    const promise = new Promise<AppRouterState>((resolve) => {\n      resolvePending = resolve;\n    });\n\n    if (!resolvePending) {\n      throw new Error(\"[vinext] Failed to initialize browser router promise\");\n    }\n\n    const pending: PendingBrowserRouterState = {\n      promise,\n      resolve: resolvePending,\n      settled: false,\n    };\n\n    activePendingBrowserRouterState = pending;\n    setter(promise);\n\n    return pending;\n  }\n\n  function settlePendingBrowserRouterState(\n    pending: PendingBrowserRouterState | null | undefined,\n  ): void {\n    if (!pending || pending.settled) return;\n\n    pending.settled = true;\n    pending.resolve(getBrowserRouterState());\n\n    if (activePendingBrowserRouterState === pending) {\n      activePendingBrowserRouterState = null;\n    }\n  }\n\n  function finalizeNavigation(\n    navId: number,\n    pending: PendingBrowserRouterState | null | undefined,\n  ): void {\n    settlePendingBrowserRouterState(pending);\n\n    if (isCurrentNavigation(navId)) {\n      clearPendingPathname(navId);\n    }\n  }\n\n  function resolvePendingBrowserRouterState(\n    pending: PendingBrowserRouterState | null | undefined,\n    commit: ApprovedVisibleCommit,\n  ): void {\n    if (!pending || pending.settled) return;\n\n    pending.settled = true;\n    pending.resolve(applyApprovedVisibleCommit(getBrowserRouterState(), commit));\n\n    if (activePendingBrowserRouterState === pending) {\n      activePendingBrowserRouterState = null;\n    }\n  }\n\n  function queuePrePaintNavigationEffect(renderId: number, effect: (() => void) | null): void {\n    if (!effect) {\n      return;\n    }\n    pendingNavigationPrePaintEffects.set(renderId, effect);\n  }\n\n  /**\n   * Run all queued pre-paint effects for renderIds up to and including the\n   * given renderId. When React supersedes a startTransition update (rapid\n   * clicks on same-route links), the superseded NavigationCommitSignal never\n   * mounts, so its pre-paint effect never fires. By draining all effects\n   * <= the committed renderId here, the winning transition cleans up after\n   * any superseded ones, keeping the counter balanced.\n   *\n   * Invariant: each superseded navigation gets a commitClientNavigationState()\n   * to balance the activateNavigationSnapshot() from its renderNavigationPayload call.\n   */\n  function drainPrePaintEffects(upToRenderId: number): void {\n    for (const [id, effect] of pendingNavigationPrePaintEffects) {\n      if (id > upToRenderId) {\n        continue;\n      }\n\n      pendingNavigationPrePaintEffects.delete(id);\n      if (id === upToRenderId) {\n        effect();\n      } else {\n        // Superseded navigations still need to balance the snapshot counter.\n        commitClientNavigationStateImpl(undefined, { releaseSnapshot: true });\n      }\n    }\n  }\n\n  /**\n   * Resolve all pending navigation commits with renderId <= the committed renderId.\n   * Note: Map iteration handles concurrent deletion safely — entries are visited in\n   * insertion order and deletion doesn't affect the iterator's view of remaining entries.\n   * This pattern is also used in drainPrePaintEffects with the same semantics.\n   */\n  function resolveCommittedNavigations(renderId: number): void {\n    for (const [pendingId, resolve] of pendingNavigationCommits) {\n      if (pendingId > renderId) {\n        continue;\n      }\n\n      pendingNavigationCommits.delete(pendingId);\n      resolve();\n    }\n  }\n\n  async function hmrReplaceTree(\n    nextElements: Promise<AppElements>,\n    navigationSnapshot: ClientNavigationRenderSnapshot,\n  ): Promise<void> {\n    if (!hasBrowserRouterState()) return;\n\n    const currentState = getBrowserRouterState();\n    const renderId = allocateRenderId();\n    const pending = await createPendingNavigationCommit({\n      currentState,\n      nextElements,\n      navigationSnapshot,\n      operationLane: \"hmr\",\n      renderId,\n      type: \"replace\",\n    });\n\n    // createPendingNavigationCommit awaits the new RSC payload. While\n    // suspended, the prior broken render can unmount BrowserRoot. Re-check\n    // before dispatching so a racing unmount doesn't surface as an\n    // initialized-setter error.\n    if (!hasBrowserRouterState()) return;\n\n    dispatchSynchronousVisibleCommit(approveHmrVisibleCommit(pending));\n  }\n\n  function NavigationCommitSignal(\n    this: void,\n    {\n      renderId,\n      children,\n    }: {\n      renderId: number;\n      children?: ReactNode;\n    },\n  ): ReactNode {\n    useLayoutEffect(() => {\n      drainPrePaintEffects(renderId);\n\n      const frame = requestAnimationFrame(() => {\n        resolveCommittedNavigations(renderId);\n      });\n\n      return () => {\n        cancelAnimationFrame(frame);\n        // Resolve pending commits to prevent callers from hanging if React\n        // unmounts this component without committing (e.g., error boundary).\n        resolveCommittedNavigations(renderId);\n      };\n    }, [renderId]);\n\n    return children;\n  }\n\n  function dispatchApprovedVisibleCommit(\n    commit: ApprovedVisibleCommit,\n    pendingRouterState: PendingBrowserRouterState | null,\n  ): void {\n    const setter = getBrowserRouterStateSetter();\n\n    if (pendingRouterState) {\n      // The programmatic navigation is already running inside React.startTransition\n      // (from router.push/replace/refresh/Link), so resolving the deferred promise\n      // is sufficient.\n      resolvePendingBrowserRouterState(pendingRouterState, commit);\n      return;\n    }\n\n    startTransition(() => {\n      setter(applyApprovedVisibleCommit(getBrowserRouterState(), commit));\n    });\n  }\n\n  function dispatchSynchronousVisibleCommit(commit: ApprovedVisibleCommit): void {\n    const setter = getBrowserRouterStateSetter();\n    setter(applyApprovedVisibleCommit(getBrowserRouterState(), commit));\n  }\n\n  function notifyDiscardedServerActionRevalidation(\n    lifecycleOptions: SameUrlServerActionLifecycleOptions | undefined,\n  ): void {\n    const revalidation = lifecycleOptions?.revalidation ?? \"none\";\n    if (!shouldScheduleRefreshForDiscardedServerAction(revalidation)) return;\n\n    lifecycleOptions?.onDiscardedRevalidation?.();\n  }\n\n  async function renderNavigationPayload(options: {\n    actionType: \"navigate\" | \"replace\" | \"traverse\";\n    createNavigationCommitEffect: BrowserNavigationCommitEffectFactory;\n    historyUpdateMode: HistoryUpdateMode | undefined;\n    navigationSnapshot: ClientNavigationRenderSnapshot;\n    nextElements: Promise<AppElements>;\n    operationLane: OperationLane;\n    params: Record<string, string | string[]>;\n    pendingRouterState: PendingBrowserRouterState | null;\n    previousNextUrl: string | null;\n    targetHistoryIndex?: number | null;\n    targetHref: string;\n    navId: number;\n  }): Promise<NavigationPayloadOutcome> {\n    const renderId = allocateRenderId();\n    let resolveCommitted: (() => void) | undefined;\n    const committed = new Promise<void>((resolve) => {\n      resolveCommitted = resolve;\n      pendingNavigationCommits.set(renderId, resolve);\n    });\n\n    let snapshotActivated = false;\n    try {\n      const startedState = getBrowserRouterState();\n      const pending = await createPendingNavigationCommit({\n        currentState: startedState,\n        nextElements: options.nextElements,\n        navigationSnapshot: options.navigationSnapshot,\n        operationLane: options.operationLane,\n        previousNextUrl: options.previousNextUrl,\n        renderId,\n        type: options.actionType,\n      });\n\n      const approval = approvePendingNavigationCommit({\n        activeNavigationId,\n        currentState: getBrowserRouterState(),\n        pending,\n        routeManifest: getRouteManifest(),\n        startedNavigationId: options.navId,\n        targetHref: options.targetHref,\n      });\n\n      if (approval.decision.disposition === \"no-commit\") {\n        settlePendingBrowserRouterState(options.pendingRouterState);\n        pendingNavigationCommits.delete(renderId);\n        resolveCommitted?.();\n        return \"no-commit\";\n      }\n\n      if (approval.decision.disposition === \"hard-navigate\") {\n        settlePendingBrowserRouterState(options.pendingRouterState);\n        pendingNavigationCommits.delete(renderId);\n        return performHardNavigation(options.targetHref) ? \"hard-navigate\" : \"no-commit\";\n      }\n\n      const approvedCommit = approval.approvedCommit;\n      if (approvedCommit === null) {\n        throw new Error(\"[vinext] Commit decision did not approve a visible commit\");\n      }\n\n      queuePrePaintNavigationEffect(\n        renderId,\n        options.createNavigationCommitEffect({\n          href: options.targetHref,\n          historyUpdateMode: options.historyUpdateMode,\n          navId: options.navId,\n          params: options.params,\n          previousNextUrl: approvedCommit.previousNextUrl,\n          targetHistoryIndex: options.targetHistoryIndex,\n        }),\n      );\n      activateNavigationSnapshot();\n      snapshotActivated = true;\n      dispatchApprovedVisibleCommit(approvedCommit, options.pendingRouterState);\n    } catch (error) {\n      pendingNavigationPrePaintEffects.delete(renderId);\n      pendingNavigationCommits.delete(renderId);\n      if (snapshotActivated) {\n        commitClientNavigationStateImpl(options.navId);\n      }\n      settlePendingBrowserRouterState(options.pendingRouterState);\n      resolveCommitted?.();\n      throw error;\n    }\n\n    return committed.then(() => \"committed\");\n  }\n\n  async function commitSameUrlNavigatePayload(\n    nextElements: Promise<AppElements>,\n    navigationSnapshot: ClientNavigationRenderSnapshot,\n    returnValue?: { ok: boolean; data: unknown },\n    actionInitiationState?: AppRouterState,\n    lifecycleOptions?: SameUrlServerActionLifecycleOptions,\n  ): Promise<unknown> {\n    const currentState = actionInitiationState ?? getBrowserRouterState();\n    const startedNavigationId = lifecycleOptions?.startedNavigationId ?? activeNavigationId;\n    const targetHref = lifecycleOptions?.targetHref ?? window.location.href;\n    const {\n      approvedCommit,\n      decision,\n      pending,\n      // Intentionally retained as #726-OPS-01 trace-shell scaffolding. The\n      // same-URL action path can consume this trace once later lifecycle gates\n      // need an observable commit explanation.\n      trace: _navigationTrace,\n    } = await resolveAndClassifyNavigationCommit({\n      activeNavigationId,\n      currentState,\n      getActiveNavigationId: () => activeNavigationId,\n      getCurrentStateForApproval: getBrowserRouterState,\n      navigationSnapshot,\n      nextElements,\n      renderId: allocateRenderId(),\n      operationLane: \"server-action\",\n      startedNavigationId,\n      routeManifest: getRouteManifest(),\n      targetHref,\n      type: \"navigate\",\n    });\n\n    if (decision.disposition === \"hard-navigate\") {\n      // Same-URL action hard navigations do not expose a navigation outcome to\n      // callers. If the loop guard blocks, the degraded state is still the\n      // existing return contract: no visible commit and no action value.\n      performHardNavigation(targetHref);\n      return undefined;\n    }\n\n    if (approvedCommit) {\n      // The helper approval and this continuation are separated by a microtask\n      // boundary, so re-check lifecycle authority before mutating visible UI.\n      const latestApproval = approvePendingNavigationCommit({\n        activeNavigationId,\n        currentState: getBrowserRouterState(),\n        pending,\n        routeManifest: getRouteManifest(),\n        startedNavigationId,\n        targetHref,\n      });\n\n      if (latestApproval.decision.disposition === \"hard-navigate\") {\n        // See the same-URL hard-navigation note above. The guard result is\n        // deliberately not surfaced through the server-action return channel.\n        performHardNavigation(targetHref);\n        return undefined;\n      }\n\n      if (latestApproval.approvedCommit) {\n        dispatchSynchronousVisibleCommit(latestApproval.approvedCommit);\n        syncHistoryStatePreviousNextUrl(latestApproval.approvedCommit.previousNextUrl);\n      } else {\n        notifyDiscardedServerActionRevalidation(lifecycleOptions);\n      }\n    } else if (decision.disposition === \"no-commit\") {\n      notifyDiscardedServerActionRevalidation(lifecycleOptions);\n    }\n\n    // Same-URL server actions still return their action value even if the UI\n    // update was skipped due to a superseding navigation. That preserves the\n    // existing caller contract; a future Phase 2 router state model could make\n    // skipped UI updates observable to the caller without conflating them here.\n    if (returnValue) {\n      if (!returnValue.ok) {\n        throw returnValue.data;\n      }\n      return returnValue.data;\n    }\n\n    return undefined;\n  }\n\n  function attachBrowserRouterState(\n    setter: Dispatch<AppRouterState | Promise<AppRouterState>>,\n    stateRef: BrowserRouterStateRef,\n  ): () => void {\n    setBrowserRouterState = setter;\n    browserRouterStateRef = stateRef;\n    markBrowserRouterStateReady();\n\n    return () => {\n      if (setBrowserRouterState === setter) {\n        setBrowserRouterState = null;\n      }\n      if (browserRouterStateRef === stateRef) {\n        browserRouterStateRef = null;\n        browserRouterStateHasCommitted = false;\n      }\n    };\n  }\n\n  return {\n    beginNavigation,\n    getActiveNavigationId,\n    hasBrowserRouterState,\n    getBrowserRouterState,\n    isCurrentNavigation,\n    waitForBrowserRouterStateReady,\n    attachBrowserRouterState,\n    beginPendingBrowserRouterState,\n    finalizeNavigation,\n    renderNavigationPayload,\n    commitSameUrlNavigatePayload,\n    hmrReplaceTree,\n    drainPrePaintEffects,\n    NavigationCommitSignal,\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"app-browser-navigation-controller.js","names":[],"sources":["../../src/server/app-browser-navigation-controller.ts"],"sourcesContent":["import { startTransition, useLayoutEffect, type Dispatch, type ReactNode } from \"react\";\nimport {\n  activateNavigationSnapshot,\n  clearPendingPathname,\n  commitClientNavigationState,\n} from \"vinext/shims/navigation\";\nimport type { ClientNavigationRenderSnapshot } from \"vinext/shims/navigation\";\nimport type { RouteManifest } from \"../routing/app-route-graph.js\";\nimport {\n  FRESH_APP_NAVIGATION_PAYLOAD_ORIGIN,\n  createPendingNavigationCommit,\n  type AppNavigationPayloadOrigin,\n  type AppRouterState,\n  type OperationLane,\n} from \"./app-browser-state.js\";\nimport {\n  applyApprovedVisibleCommit,\n  approveHmrVisibleCommit,\n  approvePendingNavigationCommit,\n  resolveAndClassifyNavigationCommit,\n  type ApprovedVisibleCommit,\n} from \"./app-browser-visible-commit.js\";\nimport {\n  shouldScheduleRefreshForDiscardedServerAction,\n  type ServerActionRevalidationKind,\n} from \"./app-browser-action-result.js\";\nimport type { AppElements } from \"./app-elements.js\";\n\nexport type HistoryUpdateMode = \"push\" | \"replace\";\n\nexport type PendingBrowserRouterState = {\n  promise: Promise<AppRouterState>;\n  resolve: (state: AppRouterState) => void;\n  settled: boolean;\n};\nexport type NavigationPayloadOutcome = \"committed\" | \"no-commit\" | \"hard-navigate\";\ntype HardNavigationMode = \"assign\" | \"replace\";\n\ntype BrowserNavigationCommitEffectFactory = (options: {\n  href: string;\n  historyUpdateMode: HistoryUpdateMode | undefined;\n  navId: number;\n  params: Record<string, string | string[]>;\n  previousNextUrl: string | null;\n  targetHistoryIndex?: number | null;\n}) => () => void;\n\ntype BrowserRouterStateRef = {\n  current: AppRouterState;\n};\n\ntype SameUrlServerActionLifecycleOptions = {\n  onDiscardedRevalidation?: () => void;\n  revalidation?: ServerActionRevalidationKind;\n  startedNavigationId?: number;\n  targetHref?: string;\n};\n\ntype BrowserNavigationControllerDeps = {\n  commitClientNavigationState?: typeof commitClientNavigationState;\n  performHardNavigation?: (href: string, mode?: HardNavigationMode) => boolean;\n  getRouteManifest?: () => RouteManifest | null;\n  syncHistoryStatePreviousNextUrl?: (previousNextUrl: string | null) => void;\n};\n\ntype BrowserNavigationController = {\n  beginNavigation(): number;\n  getActiveNavigationId(): number;\n  hasBrowserRouterState(): boolean;\n  getBrowserRouterState(): AppRouterState;\n  isCurrentNavigation(navId: number): boolean;\n  performHardNavigation(href: string, mode?: HardNavigationMode): boolean;\n  waitForBrowserRouterStateReady(): Promise<void>;\n  attachBrowserRouterState(\n    setter: Dispatch<AppRouterState | Promise<AppRouterState>>,\n    stateRef: BrowserRouterStateRef,\n  ): () => void;\n  beginPendingBrowserRouterState(): PendingBrowserRouterState;\n  finalizeNavigation(navId: number, pending: PendingBrowserRouterState | null | undefined): void;\n  renderNavigationPayload(options: {\n    actionType: \"navigate\" | \"replace\" | \"traverse\";\n    createNavigationCommitEffect: BrowserNavigationCommitEffectFactory;\n    historyUpdateMode: HistoryUpdateMode | undefined;\n    navigationSnapshot: ClientNavigationRenderSnapshot;\n    nextElements: Promise<AppElements>;\n    operationLane: OperationLane;\n    payloadOrigin: AppNavigationPayloadOrigin;\n    params: Record<string, string | string[]>;\n    pendingRouterState: PendingBrowserRouterState | null;\n    previousNextUrl: string | null;\n    targetHistoryIndex?: number | null;\n    targetHref: string;\n    navId: number;\n  }): Promise<NavigationPayloadOutcome>;\n  commitSameUrlNavigatePayload(\n    nextElements: Promise<AppElements>,\n    navigationSnapshot: ClientNavigationRenderSnapshot,\n    returnValue?: { ok: boolean; data: unknown },\n    actionInitiationState?: AppRouterState,\n    lifecycleOptions?: SameUrlServerActionLifecycleOptions,\n  ): Promise<unknown>;\n  hmrReplaceTree(\n    nextElements: Promise<AppElements>,\n    navigationSnapshot: ClientNavigationRenderSnapshot,\n  ): Promise<void>;\n  /**\n   * Force-drain the queued pre-paint effect for the given renderId without\n   * waiting for NavigationCommitSignal to commit. Used by the dev recovery\n   * boundary in app-browser-entry.ts: when a render error replaces\n   * NavigationCommitSignal with the boundary's null fallback, its\n   * useLayoutEffect never fires, so the URL update for the in-flight\n   * navigation would otherwise be lost.\n   */\n  drainPrePaintEffects(renderId: number): void;\n  NavigationCommitSignal(\n    this: void,\n    {\n      renderId,\n      children,\n    }: {\n      renderId: number;\n      children?: ReactNode;\n    },\n  ): ReactNode;\n};\n\nconst HARD_NAVIGATION_LOOP_GUARD_KEY = \"__vinext_hard_navigation_target__\";\n\nfunction normalizeBrowserHref(href: string): string {\n  try {\n    return new URL(href, window.location.href).href;\n  } catch {\n    return href;\n  }\n}\n\nfunction readHardNavigationLoopGuard(): string | null {\n  try {\n    return window.sessionStorage.getItem(HARD_NAVIGATION_LOOP_GUARD_KEY);\n  } catch {\n    return null;\n  }\n}\n\nfunction writeHardNavigationLoopGuard(targetHref: string): boolean {\n  try {\n    window.sessionStorage.setItem(HARD_NAVIGATION_LOOP_GUARD_KEY, targetHref);\n    return window.sessionStorage.getItem(HARD_NAVIGATION_LOOP_GUARD_KEY) === targetHref;\n  } catch {\n    return false;\n  }\n}\n\nexport function clearHardNavigationLoopGuard(): void {\n  try {\n    window.sessionStorage.removeItem(HARD_NAVIGATION_LOOP_GUARD_KEY);\n  } catch {}\n}\n\nfunction performHardNavigationWithLoopGuard(\n  href: string,\n  mode: HardNavigationMode = \"assign\",\n): boolean {\n  const targetHref = normalizeBrowserHref(href);\n  const currentHref = normalizeBrowserHref(window.location.href);\n\n  if (readHardNavigationLoopGuard() === targetHref && currentHref === targetHref) {\n    clearHardNavigationLoopGuard();\n    console.error(\n      `[vinext] Prevented repeated hard navigation to ${targetHref}; ` +\n        \"leaving the current document in place to avoid a reload loop.\",\n    );\n    return false;\n  }\n\n  const guardPersisted = writeHardNavigationLoopGuard(targetHref);\n  if (!guardPersisted && currentHref === targetHref) {\n    console.error(\n      `[vinext] Hard navigation to ${targetHref} requires a reload-loop guard, ` +\n        \"but sessionStorage is unavailable; leaving the current document in place.\",\n    );\n    return false;\n  }\n  // If storage is unavailable but the target is a different URL, the browser\n  // can still make forward progress. Only same-target reloads need a persisted\n  // guard because they can re-enter this exact recovery path indefinitely.\n\n  if (mode === \"replace\") {\n    window.location.replace(href);\n  } else {\n    window.location.assign(href);\n  }\n  return true;\n}\n\nexport function createAppBrowserNavigationController(\n  deps: BrowserNavigationControllerDeps = {},\n): BrowserNavigationController {\n  const commitClientNavigationStateImpl =\n    deps.commitClientNavigationState ?? commitClientNavigationState;\n  const performHardNavigation = deps.performHardNavigation ?? performHardNavigationWithLoopGuard;\n  const getRouteManifest = deps.getRouteManifest ?? (() => null);\n  const syncHistoryStatePreviousNextUrl = deps.syncHistoryStatePreviousNextUrl ?? (() => {});\n\n  // These are plain module-level variables (inside the controller closure),\n  // unlike ClientNavigationState which uses Symbol.for to survive multiple\n  // Vite module instances. The browser entry is loaded exactly once (via the\n  // RSC plugin's generated bootstrap), so the controller running in a single\n  // module instance is safe. If that assumption ever changes, these should be\n  // migrated to a Symbol.for-backed global.\n  //\n  // The most severe consequence of multiple instances would be Map fragmentation:\n  // pendingNavigationCommits and pendingNavigationPrePaintEffects would split\n  // across instances, so drainPrePaintEffects in one instance could never drain\n  // effects queued by the other, permanently leaking navigationSnapshotActiveCount\n  // and causing hooks to prefer stale snapshot values indefinitely.\n  let nextNavigationRenderId = 0;\n  let activeNavigationId = 0;\n  const pendingNavigationCommits = new Map<number, () => void>();\n  const pendingNavigationPrePaintEffects = new Map<number, () => void>();\n\n  let setBrowserRouterState: Dispatch<AppRouterState | Promise<AppRouterState>> | null = null;\n  let browserRouterStateRef: BrowserRouterStateRef | null = null;\n  let activePendingBrowserRouterState: PendingBrowserRouterState | null = null;\n  let resolveBrowserRouterStateReady: (() => void) | null = null;\n  let browserRouterStateReadyPromise: Promise<void> | null = null;\n  let browserRouterStateHasCommitted = false;\n\n  function getBrowserRouterStateSetter(): Dispatch<AppRouterState | Promise<AppRouterState>> {\n    if (!setBrowserRouterState) {\n      throw new Error(\"[vinext] Browser router state setter is not initialized\");\n    }\n    return setBrowserRouterState;\n  }\n\n  function getBrowserRouterState(): AppRouterState {\n    if (!browserRouterStateRef) {\n      throw new Error(\"[vinext] Browser router state is not initialized\");\n    }\n    return browserRouterStateRef.current;\n  }\n\n  function waitForBrowserRouterStateReady(): Promise<void> {\n    if (browserRouterStateRef || browserRouterStateHasCommitted) {\n      return Promise.resolve();\n    }\n\n    if (!browserRouterStateReadyPromise) {\n      browserRouterStateReadyPromise = new Promise((resolve) => {\n        resolveBrowserRouterStateReady = resolve;\n      });\n    }\n\n    return browserRouterStateReadyPromise;\n  }\n\n  function markBrowserRouterStateReady(): void {\n    browserRouterStateHasCommitted = true;\n    const resolveReady = resolveBrowserRouterStateReady;\n    resolveBrowserRouterStateReady = null;\n    browserRouterStateReadyPromise = null;\n    resolveReady?.();\n  }\n\n  function beginNavigation(): number {\n    activeNavigationId += 1;\n    return activeNavigationId;\n  }\n\n  function getActiveNavigationId(): number {\n    return activeNavigationId;\n  }\n\n  function allocateRenderId(): number {\n    nextNavigationRenderId += 1;\n    return nextNavigationRenderId;\n  }\n\n  function hasBrowserRouterState(): boolean {\n    return browserRouterStateRef !== null;\n  }\n\n  function isCurrentNavigation(navId: number): boolean {\n    return navId === activeNavigationId;\n  }\n\n  function beginPendingBrowserRouterState(): PendingBrowserRouterState {\n    const setter = getBrowserRouterStateSetter();\n\n    if (activePendingBrowserRouterState && !activePendingBrowserRouterState.settled) {\n      activePendingBrowserRouterState.settled = true;\n      activePendingBrowserRouterState.resolve(getBrowserRouterState());\n    }\n\n    let resolvePending: ((state: AppRouterState) => void) | undefined;\n    const promise = new Promise<AppRouterState>((resolve) => {\n      resolvePending = resolve;\n    });\n\n    if (!resolvePending) {\n      throw new Error(\"[vinext] Failed to initialize browser router promise\");\n    }\n\n    const pending: PendingBrowserRouterState = {\n      promise,\n      resolve: resolvePending,\n      settled: false,\n    };\n\n    activePendingBrowserRouterState = pending;\n    setter(promise);\n\n    return pending;\n  }\n\n  function settlePendingBrowserRouterState(\n    pending: PendingBrowserRouterState | null | undefined,\n  ): void {\n    if (!pending || pending.settled) return;\n\n    pending.settled = true;\n    pending.resolve(getBrowserRouterState());\n\n    if (activePendingBrowserRouterState === pending) {\n      activePendingBrowserRouterState = null;\n    }\n  }\n\n  function finalizeNavigation(\n    navId: number,\n    pending: PendingBrowserRouterState | null | undefined,\n  ): void {\n    settlePendingBrowserRouterState(pending);\n\n    if (isCurrentNavigation(navId)) {\n      clearPendingPathname(navId);\n    }\n  }\n\n  function resolvePendingBrowserRouterState(\n    pending: PendingBrowserRouterState | null | undefined,\n    commit: ApprovedVisibleCommit,\n  ): void {\n    if (!pending || pending.settled) return;\n\n    pending.settled = true;\n    pending.resolve(applyApprovedVisibleCommit(getBrowserRouterState(), commit));\n\n    if (activePendingBrowserRouterState === pending) {\n      activePendingBrowserRouterState = null;\n    }\n  }\n\n  function queuePrePaintNavigationEffect(renderId: number, effect: (() => void) | null): void {\n    if (!effect) {\n      return;\n    }\n    pendingNavigationPrePaintEffects.set(renderId, effect);\n  }\n\n  /**\n   * Run all queued pre-paint effects for renderIds up to and including the\n   * given renderId. When React supersedes a startTransition update (rapid\n   * clicks on same-route links), the superseded NavigationCommitSignal never\n   * mounts, so its pre-paint effect never fires. By draining all effects\n   * <= the committed renderId here, the winning transition cleans up after\n   * any superseded ones, keeping the counter balanced.\n   *\n   * Invariant: each superseded navigation gets a commitClientNavigationState()\n   * to balance the activateNavigationSnapshot() from its renderNavigationPayload call.\n   */\n  function drainPrePaintEffects(upToRenderId: number): void {\n    for (const [id, effect] of pendingNavigationPrePaintEffects) {\n      if (id > upToRenderId) {\n        continue;\n      }\n\n      pendingNavigationPrePaintEffects.delete(id);\n      if (id === upToRenderId) {\n        effect();\n      } else {\n        // Superseded navigations still need to balance the snapshot counter.\n        commitClientNavigationStateImpl(undefined, { releaseSnapshot: true });\n      }\n    }\n  }\n\n  /**\n   * Resolve all pending navigation commits with renderId <= the committed renderId.\n   * Note: Map iteration handles concurrent deletion safely — entries are visited in\n   * insertion order and deletion doesn't affect the iterator's view of remaining entries.\n   * This pattern is also used in drainPrePaintEffects with the same semantics.\n   */\n  function resolveCommittedNavigations(renderId: number): void {\n    for (const [pendingId, resolve] of pendingNavigationCommits) {\n      if (pendingId > renderId) {\n        continue;\n      }\n\n      pendingNavigationCommits.delete(pendingId);\n      resolve();\n    }\n  }\n\n  async function hmrReplaceTree(\n    nextElements: Promise<AppElements>,\n    navigationSnapshot: ClientNavigationRenderSnapshot,\n  ): Promise<void> {\n    if (!hasBrowserRouterState()) return;\n\n    const currentState = getBrowserRouterState();\n    const renderId = allocateRenderId();\n    const pending = await createPendingNavigationCommit({\n      currentState,\n      nextElements,\n      navigationSnapshot,\n      operationLane: \"hmr\",\n      payloadOrigin: FRESH_APP_NAVIGATION_PAYLOAD_ORIGIN,\n      renderId,\n      type: \"replace\",\n    });\n\n    // createPendingNavigationCommit awaits the new RSC payload. While\n    // suspended, the prior broken render can unmount BrowserRoot. Re-check\n    // before dispatching so a racing unmount doesn't surface as an\n    // initialized-setter error.\n    if (!hasBrowserRouterState()) return;\n\n    dispatchSynchronousVisibleCommit(approveHmrVisibleCommit(pending));\n  }\n\n  function NavigationCommitSignal(\n    this: void,\n    {\n      renderId,\n      children,\n    }: {\n      renderId: number;\n      children?: ReactNode;\n    },\n  ): ReactNode {\n    useLayoutEffect(() => {\n      drainPrePaintEffects(renderId);\n\n      const frame = requestAnimationFrame(() => {\n        resolveCommittedNavigations(renderId);\n      });\n\n      return () => {\n        cancelAnimationFrame(frame);\n        // Resolve pending commits to prevent callers from hanging if React\n        // unmounts this component without committing (e.g., error boundary).\n        resolveCommittedNavigations(renderId);\n      };\n    }, [renderId]);\n\n    return children;\n  }\n\n  function dispatchApprovedVisibleCommit(\n    commit: ApprovedVisibleCommit,\n    pendingRouterState: PendingBrowserRouterState | null,\n  ): void {\n    const setter = getBrowserRouterStateSetter();\n\n    if (pendingRouterState) {\n      // The programmatic navigation is already running inside React.startTransition\n      // (from router.push/replace/refresh/Link), so resolving the deferred promise\n      // is sufficient.\n      resolvePendingBrowserRouterState(pendingRouterState, commit);\n      return;\n    }\n\n    startTransition(() => {\n      setter(applyApprovedVisibleCommit(getBrowserRouterState(), commit));\n    });\n  }\n\n  function dispatchSynchronousVisibleCommit(commit: ApprovedVisibleCommit): void {\n    const setter = getBrowserRouterStateSetter();\n    setter(applyApprovedVisibleCommit(getBrowserRouterState(), commit));\n  }\n\n  function notifyDiscardedServerActionRevalidation(\n    lifecycleOptions: SameUrlServerActionLifecycleOptions | undefined,\n  ): void {\n    const revalidation = lifecycleOptions?.revalidation ?? \"none\";\n    if (!shouldScheduleRefreshForDiscardedServerAction(revalidation)) return;\n\n    lifecycleOptions?.onDiscardedRevalidation?.();\n  }\n\n  async function renderNavigationPayload(options: {\n    actionType: \"navigate\" | \"replace\" | \"traverse\";\n    createNavigationCommitEffect: BrowserNavigationCommitEffectFactory;\n    historyUpdateMode: HistoryUpdateMode | undefined;\n    navigationSnapshot: ClientNavigationRenderSnapshot;\n    nextElements: Promise<AppElements>;\n    operationLane: OperationLane;\n    payloadOrigin: AppNavigationPayloadOrigin;\n    params: Record<string, string | string[]>;\n    pendingRouterState: PendingBrowserRouterState | null;\n    previousNextUrl: string | null;\n    targetHistoryIndex?: number | null;\n    targetHref: string;\n    navId: number;\n  }): Promise<NavigationPayloadOutcome> {\n    const renderId = allocateRenderId();\n    let resolveCommitted: (() => void) | undefined;\n    const committed = new Promise<void>((resolve) => {\n      resolveCommitted = resolve;\n      pendingNavigationCommits.set(renderId, resolve);\n    });\n\n    let snapshotActivated = false;\n    try {\n      const startedState = getBrowserRouterState();\n      const pending = await createPendingNavigationCommit({\n        currentState: startedState,\n        nextElements: options.nextElements,\n        navigationSnapshot: options.navigationSnapshot,\n        operationLane: options.operationLane,\n        payloadOrigin: options.payloadOrigin,\n        previousNextUrl: options.previousNextUrl,\n        renderId,\n        type: options.actionType,\n      });\n\n      const approval = approvePendingNavigationCommit({\n        activeNavigationId,\n        currentState: getBrowserRouterState(),\n        pending,\n        routeManifest: getRouteManifest(),\n        startedNavigationId: options.navId,\n        targetHref: options.targetHref,\n      });\n\n      if (approval.decision.disposition === \"no-commit\") {\n        settlePendingBrowserRouterState(options.pendingRouterState);\n        pendingNavigationCommits.delete(renderId);\n        resolveCommitted?.();\n        return \"no-commit\";\n      }\n\n      if (approval.decision.disposition === \"hard-navigate\") {\n        settlePendingBrowserRouterState(options.pendingRouterState);\n        pendingNavigationCommits.delete(renderId);\n        return performHardNavigation(options.targetHref) ? \"hard-navigate\" : \"no-commit\";\n      }\n\n      const approvedCommit = approval.approvedCommit;\n      if (approvedCommit === null) {\n        throw new Error(\"[vinext] Commit decision did not approve a visible commit\");\n      }\n\n      queuePrePaintNavigationEffect(\n        renderId,\n        options.createNavigationCommitEffect({\n          href: options.targetHref,\n          historyUpdateMode: options.historyUpdateMode,\n          navId: options.navId,\n          params: options.params,\n          previousNextUrl: approvedCommit.previousNextUrl,\n          targetHistoryIndex: options.targetHistoryIndex,\n        }),\n      );\n      activateNavigationSnapshot();\n      snapshotActivated = true;\n      dispatchApprovedVisibleCommit(approvedCommit, options.pendingRouterState);\n    } catch (error) {\n      pendingNavigationPrePaintEffects.delete(renderId);\n      pendingNavigationCommits.delete(renderId);\n      if (snapshotActivated) {\n        commitClientNavigationStateImpl(options.navId);\n      }\n      settlePendingBrowserRouterState(options.pendingRouterState);\n      resolveCommitted?.();\n      throw error;\n    }\n\n    return committed.then(() => \"committed\");\n  }\n\n  async function commitSameUrlNavigatePayload(\n    nextElements: Promise<AppElements>,\n    navigationSnapshot: ClientNavigationRenderSnapshot,\n    returnValue?: { ok: boolean; data: unknown },\n    actionInitiationState?: AppRouterState,\n    lifecycleOptions?: SameUrlServerActionLifecycleOptions,\n  ): Promise<unknown> {\n    const currentState = actionInitiationState ?? getBrowserRouterState();\n    const startedNavigationId = lifecycleOptions?.startedNavigationId ?? activeNavigationId;\n    const targetHref = lifecycleOptions?.targetHref ?? window.location.href;\n    const {\n      approvedCommit,\n      decision,\n      pending,\n      // Intentionally retained as #726-OPS-01 trace-shell scaffolding. The\n      // same-URL action path can consume this trace once later lifecycle gates\n      // need an observable commit explanation.\n      trace: _navigationTrace,\n    } = await resolveAndClassifyNavigationCommit({\n      activeNavigationId,\n      currentState,\n      getActiveNavigationId: () => activeNavigationId,\n      getCurrentStateForApproval: getBrowserRouterState,\n      navigationSnapshot,\n      nextElements,\n      renderId: allocateRenderId(),\n      operationLane: \"server-action\",\n      payloadOrigin: FRESH_APP_NAVIGATION_PAYLOAD_ORIGIN,\n      startedNavigationId,\n      routeManifest: getRouteManifest(),\n      targetHref,\n      type: \"navigate\",\n    });\n\n    if (decision.disposition === \"hard-navigate\") {\n      // Same-URL action hard navigations do not expose a navigation outcome to\n      // callers. If the loop guard blocks, the degraded state is still the\n      // existing return contract: no visible commit and no action value.\n      performHardNavigation(targetHref);\n      return undefined;\n    }\n\n    if (approvedCommit) {\n      // The helper approval and this continuation are separated by a microtask\n      // boundary, so re-check lifecycle authority before mutating visible UI.\n      const latestApproval = approvePendingNavigationCommit({\n        activeNavigationId,\n        currentState: getBrowserRouterState(),\n        pending,\n        routeManifest: getRouteManifest(),\n        startedNavigationId,\n        targetHref,\n      });\n\n      if (latestApproval.decision.disposition === \"hard-navigate\") {\n        // See the same-URL hard-navigation note above. The guard result is\n        // deliberately not surfaced through the server-action return channel.\n        performHardNavigation(targetHref);\n        return undefined;\n      }\n\n      if (latestApproval.approvedCommit) {\n        dispatchSynchronousVisibleCommit(latestApproval.approvedCommit);\n        syncHistoryStatePreviousNextUrl(latestApproval.approvedCommit.previousNextUrl);\n      } else {\n        notifyDiscardedServerActionRevalidation(lifecycleOptions);\n      }\n    } else if (decision.disposition === \"no-commit\") {\n      notifyDiscardedServerActionRevalidation(lifecycleOptions);\n    }\n\n    // Same-URL server actions still return their action value even if the UI\n    // update was skipped due to a superseding navigation. That preserves the\n    // existing caller contract; a future Phase 2 router state model could make\n    // skipped UI updates observable to the caller without conflating them here.\n    if (returnValue) {\n      if (!returnValue.ok) {\n        throw returnValue.data;\n      }\n      return returnValue.data;\n    }\n\n    return undefined;\n  }\n\n  function attachBrowserRouterState(\n    setter: Dispatch<AppRouterState | Promise<AppRouterState>>,\n    stateRef: BrowserRouterStateRef,\n  ): () => void {\n    setBrowserRouterState = setter;\n    browserRouterStateRef = stateRef;\n    markBrowserRouterStateReady();\n\n    return () => {\n      if (setBrowserRouterState === setter) {\n        setBrowserRouterState = null;\n      }\n      if (browserRouterStateRef === stateRef) {\n        browserRouterStateRef = null;\n        browserRouterStateHasCommitted = false;\n      }\n    };\n  }\n\n  return {\n    beginNavigation,\n    getActiveNavigationId,\n    hasBrowserRouterState,\n    getBrowserRouterState,\n    isCurrentNavigation,\n    performHardNavigation,\n    waitForBrowserRouterStateReady,\n    attachBrowserRouterState,\n    beginPendingBrowserRouterState,\n    finalizeNavigation,\n    renderNavigationPayload,\n    commitSameUrlNavigatePayload,\n    hmrReplaceTree,\n    drainPrePaintEffects,\n    NavigationCommitSignal,\n  };\n}\n"],"mappings":"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"}

package/dist/server/app-browser-rsc-redirect.d.ts

@@ -1,4 +1,5 @@
 //#region src/server/app-browser-rsc-redirect.d.ts
+declare const MAX_RSC_REDIRECT_DEPTH = 10;
 type RscRedirectHistoryUpdateMode = "push" | "replace" | undefined;
 type RscRedirectLifecycleDecision = {
   kind: "no-redirect";
@@ -24,5 +25,5 @@ declare function resolveRscRedirectLifecycleHop(options: {
   responseUrl: string;
 }): RscRedirectLifecycleDecision;
 //#endregion
-export { resolveRscRedirectLifecycleHop };
+export { MAX_RSC_REDIRECT_DEPTH, resolveRscRedirectLifecycleHop };
 //# sourceMappingURL=app-browser-rsc-redirect.d.ts.map

package/dist/server/app-browser-rsc-redirect.js

@@ -16,7 +16,7 @@ function resolveRscRedirectLifecycleHop(options) {
 	};
 	const redirectedHref = resolveHardNavigationTargetFromRscResponse(responseUrl.href, options.currentHref, options.origin);
 	if (redirectedHref === toVisibleAppHref(options.currentHref, options.origin)) return { kind: "no-redirect" };
-	const maxRedirectDepth = options.maxRedirectDepth ?? MAX_RSC_REDIRECT_DEPTH;
+	const maxRedirectDepth = options.maxRedirectDepth ?? 10;
 	if (options.redirectDepth >= maxRedirectDepth) return {
 		href: redirectedHref,
 		kind: "terminal-hard-navigation",
@@ -32,6 +32,6 @@ function resolveRscRedirectLifecycleHop(options) {
 	};
 }
 //#endregion
-export { resolveRscRedirectLifecycleHop };
+export { MAX_RSC_REDIRECT_DEPTH, resolveRscRedirectLifecycleHop };
 
 //# sourceMappingURL=app-browser-rsc-redirect.js.map

package/dist/server/app-browser-rsc-redirect.js.map

@@ -1 +1 @@
-{"version":3,"file":"app-browser-rsc-redirect.js","names":[],"sources":["../../src/server/app-browser-rsc-redirect.ts"],"sourcesContent":["import {\n  resolveHardNavigationTargetFromRscResponse,\n  stripRscCacheBustingSearchParam,\n  stripRscSuffix,\n} from \"./app-rsc-cache-busting.js\";\n\nconst MAX_RSC_REDIRECT_DEPTH = 10;\n\ntype RscRedirectHistoryUpdateMode = \"push\" | \"replace\" | undefined;\n\ntype RscRedirectLifecycleDecision =\n  | { kind: \"no-redirect\" }\n  | {\n      href: string;\n      historyUpdateMode: RscRedirectHistoryUpdateMode;\n      kind: \"follow\";\n      previousNextUrl: string | null;\n      redirectDepth: number;\n    }\n  | {\n      href: string;\n      kind: \"terminal-hard-navigation\";\n      reason: \"externalRedirect\" | \"maxRedirectsExceeded\";\n      redirectDepth: number;\n    };\n\nfunction toVisibleAppHref(href: string, origin: string): string {\n  const url = new URL(href, origin);\n  stripRscCacheBustingSearchParam(url);\n  return `${stripRscSuffix(url.pathname)}${url.search}${url.hash}`;\n}\n\nexport function resolveRscRedirectLifecycleHop(options: {\n  currentHref: string;\n  historyUpdateMode: RscRedirectHistoryUpdateMode;\n  maxRedirectDepth?: number;\n  origin: string;\n  redirectDepth: number;\n  requestPreviousNextUrl: string | null;\n  responseUrl: string;\n}): RscRedirectLifecycleDecision {\n  const responseUrl = new URL(options.responseUrl, options.origin);\n\n  if (responseUrl.origin !== options.origin) {\n    return {\n      href: responseUrl.href,\n      kind: \"terminal-hard-navigation\",\n      reason: \"externalRedirect\",\n      redirectDepth: options.redirectDepth,\n    };\n  }\n\n  const redirectedHref = resolveHardNavigationTargetFromRscResponse(\n    responseUrl.href,\n    options.currentHref,\n    options.origin,\n  );\n  if (redirectedHref === toVisibleAppHref(options.currentHref, options.origin)) {\n    return { kind: \"no-redirect\" };\n  }\n\n  const maxRedirectDepth = options.maxRedirectDepth ?? MAX_RSC_REDIRECT_DEPTH;\n  if (options.redirectDepth >= maxRedirectDepth) {\n    return {\n      href: redirectedHref,\n      kind: \"terminal-hard-navigation\",\n      reason: \"maxRedirectsExceeded\",\n      redirectDepth: options.redirectDepth,\n    };\n  }\n\n  return {\n    href: redirectedHref,\n    historyUpdateMode: options.historyUpdateMode,\n    kind: \"follow\",\n    previousNextUrl: options.requestPreviousNextUrl,\n    redirectDepth: options.redirectDepth + 1,\n  };\n}\n"],"mappings":";;AAMA,MAAM,yBAAyB;AAoB/B,SAAS,iBAAiB,MAAc,QAAwB;CAC9D,MAAM,MAAM,IAAI,IAAI,MAAM,OAAO;CACjC,gCAAgC,IAAI;CACpC,OAAO,GAAG,eAAe,IAAI,SAAS,GAAG,IAAI,SAAS,IAAI;;AAG5D,SAAgB,+BAA+B,SAQd;CAC/B,MAAM,cAAc,IAAI,IAAI,QAAQ,aAAa,QAAQ,OAAO;CAEhE,IAAI,YAAY,WAAW,QAAQ,QACjC,OAAO;EACL,MAAM,YAAY;EAClB,MAAM;EACN,QAAQ;EACR,eAAe,QAAQ;EACxB;CAGH,MAAM,iBAAiB,2CACrB,YAAY,MACZ,QAAQ,aACR,QAAQ,OACT;CACD,IAAI,mBAAmB,iBAAiB,QAAQ,aAAa,QAAQ,OAAO,EAC1E,OAAO,EAAE,MAAM,eAAe;CAGhC,MAAM,mBAAmB,QAAQ,oBAAoB;CACrD,IAAI,QAAQ,iBAAiB,kBAC3B,OAAO;EACL,MAAM;EACN,MAAM;EACN,QAAQ;EACR,eAAe,QAAQ;EACxB;CAGH,OAAO;EACL,MAAM;EACN,mBAAmB,QAAQ;EAC3B,MAAM;EACN,iBAAiB,QAAQ;EACzB,eAAe,QAAQ,gBAAgB;EACxC"}
+{"version":3,"file":"app-browser-rsc-redirect.js","names":[],"sources":["../../src/server/app-browser-rsc-redirect.ts"],"sourcesContent":["import {\n  resolveHardNavigationTargetFromRscResponse,\n  stripRscCacheBustingSearchParam,\n  stripRscSuffix,\n} from \"./app-rsc-cache-busting.js\";\n\nexport const MAX_RSC_REDIRECT_DEPTH = 10;\n\ntype RscRedirectHistoryUpdateMode = \"push\" | \"replace\" | undefined;\n\ntype RscRedirectLifecycleDecision =\n  | { kind: \"no-redirect\" }\n  | {\n      href: string;\n      historyUpdateMode: RscRedirectHistoryUpdateMode;\n      kind: \"follow\";\n      previousNextUrl: string | null;\n      redirectDepth: number;\n    }\n  | {\n      href: string;\n      kind: \"terminal-hard-navigation\";\n      reason: \"externalRedirect\" | \"maxRedirectsExceeded\";\n      redirectDepth: number;\n    };\n\nfunction toVisibleAppHref(href: string, origin: string): string {\n  const url = new URL(href, origin);\n  stripRscCacheBustingSearchParam(url);\n  return `${stripRscSuffix(url.pathname)}${url.search}${url.hash}`;\n}\n\nexport function resolveRscRedirectLifecycleHop(options: {\n  currentHref: string;\n  historyUpdateMode: RscRedirectHistoryUpdateMode;\n  maxRedirectDepth?: number;\n  origin: string;\n  redirectDepth: number;\n  requestPreviousNextUrl: string | null;\n  responseUrl: string;\n}): RscRedirectLifecycleDecision {\n  const responseUrl = new URL(options.responseUrl, options.origin);\n\n  if (responseUrl.origin !== options.origin) {\n    return {\n      href: responseUrl.href,\n      kind: \"terminal-hard-navigation\",\n      reason: \"externalRedirect\",\n      redirectDepth: options.redirectDepth,\n    };\n  }\n\n  const redirectedHref = resolveHardNavigationTargetFromRscResponse(\n    responseUrl.href,\n    options.currentHref,\n    options.origin,\n  );\n  if (redirectedHref === toVisibleAppHref(options.currentHref, options.origin)) {\n    return { kind: \"no-redirect\" };\n  }\n\n  const maxRedirectDepth = options.maxRedirectDepth ?? MAX_RSC_REDIRECT_DEPTH;\n  if (options.redirectDepth >= maxRedirectDepth) {\n    return {\n      href: redirectedHref,\n      kind: \"terminal-hard-navigation\",\n      reason: \"maxRedirectsExceeded\",\n      redirectDepth: options.redirectDepth,\n    };\n  }\n\n  return {\n    href: redirectedHref,\n    historyUpdateMode: options.historyUpdateMode,\n    kind: \"follow\",\n    previousNextUrl: options.requestPreviousNextUrl,\n    redirectDepth: options.redirectDepth + 1,\n  };\n}\n"],"mappings":";;AAMA,MAAa,yBAAyB;AAoBtC,SAAS,iBAAiB,MAAc,QAAwB;CAC9D,MAAM,MAAM,IAAI,IAAI,MAAM,OAAO;CACjC,gCAAgC,IAAI;CACpC,OAAO,GAAG,eAAe,IAAI,SAAS,GAAG,IAAI,SAAS,IAAI;;AAG5D,SAAgB,+BAA+B,SAQd;CAC/B,MAAM,cAAc,IAAI,IAAI,QAAQ,aAAa,QAAQ,OAAO;CAEhE,IAAI,YAAY,WAAW,QAAQ,QACjC,OAAO;EACL,MAAM,YAAY;EAClB,MAAM;EACN,QAAQ;EACR,eAAe,QAAQ;EACxB;CAGH,MAAM,iBAAiB,2CACrB,YAAY,MACZ,QAAQ,aACR,QAAQ,OACT;CACD,IAAI,mBAAmB,iBAAiB,QAAQ,aAAa,QAAQ,OAAO,EAC1E,OAAO,EAAE,MAAM,eAAe;CAGhC,MAAM,mBAAmB,QAAQ,oBAAA;CACjC,IAAI,QAAQ,iBAAiB,kBAC3B,OAAO;EACL,MAAM;EACN,MAAM;EACN,QAAQ;EACR,eAAe,QAAQ;EACxB;CAGH,OAAO;EACL,MAAM;EACN,mBAAmB,QAAQ;EAC3B,MAAM;EACN,iBAAiB,QAAQ;EACzB,eAAe,QAAQ,gBAAgB;EACxC"}

package/dist/server/app-browser-state.d.ts

@@ -1,4 +1,5 @@
 import { RouteManifest } from "../routing/app-route-graph.js";
+import { CacheEntryReuseProof } from "./cache-proof.js";
 import { ClientNavigationRenderSnapshot } from "../shims/navigation.js";
 import { AppElements, AppElementsInterception, AppElementsSlotBinding, LayoutFlags } from "./app-elements-wire.js";
 import { NavigationTrace } from "./navigation-trace.js";
@@ -35,6 +36,7 @@ type AppRouterState = {
   visibleCommitVersion: number;
 };
 type AppRouterAction = {
+  cacheEntryReuseProof?: CacheEntryReuseProof;
   elements: AppElements;
   interception: AppElementsInterception | null;
   interceptionContext: string | null;
@@ -51,13 +53,24 @@ type AppRouterAction = {
 };
 type PendingNavigationCommit = {
   action: AppRouterAction;
+  cacheEntryReuseProof?: CacheEntryReuseProof;
   interception: AppElementsInterception | null;
   interceptionContext: string | null;
   previousNextUrl: string | null;
   rootLayoutTreePath: string | null;
   routeId: string;
 };
+type AppNavigationPayloadOrigin = Readonly<{
+  origin: "fresh";
+} | {
+  origin: "visited-cache";
+}>;
+declare const FRESH_APP_NAVIGATION_PAYLOAD_ORIGIN: AppNavigationPayloadOrigin;
+declare const VISITED_CACHE_APP_NAVIGATION_PAYLOAD_ORIGIN: AppNavigationPayloadOrigin;
 type PendingNavigationCommitDisposition = "dispatch" | "hard-navigate" | "skip";
+type CacheRestorableAppPayloadMetadata = Readonly<{
+  cacheEntryReuseProof?: CacheEntryReuseProof;
+}>;
 type DispatchPendingNavigationCommitDispositionDecision = {
   disposition: "dispatch";
   preserveAbsentSlots: boolean;
@@ -71,6 +84,9 @@ type NonDispatchPendingNavigationCommitDispositionDecision = {
   trace: NavigationTrace;
 };
 type PendingNavigationCommitDispositionDecision = DispatchPendingNavigationCommitDispositionDecision | NonDispatchPendingNavigationCommitDispositionDecision;
+declare function isCacheRestorableAppPayloadMetadata(metadata: CacheRestorableAppPayloadMetadata): metadata is CacheRestorableAppPayloadMetadata & {
+  cacheEntryReuseProof: CacheEntryReuseProof;
+};
 declare function resolveInterceptionContextFromPreviousNextUrl(previousNextUrl: string | null, basePath?: string): string | null;
 type ResolveServerActionRequestStateOptions = {
   actionId: string;
@@ -106,10 +122,11 @@ declare function createPendingNavigationCommit(options: {
   nextElements: Promise<AppElements>;
   navigationSnapshot: ClientNavigationRenderSnapshot;
   operationLane: OperationLane;
+  payloadOrigin: AppNavigationPayloadOrigin;
   previousNextUrl?: string | null;
   renderId: number;
   type: "navigate" | "replace" | "traverse";
 }): Promise<PendingNavigationCommit>;
 //#endregion
-export { AppRouterAction, AppRouterState, CommittedOperationRecord, type HistoryTraversalIntent, type OperationLane, OperationRecord, PendingNavigationCommit, PendingOperationRecord, createHistoryStateWithNavigationMetadata, createHistoryStateWithPreviousNextUrl, createPendingNavigationCommit, readHistoryStatePreviousNextUrl, readHistoryStateTraversalIndex, resolveHistoryTraversalIntent, resolveInterceptionContextFromPreviousNextUrl, resolvePendingNavigationCommitDispositionDecision, resolveServerActionRequestState };
+export { AppNavigationPayloadOrigin, AppRouterAction, AppRouterState, CommittedOperationRecord, FRESH_APP_NAVIGATION_PAYLOAD_ORIGIN, type HistoryTraversalIntent, type OperationLane, OperationRecord, PendingNavigationCommit, PendingOperationRecord, VISITED_CACHE_APP_NAVIGATION_PAYLOAD_ORIGIN, createHistoryStateWithNavigationMetadata, createHistoryStateWithPreviousNextUrl, createPendingNavigationCommit, isCacheRestorableAppPayloadMetadata, readHistoryStatePreviousNextUrl, readHistoryStateTraversalIndex, resolveHistoryTraversalIntent, resolveInterceptionContextFromPreviousNextUrl, resolvePendingNavigationCommitDispositionDecision, resolveServerActionRequestState };
 //# sourceMappingURL=app-browser-state.d.ts.map

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

@@ -7,8 +7,11 @@ import { getMountedSlotIds, getMountedSlotIdsHeader } from "./app-elements.js";
 import { createHistoryStateWithNavigationMetadata, createHistoryStateWithPreviousNextUrl, readHistoryStatePreviousNextUrl, readHistoryStateTraversalIndex, resolveHistoryTraversalIntent } from "./app-history-state.js";
 import { createRscRequestHeaders } from "./app-rsc-cache-busting.js";
 import { NavigationTraceReasonCodes, createNavigationLifecycleTraceFields, createNavigationTrace } from "./navigation-trace.js";
+import { createCacheEntryReuseProof } from "./cache-proof.js";
 import { navigationPlanner } from "./navigation-planner.js";
 //#region src/server/app-browser-state.ts
+const FRESH_APP_NAVIGATION_PAYLOAD_ORIGIN = { origin: "fresh" };
+const VISITED_CACHE_APP_NAVIGATION_PAYLOAD_ORIGIN = { origin: "visited-cache" };
 function createOperationRecord(options) {
 	return {
 		id: options.id,
@@ -17,6 +20,16 @@ function createOperationRecord(options) {
 		state: "pending"
 	};
 }
+function isCacheRestorableAppPayloadMetadata(metadata) {
+	return metadata.cacheEntryReuseProof !== void 0;
+}
+function requiresCacheEntryReuseProof(origin) {
+	switch (origin.origin) {
+		case "fresh": return false;
+		case "visited-cache": return true;
+		default: throw new Error("[vinext] Unknown App Router payload origin: " + String(origin));
+	}
+}
 function normalizeNavigationSnapshotMatchedUrl(pathname) {
 	return normalizePath(normalizePathnameForRouteMatch(pathname));
 }
@@ -150,6 +163,7 @@ function planPendingRootBoundaryFlightResponse(options) {
 		routeManifest: options.routeManifest,
 		targetSnapshot
 	});
+	const cacheEntryReuseProof = options.pending.cacheEntryReuseProof;
 	return navigationPlanner.plan({
 		routeManifest: options.routeManifest,
 		state: {
@@ -161,6 +175,7 @@ function planPendingRootBoundaryFlightResponse(options) {
 		event: {
 			kind: "flightResponseArrived",
 			result: {
+				...cacheEntryReuseProof ? { cacheEntryReuseProof } : {},
 				href: options.targetHref ?? targetSnapshot.displayUrl,
 				targetSnapshot
 			},
@@ -194,10 +209,12 @@ function mapNavigationDecisionToPendingDisposition(decision) {
 async function createPendingNavigationCommit(options) {
 	const elements = await options.nextElements;
 	const metadata = AppElementsWire.readMetadata(elements);
+	const cacheEntryReuseProof = metadata.cacheEntryReuseProof ?? (requiresCacheEntryReuseProof(options.payloadOrigin) ? createCacheEntryReuseProof(null) : void 0);
 	const requestedPreviousNextUrl = options.previousNextUrl !== void 0 ? options.previousNextUrl : options.currentState.previousNextUrl;
 	const previousNextUrl = metadata.interception === null ? null : requestedPreviousNextUrl;
 	return {
 		action: {
+			...cacheEntryReuseProof ? { cacheEntryReuseProof } : {},
 			elements,
 			interception: metadata.interception,
 			interceptionContext: metadata.interceptionContext,
@@ -216,6 +233,7 @@ async function createPendingNavigationCommit(options) {
 			routeId: metadata.routeId,
 			type: options.type
 		},
+		...cacheEntryReuseProof ? { cacheEntryReuseProof } : {},
 		interception: metadata.interception,
 		interceptionContext: metadata.interceptionContext,
 		previousNextUrl,
@@ -224,6 +242,6 @@ async function createPendingNavigationCommit(options) {
 	};
 }
 //#endregion
-export { createHistoryStateWithNavigationMetadata, createHistoryStateWithPreviousNextUrl, createPendingNavigationCommit, readHistoryStatePreviousNextUrl, readHistoryStateTraversalIndex, resolveHistoryTraversalIntent, resolveInterceptionContextFromPreviousNextUrl, resolvePendingNavigationCommitDispositionDecision, resolveServerActionRequestState };
+export { FRESH_APP_NAVIGATION_PAYLOAD_ORIGIN, VISITED_CACHE_APP_NAVIGATION_PAYLOAD_ORIGIN, createHistoryStateWithNavigationMetadata, createHistoryStateWithPreviousNextUrl, createPendingNavigationCommit, isCacheRestorableAppPayloadMetadata, readHistoryStatePreviousNextUrl, readHistoryStateTraversalIndex, resolveHistoryTraversalIntent, resolveInterceptionContextFromPreviousNextUrl, resolvePendingNavigationCommitDispositionDecision, resolveServerActionRequestState };
 
 //# sourceMappingURL=app-browser-state.js.map

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 {\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  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  interception: AppElementsInterception | null;\n  interceptionContext: string | null;\n  previousNextUrl: string | null;\n  rootLayoutTreePath: string | null;\n  routeId: string;\n};\n\ntype PendingNavigationCommitDisposition = \"dispatch\" | \"hard-navigate\" | \"skip\";\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\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\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        // 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  // 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 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      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 action.interceptionContext / action.rootLayoutTreePath / action.routeId.\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  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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"}

package/dist/server/app-browser-stream.d.ts

@@ -1,24 +1,15 @@
+import { NavigationRuntimeSnapshot } from "../client/navigation-runtime.js";
 import { RSC_FORM_STATE_GLOBAL } from "./app-browser-hydration.js";
 import { RscEmbeddedChunk } from "./app-rsc-embedded-chunks.js";
 import { ReactFormState } from "react-dom/client";
 
 //#region src/server/app-browser-stream.d.ts
-type NavigationSnapshot = {
-  pathname: string;
-  searchParams: [string, string][];
-};
-type LegacyRscEmbedData = {
-  rsc: RscEmbeddedChunk[];
-  params?: Record<string, string | string[]>;
-  nav?: NavigationSnapshot;
-};
 type VinextBrowserGlobals = {
-  __VINEXT_RSC__?: LegacyRscEmbedData;
   __VINEXT_RSC_CHUNKS__?: RscEmbeddedChunk[];
   __VINEXT_RSC_DONE__?: boolean;
   [RSC_FORM_STATE_GLOBAL]?: ReactFormState;
   __VINEXT_RSC_PARAMS__?: Record<string, string | string[]>;
-  __VINEXT_RSC_NAV__?: NavigationSnapshot;
+  __VINEXT_RSC_NAV__?: NavigationRuntimeSnapshot;
 };
 declare function getVinextBrowserGlobal(): typeof globalThis & VinextBrowserGlobals;
 /**
@@ -28,9 +19,9 @@ declare function chunksToReadableStream(chunks: readonly RscEmbeddedChunk[]): Re
 /**
  * Create a ReadableStream from progressively-embedded RSC chunks.
  *
- * The server pushes chunks into `__VINEXT_RSC_CHUNKS__` via inline <script>
- * tags. We monkey-patch `push()` so new chunks stream to React immediately
- * instead of polling with setTimeout.
+ * The server pushes chunks into the typed navigation runtime via inline
+ * <script> tags. We monkey-patch `push()` so new chunks stream to React
+ * immediately instead of polling with setTimeout.
  */
 declare function createProgressiveRscStream(): ReadableStream<Uint8Array>;
 //#endregion

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

@@ -1,3 +1,4 @@
+import { ensureNavigationRuntimeRscBootstrap, getNavigationRuntime } from "../client/navigation-runtime.js";
 import { decodeRscEmbeddedChunk } from "./app-rsc-embedded-chunks.js";
 //#region src/server/app-browser-stream.ts
 function getVinextBrowserGlobal() {
@@ -15,19 +16,23 @@ function chunksToReadableStream(chunks) {
 		controller.close();
 	} });
 }
+function getNavigationRuntimeRscBootstrap() {
+	return getNavigationRuntime()?.bootstrap.rsc ?? null;
+}
 /**
 * Create a ReadableStream from progressively-embedded RSC chunks.
 *
-* The server pushes chunks into `__VINEXT_RSC_CHUNKS__` via inline <script>
-* tags. We monkey-patch `push()` so new chunks stream to React immediately
-* instead of polling with setTimeout.
+* The server pushes chunks into the typed navigation runtime via inline
+* <script> tags. We monkey-patch `push()` so new chunks stream to React
+* immediately instead of polling with setTimeout.
 */
 function createProgressiveRscStream() {
 	return new ReadableStream({ start(controller) {
 		const vinext = getVinextBrowserGlobal();
-		const initialChunks = vinext.__VINEXT_RSC_CHUNKS__ ?? [];
+		const runtimeRsc = getNavigationRuntimeRscBootstrap();
+		const initialChunks = runtimeRsc?.rsc ?? vinext.__VINEXT_RSC_CHUNKS__ ?? [];
 		for (const chunk of initialChunks) controller.enqueue(decodeRscEmbeddedChunk(chunk));
-		if (vinext.__VINEXT_RSC_DONE__) {
+		if (runtimeRsc?.done || vinext.__VINEXT_RSC_DONE__) {
 			controller.close();
 			return;
 		}
@@ -52,12 +57,13 @@ function createProgressiveRscStream() {
 				controller.error(createUnexpectedRscStreamCloseError());
 			}
 		};
-		const arr = vinext.__VINEXT_RSC_CHUNKS__ ??= [];
+		const liveRuntimeRsc = getNavigationRuntime() === null ? null : ensureNavigationRuntimeRscBootstrap();
+		const arr = liveRuntimeRsc?.rsc ?? (vinext.__VINEXT_RSC_CHUNKS__ ??= []);
 		arr.push = function(...chunks) {
 			const length = Array.prototype.push.apply(this, chunks);
 			if (closed) return length;
 			for (const chunk of chunks) controller.enqueue(decodeRscEmbeddedChunk(chunk));
-			if (vinext.__VINEXT_RSC_DONE__) closeOnce();
+			if (liveRuntimeRsc?.done || vinext.__VINEXT_RSC_DONE__) closeOnce();
 			return length;
 		};
 		if (typeof document !== "undefined") if (document.readyState === "loading") {

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

@@ -1 +1 @@
-{"version":3,"file":"app-browser-stream.js","names":[],"sources":["../../src/server/app-browser-stream.ts"],"sourcesContent":["import type { ReactFormState } from \"react-dom/client\";\nimport { RSC_FORM_STATE_GLOBAL } from \"./app-browser-hydration.js\";\nimport { decodeRscEmbeddedChunk, type RscEmbeddedChunk } from \"./app-rsc-embedded-chunks.js\";\n\ntype NavigationSnapshot = {\n  pathname: string;\n  searchParams: [string, string][];\n};\n\ntype LegacyRscEmbedData = {\n  rsc: RscEmbeddedChunk[];\n  params?: Record<string, string | string[]>;\n  nav?: NavigationSnapshot;\n};\n\ntype VinextBrowserGlobals = {\n  __VINEXT_RSC__?: LegacyRscEmbedData;\n  __VINEXT_RSC_CHUNKS__?: RscEmbeddedChunk[];\n  __VINEXT_RSC_DONE__?: boolean;\n  [RSC_FORM_STATE_GLOBAL]?: ReactFormState;\n  __VINEXT_RSC_PARAMS__?: Record<string, string | string[]>;\n  __VINEXT_RSC_NAV__?: NavigationSnapshot;\n};\n\nexport function getVinextBrowserGlobal(): typeof globalThis & VinextBrowserGlobals {\n  return globalThis as typeof globalThis & VinextBrowserGlobals;\n}\n\nfunction createUnexpectedRscStreamCloseError(): Error {\n  return new Error(\n    \"The connection to the page was unexpectedly closed, possibly due to the stop button being clicked, loss of Wi-Fi, or an unstable internet connection.\",\n  );\n}\n\n/**\n * Convert embedded chunks back to a ReadableStream of Uint8Array chunks.\n */\nexport function chunksToReadableStream(\n  chunks: readonly RscEmbeddedChunk[],\n): ReadableStream<Uint8Array> {\n  return new ReadableStream<Uint8Array>({\n    start(controller) {\n      for (const chunk of chunks) {\n        controller.enqueue(decodeRscEmbeddedChunk(chunk));\n      }\n      controller.close();\n    },\n  });\n}\n\n/**\n * Create a ReadableStream from progressively-embedded RSC chunks.\n *\n * The server pushes chunks into `__VINEXT_RSC_CHUNKS__` via inline <script>\n * tags. We monkey-patch `push()` so new chunks stream to React immediately\n * instead of polling with setTimeout.\n */\nexport function createProgressiveRscStream(): ReadableStream<Uint8Array> {\n  return new ReadableStream<Uint8Array>({\n    start(controller) {\n      const vinext = getVinextBrowserGlobal();\n      const initialChunks = vinext.__VINEXT_RSC_CHUNKS__ ?? [];\n\n      for (const chunk of initialChunks) {\n        controller.enqueue(decodeRscEmbeddedChunk(chunk));\n      }\n\n      if (vinext.__VINEXT_RSC_DONE__) {\n        controller.close();\n        return;\n      }\n\n      let closed = false;\n      let cancelDocumentCompletionCheck: (() => void) | undefined;\n      const cancelPendingDocumentCompletionCheck = () => {\n        const cancel = cancelDocumentCompletionCheck;\n        cancelDocumentCompletionCheck = undefined;\n        cancel?.();\n      };\n      const closeOnce = () => {\n        if (!closed) {\n          closed = true;\n          cancelPendingDocumentCompletionCheck();\n          controller.close();\n        }\n      };\n      const errorOnce = () => {\n        if (!closed) {\n          closed = true;\n          cancelPendingDocumentCompletionCheck();\n          controller.error(createUnexpectedRscStreamCloseError());\n        }\n      };\n\n      const arr = (vinext.__VINEXT_RSC_CHUNKS__ ??= []);\n      arr.push = function (...chunks: RscEmbeddedChunk[]): number {\n        const length = Array.prototype.push.apply(this, chunks);\n\n        if (closed) return length;\n\n        for (const chunk of chunks) {\n          controller.enqueue(decodeRscEmbeddedChunk(chunk));\n        }\n\n        if (vinext.__VINEXT_RSC_DONE__) {\n          closeOnce();\n        }\n\n        return length;\n      };\n\n      if (typeof document !== \"undefined\") {\n        if (document.readyState === \"loading\") {\n          document.addEventListener(\"DOMContentLoaded\", errorOnce);\n          cancelDocumentCompletionCheck = () =>\n            document.removeEventListener(\"DOMContentLoaded\", errorOnce);\n        } else {\n          const timeoutId = setTimeout(errorOnce);\n          cancelDocumentCompletionCheck = () => clearTimeout(timeoutId);\n        }\n      }\n    },\n  });\n}\n"],"mappings":";;AAwBA,SAAgB,yBAAmE;CACjF,OAAO;;AAGT,SAAS,sCAA6C;CACpD,uBAAO,IAAI,MACT,wJACD;;;;;AAMH,SAAgB,uBACd,QAC4B;CAC5B,OAAO,IAAI,eAA2B,EACpC,MAAM,YAAY;EAChB,KAAK,MAAM,SAAS,QAClB,WAAW,QAAQ,uBAAuB,MAAM,CAAC;EAEnD,WAAW,OAAO;IAErB,CAAC;;;;;;;;;AAUJ,SAAgB,6BAAyD;CACvE,OAAO,IAAI,eAA2B,EACpC,MAAM,YAAY;EAChB,MAAM,SAAS,wBAAwB;EACvC,MAAM,gBAAgB,OAAO,yBAAyB,EAAE;EAExD,KAAK,MAAM,SAAS,eAClB,WAAW,QAAQ,uBAAuB,MAAM,CAAC;EAGnD,IAAI,OAAO,qBAAqB;GAC9B,WAAW,OAAO;GAClB;;EAGF,IAAI,SAAS;EACb,IAAI;EACJ,MAAM,6CAA6C;GACjD,MAAM,SAAS;GACf,gCAAgC,KAAA;GAChC,UAAU;;EAEZ,MAAM,kBAAkB;GACtB,IAAI,CAAC,QAAQ;IACX,SAAS;IACT,sCAAsC;IACtC,WAAW,OAAO;;;EAGtB,MAAM,kBAAkB;GACtB,IAAI,CAAC,QAAQ;IACX,SAAS;IACT,sCAAsC;IACtC,WAAW,MAAM,qCAAqC,CAAC;;;EAI3D,MAAM,MAAO,OAAO,0BAA0B,EAAE;EAChD,IAAI,OAAO,SAAU,GAAG,QAAoC;GAC1D,MAAM,SAAS,MAAM,UAAU,KAAK,MAAM,MAAM,OAAO;GAEvD,IAAI,QAAQ,OAAO;GAEnB,KAAK,MAAM,SAAS,QAClB,WAAW,QAAQ,uBAAuB,MAAM,CAAC;GAGnD,IAAI,OAAO,qBACT,WAAW;GAGb,OAAO;;EAGT,IAAI,OAAO,aAAa,aACtB,IAAI,SAAS,eAAe,WAAW;GACrC,SAAS,iBAAiB,oBAAoB,UAAU;GACxD,sCACE,SAAS,oBAAoB,oBAAoB,UAAU;SACxD;GACL,MAAM,YAAY,WAAW,UAAU;GACvC,sCAAsC,aAAa,UAAU;;IAIpE,CAAC"}
+{"version":3,"file":"app-browser-stream.js","names":[],"sources":["../../src/server/app-browser-stream.ts"],"sourcesContent":["import type { ReactFormState } from \"react-dom/client\";\nimport {\n  ensureNavigationRuntimeRscBootstrap,\n  getNavigationRuntime,\n  type NavigationRuntimeRscBootstrap,\n  type NavigationRuntimeSnapshot,\n} from \"../client/navigation-runtime.js\";\nimport { RSC_FORM_STATE_GLOBAL } from \"./app-browser-hydration.js\";\nimport { decodeRscEmbeddedChunk, type RscEmbeddedChunk } from \"./app-rsc-embedded-chunks.js\";\n\ntype VinextBrowserGlobals = {\n  __VINEXT_RSC_CHUNKS__?: RscEmbeddedChunk[];\n  __VINEXT_RSC_DONE__?: boolean;\n  [RSC_FORM_STATE_GLOBAL]?: ReactFormState;\n  __VINEXT_RSC_PARAMS__?: Record<string, string | string[]>;\n  __VINEXT_RSC_NAV__?: NavigationRuntimeSnapshot;\n};\n\nexport function getVinextBrowserGlobal(): typeof globalThis & VinextBrowserGlobals {\n  return globalThis as typeof globalThis & VinextBrowserGlobals;\n}\n\nfunction createUnexpectedRscStreamCloseError(): Error {\n  return new Error(\n    \"The connection to the page was unexpectedly closed, possibly due to the stop button being clicked, loss of Wi-Fi, or an unstable internet connection.\",\n  );\n}\n\n/**\n * Convert embedded chunks back to a ReadableStream of Uint8Array chunks.\n */\nexport function chunksToReadableStream(\n  chunks: readonly RscEmbeddedChunk[],\n): ReadableStream<Uint8Array> {\n  return new ReadableStream<Uint8Array>({\n    start(controller) {\n      for (const chunk of chunks) {\n        controller.enqueue(decodeRscEmbeddedChunk(chunk));\n      }\n      controller.close();\n    },\n  });\n}\n\nfunction getNavigationRuntimeRscBootstrap(): NavigationRuntimeRscBootstrap | null {\n  return getNavigationRuntime()?.bootstrap.rsc ?? null;\n}\n\n/**\n * Create a ReadableStream from progressively-embedded RSC chunks.\n *\n * The server pushes chunks into the typed navigation runtime via inline\n * <script> tags. We monkey-patch `push()` so new chunks stream to React\n * immediately instead of polling with setTimeout.\n */\nexport function createProgressiveRscStream(): ReadableStream<Uint8Array> {\n  return new ReadableStream<Uint8Array>({\n    start(controller) {\n      const vinext = getVinextBrowserGlobal();\n      const runtimeRsc = getNavigationRuntimeRscBootstrap();\n      const initialChunks = runtimeRsc?.rsc ?? vinext.__VINEXT_RSC_CHUNKS__ ?? [];\n\n      for (const chunk of initialChunks) {\n        controller.enqueue(decodeRscEmbeddedChunk(chunk));\n      }\n\n      if (runtimeRsc?.done || vinext.__VINEXT_RSC_DONE__) {\n        controller.close();\n        return;\n      }\n\n      let closed = false;\n      let cancelDocumentCompletionCheck: (() => void) | undefined;\n      const cancelPendingDocumentCompletionCheck = () => {\n        const cancel = cancelDocumentCompletionCheck;\n        cancelDocumentCompletionCheck = undefined;\n        cancel?.();\n      };\n      const closeOnce = () => {\n        if (!closed) {\n          closed = true;\n          cancelPendingDocumentCompletionCheck();\n          controller.close();\n        }\n      };\n      const errorOnce = () => {\n        if (!closed) {\n          closed = true;\n          cancelPendingDocumentCompletionCheck();\n          controller.error(createUnexpectedRscStreamCloseError());\n        }\n      };\n\n      const liveRuntimeRsc =\n        getNavigationRuntime() === null ? null : ensureNavigationRuntimeRscBootstrap();\n      const arr = liveRuntimeRsc?.rsc ?? (vinext.__VINEXT_RSC_CHUNKS__ ??= []);\n      // Capture the bootstrap object before it can be cleared. Inline done\n      // scripts mutate this same object, and clearing happens only after the\n      // stream has already been consumed or closed.\n      arr.push = function (...chunks: RscEmbeddedChunk[]): number {\n        const length = Array.prototype.push.apply(this, chunks);\n\n        if (closed) return length;\n\n        for (const chunk of chunks) {\n          controller.enqueue(decodeRscEmbeddedChunk(chunk));\n        }\n\n        if (liveRuntimeRsc?.done || vinext.__VINEXT_RSC_DONE__) {\n          closeOnce();\n        }\n\n        return length;\n      };\n\n      if (typeof document !== \"undefined\") {\n        if (document.readyState === \"loading\") {\n          document.addEventListener(\"DOMContentLoaded\", errorOnce);\n          cancelDocumentCompletionCheck = () =>\n            document.removeEventListener(\"DOMContentLoaded\", errorOnce);\n        } else {\n          const timeoutId = setTimeout(errorOnce);\n          cancelDocumentCompletionCheck = () => clearTimeout(timeoutId);\n        }\n      }\n    },\n  });\n}\n"],"mappings":";;;AAkBA,SAAgB,yBAAmE;CACjF,OAAO;;AAGT,SAAS,sCAA6C;CACpD,uBAAO,IAAI,MACT,wJACD;;;;;AAMH,SAAgB,uBACd,QAC4B;CAC5B,OAAO,IAAI,eAA2B,EACpC,MAAM,YAAY;EAChB,KAAK,MAAM,SAAS,QAClB,WAAW,QAAQ,uBAAuB,MAAM,CAAC;EAEnD,WAAW,OAAO;IAErB,CAAC;;AAGJ,SAAS,mCAAyE;CAChF,OAAO,sBAAsB,EAAE,UAAU,OAAO;;;;;;;;;AAUlD,SAAgB,6BAAyD;CACvE,OAAO,IAAI,eAA2B,EACpC,MAAM,YAAY;EAChB,MAAM,SAAS,wBAAwB;EACvC,MAAM,aAAa,kCAAkC;EACrD,MAAM,gBAAgB,YAAY,OAAO,OAAO,yBAAyB,EAAE;EAE3E,KAAK,MAAM,SAAS,eAClB,WAAW,QAAQ,uBAAuB,MAAM,CAAC;EAGnD,IAAI,YAAY,QAAQ,OAAO,qBAAqB;GAClD,WAAW,OAAO;GAClB;;EAGF,IAAI,SAAS;EACb,IAAI;EACJ,MAAM,6CAA6C;GACjD,MAAM,SAAS;GACf,gCAAgC,KAAA;GAChC,UAAU;;EAEZ,MAAM,kBAAkB;GACtB,IAAI,CAAC,QAAQ;IACX,SAAS;IACT,sCAAsC;IACtC,WAAW,OAAO;;;EAGtB,MAAM,kBAAkB;GACtB,IAAI,CAAC,QAAQ;IACX,SAAS;IACT,sCAAsC;IACtC,WAAW,MAAM,qCAAqC,CAAC;;;EAI3D,MAAM,iBACJ,sBAAsB,KAAK,OAAO,OAAO,qCAAqC;EAChF,MAAM,MAAM,gBAAgB,QAAQ,OAAO,0BAA0B,EAAE;EAIvE,IAAI,OAAO,SAAU,GAAG,QAAoC;GAC1D,MAAM,SAAS,MAAM,UAAU,KAAK,MAAM,MAAM,OAAO;GAEvD,IAAI,QAAQ,OAAO;GAEnB,KAAK,MAAM,SAAS,QAClB,WAAW,QAAQ,uBAAuB,MAAM,CAAC;GAGnD,IAAI,gBAAgB,QAAQ,OAAO,qBACjC,WAAW;GAGb,OAAO;;EAGT,IAAI,OAAO,aAAa,aACtB,IAAI,SAAS,eAAe,WAAW;GACrC,SAAS,iBAAiB,oBAAoB,UAAU;GACxD,sCACE,SAAS,oBAAoB,oBAAoB,UAAU;SACxD;GACL,MAAM,YAAY,WAAW,UAAU;GACvC,sCAAsC,aAAa,UAAU;;IAIpE,CAAC"}

package/dist/server/app-browser-visible-commit.d.ts

@@ -3,7 +3,7 @@ import { ClientNavigationRenderSnapshot } from "../shims/navigation.js";
 import { AppElements } from "./app-elements-wire.js";
 import { NavigationTrace } from "./navigation-trace.js";
 import { OperationLane } from "./navigation-planner.js";
-import { AppRouterAction, AppRouterState, PendingNavigationCommit } from "./app-browser-state.js";
+import { AppNavigationPayloadOrigin, AppRouterAction, AppRouterState, PendingNavigationCommit } from "./app-browser-state.js";
 
 //#region src/server/app-browser-visible-commit.d.ts
 type VisibleCommitDecision = {
@@ -66,6 +66,7 @@ declare function resolveAndClassifyNavigationCommit(options: {
   navigationSnapshot: ClientNavigationRenderSnapshot;
   nextElements: Promise<AppElements>;
   operationLane: OperationLane;
+  payloadOrigin: AppNavigationPayloadOrigin;
   previousNextUrl?: string | null;
   renderId: number;
   routeManifest?: RouteManifest | null;

package/dist/server/app-browser-visible-commit.js

@@ -204,6 +204,7 @@ async function resolveAndClassifyNavigationCommit(options) {
 		nextElements: options.nextElements,
 		navigationSnapshot: options.navigationSnapshot,
 		operationLane: options.operationLane,
+		payloadOrigin: options.payloadOrigin,
 		previousNextUrl: options.previousNextUrl,
 		renderId: options.renderId,
 		type: options.type