vinext 1.0.0-beta.8 → 1.0.0

package/dist/server/app-page-element-builder.d.ts

@@ -13,13 +13,13 @@ import { AppPageErrorModule, AppPageModule, AppPageRouteWiringRoute } from "./ap
  * the page module reference (used to extract the default export for the page
  * element) and the URL pattern (used as the route path in head resolution).
  */
-type AppPageBuildRoute<TModule extends AppPageModule = AppPageModule, TErrorModule extends AppPageErrorModule = AppPageErrorModule> = AppPageRouteWiringRoute<TModule, TErrorModule> & {
+export type AppPageBuildRoute<TModule extends AppPageModule = AppPageModule, TErrorModule extends AppPageErrorModule = AppPageErrorModule> = AppPageRouteWiringRoute<TModule, TErrorModule> & {
   page?: TModule | null;
   pattern: string;
   /** Param names captured by the route's URL pattern, in order. */
   params?: readonly string[] | null;
 };
-type AppPageInterceptOptions<TModule extends AppPageModule = AppPageModule> = {
+export type AppPageInterceptOptions<TModule extends AppPageModule = AppPageModule> = {
   interceptGraphId?: string | null;
   interceptionId?: string | null;
   interceptionContext?: string | null;
@@ -40,7 +40,7 @@ type AppPageInterceptOptions<TModule extends AppPageModule = AppPageModule> = {
   interceptTargetPatternParts?: readonly string[] | null;
   interceptTargetRouteGraphId?: string | null;
 };
-type AppPagePageRequest<TModule extends AppPageModule = AppPageModule> = {
+export type AppPagePageRequest<TModule extends AppPageModule = AppPageModule> = {
   /** Interception context from current-route navigation (null for direct visits). */
   opts?: AppPageInterceptOptions<TModule> | null;
   /** URL search params from the incoming request (null when unavailable). */
@@ -55,6 +55,8 @@ type AppPagePageRequest<TModule extends AppPageModule = AppPageModule> = {
   renderMode?: AppRscRenderMode;
   /** Observe page `searchParams` access for cache-safety classification. */
   observePageSearchParamsAccess?: boolean;
+  /** The route is `dynamic = "force-static"`, so pages read an empty query. */
+  isForceStatic?: boolean;
   /** Observe page metadata `searchParams` access for cache-safety classification. */
   observeMetadataSearchParamsAccess?: boolean;
   /** Whether generated metadata may stream into the response body. */
@@ -62,7 +64,7 @@ type AppPagePageRequest<TModule extends AppPageModule = AppPageModule> = {
   /** Whether streamed render errors must be sanitized for client transport. */
   isProduction?: boolean;
 };
-type BuildPageElementsOptions<TModule extends AppPageModule = AppPageModule, TErrorModule extends AppPageErrorModule = AppPageErrorModule> = {
+export type BuildPageElementsOptions<TModule extends AppPageModule = AppPageModule, TErrorModule extends AppPageErrorModule = AppPageErrorModule> = {
   applyFileBasedMetadata?: ApplyAppPageFileBasedMetadata;
   route: AppPageBuildRoute<TModule, TErrorModule>;
   params: AppPageParams;
@@ -125,8 +127,8 @@ type AppPageNavigationParamInterceptOptions = {
  * and the page head resolution in
  * {@link https://github.com/vercel/next.js/blob/canary/packages/next/src/server/app-render/create-metadata.tsx|create-metadata.tsx}.
  */
-declare function buildPageElements<TModule extends AppPageModule = AppPageModule, TErrorModule extends AppPageErrorModule = AppPageErrorModule>(options: BuildPageElementsOptions<TModule, TErrorModule>): Promise<AppElements>;
-declare const APP_PAGE_INTERCEPTION_MARKER_TRAVERSALS: readonly [{
+export declare function buildPageElements<TModule extends AppPageModule = AppPageModule, TErrorModule extends AppPageErrorModule = AppPageErrorModule>(options: BuildPageElementsOptions<TModule, TErrorModule>): Promise<AppElements>;
+export declare const APP_PAGE_INTERCEPTION_MARKER_TRAVERSALS: readonly [{
   readonly prefix: "(...)";
   readonly levels: number;
 }, {
@@ -145,9 +147,9 @@ declare const APP_PAGE_INTERCEPTION_MARKER_TRAVERSALS: readonly [{
  * already bound to the param map that owns it (the route's params up to the
  * marker, the slot's params from the marker on).
  */
-declare function resolveInterceptedSlotIdentitySegments(sourcePageSegments: readonly string[] | null | undefined, slotKey: string): readonly AppPageSemanticSegment[] | null;
-declare function resolveInterceptedSlotSegments(sourcePageSegments: readonly string[] | null | undefined, slotKey: string): readonly string[] | null;
-declare function resolveSlotParamOverrides(route: AppPageNavigationParamRoute, routePath: string): Readonly<Record<string, AppPageParams>> | null;
-declare function resolveAppPageNavigationParams(route: AppPageNavigationParamRoute, routeParams: AppPageParams, routePath: string, opts?: AppPageNavigationParamInterceptOptions | null): AppPageParams;
+export declare function resolveInterceptedSlotIdentitySegments(sourcePageSegments: readonly string[] | null | undefined, slotKey: string): readonly AppPageSemanticSegment[] | null;
+export declare function resolveInterceptedSlotSegments(sourcePageSegments: readonly string[] | null | undefined, slotKey: string): readonly string[] | null;
+export declare function resolveSlotParamOverrides(route: AppPageNavigationParamRoute, routePath: string): Readonly<Record<string, AppPageParams>> | null;
+export declare function resolveAppPageNavigationParams(route: AppPageNavigationParamRoute, routeParams: AppPageParams, routePath: string, opts?: AppPageNavigationParamInterceptOptions | null): AppPageParams;
 //#endregion
-export { APP_PAGE_INTERCEPTION_MARKER_TRAVERSALS, AppPageBuildRoute, type AppPageErrorModule, AppPageInterceptOptions, AppPagePageRequest, type AppPageRouteWiringRoute, BuildPageElementsOptions, buildPageElements, resolveAppPageNavigationParams, resolveInterceptedSlotIdentitySegments, resolveInterceptedSlotSegments, resolveSlotParamOverrides };
+export type { AppPageErrorModule, AppPageRouteWiringRoute };

package/dist/server/app-page-element-builder.js

@@ -1,21 +1,24 @@
 import { isPromiseLike } from "../utils/promise.js";
-import { createAppPageRenderDependency, invokeAppComponent, isAppRenderSuspension, isReactOwnedAppComponent, renderAfterAppDependencies } from "./app-render-dependency.js";
-import { AppElementsWire } from "./app-elements-wire.js";
 import { APP_RSC_RENDER_MODE_NAVIGATION } from "./app-rsc-render-mode.js";
+import { createAppPageRenderDependency, invokeAppComponent, isAppClientReference, isAppRenderSuspension, isReactOwnedAppComponent, renderAfterAppDependencies } from "./app-render-dependency.js";
+import { AppElementsWire } from "./app-elements-wire.js";
 import "./app-elements.js";
 import { createAppPageRenderIdentity } from "./app-page-render-identity.js";
 import { matchRoutePattern } from "../routing/route-pattern.js";
 import { makeThenableParams } from "../shims/thenable-params.js";
+import { withUseCachePageMarker } from "../shims/internal/app-page-props-cache-key.js";
 import { resolveAppPageBranchParams, resolveAppPageSegmentParams } from "./app-page-params.js";
 import { resolveAppPageSpecialError } from "./app-page-execution.js";
 import { prepareAppPageHead, resolveActiveParallelRouteHeadInputs } from "./app-page-head.js";
 import { createAppPageSearchParamsObserver, makeObservedAppPageSearchParamsThenable } from "./app-page-search-params-observation.js";
-import { isAppPageRouteGroupSegment, resolveAppPagePatternStateKey, resolveAppPageRouteStateKey } from "./app-page-segment-state.js";
+import { APP_PAGE_SEGMENT_KEY, isAppPageRouteGroupSegment, resolveAppPagePatternStateKey, resolveAppPageRouteStateKey } from "./app-page-segment-state.js";
+import { sanitizeErrorForClient } from "./app-rsc-errors.js";
+import { resolveAppPageModuleTraceSegment, traceCreateComponentTree, traceGetLayoutOrPageModule } from "./app-page-tracing.js";
 import { buildAppPageElements, createAppPageSourcePage, createAppPageTreePath, resolveAppPageLoadingModuleAtOrAbove } from "./app-page-route-wiring.js";
 import { resolveHttpAccessFallbackMetadata, resolveHttpAccessFallbackViewport } from "./app-page-http-access-fallback-metadata.js";
+import { ClientPageRoot } from "../shims/client-page-root.js";
 import "./app-rsc-route-matching.js";
 import { resolveAppPageParentHttpAccessBoundary } from "./app-page-boundary.js";
-import { sanitizeErrorForClient } from "./app-rsc-errors.js";
 import { DEFAULT_GLOBAL_ERROR_MODULE } from "./default-global-error-module.js";
 import { shouldServeStreamingMetadata } from "./streaming-metadata.js";
 import { Suspense, createElement } from "react";
@@ -23,6 +26,21 @@ import { Suspense, createElement } from "react";
 function resolveInterceptLayoutParams(branchSegments, layoutSegments, params) {
 	return resolveAppPageBranchParams(branchSegments, layoutSegments.length, params, layoutSegments);
 }
+function traceAppPageLayoutModules(modules, routeSegments, treePositions) {
+	for (const [index, module] of modules.entries()) {
+		if (!module) continue;
+		traceGetLayoutOrPageModule(resolveAppPageModuleTraceSegment(routeSegments, treePositions?.[index] ?? 0), () => module);
+	}
+}
+function resolveInterceptLayoutTraceSegment(branchSegments, layoutSegments) {
+	return resolveAppPageModuleTraceSegment(branchSegments ?? layoutSegments, layoutSegments.length);
+}
+function traceAppPageInterceptLayoutModules(modules, branchSegments, layoutSegments) {
+	for (const [index, module] of (modules ?? []).entries()) {
+		if (!module) continue;
+		traceGetLayoutOrPageModule(resolveInterceptLayoutTraceSegment(branchSegments, layoutSegments?.[index] ?? []), () => module);
+	}
+}
 /**
 * Build the App Router element tree for a matched route.
 *
@@ -42,7 +60,7 @@ function resolveInterceptLayoutParams(branchSegments, layoutSegments, params) {
 async function buildPageElements(options) {
 	const { route, params, routePath, displayPathname = routePath, pageRequest, globalErrorModule, rootNotFoundModule, rootForbiddenModule, rootUnauthorizedModule, metadataRoutes } = options;
 	const slotParamOverrides = resolveSlotParamOverrides(route, routePath);
-	const { opts, searchParams, isRscRequest, mountedSlotsHeader, renderMode = APP_RSC_RENDER_MODE_NAVIGATION, observeMetadataSearchParamsAccess = false, observePageSearchParamsAccess = false, serveStreamingMetadata, isProduction = process.env.NODE_ENV === "production" } = pageRequest;
+	const { opts, searchParams, isRscRequest, mountedSlotsHeader, renderMode = APP_RSC_RENDER_MODE_NAVIGATION, observeMetadataSearchParamsAccess = false, observePageSearchParamsAccess = false, isForceStatic = false, serveStreamingMetadata, isProduction = process.env.NODE_ENV === "production" } = pageRequest;
 	const pageModule = route.page;
 	const isSiblingIntercept = opts?.interceptSlotKey === "__vinext_page_intercept" && !!opts?.interceptPage;
 	const effectivePageModule = isSiblingIntercept ? opts.interceptPage : pageModule;
@@ -71,17 +89,22 @@ async function buildPageElements(options) {
 			const treePosition = route.layoutTreePositions?.[0] ?? 0;
 			noExportRootLayout = createAppPageTreePath(route.routeSegments, treePosition);
 		}
-		return {
-			...AppElementsWire.createMetadataEntries({
-				interception: renderIdentity.interception,
-				interceptionContext: renderIdentity.interceptionContext,
-				layoutIds: noExportLayoutIds,
-				rootLayoutTreePath: noExportRootLayout,
-				routeId: renderIdentity.routeId,
-				sourcePage: createAppPageSourcePage(sourcePageSegments)
-			}),
-			[renderIdentity.routeId]: createElement("div", null, "Page has no default export")
-		};
+		return traceCreateComponentTree(() => {
+			traceGetLayoutOrPageModule(APP_PAGE_SEGMENT_KEY, () => effectivePageModule);
+			traceAppPageLayoutModules(route.layouts, route.routeSegments ?? [], route.layoutTreePositions);
+			if (isSiblingIntercept) traceAppPageInterceptLayoutModules(opts?.interceptLayouts, opts?.interceptBranchSegments, opts?.interceptLayoutSegments);
+			return {
+				...AppElementsWire.createMetadataEntries({
+					interception: renderIdentity.interception,
+					interceptionContext: renderIdentity.interceptionContext,
+					layoutIds: noExportLayoutIds,
+					rootLayoutTreePath: noExportRootLayout,
+					routeId: renderIdentity.routeId,
+					sourcePage: createAppPageSourcePage(sourcePageSegments)
+				}),
+				[renderIdentity.routeId]: createElement("div", null, "Page has no default export")
+			};
+		});
 	}
 	const activeParallelRouteHeadInputs = resolveActiveParallelRouteHeadInputs({
 		interceptBranchSegments: opts?.interceptBranchSegments ?? null,
@@ -110,6 +133,7 @@ async function buildPageElements(options) {
 		},
 		...opts?.interceptNotFound ? {
 			notFoundModule: opts.interceptNotFound,
+			notFoundModuleRouteSegments: (opts.interceptNotFoundBranchSegments ?? opts.interceptSourcePageSegments ?? route.routeSegments ?? []).slice(0, opts.interceptNotFoundTreePosition ?? 0),
 			notFoundParams: resolveAppPageBranchParams(opts.interceptNotFoundBranchSegments ?? opts.interceptBranchSegments ?? route.routeSegments ?? [], opts.interceptNotFoundTreePosition ?? 0, effectiveParams)
 		} : {},
 		ownerTreePosition: route.routeSegments?.length ?? 0
@@ -155,6 +179,8 @@ async function buildPageElements(options) {
 		return {
 			boundaryModule,
 			boundaryParams: boundaryModule && boundaryTreePosition != null ? resolveAppPageSegmentParams(route.routeSegments ?? [], boundaryTreePosition, effectiveParams) : {},
+			boundaryRouteSegments: (route.routeSegments ?? []).slice(0, boundaryTreePosition ?? 0),
+			errorConvention: "not-found",
 			layoutModules: route.layouts,
 			layoutTreePositions: route.layoutTreePositions,
 			parallelBranches: activeParallelRouteHeadInputs,
@@ -194,25 +220,33 @@ async function buildPageElements(options) {
 	const streamingMetadataOutlet = streamingMetadataOutletInputs.length > 0 ? Promise.all(streamingMetadataOutletInputs).then(() => null) : null;
 	streamingMetadataOutlet?.catch(() => null);
 	const pageProps = { params: makeThenableParams(effectiveParams) };
-	const hasRequestSearchParams = Object.keys(pageSearchParams).length > 0;
 	const pageTreePosition = (sourcePageSegments ?? route.routeSegments ?? []).length;
 	const hasPageLoadingBoundary = resolveAppPageLoadingModuleAtOrAbove(route, pageTreePosition) !== null || isSiblingIntercept && resolveAppPageLoadingModuleAtOrAbove({
 		loading: null,
 		loadings: opts?.interceptLoadings,
 		loadingTreePositions: opts?.interceptLoadingTreePositions
 	}, pageTreePosition) !== null;
+	const hasEmptyClientPageSearchParams = isForceStatic || isProduction && process.env.__NEXT_CONFIG_OUTPUT === "export";
 	const pageRenderDependency = EffectivePageComponent && !isReactOwnedAppComponent(EffectivePageComponent) ? createAppPageRenderDependency() : null;
 	const createPageElement = (PageComponent, props, renderDependency) => {
+		if (searchParams && isAppClientReference(PageComponent)) {
+			const { searchParams: _slotSearchParams, ...pageProps } = props;
+			return createElement(ClientPageRoot, {
+				Component: PageComponent,
+				pageProps,
+				...hasEmptyClientPageSearchParams ? { emptySearchParams: true } : {}
+			});
+		}
 		if (isReactOwnedAppComponent(PageComponent)) {
 			const invocationProps = { ...props };
-			if (searchParams) invocationProps.searchParams = observePageSearchParamsAccess ? makeObservedAppPageSearchParamsThenable(pageSearchParams, { markDynamic: hasRequestSearchParams }) : makeThenableParams(pageSearchParams);
-			return createElement(PageComponent, invocationProps);
+			if (searchParams) invocationProps.searchParams = observePageSearchParamsAccess ? makeObservedAppPageSearchParamsThenable(pageSearchParams) : makeThenableParams(pageSearchParams);
+			return createElement(PageComponent, withUseCachePageMarker(PageComponent, invocationProps));
 		}
 		const PageInvoker = () => {
 			const invocationProps = { ...props };
 			if (searchParams) invocationProps.searchParams = observePageSearchParamsAccess ? makeObservedAppPageSearchParamsThenable(pageSearchParams) : makeThenableParams(pageSearchParams);
 			try {
-				const result = invokeAppComponent(PageComponent, invocationProps);
+				const result = invokeAppComponent(PageComponent, withUseCachePageMarker(PageComponent, invocationProps));
 				if (isPromiseLike(result)) {
 					if (renderDependency) Promise.resolve().then(() => renderDependency.release());
 					return Promise.resolve(result).then((resolvedResult) => renderDependency ? renderAfterAppDependencies(resolvedResult, renderDependency.resultDependencies) : resolvedResult);
@@ -233,11 +267,12 @@ async function buildPageElements(options) {
 	const pageSearchParamsThenable = searchParams ? makeThenableParams(pageSearchParams) : void 0;
 	const mountedSlotIds = mountedSlotsHeader ? new Set(mountedSlotsHeader.split(" ")) : null;
 	const slotOverrides = buildSlotOverrides(route, params, routePath, opts);
-	let siblingInterceptElement = isSiblingIntercept && EffectivePageComponent ? createPageElement(EffectivePageComponent, pageProps, pageRenderDependency) : null;
-	if (isSiblingIntercept && siblingInterceptElement !== null) {
+	const createSiblingInterceptElement = () => {
+		let element = isSiblingIntercept && EffectivePageComponent ? createPageElement(EffectivePageComponent, pageProps, pageRenderDependency) : null;
+		if (!isSiblingIntercept || element === null) return element;
 		const layoutIndexesByTreePosition = /* @__PURE__ */ new Map();
 		for (const [index, layoutModule] of (opts?.interceptLayouts ?? []).entries()) {
-			if (!layoutModule?.default) continue;
+			if (!layoutModule) continue;
 			const treePosition = opts?.interceptLayoutSegments?.[index]?.length ?? 0;
 			const indexes = layoutIndexesByTreePosition.get(treePosition) ?? [];
 			indexes.push(index);
@@ -254,50 +289,58 @@ async function buildPageElements(options) {
 			const treePosition = treePositions[index];
 			const loadingIndex = loadingIndexesByTreePosition.get(treePosition);
 			const LoadingComponent = loadingIndex === void 0 ? null : opts?.interceptLoadings?.[loadingIndex]?.default;
-			if (LoadingComponent) siblingInterceptElement = createElement(Suspense, { fallback: createElement(LoadingComponent) }, siblingInterceptElement);
+			if (LoadingComponent) element = createElement(Suspense, { fallback: createElement(LoadingComponent) }, element);
 			const layoutIndexes = layoutIndexesByTreePosition.get(treePosition) ?? [];
 			for (let layoutOffset = layoutIndexes.length - 1; layoutOffset >= 0; layoutOffset--) {
 				const layoutIndex = layoutIndexes[layoutOffset];
-				const LayoutComponent = opts?.interceptLayouts?.[layoutIndex]?.default;
-				if (!LayoutComponent) continue;
+				const layoutModule = opts?.interceptLayouts?.[layoutIndex];
+				if (!layoutModule) continue;
 				const interceptLayoutSegments = opts?.interceptLayoutSegments?.[layoutIndex] ?? [];
-				siblingInterceptElement = createElement(LayoutComponent, { params: makeThenableParams(resolveInterceptLayoutParams(opts?.interceptBranchSegments ?? interceptLayoutSegments, interceptLayoutSegments, effectiveParams)) }, siblingInterceptElement);
+				const LayoutComponent = traceGetLayoutOrPageModule(resolveInterceptLayoutTraceSegment(opts?.interceptBranchSegments, interceptLayoutSegments), () => layoutModule.default);
+				if (!LayoutComponent) continue;
+				const interceptLayoutParams = resolveInterceptLayoutParams(opts?.interceptBranchSegments ?? interceptLayoutSegments, interceptLayoutSegments, effectiveParams);
+				element = createElement(LayoutComponent, { params: makeThenableParams(interceptLayoutParams) }, element);
 			}
 		}
-	}
-	return buildAppPageElements({
-		element: isSiblingIntercept ? siblingInterceptElement : EffectivePageComponent ? createPageElement(EffectivePageComponent, pageProps, pageRenderDependency) : null,
-		createPageElement,
-		globalErrorModule: globalErrorModule ?? DEFAULT_GLOBAL_ERROR_MODULE,
-		isRscRequest,
-		interceptionId: opts?.interceptionId ?? null,
-		layoutParamAccess: options.layoutParamAccess,
-		mountedSlotIds,
-		makeThenableParams,
-		matchedParams: params,
-		pageRenderDependency,
-		metadataPlacement,
-		resolvedMetadata,
-		resolvedMetadataPathname: routePath,
-		resolvedViewport,
-		scriptNonce: options.scriptNonce,
-		streamingMetadata,
-		streamingMetadataOutlet,
-		streamingMetadataOutletSuspended: streamGeneratedHead,
-		streamingMetadataTags,
-		renderIdentity,
-		routePath,
-		semanticPageIdentity,
-		semanticInterceptionTargetRouteId: opts?.interceptTargetRouteGraphId ?? null,
-		sourcePageSegments,
-		rootNotFoundModule: rootNotFoundModule ?? null,
-		rootForbiddenModule: rootForbiddenModule ?? null,
-		rootUnauthorizedModule: rootUnauthorizedModule ?? null,
-		route,
-		searchParams: pageSearchParamsThenable,
-		slotOverrides,
-		renderMode,
-		trailingSlash: options.trailingSlash
+		return element;
+	};
+	return traceCreateComponentTree(() => {
+		if (effectivePageModule) traceGetLayoutOrPageModule(APP_PAGE_SEGMENT_KEY, () => effectivePageModule);
+		const siblingInterceptElement = createSiblingInterceptElement();
+		return buildAppPageElements({
+			element: isSiblingIntercept ? siblingInterceptElement : EffectivePageComponent ? createPageElement(EffectivePageComponent, pageProps, pageRenderDependency) : null,
+			createPageElement,
+			globalErrorModule: globalErrorModule ?? DEFAULT_GLOBAL_ERROR_MODULE,
+			isRscRequest,
+			interceptionId: opts?.interceptionId ?? null,
+			layoutParamAccess: options.layoutParamAccess,
+			mountedSlotIds,
+			makeThenableParams,
+			matchedParams: params,
+			pageRenderDependency,
+			metadataPlacement,
+			resolvedMetadata,
+			resolvedMetadataPathname: routePath,
+			resolvedViewport,
+			scriptNonce: options.scriptNonce,
+			streamingMetadata,
+			streamingMetadataOutlet,
+			streamingMetadataOutletSuspended: streamGeneratedHead,
+			streamingMetadataTags,
+			renderIdentity,
+			routePath,
+			semanticPageIdentity,
+			semanticInterceptionTargetRouteId: opts?.interceptTargetRouteGraphId ?? null,
+			sourcePageSegments,
+			rootNotFoundModule: rootNotFoundModule ?? null,
+			rootForbiddenModule: rootForbiddenModule ?? null,
+			rootUnauthorizedModule: rootUnauthorizedModule ?? null,
+			route,
+			searchParams: pageSearchParamsThenable,
+			slotOverrides,
+			renderMode,
+			trailingSlash: options.trailingSlash
+		});
 	});
 }
 /**

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

@@ -2,8 +2,8 @@ import { ClassificationReason } from "../build/layout-classification-types.js";
 import { LayoutFlags } from "./app-elements-wire.js";
 import "./app-elements.js";
 //#region src/server/app-page-execution.d.ts
-declare function tagAppPageMetadataError<T>(error: T): T;
-type AppPageSpecialError = {
+export declare function tagAppPageMetadataError<T>(error: T): T;
+export type AppPageSpecialError = {
   kind: "redirect";
   location: string;
   statusCode: number;
@@ -14,7 +14,7 @@ type AppPageSpecialError = {
   statusCode: number;
   fromMetadata?: boolean;
 };
-type AppPageFontPreload = {
+export type AppPageFontPreload = {
   href: string;
   type: string;
 };
@@ -83,7 +83,7 @@ type ProbeAppPageLayoutsResult = {
   response: Response | null;
   layoutFlags: LayoutFlags;
 };
-type LayoutClassificationOptions = {
+export type LayoutClassificationOptions = {
   /** Build-time classifications from segment config or module graph, keyed by layout index. */
   buildTimeClassifications?: ReadonlyMap<number, "static" | "dynamic"> | null;
   /**
@@ -133,15 +133,15 @@ type ProbeAppPageThrownErrorOptions = {
   probePage: () => unknown;
   runWithSuppressedHookWarning<T>(probe: () => Promise<T>): Promise<T>;
 };
-declare function resolveAppPageSpecialError(error: unknown): AppPageSpecialError | null;
-declare function buildAppPageSpecialErrorResponse(options: BuildAppPageSpecialErrorResponseOptions): Promise<Response>;
+export declare function resolveAppPageSpecialError(error: unknown): AppPageSpecialError | null;
+export declare function buildAppPageSpecialErrorResponse(options: BuildAppPageSpecialErrorResponseOptions): Promise<Response>;
 /** See `LayoutFlags` type docblock in app-elements.ts for lifecycle. */
-declare function probeAppPageLayouts(options: ProbeAppPageLayoutsOptions): Promise<ProbeAppPageLayoutsResult>;
-declare function probeAppPageComponent(options: ProbeAppPageComponentOptions): Promise<Response | null>;
-declare function probeAppPageThrownError(options: ProbeAppPageThrownErrorOptions): Promise<unknown>;
-declare function readAppPageBinaryStream(stream: ReadableStream<Uint8Array>): Promise<ArrayBuffer>;
-declare function bufferAppPageBinaryStream(stream: ReadableStream<Uint8Array>): Promise<ReadableStream<Uint8Array>>;
-declare function teeAppPageRscStreamForCapture(stream: ReadableStream<Uint8Array>, shouldCapture: boolean): AppPageRscStreamCapture;
-declare function buildAppPageFontLinkHeader(preloads: readonly AppPageFontPreload[] | null | undefined): string;
+export declare function probeAppPageLayouts(options: ProbeAppPageLayoutsOptions): Promise<ProbeAppPageLayoutsResult>;
+export declare function probeAppPageComponent(options: ProbeAppPageComponentOptions): Promise<Response | null>;
+export declare function probeAppPageThrownError(options: ProbeAppPageThrownErrorOptions): Promise<unknown>;
+export declare function readAppPageBinaryStream(stream: ReadableStream<Uint8Array>): Promise<ArrayBuffer>;
+export declare function bufferAppPageBinaryStream(stream: ReadableStream<Uint8Array>): Promise<ReadableStream<Uint8Array>>;
+export declare function teeAppPageRscStreamForCapture(stream: ReadableStream<Uint8Array>, shouldCapture: boolean): AppPageRscStreamCapture;
+export declare function buildAppPageFontLinkHeader(preloads: readonly AppPageFontPreload[] | null | undefined): string;
 //#endregion
-export { AppPageFontPreload, AppPageSpecialError, LayoutClassificationOptions, type LayoutFlags, bufferAppPageBinaryStream, buildAppPageFontLinkHeader, buildAppPageSpecialErrorResponse, probeAppPageComponent, probeAppPageLayouts, probeAppPageThrownError, readAppPageBinaryStream, resolveAppPageSpecialError, tagAppPageMetadataError, teeAppPageRscStreamForCapture };
+export type { LayoutFlags };

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

@@ -143,9 +143,9 @@ async function buildAppPageSpecialErrorResponse(options) {
 			const stream = options.buildRscRedirectFlightStream({ digest });
 			const headers = new Headers({ "Content-Type": VINEXT_RSC_CONTENT_TYPE });
 			applyEdgeRuntimeHeader(headers, options.isEdgeRuntime);
+			mergeMiddlewareResponseHeaders(headers, options.middlewareContext?.headers ?? null);
 			applyRscCompatibilityIdHeader(headers);
 			applyRscDeploymentIdHeader(headers);
-			mergeMiddlewareResponseHeaders(headers, options.middlewareContext?.headers ?? null);
 			headers.set(VINEXT_RSC_REDIRECT_HEADER, digestUrl);
 			headers.set(VINEXT_RSC_REDIRECT_TYPE_HEADER, options.specialError.type ?? "replace");
 			const pendingCookies = options.getAndClearPendingCookies?.() ?? [];
@@ -199,11 +199,13 @@ async function probeAppPageLayouts(options) {
 					if (errorResponse) return errorResponse;
 					const observationDynamic = cls.isLayoutObservationDynamic?.(layoutId) === true;
 					layoutFlags[layoutId] = buildTimeResult === "dynamic" || observationDynamic ? "d" : "s";
-					if (cls.debugClassification) if (observationDynamic && buildTimeResult === "static") cls.debugClassification(layoutId, {
-						layer: "runtime-probe",
-						outcome: "dynamic"
-					});
-					else cls.debugClassification(layoutId, cls.buildTimeReasons?.get(layoutIndex) ?? { layer: "no-classifier" });
+					if (cls.debugClassification) {
+						if (observationDynamic && buildTimeResult === "static") cls.debugClassification(layoutId, {
+							layer: "runtime-probe",
+							outcome: "dynamic"
+						});
+						else cls.debugClassification(layoutId, cls.buildTimeReasons?.get(layoutIndex) ?? { layer: "no-classifier" });
+					}
 					continue;
 				}
 				if (cls) {
@@ -257,8 +259,10 @@ async function probeAppPageComponent(options) {
 		const outcome = await runWithConnectionProbe(async () => {
 			try {
 				const pageResult = options.probePage();
-				if (isPromiseLike(pageResult)) if (options.awaitAsyncResult) await pageResult;
-				else Promise.resolve(pageResult).catch(() => {});
+				if (isPromiseLike(pageResult)) {
+					if (options.awaitAsyncResult) await pageResult;
+					else Promise.resolve(pageResult).catch(() => {});
+				}
 			} catch (error) {
 				return options.onError(error);
 			}

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

@@ -4,30 +4,34 @@ import { ThenableParamsObserver } from "../shims/thenable-params.js";
 import { Metadata, ResolvedViewport } from "../shims/metadata.js";
 import { applyFileBasedMetadata } from "./file-based-metadata.js";
 //#region src/server/app-page-head.d.ts
-type AppPageSearchParams = Record<string, string | string[]>;
-type AppPageHeadModule = Record<string, unknown>;
-type ApplyAppPageFileBasedMetadata = typeof applyFileBasedMetadata;
-type OrderedAppPageMetadataSource<TModule extends AppPageHeadModule = AppPageHeadModule> = {
+export type AppPageSearchParams = Record<string, string | string[]>;
+export type AppPageHeadModule = Record<string, unknown>;
+export type ApplyAppPageFileBasedMetadata = typeof applyFileBasedMetadata;
+export type OrderedAppPageMetadataSource<TModule extends AppPageHeadModule = AppPageHeadModule> = {
   /** Preserve an empty result as the most specific file-metadata source. */
   includeWhenEmpty?: boolean;
   module: TModule;
+  moduleRoute: string;
   params: AppPageParams;
   routeSegments: readonly string[];
   searchParams?: AppPageSearchParams;
   searchParamsObserver?: ThenableParamsObserver;
 };
-type AppPageHeadParallelRoute<TModule extends AppPageHeadModule = AppPageHeadModule> = {
+export type AppPageHeadParallelRoute<TModule extends AppPageHeadModule = AppPageHeadModule> = {
   layoutParams?: readonly AppPageParams[] | null;
   layoutModule?: TModule | null;
   layoutModules?: readonly (TModule | null | undefined)[] | null;
   layoutTreePositions?: readonly number[] | null;
+  moduleRoutePrefixSegments?: readonly string[] | null;
+  moduleRouteSegments?: readonly string[] | null;
   pageModule?: TModule | null;
   params?: AppPageParams | null;
   routeSegments?: readonly string[] | null;
 };
-type ActiveParallelRouteHeadInput<TModule extends AppPageHeadModule = AppPageHeadModule> = {
+export type ActiveParallelRouteHeadInput<TModule extends AppPageHeadModule = AppPageHeadModule> = {
   head: AppPageHeadParallelRoute<TModule>;
   notFoundModule?: TModule | null;
+  notFoundModuleRouteSegments?: readonly string[] | null;
   notFoundParams?: AppPageParams | null;
   ownerTreePosition: number;
 };
@@ -88,17 +92,17 @@ type AppPageMetadataOutputOptions = {
   routePath: string;
   routeSegments?: readonly string[] | null;
 };
-type ResolveOrderedAppPageMetadataOptions<TModule extends AppPageHeadModule = AppPageHeadModule> = AppPageMetadataOutputOptions & {
+export type ResolveOrderedAppPageMetadataOptions<TModule extends AppPageHeadModule = AppPageHeadModule> = AppPageMetadataOutputOptions & {
   sources: readonly OrderedAppPageMetadataSource<TModule>[];
 };
-type ResolveAppPageHeadResult = {
+export type ResolveAppPageHeadResult = {
   hasDynamicMetadata: boolean;
   hasSearchParams: boolean;
   metadata: Metadata | null;
   pageSearchParams: AppPageSearchParams;
   viewport: ResolvedViewport;
 };
-type PreparedAppPageHead = Omit<ResolveAppPageHeadResult, "metadata" | "viewport"> & {
+export type PreparedAppPageHead = Omit<ResolveAppPageHeadResult, "metadata" | "viewport"> & {
   metadata: Promise<Metadata | null>;
   viewport: Promise<ResolvedViewport>;
 };
@@ -106,8 +110,8 @@ type AppPageSearchParamsCollection = {
   hasSearchParams: boolean;
   pageSearchParams: AppPageSearchParams;
 };
-declare function resolveActiveParallelRouteHeadInputs<TModule extends AppPageHeadModule>(options: ResolveActiveParallelRouteHeadInputsOptions<TModule>): ActiveParallelRouteHeadInput<TModule>[];
-declare function collectAppPageSearchParams(searchParams: URLSearchParams | null | undefined): AppPageSearchParamsCollection;
+export declare function resolveActiveParallelRouteHeadInputs<TModule extends AppPageHeadModule>(options: ResolveActiveParallelRouteHeadInputsOptions<TModule>): ActiveParallelRouteHeadInput<TModule>[];
+export declare function collectAppPageSearchParams(searchParams: URLSearchParams | null | undefined): AppPageSearchParamsCollection;
 /**
  * Resolve an explicit metadata-source sequence.
  *
@@ -115,8 +119,8 @@ declare function collectAppPageSearchParams(searchParams: URLSearchParams | null
  * only supplies each source with its accumulated parent, merges the results,
  * and applies file-based metadata at the end.
  */
-declare function resolveOrderedAppPageMetadata<TModule extends AppPageHeadModule>(options: ResolveOrderedAppPageMetadataOptions<TModule>): Promise<Metadata | null>;
-declare function resolveAppPageHead<TModule extends AppPageHeadModule>(options: ResolveAppPageHeadOptions<TModule>): Promise<ResolveAppPageHeadResult>;
+export declare function resolveOrderedAppPageMetadata<TModule extends AppPageHeadModule>(options: ResolveOrderedAppPageMetadataOptions<TModule>): Promise<Metadata | null>;
+export declare function resolveAppPageHead<TModule extends AppPageHeadModule>(options: ResolveAppPageHeadOptions<TModule>): Promise<ResolveAppPageHeadResult>;
 /**
  * Start metadata and viewport resolution without coupling their completion.
  *
@@ -124,6 +128,5 @@ declare function resolveAppPageHead<TModule extends AppPageHeadModule>(options:
  * still waiting for viewport tags before the shell is emitted. Blocking
  * callers use {@link resolveAppPageHead} and observe the same result as before.
  */
-declare function prepareAppPageHead<TModule extends AppPageHeadModule>(options: ResolveAppPageHeadOptions<TModule>): PreparedAppPageHead;
-//#endregion
-export { ActiveParallelRouteHeadInput, AppPageHeadModule, AppPageHeadParallelRoute, AppPageSearchParams, ApplyAppPageFileBasedMetadata, OrderedAppPageMetadataSource, PreparedAppPageHead, ResolveAppPageHeadResult, ResolveOrderedAppPageMetadataOptions, collectAppPageSearchParams, prepareAppPageHead, resolveActiveParallelRouteHeadInputs, resolveAppPageHead, resolveOrderedAppPageMetadata };
+export declare function prepareAppPageHead<TModule extends AppPageHeadModule>(options: ResolveAppPageHeadOptions<TModule>): PreparedAppPageHead;
+//#endregion