vinext 1.3.0 → 1.3.1

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

@@ -7,8 +7,8 @@ import { AppElementsWire } from "./app-elements-wire.js";
 import { getMountedSlotIds, getMountedSlotIdsHeader } from "./app-elements.js";
 import { bindAppElementsRenderedSearch } from "../shims/slot.js";
 import { createRscRequestHeaders } from "./app-rsc-cache-busting.js";
-import { createCacheEntryReuseProof } from "./cache-proof.js";
 import { createBfcacheSegmentIdentityMap, createInitialBfcacheIdMap, createNextBfcacheIdMap, preserveBfcacheIdsForMergedElements } from "./app-bfcache-identity.js";
+import { createCacheEntryReuseProof } from "./cache-proof.js";
 import { createAppOwnedHistoryState, createExternalHistoryStatePreservingMetadata, createHistoryStateWithNavigationMetadata, createHistoryStateWithPreviousNextUrl, createHistoryStateWithTreeSnapshotId, isExternalHistoryState, isHistoryStateBfcacheVersionCurrent, readHistoryStateActiveRoutePaths, readHistoryStateBfcacheIds, readHistoryStateBfcacheVersion, readHistoryStatePreviousNextUrl, readHistoryStateTraversalIndex, resolveActiveRoutePaths, resolveHistoryTraversalIntent } from "./app-history-state.js";
 import { NavigationTraceReasonCodes, createNavigationLifecycleTraceFields, createNavigationTrace } from "./navigation-trace.js";
 import { verifyOperationTokenForCommit } from "./operation-token.js";

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

