vinext 0.0.54 → 0.1.0

package/dist/shims/navigation.js

@@ -1,17 +1,19 @@
 import { stripBasePath } from "../utils/base-path.js";
-import { VINEXT_MOUNTED_SLOTS_HEADER, VINEXT_PARAMS_HEADER } from "../server/headers.js";
+import { VINEXT_DYNAMIC_STALE_TIME_HEADER, VINEXT_MOUNTED_SLOTS_HEADER, VINEXT_PARAMS_HEADER } from "../server/headers.js";
 import { assertSafeNavigationUrl } from "./url-safety.js";
 import { AppElementsWire } from "../server/app-elements-wire.js";
 import "../server/app-elements.js";
+import { AppRouterContext } from "./internal/app-router-context.js";
 import { isAbsoluteOrProtocolRelativeUrl, isHashOnlyBrowserUrlChange, toBrowserNavigationHref, toSameOriginAppPath, withBasePath } from "./url-utils.js";
-import { scrollToHashTarget } from "./hash-scroll.js";
+import { retryScrollTo, scrollToHashTarget } from "./hash-scroll.js";
 import { getNavigationRuntime, hasAppNavigationRuntime } from "../client/navigation-runtime.js";
 import { notifyAppRouterTransitionStart } from "../client/instrumentation-client-state.js";
+import { PUBLIC_INITIAL_BFCACHE_ID } from "../server/app-bfcache-id.js";
 import { resolveManifestNavigationInterceptionContext } from "../server/app-browser-interception-context.js";
-import { createExternalHistoryStatePreservingMetadata } from "../server/app-history-state.js";
-import { VINEXT_RSC_COMPATIBILITY_ID_HEADER, createRscRequestHeaders, createRscRequestUrl } from "../server/app-rsc-cache-busting.js";
+import { createExternalHistoryStatePreservingMetadata, createHashOnlyHistoryStatePreservingNavigationMetadata } from "../server/app-history-state.js";
+import { VINEXT_RSC_COMPATIBILITY_ID_HEADER, createRscRequestHeaders, createRscRequestUrl, stripRscCacheBustingSearchParam } from "../server/app-rsc-cache-busting.js";
+import { hasPendingAppRouterPageRedirect } from "../server/app-browser-mpa-navigation.js";
 import { ReadonlyURLSearchParams } from "./readonly-url-search-params.js";
-import { AppRouterContext } from "./internal/app-router-context.js";
 import { beginAppRouterScrollIntent, clearAppRouterScrollIntent, consumeAppRouterScrollIntent } from "./app-router-scroll-state.js";
 import { UnrecognizedActionError, unstable_isUnrecognizedActionError } from "./unrecognized-action-error.js";
 import * as React$1 from "react";
@@ -25,6 +27,8 @@ import * as React$1 from "react";
 */
 const _LAYOUT_SEGMENT_CTX_KEY = Symbol.for("vinext.layoutSegmentContext");
 const _SERVER_INSERTED_HTML_CTX_KEY = Symbol.for("vinext.serverInsertedHTMLContext");
+const _BFCACHE_ID_MAP_CTX_KEY = Symbol.for("vinext.bfcacheIdMapContext");
+const _BFCACHE_SEGMENT_ID_CTX_KEY = Symbol.for("vinext.bfcacheSegmentIdContext");
 function getServerInsertedHTMLContext() {
 	if (typeof React$1.createContext !== "function") return null;
 	const globalState = globalThis;
@@ -42,6 +46,18 @@ function getLayoutSegmentContext() {
 	if (!globalState[_LAYOUT_SEGMENT_CTX_KEY]) globalState[_LAYOUT_SEGMENT_CTX_KEY] = React$1.createContext({ children: [] });
 	return globalState[_LAYOUT_SEGMENT_CTX_KEY] ?? null;
 }
+function getBfcacheIdMapContext() {
+	if (typeof React$1.createContext !== "function") return null;
+	const globalState = globalThis;
+	if (!globalState[_BFCACHE_ID_MAP_CTX_KEY]) globalState[_BFCACHE_ID_MAP_CTX_KEY] = React$1.createContext(null);
+	return globalState[_BFCACHE_ID_MAP_CTX_KEY] ?? null;
+}
+function getBfcacheSegmentIdContext() {
+	if (typeof React$1.createContext !== "function") return null;
+	const globalState = globalThis;
+	if (!globalState[_BFCACHE_SEGMENT_ID_CTX_KEY]) globalState[_BFCACHE_SEGMENT_ID_CTX_KEY] = React$1.createContext(null);
+	return globalState[_BFCACHE_SEGMENT_ID_CTX_KEY] ?? null;
+}
 /**
 * Read the child segments for a parallel route below the current layout.
 * Returns [] if no context is available (RSC environment, outside React tree)
@@ -200,6 +216,91 @@ function getPrefetchedUrls() {
 	if (!window.__VINEXT_RSC_PREFETCHED_URLS__) window.__VINEXT_RSC_PREFETCHED_URLS__ = /* @__PURE__ */ new Set();
 	return window.__VINEXT_RSC_PREFETCHED_URLS__;
 }
