vinext 0.0.49 → 0.0.50

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

@@ -5,7 +5,7 @@ import { createPendingNavigationCommit, resolvePendingNavigationCommitDispositio
 const approvedVisibleCommitBrand = Symbol("ApprovedVisibleCommit");
 function applyApprovedVisibleCommit(state, commit) {
 	assertApprovedVisibleCommit(commit);
-	return reduceApprovedVisibleCommitState(state, commit.action);
+	return reduceApprovedVisibleCommitState(state, commit);
 }
 function assertApprovedVisibleCommit(commit) {
 	if (commit[approvedVisibleCommitBrand] !== true) throw new Error("[vinext] Visible router state mutation requires ApprovedVisibleCommit");
@@ -27,16 +27,19 @@ function commitVisibleRouterState(state, nextState, operation) {
 		visibleCommitVersion
 	};
 }
-function reduceApprovedVisibleCommitState(state, action) {
+function reduceApprovedVisibleCommitState(state, commit) {
+	const { action } = commit;
 	switch (action.type) {
 		case "traverse":
 		case "navigate": return commitVisibleRouterState(state, {
-			elements: mergeElements(state.elements, action.elements, action.type === "traverse"),
+			elements: mergeElements(state.elements, action.elements, {
+				clearAbsentSlots: action.type === "traverse",
+				preserveAbsentSlots: commit.decision.preserveAbsentSlots,
+				preserveElementIds: commit.decision.preserveElementIds
+			}),
 			interceptionContext: action.interceptionContext,
-			layoutFlags: {
-				...state.layoutFlags,
-				...action.layoutFlags
-			},
+			layoutFlags: mergeLayoutFlags(state.layoutFlags, action.layoutFlags, commit.decision.preserveElementIds),
+			layoutIds: action.layoutIds,
 			navigationSnapshot: action.navigationSnapshot,
 			previousNextUrl: action.previousNextUrl,
 			renderId: action.renderId,
@@ -47,6 +50,7 @@ function reduceApprovedVisibleCommitState(state, action) {
 			elements: action.elements,
 			interceptionContext: action.interceptionContext,
 			layoutFlags: action.layoutFlags,
+			layoutIds: action.layoutIds,
 			navigationSnapshot: action.navigationSnapshot,
 			previousNextUrl: action.previousNextUrl,
 			renderId: action.renderId,
@@ -60,26 +64,37 @@ function reduceApprovedVisibleCommitState(state, action) {
 	}
 }
 function resolvePendingNavigationCommitDecision(options) {
-	const { disposition, trace } = resolvePendingNavigationCommitDispositionDecision(options);
-	switch (disposition) {
+	const decision = resolvePendingNavigationCommitDispositionDecision(options);
+	switch (decision.disposition) {
 		case "skip": return {
 			disposition: "no-commit",
-			trace
+			trace: decision.trace
 		};
 		case "hard-navigate": return {
 			disposition: "hard-navigate",
-			trace
+			trace: decision.trace
 		};
-		case "dispatch": return createVisibleCommitDecision(trace);
-		default: throw new Error("[vinext] Unknown navigation commit disposition: " + String(disposition));
+		case "dispatch": return createVisibleCommitDecision(decision.trace, decision.preserveElementIds, decision.preserveAbsentSlots);
+		default: throw new Error("[vinext] Unknown navigation commit disposition: " + String(decision));
 	}
 }
-function createVisibleCommitDecision(trace = createNavigationTrace(NavigationTraceReasonCodes.commitCurrent)) {
+function createVisibleCommitDecision(trace = createNavigationTrace(NavigationTraceReasonCodes.commitCurrent), preserveElementIds = [], preserveAbsentSlots = false) {
 	return {
 		disposition: "commit",
+		preserveAbsentSlots,
+		preserveElementIds: [...preserveElementIds],
 		trace
 	};
 }
+function mergeLayoutFlags(previousFlags, nextFlags, preserveElementIds) {
+	const merged = { ...nextFlags };
+	for (const id of preserveElementIds) {
+		if (Object.hasOwn(merged, id)) continue;
+		const value = previousFlags[id];
+		if (value) merged[id] = value;
+	}
+	return merged;
+}
 function createApprovedVisibleCommit(options) {
 	return {
 		[approvedVisibleCommitBrand]: true,
@@ -130,11 +145,10 @@ function approveHmrVisibleCommit(pending) {
 function approvePendingNavigationCommit(options) {
 	const decision = addCommitTransactionTrace(resolvePendingNavigationCommitDecision({
 		activeNavigationId: options.activeNavigationId,
-		currentVisibleCommitVersion: options.currentState.visibleCommitVersion,
-		currentRootLayoutTreePath: options.currentState.rootLayoutTreePath,
-		nextRootLayoutTreePath: options.pending.rootLayoutTreePath,
+		currentState: options.currentState,
+		pending: options.pending,
 		startedNavigationId: options.startedNavigationId,
-		startedVisibleCommitVersion: options.pending.action.operation.startedVisibleCommitVersion
+		targetHref: options.targetHref
 	}), options.pending);
 	switch (decision.disposition) {
 		case "commit": return {
@@ -167,7 +181,8 @@ async function resolveAndClassifyNavigationCommit(options) {
 		activeNavigationId: options.getActiveNavigationId?.() ?? options.activeNavigationId,
 		currentState: approvalState,
 		pending,
-		startedNavigationId: options.startedNavigationId
+		startedNavigationId: options.startedNavigationId,
+		targetHref: options.targetHref
 	});
 	return {
 		approvedCommit: approval.approvedCommit,

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

@@ -1 +1 @@
-{"version":3,"file":"app-browser-visible-commit.js","names":[],"sources":["../../src/server/app-browser-visible-commit.ts"],"sourcesContent":["import type { ClientNavigationRenderSnapshot } from \"vinext/shims/navigation\";\nimport { mergeElements } from \"vinext/shims/slot\";\nimport type { AppElements } from \"./app-elements.js\";\nimport {\n  createPendingNavigationCommit,\n  resolvePendingNavigationCommitDispositionDecision,\n  type AppRouterAction,\n  type AppRouterState,\n  type CommittedOperationRecord,\n  type OperationLane,\n  type PendingNavigationCommit,\n  type PendingOperationRecord,\n} from \"./app-browser-state.js\";\nimport {\n  NavigationTraceReasonCodes,\n  NavigationTraceTransactionCodes,\n  createNavigationTrace,\n  prependNavigationTraceEntry,\n  type NavigationTrace,\n  type NavigationTraceFields,\n  type NavigationTraceTransactionCode,\n} from \"./navigation-trace.js\";\n\ntype VisibleCommitDecision = {\n  disposition: \"commit\";\n  trace: NavigationTrace;\n};\ntype HardNavigateCommitDecision = {\n  disposition: \"hard-navigate\";\n  trace: NavigationTrace;\n};\ntype NoCommitDecision = {\n  disposition: \"no-commit\";\n  trace: NavigationTrace;\n};\ntype CommitDecision = VisibleCommitDecision | HardNavigateCommitDecision | NoCommitDecision;\nconst approvedVisibleCommitBrand: unique symbol = Symbol(\"ApprovedVisibleCommit\");\nexport type ApprovedVisibleCommit = {\n  readonly [approvedVisibleCommitBrand]: true;\n  readonly action: AppRouterAction;\n  readonly decision: VisibleCommitDecision;\n  readonly interceptionContext: string | null;\n  readonly previousNextUrl: string | null;\n  readonly rootLayoutTreePath: string | null;\n  readonly routeId: string;\n};\ntype VisibleCommitApproval = {\n  approvedCommit: ApprovedVisibleCommit;\n  decision: VisibleCommitDecision;\n};\ntype NonVisibleCommitApproval = {\n  approvedCommit: null;\n  decision: HardNavigateCommitDecision | NoCommitDecision;\n};\ntype CommitApproval = VisibleCommitApproval | NonVisibleCommitApproval;\ntype ClassifiedPendingNavigationCommit = {\n  approvedCommit: ApprovedVisibleCommit | null;\n  decision: CommitDecision;\n  pending: PendingNavigationCommit;\n  trace: NavigationTrace;\n};\n\nexport function applyApprovedVisibleCommit(\n  state: AppRouterState,\n  commit: ApprovedVisibleCommit,\n): AppRouterState {\n  assertApprovedVisibleCommit(commit);\n  return reduceApprovedVisibleCommitState(state, commit.action);\n}\n\nfunction assertApprovedVisibleCommit(commit: ApprovedVisibleCommit): void {\n  if (commit[approvedVisibleCommitBrand] !== true) {\n    throw new Error(\"[vinext] Visible router state mutation requires ApprovedVisibleCommit\");\n  }\n}\n\nfunction commitOperationRecord(\n  operation: PendingOperationRecord,\n  visibleCommitVersion: number,\n): CommittedOperationRecord {\n  return {\n    id: operation.id,\n    lane: operation.lane,\n    startedVisibleCommitVersion: operation.startedVisibleCommitVersion,\n    state: \"committed\",\n    visibleCommitVersion,\n  };\n}\n\nfunction commitVisibleRouterState(\n  state: AppRouterState,\n  nextState: Omit<AppRouterState, \"activeOperation\" | \"visibleCommitVersion\">,\n  operation: PendingOperationRecord,\n): AppRouterState {\n  // Single owner for visibleCommitVersion: only an ApprovedVisibleCommit may\n  // advance it, and every accepted visible mutation advances it exactly once.\n  const visibleCommitVersion = state.visibleCommitVersion + 1;\n  return {\n    ...nextState,\n    activeOperation: commitOperationRecord(operation, visibleCommitVersion),\n    visibleCommitVersion,\n  };\n}\n\nfunction reduceApprovedVisibleCommitState(\n  state: AppRouterState,\n  action: AppRouterAction,\n): AppRouterState {\n  switch (action.type) {\n    case \"traverse\":\n    case \"navigate\":\n      return commitVisibleRouterState(\n        state,\n        {\n          elements: mergeElements(state.elements, action.elements, action.type === \"traverse\"),\n          interceptionContext: action.interceptionContext,\n          layoutFlags: { ...state.layoutFlags, ...action.layoutFlags },\n          navigationSnapshot: action.navigationSnapshot,\n          previousNextUrl: action.previousNextUrl,\n          renderId: action.renderId,\n          rootLayoutTreePath: action.rootLayoutTreePath,\n          routeId: action.routeId,\n        },\n        action.operation,\n      );\n    case \"replace\":\n      return commitVisibleRouterState(\n        state,\n        {\n          elements: action.elements,\n          interceptionContext: action.interceptionContext,\n          layoutFlags: action.layoutFlags,\n          navigationSnapshot: action.navigationSnapshot,\n          previousNextUrl: action.previousNextUrl,\n          renderId: action.renderId,\n          rootLayoutTreePath: action.rootLayoutTreePath,\n          routeId: action.routeId,\n        },\n        action.operation,\n      );\n    default: {\n      const _exhaustive: never = action.type;\n      throw new Error(\"[vinext] Unknown router action: \" + String(_exhaustive));\n    }\n  }\n}\n\nfunction resolvePendingNavigationCommitDecision(options: {\n  activeNavigationId: number;\n  currentVisibleCommitVersion: number;\n  currentRootLayoutTreePath: string | null;\n  nextRootLayoutTreePath: string | null;\n  startedNavigationId: number;\n  startedVisibleCommitVersion: number;\n}): CommitDecision {\n  const { disposition, trace } = resolvePendingNavigationCommitDispositionDecision(options);\n\n  switch (disposition) {\n    case \"skip\":\n      return { disposition: \"no-commit\", trace };\n    case \"hard-navigate\":\n      return { disposition: \"hard-navigate\", trace };\n    case \"dispatch\":\n      return createVisibleCommitDecision(trace);\n    default: {\n      const _exhaustive: never = disposition;\n      throw new Error(\"[vinext] Unknown navigation commit disposition: \" + String(_exhaustive));\n    }\n  }\n}\n\nfunction createVisibleCommitDecision(\n  trace: NavigationTrace = createNavigationTrace(NavigationTraceReasonCodes.commitCurrent),\n): VisibleCommitDecision {\n  return { disposition: \"commit\", trace };\n}\n\nfunction createApprovedVisibleCommit(options: {\n  decision: VisibleCommitDecision;\n  pending: PendingNavigationCommit;\n}): ApprovedVisibleCommit {\n  return {\n    [approvedVisibleCommitBrand]: true,\n    action: options.pending.action,\n    decision: options.decision,\n    interceptionContext: options.pending.interceptionContext,\n    previousNextUrl: options.pending.previousNextUrl,\n    rootLayoutTreePath: options.pending.rootLayoutTreePath,\n    routeId: options.pending.routeId,\n  };\n}\n\nfunction createCommitTransactionFields(pending: PendingNavigationCommit): NavigationTraceFields {\n  return {\n    operationLane: pending.action.operation.lane,\n    pendingOperationId: pending.action.operation.id,\n    startedVisibleCommitVersion: pending.action.operation.startedVisibleCommitVersion,\n  };\n}\n\nfunction prependCommitTransactionTrace(\n  trace: NavigationTrace,\n  code: NavigationTraceTransactionCode,\n  pending: PendingNavigationCommit,\n): NavigationTrace {\n  return prependNavigationTraceEntry(trace, code, createCommitTransactionFields(pending));\n}\n\nfunction addCommitTransactionTrace(\n  decision: CommitDecision,\n  pending: PendingNavigationCommit,\n): CommitDecision {\n  switch (decision.disposition) {\n    case \"commit\":\n      return {\n        ...decision,\n        trace: prependCommitTransactionTrace(\n          decision.trace,\n          NavigationTraceTransactionCodes.visibleCommit,\n          pending,\n        ),\n      };\n    case \"hard-navigate\":\n      return {\n        ...decision,\n        trace: prependCommitTransactionTrace(\n          decision.trace,\n          NavigationTraceTransactionCodes.hardNavigate,\n          pending,\n        ),\n      };\n    case \"no-commit\":\n      return {\n        ...decision,\n        trace: prependCommitTransactionTrace(\n          decision.trace,\n          NavigationTraceTransactionCodes.noCommit,\n          pending,\n        ),\n      };\n    default: {\n      const _exhaustive: never = decision;\n      throw new Error(\"[vinext] Unknown commit decision: \" + String(_exhaustive));\n    }\n  }\n}\n\nexport function approveHmrVisibleCommit(pending: PendingNavigationCommit): ApprovedVisibleCommit {\n  if (pending.action.operation.lane !== \"hmr\") {\n    throw new Error(\"[vinext] HMR visible commit approval requires an HMR pending operation\");\n  }\n\n  const decision = addCommitTransactionTrace(createVisibleCommitDecision(), pending);\n  // This guard is a type narrowing assertion: createVisibleCommitDecision()\n  // structurally produces a commit decision, and addCommitTransactionTrace()\n  // must preserve that disposition while adding operator trace context.\n  if (decision.disposition !== \"commit\") {\n    throw new Error(\"[vinext] HMR visible commit approval did not produce a commit decision\");\n  }\n\n  return createApprovedVisibleCommit({\n    decision,\n    pending,\n  });\n}\n\nexport function approvePendingNavigationCommit(options: {\n  activeNavigationId: number;\n  currentState: AppRouterState;\n  pending: PendingNavigationCommit;\n  startedNavigationId: number;\n}): CommitApproval {\n  const decision = addCommitTransactionTrace(\n    resolvePendingNavigationCommitDecision({\n      activeNavigationId: options.activeNavigationId,\n      currentVisibleCommitVersion: options.currentState.visibleCommitVersion,\n      currentRootLayoutTreePath: options.currentState.rootLayoutTreePath,\n      nextRootLayoutTreePath: options.pending.rootLayoutTreePath,\n      startedNavigationId: options.startedNavigationId,\n      startedVisibleCommitVersion: options.pending.action.operation.startedVisibleCommitVersion,\n    }),\n    options.pending,\n  );\n\n  switch (decision.disposition) {\n    case \"commit\":\n      return {\n        approvedCommit: createApprovedVisibleCommit({\n          decision,\n          pending: options.pending,\n        }),\n        decision,\n      };\n    case \"hard-navigate\":\n    case \"no-commit\":\n      return {\n        approvedCommit: null,\n        decision,\n      };\n    default: {\n      const _exhaustive: never = decision;\n      throw new Error(\"[vinext] Unknown commit decision: \" + String(_exhaustive));\n    }\n  }\n}\n\nexport async function resolveAndClassifyNavigationCommit(options: {\n  activeNavigationId: number;\n  currentState: AppRouterState;\n  // When provided, these getters are called after awaiting nextElements so\n  // approval uses the latest lifecycle authority instead of the call snapshot.\n  getActiveNavigationId?: () => number;\n  getCurrentStateForApproval?: () => AppRouterState;\n  navigationSnapshot: ClientNavigationRenderSnapshot;\n  nextElements: Promise<AppElements>;\n  operationLane: OperationLane;\n  previousNextUrl?: string | null;\n  renderId: number;\n  startedNavigationId: number;\n  type: \"navigate\" | \"replace\" | \"traverse\";\n}): Promise<ClassifiedPendingNavigationCommit> {\n  const pending = await createPendingNavigationCommit({\n    currentState: options.currentState,\n    nextElements: options.nextElements,\n    navigationSnapshot: options.navigationSnapshot,\n    operationLane: options.operationLane,\n    previousNextUrl: options.previousNextUrl,\n    renderId: options.renderId,\n    type: options.type,\n  });\n\n  const approvalState = options.getCurrentStateForApproval?.() ?? options.currentState;\n  const approval = approvePendingNavigationCommit({\n    activeNavigationId: options.getActiveNavigationId?.() ?? options.activeNavigationId,\n    currentState: approvalState,\n    pending,\n    startedNavigationId: options.startedNavigationId,\n  });\n\n  return {\n    approvedCommit: approval.approvedCommit,\n    decision: approval.decision,\n    pending,\n    trace: approval.decision.trace,\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"app-browser-visible-commit.js","names":["_exhaustive"],"sources":["../../src/server/app-browser-visible-commit.ts"],"sourcesContent":["import type { ClientNavigationRenderSnapshot } from \"vinext/shims/navigation\";\nimport { mergeElements } from \"vinext/shims/slot\";\nimport type { AppElements } from \"./app-elements.js\";\nimport {\n  createPendingNavigationCommit,\n  resolvePendingNavigationCommitDispositionDecision,\n  type AppRouterAction,\n  type AppRouterState,\n  type CommittedOperationRecord,\n  type OperationLane,\n  type PendingNavigationCommit,\n  type PendingOperationRecord,\n} from \"./app-browser-state.js\";\nimport {\n  NavigationTraceReasonCodes,\n  NavigationTraceTransactionCodes,\n  createNavigationTrace,\n  prependNavigationTraceEntry,\n  type NavigationTrace,\n  type NavigationTraceFields,\n  type NavigationTraceTransactionCode,\n} from \"./navigation-trace.js\";\n\ntype VisibleCommitDecision = {\n  disposition: \"commit\";\n  preserveAbsentSlots: boolean;\n  preserveElementIds: readonly string[];\n  trace: NavigationTrace;\n};\ntype HardNavigateCommitDecision = {\n  disposition: \"hard-navigate\";\n  trace: NavigationTrace;\n};\ntype NoCommitDecision = {\n  disposition: \"no-commit\";\n  trace: NavigationTrace;\n};\ntype CommitDecision = VisibleCommitDecision | HardNavigateCommitDecision | NoCommitDecision;\nconst approvedVisibleCommitBrand: unique symbol = Symbol(\"ApprovedVisibleCommit\");\nexport type ApprovedVisibleCommit = {\n  readonly [approvedVisibleCommitBrand]: true;\n  readonly action: AppRouterAction;\n  readonly decision: VisibleCommitDecision;\n  readonly interceptionContext: string | null;\n  readonly previousNextUrl: string | null;\n  readonly rootLayoutTreePath: string | null;\n  readonly routeId: string;\n};\ntype VisibleCommitApproval = {\n  approvedCommit: ApprovedVisibleCommit;\n  decision: VisibleCommitDecision;\n};\ntype NonVisibleCommitApproval = {\n  approvedCommit: null;\n  decision: HardNavigateCommitDecision | NoCommitDecision;\n};\ntype CommitApproval = VisibleCommitApproval | NonVisibleCommitApproval;\ntype ClassifiedPendingNavigationCommit = {\n  approvedCommit: ApprovedVisibleCommit | null;\n  decision: CommitDecision;\n  pending: PendingNavigationCommit;\n  trace: NavigationTrace;\n};\n\nexport function applyApprovedVisibleCommit(\n  state: AppRouterState,\n  commit: ApprovedVisibleCommit,\n): AppRouterState {\n  assertApprovedVisibleCommit(commit);\n  return reduceApprovedVisibleCommitState(state, commit);\n}\n\nfunction assertApprovedVisibleCommit(commit: ApprovedVisibleCommit): void {\n  if (commit[approvedVisibleCommitBrand] !== true) {\n    throw new Error(\"[vinext] Visible router state mutation requires ApprovedVisibleCommit\");\n  }\n}\n\nfunction commitOperationRecord(\n  operation: PendingOperationRecord,\n  visibleCommitVersion: number,\n): CommittedOperationRecord {\n  return {\n    id: operation.id,\n    lane: operation.lane,\n    startedVisibleCommitVersion: operation.startedVisibleCommitVersion,\n    state: \"committed\",\n    visibleCommitVersion,\n  };\n}\n\nfunction commitVisibleRouterState(\n  state: AppRouterState,\n  nextState: Omit<AppRouterState, \"activeOperation\" | \"visibleCommitVersion\">,\n  operation: PendingOperationRecord,\n): AppRouterState {\n  // Single owner for visibleCommitVersion: only an ApprovedVisibleCommit may\n  // advance it, and every accepted visible mutation advances it exactly once.\n  const visibleCommitVersion = state.visibleCommitVersion + 1;\n  return {\n    ...nextState,\n    activeOperation: commitOperationRecord(operation, visibleCommitVersion),\n    visibleCommitVersion,\n  };\n}\n\nfunction reduceApprovedVisibleCommitState(\n  state: AppRouterState,\n  commit: ApprovedVisibleCommit,\n): AppRouterState {\n  const { action } = commit;\n  switch (action.type) {\n    case \"traverse\":\n    case \"navigate\":\n      return commitVisibleRouterState(\n        state,\n        {\n          elements: mergeElements(state.elements, action.elements, {\n            clearAbsentSlots: action.type === \"traverse\",\n            preserveAbsentSlots: commit.decision.preserveAbsentSlots,\n            preserveElementIds: commit.decision.preserveElementIds,\n          }),\n          interceptionContext: action.interceptionContext,\n          layoutFlags: mergeLayoutFlags(\n            state.layoutFlags,\n            action.layoutFlags,\n            commit.decision.preserveElementIds,\n          ),\n          layoutIds: action.layoutIds,\n          navigationSnapshot: action.navigationSnapshot,\n          previousNextUrl: action.previousNextUrl,\n          renderId: action.renderId,\n          rootLayoutTreePath: action.rootLayoutTreePath,\n          routeId: action.routeId,\n        },\n        action.operation,\n      );\n    case \"replace\":\n      return commitVisibleRouterState(\n        state,\n        {\n          elements: action.elements,\n          interceptionContext: action.interceptionContext,\n          layoutFlags: action.layoutFlags,\n          layoutIds: action.layoutIds,\n          navigationSnapshot: action.navigationSnapshot,\n          previousNextUrl: action.previousNextUrl,\n          renderId: action.renderId,\n          rootLayoutTreePath: action.rootLayoutTreePath,\n          routeId: action.routeId,\n        },\n        action.operation,\n      );\n    default: {\n      const _exhaustive: never = action.type;\n      throw new Error(\"[vinext] Unknown router action: \" + String(_exhaustive));\n    }\n  }\n}\n\nfunction resolvePendingNavigationCommitDecision(options: {\n  activeNavigationId: number;\n  currentState: AppRouterState;\n  pending: PendingNavigationCommit;\n  startedNavigationId: number;\n  targetHref: string;\n}): CommitDecision {\n  const decision = resolvePendingNavigationCommitDispositionDecision(options);\n\n  switch (decision.disposition) {\n    case \"skip\":\n      return { disposition: \"no-commit\", trace: decision.trace };\n    case \"hard-navigate\":\n      return { disposition: \"hard-navigate\", trace: decision.trace };\n    case \"dispatch\":\n      return createVisibleCommitDecision(\n        decision.trace,\n        decision.preserveElementIds,\n        decision.preserveAbsentSlots,\n      );\n    default: {\n      const _exhaustive: never = decision;\n      throw new Error(\"[vinext] Unknown navigation commit disposition: \" + String(_exhaustive));\n    }\n  }\n}\n\nfunction createVisibleCommitDecision(\n  trace: NavigationTrace = createNavigationTrace(NavigationTraceReasonCodes.commitCurrent),\n  preserveElementIds: readonly string[] = [],\n  preserveAbsentSlots: boolean = false,\n): VisibleCommitDecision {\n  return {\n    disposition: \"commit\",\n    preserveAbsentSlots,\n    preserveElementIds: [...preserveElementIds],\n    trace,\n  };\n}\n\nfunction mergeLayoutFlags(\n  previousFlags: AppRouterState[\"layoutFlags\"],\n  nextFlags: AppRouterState[\"layoutFlags\"],\n  preserveElementIds: readonly string[],\n): AppRouterState[\"layoutFlags\"] {\n  const merged: Record<string, \"s\" | \"d\"> = { ...nextFlags };\n  for (const id of preserveElementIds) {\n    if (Object.hasOwn(merged, id)) continue;\n    const value = previousFlags[id];\n    if (value) merged[id] = value;\n  }\n  return merged;\n}\n\nfunction createApprovedVisibleCommit(options: {\n  decision: VisibleCommitDecision;\n  pending: PendingNavigationCommit;\n}): ApprovedVisibleCommit {\n  return {\n    [approvedVisibleCommitBrand]: true,\n    action: options.pending.action,\n    decision: options.decision,\n    interceptionContext: options.pending.interceptionContext,\n    previousNextUrl: options.pending.previousNextUrl,\n    rootLayoutTreePath: options.pending.rootLayoutTreePath,\n    routeId: options.pending.routeId,\n  };\n}\n\nfunction createCommitTransactionFields(pending: PendingNavigationCommit): NavigationTraceFields {\n  return {\n    operationLane: pending.action.operation.lane,\n    pendingOperationId: pending.action.operation.id,\n    startedVisibleCommitVersion: pending.action.operation.startedVisibleCommitVersion,\n  };\n}\n\nfunction prependCommitTransactionTrace(\n  trace: NavigationTrace,\n  code: NavigationTraceTransactionCode,\n  pending: PendingNavigationCommit,\n): NavigationTrace {\n  return prependNavigationTraceEntry(trace, code, createCommitTransactionFields(pending));\n}\n\nfunction addCommitTransactionTrace(\n  decision: CommitDecision,\n  pending: PendingNavigationCommit,\n): CommitDecision {\n  switch (decision.disposition) {\n    case \"commit\":\n      return {\n        ...decision,\n        trace: prependCommitTransactionTrace(\n          decision.trace,\n          NavigationTraceTransactionCodes.visibleCommit,\n          pending,\n        ),\n      };\n    case \"hard-navigate\":\n      return {\n        ...decision,\n        trace: prependCommitTransactionTrace(\n          decision.trace,\n          NavigationTraceTransactionCodes.hardNavigate,\n          pending,\n        ),\n      };\n    case \"no-commit\":\n      return {\n        ...decision,\n        trace: prependCommitTransactionTrace(\n          decision.trace,\n          NavigationTraceTransactionCodes.noCommit,\n          pending,\n        ),\n      };\n    default: {\n      const _exhaustive: never = decision;\n      throw new Error(\"[vinext] Unknown commit decision: \" + String(_exhaustive));\n    }\n  }\n}\n\nexport function approveHmrVisibleCommit(pending: PendingNavigationCommit): ApprovedVisibleCommit {\n  if (pending.action.operation.lane !== \"hmr\") {\n    throw new Error(\"[vinext] HMR visible commit approval requires an HMR pending operation\");\n  }\n\n  const decision = addCommitTransactionTrace(createVisibleCommitDecision(), pending);\n  // This guard is a type narrowing assertion: createVisibleCommitDecision()\n  // structurally produces a commit decision, and addCommitTransactionTrace()\n  // must preserve that disposition while adding operator trace context.\n  if (decision.disposition !== \"commit\") {\n    throw new Error(\"[vinext] HMR visible commit approval did not produce a commit decision\");\n  }\n\n  return createApprovedVisibleCommit({\n    decision,\n    pending,\n  });\n}\n\nexport function approvePendingNavigationCommit(options: {\n  activeNavigationId: number;\n  currentState: AppRouterState;\n  pending: PendingNavigationCommit;\n  startedNavigationId: number;\n  targetHref: string;\n}): CommitApproval {\n  const decision = addCommitTransactionTrace(\n    resolvePendingNavigationCommitDecision({\n      activeNavigationId: options.activeNavigationId,\n      currentState: options.currentState,\n      pending: options.pending,\n      startedNavigationId: options.startedNavigationId,\n      targetHref: options.targetHref,\n    }),\n    options.pending,\n  );\n\n  switch (decision.disposition) {\n    case \"commit\":\n      return {\n        approvedCommit: createApprovedVisibleCommit({\n          decision,\n          pending: options.pending,\n        }),\n        decision,\n      };\n    case \"hard-navigate\":\n    case \"no-commit\":\n      return {\n        approvedCommit: null,\n        decision,\n      };\n    default: {\n      const _exhaustive: never = decision;\n      throw new Error(\"[vinext] Unknown commit decision: \" + String(_exhaustive));\n    }\n  }\n}\n\nexport async function resolveAndClassifyNavigationCommit(options: {\n  activeNavigationId: number;\n  currentState: AppRouterState;\n  // When provided, these getters are called after awaiting nextElements so\n  // approval uses the latest lifecycle authority instead of the call snapshot.\n  getActiveNavigationId?: () => number;\n  getCurrentStateForApproval?: () => AppRouterState;\n  navigationSnapshot: ClientNavigationRenderSnapshot;\n  nextElements: Promise<AppElements>;\n  operationLane: OperationLane;\n  previousNextUrl?: string | null;\n  renderId: number;\n  startedNavigationId: number;\n  targetHref: string;\n  type: \"navigate\" | \"replace\" | \"traverse\";\n}): Promise<ClassifiedPendingNavigationCommit> {\n  const pending = await createPendingNavigationCommit({\n    currentState: options.currentState,\n    nextElements: options.nextElements,\n    navigationSnapshot: options.navigationSnapshot,\n    operationLane: options.operationLane,\n    previousNextUrl: options.previousNextUrl,\n    renderId: options.renderId,\n    type: options.type,\n  });\n\n  const approvalState = options.getCurrentStateForApproval?.() ?? options.currentState;\n  const approval = approvePendingNavigationCommit({\n    activeNavigationId: options.getActiveNavigationId?.() ?? options.activeNavigationId,\n    currentState: approvalState,\n    pending,\n    startedNavigationId: options.startedNavigationId,\n    targetHref: options.targetHref,\n  });\n\n  return {\n    approvedCommit: approval.approvedCommit,\n    decision: approval.decision,\n    pending,\n    trace: approval.decision.trace,\n  };\n}\n"],"mappings":"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"}

package/dist/server/app-client-reference-preloader.js.map

@@ -1 +1 @@
-{"version":3,"file":"app-client-reference-preloader.js","names":[],"sources":["../../src/server/app-client-reference-preloader.ts"],"sourcesContent":["type ClientReferenceRequire = (id: string) => Promise<unknown>;\n\ntype ClientReferenceMap = Readonly<Record<string, unknown>>;\n\ntype ClientReferencePreloaderOptions = {\n  getReferences: () => ClientReferenceMap | undefined;\n  getClientRequire: () => ClientReferenceRequire | undefined;\n  onPreloadError?: (id: string, error: unknown) => void;\n};\n\ntype ClientReferencePreloader = {\n  preload: (referenceIds?: Iterable<string>) => Promise<void>;\n};\n\nconst resolvedPreload = Promise.resolve();\n\nexport function createClientReferencePreloader(\n  options: ClientReferencePreloaderOptions,\n): ClientReferencePreloader {\n  let allReferencesPreloaded = false;\n  let allReferencesPreloadPromise: Promise<void> | null = null;\n  const preloadedReferences = new Set<string>();\n  const referencePreloadPromises = new Map<string, Promise<void>>();\n\n  function preloadReference(id: string, clientRequire: ClientReferenceRequire): Promise<void> {\n    if (preloadedReferences.has(id)) {\n      return resolvedPreload;\n    }\n\n    const existing = referencePreloadPromises.get(id);\n    if (existing) {\n      return existing;\n    }\n\n    const preloadPromise = clientRequire(id)\n      .catch((error) => {\n        options.onPreloadError?.(id, error);\n      })\n      .then(() => {\n        preloadedReferences.add(id);\n      })\n      .finally(() => {\n        referencePreloadPromises.delete(id);\n      });\n\n    referencePreloadPromises.set(id, preloadPromise);\n    return preloadPromise;\n  }\n\n  function preloadReferenceSet(\n    referenceIds: Iterable<string>,\n    refs: ClientReferenceMap,\n    clientRequire: ClientReferenceRequire,\n  ): Promise<void> {\n    const pending: Promise<void>[] = [];\n\n    for (const id of referenceIds) {\n      if (Object.hasOwn(refs, id)) {\n        pending.push(preloadReference(id, clientRequire));\n      }\n    }\n\n    if (pending.length === 0) {\n      return resolvedPreload;\n    }\n\n    return Promise.all(pending).then(() => {});\n  }\n\n  return {\n    preload(referenceIds) {\n      const refs = options.getReferences();\n      const clientRequire = options.getClientRequire();\n      if (!refs || !clientRequire) {\n        return resolvedPreload;\n      }\n\n      if (referenceIds) {\n        return preloadReferenceSet(referenceIds, refs, clientRequire);\n      }\n\n      if (allReferencesPreloaded) {\n        return resolvedPreload;\n      }\n      if (allReferencesPreloadPromise) {\n        return allReferencesPreloadPromise;\n      }\n\n      allReferencesPreloadPromise = preloadReferenceSet(Object.keys(refs), refs, clientRequire)\n        .then(() => {\n          allReferencesPreloaded = true;\n        })\n        .finally(() => {\n          allReferencesPreloadPromise = null;\n        });\n\n      return allReferencesPreloadPromise;\n    },\n  };\n}\n"],"mappings":";AAcA,MAAM,kBAAkB,QAAQ,SAAS;AAEzC,SAAgB,+BACd,SAC0B;CAC1B,IAAI,yBAAyB;CAC7B,IAAI,8BAAoD;CACxD,MAAM,sCAAsB,IAAI,KAAa;CAC7C,MAAM,2CAA2B,IAAI,KAA4B;CAEjE,SAAS,iBAAiB,IAAY,eAAsD;AAC1F,MAAI,oBAAoB,IAAI,GAAG,CAC7B,QAAO;EAGT,MAAM,WAAW,yBAAyB,IAAI,GAAG;AACjD,MAAI,SACF,QAAO;EAGT,MAAM,iBAAiB,cAAc,GAAG,CACrC,OAAO,UAAU;AAChB,WAAQ,iBAAiB,IAAI,MAAM;IACnC,CACD,WAAW;AACV,uBAAoB,IAAI,GAAG;IAC3B,CACD,cAAc;AACb,4BAAyB,OAAO,GAAG;IACnC;AAEJ,2BAAyB,IAAI,IAAI,eAAe;AAChD,SAAO;;CAGT,SAAS,oBACP,cACA,MACA,eACe;EACf,MAAM,UAA2B,EAAE;AAEnC,OAAK,MAAM,MAAM,aACf,KAAI,OAAO,OAAO,MAAM,GAAG,CACzB,SAAQ,KAAK,iBAAiB,IAAI,cAAc,CAAC;AAIrD,MAAI,QAAQ,WAAW,EACrB,QAAO;AAGT,SAAO,QAAQ,IAAI,QAAQ,CAAC,WAAW,GAAG;;AAG5C,QAAO,EACL,QAAQ,cAAc;EACpB,MAAM,OAAO,QAAQ,eAAe;EACpC,MAAM,gBAAgB,QAAQ,kBAAkB;AAChD,MAAI,CAAC,QAAQ,CAAC,cACZ,QAAO;AAGT,MAAI,aACF,QAAO,oBAAoB,cAAc,MAAM,cAAc;AAG/D,MAAI,uBACF,QAAO;AAET,MAAI,4BACF,QAAO;AAGT,gCAA8B,oBAAoB,OAAO,KAAK,KAAK,EAAE,MAAM,cAAc,CACtF,WAAW;AACV,4BAAyB;IACzB,CACD,cAAc;AACb,iCAA8B;IAC9B;AAEJ,SAAO;IAEV"}
+{"version":3,"file":"app-client-reference-preloader.js","names":[],"sources":["../../src/server/app-client-reference-preloader.ts"],"sourcesContent":["type ClientReferenceRequire = (id: string) => Promise<unknown>;\n\ntype ClientReferenceMap = Readonly<Record<string, unknown>>;\n\ntype ClientReferencePreloaderOptions = {\n  getReferences: () => ClientReferenceMap | undefined;\n  getClientRequire: () => ClientReferenceRequire | undefined;\n  onPreloadError?: (id: string, error: unknown) => void;\n};\n\ntype ClientReferencePreloader = {\n  preload: (referenceIds?: Iterable<string>) => Promise<void>;\n};\n\nconst resolvedPreload = Promise.resolve();\n\nexport function createClientReferencePreloader(\n  options: ClientReferencePreloaderOptions,\n): ClientReferencePreloader {\n  let allReferencesPreloaded = false;\n  let allReferencesPreloadPromise: Promise<void> | null = null;\n  const preloadedReferences = new Set<string>();\n  const referencePreloadPromises = new Map<string, Promise<void>>();\n\n  function preloadReference(id: string, clientRequire: ClientReferenceRequire): Promise<void> {\n    if (preloadedReferences.has(id)) {\n      return resolvedPreload;\n    }\n\n    const existing = referencePreloadPromises.get(id);\n    if (existing) {\n      return existing;\n    }\n\n    const preloadPromise = clientRequire(id)\n      .catch((error) => {\n        options.onPreloadError?.(id, error);\n      })\n      .then(() => {\n        preloadedReferences.add(id);\n      })\n      .finally(() => {\n        referencePreloadPromises.delete(id);\n      });\n\n    referencePreloadPromises.set(id, preloadPromise);\n    return preloadPromise;\n  }\n\n  function preloadReferenceSet(\n    referenceIds: Iterable<string>,\n    refs: ClientReferenceMap,\n    clientRequire: ClientReferenceRequire,\n  ): Promise<void> {\n    const pending: Promise<void>[] = [];\n\n    for (const id of referenceIds) {\n      if (Object.hasOwn(refs, id)) {\n        pending.push(preloadReference(id, clientRequire));\n      }\n    }\n\n    if (pending.length === 0) {\n      return resolvedPreload;\n    }\n\n    return Promise.all(pending).then(() => {});\n  }\n\n  return {\n    preload(referenceIds) {\n      const refs = options.getReferences();\n      const clientRequire = options.getClientRequire();\n      if (!refs || !clientRequire) {\n        return resolvedPreload;\n      }\n\n      if (referenceIds) {\n        return preloadReferenceSet(referenceIds, refs, clientRequire);\n      }\n\n      if (allReferencesPreloaded) {\n        return resolvedPreload;\n      }\n      if (allReferencesPreloadPromise) {\n        return allReferencesPreloadPromise;\n      }\n\n      allReferencesPreloadPromise = preloadReferenceSet(Object.keys(refs), refs, clientRequire)\n        .then(() => {\n          allReferencesPreloaded = true;\n        })\n        .finally(() => {\n          allReferencesPreloadPromise = null;\n        });\n\n      return allReferencesPreloadPromise;\n    },\n  };\n}\n"],"mappings":";AAcA,MAAM,kBAAkB,QAAQ,SAAS;AAEzC,SAAgB,+BACd,SAC0B;CAC1B,IAAI,yBAAyB;CAC7B,IAAI,8BAAoD;CACxD,MAAM,sCAAsB,IAAI,KAAa;CAC7C,MAAM,2CAA2B,IAAI,KAA4B;CAEjE,SAAS,iBAAiB,IAAY,eAAsD;EAC1F,IAAI,oBAAoB,IAAI,GAAG,EAC7B,OAAO;EAGT,MAAM,WAAW,yBAAyB,IAAI,GAAG;EACjD,IAAI,UACF,OAAO;EAGT,MAAM,iBAAiB,cAAc,GAAG,CACrC,OAAO,UAAU;GAChB,QAAQ,iBAAiB,IAAI,MAAM;IACnC,CACD,WAAW;GACV,oBAAoB,IAAI,GAAG;IAC3B,CACD,cAAc;GACb,yBAAyB,OAAO,GAAG;IACnC;EAEJ,yBAAyB,IAAI,IAAI,eAAe;EAChD,OAAO;;CAGT,SAAS,oBACP,cACA,MACA,eACe;EACf,MAAM,UAA2B,EAAE;EAEnC,KAAK,MAAM,MAAM,cACf,IAAI,OAAO,OAAO,MAAM,GAAG,EACzB,QAAQ,KAAK,iBAAiB,IAAI,cAAc,CAAC;EAIrD,IAAI,QAAQ,WAAW,GACrB,OAAO;EAGT,OAAO,QAAQ,IAAI,QAAQ,CAAC,WAAW,GAAG;;CAG5C,OAAO,EACL,QAAQ,cAAc;EACpB,MAAM,OAAO,QAAQ,eAAe;EACpC,MAAM,gBAAgB,QAAQ,kBAAkB;EAChD,IAAI,CAAC,QAAQ,CAAC,eACZ,OAAO;EAGT,IAAI,cACF,OAAO,oBAAoB,cAAc,MAAM,cAAc;EAG/D,IAAI,wBACF,OAAO;EAET,IAAI,6BACF,OAAO;EAGT,8BAA8B,oBAAoB,OAAO,KAAK,KAAK,EAAE,MAAM,cAAc,CACtF,WAAW;GACV,yBAAyB;IACzB,CACD,cAAc;GACb,8BAA8B;IAC9B;EAEJ,OAAO;IAEV"}

package/dist/server/app-elements-wire.d.ts

@@ -4,6 +4,7 @@ import { ReactNode } from "react";
 //#region src/server/app-elements-wire.d.ts
 declare const APP_ARTIFACT_COMPATIBILITY_KEY = "__artifactCompatibility";
 declare const APP_INTERCEPTION_CONTEXT_KEY = "__interceptionContext";
+declare const APP_LAYOUT_IDS_KEY = "__layoutIds";
 declare const APP_LAYOUT_FLAGS_KEY = "__layoutFlags";
 declare const APP_ROUTE_KEY = "__route";
 declare const APP_ROOT_LAYOUT_KEY = "__rootLayout";
@@ -34,6 +35,7 @@ type LayoutFlags = Readonly<Record<string, "s" | "d">>;
 type AppElementsMetadata = {
   artifactCompatibility: ArtifactCompatibilityEnvelope;
   interceptionContext: string | null;
+  layoutIds: readonly string[];
   layoutFlags: LayoutFlags;
   routeId: string;
   rootLayoutTreePath: string | null;
@@ -59,12 +61,14 @@ type AppElementsWireElementKey = {
 };
 type AppElementsWireMetadataInput = {
   interceptionContext: string | null;
+  layoutIds?: readonly string[];
   routeId: string;
   rootLayoutTreePath: string | null;
 };
 type AppElementsWireMetadataEntries = Readonly<{
   [APP_ROUTE_KEY]: string;
   [APP_INTERCEPTION_CONTEXT_KEY]: string | null;
+  [APP_LAYOUT_IDS_KEY]: readonly string[];
   [APP_ROOT_LAYOUT_KEY]: string | null;
 }>;
 /**
@@ -77,6 +81,7 @@ type AppOutgoingElements = Readonly<Record<string, ReactNode | LayoutFlags | Art
 type AppElementsWireKeys = {
   readonly artifactCompatibility: typeof APP_ARTIFACT_COMPATIBILITY_KEY;
   readonly interceptionContext: typeof APP_INTERCEPTION_CONTEXT_KEY;
+  readonly layoutIds: typeof APP_LAYOUT_IDS_KEY;
   readonly layoutFlags: typeof APP_LAYOUT_FLAGS_KEY;
   readonly rootLayout: typeof APP_ROOT_LAYOUT_KEY;
   readonly route: typeof APP_ROUTE_KEY;
@@ -126,5 +131,5 @@ declare function buildOutgoingAppPayload(input: {
 declare function readAppElementsMetadata(elements: Readonly<Record<string, unknown>>): AppElementsMetadata;
 declare const AppElementsWire: AppElementsWireCodec;
 //#endregion
-export { APP_ARTIFACT_COMPATIBILITY_KEY, APP_INTERCEPTION_CONTEXT_KEY, APP_LAYOUT_FLAGS_KEY, APP_ROOT_LAYOUT_KEY, APP_ROUTE_KEY, APP_UNMATCHED_SLOT_WIRE_VALUE, AppElementValue, AppElements, AppElementsWire, AppOutgoingElements, AppWireElements, LayoutFlags, UNMATCHED_SLOT, buildOutgoingAppPayload, isAppElementsRecord, normalizeAppElements, readAppElementsMetadata, withLayoutFlags };
+export { APP_ARTIFACT_COMPATIBILITY_KEY, APP_INTERCEPTION_CONTEXT_KEY, APP_LAYOUT_FLAGS_KEY, APP_LAYOUT_IDS_KEY, APP_ROOT_LAYOUT_KEY, APP_ROUTE_KEY, APP_UNMATCHED_SLOT_WIRE_VALUE, AppElementValue, AppElements, AppElementsWire, AppOutgoingElements, AppWireElements, LayoutFlags, UNMATCHED_SLOT, buildOutgoingAppPayload, isAppElementsRecord, normalizeAppElements, readAppElementsMetadata, withLayoutFlags };
 //# sourceMappingURL=app-elements-wire.d.ts.map

package/dist/server/app-elements-wire.js

@@ -4,6 +4,7 @@ import { isValidElement } from "react";
 const APP_INTERCEPTION_SEPARATOR = "\0";
 const APP_ARTIFACT_COMPATIBILITY_KEY = "__artifactCompatibility";
 const APP_INTERCEPTION_CONTEXT_KEY = "__interceptionContext";
+const APP_LAYOUT_IDS_KEY = "__layoutIds";
 const APP_LAYOUT_FLAGS_KEY = "__layoutFlags";
 const APP_ROUTE_KEY = "__route";
 const APP_ROOT_LAYOUT_KEY = "__rootLayout";
@@ -103,6 +104,7 @@ function createAppElementsWireMetadataEntries(input) {
 	return {
 		[APP_ROUTE_KEY]: input.routeId,
 		[APP_INTERCEPTION_CONTEXT_KEY]: input.interceptionContext,
+		[APP_LAYOUT_IDS_KEY]: [...input.layoutIds ?? []],
 		[APP_ROOT_LAYOUT_KEY]: input.rootLayoutTreePath
 	};
 }
@@ -126,6 +128,17 @@ function parseLayoutFlags(value) {
 	if (isLayoutFlagsRecord(value)) return value;
 	return {};
 }
+function parseLayoutIds(value) {
+	if (value === void 0) return [];
+	if (!Array.isArray(value)) throw new Error("[vinext] Invalid __layoutIds in App Router payload: expected layout id string[]");
+	const layoutIds = [];
+	for (const entry of value) {
+		if (typeof entry !== "string") throw new Error("[vinext] Invalid __layoutIds in App Router payload: expected layout id string[]");
+		if (parseAppElementsWireElementKey(entry)?.kind !== "layout") throw new Error("[vinext] Invalid __layoutIds in App Router payload: expected layout ids");
+		layoutIds.push(entry);
+	}
+	return layoutIds;
+}
 /**
 * Type predicate for a plain (non-null, non-array) record of app payload values.
 * Used to distinguish the App Router payload object from bare React elements at
@@ -168,9 +181,11 @@ function readAppElementsMetadata(elements) {
 	if (rootLayoutTreePath === void 0) throw new Error("[vinext] Missing __rootLayout key in App Router payload");
 	if (rootLayoutTreePath !== null && typeof rootLayoutTreePath !== "string") throw new Error("[vinext] Invalid __rootLayout in App Router payload: expected string or null");
 	const layoutFlags = parseLayoutFlags(elements[APP_LAYOUT_FLAGS_KEY]);
+	const layoutIds = parseLayoutIds(elements[APP_LAYOUT_IDS_KEY]);
 	return {
 		artifactCompatibility: readArtifactCompatibilityMetadata(elements[APP_ARTIFACT_COMPATIBILITY_KEY]),
 		interceptionContext: interceptionContext ?? null,
+		layoutIds,
 		layoutFlags,
 		routeId,
 		rootLayoutTreePath
@@ -180,6 +195,7 @@ const AppElementsWire = {
 	keys: {
 		artifactCompatibility: APP_ARTIFACT_COMPATIBILITY_KEY,
 		interceptionContext: APP_INTERCEPTION_CONTEXT_KEY,
+		layoutIds: APP_LAYOUT_IDS_KEY,
 		layoutFlags: APP_LAYOUT_FLAGS_KEY,
 		rootLayout: APP_ROOT_LAYOUT_KEY,
 		route: APP_ROUTE_KEY
@@ -200,6 +216,6 @@ const AppElementsWire = {
 	withLayoutFlags
 };
 //#endregion
-export { APP_ARTIFACT_COMPATIBILITY_KEY, APP_INTERCEPTION_CONTEXT_KEY, APP_LAYOUT_FLAGS_KEY, APP_ROOT_LAYOUT_KEY, APP_ROUTE_KEY, APP_UNMATCHED_SLOT_WIRE_VALUE, AppElementsWire, UNMATCHED_SLOT, buildOutgoingAppPayload, isAppElementsRecord, normalizeAppElements, readAppElementsMetadata, withLayoutFlags };
+export { APP_ARTIFACT_COMPATIBILITY_KEY, APP_INTERCEPTION_CONTEXT_KEY, APP_LAYOUT_FLAGS_KEY, APP_LAYOUT_IDS_KEY, APP_ROOT_LAYOUT_KEY, APP_ROUTE_KEY, APP_UNMATCHED_SLOT_WIRE_VALUE, AppElementsWire, UNMATCHED_SLOT, buildOutgoingAppPayload, isAppElementsRecord, normalizeAppElements, readAppElementsMetadata, withLayoutFlags };
 
 //# sourceMappingURL=app-elements-wire.js.map

package/dist/server/app-elements-wire.js.map

@@ -1 +1 @@
-{"version":3,"file":"app-elements-wire.js","names":[],"sources":["../../src/server/app-elements-wire.ts"],"sourcesContent":["import { isValidElement, type ReactNode } from \"react\";\nimport {\n  createArtifactCompatibilityEnvelope,\n  parseArtifactCompatibilityEnvelope,\n  type ArtifactCompatibilityEnvelope,\n} from \"./artifact-compatibility.js\";\n\nconst APP_INTERCEPTION_SEPARATOR = \"\\0\";\n\nexport const APP_ARTIFACT_COMPATIBILITY_KEY = \"__artifactCompatibility\";\nexport const APP_INTERCEPTION_CONTEXT_KEY = \"__interceptionContext\";\nexport const APP_LAYOUT_FLAGS_KEY = \"__layoutFlags\";\nexport const APP_ROUTE_KEY = \"__route\";\nexport const APP_ROOT_LAYOUT_KEY = \"__rootLayout\";\nexport const APP_UNMATCHED_SLOT_WIRE_VALUE = \"__VINEXT_UNMATCHED_SLOT__\";\n\nexport const UNMATCHED_SLOT = Symbol.for(\"vinext.unmatchedSlot\");\n\nexport type AppElementValue = ReactNode | typeof UNMATCHED_SLOT | string | null;\ntype AppWireElementValue = ReactNode | string | null;\n\nexport type AppElements = Readonly<Record<string, AppElementValue>>;\nexport type AppWireElements = Readonly<Record<string, AppWireElementValue>>;\n\n/**\n * Per-layout static/dynamic flags. `\"s\"` = static (skippable on next nav);\n * `\"d\"` = dynamic (must always render).\n *\n * Lifecycle (partial — later PRs extend this):\n *\n *   1. PROBE   — probeAppPageLayouts (server/app-page-execution.ts) returns\n *                LayoutFlags for every layout in the route at render time.\n *\n *   2. ATTACH  — AppElementsWire.encodeOutgoingPayload writes `__layoutFlags`\n *                into the outgoing App Router payload record.\n *\n *   3. WIRE    — renderToReadableStream serializes the record as RSC row 0.\n *\n *   4. PARSE   — AppElementsWire.readMetadata extracts layoutFlags from the\n *                wire payload on the client side.\n */\nexport type LayoutFlags = Readonly<Record<string, \"s\" | \"d\">>;\n\ntype AppElementsMetadata = {\n  artifactCompatibility: ArtifactCompatibilityEnvelope;\n  interceptionContext: string | null;\n  layoutFlags: LayoutFlags;\n  routeId: string;\n  rootLayoutTreePath: string | null;\n};\n\ntype AppElementsWireElementKey =\n  | { kind: \"layout\"; treePath: string }\n  | { interceptionContext: string | null; kind: \"page\"; path: string }\n  | { interceptionContext: string | null; kind: \"route\"; path: string }\n  | { kind: \"slot\"; name: string; treePath: string }\n  | { kind: \"template\"; treePath: string };\n\ntype AppElementsWireMetadataInput = {\n  interceptionContext: string | null;\n  routeId: string;\n  rootLayoutTreePath: string | null;\n};\n\ntype AppElementsWireMetadataEntries = Readonly<{\n  [APP_ROUTE_KEY]: string;\n  [APP_INTERCEPTION_CONTEXT_KEY]: string | null;\n  [APP_ROOT_LAYOUT_KEY]: string | null;\n}>;\n\n/**\n * The outgoing wire payload shape. Includes ReactNode values for the\n * rendered tree plus metadata values like LayoutFlags attached under\n * known keys (e.g. __layoutFlags). Distinct from AppElements / AppWireElements\n * which only carry render-time values.\n */\nexport type AppOutgoingElements = Readonly<\n  Record<string, ReactNode | LayoutFlags | ArtifactCompatibilityEnvelope>\n>;\n\ntype AppElementsWireKeys = {\n  readonly artifactCompatibility: typeof APP_ARTIFACT_COMPATIBILITY_KEY;\n  readonly interceptionContext: typeof APP_INTERCEPTION_CONTEXT_KEY;\n  readonly layoutFlags: typeof APP_LAYOUT_FLAGS_KEY;\n  readonly rootLayout: typeof APP_ROOT_LAYOUT_KEY;\n  readonly route: typeof APP_ROUTE_KEY;\n};\n\ntype AppElementsWireCodec = {\n  readonly keys: AppElementsWireKeys;\n  readonly unmatchedSlotValue: typeof APP_UNMATCHED_SLOT_WIRE_VALUE;\n  createMetadataEntries(input: AppElementsWireMetadataInput): AppElementsWireMetadataEntries;\n  decode(elements: AppWireElements): AppElements;\n  encodeCacheKey(rscUrl: string, interceptionContext: string | null): string;\n  encodeLayoutId(treePath: string): string;\n  encodeOutgoingPayload(input: {\n    element: ReactNode | Readonly<Record<string, ReactNode>>;\n    artifactCompatibility?: ArtifactCompatibilityEnvelope;\n    layoutFlags: LayoutFlags;\n  }): ReactNode | AppOutgoingElements;\n  encodePageId(routePath: string, interceptionContext: string | null): string;\n  encodeRouteId(routePath: string, interceptionContext: string | null): string;\n  encodeSlotId(slotName: string, treePath: string): string;\n  encodeTemplateId(treePath: string): string;\n  isSlotId(key: string): boolean;\n  parseElementKey(key: string): AppElementsWireElementKey | null;\n  readMetadata(elements: Readonly<Record<string, unknown>>): AppElementsMetadata;\n  withLayoutFlags<T extends Record<string, unknown>>(\n    elements: T,\n    layoutFlags: LayoutFlags,\n  ): T & { [APP_LAYOUT_FLAGS_KEY]: LayoutFlags };\n};\n\nfunction appendInterceptionContext(identity: string, interceptionContext: string | null): string {\n  return interceptionContext === null\n    ? identity\n    : `${identity}${APP_INTERCEPTION_SEPARATOR}${interceptionContext}`;\n}\n\nfunction createAppPayloadRouteId(routePath: string, interceptionContext: string | null): string {\n  return appendInterceptionContext(`route:${routePath}`, interceptionContext);\n}\n\nfunction createAppPayloadPageId(routePath: string, interceptionContext: string | null): string {\n  return appendInterceptionContext(`page:${routePath}`, interceptionContext);\n}\n\nfunction createAppPayloadLayoutId(treePath: string): string {\n  return `layout:${treePath}`;\n}\n\nfunction createAppPayloadTemplateId(treePath: string): string {\n  return `template:${treePath}`;\n}\n\nfunction createAppPayloadSlotId(slotName: string, treePath: string): string {\n  return `slot:${slotName}:${treePath}`;\n}\n\nfunction createAppPayloadCacheKey(rscUrl: string, interceptionContext: string | null): string {\n  return appendInterceptionContext(rscUrl, interceptionContext);\n}\n\nfunction parsePathWithInterception(input: string): {\n  interceptionContext: string | null;\n  path: string;\n} | null {\n  const separatorIndex = input.indexOf(APP_INTERCEPTION_SEPARATOR);\n  const path = separatorIndex === -1 ? input : input.slice(0, separatorIndex);\n  if (!path.startsWith(\"/\")) return null;\n\n  return {\n    interceptionContext: separatorIndex === -1 ? null : input.slice(separatorIndex + 1),\n    path,\n  };\n}\n\n/**\n * AppElements tree paths are absolute route-tree paths on the wire.\n * Bare segment names are not valid layout/template/slot tree identities.\n */\nfunction parseTreePath(input: string): string | null {\n  return input.startsWith(\"/\") ? input : null;\n}\n\nfunction parseAppElementsWireElementKey(key: string): AppElementsWireElementKey | null {\n  if (key.startsWith(\"route:\")) {\n    const parsed = parsePathWithInterception(key.slice(\"route:\".length));\n    if (!parsed) return null;\n    return { interceptionContext: parsed.interceptionContext, kind: \"route\", path: parsed.path };\n  }\n\n  if (key.startsWith(\"page:\")) {\n    const parsed = parsePathWithInterception(key.slice(\"page:\".length));\n    if (!parsed) return null;\n    return { interceptionContext: parsed.interceptionContext, kind: \"page\", path: parsed.path };\n  }\n\n  if (key.startsWith(\"layout:\")) {\n    const treePath = parseTreePath(key.slice(\"layout:\".length));\n    return treePath ? { kind: \"layout\", treePath } : null;\n  }\n\n  if (key.startsWith(\"template:\")) {\n    const treePath = parseTreePath(key.slice(\"template:\".length));\n    return treePath ? { kind: \"template\", treePath } : null;\n  }\n\n  if (key.startsWith(\"slot:\")) {\n    const body = key.slice(\"slot:\".length);\n    const separatorIndex = body.indexOf(\":\");\n    if (separatorIndex <= 0) return null;\n    const name = body.slice(0, separatorIndex);\n    const treePath = parseTreePath(body.slice(separatorIndex + 1));\n    return treePath ? { kind: \"slot\", name, treePath } : null;\n  }\n\n  return null;\n}\n\nfunction isAppElementsWireSlotId(key: string): boolean {\n  if (!key.startsWith(\"slot:\")) return false;\n  const body = key.slice(\"slot:\".length);\n  const separatorIndex = body.indexOf(\":\");\n  return separatorIndex > 0 && body.charCodeAt(separatorIndex + 1) === 0x2f;\n}\n\nfunction createAppElementsWireMetadataEntries(\n  input: AppElementsWireMetadataInput,\n): AppElementsWireMetadataEntries {\n  return {\n    [APP_ROUTE_KEY]: input.routeId,\n    [APP_INTERCEPTION_CONTEXT_KEY]: input.interceptionContext,\n    [APP_ROOT_LAYOUT_KEY]: input.rootLayoutTreePath,\n  };\n}\n\nexport function normalizeAppElements(elements: AppWireElements): AppElements {\n  let needsNormalization = false;\n  for (const [key, value] of Object.entries(elements)) {\n    if (isAppElementsWireSlotId(key) && value === APP_UNMATCHED_SLOT_WIRE_VALUE) {\n      needsNormalization = true;\n      break;\n    }\n  }\n\n  if (!needsNormalization) {\n    return elements;\n  }\n\n  const normalized: Record<string, AppElementValue> = {};\n  for (const [key, value] of Object.entries(elements)) {\n    normalized[key] =\n      isAppElementsWireSlotId(key) && value === APP_UNMATCHED_SLOT_WIRE_VALUE\n        ? UNMATCHED_SLOT\n        : value;\n  }\n\n  return normalized;\n}\n\nfunction isLayoutFlagsRecord(value: unknown): value is LayoutFlags {\n  if (typeof value !== \"object\" || value === null || Array.isArray(value)) return false;\n  for (const v of Object.values(value)) {\n    if (v !== \"s\" && v !== \"d\") return false;\n  }\n  return true;\n}\n\nfunction parseLayoutFlags(value: unknown): LayoutFlags {\n  if (isLayoutFlagsRecord(value)) return value;\n  return {};\n}\n\n/**\n * Type predicate for a plain (non-null, non-array) record of app payload values.\n * Used to distinguish the App Router payload object from bare React elements at\n * the render boundary. Narrows to `Readonly<Record<string, unknown>>` because\n * the outgoing payload carries heterogeneous values (ReactNodes for the rendered\n * tree, plus metadata like `__layoutFlags` which is a plain object). Delegates\n * to React's canonical `isValidElement` so we don't depend on React's internal\n * `$$typeof` marker scheme.\n */\nexport function isAppElementsRecord(value: unknown): value is Readonly<Record<string, unknown>> {\n  if (typeof value !== \"object\" || value === null) return false;\n  if (Array.isArray(value)) return false;\n  if (isValidElement(value)) return false;\n  return true;\n}\n\nexport function withLayoutFlags<T extends Record<string, unknown>>(\n  elements: T,\n  layoutFlags: LayoutFlags,\n): T & { [APP_LAYOUT_FLAGS_KEY]: LayoutFlags } {\n  return { ...elements, [APP_LAYOUT_FLAGS_KEY]: layoutFlags };\n}\n\nexport function buildOutgoingAppPayload(input: {\n  element: ReactNode | Readonly<Record<string, ReactNode>>;\n  artifactCompatibility?: ArtifactCompatibilityEnvelope;\n  layoutFlags: LayoutFlags;\n}): ReactNode | AppOutgoingElements {\n  if (!isAppElementsRecord(input.element)) {\n    return input.element;\n  }\n  return {\n    ...input.element,\n    [APP_LAYOUT_FLAGS_KEY]: input.layoutFlags,\n    [APP_ARTIFACT_COMPATIBILITY_KEY]:\n      input.artifactCompatibility ?? createArtifactCompatibilityEnvelope(),\n  };\n}\n\nfunction readArtifactCompatibilityMetadata(value: unknown): ArtifactCompatibilityEnvelope {\n  if (value === undefined) return createArtifactCompatibilityEnvelope();\n\n  const artifactCompatibility = parseArtifactCompatibilityEnvelope(value);\n  // TODO(#726-COMPAT-04): hard-fail malformed compatibility metadata once\n  // cache/skip consumers depend on this proof. During Wave01 the field is\n  // emitted as scaffolding, so bad or future-version values degrade like\n  // missing __layoutFlags instead of crashing render paths that do not read it.\n  return artifactCompatibility ?? createArtifactCompatibilityEnvelope();\n}\n\nexport function readAppElementsMetadata(\n  elements: Readonly<Record<string, unknown>>,\n): AppElementsMetadata {\n  const routeId = elements[APP_ROUTE_KEY];\n  if (typeof routeId !== \"string\") {\n    throw new Error(\"[vinext] Missing __route string in App Router payload\");\n  }\n\n  const interceptionContext = elements[APP_INTERCEPTION_CONTEXT_KEY];\n  if (\n    interceptionContext !== undefined &&\n    interceptionContext !== null &&\n    typeof interceptionContext !== \"string\"\n  ) {\n    throw new Error(\"[vinext] Invalid __interceptionContext in App Router payload\");\n  }\n\n  const rootLayoutTreePath = elements[APP_ROOT_LAYOUT_KEY];\n  if (rootLayoutTreePath === undefined) {\n    throw new Error(\"[vinext] Missing __rootLayout key in App Router payload\");\n  }\n  if (rootLayoutTreePath !== null && typeof rootLayoutTreePath !== \"string\") {\n    throw new Error(\"[vinext] Invalid __rootLayout in App Router payload: expected string or null\");\n  }\n\n  const layoutFlags = parseLayoutFlags(elements[APP_LAYOUT_FLAGS_KEY]);\n  const artifactCompatibility = readArtifactCompatibilityMetadata(\n    elements[APP_ARTIFACT_COMPATIBILITY_KEY],\n  );\n\n  return {\n    artifactCompatibility,\n    interceptionContext: interceptionContext ?? null,\n    layoutFlags,\n    routeId,\n    rootLayoutTreePath,\n  };\n}\n\nexport const AppElementsWire: AppElementsWireCodec = {\n  // WIRE follow-ups use these stable key names when moving payload readers and writers\n  // behind the codec boundary.\n  keys: {\n    artifactCompatibility: APP_ARTIFACT_COMPATIBILITY_KEY,\n    interceptionContext: APP_INTERCEPTION_CONTEXT_KEY,\n    layoutFlags: APP_LAYOUT_FLAGS_KEY,\n    rootLayout: APP_ROOT_LAYOUT_KEY,\n    route: APP_ROUTE_KEY,\n  },\n  unmatchedSlotValue: APP_UNMATCHED_SLOT_WIRE_VALUE,\n  createMetadataEntries: createAppElementsWireMetadataEntries,\n  decode: normalizeAppElements,\n  encodeCacheKey: createAppPayloadCacheKey,\n  encodeLayoutId: createAppPayloadLayoutId,\n  encodeOutgoingPayload: buildOutgoingAppPayload,\n  encodePageId: createAppPayloadPageId,\n  encodeRouteId: createAppPayloadRouteId,\n  encodeSlotId: createAppPayloadSlotId,\n  encodeTemplateId: createAppPayloadTemplateId,\n  isSlotId: isAppElementsWireSlotId,\n  parseElementKey: parseAppElementsWireElementKey,\n  readMetadata: readAppElementsMetadata,\n  withLayoutFlags,\n};\n"],"mappings":"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"}
+{"version":3,"file":"app-elements-wire.js","names":[],"sources":["../../src/server/app-elements-wire.ts"],"sourcesContent":["import { isValidElement, type ReactNode } from \"react\";\nimport {\n  createArtifactCompatibilityEnvelope,\n  parseArtifactCompatibilityEnvelope,\n  type ArtifactCompatibilityEnvelope,\n} from \"./artifact-compatibility.js\";\n\nconst APP_INTERCEPTION_SEPARATOR = \"\\0\";\n\nexport const APP_ARTIFACT_COMPATIBILITY_KEY = \"__artifactCompatibility\";\nexport const APP_INTERCEPTION_CONTEXT_KEY = \"__interceptionContext\";\nexport const APP_LAYOUT_IDS_KEY = \"__layoutIds\";\nexport const APP_LAYOUT_FLAGS_KEY = \"__layoutFlags\";\nexport const APP_ROUTE_KEY = \"__route\";\nexport const APP_ROOT_LAYOUT_KEY = \"__rootLayout\";\nexport const APP_UNMATCHED_SLOT_WIRE_VALUE = \"__VINEXT_UNMATCHED_SLOT__\";\n\nexport const UNMATCHED_SLOT = Symbol.for(\"vinext.unmatchedSlot\");\n\nexport type AppElementValue = ReactNode | typeof UNMATCHED_SLOT | string | null;\ntype AppWireElementValue = ReactNode | string | null;\n\nexport type AppElements = Readonly<Record<string, AppElementValue>>;\nexport type AppWireElements = Readonly<Record<string, AppWireElementValue>>;\n\n/**\n * Per-layout static/dynamic flags. `\"s\"` = static (skippable on next nav);\n * `\"d\"` = dynamic (must always render).\n *\n * Lifecycle (partial — later PRs extend this):\n *\n *   1. PROBE   — probeAppPageLayouts (server/app-page-execution.ts) returns\n *                LayoutFlags for every layout in the route at render time.\n *\n *   2. ATTACH  — AppElementsWire.encodeOutgoingPayload writes `__layoutFlags`\n *                into the outgoing App Router payload record.\n *\n *   3. WIRE    — renderToReadableStream serializes the record as RSC row 0.\n *\n *   4. PARSE   — AppElementsWire.readMetadata extracts layoutFlags from the\n *                wire payload on the client side.\n */\nexport type LayoutFlags = Readonly<Record<string, \"s\" | \"d\">>;\n\ntype AppElementsMetadata = {\n  artifactCompatibility: ArtifactCompatibilityEnvelope;\n  interceptionContext: string | null;\n  layoutIds: readonly string[];\n  layoutFlags: LayoutFlags;\n  routeId: string;\n  rootLayoutTreePath: string | null;\n};\n\ntype AppElementsWireElementKey =\n  | { kind: \"layout\"; treePath: string }\n  | { interceptionContext: string | null; kind: \"page\"; path: string }\n  | { interceptionContext: string | null; kind: \"route\"; path: string }\n  | { kind: \"slot\"; name: string; treePath: string }\n  | { kind: \"template\"; treePath: string };\n\ntype AppElementsWireMetadataInput = {\n  interceptionContext: string | null;\n  layoutIds?: readonly string[];\n  routeId: string;\n  rootLayoutTreePath: string | null;\n};\n\ntype AppElementsWireMetadataEntries = Readonly<{\n  [APP_ROUTE_KEY]: string;\n  [APP_INTERCEPTION_CONTEXT_KEY]: string | null;\n  [APP_LAYOUT_IDS_KEY]: readonly string[];\n  [APP_ROOT_LAYOUT_KEY]: string | null;\n}>;\n\n/**\n * The outgoing wire payload shape. Includes ReactNode values for the\n * rendered tree plus metadata values like LayoutFlags attached under\n * known keys (e.g. __layoutFlags). Distinct from AppElements / AppWireElements\n * which only carry render-time values.\n */\nexport type AppOutgoingElements = Readonly<\n  Record<string, ReactNode | LayoutFlags | ArtifactCompatibilityEnvelope>\n>;\n\ntype AppElementsWireKeys = {\n  readonly artifactCompatibility: typeof APP_ARTIFACT_COMPATIBILITY_KEY;\n  readonly interceptionContext: typeof APP_INTERCEPTION_CONTEXT_KEY;\n  readonly layoutIds: typeof APP_LAYOUT_IDS_KEY;\n  readonly layoutFlags: typeof APP_LAYOUT_FLAGS_KEY;\n  readonly rootLayout: typeof APP_ROOT_LAYOUT_KEY;\n  readonly route: typeof APP_ROUTE_KEY;\n};\n\ntype AppElementsWireCodec = {\n  readonly keys: AppElementsWireKeys;\n  readonly unmatchedSlotValue: typeof APP_UNMATCHED_SLOT_WIRE_VALUE;\n  createMetadataEntries(input: AppElementsWireMetadataInput): AppElementsWireMetadataEntries;\n  decode(elements: AppWireElements): AppElements;\n  encodeCacheKey(rscUrl: string, interceptionContext: string | null): string;\n  encodeLayoutId(treePath: string): string;\n  encodeOutgoingPayload(input: {\n    element: ReactNode | Readonly<Record<string, ReactNode>>;\n    artifactCompatibility?: ArtifactCompatibilityEnvelope;\n    layoutFlags: LayoutFlags;\n  }): ReactNode | AppOutgoingElements;\n  encodePageId(routePath: string, interceptionContext: string | null): string;\n  encodeRouteId(routePath: string, interceptionContext: string | null): string;\n  encodeSlotId(slotName: string, treePath: string): string;\n  encodeTemplateId(treePath: string): string;\n  isSlotId(key: string): boolean;\n  parseElementKey(key: string): AppElementsWireElementKey | null;\n  readMetadata(elements: Readonly<Record<string, unknown>>): AppElementsMetadata;\n  withLayoutFlags<T extends Record<string, unknown>>(\n    elements: T,\n    layoutFlags: LayoutFlags,\n  ): T & { [APP_LAYOUT_FLAGS_KEY]: LayoutFlags };\n};\n\nfunction appendInterceptionContext(identity: string, interceptionContext: string | null): string {\n  return interceptionContext === null\n    ? identity\n    : `${identity}${APP_INTERCEPTION_SEPARATOR}${interceptionContext}`;\n}\n\nfunction createAppPayloadRouteId(routePath: string, interceptionContext: string | null): string {\n  return appendInterceptionContext(`route:${routePath}`, interceptionContext);\n}\n\nfunction createAppPayloadPageId(routePath: string, interceptionContext: string | null): string {\n  return appendInterceptionContext(`page:${routePath}`, interceptionContext);\n}\n\nfunction createAppPayloadLayoutId(treePath: string): string {\n  return `layout:${treePath}`;\n}\n\nfunction createAppPayloadTemplateId(treePath: string): string {\n  return `template:${treePath}`;\n}\n\nfunction createAppPayloadSlotId(slotName: string, treePath: string): string {\n  return `slot:${slotName}:${treePath}`;\n}\n\nfunction createAppPayloadCacheKey(rscUrl: string, interceptionContext: string | null): string {\n  return appendInterceptionContext(rscUrl, interceptionContext);\n}\n\nfunction parsePathWithInterception(input: string): {\n  interceptionContext: string | null;\n  path: string;\n} | null {\n  const separatorIndex = input.indexOf(APP_INTERCEPTION_SEPARATOR);\n  const path = separatorIndex === -1 ? input : input.slice(0, separatorIndex);\n  if (!path.startsWith(\"/\")) return null;\n\n  return {\n    interceptionContext: separatorIndex === -1 ? null : input.slice(separatorIndex + 1),\n    path,\n  };\n}\n\n/**\n * AppElements tree paths are absolute route-tree paths on the wire.\n * Bare segment names are not valid layout/template/slot tree identities.\n */\nfunction parseTreePath(input: string): string | null {\n  return input.startsWith(\"/\") ? input : null;\n}\n\nfunction parseAppElementsWireElementKey(key: string): AppElementsWireElementKey | null {\n  if (key.startsWith(\"route:\")) {\n    const parsed = parsePathWithInterception(key.slice(\"route:\".length));\n    if (!parsed) return null;\n    return { interceptionContext: parsed.interceptionContext, kind: \"route\", path: parsed.path };\n  }\n\n  if (key.startsWith(\"page:\")) {\n    const parsed = parsePathWithInterception(key.slice(\"page:\".length));\n    if (!parsed) return null;\n    return { interceptionContext: parsed.interceptionContext, kind: \"page\", path: parsed.path };\n  }\n\n  if (key.startsWith(\"layout:\")) {\n    const treePath = parseTreePath(key.slice(\"layout:\".length));\n    return treePath ? { kind: \"layout\", treePath } : null;\n  }\n\n  if (key.startsWith(\"template:\")) {\n    const treePath = parseTreePath(key.slice(\"template:\".length));\n    return treePath ? { kind: \"template\", treePath } : null;\n  }\n\n  if (key.startsWith(\"slot:\")) {\n    const body = key.slice(\"slot:\".length);\n    const separatorIndex = body.indexOf(\":\");\n    if (separatorIndex <= 0) return null;\n    const name = body.slice(0, separatorIndex);\n    const treePath = parseTreePath(body.slice(separatorIndex + 1));\n    return treePath ? { kind: \"slot\", name, treePath } : null;\n  }\n\n  return null;\n}\n\nfunction isAppElementsWireSlotId(key: string): boolean {\n  if (!key.startsWith(\"slot:\")) return false;\n  const body = key.slice(\"slot:\".length);\n  const separatorIndex = body.indexOf(\":\");\n  return separatorIndex > 0 && body.charCodeAt(separatorIndex + 1) === 0x2f;\n}\n\nfunction createAppElementsWireMetadataEntries(\n  input: AppElementsWireMetadataInput,\n): AppElementsWireMetadataEntries {\n  return {\n    [APP_ROUTE_KEY]: input.routeId,\n    [APP_INTERCEPTION_CONTEXT_KEY]: input.interceptionContext,\n    [APP_LAYOUT_IDS_KEY]: [...(input.layoutIds ?? [])],\n    [APP_ROOT_LAYOUT_KEY]: input.rootLayoutTreePath,\n  };\n}\n\nexport function normalizeAppElements(elements: AppWireElements): AppElements {\n  let needsNormalization = false;\n  for (const [key, value] of Object.entries(elements)) {\n    if (isAppElementsWireSlotId(key) && value === APP_UNMATCHED_SLOT_WIRE_VALUE) {\n      needsNormalization = true;\n      break;\n    }\n  }\n\n  if (!needsNormalization) {\n    return elements;\n  }\n\n  const normalized: Record<string, AppElementValue> = {};\n  for (const [key, value] of Object.entries(elements)) {\n    normalized[key] =\n      isAppElementsWireSlotId(key) && value === APP_UNMATCHED_SLOT_WIRE_VALUE\n        ? UNMATCHED_SLOT\n        : value;\n  }\n\n  return normalized;\n}\n\nfunction isLayoutFlagsRecord(value: unknown): value is LayoutFlags {\n  if (typeof value !== \"object\" || value === null || Array.isArray(value)) return false;\n  for (const v of Object.values(value)) {\n    if (v !== \"s\" && v !== \"d\") return false;\n  }\n  return true;\n}\n\nfunction parseLayoutFlags(value: unknown): LayoutFlags {\n  if (isLayoutFlagsRecord(value)) return value;\n  return {};\n}\n\nfunction parseLayoutIds(value: unknown): readonly string[] {\n  if (value === undefined) return [];\n  if (!Array.isArray(value)) {\n    throw new Error(\n      \"[vinext] Invalid __layoutIds in App Router payload: expected layout id string[]\",\n    );\n  }\n\n  const layoutIds: string[] = [];\n  for (const entry of value) {\n    if (typeof entry !== \"string\") {\n      throw new Error(\n        \"[vinext] Invalid __layoutIds in App Router payload: expected layout id string[]\",\n      );\n    }\n\n    const parsed = parseAppElementsWireElementKey(entry);\n    if (parsed?.kind !== \"layout\") {\n      throw new Error(\"[vinext] Invalid __layoutIds in App Router payload: expected layout ids\");\n    }\n\n    layoutIds.push(entry);\n  }\n  return layoutIds;\n}\n\n/**\n * Type predicate for a plain (non-null, non-array) record of app payload values.\n * Used to distinguish the App Router payload object from bare React elements at\n * the render boundary. Narrows to `Readonly<Record<string, unknown>>` because\n * the outgoing payload carries heterogeneous values (ReactNodes for the rendered\n * tree, plus metadata like `__layoutFlags` which is a plain object). Delegates\n * to React's canonical `isValidElement` so we don't depend on React's internal\n * `$$typeof` marker scheme.\n */\nexport function isAppElementsRecord(value: unknown): value is Readonly<Record<string, unknown>> {\n  if (typeof value !== \"object\" || value === null) return false;\n  if (Array.isArray(value)) return false;\n  if (isValidElement(value)) return false;\n  return true;\n}\n\nexport function withLayoutFlags<T extends Record<string, unknown>>(\n  elements: T,\n  layoutFlags: LayoutFlags,\n): T & { [APP_LAYOUT_FLAGS_KEY]: LayoutFlags } {\n  return { ...elements, [APP_LAYOUT_FLAGS_KEY]: layoutFlags };\n}\n\nexport function buildOutgoingAppPayload(input: {\n  element: ReactNode | Readonly<Record<string, ReactNode>>;\n  artifactCompatibility?: ArtifactCompatibilityEnvelope;\n  layoutFlags: LayoutFlags;\n}): ReactNode | AppOutgoingElements {\n  if (!isAppElementsRecord(input.element)) {\n    return input.element;\n  }\n  return {\n    ...input.element,\n    [APP_LAYOUT_FLAGS_KEY]: input.layoutFlags,\n    [APP_ARTIFACT_COMPATIBILITY_KEY]:\n      input.artifactCompatibility ?? createArtifactCompatibilityEnvelope(),\n  };\n}\n\nfunction readArtifactCompatibilityMetadata(value: unknown): ArtifactCompatibilityEnvelope {\n  if (value === undefined) return createArtifactCompatibilityEnvelope();\n\n  const artifactCompatibility = parseArtifactCompatibilityEnvelope(value);\n  // TODO(#726-COMPAT-04): hard-fail malformed compatibility metadata once\n  // cache/skip consumers depend on this proof. During Wave01 the field is\n  // emitted as scaffolding, so bad or future-version values degrade like\n  // missing __layoutFlags instead of crashing render paths that do not read it.\n  return artifactCompatibility ?? createArtifactCompatibilityEnvelope();\n}\n\nexport function readAppElementsMetadata(\n  elements: Readonly<Record<string, unknown>>,\n): AppElementsMetadata {\n  const routeId = elements[APP_ROUTE_KEY];\n  if (typeof routeId !== \"string\") {\n    throw new Error(\"[vinext] Missing __route string in App Router payload\");\n  }\n\n  const interceptionContext = elements[APP_INTERCEPTION_CONTEXT_KEY];\n  if (\n    interceptionContext !== undefined &&\n    interceptionContext !== null &&\n    typeof interceptionContext !== \"string\"\n  ) {\n    throw new Error(\"[vinext] Invalid __interceptionContext in App Router payload\");\n  }\n\n  const rootLayoutTreePath = elements[APP_ROOT_LAYOUT_KEY];\n  if (rootLayoutTreePath === undefined) {\n    throw new Error(\"[vinext] Missing __rootLayout key in App Router payload\");\n  }\n  if (rootLayoutTreePath !== null && typeof rootLayoutTreePath !== \"string\") {\n    throw new Error(\"[vinext] Invalid __rootLayout in App Router payload: expected string or null\");\n  }\n\n  const layoutFlags = parseLayoutFlags(elements[APP_LAYOUT_FLAGS_KEY]);\n  const layoutIds = parseLayoutIds(elements[APP_LAYOUT_IDS_KEY]);\n  const artifactCompatibility = readArtifactCompatibilityMetadata(\n    elements[APP_ARTIFACT_COMPATIBILITY_KEY],\n  );\n\n  return {\n    artifactCompatibility,\n    interceptionContext: interceptionContext ?? null,\n    layoutIds,\n    layoutFlags,\n    routeId,\n    rootLayoutTreePath,\n  };\n}\n\nexport const AppElementsWire: AppElementsWireCodec = {\n  // WIRE follow-ups use these stable key names when moving payload readers and writers\n  // behind the codec boundary.\n  keys: {\n    artifactCompatibility: APP_ARTIFACT_COMPATIBILITY_KEY,\n    interceptionContext: APP_INTERCEPTION_CONTEXT_KEY,\n    layoutIds: APP_LAYOUT_IDS_KEY,\n    layoutFlags: APP_LAYOUT_FLAGS_KEY,\n    rootLayout: APP_ROOT_LAYOUT_KEY,\n    route: APP_ROUTE_KEY,\n  },\n  unmatchedSlotValue: APP_UNMATCHED_SLOT_WIRE_VALUE,\n  createMetadataEntries: createAppElementsWireMetadataEntries,\n  decode: normalizeAppElements,\n  encodeCacheKey: createAppPayloadCacheKey,\n  encodeLayoutId: createAppPayloadLayoutId,\n  encodeOutgoingPayload: buildOutgoingAppPayload,\n  encodePageId: createAppPayloadPageId,\n  encodeRouteId: createAppPayloadRouteId,\n  encodeSlotId: createAppPayloadSlotId,\n  encodeTemplateId: createAppPayloadTemplateId,\n  isSlotId: isAppElementsWireSlotId,\n  parseElementKey: parseAppElementsWireElementKey,\n  readMetadata: readAppElementsMetadata,\n  withLayoutFlags,\n};\n"],"mappings":";;;AAOA,MAAM,6BAA6B;AAEnC,MAAa,iCAAiC;AAC9C,MAAa,+BAA+B;AAC5C,MAAa,qBAAqB;AAClC,MAAa,uBAAuB;AACpC,MAAa,gBAAgB;AAC7B,MAAa,sBAAsB;AACnC,MAAa,gCAAgC;AAE7C,MAAa,iBAAiB,OAAO,IAAI,uBAAuB;AAqGhE,SAAS,0BAA0B,UAAkB,qBAA4C;CAC/F,OAAO,wBAAwB,OAC3B,WACA,GAAG,WAAW,6BAA6B;;AAGjD,SAAS,wBAAwB,WAAmB,qBAA4C;CAC9F,OAAO,0BAA0B,SAAS,aAAa,oBAAoB;;AAG7E,SAAS,uBAAuB,WAAmB,qBAA4C;CAC7F,OAAO,0BAA0B,QAAQ,aAAa,oBAAoB;;AAG5E,SAAS,yBAAyB,UAA0B;CAC1D,OAAO,UAAU;;AAGnB,SAAS,2BAA2B,UAA0B;CAC5D,OAAO,YAAY;;AAGrB,SAAS,uBAAuB,UAAkB,UAA0B;CAC1E,OAAO,QAAQ,SAAS,GAAG;;AAG7B,SAAS,yBAAyB,QAAgB,qBAA4C;CAC5F,OAAO,0BAA0B,QAAQ,oBAAoB;;AAG/D,SAAS,0BAA0B,OAG1B;CACP,MAAM,iBAAiB,MAAM,QAAQ,2BAA2B;CAChE,MAAM,OAAO,mBAAmB,KAAK,QAAQ,MAAM,MAAM,GAAG,eAAe;CAC3E,IAAI,CAAC,KAAK,WAAW,IAAI,EAAE,OAAO;CAElC,OAAO;EACL,qBAAqB,mBAAmB,KAAK,OAAO,MAAM,MAAM,iBAAiB,EAAE;EACnF;EACD;;;;;;AAOH,SAAS,cAAc,OAA8B;CACnD,OAAO,MAAM,WAAW,IAAI,GAAG,QAAQ;;AAGzC,SAAS,+BAA+B,KAA+C;CACrF,IAAI,IAAI,WAAW,SAAS,EAAE;EAC5B,MAAM,SAAS,0BAA0B,IAAI,MAAM,EAAgB,CAAC;EACpE,IAAI,CAAC,QAAQ,OAAO;EACpB,OAAO;GAAE,qBAAqB,OAAO;GAAqB,MAAM;GAAS,MAAM,OAAO;GAAM;;CAG9F,IAAI,IAAI,WAAW,QAAQ,EAAE;EAC3B,MAAM,SAAS,0BAA0B,IAAI,MAAM,EAAe,CAAC;EACnE,IAAI,CAAC,QAAQ,OAAO;EACpB,OAAO;GAAE,qBAAqB,OAAO;GAAqB,MAAM;GAAQ,MAAM,OAAO;GAAM;;CAG7F,IAAI,IAAI,WAAW,UAAU,EAAE;EAC7B,MAAM,WAAW,cAAc,IAAI,MAAM,EAAiB,CAAC;EAC3D,OAAO,WAAW;GAAE,MAAM;GAAU;GAAU,GAAG;;CAGnD,IAAI,IAAI,WAAW,YAAY,EAAE;EAC/B,MAAM,WAAW,cAAc,IAAI,MAAM,EAAmB,CAAC;EAC7D,OAAO,WAAW;GAAE,MAAM;GAAY;GAAU,GAAG;;CAGrD,IAAI,IAAI,WAAW,QAAQ,EAAE;EAC3B,MAAM,OAAO,IAAI,MAAM,EAAe;EACtC,MAAM,iBAAiB,KAAK,QAAQ,IAAI;EACxC,IAAI,kBAAkB,GAAG,OAAO;EAChC,MAAM,OAAO,KAAK,MAAM,GAAG,eAAe;EAC1C,MAAM,WAAW,cAAc,KAAK,MAAM,iBAAiB,EAAE,CAAC;EAC9D,OAAO,WAAW;GAAE,MAAM;GAAQ;GAAM;GAAU,GAAG;;CAGvD,OAAO;;AAGT,SAAS,wBAAwB,KAAsB;CACrD,IAAI,CAAC,IAAI,WAAW,QAAQ,EAAE,OAAO;CACrC,MAAM,OAAO,IAAI,MAAM,EAAe;CACtC,MAAM,iBAAiB,KAAK,QAAQ,IAAI;CACxC,OAAO,iBAAiB,KAAK,KAAK,WAAW,iBAAiB,EAAE,KAAK;;AAGvE,SAAS,qCACP,OACgC;CAChC,OAAO;GACJ,gBAAgB,MAAM;GACtB,+BAA+B,MAAM;GACrC,qBAAqB,CAAC,GAAI,MAAM,aAAa,EAAE,CAAE;GACjD,sBAAsB,MAAM;EAC9B;;AAGH,SAAgB,qBAAqB,UAAwC;CAC3E,IAAI,qBAAqB;CACzB,KAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,SAAS,EACjD,IAAI,wBAAwB,IAAI,IAAI,UAAA,6BAAyC;EAC3E,qBAAqB;EACrB;;CAIJ,IAAI,CAAC,oBACH,OAAO;CAGT,MAAM,aAA8C,EAAE;CACtD,KAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,SAAS,EACjD,WAAW,OACT,wBAAwB,IAAI,IAAI,UAAA,8BAC5B,iBACA;CAGR,OAAO;;AAGT,SAAS,oBAAoB,OAAsC;CACjE,IAAI,OAAO,UAAU,YAAY,UAAU,QAAQ,MAAM,QAAQ,MAAM,EAAE,OAAO;CAChF,KAAK,MAAM,KAAK,OAAO,OAAO,MAAM,EAClC,IAAI,MAAM,OAAO,MAAM,KAAK,OAAO;CAErC,OAAO;;AAGT,SAAS,iBAAiB,OAA6B;CACrD,IAAI,oBAAoB,MAAM,EAAE,OAAO;CACvC,OAAO,EAAE;;AAGX,SAAS,eAAe,OAAmC;CACzD,IAAI,UAAU,KAAA,GAAW,OAAO,EAAE;CAClC,IAAI,CAAC,MAAM,QAAQ,MAAM,EACvB,MAAM,IAAI,MACR,kFACD;CAGH,MAAM,YAAsB,EAAE;CAC9B,KAAK,MAAM,SAAS,OAAO;EACzB,IAAI,OAAO,UAAU,UACnB,MAAM,IAAI,MACR,kFACD;EAIH,IADe,+BAA+B,MACpC,EAAE,SAAS,UACnB,MAAM,IAAI,MAAM,0EAA0E;EAG5F,UAAU,KAAK,MAAM;;CAEvB,OAAO;;;;;;;;;;;AAYT,SAAgB,oBAAoB,OAA4D;CAC9F,IAAI,OAAO,UAAU,YAAY,UAAU,MAAM,OAAO;CACxD,IAAI,MAAM,QAAQ,MAAM,EAAE,OAAO;CACjC,IAAI,eAAe,MAAM,EAAE,OAAO;CAClC,OAAO;;AAGT,SAAgB,gBACd,UACA,aAC6C;CAC7C,OAAO;EAAE,GAAG;GAAW,uBAAuB;EAAa;;AAG7D,SAAgB,wBAAwB,OAIJ;CAClC,IAAI,CAAC,oBAAoB,MAAM,QAAQ,EACrC,OAAO,MAAM;CAEf,OAAO;EACL,GAAG,MAAM;GACR,uBAAuB,MAAM;GAC7B,iCACC,MAAM,yBAAyB,qCAAqC;EACvE;;AAGH,SAAS,kCAAkC,OAA+C;CACxF,IAAI,UAAU,KAAA,GAAW,OAAO,qCAAqC;CAOrE,OAL8B,mCAAmC,MAKrC,IAAI,qCAAqC;;AAGvE,SAAgB,wBACd,UACqB;CACrB,MAAM,UAAU,SAAS;CACzB,IAAI,OAAO,YAAY,UACrB,MAAM,IAAI,MAAM,wDAAwD;CAG1E,MAAM,sBAAsB,SAAS;CACrC,IACE,wBAAwB,KAAA,KACxB,wBAAwB,QACxB,OAAO,wBAAwB,UAE/B,MAAM,IAAI,MAAM,+DAA+D;CAGjF,MAAM,qBAAqB,SAAS;CACpC,IAAI,uBAAuB,KAAA,GACzB,MAAM,IAAI,MAAM,0DAA0D;CAE5E,IAAI,uBAAuB,QAAQ,OAAO,uBAAuB,UAC/D,MAAM,IAAI,MAAM,+EAA+E;CAGjG,MAAM,cAAc,iBAAiB,SAAS,sBAAsB;CACpE,MAAM,YAAY,eAAe,SAAS,oBAAoB;CAK9D,OAAO;EACL,uBAL4B,kCAC5B,SAAS,gCAIY;EACrB,qBAAqB,uBAAuB;EAC5C;EACA;EACA;EACA;EACD;;AAGH,MAAa,kBAAwC;CAGnD,MAAM;EACJ,uBAAuB;EACvB,qBAAqB;EACrB,WAAW;EACX,aAAa;EACb,YAAY;EACZ,OAAO;EACR;CACD,oBAAoB;CACpB,uBAAuB;CACvB,QAAQ;CACR,gBAAgB;CAChB,gBAAgB;CAChB,uBAAuB;CACvB,cAAc;CACd,eAAe;CACf,cAAc;CACd,kBAAkB;CAClB,UAAU;CACV,iBAAiB;CACjB,cAAc;CACd;CACD"}

package/dist/server/app-elements.d.ts

@@ -1,9 +1,9 @@
-import { APP_ARTIFACT_COMPATIBILITY_KEY, APP_INTERCEPTION_CONTEXT_KEY, APP_LAYOUT_FLAGS_KEY, APP_ROOT_LAYOUT_KEY, APP_ROUTE_KEY, APP_UNMATCHED_SLOT_WIRE_VALUE, AppElementValue, AppElements, AppElementsWire, AppOutgoingElements, AppWireElements, LayoutFlags, UNMATCHED_SLOT, buildOutgoingAppPayload, isAppElementsRecord, normalizeAppElements, readAppElementsMetadata, withLayoutFlags } from "./app-elements-wire.js";
+import { APP_ARTIFACT_COMPATIBILITY_KEY, APP_INTERCEPTION_CONTEXT_KEY, APP_LAYOUT_FLAGS_KEY, APP_LAYOUT_IDS_KEY, APP_ROOT_LAYOUT_KEY, APP_ROUTE_KEY, APP_UNMATCHED_SLOT_WIRE_VALUE, AppElementValue, AppElements, AppElementsWire, AppOutgoingElements, AppWireElements, LayoutFlags, UNMATCHED_SLOT, buildOutgoingAppPayload, isAppElementsRecord, normalizeAppElements, readAppElementsMetadata, withLayoutFlags } from "./app-elements-wire.js";
 
 //#region src/server/app-elements.d.ts
 declare function getMountedSlotIds(elements: AppElements): string[];
 declare function getMountedSlotIdsHeader(elements: AppElements): string | null;
 declare function resolveVisitedResponseInterceptionContext(requestInterceptionContext: string | null, payloadInterceptionContext: string | null): string | null;
 //#endregion
-export { APP_ARTIFACT_COMPATIBILITY_KEY, APP_INTERCEPTION_CONTEXT_KEY, APP_LAYOUT_FLAGS_KEY, APP_ROOT_LAYOUT_KEY, APP_ROUTE_KEY, APP_UNMATCHED_SLOT_WIRE_VALUE, type AppElementValue, type AppElements, AppElementsWire, type AppOutgoingElements, type AppWireElements, type LayoutFlags, UNMATCHED_SLOT, buildOutgoingAppPayload, getMountedSlotIds, getMountedSlotIdsHeader, isAppElementsRecord, normalizeAppElements, readAppElementsMetadata, resolveVisitedResponseInterceptionContext, withLayoutFlags };
+export { APP_ARTIFACT_COMPATIBILITY_KEY, APP_INTERCEPTION_CONTEXT_KEY, APP_LAYOUT_FLAGS_KEY, APP_LAYOUT_IDS_KEY, APP_ROOT_LAYOUT_KEY, APP_ROUTE_KEY, APP_UNMATCHED_SLOT_WIRE_VALUE, type AppElementValue, type AppElements, AppElementsWire, type AppOutgoingElements, type AppWireElements, type LayoutFlags, UNMATCHED_SLOT, buildOutgoingAppPayload, getMountedSlotIds, getMountedSlotIdsHeader, isAppElementsRecord, normalizeAppElements, readAppElementsMetadata, resolveVisitedResponseInterceptionContext, withLayoutFlags };
 //# sourceMappingURL=app-elements.d.ts.map

package/dist/server/app-elements.js

@@ -1,5 +1,5 @@
 import { normalizeMountedSlotsHeader } from "./app-mounted-slots-header.js";
-import { APP_ARTIFACT_COMPATIBILITY_KEY, APP_INTERCEPTION_CONTEXT_KEY, APP_LAYOUT_FLAGS_KEY, APP_ROOT_LAYOUT_KEY, APP_ROUTE_KEY, APP_UNMATCHED_SLOT_WIRE_VALUE, AppElementsWire, UNMATCHED_SLOT, buildOutgoingAppPayload, isAppElementsRecord, normalizeAppElements, readAppElementsMetadata, withLayoutFlags } from "./app-elements-wire.js";
+import { APP_ARTIFACT_COMPATIBILITY_KEY, APP_INTERCEPTION_CONTEXT_KEY, APP_LAYOUT_FLAGS_KEY, APP_LAYOUT_IDS_KEY, APP_ROOT_LAYOUT_KEY, APP_ROUTE_KEY, APP_UNMATCHED_SLOT_WIRE_VALUE, AppElementsWire, UNMATCHED_SLOT, buildOutgoingAppPayload, isAppElementsRecord, normalizeAppElements, readAppElementsMetadata, withLayoutFlags } from "./app-elements-wire.js";
 //#region src/server/app-elements.ts
 function getMountedSlotIds(elements) {
 	return Object.keys(elements).filter((key) => {
@@ -14,6 +14,6 @@ function resolveVisitedResponseInterceptionContext(requestInterceptionContext, p
 	return payloadInterceptionContext ?? requestInterceptionContext;
 }
 //#endregion
-export { APP_ARTIFACT_COMPATIBILITY_KEY, APP_INTERCEPTION_CONTEXT_KEY, APP_LAYOUT_FLAGS_KEY, APP_ROOT_LAYOUT_KEY, APP_ROUTE_KEY, APP_UNMATCHED_SLOT_WIRE_VALUE, AppElementsWire, UNMATCHED_SLOT, buildOutgoingAppPayload, getMountedSlotIds, getMountedSlotIdsHeader, isAppElementsRecord, normalizeAppElements, readAppElementsMetadata, resolveVisitedResponseInterceptionContext, withLayoutFlags };
+export { APP_ARTIFACT_COMPATIBILITY_KEY, APP_INTERCEPTION_CONTEXT_KEY, APP_LAYOUT_FLAGS_KEY, APP_LAYOUT_IDS_KEY, APP_ROOT_LAYOUT_KEY, APP_ROUTE_KEY, APP_UNMATCHED_SLOT_WIRE_VALUE, AppElementsWire, UNMATCHED_SLOT, buildOutgoingAppPayload, getMountedSlotIds, getMountedSlotIdsHeader, isAppElementsRecord, normalizeAppElements, readAppElementsMetadata, resolveVisitedResponseInterceptionContext, withLayoutFlags };
 
 //# sourceMappingURL=app-elements.js.map

package/dist/server/app-elements.js.map

@@ -1 +1 @@
-{"version":3,"file":"app-elements.js","names":[],"sources":["../../src/server/app-elements.ts"],"sourcesContent":["import { normalizeMountedSlotsHeader } from \"./app-mounted-slots-header.js\";\nimport { AppElementsWire, UNMATCHED_SLOT, type AppElements } from \"./app-elements-wire.js\";\n\nexport {\n  AppElementsWire,\n  APP_ARTIFACT_COMPATIBILITY_KEY,\n  APP_INTERCEPTION_CONTEXT_KEY,\n  APP_LAYOUT_FLAGS_KEY,\n  APP_ROOT_LAYOUT_KEY,\n  APP_ROUTE_KEY,\n  APP_UNMATCHED_SLOT_WIRE_VALUE,\n  UNMATCHED_SLOT,\n  buildOutgoingAppPayload,\n  isAppElementsRecord,\n  normalizeAppElements,\n  readAppElementsMetadata,\n  withLayoutFlags,\n  type AppElementValue,\n  type AppElements,\n  type AppOutgoingElements,\n  type AppWireElements,\n  type LayoutFlags,\n} from \"./app-elements-wire.js\";\n\n// Raw constructor helpers stay private because callers use AppElementsWire codecs.\n\nexport function getMountedSlotIds(elements: AppElements): string[] {\n  return Object.keys(elements)\n    .filter((key) => {\n      const value = elements[key];\n      return (\n        AppElementsWire.isSlotId(key) &&\n        value !== null &&\n        value !== undefined &&\n        value !== UNMATCHED_SLOT\n      );\n    })\n    .sort();\n}\n\nexport function getMountedSlotIdsHeader(elements: AppElements): string | null {\n  return normalizeMountedSlotsHeader(getMountedSlotIds(elements).join(\" \"));\n}\n\nexport function resolveVisitedResponseInterceptionContext(\n  requestInterceptionContext: string | null,\n  payloadInterceptionContext: string | null,\n): string | null {\n  return payloadInterceptionContext ?? requestInterceptionContext;\n}\n"],"mappings":";;;AA0BA,SAAgB,kBAAkB,UAAiC;AACjE,QAAO,OAAO,KAAK,SAAS,CACzB,QAAQ,QAAQ;EACf,MAAM,QAAQ,SAAS;AACvB,SACE,gBAAgB,SAAS,IAAI,IAC7B,UAAU,QACV,UAAU,KAAA,KACV,UAAU;GAEZ,CACD,MAAM;;AAGX,SAAgB,wBAAwB,UAAsC;AAC5E,QAAO,4BAA4B,kBAAkB,SAAS,CAAC,KAAK,IAAI,CAAC;;AAG3E,SAAgB,0CACd,4BACA,4BACe;AACf,QAAO,8BAA8B"}
+{"version":3,"file":"app-elements.js","names":[],"sources":["../../src/server/app-elements.ts"],"sourcesContent":["import { normalizeMountedSlotsHeader } from \"./app-mounted-slots-header.js\";\nimport { AppElementsWire, UNMATCHED_SLOT, type AppElements } from \"./app-elements-wire.js\";\n\nexport {\n  AppElementsWire,\n  APP_ARTIFACT_COMPATIBILITY_KEY,\n  APP_INTERCEPTION_CONTEXT_KEY,\n  APP_LAYOUT_IDS_KEY,\n  APP_LAYOUT_FLAGS_KEY,\n  APP_ROOT_LAYOUT_KEY,\n  APP_ROUTE_KEY,\n  APP_UNMATCHED_SLOT_WIRE_VALUE,\n  UNMATCHED_SLOT,\n  buildOutgoingAppPayload,\n  isAppElementsRecord,\n  normalizeAppElements,\n  readAppElementsMetadata,\n  withLayoutFlags,\n  type AppElementValue,\n  type AppElements,\n  type AppOutgoingElements,\n  type AppWireElements,\n  type LayoutFlags,\n} from \"./app-elements-wire.js\";\n\n// Raw constructor helpers stay private because callers use AppElementsWire codecs.\n\nexport function getMountedSlotIds(elements: AppElements): string[] {\n  return Object.keys(elements)\n    .filter((key) => {\n      const value = elements[key];\n      return (\n        AppElementsWire.isSlotId(key) &&\n        value !== null &&\n        value !== undefined &&\n        value !== UNMATCHED_SLOT\n      );\n    })\n    .sort();\n}\n\nexport function getMountedSlotIdsHeader(elements: AppElements): string | null {\n  return normalizeMountedSlotsHeader(getMountedSlotIds(elements).join(\" \"));\n}\n\nexport function resolveVisitedResponseInterceptionContext(\n  requestInterceptionContext: string | null,\n  payloadInterceptionContext: string | null,\n): string | null {\n  return payloadInterceptionContext ?? requestInterceptionContext;\n}\n"],"mappings":";;;AA2BA,SAAgB,kBAAkB,UAAiC;CACjE,OAAO,OAAO,KAAK,SAAS,CACzB,QAAQ,QAAQ;EACf,MAAM,QAAQ,SAAS;EACvB,OACE,gBAAgB,SAAS,IAAI,IAC7B,UAAU,QACV,UAAU,KAAA,KACV,UAAU;GAEZ,CACD,MAAM;;AAGX,SAAgB,wBAAwB,UAAsC;CAC5E,OAAO,4BAA4B,kBAAkB,SAAS,CAAC,KAAK,IAAI,CAAC;;AAG3E,SAAgB,0CACd,4BACA,4BACe;CACf,OAAO,8BAA8B"}

package/dist/server/app-fallback-renderer.js.map

@@ -1 +1 @@
-{"version":3,"file":"app-fallback-renderer.js","names":[],"sources":["../../src/server/app-fallback-renderer.ts"],"sourcesContent":["import type { ReactNode } from \"react\";\nimport type { AppPageParams } from \"./app-page-boundary.js\";\nimport {\n  renderAppPageErrorBoundary,\n  renderAppPageHttpAccessFallback,\n  type AppPageBoundaryRoute,\n} from \"./app-page-boundary-render.js\";\nimport type { AppPageFontPreload } from \"./app-page-execution.js\";\nimport type { AppPageMiddlewareContext } from \"./app-page-response.js\";\nimport type { AppPageSsrHandler } from \"./app-page-stream.js\";\nimport type { MetadataFileRoute } from \"./metadata-routes.js\";\nimport type { AppElements } from \"./app-elements.js\";\n\n// oxlint-disable-next-line @typescript-eslint/no-explicit-any\ntype AppPageComponent = import(\"react\").ComponentType<any>;\ntype AppPageModule = Record<string, unknown> & {\n  default?: AppPageComponent | null | undefined;\n};\ntype AppPageBoundaryOnError = (\n  error: unknown,\n  requestInfo: unknown,\n  errorContext: unknown,\n) => unknown;\n\ntype AppFallbackRendererRootBoundaries<TModule extends AppPageModule = AppPageModule> = {\n  rootForbiddenModule?: TModule | null;\n  rootLayouts: readonly (TModule | null | undefined)[];\n  rootNotFoundModule?: TModule | null;\n  rootUnauthorizedModule?: TModule | null;\n};\n\ntype AppFallbackRendererFontProviders = {\n  buildFontLinkHeader: (preloads: readonly AppPageFontPreload[] | null | undefined) => string;\n  getFontLinks: () => string[];\n  getFontPreloads: () => AppPageFontPreload[];\n  getFontStyles: () => string[];\n};\n\ntype AppFallbackRendererOptions<TModule extends AppPageModule = AppPageModule> = {\n  clearRequestContext: () => void;\n  createRscOnErrorHandler: (\n    request: Request,\n    pathname: string,\n    routePath: string,\n  ) => AppPageBoundaryOnError;\n  fontProviders: AppFallbackRendererFontProviders;\n  getNavigationContext: () => unknown;\n  globalErrorModule?: TModule | null;\n  makeThenableParams: (params: AppPageParams) => unknown;\n  metadataRoutes: MetadataFileRoute[];\n  resolveChildSegments: (\n    routeSegments: readonly string[],\n    treePosition: number,\n    params: AppPageParams,\n  ) => string[];\n  rootBoundaries: AppFallbackRendererRootBoundaries<TModule>;\n  rscRenderer: (\n    element: ReactNode | AppElements,\n    options: { onError: AppPageBoundaryOnError },\n  ) => ReadableStream<Uint8Array>;\n  sanitizer: (error: Error) => Error;\n  ssrLoader: () => Promise<AppPageSsrHandler>;\n};\n\ntype AppFallbackRenderer<TModule extends AppPageModule = AppPageModule> = {\n  renderErrorBoundary: (\n    route: AppPageBoundaryRoute<TModule> | null,\n    error: unknown,\n    isRscRequest: boolean,\n    request: Request,\n    matchedParams: AppPageParams | undefined,\n    scriptNonce: string | undefined,\n    middlewareContext: AppPageMiddlewareContext,\n  ) => Promise<Response | null>;\n  renderHttpAccessFallback: (\n    route: AppPageBoundaryRoute<TModule> | null,\n    statusCode: number,\n    isRscRequest: boolean,\n    request: Request,\n    opts: {\n      boundaryComponent?: AppPageComponent | null;\n      layouts?: readonly (TModule | null | undefined)[] | null;\n      matchedParams?: AppPageParams;\n    },\n    scriptNonce: string | undefined,\n    middlewareContext: AppPageMiddlewareContext,\n  ) => Promise<Response | null>;\n  renderNotFound: (\n    route: AppPageBoundaryRoute<TModule> | null,\n    isRscRequest: boolean,\n    request: Request,\n    matchedParams: AppPageParams | undefined,\n    scriptNonce: string | undefined,\n    middlewareContext: AppPageMiddlewareContext,\n  ) => Promise<Response | null>;\n};\n\nconst EMPTY_MW_CTX: AppPageMiddlewareContext = { headers: null, status: null };\n\nexport function createAppFallbackRenderer<TModule extends AppPageModule>(\n  options: AppFallbackRendererOptions<TModule>,\n): AppFallbackRenderer<TModule> {\n  const {\n    clearRequestContext,\n    createRscOnErrorHandler: buildRscOnErrorHandler,\n    fontProviders,\n    getNavigationContext,\n    globalErrorModule,\n    makeThenableParams,\n    metadataRoutes,\n    resolveChildSegments,\n    rootBoundaries,\n    rscRenderer,\n    sanitizer,\n    ssrLoader,\n  } = options;\n\n  const { rootForbiddenModule, rootLayouts, rootNotFoundModule, rootUnauthorizedModule } =\n    rootBoundaries;\n\n  return {\n    renderHttpAccessFallback(\n      route,\n      statusCode,\n      isRscRequest,\n      request,\n      opts,\n      scriptNonce,\n      middlewareContext,\n    ) {\n      return renderAppPageHttpAccessFallback({\n        boundaryComponent: opts?.boundaryComponent ?? null,\n        buildFontLinkHeader: fontProviders.buildFontLinkHeader,\n        clearRequestContext,\n        createRscOnErrorHandler(pathname, routePath) {\n          return buildRscOnErrorHandler(request, pathname, routePath);\n        },\n        getFontLinks: fontProviders.getFontLinks,\n        getFontPreloads: fontProviders.getFontPreloads,\n        getFontStyles: fontProviders.getFontStyles,\n        getNavigationContext,\n        globalErrorModule,\n        isRscRequest,\n        layoutModules: opts?.layouts ?? null,\n        loadSsrHandler: ssrLoader,\n        makeThenableParams,\n        matchedParams: opts?.matchedParams ?? route?.params ?? {},\n        middlewareContext: middlewareContext ?? EMPTY_MW_CTX,\n        metadataRoutes,\n        requestUrl: request.url,\n        resolveChildSegments,\n        rootForbiddenModule,\n        rootLayouts,\n        rootNotFoundModule,\n        rootUnauthorizedModule,\n        route,\n        renderToReadableStream: rscRenderer,\n        scriptNonce,\n        statusCode,\n      });\n    },\n\n    renderNotFound(route, isRscRequest, request, matchedParams, scriptNonce, middlewareContext) {\n      return this.renderHttpAccessFallback(\n        route,\n        404,\n        isRscRequest,\n        request,\n        { matchedParams },\n        scriptNonce,\n        middlewareContext,\n      );\n    },\n\n    renderErrorBoundary(\n      route,\n      error,\n      isRscRequest,\n      request,\n      matchedParams,\n      scriptNonce,\n      middlewareContext,\n    ) {\n      return renderAppPageErrorBoundary({\n        buildFontLinkHeader: fontProviders.buildFontLinkHeader,\n        clearRequestContext,\n        createRscOnErrorHandler(pathname, routePath) {\n          return buildRscOnErrorHandler(request, pathname, routePath);\n        },\n        error,\n        getFontLinks: fontProviders.getFontLinks,\n        getFontPreloads: fontProviders.getFontPreloads,\n        getFontStyles: fontProviders.getFontStyles,\n        getNavigationContext,\n        globalErrorModule,\n        isRscRequest,\n        loadSsrHandler: ssrLoader,\n        makeThenableParams,\n        matchedParams: matchedParams ?? route?.params ?? {},\n        middlewareContext: middlewareContext ?? EMPTY_MW_CTX,\n        metadataRoutes,\n        requestUrl: request.url,\n        resolveChildSegments,\n        rootLayouts,\n        route,\n        renderToReadableStream: rscRenderer,\n        sanitizeErrorForClient: sanitizer,\n        scriptNonce,\n      });\n    },\n  };\n}\n"],"mappings":";;AAiGA,MAAM,eAAyC;CAAE,SAAS;CAAM,QAAQ;CAAM;AAE9E,SAAgB,0BACd,SAC8B;CAC9B,MAAM,EACJ,qBACA,yBAAyB,wBACzB,eACA,sBACA,mBACA,oBACA,gBACA,sBACA,gBACA,aACA,WACA,cACE;CAEJ,MAAM,EAAE,qBAAqB,aAAa,oBAAoB,2BAC5D;AAEF,QAAO;EACL,yBACE,OACA,YACA,cACA,SACA,MACA,aACA,mBACA;AACA,UAAO,gCAAgC;IACrC,mBAAmB,MAAM,qBAAqB;IAC9C,qBAAqB,cAAc;IACnC;IACA,wBAAwB,UAAU,WAAW;AAC3C,YAAO,uBAAuB,SAAS,UAAU,UAAU;;IAE7D,cAAc,cAAc;IAC5B,iBAAiB,cAAc;IAC/B,eAAe,cAAc;IAC7B;IACA;IACA;IACA,eAAe,MAAM,WAAW;IAChC,gBAAgB;IAChB;IACA,eAAe,MAAM,iBAAiB,OAAO,UAAU,EAAE;IACzD,mBAAmB,qBAAqB;IACxC;IACA,YAAY,QAAQ;IACpB;IACA;IACA;IACA;IACA;IACA;IACA,wBAAwB;IACxB;IACA;IACD,CAAC;;EAGJ,eAAe,OAAO,cAAc,SAAS,eAAe,aAAa,mBAAmB;AAC1F,UAAO,KAAK,yBACV,OACA,KACA,cACA,SACA,EAAE,eAAe,EACjB,aACA,kBACD;;EAGH,oBACE,OACA,OACA,cACA,SACA,eACA,aACA,mBACA;AACA,UAAO,2BAA2B;IAChC,qBAAqB,cAAc;IACnC;IACA,wBAAwB,UAAU,WAAW;AAC3C,YAAO,uBAAuB,SAAS,UAAU,UAAU;;IAE7D;IACA,cAAc,cAAc;IAC5B,iBAAiB,cAAc;IAC/B,eAAe,cAAc;IAC7B;IACA;IACA;IACA,gBAAgB;IAChB;IACA,eAAe,iBAAiB,OAAO,UAAU,EAAE;IACnD,mBAAmB,qBAAqB;IACxC;IACA,YAAY,QAAQ;IACpB;IACA;IACA;IACA,wBAAwB;IACxB,wBAAwB;IACxB;IACD,CAAC;;EAEL"}
+{"version":3,"file":"app-fallback-renderer.js","names":[],"sources":["../../src/server/app-fallback-renderer.ts"],"sourcesContent":["import type { ReactNode } from \"react\";\nimport type { AppPageParams } from \"./app-page-boundary.js\";\nimport {\n  renderAppPageErrorBoundary,\n  renderAppPageHttpAccessFallback,\n  type AppPageBoundaryRoute,\n} from \"./app-page-boundary-render.js\";\nimport type { AppPageFontPreload } from \"./app-page-execution.js\";\nimport type { AppPageMiddlewareContext } from \"./app-page-response.js\";\nimport type { AppPageSsrHandler } from \"./app-page-stream.js\";\nimport type { MetadataFileRoute } from \"./metadata-routes.js\";\nimport type { AppElements } from \"./app-elements.js\";\n\n// oxlint-disable-next-line @typescript-eslint/no-explicit-any\ntype AppPageComponent = import(\"react\").ComponentType<any>;\ntype AppPageModule = Record<string, unknown> & {\n  default?: AppPageComponent | null | undefined;\n};\ntype AppPageBoundaryOnError = (\n  error: unknown,\n  requestInfo: unknown,\n  errorContext: unknown,\n) => unknown;\n\ntype AppFallbackRendererRootBoundaries<TModule extends AppPageModule = AppPageModule> = {\n  rootForbiddenModule?: TModule | null;\n  rootLayouts: readonly (TModule | null | undefined)[];\n  rootNotFoundModule?: TModule | null;\n  rootUnauthorizedModule?: TModule | null;\n};\n\ntype AppFallbackRendererFontProviders = {\n  buildFontLinkHeader: (preloads: readonly AppPageFontPreload[] | null | undefined) => string;\n  getFontLinks: () => string[];\n  getFontPreloads: () => AppPageFontPreload[];\n  getFontStyles: () => string[];\n};\n\ntype AppFallbackRendererOptions<TModule extends AppPageModule = AppPageModule> = {\n  clearRequestContext: () => void;\n  createRscOnErrorHandler: (\n    request: Request,\n    pathname: string,\n    routePath: string,\n  ) => AppPageBoundaryOnError;\n  fontProviders: AppFallbackRendererFontProviders;\n  getNavigationContext: () => unknown;\n  globalErrorModule?: TModule | null;\n  makeThenableParams: (params: AppPageParams) => unknown;\n  metadataRoutes: MetadataFileRoute[];\n  resolveChildSegments: (\n    routeSegments: readonly string[],\n    treePosition: number,\n    params: AppPageParams,\n  ) => string[];\n  rootBoundaries: AppFallbackRendererRootBoundaries<TModule>;\n  rscRenderer: (\n    element: ReactNode | AppElements,\n    options: { onError: AppPageBoundaryOnError },\n  ) => ReadableStream<Uint8Array>;\n  sanitizer: (error: Error) => Error;\n  ssrLoader: () => Promise<AppPageSsrHandler>;\n};\n\ntype AppFallbackRenderer<TModule extends AppPageModule = AppPageModule> = {\n  renderErrorBoundary: (\n    route: AppPageBoundaryRoute<TModule> | null,\n    error: unknown,\n    isRscRequest: boolean,\n    request: Request,\n    matchedParams: AppPageParams | undefined,\n    scriptNonce: string | undefined,\n    middlewareContext: AppPageMiddlewareContext,\n  ) => Promise<Response | null>;\n  renderHttpAccessFallback: (\n    route: AppPageBoundaryRoute<TModule> | null,\n    statusCode: number,\n    isRscRequest: boolean,\n    request: Request,\n    opts: {\n      boundaryComponent?: AppPageComponent | null;\n      layouts?: readonly (TModule | null | undefined)[] | null;\n      matchedParams?: AppPageParams;\n    },\n    scriptNonce: string | undefined,\n    middlewareContext: AppPageMiddlewareContext,\n  ) => Promise<Response | null>;\n  renderNotFound: (\n    route: AppPageBoundaryRoute<TModule> | null,\n    isRscRequest: boolean,\n    request: Request,\n    matchedParams: AppPageParams | undefined,\n    scriptNonce: string | undefined,\n    middlewareContext: AppPageMiddlewareContext,\n  ) => Promise<Response | null>;\n};\n\nconst EMPTY_MW_CTX: AppPageMiddlewareContext = { headers: null, status: null };\n\nexport function createAppFallbackRenderer<TModule extends AppPageModule>(\n  options: AppFallbackRendererOptions<TModule>,\n): AppFallbackRenderer<TModule> {\n  const {\n    clearRequestContext,\n    createRscOnErrorHandler: buildRscOnErrorHandler,\n    fontProviders,\n    getNavigationContext,\n    globalErrorModule,\n    makeThenableParams,\n    metadataRoutes,\n    resolveChildSegments,\n    rootBoundaries,\n    rscRenderer,\n    sanitizer,\n    ssrLoader,\n  } = options;\n\n  const { rootForbiddenModule, rootLayouts, rootNotFoundModule, rootUnauthorizedModule } =\n    rootBoundaries;\n\n  return {\n    renderHttpAccessFallback(\n      route,\n      statusCode,\n      isRscRequest,\n      request,\n      opts,\n      scriptNonce,\n      middlewareContext,\n    ) {\n      return renderAppPageHttpAccessFallback({\n        boundaryComponent: opts?.boundaryComponent ?? null,\n        buildFontLinkHeader: fontProviders.buildFontLinkHeader,\n        clearRequestContext,\n        createRscOnErrorHandler(pathname, routePath) {\n          return buildRscOnErrorHandler(request, pathname, routePath);\n        },\n        getFontLinks: fontProviders.getFontLinks,\n        getFontPreloads: fontProviders.getFontPreloads,\n        getFontStyles: fontProviders.getFontStyles,\n        getNavigationContext,\n        globalErrorModule,\n        isRscRequest,\n        layoutModules: opts?.layouts ?? null,\n        loadSsrHandler: ssrLoader,\n        makeThenableParams,\n        matchedParams: opts?.matchedParams ?? route?.params ?? {},\n        middlewareContext: middlewareContext ?? EMPTY_MW_CTX,\n        metadataRoutes,\n        requestUrl: request.url,\n        resolveChildSegments,\n        rootForbiddenModule,\n        rootLayouts,\n        rootNotFoundModule,\n        rootUnauthorizedModule,\n        route,\n        renderToReadableStream: rscRenderer,\n        scriptNonce,\n        statusCode,\n      });\n    },\n\n    renderNotFound(route, isRscRequest, request, matchedParams, scriptNonce, middlewareContext) {\n      return this.renderHttpAccessFallback(\n        route,\n        404,\n        isRscRequest,\n        request,\n        { matchedParams },\n        scriptNonce,\n        middlewareContext,\n      );\n    },\n\n    renderErrorBoundary(\n      route,\n      error,\n      isRscRequest,\n      request,\n      matchedParams,\n      scriptNonce,\n      middlewareContext,\n    ) {\n      return renderAppPageErrorBoundary({\n        buildFontLinkHeader: fontProviders.buildFontLinkHeader,\n        clearRequestContext,\n        createRscOnErrorHandler(pathname, routePath) {\n          return buildRscOnErrorHandler(request, pathname, routePath);\n        },\n        error,\n        getFontLinks: fontProviders.getFontLinks,\n        getFontPreloads: fontProviders.getFontPreloads,\n        getFontStyles: fontProviders.getFontStyles,\n        getNavigationContext,\n        globalErrorModule,\n        isRscRequest,\n        loadSsrHandler: ssrLoader,\n        makeThenableParams,\n        matchedParams: matchedParams ?? route?.params ?? {},\n        middlewareContext: middlewareContext ?? EMPTY_MW_CTX,\n        metadataRoutes,\n        requestUrl: request.url,\n        resolveChildSegments,\n        rootLayouts,\n        route,\n        renderToReadableStream: rscRenderer,\n        sanitizeErrorForClient: sanitizer,\n        scriptNonce,\n      });\n    },\n  };\n}\n"],"mappings":";;AAiGA,MAAM,eAAyC;CAAE,SAAS;CAAM,QAAQ;CAAM;AAE9E,SAAgB,0BACd,SAC8B;CAC9B,MAAM,EACJ,qBACA,yBAAyB,wBACzB,eACA,sBACA,mBACA,oBACA,gBACA,sBACA,gBACA,aACA,WACA,cACE;CAEJ,MAAM,EAAE,qBAAqB,aAAa,oBAAoB,2BAC5D;CAEF,OAAO;EACL,yBACE,OACA,YACA,cACA,SACA,MACA,aACA,mBACA;GACA,OAAO,gCAAgC;IACrC,mBAAmB,MAAM,qBAAqB;IAC9C,qBAAqB,cAAc;IACnC;IACA,wBAAwB,UAAU,WAAW;KAC3C,OAAO,uBAAuB,SAAS,UAAU,UAAU;;IAE7D,cAAc,cAAc;IAC5B,iBAAiB,cAAc;IAC/B,eAAe,cAAc;IAC7B;IACA;IACA;IACA,eAAe,MAAM,WAAW;IAChC,gBAAgB;IAChB;IACA,eAAe,MAAM,iBAAiB,OAAO,UAAU,EAAE;IACzD,mBAAmB,qBAAqB;IACxC;IACA,YAAY,QAAQ;IACpB;IACA;IACA;IACA;IACA;IACA;IACA,wBAAwB;IACxB;IACA;IACD,CAAC;;EAGJ,eAAe,OAAO,cAAc,SAAS,eAAe,aAAa,mBAAmB;GAC1F,OAAO,KAAK,yBACV,OACA,KACA,cACA,SACA,EAAE,eAAe,EACjB,aACA,kBACD;;EAGH,oBACE,OACA,OACA,cACA,SACA,eACA,aACA,mBACA;GACA,OAAO,2BAA2B;IAChC,qBAAqB,cAAc;IACnC;IACA,wBAAwB,UAAU,WAAW;KAC3C,OAAO,uBAAuB,SAAS,UAAU,UAAU;;IAE7D;IACA,cAAc,cAAc;IAC5B,iBAAiB,cAAc;IAC/B,eAAe,cAAc;IAC7B;IACA;IACA;IACA,gBAAgB;IAChB;IACA,eAAe,iBAAiB,OAAO,UAAU,EAAE;IACnD,mBAAmB,qBAAqB;IACxC;IACA,YAAY,QAAQ;IACpB;IACA;IACA;IACA,wBAAwB;IACxB,wBAAwB;IACxB;IACD,CAAC;;EAEL"}

package/dist/server/app-hook-warning-suppression.js.map

@@ -1 +1 @@
-{"version":3,"file":"app-hook-warning-suppression.js","names":[],"sources":["../../src/server/app-hook-warning-suppression.ts"],"sourcesContent":["import { AsyncLocalStorage } from \"node:async_hooks\";\n\nexport const suppressHookWarningAls = new AsyncLocalStorage<boolean>();\n\nconst _origConsoleError = console.error;\nconsole.error = (...args: unknown[]) => {\n  if (\n    suppressHookWarningAls.getStore() === true &&\n    typeof args[0] === \"string\" &&\n    args[0].includes(\"Invalid hook call\")\n  )\n    return;\n  _origConsoleError.apply(console, args);\n};\n"],"mappings":";;AAEA,MAAa,yBAAyB,IAAI,mBAA4B;AAEtE,MAAM,oBAAoB,QAAQ;AAClC,QAAQ,SAAS,GAAG,SAAoB;AACtC,KACE,uBAAuB,UAAU,KAAK,QACtC,OAAO,KAAK,OAAO,YACnB,KAAK,GAAG,SAAS,oBAAoB,CAErC;AACF,mBAAkB,MAAM,SAAS,KAAK"}
+{"version":3,"file":"app-hook-warning-suppression.js","names":[],"sources":["../../src/server/app-hook-warning-suppression.ts"],"sourcesContent":["import { AsyncLocalStorage } from \"node:async_hooks\";\n\nexport const suppressHookWarningAls = new AsyncLocalStorage<boolean>();\n\nconst _origConsoleError = console.error;\nconsole.error = (...args: unknown[]) => {\n  if (\n    suppressHookWarningAls.getStore() === true &&\n    typeof args[0] === \"string\" &&\n    args[0].includes(\"Invalid hook call\")\n  )\n    return;\n  _origConsoleError.apply(console, args);\n};\n"],"mappings":";;AAEA,MAAa,yBAAyB,IAAI,mBAA4B;AAEtE,MAAM,oBAAoB,QAAQ;AAClC,QAAQ,SAAS,GAAG,SAAoB;CACtC,IACE,uBAAuB,UAAU,KAAK,QACtC,OAAO,KAAK,OAAO,YACnB,KAAK,GAAG,SAAS,oBAAoB,EAErC;CACF,kBAAkB,MAAM,SAAS,KAAK"}

package/dist/server/app-middleware.d.ts

@@ -1,5 +1,6 @@
 import { NextI18nConfig } from "../config/next-config.js";
 import { MiddlewareModule } from "./middleware-runtime.js";
+import { FLIGHT_HEADERS } from "./headers.js";
 
 //#region src/server/app-middleware.d.ts
 type AppMiddlewareContext = {
@@ -24,7 +25,6 @@ type ApplyAppMiddlewareResult = {
   kind: "response";
   response: Response;
 };
-declare const FLIGHT_HEADERS: readonly string[];
 declare function isExternalMiddlewareRewrite(rewriteUrl: string, request: Request): boolean;
 declare function proxyExternalMiddlewareRewrite(request: Request, rewriteUrl: string, context: AppMiddlewareContext): Promise<Response>;
 declare function applyAppMiddleware(options: ApplyAppMiddlewareOptions): Promise<ApplyAppMiddlewareResult>;

package/dist/server/app-middleware.js

@@ -1,3 +1,4 @@
+import { FLIGHT_HEADERS, VINEXT_MW_CTX_HEADER } from "./headers.js";
 import { buildRequestHeadersFromMiddlewareResponse } from "./middleware-request-headers.js";
 import { isExternalUrl, proxyExternalRequest } from "../config/config-matchers.js";
 import { internalServerErrorResponse } from "./http-error-responses.js";
@@ -7,13 +8,6 @@ import { applyMiddlewareRequestHeaders, setHeadersContext } from "../shims/heade
 import { setNavigationContext } from "../shims/navigation.js";
 import { mergeMiddlewareResponseHeaders } from "./middleware-response-headers.js";
 //#region src/server/app-middleware.ts
-const FLIGHT_HEADERS = [
-	"rsc",
-	"next-router-state-tree",
-	"next-router-prefetch",
-	"next-hmr-refresh",
-	"next-router-segment-prefetch"
-];
 const FLIGHT_HEADER_SET = new Set(FLIGHT_HEADERS);
 function isForwardedMiddlewareContext(value) {
 	return !!value && typeof value === "object";
@@ -45,7 +39,7 @@ function isExternalMiddlewareRewrite(rewriteUrl, request) {
 	return new URL(rewriteUrl, request.url).origin !== new URL(request.url).origin;
 }
 function requestWithMiddlewareRequestHeaders(request, middlewareHeaders) {
-	const nextHeaders = middlewareHeaders ? buildRequestHeadersFromMiddlewareResponse(request.headers, middlewareHeaders) : null;
+	const nextHeaders = middlewareHeaders ? buildRequestHeadersFromMiddlewareResponse(request.headers, middlewareHeaders, { preserveCredentialHeaders: true }) : null;
 	if (!nextHeaders) return request;
 	const init = {
 		method: request.method,
@@ -81,7 +75,7 @@ async function proxyExternalMiddlewareRewrite(request, rewriteUrl, context) {
 }
 function applyForwardedMiddlewareContext(request, context) {
 	if (process.env.NODE_ENV === "production") return { applied: false };
-	const header = request.headers.get("x-vinext-mw-ctx");
+	const header = request.headers.get(VINEXT_MW_CTX_HEADER);
 	if (!header) return { applied: false };
 	try {
 		const data = JSON.parse(header);
@@ -142,6 +136,7 @@ async function applyAppMiddleware(options) {
 			};
 		}
 		if (result.responseHeaders) options.context.headers = new Headers(result.responseHeaders);
+		if (result.status !== void 0) options.context.status = result.status;
 		if (result.rewriteUrl) {
 			if (result.rewriteStatus !== void 0) options.context.status = result.rewriteStatus;
 			if (isExternalUrl(result.rewriteUrl)) return {