vinext 1.2.1 → 1.3.1

package/dist/shims/metadata.js

@@ -23,12 +23,23 @@ async function resolveModuleViewport(mod, params = {}, searchParams, parent = Pr
 			params: asyncParams,
 			searchParams: makeThenableParams(searchParams, searchParamsObserver)
 		});
-		return await mod.generateViewport(props, parent);
+		return await callSegmentResolver(mod.generateViewport, props, parent);
 	}
 	if (mod.viewport && typeof mod.viewport === "object") return mod.viewport;
 	return null;
 }
 /**
+* Call a segment's generateMetadata() or generateViewport() with `parent`, as
+* Next.js's getResult does for both.
+* https://github.com/vercel/next.js/blob/canary/packages/next/src/lib/metadata/resolve-metadata.ts (getResult)
+*/
+function callSegmentResolver(resolver, props, parent) {
+	if (!(Reflect.get(resolver, USE_CACHE_FUNCTION_SYMBOL) === true)) return resolver(props, parent);
+	const acceptsSecondArgument = Reflect.get(resolver, USE_CACHE_ACCEPTS_SECOND_ARGUMENT_SYMBOL);
+	if (!(typeof acceptsSecondArgument === "boolean" ? acceptsSecondArgument : resolver.length >= 2)) return resolver(props);
+	return parent.then(() => resolver(props, parent));
+}
+/**
 * Merge viewport configs from multiple sources (layouts + page).
 * Later entries override earlier ones.
 */
