vinext 1.0.1 → 1.1.0

package/dist/server/app-page-route-wiring.js

@@ -1,14 +1,15 @@
 import { fnv1a64 } from "../utils/hash.js";
 import { APP_RSC_RENDER_MODE_PREFETCH_EMPTY, APP_RSC_RENDER_MODE_PREFETCH_LOADING_SHELL } from "./app-rsc-render-mode.js";
+import { createInlineScriptTag, escapeHtmlAttr } from "./html.js";
 import { createAppRenderDependency, registerAppElementRenderDependencies, renderAfterAppDependencies, renderAppComponentWithDependencyBarrier } from "./app-render-dependency.js";
 import { APP_LAYOUT_IDS_KEY, APP_ROOT_LAYOUT_KEY, APP_STATIC_SIBLINGS_KEY, AppElementsWire, normalizeAppElementsSlotBindings } from "./app-elements-wire.js";
 import { APP_PREFETCH_LOADING_SHELL_MARKER_KEY } from "./app-elements.js";
-import { createInlineScriptTag, escapeHtmlAttr } from "./html.js";
 import DefaultGlobalError from "../shims/default-global-error.js";
 import { ErrorBoundary, ForbiddenBoundary, GlobalErrorBoundary, NotFoundBoundary, RedirectBoundary, UnauthorizedBoundary } from "../shims/error-boundary.js";
 import { AppRouterScrollTarget } from "../shims/app-router-scroll.js";
 import DefaultNotFound from "../shims/default-not-found.js";
 import { LayoutSegmentProvider } from "../shims/layout-segment-context.js";
+import { withUseCacheLayoutMarker } from "../shims/internal/app-page-props-cache-key.js";
 import { MetadataHead, ViewportHead, renderMetadataToHtml } from "../shims/metadata.js";
 import { BfcacheSegmentBoundary, Children as Children$1, ParallelSlot, Slot } from "../shims/slot.js";
 import { StreamedIconsInsertion } from "../shims/streamed-icons.js";
@@ -64,7 +65,7 @@ function probeAppPageLayoutWithTracking(options) {
 		});
 		const layoutParams = resolveAppPageSegmentParams(options.route.routeSegments, treePosition, options.matchedParams);
 		return probeReactServerSubtree(/* @__PURE__ */ jsx(LayoutComponent, {
-			params: options.makeThenableParams(layoutParams, options.layoutParamAccess?.createThenableParamsObserver(layoutId)),
+			...withUseCacheLayoutMarker(LayoutComponent, { params: options.makeThenableParams(layoutParams, options.layoutParamAccess?.createThenableParamsObserver(layoutId)) }),
 			children: APP_PAGE_LAYOUT_PROBE_CHILD
 		}));
 	};
@@ -179,6 +180,14 @@ function createAppPageSlotLoadingEntries(slot, override) {
 	}
 	return entries;
 }
+/**
+* Only an override that replaces the slot's page or layouts changes its tree.
+* A params-only override, as built for an inherited slot with its own param
+* names, keeps the slot's nested loading boundaries.
+*/
+function getAppPageSlotTreeOverride(override) {
+	return override?.pageModule != null || override?.layoutModules !== void 0 ? override ?? null : null;
+}
 function getFirstLoadingEntry(entries) {
 	return entries.reduce((first, entry) => first === null || entry.treePosition < first.treePosition ? entry : first, null);
 }
@@ -242,17 +251,24 @@ function createAppPageSlotBindings(route, layoutEntries, resolveSlotOverride, op
 	}
 	return normalizeAppElementsSlotBindings(bindings, { layoutIds: layoutEntries.map((entry) => entry.id) });
 }