+function isDynamicStaleTimeSeconds(value) {
+	return typeof value === "number" && Number.isFinite(value) && Number.isInteger(value) && value >= 0;
+}
+function isCacheExpiresAt(value) {
+	return typeof value === "number" && Number.isFinite(value) && value >= 0;
+}
+function parseDynamicStaleTimeSeconds(value) {
+	if (value === null || value === "") return void 0;
+	const seconds = Number(value);
+	return isDynamicStaleTimeSeconds(seconds) ? seconds : void 0;
+}
+function resolveCachedRscResponseTtlMs(cached, fallbackTtlMs) {
+	const seconds = cached.dynamicStaleTimeSeconds;
+	if (!isDynamicStaleTimeSeconds(seconds)) return fallbackTtlMs;
+	return seconds * 1e3;
+}
+function resolveCachedRscResponseExpiresAt(timestamp, cached, fallbackTtlMs) {
+	if (isCacheExpiresAt(cached.expiresAt)) return cached.expiresAt;
+	return timestamp + resolveCachedRscResponseTtlMs(cached, fallbackTtlMs);
+}
+function resolvePrefetchCacheEntryExpiresAt(entry) {
+	if (entry.expiresAt !== void 0) return entry.expiresAt;
+	if (entry.snapshot) return resolveCachedRscResponseExpiresAt(entry.timestamp, entry.snapshot, PREFETCH_CACHE_TTL);
+	return entry.timestamp + PREFETCH_CACHE_TTL;
+}
+function resolvePrefetchCacheEntryMountedSlotsHeader(entry) {
+	if (entry.mountedSlotsHeader !== void 0) return entry.mountedSlotsHeader;
+	return entry.snapshot?.mountedSlotsHeader ?? null;
+}
+function normalizeRscCacheLookupUrl(rscUrl) {
+	try {
+		const url = new URL(rscUrl, "http://vinext.local");
+		stripRscCacheBustingSearchParam(url);
+		return `${url.pathname}${url.search}`;
+	} catch {
+		return null;
+	}
+}
+function parsePrefetchCacheKey(cacheKey) {
+	const separatorIndex = cacheKey.indexOf("\0");
+	if (separatorIndex === -1) return {
+		interceptionContext: null,
+		rscUrl: cacheKey
+	};
+	return {
+		interceptionContext: cacheKey.slice(separatorIndex + 1),
+		rscUrl: cacheKey.slice(0, separatorIndex)
+	};
+}
+function isPrefetchCacheEntryCompatibleWithMountedSlots(entry, mountedSlotsHeader) {
+	if (resolvePrefetchCacheEntryMountedSlotsHeader(entry) === mountedSlotsHeader) return true;
+	return (entry.snapshot?.mountedSlotsHeader ?? null) === mountedSlotsHeader;
+}
+function findPrefetchCacheEntryForNavigation(rscUrl, interceptionContext, mountedSlotsHeader) {
+	const exactCacheKey = AppElementsWire.encodeCacheKey(rscUrl, interceptionContext);
+	const cache = getPrefetchCache();
+	const exactEntry = cache.get(exactCacheKey);
+	if (exactEntry && exactEntry.cacheForNavigation !== false && isPrefetchCacheEntryCompatibleWithMountedSlots(exactEntry, mountedSlotsHeader)) return {
+		cacheKey: exactCacheKey,
+		entry: exactEntry
+	};
+	const normalizedTarget = normalizeRscCacheLookupUrl(rscUrl);
+	if (normalizedTarget === null) return null;
+	for (const [cacheKey, entry] of cache) {
+		if (cacheKey === exactCacheKey) continue;
+		if (entry.cacheForNavigation === false) continue;
+		const source = parsePrefetchCacheKey(cacheKey);
+		if (source.interceptionContext !== interceptionContext) continue;
+		if (normalizeRscCacheLookupUrl(source.rscUrl) !== normalizedTarget) continue;
+		if (!isPrefetchCacheEntryCompatibleWithMountedSlots(entry, mountedSlotsHeader)) continue;
+		return {
+			cacheKey,
+			entry
+		};
+	}
+	return null;
+}
+function hasPrefetchCacheEntryForNavigation(rscUrl, interceptionContext = null, mountedSlotsHeader = null) {
+	const match = findPrefetchCacheEntryForNavigation(rscUrl, interceptionContext, mountedSlotsHeader);
+	if (match === null) return false;
+	if (match.entry.pending !== void 0) return true;
+	if (resolvePrefetchCacheEntryExpiresAt(match.entry) > Date.now()) return true;
+	deletePrefetchCacheEntry(getPrefetchCache(), getPrefetchedUrls(), match.cacheKey, match.entry, true);
+	return false;
+}
 /**
 * Evict prefetch cache entries if at capacity.
 * First sweeps expired entries, then falls back to FIFO eviction.
@@ -209,7 +310,7 @@ function evictPrefetchCacheIfNeeded() {
 	if (cache.size < 50) return;
 	const now = Date.now();
 	const prefetched = getPrefetchedUrls();
-	for (const [key, entry] of cache) if (now - entry.timestamp >= PREFETCH_CACHE_TTL) deletePrefetchCacheEntry(cache, prefetched, key, entry, true);
+	for (const [key, entry] of cache) if (resolvePrefetchCacheEntryExpiresAt(entry) <= now) deletePrefetchCacheEntry(cache, prefetched, key, entry, true);
 	while (cache.size >= 50) {
 		const oldest = cache.keys().next().value;
 		if (oldest !== void 0) {
@@ -258,8 +359,7 @@ function invalidatePrefetchCacheEntry(cacheKey) {
 function schedulePrefetchInvalidation(cacheKey, entry) {
 	if (entry.onInvalidateCallbacks === void 0 || entry.onInvalidateCallbacks.size === 0) return;
 	clearPrefetchInvalidation(entry);
-	const elapsed = Date.now() - entry.timestamp;
-	const delay = Math.max(0, PREFETCH_CACHE_TTL - elapsed);
+	const delay = Math.max(0, resolvePrefetchCacheEntryExpiresAt(entry) - Date.now());
 	entry.invalidationTimer = setTimeout(() => {
 		invalidatePrefetchCacheEntry(cacheKey);
 	}, delay);
@@ -303,12 +403,15 @@ function storePrefetchResponse(rscUrl, response, interceptionContext = null, opt
 	const cacheKey = AppElementsWire.encodeCacheKey(rscUrl, interceptionContext);
 	evictPrefetchCacheIfNeeded();
 	const entry = {
+		mountedSlotsHeader: null,
 		outcome: "pending",
 		timestamp: Date.now()
 	};
 	addPrefetchInvalidationCallback(entry, options?.onInvalidate);
 	entry.pending = snapshotRscResponse(response).then((snapshot) => {
+		entry.mountedSlotsHeader = snapshot.mountedSlotsHeader ?? null;
 		entry.snapshot = snapshot;
+		entry.expiresAt = resolveCachedRscResponseExpiresAt(entry.timestamp, snapshot, PREFETCH_CACHE_TTL);
 	}).catch(() => {
 		deletePrefetchCacheEntry(getPrefetchCache(), getPrefetchedUrls(), cacheKey, entry, false);
 	}).finally(() => {
@@ -321,10 +424,12 @@ function storePrefetchResponse(rscUrl, response, interceptionContext = null, opt
 	getPrefetchCache().set(cacheKey, entry);
 }
 function createCachedRscResponseSnapshot(response, buffer, responseUrl = null) {
+	const dynamicStaleTimeSeconds = parseDynamicStaleTimeSeconds(response.headers.get(VINEXT_DYNAMIC_STALE_TIME_HEADER));
 	return {
 		compatibilityIdHeader: response.headers.get(VINEXT_RSC_COMPATIBILITY_ID_HEADER),
 		buffer,
 		contentType: response.headers.get("content-type") ?? "text/x-component",
+		...dynamicStaleTimeSeconds !== void 0 ? { dynamicStaleTimeSeconds } : {},
 		mountedSlotsHeader: response.headers.get(VINEXT_MOUNTED_SLOTS_HEADER),
 		paramsHeader: response.headers.get(VINEXT_PARAMS_HEADER),
 		url: responseUrl ?? response.url
@@ -356,6 +461,7 @@ function restoreRscResponse(cached, copy = true) {
 	const headers = new Headers({ "content-type": cached.contentType });
 	if (cached.mountedSlotsHeader != null) headers.set(VINEXT_MOUNTED_SLOTS_HEADER, cached.mountedSlotsHeader);
 	if (cached.compatibilityIdHeader != null) headers.set(VINEXT_RSC_COMPATIBILITY_ID_HEADER, cached.compatibilityIdHeader);
+	if (isDynamicStaleTimeSeconds(cached.dynamicStaleTimeSeconds)) headers.set(VINEXT_DYNAMIC_STALE_TIME_HEADER, String(cached.dynamicStaleTimeSeconds));
 	if (cached.paramsHeader != null) headers.set(VINEXT_PARAMS_HEADER, cached.paramsHeader);
 	return new Response(copy ? cached.buffer.slice(0) : cached.buffer, {
 		status: 200,
@@ -376,17 +482,17 @@ function prefetchRscResponse(rscUrl, fetchPromise, interceptionContext = null, m
 	const now = Date.now();
 	const entry = {
 		cacheForNavigation: behavior.cacheForNavigation ?? true,
+		mountedSlotsHeader,
 		optimisticRouteShell: behavior.optimisticRouteShell === true,
 		outcome: "pending",
 		timestamp: now
 	};
 	addPrefetchInvalidationCallback(entry, options?.onInvalidate);
 	entry.pending = fetchPromise.then(async (response) => {
-		if (response.ok) entry.snapshot = {
-			...await snapshotRscResponse(response),
-			mountedSlotsHeader
-		};
-		else deletePrefetchCacheEntry(cache, prefetched, cacheKey, entry, false);
+		if (response.ok) {
+			entry.snapshot = await snapshotRscResponse(response);
+			entry.expiresAt = resolveCachedRscResponseExpiresAt(entry.timestamp, entry.snapshot, PREFETCH_CACHE_TTL);
+		} else deletePrefetchCacheEntry(cache, prefetched, cacheKey, entry, false);
 	}).catch(() => {
 		deletePrefetchCacheEntry(cache, prefetched, cacheKey, entry, false);
 	}).finally(() => {
@@ -405,20 +511,39 @@ function prefetchRscResponse(rscUrl, fetchPromise, interceptionContext = null, m
 * Returns null if the entry is still in flight or doesn't exist.
 */
 function consumePrefetchResponse(rscUrl, interceptionContext = null, mountedSlotsHeader = null) {
-	const cacheKey = AppElementsWire.encodeCacheKey(rscUrl, interceptionContext);
 	const cache = getPrefetchCache();
-	const entry = cache.get(cacheKey);
-	if (!entry) return null;
+	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);
+	if (!match) return null;
+	const { cacheKey, entry } = match;
 	if (entry.pending || entry.outcome !== "cache-seeded") return null;
 	if (entry.cacheForNavigation === false) return null;
 	deletePrefetchCacheEntry(cache, getPrefetchedUrls(), cacheKey, entry, false);
 	if (entry.snapshot) {
-		if ((entry.snapshot.mountedSlotsHeader ?? null) !== mountedSlotsHeader) return null;
-		if (Date.now() - entry.timestamp >= PREFETCH_CACHE_TTL) return null;
+		if (!isPrefetchCacheEntryCompatibleWithMountedSlots(entry, mountedSlotsHeader)) return null;
+		if (resolvePrefetchCacheEntryExpiresAt(entry) <= Date.now()) return null;
+		if (entry.expiresAt !== void 0 || entry.snapshot.expiresAt !== void 0) return {
+			...entry.snapshot,
+			expiresAt: resolvePrefetchCacheEntryExpiresAt(entry)
+		};
 		return entry.snapshot;
 	}
 	return null;
 }