@@ -232,13 +243,26 @@ function postProcessMetadata(merged) {
 * tags are the exception: Next.js merges those across segments.
 */
 function mergeMetadataEntries(entries) {
+	return mergeEntries(entries, false);
+}
+/**
+* Merge metadata into the `parent` a later segment's resolver receives. Like
+* {@link mergeMetadataEntries}, except the title stays resolved as Next.js's
+* `{ absolute, template }`, so `(await parent).title?.absolute` reads the
+* title so far. `template` is the one the next title gets, so merging this
+* parent with later entries resolves their titles as the full merge does.
+* https://github.com/vercel/next.js/blob/canary/packages/next/src/lib/metadata/resolvers/resolve-title.ts
+*/
+function mergeParentMetadataEntries(entries) {
+	return mergeEntries(entries, true);
+}
+function mergeEntries(entries, resolvedTitle) {
 	if (entries.length === 0) return {};
 	const merged = {};
 	let parentTemplate;
 	for (const entry of entries) {
 		const meta = entry.metadata;
 		const isPage = Boolean(entry.isPage);
-		const contributesTitle = entry.contributesTitle !== false;
 		for (const key of Object.keys(meta)) {
 			if (key === "title") continue;
 			const incoming = meta[key];
@@ -249,9 +273,13 @@ function mergeMetadataEntries(entries) {
 			};
 			else merged[key] = incoming;
 		}
-		if (contributesTitle && meta.title !== void 0) merged.title = resolveTitle(meta.title, parentTemplate);
-		if (contributesTitle && !isPage && meta.title && typeof meta.title === "object" && meta.title.template) parentTemplate = meta.title.template;
+		if (meta.title !== void 0) merged.title = resolveTitle(meta.title, parentTemplate);
+		if (!isPage && meta.title && typeof meta.title === "object" && meta.title.template) parentTemplate = meta.title.template;
 	}
+	if (resolvedTitle && Object.hasOwn(merged, "title")) merged.title = {
+		absolute: resolveStringTitle(merged.title) ?? "",
+		template: parentTemplate ?? null
+	};
 	return merged;
 }
 /**
@@ -268,13 +296,10 @@ async function resolveModuleMetadata(mod, params = {}, searchParams, parent = Pr
 	if (typeof mod.generateMetadata === "function") {
 		const generateMetadata = mod.generateMetadata;
 		const asyncParams = makeThenableParams(params);
-		const props = searchParams === void 0 ? withUseCacheLayoutMarker(generateMetadata, { params: asyncParams }) : withUseCachePageMarker(generateMetadata, {
+		return await callSegmentResolver(generateMetadata, searchParams === void 0 ? withUseCacheLayoutMarker(generateMetadata, { params: asyncParams }) : withUseCachePageMarker(generateMetadata, {
 			params: asyncParams,
 			searchParams: makeThenableParams(searchParams, searchParamsObserver)
-		});
-		const isUseCacheFunction = Reflect.get(generateMetadata, USE_CACHE_FUNCTION_SYMBOL) === true;
-		const acceptsSecondArgument = Reflect.get(generateMetadata, USE_CACHE_ACCEPTS_SECOND_ARGUMENT_SYMBOL);
-		return await (!isUseCacheFunction || (typeof acceptsSecondArgument === "boolean" ? acceptsSecondArgument : generateMetadata.length >= 2) ? generateMetadata(props, parent) : generateMetadata(props));
+		}), parent);
 	}
 	if (mod.metadata && typeof mod.metadata === "object") return mod.metadata;
 	return null;
@@ -607,24 +632,61 @@ function MetadataHead({ metadata, pathname = "/", trailingSlash, streamedIconKey
 				}
 			}
 		}
-		if (og.videos) for (const video of og.videos) {
-			elements.push(/* @__PURE__ */ jsx("meta", {
-				property: "og:video",
-				content: resolveUrl(video.url)
-			}, key++));
-			if (video.width) elements.push(/* @__PURE__ */ jsx("meta", {
-				property: "og:video:width",
-				content: String(video.width)
-			}, key++));
-			if (video.height) elements.push(/* @__PURE__ */ jsx("meta", {
-				property: "og:video:height",
-				content: String(video.height)
+		if (og.videos) {
+			const videos = normalizeUrlDescriptorEntries(og.videos, (url) => ({ url }));
+			for (const video of videos) {
+				if (video.url) elements.push(/* @__PURE__ */ jsx("meta", {
+					property: "og:video",
+					content: stringifyUrl(video.url)
+				}, key++));
+				if (video.secureUrl) elements.push(/* @__PURE__ */ jsx("meta", {
+					property: "og:video:secure_url",
+					content: stringifyUrl(video.secureUrl)
+				}, key++));
+				if (video.type) elements.push(/* @__PURE__ */ jsx("meta", {
+					property: "og:video:type",
+					content: video.type
+				}, key++));
+				if (video.width) elements.push(/* @__PURE__ */ jsx("meta", {
+					property: "og:video:width",
+					content: String(video.width)
+				}, key++));
+				if (video.height) elements.push(/* @__PURE__ */ jsx("meta", {
+					property: "og:video:height",
+					content: String(video.height)
+				}, key++));
+			}
+		}
+		if (og.audio) {
+			const audios = normalizeUrlDescriptorEntries(og.audio, (url) => ({ url }));
+			for (const audio of audios) {
+				if (audio.url) elements.push(/* @__PURE__ */ jsx("meta", {
+					property: "og:audio",
+					content: stringifyUrl(audio.url)
+				}, key++));
+				if (audio.secureUrl) elements.push(/* @__PURE__ */ jsx("meta", {
+					property: "og:audio:secure_url",
+					content: stringifyUrl(audio.secureUrl)
+				}, key++));
+				if (audio.type) elements.push(/* @__PURE__ */ jsx("meta", {
+					property: "og:audio:type",
+					content: audio.type
+				}, key++));
+			}
+		}
+		const ogListTags = [
+			["og:email", og.emails],
+			["og:phone_number", og.phoneNumbers],
+			["og:fax_number", og.faxNumbers],
+			["og:locale:alternate", og.alternateLocale]
+		];
+		for (const [property, value] of ogListTags) {
+			if (!value) continue;
+			for (const content of Array.isArray(value) ? value : [value]) elements.push(/* @__PURE__ */ jsx("meta", {
+				property,
+				content
 			}, key++));
 		}
-		if (og.audio) for (const audio of og.audio) elements.push(/* @__PURE__ */ jsx("meta", {
-			property: "og:audio",
-			content: resolveUrl(audio.url)
-		}, key++));
 	}
 	if (metadata.twitter) {
 		const tw = metadata.twitter;
@@ -867,4 +929,4 @@ function MetadataHead({ metadata, pathname = "/", trailingSlash, streamedIconKey
 	return /* @__PURE__ */ jsx(Fragment$1, { children: elements });
 }
 //#endregion
-export { DEFAULT_VIEWPORT, MetadataHead, ViewportHead, mergeMetadata, mergeMetadataEntries, mergeViewport, postProcessMetadata, renderMetadataToHtml, resolveModuleMetadata, resolveModuleViewport };
+export { DEFAULT_VIEWPORT, MetadataHead, ViewportHead, mergeMetadata, mergeMetadataEntries, mergeParentMetadataEntries, mergeViewport, postProcessMetadata, renderMetadataToHtml, resolveModuleMetadata, resolveModuleViewport };

package/dist/shims/navigation-errors.d.ts

@@ -58,4 +58,5 @@ export declare function isDynamicServerError(error: unknown): error is DynamicSe
  * them. This covers the categories vinext can currently produce.
  */
 export declare function unstable_rethrow(error: unknown): void;
-//#endregion
+//#endregion
+export {};

package/dist/shims/navigation.d.ts

@@ -3,6 +3,7 @@ import { NavigationRuntimeVisibleCommitMode } from "../client/navigation-runtime
 import { AppElements } from "../server/app-elements-wire.js";
 import "../server/app-elements.js";
 import { AppRouterInstance, NavigateOptions, PrefetchOptions as PrefetchOptions$1 } from "./internal/app-router-context.js";
+import { AppRoutePrefetchPolicy } from "./internal/app-route-prefetch-policy.js";
 import { ReadonlyURLSearchParams } from "./readonly-url-search-params.js";
 import { AppRscRenderMode } from "../server/app-rsc-render-mode.js";
 import { GLOBAL_ACCESSORS_KEY, NavigationContext, NavigationStateAccessors, SegmentMap, ServerInsertedHTMLContext, _registerStateAccessors, clearServerInsertedHTML, flushServerInsertedHTML, getBfcacheIdMapContext, getBfcacheSegmentIdContext, getLayoutSegmentContext, getNavigationContext, renderServerInsertedHTML, setNavigationContext } from "./navigation-context-state.js";
@@ -67,7 +68,13 @@ export type PrefetchOptions = {
 export type PrefetchCacheKind = "loading-shell" | "navigation" | "route-tree";
 export type PrefetchCacheEntry = {
   cacheForNavigation?: boolean;
+  /**
+   * Set while a full prefetch would be kept as learning-only if its page
+   * renders dynamically. A hover upgrade turns it into a full prefetch.
+   */
+  dynamicStaleTime?: "learning-only" | "full-prefetch";
   expiresAt?: number;
+  fallbackTtlMs?: number;
   invalidationTimer?: ReturnType<typeof setTimeout>;
   mountedSlotsHeader?: string | null;
   onInvalidateCallbacks?: Set<() => void>;
@@ -86,7 +93,7 @@ export type PrefetchCacheEntry = {
   timestamp: number;
 };
 export declare function getCurrentInterceptionContext(): string | null;
-export declare function getPrefetchInterceptionContext(targetHref: string): string | null;
+export declare function getPrefetchInterceptionContext(targetHref: string, currentPathname?: string): string | null;
 export declare function getCurrentNextUrl(): string;
 export declare function createAppPrefetchRequestHeaders(options: {
   fetchPriority: "auto" | "high" | "low";
@@ -116,6 +123,10 @@ export declare function hasPrefetchCacheEntryForNavigation(rscUrl: string, inter
   additionalRscUrls?: readonly string[];
   notifyInvalidation?: boolean;
   onInvalidate?: () => void;
+  /** Called with the matched entry, and the key it was found under, when it is reused. */
+  onReuse?: (entry: PrefetchCacheEntry, cacheKey: string) => void;
+  /** Whether an in-flight entry counts as reusable. Defaults to true. */
+  reusePending?: boolean;
 }): boolean;
 /**
  * Return whether the exact learning-only Link prefetch is still usable.
@@ -124,7 +135,16 @@ export declare function hasPrefetchCacheEntryForNavigation(rscUrl: string, inter
  */
 export declare function hasFreshLearningOnlyPrefetchCacheEntry(rscUrl: string, interceptionContext?: string | null): boolean;
 export declare function hasSearchAgnosticPrefetchShellForRoute(rscUrl: string, interceptionContext?: string | null, mountedSlotsHeader?: string | null): boolean;
-export declare function discardLearningOnlyPrefetchCacheEntry(rscUrl: string, interceptionContext?: string | null): boolean;
+export declare function discardLearningOnlyPrefetchCacheEntry(rscUrl: string, interceptionContext?: string | null, mountedSlotsHeader?: string | null): boolean;
+/**
+ * Make a prefetch reusable by a navigation, as an `unstable_dynamicOnHover`
+ * hover does. A pending one that would be kept as learning-only becomes a full
+ * prefetch and takes the full-prefetch lifetime. One already kept as
+ * learning-only because its page rendered dynamically is left for the full
+ * prefetch to replace: Next.js refetches it with `FetchStrategy.Full`, so the
+ * page reflects the cookies and headers at hover time.
+ */
+export declare function promotePrefetchCacheEntryForNavigation(cacheKey: string, entry: PrefetchCacheEntry): void;
 export declare function invalidatePrefetchCache(): void;
 /**
  * Prevent completed navigation responses from becoming authoritative again
@@ -206,7 +226,7 @@ export declare function fetchRouteTreeGatedPrefetch(options: {
  */
 export declare function prefetchRscResponse(rscUrl: string, fetchPromise: Promise<Response>, interceptionContext?: string | null, mountedSlotsHeader?: string | null, options?: PrefetchOptions, behavior?: {
   cacheForNavigation?: boolean;
-  dynamicStaleTime?: "verbatim" | "full-prefetch" | "ignore";
+  dynamicStaleTime?: AppRoutePrefetchPolicy["dynamicStaleTime"];
   fallbackTtlMs?: number;
   optimisticRouteShell?: boolean;
   prefetchKind?: PrefetchCacheKind;

package/dist/shims/navigation.js

@@ -1,7 +1,7 @@
 import { isBotUserAgent } from "../utils/html-limited-bots.js";
 import { isExternalUrl } from "../utils/external-url.js";
 import { stripBasePath } from "../utils/base-path.js";
-import { NEXT_ROUTER_PREFETCH_HEADER, NEXT_ROUTER_SEGMENT_PREFETCH_HEADER, VINEXT_MOUNTED_SLOTS_HEADER, VINEXT_RSC_RENDER_MODE_HEADER } from "../server/app-rsc-vary.js";
+import { NEXT_ROUTER_PREFETCH_HEADER, NEXT_ROUTER_SEGMENT_PREFETCH_HEADER, VINEXT_INTERCEPTION_CONTEXT_HEADER, VINEXT_MOUNTED_SLOTS_HEADER, VINEXT_RSC_RENDER_MODE_HEADER } from "../server/app-rsc-vary.js";
 import { NEXT_ROUTER_STALE_TIME_HEADER, VINEXT_DYNAMIC_STALE_TIME_HEADER, VINEXT_PARAMS_HEADER, VINEXT_RENDERED_PATH_AND_SEARCH_HEADER, VINEXT_RSC_COMPLETION_METADATA_HEADER, VINEXT_RSC_REDIRECT_HEADER, VINEXT_RSC_REDIRECT_TYPE_HEADER, VINEXT_STALE_TIME_PENDING_HEADER } from "../server/headers.js";
 import { assertSafeNavigationUrl } from "./url-safety.js";
 import { APP_RSC_RENDER_MODE_PREFETCH_DYNAMIC_SHELL, APP_RSC_RENDER_MODE_PREFETCH_LOADING_SHELL } from "../server/app-rsc-render-mode.js";
@@ -19,7 +19,7 @@ import { clearAppNavigationFailureTarget, stageAppNavigationFailureTarget } from
 import { beginAppRouterScrollIntent, clearAppRouterScrollIntent, consumeAppRouterScrollIntent, getPendingAppRouterScrollIntent, isLatestAppRouterScrollIntent } from "./app-router-scroll-state.js";
 import { VINEXT_RSC_COMPATIBILITY_ID_HEADER, VINEXT_RSC_CONTENT_TYPE, createRscRequestHeaders, createRscRequestUrl, formatRscRequestPath, parseRscRequestPath, stripRscCacheBustingSearchParam, stripRscSuffix } from "../server/app-rsc-cache-busting.js";
 import { notifyAppRouterTransitionStart } from "../client/instrumentation-client-state.js";
-import { getNavigationRuntime, hasAppNavigationRuntime } from "../client/navigation-runtime.js";
+import { getNavigationRuntime, hasAppNavigationRuntime, loadNavigationRuntimeRouteManifest } from "../client/navigation-runtime.js";
 import { UnrecognizedActionError, unstable_isUnrecognizedActionError } from "./unrecognized-action-error.js";
 import { PUBLIC_INITIAL_BFCACHE_ID } from "../server/app-bfcache-id.js";
 import { resolveManifestNavigationInterceptionContext } from "../server/app-browser-interception-context.js";
@@ -70,9 +70,9 @@ function useChildSegments(parallelRoutesKey = "children") {
 		return [];
 	}
 }
-const _READONLY_SEARCH_PARAMS = Symbol("vinext.navigation.readonlySearchParams");
-const _READONLY_SEARCH_PARAMS_SOURCE = Symbol("vinext.navigation.readonlySearchParamsSource");
-const _READONLY_SEARCH_PARAMS_SOURCE_KEY = Symbol("vinext.navigation.readonlySearchParamsSourceKey");
+const _READONLY_SEARCH_PARAMS = Symbol.for("vinext.navigation.readonlySearchParams");
+const _READONLY_SEARCH_PARAMS_SOURCE = Symbol.for("vinext.navigation.readonlySearchParamsSource");
+const _READONLY_SEARCH_PARAMS_SOURCE_KEY = Symbol.for("vinext.navigation.readonlySearchParamsSourceKey");
 const PAGES_NAVIGATION_NOTIFY_KEY = Symbol.for("vinext.navigation.pagesNavigationNotify");
 const isServer = typeof window === "undefined";
 /** basePath from next.config.js, injected by the plugin at build time */
@@ -117,7 +117,7 @@ function getCurrentInterceptionContext() {
 	if (isServer) return null;
 	return stripBasePath(window.location.pathname, __basePath);
 }
-function getPrefetchInterceptionContext(targetHref) {
+function getPrefetchInterceptionContext(targetHref, currentPathname) {
 	if (isServer) return null;
 	let targetUrl;
 	try {
@@ -127,7 +127,7 @@ function getPrefetchInterceptionContext(targetHref) {
 	}
 	return resolveManifestNavigationInterceptionContext({
 		basePath: __basePath,
-		currentPathname: window.location.pathname,
+		currentPathname: currentPathname ?? window.location.pathname,
 		routeManifest: getNavigationRuntime()?.bootstrap.routeManifest ?? null,
 		targetPathname: targetUrl.pathname
 	});
@@ -296,9 +296,11 @@ function findPrefetchCacheEntryForNavigation(rscUrl, interceptionContext, mounte
 function hasPrefetchCacheEntryForNavigation(rscUrl, interceptionContext = null, mountedSlotsHeader = null, options = {}) {
 	const match = findPrefetchCacheEntryForNavigation(rscUrl, interceptionContext, mountedSlotsHeader, options.additionalRscUrls);
 	if (match === null) return false;
+	if (match.entry.pending !== void 0 && options.reusePending === false) return false;
 	if (match.entry.pending !== void 0 || resolvePrefetchCacheEntryExpiresAt(match.entry) > Date.now()) {
 		touchPrefetchCacheEntry(getPrefetchCache(), match.cacheKey, match.entry);
 		attachPrefetchInvalidationToEntry(match.cacheKey, match.entry, options.onInvalidate);
+		options.onReuse?.(match.entry, match.cacheKey);
 		return true;
 	}
 	deletePrefetchCacheEntry(getPrefetchCache(), getPrefetchedUrls(), match.cacheKey, match.entry, options.notifyInvalidation ?? true);
@@ -494,7 +496,7 @@ function deletePrefetchCacheEntry(cache, prefetched, cacheKey, entry, notify) {
 		entry.onInvalidateCallbacks = void 0;
 	}
 }
-function discardLearningOnlyPrefetchCacheEntry(rscUrl, interceptionContext = null) {
+function discardLearningOnlyPrefetchCacheEntry(rscUrl, interceptionContext = null, mountedSlotsHeader = null) {
 	const cache = getPrefetchCache();
 	const prefetched = getPrefetchedUrls();
 	const normalizedTarget = normalizeRscCacheLookupUrl(rscUrl);
@@ -505,6 +507,7 @@ function discardLearningOnlyPrefetchCacheEntry(rscUrl, interceptionContext = nul
 		const source = parsePrefetchCacheKey(cacheKey);
 		if (source.interceptionContext !== interceptionContext) continue;
 		if (normalizeRscCacheLookupUrl(source.rscUrl) !== normalizedTarget) continue;
+		if (!isPrefetchCacheEntryCompatibleWithMountedSlots(entry, mountedSlotsHeader)) continue;
 		superseded.push([cacheKey, entry]);
 	}
 	for (const [cacheKey, entry] of superseded) {
@@ -513,6 +516,25 @@ function discardLearningOnlyPrefetchCacheEntry(rscUrl, interceptionContext = nul
 	}
 	return superseded.length > 0;
 }
+/**
+* Make a prefetch reusable by a navigation, as an `unstable_dynamicOnHover`
+* hover does. A pending one that would be kept as learning-only becomes a full
+* prefetch and takes the full-prefetch lifetime. One already kept as
+* learning-only because its page rendered dynamically is left for the full
+* prefetch to replace: Next.js refetches it with `FetchStrategy.Full`, so the
+* page reflects the cookies and headers at hover time.
+*/
+function promotePrefetchCacheEntryForNavigation(cacheKey, entry) {
+	if (entry.dynamicStaleTime !== "learning-only") {
+		entry.cacheForNavigation = true;
+		return;
+	}
+	if (entry.cacheForNavigation === false) return;
+	entry.dynamicStaleTime = "full-prefetch";
+	if (entry.snapshot === void 0) return;
+	entry.expiresAt = resolvePrefetchedRscResponseExpiresAt(entry.timestamp, entry.snapshot, entry.fallbackTtlMs ?? PREFETCH_CACHE_TTL, "full-prefetch");
+	schedulePrefetchInvalidation(cacheKey, entry);
+}
 function invalidatePrefetchCacheEntry(cacheKey) {
 	const cache = getPrefetchCache();
 	const entry = cache.get(cacheKey);
@@ -837,6 +859,10 @@ function prefetchRscResponse(rscUrl, fetchPromise, interceptionContext = null, m
 		searchAgnosticShell: behavior.searchAgnosticShell === true,
 		timestamp: now
 	};
+	if (behavior.dynamicStaleTime === "learning-only" && behavior.searchAgnosticShell !== true) {
+		entry.dynamicStaleTime = "learning-only";
+		entry.fallbackTtlMs = behavior.fallbackTtlMs ?? PREFETCH_CACHE_TTL;
+	}
 	addPrefetchInvalidationCallback(entry, options?.onInvalidate);
 	entry.fetchPromise = fetchPromise;
 	entry.pending = fetchPromise.then(async (response) => {
@@ -847,8 +873,13 @@ function prefetchRscResponse(rscUrl, fetchPromise, interceptionContext = null, m
 			entry.snapshot = snapshot;
 			entry.size = snapshot.buffer.byteLength;
 			adjustPrefetchCacheByteSize(cache, entry.size - previousSize);
-			entry.expiresAt = resolvePrefetchedRscResponseExpiresAt(entry.timestamp, entry.snapshot, behavior.fallbackTtlMs ?? PREFETCH_CACHE_TTL, behavior.searchAgnosticShell === true ? "ignore" : behavior.dynamicStaleTime ?? (behavior.optimisticRouteShell === true ? "ignore" : "verbatim"));
-			if (behavior.prepareSnapshot && snapshot.redirectHeader === void 0) try {
+			const fallbackTtlMs = behavior.fallbackTtlMs ?? PREFETCH_CACHE_TTL;
+			const dynamicStaleTime = behavior.searchAgnosticShell === true ? "ignore" : entry.dynamicStaleTime ?? behavior.dynamicStaleTime ?? (behavior.optimisticRouteShell === true ? "ignore" : "verbatim");
+			if (dynamicStaleTime === "learning-only" && isStaleTimeSeconds(snapshot.dynamicStaleTimeSeconds)) {
+				entry.cacheForNavigation = false;
+				entry.expiresAt = entry.timestamp + Math.max(fallbackTtlMs, MIN_PREFETCH_STALE_TIME_MS);
+			} else entry.expiresAt = resolvePrefetchedRscResponseExpiresAt(entry.timestamp, entry.snapshot, fallbackTtlMs, dynamicStaleTime === "learning-only" ? "verbatim" : dynamicStaleTime);
+			if (behavior.prepareSnapshot && entry.cacheForNavigation && snapshot.redirectHeader === void 0) try {
 				const preparedElements = await behavior.prepareSnapshot(snapshot);
 				if (cache.get(cacheKey) !== entry) return;
 				entry.preparedElements = preparedElements;
@@ -952,8 +983,12 @@ async function consumePrefetchResponseForNavigation(rscUrl, interceptionContext
 	if (options?.shouldConsume?.() === false) return null;
 	const allowExpiredInFlightHandoff = entry.pending !== void 0;
 	if (entry.pending !== void 0) {
-		promoteAppPrefetchFetch(entry.fetchPromise);
-		await entry.pending.catch(() => {});
+		const releaseClaim = promoteAppPrefetchFetch(entry.fetchPromise, options?.shouldConsume);
+		try {
+			await entry.pending.catch(() => {});
+		} finally {
+			releaseClaim();
+		}
 		if (cache.get(cacheKey) !== entry) return null;
 		if (options?.shouldConsume?.() === false) return null;
 	}
@@ -1040,14 +1075,31 @@ let _cachedEmptyClientSearchParams = null;
 * be visible until the next commit.
 */
 function getSearchParamsSnapshot() {
-	if (getNavigationContext()) return getServerSearchParamsSnapshot();
+	const hasAppContext = getNavigationContext() !== null;
 	const pagesCtx = getPagesNavigationContext();
-	if (pagesCtx) return getReadonlyPagesSearchParams(pagesCtx.searchParams);
-	const cached = getClientNavigationState()?.cachedReadonlySearchParams;
-	if (cached) return cached;
+	if (!hasAppContext && pagesCtx) return getReadonlyPagesSearchParams(pagesCtx.searchParams);
+	const state = getClientNavigationState();
+	if (state) {
+		if (hasAppContext) adoptHydrationSearchParams(state);
+		return state.cachedReadonlySearchParams;
+	}
 	if (_cachedEmptyClientSearchParams === null) _cachedEmptyClientSearchParams = new ReadonlyURLSearchParams();
 	return _cachedEmptyClientSearchParams;
 }
+let _comparedHydrationSearchParams = null;
+/**
+* Keep the hydrated search params object when the browser URL has the same
+* query. React compares the two snapshots by identity once hydrated, so a new
+* object would re-render every useSearchParams() caller and re-run effects
+* keyed on it, where Next.js keeps one object from the first render.
+*/
+function adoptHydrationSearchParams(state) {
+	const hydrated = getServerSearchParamsSnapshot();
+	if (hydrated === state.cachedReadonlySearchParams) return;
+	if (hydrated === _comparedHydrationSearchParams) return;
+	_comparedHydrationSearchParams = hydrated;
+	if (hydrated.toString() === state.cachedReadonlySearchParams.toString()) state.cachedReadonlySearchParams = hydrated;
+}
 function syncCommittedUrlStateFromLocation() {
 	const state = getClientNavigationState();
 	if (!state) return false;
@@ -1465,6 +1517,11 @@ async function navigateClientSide(href, mode, scroll, programmaticTransition = f
 		const fullHref = toCanonicalBrowserNavigationHref(normalizedHref, window.location.href, __basePath, __trailingSlash);
 		notifyAppRouterTransitionStart(fullHref, mode);
 		if (mode === "push") saveScrollPosition();
+		const mpaNavigate = getNavigationRuntime()?.functions.navigateExternal;
+		if (mpaNavigate) {
+			await mpaNavigate(fullHref, mode);
+			return;
+		}
 		hardNavigateTo(fullHref, mode);
 		await new Promise(() => {});
 		return;
@@ -1607,7 +1664,8 @@ const _appRouter = {
 		if (prefetchHref == null) return;
 		const fullHref = toAppPrefetchDestination(prefetchHref);
 		if (fullHref === null) return;
-		const interceptionContext = getPrefetchInterceptionContext(fullHref);
+		const currentPathname = window.location.pathname;
+		let interceptionContext = getPrefetchInterceptionContext(fullHref, currentPathname);
 		const mountedSlotsHeader = getMountedSlotsHeader();
 		const headers = createAppPrefetchRequestHeaders({
 			fetchPriority: "low",
@@ -1616,6 +1674,12 @@ const _appRouter = {
 		});
 		const setup = beginPrefetchSetup(fullHref);
 		(async () => {
+			const routeManifestLoad = loadNavigationRuntimeRouteManifest();
+			if (routeManifestLoad !== null) {
+				if (!await routeManifestLoad || setup.cancelled) return;
+				interceptionContext = getPrefetchInterceptionContext(fullHref, currentPathname);
+				if (interceptionContext !== null) headers.set(VINEXT_INTERCEPTION_CONTEXT_HEADER, interceptionContext);
+			}
 			if (HAS_CLIENT_REWRITES) await preloadHybridClientRouteOwner();
 			const hybridOwner = resolveHybridClientRouteOwner(fullHref);
 			if (hybridOwner === "pages" || hybridOwner === "document") return;
@@ -1623,7 +1687,7 @@ const _appRouter = {
 			const kind = options?.kind === "full" ? "full" : "auto";
 			const [{ resolveAutoAppRoutePrefetch, resolveFullAppRoutePrefetch }, { resolveAppPrefetchRscRequest }] = await Promise.all([import("./internal/app-route-prefetch-policy.js"), import("./internal/app-prefetch-rsc-request.js")]);
 			if (setup.cancelled) return;
-			const policy = kind === "full" ? resolveFullAppRoutePrefetch() : resolveAutoAppRoutePrefetch(rewrittenPrefetchHref ?? fullHref);
+			const policy = kind === "full" ? resolveFullAppRoutePrefetch() : resolveAutoAppRoutePrefetch(rewrittenPrefetchHref ?? fullHref, interceptionContext);
 			const reusable = policy.shouldPrefetch && policy.cacheForNavigation;
 			const requiresRouteTreePrefetch = policy.requiresRouteTreePrefetch === true;
 			if (reusable && kind === "full") headers.delete(NEXT_ROUTER_PREFETCH_HEADER);
@@ -1635,7 +1699,7 @@ const _appRouter = {
 			if (!reusable && kind === "auto") {
 				headers.set(NEXT_ROUTER_PREFETCH_HEADER, "1");
 				headers.set(NEXT_ROUTER_SEGMENT_PREFETCH_HEADER, "1");
-				headers.set(VINEXT_RSC_RENDER_MODE_HEADER, hasSearchParams ? APP_RSC_RENDER_MODE_PREFETCH_DYNAMIC_SHELL : APP_RSC_RENDER_MODE_PREFETCH_LOADING_SHELL);
+				headers.set(VINEXT_RSC_RENDER_MODE_HEADER, hasSearchParams && policy.rendersDynamically !== true ? APP_RSC_RENDER_MODE_PREFETCH_DYNAMIC_SHELL : APP_RSC_RENDER_MODE_PREFETCH_LOADING_SHELL);
 			}
 			const { additionalRscUrls, rscUrl } = await resolveAppPrefetchRscRequest({
 				fullHref,
@@ -1645,15 +1709,17 @@ const _appRouter = {
 			if (setup.cancelled) return;
 			const cacheKey = AppElementsWire.encodeCacheKey(rscUrl, interceptionContext);
 			const prefetched = getPrefetchedUrls();
+			if (policy.dynamicStaleTime !== "full-prefetch" && hasFreshLearningOnlyPrefetchCacheEntry(rscUrl, interceptionContext)) {
+				attachPrefetchInvalidationCallback(cacheKey, options?.onInvalidate);
+				return;
+			}
 			if (reusable) {
-				discardLearningOnlyPrefetchCacheEntry(rscUrl, interceptionContext);
+				discardLearningOnlyPrefetchCacheEntry(rscUrl, interceptionContext, mountedSlotsHeader);
 				if (hasPrefetchCacheEntryForNavigation(rscUrl, interceptionContext, mountedSlotsHeader, {
 					additionalRscUrls,
-					onInvalidate: options?.onInvalidate
+					onInvalidate: options?.onInvalidate,
+					onReuse: policy.dynamicStaleTime === "full-prefetch" ? (entry, matchedCacheKey) => promotePrefetchCacheEntryForNavigation(matchedCacheKey, entry) : void 0
 				})) return;
-			} else if (hasFreshLearningOnlyPrefetchCacheEntry(rscUrl, interceptionContext)) {
-				attachPrefetchInvalidationCallback(cacheKey, options?.onInvalidate);
-				return;
 			}
 			prefetched.add(cacheKey);
 			const fetchFullRscPayload = () => scheduleAppPrefetchFetch((signal) => fetch(rscUrl, {
@@ -1848,4 +1914,4 @@ if (!isServer) {
 	}
 }
 //#endregion
-export { BailoutToCSRError, DYNAMIC_NAVIGATION_CACHE_TTL, DynamicServerError, GLOBAL_ACCESSORS_KEY, HTTP_ERROR_FALLBACK_ERROR_CODE, MAX_PREFETCH_CACHE_SIZE, PREFETCH_CACHE_TTL, ReadonlyURLSearchParams, RedirectType, ServerInsertedHTMLContext, UnrecognizedActionError, __basePath, _registerStateAccessors, activateNavigationSnapshot, appRouterInstance, applyAppRouterScrollFallback, clearPendingPathname, clearServerInsertedHTML, commitClientNavigationState, consumePrefetchResponse, consumePrefetchResponseForNavigation, createAppPrefetchRequestHeaders, createCachedRscResponseSnapshot, createClientNavigationRenderSnapshot, createSnapshotPathAndSearch, decodeRedirectError, deletePrefetchResponseSnapshot, disableNavigationResponsePrefetchCacheReuse, discardLearningOnlyPrefetchCacheEntry, fetchRouteTreeGatedPrefetch, flushServerInsertedHTML, forbidden, getAccessFallbackHTTPStatus, getBfcacheIdMapContext, getBfcacheSegmentIdContext, getClientNavigationRenderContext, getClientNavigationState, getClientParams, getCurrentInterceptionContext, getCurrentNextUrl, getFreshPrefetchCacheEntry, getLayoutSegmentContext, getMountedSlotsHeader, getNavigationContext, getPrefetchCache, getPrefetchInterceptionContext, getPrefetchedUrls, hasFreshLearningOnlyPrefetchCacheEntry, hasPrefetchCacheEntryForNavigation, hasSearchAgnosticPrefetchShellForRoute, invalidatePrefetchCache, isBailoutToCSRError, isDynamicServerError, isHTTPAccessFallbackError, isNextRouterError, isRedirectError, navigateClientSide, notFound, parseRenderedPathAndSearchHeader, peekPrefetchResponseForNavigation, permanentRedirect, prefetchRscResponse, preloadHybridClientRouteOwner, prepareNavigationPrefetchSnapshot, pushHistoryStateWithoutNotify, redirect, renderServerInsertedHTML, replaceClientParamsWithoutNotify, replaceHistoryStateWithoutNotify, resolveCachedRscResponseExpiresAt, resolveCachedRscResponseTtlMs, resolveLoadedHybridClientRewriteHref, resolvePrefetchCacheEntryMountedSlotsHeader, restoreRscResponse, saveScrollPosition, seedPrefetchResponseSnapshot, setClientParams, setMountedSlotsHeader, setNavigationContext, setPendingPathname, snapshotRscResponse, storePrefetchResponse, unauthorized, unstable_isUnrecognizedActionError, unstable_rethrow, useClientNavigationRenderSnapshot, useParams, usePathname, useRouter, useSearchParams, useSelectedLayoutSegment, useSelectedLayoutSegments, useServerInsertedHTML };
+export { BailoutToCSRError, DYNAMIC_NAVIGATION_CACHE_TTL, DynamicServerError, GLOBAL_ACCESSORS_KEY, HTTP_ERROR_FALLBACK_ERROR_CODE, MAX_PREFETCH_CACHE_SIZE, PREFETCH_CACHE_TTL, ReadonlyURLSearchParams, RedirectType, ServerInsertedHTMLContext, UnrecognizedActionError, __basePath, _registerStateAccessors, activateNavigationSnapshot, appRouterInstance, applyAppRouterScrollFallback, clearPendingPathname, clearServerInsertedHTML, commitClientNavigationState, consumePrefetchResponse, consumePrefetchResponseForNavigation, createAppPrefetchRequestHeaders, createCachedRscResponseSnapshot, createClientNavigationRenderSnapshot, createSnapshotPathAndSearch, decodeRedirectError, deletePrefetchResponseSnapshot, disableNavigationResponsePrefetchCacheReuse, discardLearningOnlyPrefetchCacheEntry, fetchRouteTreeGatedPrefetch, flushServerInsertedHTML, forbidden, getAccessFallbackHTTPStatus, getBfcacheIdMapContext, getBfcacheSegmentIdContext, getClientNavigationRenderContext, getClientNavigationState, getClientParams, getCurrentInterceptionContext, getCurrentNextUrl, getFreshPrefetchCacheEntry, getLayoutSegmentContext, getMountedSlotsHeader, getNavigationContext, getPrefetchCache, getPrefetchInterceptionContext, getPrefetchedUrls, hasFreshLearningOnlyPrefetchCacheEntry, hasPrefetchCacheEntryForNavigation, hasSearchAgnosticPrefetchShellForRoute, invalidatePrefetchCache, isBailoutToCSRError, isDynamicServerError, isHTTPAccessFallbackError, isNextRouterError, isRedirectError, navigateClientSide, notFound, parseRenderedPathAndSearchHeader, peekPrefetchResponseForNavigation, permanentRedirect, prefetchRscResponse, preloadHybridClientRouteOwner, prepareNavigationPrefetchSnapshot, promotePrefetchCacheEntryForNavigation, pushHistoryStateWithoutNotify, redirect, renderServerInsertedHTML, replaceClientParamsWithoutNotify, replaceHistoryStateWithoutNotify, resolveCachedRscResponseExpiresAt, resolveCachedRscResponseTtlMs, resolveLoadedHybridClientRewriteHref, resolvePrefetchCacheEntryMountedSlotsHeader, restoreRscResponse, saveScrollPosition, seedPrefetchResponseSnapshot, setClientParams, setMountedSlotsHeader, setNavigationContext, setPendingPathname, snapshotRscResponse, storePrefetchResponse, unauthorized, unstable_isUnrecognizedActionError, unstable_rethrow, useClientNavigationRenderSnapshot, useParams, usePathname, useRouter, useSearchParams, useSelectedLayoutSegment, useSelectedLayoutSegments, useServerInsertedHTML };

package/dist/shims/og.js

@@ -1,4 +1,6 @@
+import { shareIsolatePromise } from "../server/isolate-shared-promise.js";
 //#region src/shims/og.tsx
+let vercelOg;
 const CACHE_HEADERS = {
 	noCache: "no-cache, no-store",
 	revalidate: "public, max-age=0, must-revalidate"
@@ -13,21 +15,43 @@ const CACHE_HEADERS = {
 var ImageResponse = class extends Response {
 	static displayName = "ImageResponse";
 	constructor(element, options) {
+		let startRendering;
+		const constructed = new Promise((resolve) => {
+			startRendering = resolve;
+		});
 		const readable = new ReadableStream({ async start(controller) {
-			const { ImageResponse: VercelImageResponse } = await import("@vercel/og");
-			const imageResponse = new VercelImageResponse(element, options);
-			if (!imageResponse.body) {
-				controller.close();
-				return;
+			await constructed;
+			if (options === null) throw new TypeError("Cannot read properties of null (reading 'headers')");
+			let settleInitialization;
+			if (!vercelOg) {
+				const loading = import("@vercel/og");
+				vercelOg = loading;
+				loading.catch(() => {
+					if (vercelOg === loading) vercelOg = void 0;
+				});
+				shareIsolatePromise(new Promise((resolve) => {
+					settleInitialization = resolve;
+				}));
 			}
-			const reader = imageResponse.body.getReader();
-			while (true) {
-				const { done, value } = await reader.read();
-				if (done) {
+			try {
+				const { ImageResponse: VercelImageResponse } = await vercelOg;
+				const imageResponse = new VercelImageResponse(element, options);
+				if (!imageResponse.body) {
 					controller.close();
 					return;
 				}
-				controller.enqueue(value);
+				const reader = imageResponse.body.getReader();
+				while (true) {
+					const { done, value } = await reader.read();
+					settleInitialization?.();
+					if (done) {
+						controller.close();
+						return;
+					}
+					controller.enqueue(value);
+				}
+			} finally {
+				settleInitialization?.();
 			}
 		} });
 		const headers = new Headers({
@@ -42,6 +66,7 @@ var ImageResponse = class extends Response {
 			status: options?.status,
 			statusText: options?.statusText
 		});
+		startRendering();
 	}
 };
 //#endregion

package/dist/shims/pages-router-runtime.d.ts

@@ -8,4 +8,5 @@ export declare function setPagesRouterPopStateHandler(handler: PagesRouterPopSta
  */
 export declare function setStampInitialHistoryState(fn: () => void): void;
 export declare function installPagesRouterRuntime(): void;
-//#endregion
+//#endregion
+export {};

package/dist/shims/ppr-fallback-shell.d.ts

@@ -29,4 +29,5 @@ export declare function waitForPprFallbackShellCacheReady(state: PprFallbackShel
 export declare function preparePprFallbackShellFinalRender(state: PprFallbackShellState): void;
 export declare function beginPprFallbackShellFinalRender(state: PprFallbackShellState): void;
 export declare function isPprFallbackShellAbortError(error: unknown): boolean;
-//#endregion
+//#endregion
+export {};

package/dist/shims/request-context.d.ts

@@ -38,6 +38,19 @@ export type ExecutionContextLike = {
   cache?: unknown;
   /** Server-owned origin for credential-bearing Pages revalidation loopbacks. */
   trustedRevalidateOrigin?: string;
+  /**
+   * Node production server signal that aborts when the client disconnects
+   * before the response finishes. Its Request only follows this signal, so the
+   * App RSC handler takes it from here (UnifiedRequestContext.requestSignal).
+   */
+  requestSignal?: AbortSignal;
+  /**
+   * Server-owned origin middleware runs against. Set by the Node production
+   * server, whose request URL comes from the client's Host header. Without it
+   * middleware uses the request URL's origin, which Workers can trust because
+   * the platform routes by hostname.
+   */
+  middlewareOrigin?: string;
   /** Worker-owned in-process dispatcher for authenticated Pages revalidation. */
   dispatchPagesRevalidate?: (request: Request) => Promise<Response>;
   /** Marks a request currently executing through the internal revalidation dispatcher. */