-function createAppPageRouteHead(metadata, viewport, pathname, metadataPlacement, trailingSlash) {
-	return /* @__PURE__ */ jsxs(Fragment$1, { children: [
-		/* @__PURE__ */ jsx("meta", { charSet: "utf-8" }),
-		metadata && metadataPlacement === "head" ? /* @__PURE__ */ jsx(MetadataHead, {
-			metadata,
-			pathname,
-			trailingSlash
-		}) : null,
-		/* @__PURE__ */ jsx(ViewportHead, { viewport })
-	] });
+function createAppPageRouteHead(resolveHead, pathname, metadataPlacement, trailingSlash) {
+	return /* @__PURE__ */ jsxs(Fragment$1, { children: [/* @__PURE__ */ jsx("meta", { charSet: "utf-8" }), resolveHead ? /* @__PURE__ */ jsx(AppPageHead, {
+		metadataPlacement,
+		pathname,
+		resolveHead,
+		trailingSlash
+	}) : /* @__PURE__ */ jsx(ViewportHead, { viewport: {} })] });
+}
+async function AppPageHead(props) {
+	const head = props.resolveHead();
+	const [metadata, viewport] = await Promise.all([props.metadataPlacement === "head" ? head.metadata : null, head.viewport]);
+	return /* @__PURE__ */ jsxs(Fragment$1, { children: [metadata ? /* @__PURE__ */ jsx(MetadataHead, {
+		metadata,
+		pathname: props.pathname,
+		trailingSlash: props.trailingSlash
+	}) : null, /* @__PURE__ */ jsx(ViewportHead, { viewport })] });
 }
+AppPageHead.displayName = "Vinext.Head";
 function hasStreamedIcons(metadata) {
 	const icons = metadata.icons;
 	if (!icons) return false;
@@ -282,15 +298,14 @@ function createAppPageRouteBodyMetadata(metadata, pathname, metadataPlacement, t
 }
 async function AppPageStreamingMetadata(props) {
 	try {
-		return createAppPageRouteBodyMetadata(await props.metadata, props.pathname, "body", props.trailingSlash, props.scriptNonce);
+		return createAppPageRouteBodyMetadata(await props.resolveHead().metadata, props.pathname, "body", props.trailingSlash, props.scriptNonce);
 	} catch {
 		return null;
 	}
 }
 AppPageStreamingMetadata.displayName = "Vinext.StreamingMetadata";
 async function AppPageMetadataOutlet(props) {
-	await props.metadata;
-	return null;
+	return props.resolveHead().outlet;
 }
 AppPageMetadataOutlet.displayName = "Vinext.MetadataOutlet";
 function createAppPageStreamingMetadataOutlet(elementId, suspended = true) {
@@ -319,8 +334,8 @@ function buildAppPageElements(options) {
 	const routeId = renderIdentity?.routeId ?? AppElementsWire.encodeRouteId(options.routePath, interceptionContext);
 	const pageId = renderIdentity?.pageId ?? AppElementsWire.encodePageId(options.routePath, interceptionContext);
 	const pageElementId = options.route.childrenSlot ? resolveAppPageChildrenSlotId(options.route.childrenSlot) : pageId;
-	const streamingMetadataBodyId = options.streamingMetadata ? `__vinext_streaming_metadata_body:${routeId}` : null;
-	const streamingMetadataOutletId = options.streamingMetadataOutlet ? `__vinext_streaming_metadata_outlet:${routeId}` : null;
+	const metadataPlacement = options.metadataPlacement ?? "head";
+	const streamingMetadataOutletId = options.resolveHead ? `__vinext_streaming_metadata_outlet:${routeId}` : null;
 	const layoutEntries = createAppPageLayoutEntries(options.route);
 	const templateEntries = createAppPageTemplateEntries(options.route);
 	const loadingEntries = createAppPageLoadingEntries(options.route);
@@ -337,7 +352,6 @@ function buildAppPageElements(options) {
 	const isPrefetchLoadingShell = renderMode === APP_RSC_RENDER_MODE_PREFETCH_LOADING_SHELL;
 	const pageRenderDependency = isPrefetchLoadingShell ? null : options.pageRenderDependency;
 	const prefetchLoadingEntry = isPrefetchLoadingShell ? getPrefetchLoadingEntry(options.route) : null;
-	const metadataPlacement = options.metadataPlacement ?? "head";
 	const layoutEntriesByTreePosition = /* @__PURE__ */ new Map();
 	const templateEntriesByTreePosition = /* @__PURE__ */ new Map();
 	const loadingEntriesByTreePosition = /* @__PURE__ */ new Map();
@@ -380,8 +394,11 @@ function buildAppPageElements(options) {
 		routePath: options.routePath
 	});
 	const prefetchSlotLoadingEntries = isPrefetchLoadingShell ? Object.entries(options.route.slots ?? {}).flatMap(([slotKey, slot]) => {
-		return getFirstLoadingEntry(createAppPageSlotLoadingEntries(slot, resolveSlotOverride(slotKey, slot.name) ?? null)) ? [{ ownerTreePosition: slot.ownerTreePosition ?? 0 }] : [];
+		return getFirstLoadingEntry(createAppPageSlotLoadingEntries(slot, getAppPageSlotTreeOverride(resolveSlotOverride(slotKey, slot.name)))) ? [{ ownerTreePosition: slot.ownerTreePosition ?? 0 }] : [];
 	}) : [];
+	const prefetchLoadingComponent = getDefaultExport(prefetchLoadingEntry?.loadingModule);
+	const shouldRenderPrefetchLoadingShell = isPrefetchLoadingShell && (prefetchLoadingComponent !== null || prefetchSlotLoadingEntries.length > 0);
+	const streamingMetadataBodyId = options.resolveHead && metadataPlacement === "body" && (!isPrefetchLoadingShell || shouldRenderPrefetchLoadingShell) ? `__vinext_streaming_metadata_body:${routeId}` : null;
 	const prefetchCutoffTreePosition = isPrefetchLoadingShell ? prefetchLoadingEntry?.treePosition ?? prefetchSlotLoadingEntries.reduce((deepest, entry) => Math.max(deepest, entry.ownerTreePosition), 0) : null;
 	const includesPrefetchTreePosition = (treePosition) => prefetchCutoffTreePosition === null || treePosition <= prefetchCutoffTreePosition;
 	const segmentPlan = createAppPageSegmentPlan({
@@ -426,13 +443,13 @@ function buildAppPageElements(options) {
 	const elements = {};
 	for (const slotPlan of segmentPlan.slots) for (const segment of slotPlan.nestedBfcacheSegments) elements[segment.id] = null;
 	if (options.route.staticSiblings && options.route.staticSiblings.length > 0) elements[APP_STATIC_SIBLINGS_KEY] = options.route.staticSiblings;
-	if (options.streamingMetadata && streamingMetadataBodyId) elements[streamingMetadataBodyId] = /* @__PURE__ */ jsx(AppPageStreamingMetadata, {
-		metadata: options.streamingMetadataTags ?? options.streamingMetadata,
+	if (options.resolveHead && streamingMetadataBodyId) elements[streamingMetadataBodyId] = /* @__PURE__ */ jsx(AppPageStreamingMetadata, {
 		pathname: options.resolvedMetadataPathname ?? options.routePath,
+		resolveHead: options.resolveHead,
 		scriptNonce: options.scriptNonce,
 		trailingSlash: options.trailingSlash
 	});
-	if (options.streamingMetadataOutlet && streamingMetadataOutletId) elements[streamingMetadataOutletId] = /* @__PURE__ */ jsx(AppPageMetadataOutlet, { metadata: options.streamingMetadataOutlet });
+	if (options.resolveHead && streamingMetadataOutletId) elements[streamingMetadataOutletId] = /* @__PURE__ */ jsx(AppPageMetadataOutlet, { resolveHead: options.resolveHead });
 	const getEffectiveSlotParams = (slotKey, _slotName) => slotPlansByKey.get(slotKey)?.params ?? options.matchedParams;
 	for (const treePosition of orderedTreePositions) {
 		if (isPrefetchLoadingShell && !includesPrefetchTreePosition(treePosition)) continue;
@@ -457,8 +474,6 @@ function buildAppPageElements(options) {
 	}
 	pageRenderDependency?.setResultDependencies(pageDependencies);
 	const routeLoadingComponent = getDefaultExport(options.route.loading);
-	const prefetchLoadingComponent = getDefaultExport(prefetchLoadingEntry?.loadingModule);
-	const shouldRenderPrefetchLoadingShell = isPrefetchLoadingShell && (prefetchLoadingComponent !== null || prefetchSlotLoadingEntries.length > 0);
 	if (shouldRenderPrefetchLoadingShell) elements[APP_PREFETCH_LOADING_SHELL_MARKER_KEY] = "LoadingBoundary";
 	const pageLoadingModule = resolveAppPageLoadingModuleAtOrAbove(options.route, routeSegments.length);
 	const PageLoadingComponent = pageRenderDependency ? getDefaultExport(pageLoadingModule) : null;
@@ -508,11 +523,11 @@ function buildAppPageElements(options) {
 		}
 		const LayoutComponent = layoutComponent;
 		const layoutDependency = layoutDependenciesByIndex.get(index);
-		let layoutElement = layoutDependency ? renderAppComponentWithDependencyBarrier(LayoutComponent, {
+		let layoutElement = layoutDependency ? renderAppComponentWithDependencyBarrier(LayoutComponent, withUseCacheLayoutMarker(LayoutComponent, {
 			...layoutProps,
 			children: /* @__PURE__ */ jsx(Children$1, {})
-		}, layoutDependency) : /* @__PURE__ */ jsx(LayoutComponent, {
-			...layoutProps,
+		}), layoutDependency) : /* @__PURE__ */ jsx(LayoutComponent, {
+			...withUseCacheLayoutMarker(LayoutComponent, layoutProps),
 			children: /* @__PURE__ */ jsx(Children$1, {})
 		});
 		const ancestorLoadingEntry = findNearestAncestorLoadingEntry(layoutEntry.treePosition);
@@ -532,8 +547,9 @@ function buildAppPageElements(options) {
 		const isOwnedAtRoutePrefetchCutoff = isPrefetchLoadingShell && prefetchLoadingEntry !== null && ownerTreePosition === prefetchLoadingEntry.treePosition;
 		if (!includedInPayload) continue;
 		const slotOwnerParams = resolveAppPageSegmentParams(options.route.routeSegments, layoutEntries[targetIndex]?.treePosition ?? 0, options.matchedParams);
-		const hasSlotTreeOverride = slotOverride?.pageModule != null || slotOverride?.layoutModules !== void 0;
-		const slotLoadingEntries = createAppPageSlotLoadingEntries(slot, hasSlotTreeOverride ? slotOverride ?? null : null);
+		const slotTreeOverride = getAppPageSlotTreeOverride(slotOverride);
+		const hasSlotTreeOverride = slotTreeOverride !== null;
+		const slotLoadingEntries = createAppPageSlotLoadingEntries(slot, slotTreeOverride);
 		const prefetchSlotLoadingEntry = isOwnedAtRoutePrefetchCutoff ? prefetchLoadingEntry : isPrefetchLoadingShell ? getFirstLoadingEntry(slotLoadingEntries) : null;
 		if (isPrefetchLoadingShell && prefetchSlotLoadingEntry === null) continue;
 		const resolvedOverrideOrPageComponent = slotOverride?.pageModule || slot.page ? traceGetLayoutOrPageModule(APP_PAGE_SEGMENT_KEY, () => getDefaultExport(slotOverride?.pageModule) ?? getDefaultExport(slot.page)) : null;
@@ -557,6 +573,10 @@ function buildAppPageElements(options) {
 				return /* @__PURE__ */ jsx(slotComponent, { ...slotProps });
 			})();
 			if (overrideOrPageComponent) slotElement = /* @__PURE__ */ jsx(Fragment, { children: slotElement }, slotResetKey);
+			slotElement = /* @__PURE__ */ jsx(RedirectBoundary, {
+				resetKey: slotResetKey,
+				children: slotElement
+			});
 		}
 		const branchLayouts = /* @__PURE__ */ new Map();
 		const addBranchLayout = (treePosition, entry) => {
@@ -637,7 +657,7 @@ function buildAppPageElements(options) {
 				const layoutEntry = layoutEntriesAtPosition[layoutIndex];
 				const LayoutComponent = layoutEntry.component;
 				slotElement = /* @__PURE__ */ jsx(LayoutComponent, {
-					params: options.makeThenableParams(layoutEntry.params),
+					...withUseCacheLayoutMarker(LayoutComponent, { params: options.makeThenableParams(layoutEntry.params) }),
 					children: slotElement
 				});
 			}
@@ -669,7 +689,10 @@ function buildAppPageElements(options) {
 		if (prefetchLoadingComponent === null) routeChildren = null;
 		else routeChildren = /* @__PURE__ */ jsx(prefetchLoadingComponent, {});
 	} else {
-		routeChildren = /* @__PURE__ */ jsx(RedirectBoundary, { children: routeChildren });
+		routeChildren = /* @__PURE__ */ jsx(RedirectBoundary, {
+			resetKey: routeResetKey,
+			children: routeChildren
+		});
 		if (routeLoadingComponent) routeChildren = /* @__PURE__ */ jsx(Suspense, {
 			fallback: /* @__PURE__ */ jsx(routeLoadingComponent, {}),
 			children: routeChildren
@@ -787,9 +810,8 @@ function buildAppPageElements(options) {
 		}) : routeChildren
 	});
 	const routeElement = /* @__PURE__ */ jsxs(Fragment$1, { children: [
-		createAppPageRouteHead(options.resolvedMetadata, options.resolvedViewport, options.resolvedMetadataPathname ?? options.routePath, metadataPlacement, options.trailingSlash),
+		createAppPageRouteHead(options.resolveHead, options.resolvedMetadataPathname ?? options.routePath, metadataPlacement, options.trailingSlash),
 		routeChildren,
-		createAppPageRouteBodyMetadata(options.resolvedMetadata, options.resolvedMetadataPathname ?? options.routePath, metadataPlacement, options.trailingSlash, options.scriptNonce),
 		createAppPageStreamingMetadataBody(streamingMetadataBodyId)
 	] });
 	elements[routeId] = pageRenderDependency ? renderAfterAppDependencies(routeElement, [pageRenderDependency]) : routeElement;

package/dist/server/app-page-rsc-render-status.d.ts

@@ -0,0 +1,48 @@
+import { NavigationContext } from "../shims/navigation-context-state.js";
+import "../shims/navigation.js";
+import { RootParams } from "../shims/root-params.js";
+import { AppPageSsrHandler } from "./app-page-stream.js";
+//#region src/server/app-page-rsc-render-status.d.ts
+/**
+ * The status of a finished RSC render, as Next.js's static generation decides
+ * it from the document's shell. A special error that rejects the shell sets
+ * it. One inside a Suspense boundary leaves the render a 200.
+ */
+export type AppPageRscRenderStatus = {
+  kind: "page";
+} | {
+  kind: "special-error";
+  status: number;
+  headers?: Record<string, string>;
+} |
+/**
+ * A render not stored: another error rejected the shell, or
+ * generateMetadata()'s special error, whose document an RSC miss can't write.
+ */
+{
+  kind: "unstorable";
+};
+type CreateAppPageRscRenderStatusResolverOptions = {
+  basePath?: string;
+  capturedRscData: Promise<ArrayBuffer>;
+  getCapturedSpecialError: () => unknown;
+  getCapturedSpecialErrors: (error: unknown) => readonly unknown[];
+  isForceStatic: boolean;
+  loadSsrHandler: () => Promise<AppPageSsrHandler>;
+  navigationContext: NavigationContext | null;
+  rootParams?: RootParams;
+};
+/**
+ * Resolve an RSC-only render's status once its Flight payload is complete.
+ * Flight can't tell whether a special error sits inside a Suspense boundary, so
+ * a render that threw one renders the document's shell from the same payload,
+ * as Next.js's static generation renders HTML beside RSC. Its server
+ * components don't run again. A render without a special error is a 200.
+ */
+export declare function createAppPageRscRenderStatusResolver(options: CreateAppPageRscRenderStatusResolverOptions): () => Promise<AppPageRscRenderStatus>;
+/**
+ * The status Next.js sends an RSC request for a render with this status. Its
+ * payload carries a redirect, so a redirect is a 200 with its `location`.
+ */
+export declare function resolveAppPageRscResponseStatus(status: number): number;
+//#endregion

package/dist/server/app-page-rsc-render-status.js

@@ -0,0 +1,54 @@
+import { resolveAppPageShellSpecialError, resolveAppPageSpecialErrorStoredHeaders } from "./app-page-execution.js";
+import { isAppSsrRenderResult } from "./app-page-stream.js";
+//#region src/server/app-page-rsc-render-status.ts
+const PAGE_STATUS = { kind: "page" };
+/**
+* Resolve an RSC-only render's status once its Flight payload is complete.
+* Flight can't tell whether a special error sits inside a Suspense boundary, so
+* a render that threw one renders the document's shell from the same payload,
+* as Next.js's static generation renders HTML beside RSC. Its server
+* components don't run again. A render without a special error is a 200.
+*/
+function createAppPageRscRenderStatusResolver(options) {
+	let status;
+	return () => status ??= resolveAppPageRscRenderStatus(options);
+}
+async function resolveAppPageRscRenderStatus(options) {
+	const rscData = await options.capturedRscData;
+	if (options.getCapturedSpecialError() === null) return PAGE_STATUS;
+	const ssrHandler = await options.loadSsrHandler();
+	let rendered;
+	try {
+		rendered = await ssrHandler.handleSsr(new Response(rscData).body, options.navigationContext, {
+			links: [],
+			preloads: [],
+			styles: []
+		}, {
+			basePath: options.basePath,
+			isForceStatic: options.isForceStatic,
+			isStaticGeneration: true,
+			onSsrError: () => void 0,
+			rootParams: options.rootParams
+		});
+	} catch (error) {
+		const specialError = resolveAppPageShellSpecialError(error, options.getCapturedSpecialErrors(error));
+		if (!specialError || specialError.fromMetadata === true) return { kind: "unstorable" };
+		const headers = resolveAppPageSpecialErrorStoredHeaders(specialError, options.basePath);
+		return {
+			kind: "special-error",
+			status: specialError.statusCode,
+			...headers ? { headers } : {}
+		};
+	}
+	(isAppSsrRenderResult(rendered) ? rendered.htmlStream : rendered).cancel().catch(() => {});
+	return PAGE_STATUS;
+}
+/**
+* The status Next.js sends an RSC request for a render with this status. Its
+* payload carries a redirect, so a redirect is a 200 with its `location`.
+*/
+function resolveAppPageRscResponseStatus(status) {
+	return status >= 300 && status < 400 ? 200 : status;
+}
+//#endregion
+export { createAppPageRscRenderStatusResolver, resolveAppPageRscResponseStatus };

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

@@ -83,8 +83,9 @@ export type AppPageSsrHandler = {
     initialDevServerError?: unknown;
     /** Report an SSR/Fizz render failure through instrumentation. */
     onSsrError?: (error: unknown) => unknown;
-    /** Mirror inline Flight chunks into Next.js's `self.__next_f` transport. */
-    mirrorNextFlight?: boolean;
+    /** Mirror inline Flight chunks into Next.js's `self.__next_f` transport, or start
+     *  mirroring once a function returns true. */
+    mirrorNextFlight?: boolean | (() => boolean);
     /** When true, an SSR-phase-only shell render error resolves to the
      *  default `__next_error__` error-document shell (with the original
      *  flight payload and bootstrap) instead of rejecting. See handleSsr. */
@@ -141,8 +142,9 @@ type RenderAppPageHtmlStreamOptions = {
   initialDevServerError?: unknown;
   /** Report an SSR/Fizz render failure through instrumentation. */
   onSsrError?: (error: unknown) => unknown;
-  /** Mirror inline Flight chunks into Next.js's `self.__next_f` transport. */
-  mirrorNextFlight?: boolean;
+  /** Mirror inline Flight chunks into Next.js's `self.__next_f` transport, or start
+   *  mirroring once a function returns true. */
+  mirrorNextFlight?: boolean | (() => boolean);
   /** True when the app supplies a custom global-error.tsx. Disables the
    *  default error-document shell fallback so SSR shell errors keep driving
    *  the server-rendered global-error boundary re-render. */
@@ -175,12 +177,17 @@ type RenderAppPageHtmlStreamWithRecoveryOptions<TSpecialError> = {
 type AppPageRscErrorTracker = {
   getCapturedError: () => unknown;
   /**
-   * Returns a NEXT_REDIRECT or NEXT_HTTP_ERROR_FALLBACK error captured during
-   * the RSC render. Read after the SSR shell promise resolves to swap a
-   * 307/404 in place of the streamed body when redirect()/notFound() throws
-   * synchronously inside a route-level Suspense boundary (loading.tsx).
+   * Returns the first NEXT_REDIRECT or NEXT_HTTP_ERROR_FALLBACK error captured
+   * during the RSC render, if any. Whether it set the render's status depends
+   * on whether it rejected the document's shell.
    */
   getCapturedSpecialError: () => unknown;
+  /**
+   * The special errors the RSC render threw with the digest of `error`. The
+   * SSR shell rejects with its own copy, decoded from the Flight digest, which
+   * loses server-side markers such as generateMetadata()'s.
+   */
+  getCapturedSpecialErrors: (error: unknown) => readonly unknown[];
   isCapturedError: (error: unknown) => boolean;
   onRenderError: (error: unknown, requestInfo: unknown, errorContext: unknown) => unknown;
 };

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

@@ -151,6 +151,7 @@ function createAppPageRscErrorTracker(baseOnError) {
 	let capturedSpecialError = null;
 	const capturedErrors = /* @__PURE__ */ new Set();
 	const capturedDigests = /* @__PURE__ */ new Set();
+	const specialErrorsByDigest = /* @__PURE__ */ new Map();
 	return {
 		getCapturedError() {
 			return capturedError;
@@ -158,6 +159,10 @@ function createAppPageRscErrorTracker(baseOnError) {
 		getCapturedSpecialError() {
 			return capturedSpecialError;
 		},
+		getCapturedSpecialErrors(error) {
+			const digest = getNextErrorDigest(error);
+			return digest !== null && specialErrorsByDigest.get(digest) || [];
+		},
 		isCapturedError(error) {
 			if (capturedErrors.has(error)) return true;
 			const digest = getNextErrorDigest(error);
@@ -173,6 +178,7 @@ function createAppPageRscErrorTracker(baseOnError) {
 			const result = baseOnError(error, requestInfo, errorContext);
 			const digest = typeof result === "string" ? result : getNextErrorDigest(error);
 			if (digest !== null && !isNavigationSignalError(error)) capturedDigests.add(digest);
+			else if (digest !== null) specialErrorsByDigest.set(digest, [...specialErrorsByDigest.get(digest) ?? [], error]);
 			return result;
 		}
 	};

package/dist/server/app-request-stage-dispatch.js

@@ -40,7 +40,7 @@ async function dispatchAppRequestStage(request, ctx, dispatchResponseStage, opti
 			draftModeCookie: null,
 			middlewareCookieOverlay: null,
 			prerenderDiscovery: options.prerenderDiscovery,
-			protocolVersion: 10,
+			protocolVersion: 11,
 			requestOrigin: new URL(request.url).origin,
 			scriptNonce: null,
 			staticFileSignalToken,

package/dist/server/app-request-stage-independent-entry.js

@@ -3,9 +3,8 @@ import { runWithExecutionContext } from "../shims/request-context.js";
 import "./server-globals.js";
 import "./app-rsc-vary.js";
 import { VINEXT_CACHEABILITY_PROBE_QUERY_PARAM, VINEXT_EXPECTED_WORKER_VERSION_HEADER } from "./headers.js";
-import { badRequestResponse, notFoundResponse } from "./http-error-responses.js";
-import { isOpenRedirectShaped } from "./open-redirect.js";
-import { cloneRequestWithHeaders, filterInternalHeaders } from "./request-pipeline.js";
+import { badRequestResponse } from "./http-error-responses.js";
+import { cloneRequestWithHeaders, filterInternalHeaders, guardProtocolRelativeUrl } from "./request-pipeline.js";
 import { getExplicitCdnCacheAdapter } from "../shims/cdn-cache-state.js";
 import { applyCdnResponseIdentityHeaders, validateCdnRequest } from "./cache-control.js";
 import { registerLazyDataCacheHandler } from "../shims/cache-handler.js";
@@ -71,7 +70,8 @@ async function handleRequest(request, env, platformCtx, dispatchResponseStage, a
 	}
 	const url = new URL(request.url);
 	if (isImageOptimizationPath(url.pathname) && assets && getImageOptimizer()) return handleConfiguredImageOptimization(request, (assetPath) => Promise.resolve(assets.fetch(new Request(new URL(assetPath, request.url)))), __imageAllowedWidths, __imageConfig);
-	if (isOpenRedirectShaped(url.pathname)) return notFoundResponse();
+	const protocolRelativeGuard = guardProtocolRelativeUrl(url.pathname, url.search);
+	if (protocolRelativeGuard) return protocolRelativeGuard;
 	try {
 		decodeURIComponent(url.pathname);
 	} catch {

package/dist/server/app-response-header-provenance.d.ts

@@ -3,6 +3,8 @@
 export declare function markFrameworkLinkHeaders(headers: Headers, linkHeader: string | string[] | null | undefined): void;
 /** Whether the response carries renderer-owned Link values that config may prepend to. */
 export declare function hasFrameworkLinkHeaders(headers: Headers): boolean;
+/** The renderer-owned part of the response's Link header, without middleware's. */
+export declare function getFrameworkLinkHeader(headers: Headers): string | null;
 /** Mark Link values returned by an Edge route handler after config and middleware. */
 export declare function markEdgeRouteHandlerLinkHeaders(headers: Headers, linkHeader: string | null | undefined): void;
 /** Whether config must precede a later framework or Edge-handler Link value. */

package/dist/server/app-response-header-provenance.js

@@ -1,17 +1,22 @@
 import { preserveFullyBufferedBodyMetadata } from "./fully-buffered-response.js";
 import "../shims/unified-request-context.js";
 //#region src/server/app-response-header-provenance.ts
-const frameworkLinkHeaders = /* @__PURE__ */ new WeakSet();
+const frameworkLinkHeaders = /* @__PURE__ */ new WeakMap();
 const edgeRouteHandlerLinkHeaders = /* @__PURE__ */ new WeakSet();
 const APP_RESPONSE_STAGE_LINK_PROVENANCE_HEADER = "x-vinext-app-stage-post-config-link";
 /** Mark response headers whose Link value was emitted by the App page renderer. */
 function markFrameworkLinkHeaders(headers, linkHeader) {
-	if (linkHeader && (typeof linkHeader === "string" || linkHeader.length > 0)) frameworkLinkHeaders.add(headers);
+	const value = Array.isArray(linkHeader) ? linkHeader.join(", ") : linkHeader;
+	if (value) frameworkLinkHeaders.set(headers, value);
 }
 /** Whether the response carries renderer-owned Link values that config may prepend to. */
 function hasFrameworkLinkHeaders(headers) {
 	return frameworkLinkHeaders.has(headers);
 }
+/** The renderer-owned part of the response's Link header, without middleware's. */
+function getFrameworkLinkHeader(headers) {
+	return frameworkLinkHeaders.get(headers) ?? null;
+}
 /** Mark Link values returned by an Edge route handler after config and middleware. */
 function markEdgeRouteHandlerLinkHeaders(headers, linkHeader) {
 	if (linkHeader) edgeRouteHandlerLinkHeaders.add(headers);
@@ -22,7 +27,8 @@ function hasPostConfigLinkHeaders(headers) {
 }
 /** Preserve Link provenance when a response wrapper reconstructs a Response. */
 function copyLinkHeaderProvenance(source, target) {
-	if (frameworkLinkHeaders.has(source)) frameworkLinkHeaders.add(target);
+	const frameworkLink = frameworkLinkHeaders.get(source);
+	if (frameworkLink !== void 0) frameworkLinkHeaders.set(target, frameworkLink);
 	if (edgeRouteHandlerLinkHeaders.has(source)) edgeRouteHandlerLinkHeaders.add(target);
 }
 /** Serialize otherwise process-local Link provenance across a response-stage transport. */
@@ -56,4 +62,4 @@ function consumeResponseStageLinkProvenance(response) {
 	};
 }
 //#endregion
-export { consumeResponseStageLinkProvenance, copyLinkHeaderProvenance, hasFrameworkLinkHeaders, hasPostConfigLinkHeaders, markEdgeRouteHandlerLinkHeaders, markFrameworkLinkHeaders, serializeResponseStageLinkProvenance };
+export { consumeResponseStageLinkProvenance, copyLinkHeaderProvenance, getFrameworkLinkHeader, hasFrameworkLinkHeaders, hasPostConfigLinkHeaders, markEdgeRouteHandlerLinkHeaders, markFrameworkLinkHeaders, serializeResponseStageLinkProvenance };

package/dist/server/app-route-handler-dispatch.js

@@ -9,12 +9,12 @@ import { markDynamicUsage } from "../shims/internal/headers-state.js";
 import { consumeDynamicUsage, getActiveDraftModeState, getAndClearPendingCookies, getDraftModeCookieHeader, isDraftModeRequest, setHeadersAccessPhase } from "../shims/headers.js";
 import { _drainPendingRevalidations } from "../shims/cache-request-state.js";
 import { ensureFetchPatch, getCollectedFetchTags, setCurrentFetchCacheMode, setCurrentFetchRevalidate, setCurrentFetchSoftTags, setCurrentForceDynamicFetchDefault } from "../shims/fetch-cache.js";
+import { resolveAppRouteHandlerFetchCacheMode } from "./app-segment-config.js";
 import { setNavigationContext } from "../shims/navigation-context-state.js";
 import { makeThenableParams } from "../shims/thenable-params.js";
 import { traceResponseStart } from "./response-start-tracing.js";
 import { buildPageCacheTags } from "./implicit-tags.js";
 import { applyRouteHandlerMiddlewareContext, finalizeRouteHandlerResponse } from "./app-route-handler-response.js";
-import { resolveAppRouteHandlerFetchCacheMode } from "./app-segment-config.js";
 import "../shims/navigation.js";
 import { isKnownDynamicAppRoute, isValidHTTPMethod } from "./app-route-handler-runtime.js";
 import { getAppRouteHandlerRevalidateSeconds, hasAppRouteHandlerDefaultExport, hasNonStaticAppRouteHandlerMethods, resolveAppRouteHandlerMethod, shouldReadAppRouteHandlerCache } from "./app-route-handler-policy.js";

package/dist/server/app-router-entry.js

@@ -5,8 +5,7 @@ import "./server-globals.js";
 import "./app-rsc-vary.js";
 import { VINEXT_CACHEABILITY_PROBE_QUERY_PARAM } from "./headers.js";
 import { badRequestResponse, notFoundResponse, notFoundStaticAssetResponse } from "./http-error-responses.js";
-import { isOpenRedirectShaped } from "./open-redirect.js";
-import { cloneRequestWithHeaders, filterInternalHeaders } from "./request-pipeline.js";
+import { cloneRequestWithHeaders, filterInternalHeaders, guardProtocolRelativeUrl } from "./request-pipeline.js";
 import { getCdnCacheAdapter } from "../shims/cdn-cache.js";
 import { applyCdnResponseIdentityHeaders, validateCdnRequest } from "./cache-control.js";
 import { getImageOptimizer, handleConfiguredImageOptimization, isImageOptimizationPath } from "./image-optimization.js";
@@ -83,7 +82,8 @@ async function handleRequest(request, env, platformCtx) {
 	if (cdnValidationResponse) return cdnValidationResponse;
 	const url = new URL(request.url);
 	if (isImageOptimizationPath(url.pathname) && assets && getImageOptimizer()) return handleConfiguredImageOptimization(request, (assetPath) => Promise.resolve(assets.fetch(new Request(new URL(assetPath, request.url)))), __imageAllowedWidths, __imageConfig);
-	if (isOpenRedirectShaped(url.pathname)) return notFoundResponse();
+	const protocolRelativeGuard = guardProtocolRelativeUrl(url.pathname, url.search);
+	if (protocolRelativeGuard) return protocolRelativeGuard;
 	try {
 		decodeURIComponent(url.pathname);
 	} catch {

package/dist/server/app-rsc-handler.d.ts

@@ -85,6 +85,8 @@ type DispatchMatchedPageOptions<TRoute> = {
   scriptNonce?: string;
   searchParams: URLSearchParams;
   renderMode: AppRscRenderMode;
+  /** Render the document whole before its first byte (a regeneration or warm-up). */
+  renderWholeDocument?: boolean;
 };
 type DispatchMatchedRouteHandlerOptions<TRoute> = {
   /**
@@ -235,6 +237,8 @@ export type CreateAppRscHandlerOptions<TRoute extends AppRscHandlerRoute> = {
   matchInterceptRoute?: (pathname: string, sourcePathname: string, interceptionId?: string | null) => AppRscRouteMatch<TRoute> | null;
   matchRoute: (pathname: string) => AppRscRouteMatch<TRoute> | null;
   matchRequestRoute?: (pathname: string) => AppRscRouteMatch<TRoute> | null;
+  /** `matchRequestRoute` without its decoded static page substitution. */
+  matchRawRequestRoute?: (pathname: string) => AppRscRouteMatch<TRoute> | null;
   runMiddleware?: (options: RunAppMiddlewareOptions) => Promise<ApplyAppMiddlewareResult>;
   publicFiles: ReadonlySet<string>;
   prefetchInlining?: PrefetchInliningConfig;