@@ -21,4 +21,5 @@ export declare function chunksToReadableStream(chunks: readonly RscEmbeddedChunk
  * immediately instead of polling with setTimeout.
  */
 export declare function createProgressiveRscStream(): ReadableStream<Uint8Array>;
-//#endregion
+//#endregion
+export {};

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

@@ -79,4 +79,5 @@ export declare function resolveAndClassifyNavigationCommit(options: {
   targetHref: string;
   type: "navigate" | "replace" | "traverse";
 }): Promise<ClassifiedPendingNavigationCommit>;
-//#endregion
+//#endregion
+export {};

package/dist/server/app-client-reference-manifest.d.ts

@@ -0,0 +1,31 @@
+import { ClientReferenceChunks } from "../utils/client-reference-chunks.js";
+//#region src/server/app-client-reference-manifest.d.ts
+type ClientManifestEntry = {
+  id: string;
+  name: string;
+  chunks: string[];
+  async?: boolean;
+};
+type ClientManifest = Record<string, ClientManifestEntry>;
+/**
+ * Names the chunks each client reference loads in its Flight row, as Next.js
+ * does, so the browser loads a reference without a registry of every client
+ * reference in the app (see shims/internal/client-reference-loader.ts). Returns a
+ * function that wraps @vitejs/plugin-rsc's client manifest, which leaves the
+ * chunks empty. Without chunk data (development, or `rsc: false`) it returns
+ * the manifest unchanged.
+ */
+export declare function createClientReferenceChunksManifest(referenceChunks: ClientReferenceChunks | undefined): (manifest: ClientManifest) => ClientManifest;
+/**
+ * The SSR Flight client's consumer manifest. React's webpack binding loads the
+ * chunks a client reference's row names before requiring the reference, which
+ * only the browser can do, so SSR resolves each reference to itself without
+ * them. A null `moduleLoading` keeps React from preinitializing the chunks as
+ * classic scripts; SSR preloads them through @vitejs/plugin-rsc instead.
+ */
+export declare const ssrServerConsumerManifest: {
+  moduleMap: Record<string, Record<string, ClientManifestEntry>>;
+  moduleLoading: null;
+};
+//#endregion
+export {};

package/dist/server/app-client-reference-manifest.js

@@ -0,0 +1,46 @@
+import { toFlightChunks } from "../utils/client-reference-chunks.js";
+//#region src/server/app-client-reference-manifest.ts
+/**
+* Names the chunks each client reference loads in its Flight row, as Next.js
+* does, so the browser loads a reference without a registry of every client
+* reference in the app (see shims/internal/client-reference-loader.ts). Returns a
+* function that wraps @vitejs/plugin-rsc's client manifest, which leaves the
+* chunks empty. Without chunk data (development, or `rsc: false`) it returns
+* the manifest unchanged.
+*/
+function createClientReferenceChunksManifest(referenceChunks) {
+	if (!referenceChunks) return (manifest) => manifest;
+	const flightChunks = referenceChunks.modules.map(toFlightChunks);
+	return (manifest) => new Proxy(manifest, { get(target, id, receiver) {
+		const entry = Reflect.get(target, id, receiver);
+		if (typeof id !== "string" || !entry || typeof entry !== "object") return entry;
+		const reference = entry;
+		const index = Object.hasOwn(referenceChunks.references, reference.id) ? referenceChunks.references[reference.id] : void 0;
+		return index === void 0 ? reference : {
+			...reference,
+			chunks: flightChunks[index]
+		};
+	} });
+}
+/**
+* The SSR Flight client's consumer manifest. React's webpack binding loads the
+* chunks a client reference's row names before requiring the reference, which
+* only the browser can do, so SSR resolves each reference to itself without
+* them. A null `moduleLoading` keeps React from preinitializing the chunks as
+* classic scripts; SSR preloads them through @vitejs/plugin-rsc instead.
+*/
+const ssrServerConsumerManifest = {
+	moduleMap: new Proxy({}, { get(_target, id) {
+		if (typeof id !== "string") return void 0;
+		return new Proxy({}, { get(_exports, name) {
+			return typeof name === "string" ? {
+				id,
+				chunks: [],
+				name
+			} : void 0;
+		} });
+	} }),
+	moduleLoading: null
+};
+//#endregion
+export { createClientReferenceChunksManifest, ssrServerConsumerManifest };

package/dist/server/app-client-reference-preloader.d.ts

@@ -7,7 +7,11 @@ type ClientReferencePreloaderOptions = {
   onPreloadError?: (id: string, error: unknown) => void;
 };
 type ClientReferencePreloader = {
-  preload: (referenceIds?: Iterable<string>) => Promise<void>;
+  /**
+   * Load `referenceIds` in order, or every reference without them. The
+   * returned promise doesn't wait for those in `streamedIds`.
+   */
+  preload: (referenceIds?: Iterable<string>, streamedIds?: ReadonlySet<string>) => Promise<void>;
 };
 /**
  * The client references each App Router route preloads before SSR, generated
@@ -25,12 +29,28 @@ export type RouteClientReferences = {
   routes: Readonly<Record<string, readonly number[]>>;
   /** The files of a render without a route, such as a route-miss 404. */
   routeless: readonly number[];
+  /**
+   * References whose SSR modules evaluate asynchronously (top-level await),
+   * which a render streams instead of waiting for.
+   */
+  async: readonly number[];
+};
+/** The client references a render loads, and those it streams instead of waiting for. */
+export type RouteClientReferenceSet = {
+  /**
+   * In import order: the `always` set, then each route file's references in
+   * the order its route files render.
+   */
+  references: string[];
+  streamed: string[];
 };
 /**
  * The client references a render of `routePattern` preloads, or of no route
- * when it is null. Undefined, meaning every reference, without a plan or a
- * route to look up, or for a pattern the plan doesn't know.
+ * when it is null, and those it streams.
+ * Undefined, meaning every reference, without a plan or a route to look up,
+ * or for a pattern the plan doesn't know.
  */
-export declare function resolveRouteClientReferences(plan: RouteClientReferences | null, routePattern: string | null | undefined): string[] | undefined;
+export declare function resolveRouteClientReferences(plan: RouteClientReferences | null, routePattern: string | null | undefined): RouteClientReferenceSet | undefined;
 export declare function createClientReferencePreloader(options: ClientReferencePreloaderOptions): ClientReferencePreloader;
-//#endregion
+//#endregion
+export {};

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

