vinext 1.0.0-beta.2 → 1.0.0-beta.4

package/dist/shims/navigation.d.ts

@@ -1,7 +1,9 @@
 import { AppRouterScrollIntent } from "./app-router-scroll-state.js";
 import { NavigationRuntimeVisibleCommitMode } from "../client/navigation-runtime.js";
+import { AppElements } from "../server/app-elements-wire.js";
 import { AppRouterInstance, NavigateOptions, PrefetchOptions as PrefetchOptions$1 } from "./internal/app-router-context.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";
 import { BailoutToCSRError, DynamicServerError, HTTP_ERROR_FALLBACK_ERROR_CODE, RedirectType, decodeRedirectError, forbidden, getAccessFallbackHTTPStatus, isBailoutToCSRError, isDynamicServerError, isHTTPAccessFallbackError, isNextRouterError, isRedirectError, notFound, permanentRedirect, redirect, unauthorized, unstable_rethrow } from "./navigation-errors.js";
 import { UnrecognizedActionError, unstable_isUnrecognizedActionError } from "./unrecognized-action-error.js";
@@ -27,6 +29,7 @@ type CachedRscResponse = {
   expiresAt?: number;
   mountedSlotsHeader?: string | null;
   paramsHeader: string | null;
+  preparedElements?: AppElements;
   renderedPathAndSearch: string | null;
   url: string;
 };