+async function consumePrefetchResponseForNavigation(rscUrl, interceptionContext = null, mountedSlotsHeader = null, options) {
+	const cache = getPrefetchCache();
+	const match = findPrefetchCacheEntryForNavigation(rscUrl, interceptionContext, mountedSlotsHeader);
+	if (!match) return null;
+	const { cacheKey, entry } = match;
+	if (entry.pending !== void 0) {
+		await entry.pending.catch(() => {});
+		if (cache.get(cacheKey) !== entry) return null;
+	}
+	if (options?.shouldConsume?.() === false) return null;
+	return consumePrefetchResponse(rscUrl, interceptionContext, mountedSlotsHeader);
+}
 const _CLIENT_NAV_STATE_KEY = Symbol.for("vinext.clientNavigationState");
 const _MOUNTED_SLOTS_HEADER_KEY = Symbol.for("vinext.mountedSlotsHeader");
 function setMountedSlotsHeader(header) {
@@ -617,9 +742,9 @@ function clearPendingPathname(navId) {
 }
 function getClientParamsSnapshot() {
 	const state = getClientNavigationState();
-	if (state && Object.keys(state.clientParams).length > 0) return state.clientParams;
 	const pagesCtx = _getPagesNavigationContext();
 	if (pagesCtx) return pagesCtx.params;
+	if (state && Object.keys(state.clientParams).length > 0) return state.clientParams;
 	return state?.clientParams ?? _EMPTY_PARAMS;
 }
 function getServerParamsSnapshot() {
@@ -720,10 +845,7 @@ function commitClientNavigationState(navId, options) {
 	}
 	const shouldNotify = urlChanged || state.hasPendingNavigationUpdate;
 	state.hasPendingNavigationUpdate = false;
-	if (shouldNotify) {
-		notifyNavigationListeners();
-		getNavigationRuntime()?.functions.pingVisibleLinks?.();
-	}
+	if (shouldNotify) notifyNavigationListeners();
 }
 function pushHistoryStateWithoutNotify(data, unused, url) {
 	withSuppressedUrlNotifications(() => {
@@ -755,8 +877,9 @@ function commitHashOnlyHistoryState(href, mode, scroll) {
 		commitAppRouterHashNavigation(href, mode, scroll);
 		return;
 	}
-	if (mode === "replace") replaceHistoryStateWithoutNotify(null, "", href);
-	else pushHistoryStateWithoutNotify(null, "", href);
+	const historyState = createHashOnlyHistoryStatePreservingNavigationMetadata(window.history.state);
+	if (mode === "replace") replaceHistoryStateWithoutNotify(historyState, "", href);
+	else pushHistoryStateWithoutNotify(historyState, "", href);
 }
 function applyAppRouterScrollFallback(intent) {
 	if (typeof document === "undefined" || typeof window === "undefined") return;
@@ -786,14 +909,8 @@ function restoreScrollPosition(state) {
 		const { __vinext_scrollX: x, __vinext_scrollY: y } = state;
 		Promise.resolve().then(() => {
 			const pending = window.__VINEXT_RSC_PENDING__ ?? null;
-			if (pending) pending.then(() => {
-				requestAnimationFrame(() => {
-					window.scrollTo(x, y);
-				});
-			});
-			else requestAnimationFrame(() => {
-				window.scrollTo(x, y);
-			});
+			if (pending) pending.then(() => retryScrollTo(x, y));
+			else retryScrollTo(x, y);
 		});
 	}
 }
@@ -805,8 +922,15 @@ async function navigateClientSide(href, mode, scroll, programmaticTransition = f
 	if (isExternalUrl(href)) {
 		const localPath = toSameOriginAppPath(href, __basePath);
 		if (localPath == null) {
+			notifyAppRouterTransitionStart(href, mode);
+			const externalNavigate = getNavigationRuntime()?.functions.navigateExternal;
+			if (externalNavigate) {
+				await externalNavigate(href, mode);
+				return;
+			}
 			if (mode === "replace") window.location.replace(href);
 			else window.location.assign(href);
+			await new Promise(() => {});
 			return;
 		}
 		normalizedHref = localPath;
@@ -821,6 +945,17 @@ async function navigateClientSide(href, mode, scroll, programmaticTransition = f
 		if (scroll) scrollToHashTarget(hash);
 		return;
 	}
+	if (hasPendingAppRouterPageRedirect(typeof document === "undefined" ? void 0 : document)) {
+		const mpaNavigate = getNavigationRuntime()?.functions.navigateExternal;
+		if (mpaNavigate) {
+			await mpaNavigate(fullHref, mode);
+			return;
+		}
+		if (mode === "replace") window.location.replace(fullHref);
+		else window.location.assign(fullHref);
+		await new Promise(() => {});
+		return;
+	}
 	const hashIdx = fullHref.indexOf("#");
 	const hash = hashIdx !== -1 ? fullHref.slice(hashIdx) : "";
 	const scrollIntent = scroll ? beginAppRouterScrollIntent(hash || null) : null;
@@ -859,13 +994,15 @@ function releaseScheduledAppRouterNavigationAfterCurrentTask(release) {
 	queueMicrotask(release);
 }
 /**
-* Public App Router instance, exposed for the browser entry so it can wire
-* `window.next.router` to the same singleton returned from `useRouter()`.
+* App Router public router instance. Mirrors Next.js's
+* `publicAppRouterInstance` from
+* `packages/next/src/client/components/app-router-instance.ts`.
 *
-* Mirrors `publicAppRouterInstance` from Next.js's
-* `packages/next/src/client/components/app-router-instance.ts` (line 392).
+* Exported so the App Router browser entry can install it on
+* `window.next.router` for Next.js parity (see `client/window-next.ts`).
+* Internal callers in this file continue to use `_appRouter` for brevity.
 */
-const appRouterInstance = {
+const _appRouter = {
 	bfcacheId: "0",
 	push(href, options) {
 		assertSafeNavigationUrl(href);
@@ -953,19 +1090,47 @@ const appRouterInstance = {
 		});
 	}
 };
+function formatPublicBfcacheId(value) {
+	if (!value || value === "0") return PUBLIC_INITIAL_BFCACHE_ID;
+	return value;
+}
+function readBfcacheIdFromContext() {
+	const segmentContext = getBfcacheSegmentIdContext();
+	const idMapContext = getBfcacheIdMapContext();
+	if (!segmentContext || !idMapContext || typeof React$1.useContext !== "function") return formatPublicBfcacheId(null);
+	try {
+		const segmentId = React$1.useContext(segmentContext);
+		const idMap = React$1.useContext(idMapContext);
+		return formatPublicBfcacheId(segmentId !== null ? idMap?.[segmentId] : null);
+	} catch (error) {
+		if (process.env.NODE_ENV !== "production") console.warn("[vinext] readBfcacheIdFromContext failed:", error);
+		return formatPublicBfcacheId(null);
+	}
+}
+/**
+* Public App Router instance, exposed for the browser entry so it can wire
+* `window.next.router` to the same singleton returned from `useRouter()`.
+*
+* Mirrors `publicAppRouterInstance` from Next.js's
+* `packages/next/src/client/components/app-router-instance.ts` (line 392).
+*/
+const appRouterInstance = _appRouter;
 /**
 * App Router's useRouter — returns push/replace/back/forward/refresh.
 * Different from Pages Router's useRouter (next/router).
 *
-* Returns a stable singleton: the same object reference on every call,
-* matching Next.js behavior so components using referential equality
-* (e.g. useMemo / useEffect deps, React.memo) don't re-render unnecessarily.
+* Preserves the mounted AppRouterContext router as the authority for methods
+* and layers the nearest segment's contextual `bfcacheId` on top.
 */
 function useRouter() {
-	if (!AppRouterContext || typeof React$1.useContext !== "function") throw new Error("invariant expected app router to be mounted");
+	if (!AppRouterContext || typeof React$1.useContext !== "function" || typeof React$1.useMemo !== "function") throw new Error("invariant expected app router to be mounted");
 	const router = React$1.useContext(AppRouterContext);
 	if (router === null) throw new Error("invariant expected app router to be mounted");
-	return router;
+	const bfcacheId = readBfcacheIdFromContext();
+	return React$1.useMemo(() => ({
+		...router,
+		bfcacheId
+	}), [router, bfcacheId]);
 }
 /**
 * Returns the active child segment one level below the layout where it's called.
@@ -1186,10 +1351,44 @@ function unauthorized() {
 * `shims/error-boundary.tsx`.
 */
 function isRedirectError(error) {
-	if (!error || typeof error !== "object" || !("digest" in error) || typeof error.digest !== "string") return false;
+	if (!error || typeof error !== "object") return false;
+	if (!("digest" in error)) return false;
+	if (typeof error.digest !== "string") return false;
 	return error.digest.startsWith("NEXT_REDIRECT;");
 }
 /**
+* Parse a redirect error digest into its URL and type components.
+*
+* Supports two formats:
+*   - vinext's 3-part: `NEXT_REDIRECT;{type};{encoded-url}`
+*   - Next.js's 5-part: `NEXT_REDIRECT;{type};{url};{status};{isClient}`
+*
+* The URL segment is always percent-encoded on the write side
+* (encodeURIComponent is used), so re-joining with ";" for the 5-part
+* format is defensive — it correctly handles any unencoded ";" that
+* might appear in an externally-sourced digest.
+*
+* Returns null for malformed digests that have an empty URL segment, or
+* when the URL contains invalid percent-encoding.
+*/
+function decodeRedirectError(digest) {
+	if (!digest.startsWith("NEXT_REDIRECT;")) return null;
+	const parts = digest.split(";");
+	const encodedTarget = parts.length >= 5 ? parts.slice(2, -2).join(";") : parts[2];
+	if (!encodedTarget) return null;
+	let url;
+	try {
+		url = decodeURIComponent(encodedTarget);
+	} catch {
+		return null;
+	}
+	const type = parts[1] === "push" ? "push" : "replace";
+	return {
+		url,
+		type
+	};
+}
+/**
 * Returns true if the error is a Next.js navigation signal — either a redirect
 * or an HTTP access fallback (notFound / forbidden / unauthorized).
 *
@@ -1330,6 +1529,4 @@ if (!isServer) {
 	}
 }
 //#endregion
-export { BailoutToCSRError, DynamicServerError, GLOBAL_ACCESSORS_KEY, HTTP_ERROR_FALLBACK_ERROR_CODE, MAX_PREFETCH_CACHE_SIZE, PREFETCH_CACHE_TTL, ReadonlyURLSearchParams, RedirectType, ServerInsertedHTMLContext, UnrecognizedActionError, __basePath, _registerStateAccessors, activateNavigationSnapshot, appRouterInstance, clearPendingPathname, clearServerInsertedHTML, commitClientNavigationState, consumePrefetchResponse, createCachedRscResponseSnapshot, createClientNavigationRenderSnapshot, flushServerInsertedHTML, forbidden, getAccessFallbackHTTPStatus, getClientNavigationRenderContext, getClientNavigationState, getClientParams, getCurrentInterceptionContext, getCurrentNextUrl, getLayoutSegmentContext, getMountedSlotsHeader, getNavigationContext, getPrefetchCache, getPrefetchInterceptionContext, getPrefetchedUrls, invalidatePrefetchCache, isBailoutToCSRError, isDynamicServerError, isHTTPAccessFallbackError, isNextRouterError, isRedirectError, navigateClientSide, notFound, permanentRedirect, prefetchRscResponse, pushHistoryStateWithoutNotify, redirect, renderServerInsertedHTML, replaceClientParamsWithoutNotify, replaceHistoryStateWithoutNotify, restoreRscResponse, setClientParams, setMountedSlotsHeader, setNavigationContext, setPendingPathname, snapshotRscResponse, storePrefetchResponse, unauthorized, unstable_isUnrecognizedActionError, unstable_rethrow, useParams, usePathname, useRouter, useSearchParams, useSelectedLayoutSegment, useSelectedLayoutSegments, useServerInsertedHTML };
-
-//# sourceMappingURL=navigation.js.map
+export { BailoutToCSRError, DynamicServerError, GLOBAL_ACCESSORS_KEY, HTTP_ERROR_FALLBACK_ERROR_CODE, MAX_PREFETCH_CACHE_SIZE, PREFETCH_CACHE_TTL, ReadonlyURLSearchParams, RedirectType, ServerInsertedHTMLContext, UnrecognizedActionError, __basePath, _registerStateAccessors, activateNavigationSnapshot, appRouterInstance, clearPendingPathname, clearServerInsertedHTML, commitClientNavigationState, consumePrefetchResponse, consumePrefetchResponseForNavigation, createCachedRscResponseSnapshot, createClientNavigationRenderSnapshot, decodeRedirectError, flushServerInsertedHTML, forbidden, getAccessFallbackHTTPStatus, getBfcacheIdMapContext, getBfcacheSegmentIdContext, getClientNavigationRenderContext, getClientNavigationState, getClientParams, getCurrentInterceptionContext, getCurrentNextUrl, getLayoutSegmentContext, getMountedSlotsHeader, getNavigationContext, getPrefetchCache, getPrefetchInterceptionContext, getPrefetchedUrls, hasPrefetchCacheEntryForNavigation, invalidatePrefetchCache, isBailoutToCSRError, isDynamicServerError, isHTTPAccessFallbackError, isNextRouterError, isRedirectError, navigateClientSide, notFound, permanentRedirect, prefetchRscResponse, pushHistoryStateWithoutNotify, redirect, renderServerInsertedHTML, replaceClientParamsWithoutNotify, replaceHistoryStateWithoutNotify, resolveCachedRscResponseExpiresAt, resolveCachedRscResponseTtlMs, resolvePrefetchCacheEntryMountedSlotsHeader, restoreRscResponse, saveScrollPosition, setClientParams, setMountedSlotsHeader, setNavigationContext, setPendingPathname, snapshotRscResponse, storePrefetchResponse, unauthorized, unstable_isUnrecognizedActionError, unstable_rethrow, useParams, usePathname, useRouter, useSearchParams, useSelectedLayoutSegment, useSelectedLayoutSegments, useServerInsertedHTML };

package/dist/shims/navigation.react-server.d.ts

@@ -11,5 +11,4 @@ declare function useSelectedLayoutSegments(): never;
 declare function useServerInsertedHTML(): never;
 declare function unstable_isUnrecognizedActionError(): boolean;
 //#endregion
-export { BailoutToCSRError, DynamicServerError, GLOBAL_ACCESSORS_KEY, HTTP_ERROR_FALLBACK_ERROR_CODE, type NavigationContext, ReadonlyURLSearchParams, RedirectType, type SegmentMap, ServerInsertedHTMLContext, _registerStateAccessors, clearServerInsertedHTML, flushServerInsertedHTML, forbidden, getAccessFallbackHTTPStatus, getLayoutSegmentContext, getNavigationContext, isBailoutToCSRError, isDynamicServerError, isHTTPAccessFallbackError, isNextRouterError, isRedirectError, notFound, permanentRedirect, redirect, renderServerInsertedHTML, setNavigationContext, unauthorized, unstable_isUnrecognizedActionError, unstable_rethrow, useParams, usePathname, useRouter, useSearchParams, useSelectedLayoutSegment, useSelectedLayoutSegments, useServerInsertedHTML };
-//# sourceMappingURL=navigation.react-server.d.ts.map
+export { BailoutToCSRError, DynamicServerError, GLOBAL_ACCESSORS_KEY, HTTP_ERROR_FALLBACK_ERROR_CODE, type NavigationContext, ReadonlyURLSearchParams, RedirectType, type SegmentMap, ServerInsertedHTMLContext, _registerStateAccessors, clearServerInsertedHTML, flushServerInsertedHTML, forbidden, getAccessFallbackHTTPStatus, getLayoutSegmentContext, getNavigationContext, isBailoutToCSRError, isDynamicServerError, isHTTPAccessFallbackError, isNextRouterError, isRedirectError, notFound, permanentRedirect, redirect, renderServerInsertedHTML, setNavigationContext, unauthorized, unstable_isUnrecognizedActionError, unstable_rethrow, useParams, usePathname, useRouter, useSearchParams, useSelectedLayoutSegment, useSelectedLayoutSegments, useServerInsertedHTML };

package/dist/shims/navigation.react-server.js

@@ -28,5 +28,3 @@ function unstable_isUnrecognizedActionError() {
 }
 //#endregion
 export { BailoutToCSRError, DynamicServerError, GLOBAL_ACCESSORS_KEY, HTTP_ERROR_FALLBACK_ERROR_CODE, ReadonlyURLSearchParams, RedirectType, ServerInsertedHTMLContext, _registerStateAccessors, clearServerInsertedHTML, flushServerInsertedHTML, forbidden, getAccessFallbackHTTPStatus, getLayoutSegmentContext, getNavigationContext, isBailoutToCSRError, isDynamicServerError, isHTTPAccessFallbackError, isNextRouterError, isRedirectError, notFound, permanentRedirect, redirect, renderServerInsertedHTML, setNavigationContext, unauthorized, unstable_isUnrecognizedActionError, unstable_rethrow, useParams, usePathname, useRouter, useSearchParams, useSelectedLayoutSegment, useSelectedLayoutSegments, useServerInsertedHTML };
-
-//# sourceMappingURL=navigation.react-server.js.map

package/dist/shims/offline.d.ts

@@ -1,5 +1,4 @@
 //#region src/shims/offline.d.ts
 declare function useOffline(): boolean;
 //#endregion
-export { useOffline };
-//# sourceMappingURL=offline.d.ts.map
+export { useOffline };

package/dist/shims/offline.js

@@ -13,5 +13,3 @@ function useOffline() {
 }
 //#endregion
 export { useOffline };
-
-//# sourceMappingURL=offline.js.map

package/dist/shims/og.d.ts

@@ -14,5 +14,4 @@ declare class ImageResponse extends Response {
   constructor(element: ReactElement, options?: ImageResponseOptions$1);
 }
 //#endregion
-export { ImageResponse, type ImageResponseOptions };
-//# sourceMappingURL=og.d.ts.map
+export { ImageResponse, type ImageResponseOptions };

package/dist/shims/og.js

@@ -1,4 +1,3 @@
-import { ImageResponse as ImageResponse$1 } from "@vercel/og";
 //#region src/shims/og.tsx
 const CACHE_HEADERS = {
 	noCache: "no-cache, no-store",
@@ -15,7 +14,8 @@ var ImageResponse = class extends Response {
 	static displayName = "ImageResponse";
 	constructor(element, options) {
 		const readable = new ReadableStream({ async start(controller) {
-			const imageResponse = new ImageResponse$1(element, options);
+			const { ImageResponse: VercelImageResponse } = await import("@vercel/og");
+			const imageResponse = new VercelImageResponse(element, options);
 			if (!imageResponse.body) {
 				controller.close();
 				return;
@@ -46,5 +46,3 @@ var ImageResponse = class extends Response {
 };
 //#endregion
 export { ImageResponse };
-
-//# sourceMappingURL=og.js.map

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

@@ -1,7 +1,12 @@
 //#region src/shims/pages-router-runtime.d.ts
 type PagesRouterPopStateHandler = (event: PopStateEvent) => void;
 declare function setPagesRouterPopStateHandler(handler: PagesRouterPopStateHandler): void;
+/**
+ * Register the function that stamps Next.js-shaped state onto the initial
+ * document entry (called once at install time). Router.ts registers this so
+ * the runtime module stays free of router internals.
+ */
+declare function setStampInitialHistoryState(fn: () => void): void;
 declare function installPagesRouterRuntime(): void;
 //#endregion
-export { installPagesRouterRuntime, setPagesRouterPopStateHandler };
-//# sourceMappingURL=pages-router-runtime.d.ts.map
+export { installPagesRouterRuntime, setPagesRouterPopStateHandler, setStampInitialHistoryState };

package/dist/shims/pages-router-runtime.js

@@ -1,16 +1,24 @@
 //#region src/shims/pages-router-runtime.ts
 let pagesRouterPopStateHandler;
+let stampInitialHistoryStateFn;
 let pagesRouterRuntimeInstalled = false;
 function setPagesRouterPopStateHandler(handler) {
 	pagesRouterPopStateHandler = handler;
 }
+/**
+* Register the function that stamps Next.js-shaped state onto the initial
+* document entry (called once at install time). Router.ts registers this so
+* the runtime module stays free of router internals.
+*/
+function setStampInitialHistoryState(fn) {
+	stampInitialHistoryStateFn = fn;
+}
 function installPagesRouterRuntime() {
 	if (typeof window === "undefined" || pagesRouterRuntimeInstalled) return;
 	if (!pagesRouterPopStateHandler) throw new Error("[vinext] Pages Router runtime installed before next/router was initialized");
 	pagesRouterRuntimeInstalled = true;
+	stampInitialHistoryStateFn?.();
 	window.addEventListener("popstate", pagesRouterPopStateHandler);
 }
 //#endregion
-export { installPagesRouterRuntime, setPagesRouterPopStateHandler };
-
-//# sourceMappingURL=pages-router-runtime.js.map
+export { installPagesRouterRuntime, setPagesRouterPopStateHandler, setStampInitialHistoryState };

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

@@ -0,0 +1,29 @@
+//#region src/shims/ppr-fallback-shell.d.ts
+type PprFallbackShellState = {
+  abortController: AbortController;
+  cacheEpoch: number;
+  cacheReadyResolvers: Array<() => void>;
+  fallbackParamNames: ReadonlySet<string>;
+  hasDynamicBoundary: boolean;
+  isAbortScheduled: boolean;
+  pendingAbortCleanup: (() => void) | null;
+  pendingCacheReadyCleanup: (() => void) | null;
+  pendingCacheTasks: number;
+  phase: "warmup" | "final";
+  routePattern: string;
+};
+type CreatePprFallbackShellStateOptions = {
+  fallbackParamNames: readonly string[];
+  routePattern: string;
+};
+declare function createPprFallbackShellState(options: CreatePprFallbackShellStateOptions): PprFallbackShellState;
+declare function runWithPprFallbackShellState<T>(state: PprFallbackShellState, fn: () => T): T;
+declare function getPprFallbackShellState(): PprFallbackShellState | null;
+declare function trackPprFallbackShellCacheTask<T>(fn: () => Promise<T>, cacheVariant: string): Promise<T>;
+declare function createPprFallbackShellSuspensePromiseForState<T>(state: PprFallbackShellState, expression: string): Promise<T>;
+declare function createPprFallbackShellSuspensePromise<T>(expression: string): Promise<T> | null;
+declare function waitForPprFallbackShellCacheReady(state: PprFallbackShellState): Promise<void>;
+declare function preparePprFallbackShellFinalRender(state: PprFallbackShellState): void;
+declare function isPprFallbackShellAbortError(error: unknown): boolean;
+//#endregion
+export { PprFallbackShellState, createPprFallbackShellState, createPprFallbackShellSuspensePromise, createPprFallbackShellSuspensePromiseForState, getPprFallbackShellState, isPprFallbackShellAbortError, preparePprFallbackShellFinalRender, runWithPprFallbackShellState, trackPprFallbackShellCacheTask, waitForPprFallbackShellCacheReady };