@@ -3,8 +3,9 @@ import { shareIsolatePromise } from "./isolate-shared-promise.js";
 const resolvedPreload = Promise.resolve();
 /**
 * The client references a render of `routePattern` preloads, or of no route
-* when it is null. Undefined, meaning every reference, without a plan or a
-* route to look up, or for a pattern the plan doesn't know.
+* when it is null, and those it streams.
+* Undefined, meaning every reference, without a plan or a route to look up,
+* or for a pattern the plan doesn't know.
 */
 function resolveRouteClientReferences(plan, routePattern) {
 	if (!plan || routePattern === void 0) return void 0;
@@ -14,7 +15,18 @@ function resolveRouteClientReferences(plan, routePattern) {
 	else return;
 	const indices = new Set(plan.always);
 	for (const file of files) for (const index of plan.files[file]) indices.add(index);
-	return Array.from(indices, (index) => plan.references[index]);
+	const asyncIndices = new Set(plan.async);
+	const references = [];
+	const streamed = [];
+	for (const index of indices) {
+		const id = plan.references[index];
+		references.push(id);
+		if (asyncIndices.has(index)) streamed.push(id);
+	}
+	return {
+		references,
+		streamed
+	};
 }
 function createClientReferencePreloader(options) {
 	let allReferencesPreloaded = false;
@@ -42,17 +54,20 @@ function createClientReferencePreloader(options) {
 		referencePreloadPromises.set(id, preloadPromise);
 		return preloadPromise;
 	}
-	function preloadReferenceSet(referenceIds, refs, clientRequire) {
+	function preloadReferenceSet(referenceIds, refs, clientRequire, streamedIds) {
 		const pending = [];
-		for (const id of referenceIds) if (Object.hasOwn(refs, id) && !preloadedReferences.has(id)) pending.push(preloadReference(id, clientRequire));
+		for (const id of referenceIds) if (Object.hasOwn(refs, id) && !preloadedReferences.has(id)) {
+			const loading = preloadReference(id, clientRequire);
+			if (!streamedIds?.has(id)) pending.push(loading);
+		}
 		if (pending.length === 0) return resolvedPreload;
 		return Promise.all(pending).then(() => {});
 	}
-	return { preload(referenceIds) {
+	return { preload(referenceIds, streamedIds) {
 		const refs = options.getReferences();
 		const clientRequire = options.getClientRequire();
 		if (!refs || !clientRequire) return resolvedPreload;
-		if (referenceIds) return preloadReferenceSet(referenceIds, refs, clientRequire);
+		if (referenceIds) return preloadReferenceSet(referenceIds, refs, clientRequire, streamedIds);
 		if (allReferencesPreloaded) return resolvedPreload;
 		if (allReferencesPreloadPromise) return allReferencesPreloadPromise;
 		allReferencesPreloadPromise = shareIsolatePromise(preloadReferenceSet(Object.keys(refs), refs, clientRequire).then(() => {

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

@@ -183,4 +183,5 @@ export declare function buildOutgoingAppPayload(input: {
 }): ReactNode | AppOutgoingElements;
 export declare function readAppElementsMetadata(elements: Readonly<Record<string, unknown>>): AppElementsMetadata;
 export declare const AppElementsWire: AppElementsWireCodec;
-//#endregion
+//#endregion
+export {};

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

@@ -1,6 +1,8 @@
 import { APP_ARTIFACT_COMPATIBILITY_KEY, APP_BFCACHE_SEGMENT_IDENTITIES_KEY, APP_CACHE_ENTRY_REUSE_PROOF_KEY, APP_DYNAMIC_STALE_TIME_KEY, APP_INTERCEPTION_CONTEXT_KEY, APP_INTERCEPTION_KEY, APP_LAYOUT_FLAGS_KEY, APP_LAYOUT_IDS_KEY, APP_ROOT_LAYOUT_KEY, APP_ROUTE_KEY, APP_SKIPPED_LAYOUT_IDS_KEY, APP_SLOT_BINDINGS_KEY, APP_SOURCE_PAGE_SEGMENTS_KEY, APP_STATIC_SIBLINGS_KEY, APP_UNMATCHED_SLOT_WIRE_VALUE, AppElementValue, AppElements, AppElementsBfcacheSegmentIdentities, AppElementsInterception, AppElementsSlotBinding, AppElementsWire, AppOutgoingElements, AppWireElements, LayoutFlags, UNMATCHED_SLOT, buildOutgoingAppPayload, compareAppElementsSlotIds, isAppElementsRecord, normalizeAppElements, normalizeAppElementsSlotBindings, readAppElementsMetadata, withLayoutFlags } from "./app-elements-wire.js";
 //#region src/server/app-elements.d.ts
 export declare const APP_PREFETCH_LOADING_SHELL_MARKER_KEY = "__prefetchLoadingShell";
+/** Prefix of the element that streams a route's generateMetadata() tags in the body. */
+export declare const APP_STREAMING_METADATA_BODY_ID_PREFIX = "__vinext_streaming_metadata_body:";
 export declare function getMountedSlotIds(elements: AppElements): string[];
 export declare function getMountedSlotIdsHeader(elements: AppElements): string | null;
 export declare function resolveVisitedResponseInterceptionContext(requestInterceptionContext: string | null, payloadInterceptionContext: string | null): string | null;

package/dist/server/app-elements.js

@@ -2,6 +2,8 @@ import { normalizeMountedSlotsHeader } from "./app-mounted-slots-header.js";
 import { APP_ARTIFACT_COMPATIBILITY_KEY, APP_BFCACHE_SEGMENT_IDENTITIES_KEY, APP_CACHE_ENTRY_REUSE_PROOF_KEY, APP_DYNAMIC_STALE_TIME_KEY, APP_INTERCEPTION_CONTEXT_KEY, APP_INTERCEPTION_KEY, APP_LAYOUT_FLAGS_KEY, APP_LAYOUT_IDS_KEY, APP_ROOT_LAYOUT_KEY, APP_ROUTE_KEY, APP_SKIPPED_LAYOUT_IDS_KEY, APP_SLOT_BINDINGS_KEY, APP_SOURCE_PAGE_SEGMENTS_KEY, APP_STATIC_SIBLINGS_KEY, APP_UNMATCHED_SLOT_WIRE_VALUE, AppElementsWire, UNMATCHED_SLOT, buildOutgoingAppPayload, compareAppElementsSlotIds, isAppElementsRecord, normalizeAppElements, normalizeAppElementsSlotBindings, readAppElementsMetadata, withLayoutFlags } from "./app-elements-wire.js";
 //#region src/server/app-elements.ts
 const APP_PREFETCH_LOADING_SHELL_MARKER_KEY = "__prefetchLoadingShell";
+/** Prefix of the element that streams a route's generateMetadata() tags in the body. */
+const APP_STREAMING_METADATA_BODY_ID_PREFIX = "__vinext_streaming_metadata_body:";
 function getMountedSlotIds(elements) {
 	return Object.keys(elements).filter((key) => {
 		const value = elements[key];
@@ -16,4 +18,4 @@ function resolveVisitedResponseInterceptionContext(requestInterceptionContext, p
 	return payloadInterceptionContext ?? requestInterceptionContext;
 }
 //#endregion
-export { APP_ARTIFACT_COMPATIBILITY_KEY, APP_BFCACHE_SEGMENT_IDENTITIES_KEY, APP_CACHE_ENTRY_REUSE_PROOF_KEY, APP_DYNAMIC_STALE_TIME_KEY, APP_INTERCEPTION_CONTEXT_KEY, APP_INTERCEPTION_KEY, APP_LAYOUT_FLAGS_KEY, APP_LAYOUT_IDS_KEY, APP_PREFETCH_LOADING_SHELL_MARKER_KEY, APP_ROOT_LAYOUT_KEY, APP_ROUTE_KEY, APP_SKIPPED_LAYOUT_IDS_KEY, APP_SLOT_BINDINGS_KEY, APP_SOURCE_PAGE_SEGMENTS_KEY, APP_STATIC_SIBLINGS_KEY, APP_UNMATCHED_SLOT_WIRE_VALUE, AppElementsWire, UNMATCHED_SLOT, buildOutgoingAppPayload, compareAppElementsSlotIds, getMountedSlotIds, getMountedSlotIdsHeader, isAppElementsRecord, normalizeAppElements, normalizeAppElementsSlotBindings, readAppElementsMetadata, resolveVisitedResponseInterceptionContext, withLayoutFlags };
+export { APP_ARTIFACT_COMPATIBILITY_KEY, APP_BFCACHE_SEGMENT_IDENTITIES_KEY, APP_CACHE_ENTRY_REUSE_PROOF_KEY, APP_DYNAMIC_STALE_TIME_KEY, APP_INTERCEPTION_CONTEXT_KEY, APP_INTERCEPTION_KEY, APP_LAYOUT_FLAGS_KEY, APP_LAYOUT_IDS_KEY, APP_PREFETCH_LOADING_SHELL_MARKER_KEY, APP_ROOT_LAYOUT_KEY, APP_ROUTE_KEY, APP_SKIPPED_LAYOUT_IDS_KEY, APP_SLOT_BINDINGS_KEY, APP_SOURCE_PAGE_SEGMENTS_KEY, APP_STATIC_SIBLINGS_KEY, APP_STREAMING_METADATA_BODY_ID_PREFIX, APP_UNMATCHED_SLOT_WIRE_VALUE, AppElementsWire, UNMATCHED_SLOT, buildOutgoingAppPayload, compareAppElementsSlotIds, getMountedSlotIds, getMountedSlotIdsHeader, isAppElementsRecord, normalizeAppElements, normalizeAppElementsSlotBindings, readAppElementsMetadata, resolveVisitedResponseInterceptionContext, withLayoutFlags };

package/dist/server/app-fallback-renderer.d.ts

@@ -6,7 +6,7 @@ import "../shims/navigation.js";
 import { AppPageParams } from "./app-page-boundary.js";
 import { AppPageFontPreload } from "./app-page-execution.js";
 import { AppPageMiddlewareContext } from "./app-page-response.js";
-import { ApplyAppPageFileBasedMetadata } from "./app-page-head.js";
+import { AppPageFallbackRouteHead, ApplyAppPageFileBasedMetadata } from "./app-page-head.js";
 import { AppPageInterceptOptions } from "./app-page-element-builder.js";
 import { AppPageSsrHandler } from "./app-page-stream.js";
 import { AppRenderErrorContextOverrides } from "./app-rsc-error-handler.js";
@@ -95,13 +95,20 @@ type AppFallbackRenderer<TModule extends AppPageModule = AppPageModule> = {
   renderHttpAccessFallback: (route: AppPageBoundaryRoute<TModule> | null, statusCode: number, isRscRequest: boolean, request: Request, opts: {
     boundaryComponent?: AppPageComponent | null;
     boundaryModule?: TModule | null;
+    /** Boundary whose metadata the head uses, when not `boundaryModule`. */
+    headBoundaryModule?: TModule | null;
+    /** Layouts whose metadata the head uses, when more than `layouts`. */
+    headLayouts?: readonly (TModule | null | undefined)[] | null;
     intercept?: AppPageInterceptOptions<TModule> | null;
     /** The document may be stored, so it must not carry the request's query. */
     isCacheCandidate?: boolean;
     layouts?: readonly (TModule | null | undefined)[] | null;
     matchedParams?: AppPageParams;
+    /** The route's render threw the signal, so the document keeps the route's head. */
+    routeHead?: AppPageFallbackRouteHead | null;
   }, scriptNonce: string | undefined, middlewareContext: AppPageMiddlewareContext, callContext?: AppFallbackRendererCallContext) => Promise<Response | null>;
   renderNotFound: (route: AppPageBoundaryRoute<TModule> | null, isRscRequest: boolean, request: Request, matchedParams: AppPageParams | undefined, scriptNonce: string | undefined, middlewareContext: AppPageMiddlewareContext, callContext?: AppFallbackRendererCallContext) => Promise<Response | null>;
 };
 export declare function createAppFallbackRenderer<TModule extends AppPageModule>(options: AppFallbackRendererOptions<TModule>): AppFallbackRenderer<TModule>;
-//#endregion
+//#endregion
+export {};

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

@@ -4,7 +4,7 @@ import { DEFAULT_GLOBAL_ERROR_MODULE } from "./default-global-error-module.js";
 import { shouldServeStreamingMetadata } from "./streaming-metadata.js";
 import { renderAppPageErrorBoundary, renderAppPageHttpAccessFallback } from "./app-page-boundary-render.js";
 import { DEFAULT_GLOBAL_NOT_FOUND_MODULE } from "./default-global-not-found-module.js";
-import { DEFAULT_NOT_FOUND_MODULE } from "./default-not-found-module.js";
+import { DEFAULT_NOT_FOUND_MODULE } from "./default-http-access-fallback-modules.js";
 //#region src/server/app-fallback-renderer.ts
 const EMPTY_MW_CTX = {
 	headers: null,
@@ -86,6 +86,8 @@ function createAppFallbackRenderer(options) {
 				getAndClearPendingCookies,
 				getNavigationContext,
 				globalErrorModule: effectiveGlobalErrorModule,
+				headBoundaryModule: opts?.headBoundaryModule ?? null,
+				headLayoutModules: useGlobalNotFound ? [] : opts?.headLayouts ?? null,
 				intercept: opts?.intercept ?? null,
 				isCacheCandidate: opts?.isCacheCandidate,
 				isEdgeRuntime: callContext?.isEdgeRuntime,
@@ -104,6 +106,7 @@ function createAppFallbackRenderer(options) {
 				rootNotFoundModule: routeMissRootNotFoundModule,
 				rootUnauthorizedModule,
 				route: useGlobalNotFound ? null : route,
+				routeHead: opts?.routeHead ?? null,
 				routePathname: callContext?.routePathname,
 				renderToReadableStream: rscRenderer,
 				scriptNonce,

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

@@ -104,4 +104,5 @@ export declare function resolveHistoryTraversalIntent(options: {
   currentHistoryIndex: number | null;
   historyState: unknown;
 }): HistoryTraversalIntent;
-//#endregion
+//#endregion
+export {};

package/dist/server/app-inline-css-client.d.ts

@@ -2,4 +2,5 @@
 type InlineCssStylesheetLinkElement = Pick<HTMLLinkElement, "getAttribute" | "hasAttribute">;
 export declare function isInlineCssStylesheetLinkElement(link: InlineCssStylesheetLinkElement): boolean;
 export declare function removeStylesheetLinksCoveredByInlineCss(): void;
-//#endregion
+//#endregion
+export {};

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

@@ -38,4 +38,5 @@ export type StaticLayoutObservationSkipRejection = Readonly<{
 export declare function getStaticLayoutObservationSkipRejection(observation: AppLayoutParamAccessObservation): StaticLayoutObservationSkipRejection | null;
 export declare function isAppLayoutObservationUnsafeForStaticReuse(observation: AppLayoutParamAccessObservation): boolean;
 export declare function createAppLayoutParamAccessTracker(): AppLayoutParamAccessTracker;
-//#endregion
+//#endregion
+export {};

package/dist/server/app-metadata-tracing.d.ts

@@ -9,4 +9,5 @@ export declare function createGenerateMetadataSpanDescriptor(moduleRoute: string
   readonly name: `generateMetadata ${string}`;
   readonly type: "ResolveMetadata.generateMetadata";
 };
-//#endregion
+//#endregion
+export {};

package/dist/server/app-optimistic-routing.d.ts

@@ -49,6 +49,22 @@ export declare function createOptimisticRouteTemplate(options: {
   routeManifest: BrowserRouteManifest;
 }): OptimisticRouteTemplate | null;
 export declare function createOptimisticRouteElements(template: OptimisticRouteTemplate): AppElements;
+/**
+ * The optimistic shell reveals the prefetch's streamed metadata, such as its
+ * title. React won't hide revealed content again in a transition, so while the
+ * authoritative payload's own metadata streams, its whole commit, page
+ * included, would wait for it. Render that metadata in a new boundary whose
+ * fallback is the shell's instead, so the page commits as it streams and the
+ * prefetched title stays until the payload's arrives. Next.js likewise renders
+ * the prefetched head until the dynamic one resolves (`Head` in app-router.tsx).
+ *
+ * A payload streams at most one route's metadata. The shell's may carry
+ * another concrete route id, since a template learned for one set of params
+ * is reused for others. `navigationKey` remounts the boundary on every
+ * navigation, so one that already revealed an earlier navigation's metadata
+ * can't hold back the next, as Next.js keys `Head` by its vary path.
+ */
+export declare function keepOptimisticStreamingMetadata(elements: AppElements, optimisticElements: AppElements, navigationKey: string): AppElements;
 /**
  * A loading-shell prefetch stops at the first loading boundary, so layouts
  * below that boundary are present in the route metadata but absent from the
@@ -74,4 +90,5 @@ export declare function resolveOptimisticNavigationPayload(options: {
   routeManifest: BrowserRouteManifest;
   templates: ReadonlyMap<string, OptimisticRouteTemplate>;
 }): OptimisticNavigationPayload | null;
-//#endregion
+//#endregion
+export {};

package/dist/server/app-optimistic-routing.js

@@ -203,6 +203,39 @@ function createOptimisticRouteElements(template) {
 	for (const pageElementId of template.pageElementIds) elements[pageElementId] = createElement(OptimisticRouteSegment);
 	return elements;
 }
+function findStreamingMetadataBody(elements) {
+	for (const id of Object.keys(elements)) if (id.startsWith("__vinext_streaming_metadata_body:")) return id;
+	return null;
+}
+/**
+* The optimistic shell reveals the prefetch's streamed metadata, such as its
+* title. React won't hide revealed content again in a transition, so while the
+* authoritative payload's own metadata streams, its whole commit, page
+* included, would wait for it. Render that metadata in a new boundary whose
+* fallback is the shell's instead, so the page commits as it streams and the
+* prefetched title stays until the payload's arrives. Next.js likewise renders
+* the prefetched head until the dynamic one resolves (`Head` in app-router.tsx).
+*
+* A payload streams at most one route's metadata. The shell's may carry
+* another concrete route id, since a template learned for one set of params
+* is reused for others. `navigationKey` remounts the boundary on every
+* navigation, so one that already revealed an earlier navigation's metadata
+* can't hold back the next, as Next.js keys `Head` by its vary path.
+*/
+function keepOptimisticStreamingMetadata(elements, optimisticElements, navigationKey) {
+	const id = findStreamingMetadataBody(elements);
+	const optimisticId = findStreamingMetadataBody(optimisticElements);
+	if (id === null || optimisticId === null) return elements;
+	const optimisticMetadata = optimisticElements[optimisticId];
+	if (optimisticMetadata == null) return elements;
+	return {
+		...elements,
+		[id]: createElement(Suspense, {
+			fallback: optimisticMetadata,
+			key: navigationKey
+		}, elements[id])
+	};
+}
 /**
 * A loading-shell prefetch stops at the first loading boundary, so layouts
 * below that boundary are present in the route metadata but absent from the
@@ -278,4 +311,4 @@ function resolveOptimisticNavigationPayload(options) {
 	};
 }
 //#endregion
-export { canCommitOptimisticRouteTemplate, createOptimisticRouteElements, createOptimisticRouteTemplate, getOptimisticPrefetchSourceKey, getOptimisticRouteTemplateKey, matchOptimisticRouteManifestRoute, resolveOptimisticNavigationParamsForHref, resolveOptimisticNavigationPayload };
+export { canCommitOptimisticRouteTemplate, createOptimisticRouteElements, createOptimisticRouteTemplate, getOptimisticPrefetchSourceKey, getOptimisticRouteTemplateKey, keepOptimisticStreamingMetadata, matchOptimisticRouteManifestRoute, resolveOptimisticNavigationParamsForHref, resolveOptimisticNavigationPayload };

package/dist/server/app-page-boundary-render.d.ts

@@ -6,7 +6,7 @@ import "../shims/navigation.js";
 import { AppPageParams } from "./app-page-boundary.js";
 import { AppPageFontPreload } from "./app-page-execution.js";
 import { AppPageMiddlewareContext } from "./app-page-response.js";
-import { ApplyAppPageFileBasedMetadata } from "./app-page-head.js";
+import { AppPageFallbackRouteHead, ApplyAppPageFileBasedMetadata } from "./app-page-head.js";
 import { AppPageRouteWiringRoute } from "./app-page-route-wiring.js";
 import { AppPageInterceptOptions } from "./app-page-element-builder.js";
 import { AppPageSsrHandler } from "./app-page-stream.js";
@@ -30,9 +30,17 @@ export type AppPageBoundaryRoute<TModule extends AppPageModule = AppPageModule>
   notFound?: TModule | null;
   notFounds?: readonly (TModule | null | undefined)[] | null;
   notFoundTreePosition?: number | null;
+  page?: TModule | null;
   params?: AppPageParams;
   pattern?: string;
   routeSegments?: readonly string[];
+  childrenSlot?: AppPageRouteWiringRoute<TModule>["childrenSlot"];
+  segmentForbiddens?: readonly (TModule | null | undefined)[] | null;
+  segmentForbiddenTreePositions?: readonly number[] | null;
+  segmentNotFounds?: readonly (TModule | null | undefined)[] | null;
+  segmentNotFoundTreePositions?: readonly number[] | null;
+  segmentUnauthorizeds?: readonly (TModule | null | undefined)[] | null;
+  segmentUnauthorizedTreePositions?: readonly number[] | null;
   slots?: AppPageRouteWiringRoute<TModule>["slots"];
   unauthorized?: TModule | null;
   unauthorizedTreePosition?: number | null;
@@ -88,12 +96,21 @@ type AppPageBoundaryRenderCommonOptions<TModule extends AppPageModule = AppPageM
 type RenderAppPageHttpAccessFallbackOptions<TModule extends AppPageModule = AppPageModule> = {
   boundaryComponent?: AppPageComponent | null;
   boundaryModule?: TModule | null;
+  /** Boundary whose metadata the head uses, when not the rendered boundary. */
+  headBoundaryModule?: TModule | null;
+  /** Layouts whose metadata the head uses, when more than render around the boundary. */
+  headLayoutModules?: readonly (TModule | null | undefined)[] | null;
   intercept?: AppPageInterceptOptions<TModule> | null;
   layoutModules?: readonly (TModule | null | undefined)[] | null;
   matchedParams: AppPageParams;
   rootForbiddenModule?: TModule | null;
   rootNotFoundModule?: TModule | null;
   rootUnauthorizedModule?: TModule | null;
+  /**
+   * The matched route's render threw the signal, so the document keeps the
+   * route's own head rather than the boundary convention's.
+   */
+  routeHead?: AppPageFallbackRouteHead | null;
   /** Normalized, basePath-free application pathname used for route matching. */
   routePathname?: string;
   route?: AppPageBoundaryRoute<TModule> | null;
@@ -116,4 +133,5 @@ type RenderAppPageErrorBoundaryOptions<TModule extends AppPageModule = AppPageMo
 } & AppPageBoundaryRenderCommonOptions<TModule>;
 export declare function renderAppPageHttpAccessFallback<TModule extends AppPageModule>(options: RenderAppPageHttpAccessFallbackOptions<TModule>): Promise<Response | null>;
 export declare function renderAppPageErrorBoundary<TModule extends AppPageModule>(options: RenderAppPageErrorBoundaryOptions<TModule>): Promise<Response | null>;
-//#endregion
+//#endregion
+export {};