@@ -46,6 +49,7 @@ type PrefetchCacheEntry = {
   snapshot?: CachedRscResponse;
   cacheKeys?: Set<string>;
   pending?: Promise<void>;
+  preparedElements?: AppElements;
   prefetchKind?: PrefetchCacheKind;
   searchAgnosticShell?: boolean;
   size?: number;
@@ -54,6 +58,13 @@ type PrefetchCacheEntry = {
 declare function getCurrentInterceptionContext(): string | null;
 declare function getPrefetchInterceptionContext(targetHref: string): string | null;
 declare function getCurrentNextUrl(): string;
+declare function createAppPrefetchRequestHeaders(options: {
+  fetchPriority: "auto" | "high" | "low";
+  interceptionContext?: string | null;
+  mountedSlotsHeader?: string | null;
+  prefetchKind?: "auto" | "full";
+  renderMode?: AppRscRenderMode;
+}): Headers;
 /** Get or create the shared in-memory RSC prefetch cache on window. */
 declare function getPrefetchCache(): Map<string, PrefetchCacheEntry>;
 /**
@@ -69,6 +80,7 @@ declare function hasPrefetchCacheEntryForNavigation(rscUrl: string, interception
   notifyInvalidation?: boolean;
 }): boolean;
 declare function hasSearchAgnosticPrefetchShellForRoute(rscUrl: string, interceptionContext?: string | null, mountedSlotsHeader?: string | null): boolean;
+declare function discardLearningOnlyPrefetchCacheEntry(rscUrl: string, interceptionContext?: string | null): boolean;
 declare function invalidatePrefetchCache(): void;
 declare function seedPrefetchResponseSnapshot(rscUrl: string, snapshot: CachedRscResponse, interceptionContext?: string | null, mountedSlotsHeader?: string | null, fallbackTtlMs?: number): void;
 declare function deletePrefetchResponseSnapshot(rscUrl: string, snapshot: CachedRscResponse, interceptionContext?: string | null): void;
@@ -121,8 +133,10 @@ declare function restoreRscResponse(cached: CachedRscResponse, copy?: boolean):
 declare function prefetchRscResponse(rscUrl: string, fetchPromise: Promise<Response>, interceptionContext?: string | null, mountedSlotsHeader?: string | null, options?: PrefetchOptions, behavior?: {
   cacheForNavigation?: boolean;
   fallbackTtlMs?: number;
+  minimumTtlMs?: number;
   optimisticRouteShell?: boolean;
   prefetchKind?: PrefetchCacheKind;
+  prepareSnapshot?: (snapshot: CachedRscResponse) => Promise<AppElements>;
   searchAgnosticShell?: boolean;
 }): void;
 declare function peekPrefetchResponseForNavigation(rscUrl: string, interceptionContext?: string | null, mountedSlotsHeader?: string | null): CachedRscResponse | null;
@@ -131,7 +145,9 @@ declare function peekPrefetchResponseForNavigation(rscUrl: string, interceptionC
  * Only returns settled (non-pending) snapshots synchronously.
  * Returns null if the entry is still in flight or doesn't exist.
  */
-declare function consumePrefetchResponse(rscUrl: string, interceptionContext?: string | null, mountedSlotsHeader?: string | null): CachedRscResponse | null;
+declare function consumePrefetchResponse(rscUrl: string, interceptionContext?: string | null, mountedSlotsHeader?: string | null, options?: {
+  additionalRscUrls?: readonly string[];
+}): CachedRscResponse | null;
 /**
  * Consume a prefetched response for navigation. Unlike the synchronous cache
  * read above, this waits for an already-started prefetch snapshot before
@@ -303,4 +319,4 @@ declare function useSelectedLayoutSegments(parallelRoutesKey?: string): string[]
  */
 declare function useServerInsertedHTML(callback: () => unknown): void;
 //#endregion
-export { BailoutToCSRError, CachedRscResponse, ClientNavigationRenderSnapshot, DYNAMIC_NAVIGATION_CACHE_TTL, DynamicServerError, GLOBAL_ACCESSORS_KEY, HTTP_ERROR_FALLBACK_ERROR_CODE, MAX_PREFETCH_CACHE_SIZE, type NavigationContext, type NavigationStateAccessors, PREFETCH_CACHE_TTL, PrefetchCacheEntry, PrefetchCacheKind, PrefetchOptions, ReadonlyURLSearchParams, RedirectType, type SegmentMap, ServerInsertedHTMLContext, UnrecognizedActionError, __basePath, _registerStateAccessors, activateNavigationSnapshot, appRouterInstance, applyAppRouterScrollFallback, clearPendingPathname, clearServerInsertedHTML, commitClientNavigationState, consumePrefetchResponse, consumePrefetchResponseForNavigation, createCachedRscResponseSnapshot, createClientNavigationRenderSnapshot, createSnapshotPathAndSearch, decodeRedirectError, deletePrefetchResponseSnapshot, flushServerInsertedHTML, forbidden, getAccessFallbackHTTPStatus, getBfcacheIdMapContext, getBfcacheSegmentIdContext, getClientNavigationRenderContext, getClientNavigationState, getClientParams, getCurrentInterceptionContext, getCurrentNextUrl, getLayoutSegmentContext, getMountedSlotsHeader, getNavigationContext, getPrefetchCache, getPrefetchInterceptionContext, getPrefetchedUrls, hasPrefetchCacheEntryForNavigation, hasSearchAgnosticPrefetchShellForRoute, invalidatePrefetchCache, isBailoutToCSRError, isDynamicServerError, isHTTPAccessFallbackError, isNextRouterError, isRedirectError, navigateClientSide, notFound, peekPrefetchResponseForNavigation, permanentRedirect, prefetchRscResponse, preloadHybridClientRouteOwner, 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, CachedRscResponse, ClientNavigationRenderSnapshot, DYNAMIC_NAVIGATION_CACHE_TTL, DynamicServerError, GLOBAL_ACCESSORS_KEY, HTTP_ERROR_FALLBACK_ERROR_CODE, MAX_PREFETCH_CACHE_SIZE, type NavigationContext, type NavigationStateAccessors, PREFETCH_CACHE_TTL, PrefetchCacheEntry, PrefetchCacheKind, PrefetchOptions, ReadonlyURLSearchParams, RedirectType, type SegmentMap, ServerInsertedHTMLContext, UnrecognizedActionError, __basePath, _registerStateAccessors, activateNavigationSnapshot, appRouterInstance, applyAppRouterScrollFallback, clearPendingPathname, clearServerInsertedHTML, commitClientNavigationState, consumePrefetchResponse, consumePrefetchResponseForNavigation, createAppPrefetchRequestHeaders, createCachedRscResponseSnapshot, createClientNavigationRenderSnapshot, createSnapshotPathAndSearch, decodeRedirectError, deletePrefetchResponseSnapshot, discardLearningOnlyPrefetchCacheEntry, flushServerInsertedHTML, forbidden, getAccessFallbackHTTPStatus, getBfcacheIdMapContext, getBfcacheSegmentIdContext, getClientNavigationRenderContext, getClientNavigationState, getClientParams, getCurrentInterceptionContext, getCurrentNextUrl, getLayoutSegmentContext, getMountedSlotsHeader, getNavigationContext, getPrefetchCache, getPrefetchInterceptionContext, getPrefetchedUrls, hasPrefetchCacheEntryForNavigation, hasSearchAgnosticPrefetchShellForRoute, invalidatePrefetchCache, isBailoutToCSRError, isDynamicServerError, isHTTPAccessFallbackError, isNextRouterError, isRedirectError, navigateClientSide, notFound, peekPrefetchResponseForNavigation, permanentRedirect, prefetchRscResponse, preloadHybridClientRouteOwner, 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/navigation.js

@@ -8,12 +8,12 @@ import { markPprFallbackShellDynamicBoundary } from "./ppr-fallback-shell.js";
 import { AppRouterContext } from "./internal/app-router-context.js";
 import { resolveDirectHybridClientRouteOwner } from "./internal/hybrid-client-route-owner-direct.js";
 import { toBrowserNavigationHref, toSameOriginAppPath, withBasePath } from "./url-utils.js";
-import { retryScrollTo, scrollToHashTarget } from "./hash-scroll.js";
+import { retryScrollTo, scrollToHashTarget, scrollToHashTargetOnNextFrame } from "./hash-scroll.js";
+import { isBotUserAgent } from "../utils/html-limited-bots.js";
 import { GLOBAL_ACCESSORS_KEY, ServerInsertedHTMLContext, _registerStateAccessors, clearClientHydrationContext, clearServerInsertedHTML, flushServerInsertedHTML, getBfcacheIdMapContext, getBfcacheSegmentIdContext, getLayoutSegmentContext, getNavigationContext, registerServerInsertedHTMLCallback, renderServerInsertedHTML, setNavigationContext } from "./navigation-context-state.js";
 import { BailoutToCSRError, DynamicServerError, HTTP_ERROR_FALLBACK_ERROR_CODE, RedirectType, decodeRedirectError, forbidden, getAccessFallbackHTTPStatus, isBailoutToCSRError, isDynamicServerError, isHTTPAccessFallbackError, isNextRouterError, isRedirectError, notFound, permanentRedirect, redirect, unauthorized, unstable_rethrow } from "./navigation-errors.js";
-import { isBotUserAgent } from "../utils/html-limited-bots.js";
 import { clearAppNavigationFailureTarget, stageAppNavigationFailureTarget } from "../client/app-nav-failure-handler.js";
-import { beginAppRouterScrollIntent, clearAppRouterScrollIntent, consumeAppRouterScrollIntent, getPendingAppRouterScrollIntent } from "./app-router-scroll-state.js";
+import { beginAppRouterScrollIntent, clearAppRouterScrollIntent, consumeAppRouterScrollIntent, getPendingAppRouterScrollIntent, isLatestAppRouterScrollIntent } from "./app-router-scroll-state.js";
 import { VINEXT_RSC_COMPATIBILITY_ID_HEADER, createRscRequestHeaders, createRscRequestUrl, stripRscCacheBustingSearchParam, stripRscSuffix } from "../server/app-rsc-cache-busting.js";
 import { getNavigationRuntime, hasAppNavigationRuntime } from "../client/navigation-runtime.js";
 import { notifyAppRouterTransitionStart } from "../client/instrumentation-client-state.js";
@@ -121,6 +121,15 @@ function getCurrentNextUrl() {
 	if (isServer) return "/";
 	return window.location.pathname + window.location.search;
 }
+function createAppPrefetchRequestHeaders(options) {
+	const prefetchRouterState = getNavigationRuntime()?.functions.getPrefetchRouterState?.() ?? null;
+	return createRscRequestHeaders({
+		...options,
+		nextUrl: getCurrentNextUrl(),
+		includePrefetchHeader: options.prefetchKind !== "full",
+		prefetchRouterState
+	});
+}
 /** Get or create the shared in-memory RSC prefetch cache on window. */
 function getPrefetchCache() {
 	if (isServer) return /* @__PURE__ */ new Map();
@@ -156,11 +165,11 @@ function resolveCachedRscResponseExpiresAt(timestamp, cached, fallbackTtlMs) {
 	if (isCacheExpiresAt(cached.expiresAt)) return cached.expiresAt;
 	return timestamp + resolveCachedRscResponseTtlMs(cached, fallbackTtlMs);
 }
-function resolvePrefetchedRscResponseExpiresAt(timestamp, cached, fallbackTtlMs) {
+function resolvePrefetchedRscResponseExpiresAt(timestamp, cached, fallbackTtlMs, minimumTtlMs = MIN_PREFETCH_STALE_TIME_MS) {
 	if (isCacheExpiresAt(cached.expiresAt)) return cached.expiresAt;
 	const seconds = cached.dynamicStaleTimeSeconds;
-	if (!isDynamicStaleTimeSeconds(seconds)) return timestamp + Math.max(fallbackTtlMs, MIN_PREFETCH_STALE_TIME_MS);
-	return timestamp + Math.max(seconds * 1e3, MIN_PREFETCH_STALE_TIME_MS);
+	if (!isDynamicStaleTimeSeconds(seconds)) return timestamp + Math.max(fallbackTtlMs, minimumTtlMs);
+	return timestamp + Math.max(seconds * 1e3, minimumTtlMs);
 }
 function resolvePrefetchCacheEntryExpiresAt(entry) {
 	if (entry.expiresAt !== void 0) return entry.expiresAt;
@@ -347,12 +356,15 @@ function notifyPrefetchInvalidated(entry) {
 	}
 }
 function deletePrefetchCacheEntry(cache, prefetched, cacheKey, entry, notify) {
-	adjustPrefetchCacheByteSize(cache, -getPrefetchCacheEntrySize(entry));
 	const cacheKeys = entry.cacheKeys ?? /* @__PURE__ */ new Set([cacheKey]);
-	for (const key of cacheKeys) {
-		if (cache.get(key) === entry) cache.delete(key);
+	let removedOwnedKey = false;
+	for (const key of cacheKeys) if (cache.get(key) === entry) {
+		cache.delete(key);
 		prefetched.delete(key);
+		removedOwnedKey = true;
 	}
+	if (!removedOwnedKey) return;
+	adjustPrefetchCacheByteSize(cache, -getPrefetchCacheEntrySize(entry));
 	entry.cacheKeys = void 0;
 	if (notify) notifyPrefetchInvalidated(entry);
 	else {
@@ -360,6 +372,22 @@ function deletePrefetchCacheEntry(cache, prefetched, cacheKey, entry, notify) {
 		entry.onInvalidateCallbacks = void 0;
 	}
 }
+function discardLearningOnlyPrefetchCacheEntry(rscUrl, interceptionContext = null) {
+	const cache = getPrefetchCache();
+	const prefetched = getPrefetchedUrls();
+	const normalizedTarget = normalizeRscCacheLookupUrl(rscUrl);
+	if (normalizedTarget === null) return false;
+	let discarded = false;
+	for (const [cacheKey, entry] of cache) {
+		if (entry.cacheForNavigation !== false || entry.prefetchKind !== "navigation") continue;
+		const source = parsePrefetchCacheKey(cacheKey);
+		if (source.interceptionContext !== interceptionContext) continue;
+		if (normalizeRscCacheLookupUrl(source.rscUrl) !== normalizedTarget) continue;
+		deletePrefetchCacheEntry(cache, prefetched, cacheKey, entry, false);
+		discarded = true;
+	}
+	return discarded;
+}
 function invalidatePrefetchCacheEntry(cacheKey) {
 	const cache = getPrefetchCache();
 	const entry = cache.get(cacheKey);
@@ -565,7 +593,12 @@ 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);
+			entry.expiresAt = resolvePrefetchedRscResponseExpiresAt(entry.timestamp, entry.snapshot, behavior.fallbackTtlMs ?? PREFETCH_CACHE_TTL, behavior.minimumTtlMs);
+			if (behavior.prepareSnapshot) try {
+				const preparedElements = await behavior.prepareSnapshot(snapshot);
+				if (cache.get(cacheKey) !== entry) return;
+				entry.preparedElements = preparedElements;
+			} catch {}
 			addRenderedPathAndSearchPrefetchAlias(cache, prefetched, cacheKey, entry);
 			evictPrefetchCacheIfNeeded();
 		} else {
@@ -620,28 +653,37 @@ function peekPrefetchResponseForNavigation(rscUrl, interceptionContext = null, m
 * Only returns settled (non-pending) snapshots synchronously.
 * Returns null if the entry is still in flight or doesn't exist.
 */
-function consumePrefetchResponse(rscUrl, interceptionContext = null, mountedSlotsHeader = null) {
+function consumePrefetchResponse(rscUrl, interceptionContext = null, mountedSlotsHeader = null, options) {
 	const cache = getPrefetchCache();
 	const exactCacheKey = AppElementsWire.encodeCacheKey(rscUrl, interceptionContext);
 	const exactEntry = cache.get(exactCacheKey);
 	if (exactEntry && exactEntry.cacheForNavigation !== false && !isPrefetchCacheEntryCompatibleWithMountedSlots(exactEntry, mountedSlotsHeader)) deletePrefetchCacheEntry(cache, getPrefetchedUrls(), exactCacheKey, exactEntry, false);
-	const match = findPrefetchCacheEntryForNavigation(rscUrl, interceptionContext, mountedSlotsHeader);
+	const match = findPrefetchCacheEntryForNavigation(rscUrl, interceptionContext, mountedSlotsHeader, options?.additionalRscUrls);
 	if (!match) return null;
 	const { cacheKey, entry } = match;
 	return consumeMatchedPrefetchResponse(cacheKey, entry, mountedSlotsHeader);
 }
 function consumeMatchedPrefetchResponse(cacheKey, entry, mountedSlotsHeader) {
+	const cache = getPrefetchCache();
 	if (entry.pending || entry.outcome !== "cache-seeded") return null;
 	if (entry.cacheForNavigation === false) return null;
-	deletePrefetchCacheEntry(getPrefetchCache(), getPrefetchedUrls(), cacheKey, entry, false);
 	if (entry.snapshot) {
 		if (!isPrefetchCacheEntryCompatibleWithMountedSlots(entry, mountedSlotsHeader)) return null;
-		if (resolvePrefetchCacheEntryExpiresAt(entry) <= Date.now()) return null;
+		if (resolvePrefetchCacheEntryExpiresAt(entry) <= Date.now()) {
+			deletePrefetchCacheEntry(cache, getPrefetchedUrls(), cacheKey, entry, false);
+			return null;
+		}
+		deletePrefetchCacheEntry(cache, getPrefetchedUrls(), cacheKey, entry, false);
+		const snapshot = entry.snapshot;
 		if (entry.expiresAt !== void 0 || entry.snapshot.expiresAt !== void 0) return {
-			...entry.snapshot,
-			expiresAt: resolvePrefetchCacheEntryExpiresAt(entry)
+			...snapshot,
+			expiresAt: resolvePrefetchCacheEntryExpiresAt(entry),
+			...entry.preparedElements ? { preparedElements: entry.preparedElements } : {}
 		};
-		return entry.snapshot;
+		return entry.preparedElements ? {
+			...snapshot,
+			preparedElements: entry.preparedElements
+		} : snapshot;
 	}
 	return null;
 }
@@ -1036,7 +1078,7 @@ function commitHashOnlyHistoryState(href, mode, scroll) {
 function applyAppRouterScrollFallback(intent) {
 	if (typeof document === "undefined" || typeof window === "undefined") return;
 	if (intent.hash !== null) {
-		scrollToHashTarget(intent.hash);
+		scrollToHashTargetOnNextFrame(intent.hash, () => isLatestAppRouterScrollIntent(intent));
 		return;
 	}
 	if (intent.targetHoistedInHead) return;
@@ -1259,7 +1301,10 @@ const _appRouter = {
 			const fullHref = toBrowserNavigationHref(prefetchHref, window.location.href, __basePath);
 			const interceptionContext = getPrefetchInterceptionContext(fullHref);
 			const mountedSlotsHeader = getMountedSlotsHeader();
-			const headers = createRscRequestHeaders({ interceptionContext });
+			const headers = createAppPrefetchRequestHeaders({
+				fetchPriority: "low",
+				interceptionContext
+			});
 			if (mountedSlotsHeader) headers.set(VINEXT_MOUNTED_SLOTS_HEADER, mountedSlotsHeader);
 			const rscUrl = await createRscRequestUrl(fullHref, headers);
 			const cacheKey = AppElementsWire.encodeCacheKey(rscUrl, interceptionContext);
@@ -1273,7 +1318,11 @@ const _appRouter = {
 				headers,
 				credentials: "include",
 				priority: "low"
-			}), "low"), interceptionContext, mountedSlotsHeader, options);
+			}), "low"), interceptionContext, mountedSlotsHeader, options, {
+				cacheForNavigation: false,
+				optimisticRouteShell: true,
+				prefetchKind: "navigation"
+			});
 		})().catch((error) => {
 			console.error("[vinext] RSC prefetch setup error:", error);
 		});
@@ -1412,4 +1461,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, createCachedRscResponseSnapshot, createClientNavigationRenderSnapshot, createSnapshotPathAndSearch, decodeRedirectError, deletePrefetchResponseSnapshot, flushServerInsertedHTML, forbidden, getAccessFallbackHTTPStatus, getBfcacheIdMapContext, getBfcacheSegmentIdContext, getClientNavigationRenderContext, getClientNavigationState, getClientParams, getCurrentInterceptionContext, getCurrentNextUrl, getLayoutSegmentContext, getMountedSlotsHeader, getNavigationContext, getPrefetchCache, getPrefetchInterceptionContext, getPrefetchedUrls, hasPrefetchCacheEntryForNavigation, hasSearchAgnosticPrefetchShellForRoute, invalidatePrefetchCache, isBailoutToCSRError, isDynamicServerError, isHTTPAccessFallbackError, isNextRouterError, isRedirectError, navigateClientSide, notFound, peekPrefetchResponseForNavigation, permanentRedirect, prefetchRscResponse, preloadHybridClientRouteOwner, 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, discardLearningOnlyPrefetchCacheEntry, flushServerInsertedHTML, forbidden, getAccessFallbackHTTPStatus, getBfcacheIdMapContext, getBfcacheSegmentIdContext, getClientNavigationRenderContext, getClientNavigationState, getClientParams, getCurrentInterceptionContext, getCurrentNextUrl, getLayoutSegmentContext, getMountedSlotsHeader, getNavigationContext, getPrefetchCache, getPrefetchInterceptionContext, getPrefetchedUrls, hasPrefetchCacheEntryForNavigation, hasSearchAgnosticPrefetchShellForRoute, invalidatePrefetchCache, isBailoutToCSRError, isDynamicServerError, isHTTPAccessFallbackError, isNextRouterError, isRedirectError, navigateClientSide, notFound, peekPrefetchResponseForNavigation, permanentRedirect, prefetchRscResponse, preloadHybridClientRouteOwner, 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/request-context.d.ts

@@ -27,13 +27,17 @@
  */
 type ExecutionContextLike = {
   waitUntil(promise: Promise<unknown>): void;
-  passThroughOnException?(): void;
+  passThroughOnException?(): void; /** Host runtime executing the current request. */
+  hostRuntime?: "node" | "worker";
   /**
    * Optional host-provided cache handle that some runtimes expose on the
    * execution context. Typed as `unknown` to keep this module runtime-agnostic;
    * CDN cache adapters that know the concrete shape narrow it themselves.
    */
-  cache?: unknown;
+  cache?: unknown; /** Server-owned origin for credential-bearing Pages revalidation loopbacks. */
+  trustedRevalidateOrigin?: 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. */
+  isInternalPagesRevalidation?: boolean;
 };
 /**
  * Run `fn` with the given `ExecutionContext` available via

package/dist/shims/router.js

@@ -1159,13 +1159,12 @@ async function renderPagesNavigationTarget(url, target, props, options, assertSt
 	assertStillCurrent();
 	const React = (await import("react")).default;
 	assertStillCurrent();
-	const rawPageProps = props.pageProps;
-	const pageProps = isUnknownRecord(rawPageProps) ? rawPageProps : {};
+	const pageProps = Object.assign({}, props.pageProps);
+	props.pageProps = pageProps;
 	let element;
 	if (AppComponent) element = React.createElement(AppComponent, {
 		...props,
 		Component: PageComponent,
-		pageProps: rawPageProps,
 		router: singletonRouter
 	});
 	else element = React.createElement(PageComponent, pageProps);
@@ -1312,8 +1311,8 @@ async function navigateClientHtml(url, fetchUrl, controller, navId, assertStillC
 	if (!nextDataJson) scheduleHardNavigationAndThrow(url, "Navigation failed: missing __NEXT_DATA__ in response");
 	const nextData = parseVinextNextDataJson(nextDataJson);
 	const props = nextData.props && typeof nextData.props === "object" ? nextData.props : {};
-	const rawPageProps = props.pageProps;
-	const pageProps = isUnknownRecord(rawPageProps) ? rawPageProps : {};
+	const pageProps = Object.assign({}, props.pageProps);
+	props.pageProps = pageProps;
 	let pageModuleUrl = nextData.__vinext?.pageModuleUrl;
 	if (!pageModuleUrl) {
 		const moduleMatch = html.match(/import\("([^"]+)"\);\s*\n\s*const PageComponent/);
@@ -1355,7 +1354,6 @@ async function navigateClientHtml(url, fetchUrl, controller, navId, assertStillC
 	if (AppComponent) element = React.createElement(AppComponent, {
 		...props,
 		Component: PageComponent,
-		pageProps: rawPageProps,
 		router: singletonRouter
 	});
 	else element = React.createElement(PageComponent, pageProps);
@@ -1647,7 +1645,20 @@ async function performNavigation(url, as, options, mode, onStateUpdate) {
 				const hashStr = extractHash(resolved);
 				resolved = normalizePathTrailingSlash(`${projection.href.split(/[?#]/, 1)[0]}${searchStr ? `?${searchStr}` : ""}${hashStr}`, __trailingSlash);
 			}
-		} else interpolatedRoute = resolved;
+		} else {
+			const missingParams = projection ? routePatternParts(projection.routePathname).filter((part) => part.startsWith(":") && !part.endsWith("*")).map((part) => part.slice(1, part.endsWith("+") ? -1 : void 0)).filter((paramName) => {
+				const value = projection.query[paramName];
+				return value === void 0 || value === "" || Array.isArray(value) && value.length === 0;
+			}) : [];
+			const hasExplicitHrefPathname = typeof url === "string" || url.pathname !== void 0;
+			const isMiddlewareMatch = options?.shallow !== true && getPagesMiddlewareDataHref(resolved, __basePath) !== null;
+			if (missingParams.length > 0 && hasExplicitHrefPathname && !isMiddlewareMatch) {
+				const asPathname = stripHash(resolved).split("?", 1)[0];
+				const routePathname = projection?.routePathname ?? stripHash(resolvedRoute).split("?", 1)[0];
+				throw new HrefInterpolationError(asPathname === routePathname ? `The provided \`href\` (${resolvedRoute}) value is missing query values (${missingParams.join(", ")}) to be interpolated properly. Read more: https://nextjs.org/docs/messages/href-interpolation-failed` : `The provided \`as\` value (${asPathname}) is incompatible with the \`href\` value (${routePathname}). Read more: https://nextjs.org/docs/messages/incompatible-href-as`);
+			}
+			interpolatedRoute = resolved;
+		}
 	}
 	const full = normalizePathTrailingSlash(toBrowserNavigationHref(resolved, window.location.href, __basePath), __trailingSlash);
 	const fullRouteUrl = interpolatedRoute !== resolved ? normalizePathTrailingSlash(toBrowserNavigationHref(interpolatedRoute, window.location.href, __basePath), __trailingSlash) : full;

package/dist/shims/script.js

@@ -1,8 +1,8 @@
 "use client";
-import { escapeInlineContent } from "./head.js";
 import { useScriptNonce } from "./script-nonce-context.js";
 import { hasAppNavigationRuntimeBootstrap } from "../client/navigation-runtime.js";
 import { useBeforeInteractiveRegister } from "./before-interactive-context.js";
+import { escapeInlineContent } from "./head.js";
 import React, { useEffect, useRef } from "react";
 import * as ReactDOM from "react-dom";
 //#region src/shims/script.tsx

package/dist/shims/server.d.ts

@@ -230,15 +230,16 @@ declare class ResponseCookies {
   }]): this;
   get(...args: [name: string] | [options: {
     name: string;
-  }]): CookieEntry | undefined;
+  }]): ResponseCookieEntry | undefined;
   has(name: string): boolean;
   getAll(...args: [name: string] | [options: {
     name: string;
-  }] | []): CookieEntry[];
+  }] | []): ResponseCookieEntry[];
   delete(...args: [name: string] | [options: Omit<CookieOptions & {
     name: string;
   }, "maxAge" | "expires">]): this;
-  [Symbol.iterator](): MapIterator<[string, CookieEntry]>;
+  [Symbol.iterator](): MapIterator<[string, ResponseCookieEntry]>;
+  toString(): string;
   /** Delete all Set-Cookie headers and re-append from the internal map. */
   private _syncHeaders;
 }
@@ -249,10 +250,11 @@ type CookieOptions = {
   expires?: Date | number;
   httpOnly?: boolean;
   secure?: boolean;
-  sameSite?: true | false | "strict" | "lax" | "none" | "Strict" | "Lax" | "None";
+  sameSite?: true | false | "strict" | "lax" | "none";
   partitioned?: boolean;
   priority?: "low" | "medium" | "high";
 };
+type ResponseCookieEntry = CookieEntry & CookieOptions;
 type MiddlewareResponseInit = {
   request?: {
     headers?: Headers;
@@ -323,8 +325,7 @@ type UserAgent = {
  *
  * Uses the platform's `waitUntil` (via the per-request ExecutionContext) when
  * available so the task survives past the response on Cloudflare Workers.
- * Falls back to a fire-and-forget microtask on runtimes without an execution
- * context (e.g. Node.js dev server).
+ * Node.js dev drains callbacks from its response finish/close lifecycle.
  *
  * Throws when called inside a cached scope — request-specific
  * side-effects must not leak into cached results.