vinext 0.1.2 → 0.1.4

package/dist/shims/cache.d.ts

@@ -53,6 +53,7 @@ type CachedPagesValue = {
   kind: "PAGES";
   html: string;
   pageData: object;
+  generatedFromDataRequest?: boolean;
   headers: Record<string, string | string[]> | undefined;
   status: number | undefined;
 };

package/dist/shims/cache.js

@@ -1,10 +1,10 @@
 import { getOrCreateAls } from "./internal/als-registry.js";
 import { getRequestContext, isInsideUnifiedScope, runWithUnifiedStateMutation } from "./unified-request-context.js";
 import { getRequestExecutionContext, runWithExecutionContext } from "./request-context.js";
+import { makeHangingPromise } from "./internal/make-hanging-promise.js";
 import { getHeadersAccessPhase, markDynamicUsage } from "./headers.js";
 import { fnv1a64 } from "../utils/hash.js";
 import { workUnitAsyncStorage } from "./internal/work-unit-async-storage.js";
-import { makeHangingPromise } from "./internal/make-hanging-promise.js";
 import { readCacheControlNumberField } from "../utils/cache-control-metadata.js";
 import { encodeCacheTag, encodeCacheTags } from "../utils/encode-cache-tag.js";
 import { getCdnCacheAdapter } from "./cdn-cache.js";

package/dist/shims/cdn-cache.d.ts

@@ -1,8 +1,8 @@
 import { CacheHandlerValue, IncrementalCacheValue } from "./cache.js";
 
 //#region src/shims/cdn-cache.d.ts
-/** A map of response header name -> value the adapter wants applied. */
-type CdnResponseHeaders = Record<string, string>;
+/** A map of response header name -> value the adapter wants applied or removed. */
+type CdnResponseHeaders = Record<string, string | null>;
 type CdnCacheableHeaderInput = {
   /**
    * The cacheable `Cache-Control` value the framework computed for shared
@@ -50,9 +50,9 @@ type CdnCacheAdapter = {
    */
   set(key: string, data: IncrementalCacheValue | null, ctx?: Record<string, unknown>): Promise<void>;
   /**
-   * Build the response cache headers for a given cacheable policy. Returns a map
-   * so an adapter can emit more than one header (e.g. `Cache-Control` +
-   * `CDN-Cache-Control`).
+   * Build the response cache headers for a given policy. Returns a map so an
+   * adapter can emit more than one header (e.g. `Cache-Control` +
+   * `CDN-Cache-Control`) and remove stale adapter-owned headers with `null`.
    */
   buildResponseHeaders(input: CdnCacheableHeaderInput): CdnResponseHeaders;
   /**

package/dist/shims/document.d.ts

@@ -34,25 +34,23 @@ declare function Main(): React.JSX.Element;
  */
 declare function NextScript(): React.JSX.Element;
 /**
- * Loose stand-ins for Next.js's `DocumentContext` / `DocumentInitialProps`.
- * The shim doesn't currently invoke `getInitialProps` on user `_document.tsx`
- * files (separate gap), but the signatures here match Next.js's so subclasses
- * that delegate via `await Document.getInitialProps(ctx)` typecheck against
- * the same shape they'd see under real Next.js.
+ * Stand-ins for Next.js's `DocumentContext` / `DocumentInitialProps`.
+ * The signatures match Next.js so custom `_document.tsx` subclasses can use
+ * `ctx.renderPage()` enhancers and delegate through
+ * `await Document.getInitialProps(ctx)` with the expected public types.
  *
  * @see https://github.com/vercel/next.js/blob/canary/packages/next/src/shared/lib/utils.ts
  */
 type DocumentContext = {
-  renderPage?: (options?: {
+  renderPage: (options?: {
     enhanceApp?: (App: React.ComponentType<{
       children?: React.ReactNode;
-    }>) => unknown;
-    enhanceComponent?: (Comp: React.ComponentType<unknown>) => unknown;
-  }) => {
-    html: string;
-    head?: ReadonlyArray<React.ReactElement>;
-  };
-  defaultGetInitialProps?: (ctx: DocumentContext, options?: {
+    }>) => React.ComponentType<{
+      children?: React.ReactNode;
+    }>;
+    enhanceComponent?: (Comp: React.ComponentType<unknown>) => React.ComponentType<unknown>;
+  } | ((Comp: React.ComponentType<unknown>) => React.ComponentType<unknown>)) => DocumentInitialProps | Promise<DocumentInitialProps>;
+  defaultGetInitialProps: (ctx: DocumentContext, options?: {
     nonce?: string;
   }) => Promise<DocumentInitialProps>;
   pathname?: string;
@@ -83,14 +81,11 @@ declare class Document<P = {}> extends React.Component<P & {
   children?: React.ReactNode;
 }> {
   /**
-   * `getInitialProps` is invoked by the SSR pipeline. The default implementation
-   * is a stub: vinext does not yet plumb the Pages Router `renderPage` /
-   * `defaultGetInitialProps` chain into the SSR entry, so subclasses that
-   * delegate via `await Document.getInitialProps(ctx)` receive an empty shell
-   * (`html: ""`). This matches the runtime contract user code expects without
-   * pretending the chain is wired up.
+   * `getInitialProps` is invoked by the SSR pipeline. The runtime-provided
+   * `ctx.defaultGetInitialProps()` owns the page render and style collection,
+   * matching Next.js's canonical CSS-in-JS integration path.
    */
-  static getInitialProps(_ctx: DocumentContext): Promise<DocumentInitialProps>;
+  static getInitialProps(ctx: DocumentContext): Promise<DocumentInitialProps>;
   render(): React.ReactNode;
 }
 //#endregion

package/dist/shims/document.js

@@ -61,15 +61,12 @@ function NextScript() {
 */
 var Document = class extends React.Component {
 	/**
-	* `getInitialProps` is invoked by the SSR pipeline. The default implementation
-	* is a stub: vinext does not yet plumb the Pages Router `renderPage` /
-	* `defaultGetInitialProps` chain into the SSR entry, so subclasses that
-	* delegate via `await Document.getInitialProps(ctx)` receive an empty shell
-	* (`html: ""`). This matches the runtime contract user code expects without
-	* pretending the chain is wired up.
+	* `getInitialProps` is invoked by the SSR pipeline. The runtime-provided
+	* `ctx.defaultGetInitialProps()` owns the page render and style collection,
+	* matching Next.js's canonical CSS-in-JS integration path.
 	*/
-	static async getInitialProps(_ctx) {
-		return { html: "" };
+	static getInitialProps(ctx) {
+		return ctx.defaultGetInitialProps(ctx);
 	}
 	render() {
 		return /* @__PURE__ */ jsxs(Html, { children: [/* @__PURE__ */ jsx(Head, {}), /* @__PURE__ */ jsxs("body", { children: [/* @__PURE__ */ jsx(Main, {}), /* @__PURE__ */ jsx(NextScript, {})] })] });

package/dist/shims/dynamic-preload-chunks.js

@@ -1,4 +1,5 @@
 "use client";
+import { appendAssetDeploymentIdQuery } from "../utils/deployment-id.js";
 import { useScriptNonce } from "./script-nonce-context.js";
 import React from "react";
 import * as ReactDOM from "react-dom";
@@ -51,8 +52,9 @@ function DynamicPreloadChunks(props) {
 	if (files.length === 0) return null;
 	const stylesheets = [];
 	for (const file of files) {
-		const href = dynamicPreloadHref(file);
-		if (href.endsWith(".css")) {
+		const assetHref = dynamicPreloadHref(file);
+		if (assetHref.endsWith(".css")) {
+			const href = appendAssetDeploymentIdQuery(assetHref);
 			stylesheets.push(React.createElement("link", {
 				key: href,
 				rel: "stylesheet",
@@ -62,13 +64,13 @@ function DynamicPreloadChunks(props) {
 			}));
 			continue;
 		}
-		if (href.endsWith(".js") && typeof ReactDOM.preload === "function") {
+		if (assetHref.endsWith(".js") && typeof ReactDOM.preload === "function") {
 			const preloadOptions = {
 				as: "script",
 				fetchPriority: "low",
 				nonce
 			};
-			ReactDOM.preload(href, preloadOptions);
+			ReactDOM.preload(assetHref, preloadOptions);
 		}
 	}
 	return stylesheets.length > 0 ? React.createElement(React.Fragment, null, ...stylesheets) : null;

package/dist/shims/error-boundary.d.ts

@@ -17,6 +17,7 @@ type RedirectBoundaryState = {
   redirectType: "push" | "replace" | null;
 };
 type ErrorBoundaryInnerProps = {
+  isImplicitRootErrorBoundary?: boolean;
   pathname: string | null;
 } & ErrorBoundaryProps;
 type ErrorBoundaryState = {
@@ -131,6 +132,7 @@ declare function UnauthorizedBoundary({
   resetKey
 }: UnauthorizedBoundaryProps): React.JSX.Element;
 type DevRecoveryBoundaryProps = {
+  isImplicitRootErrorBoundary?: boolean;
   resetKey: number;
   onCatch?: (resetKey: number) => void;
   children?: React.ReactNode;

package/dist/shims/error-boundary.js

@@ -1,5 +1,7 @@
 "use client";
+import { handleAppNavigationFailure } from "../client/app-nav-failure-handler.js";
 import { decodeRedirectError, isRedirectError, usePathname, useRouter } from "./navigation.js";
+import DefaultGlobalError from "./default-global-error.js";
 import { VINEXT_DEV_ERROR_RECOVERY_EVENT } from "../utils/dev-error-recovery-event.js";
 import { isNavigationSignalError } from "../utils/navigation-signal.js";
 import React from "react";
@@ -98,6 +100,10 @@ var ErrorBoundaryInner = class extends React.Component {
 	}
 	static getDerivedStateFromProps(props, state) {
 		const nextResetState = readBoundaryResetState(props);
+		if (state.error && handleAppNavigationFailure(state.error.thrownValue)) return {
+			error: null,
+			...nextResetState
+		};
 		if (state.error && shouldResetBoundary(nextResetState, state)) return {
 			error: null,
 			...nextResetState
@@ -150,6 +156,7 @@ function GlobalErrorBoundary({ fallback, children }) {
 	return /* @__PURE__ */ jsx(ErrorBoundaryInner, {
 		pathname: usePathname(),
 		fallback,
+		isImplicitRootErrorBoundary: fallback === DefaultGlobalError,
 		children
 	});
 }

package/dist/shims/error.js

@@ -1,6 +1,7 @@
 import { AppRouterContext } from "./internal/app-router-context.js";
 import { RouterContext } from "./internal/router-context.js";
-import { isNextRouterError, usePathname } from "./navigation.js";
+import { isNextRouterError } from "./navigation.js";
+import { useUntrackedPathname } from "./internal/navigation-untracked.js";
 import React from "react";
 //#region src/shims/error.tsx
 /**
@@ -104,7 +105,7 @@ function unstable_catchError(fallback) {
 	Fallback.displayName = fallback.name || "CatchErrorFallback";
 	function CatchErrorBoundary(allProps) {
 		const { children, ...rest } = allProps;
-		const pathname = usePathname();
+		const pathname = useUntrackedPathname();
 		const isPagesRouter = React.useContext(RouterContext) !== null;
 		const forwardedProps = rest;
 		return React.createElement(_CatchError, {

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

@@ -0,0 +1,9 @@
+//#region src/shims/error.react-server.d.ts
+type ErrorInfo = {
+  error: unknown;
+  reset: () => void;
+  unstable_retry: () => void;
+};
+declare function unstable_catchError(): never;
+//#endregion
+export { ErrorInfo, unstable_catchError };

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

@@ -0,0 +1,6 @@
+//#region src/shims/error.react-server.ts
+function unstable_catchError() {
+	throw new Error("`unstable_catchError` can only be used in Client Components.");
+}
+//#endregion
+export { unstable_catchError };

package/dist/shims/fetch-cache.d.ts

@@ -40,6 +40,7 @@ type FetchCacheState = {
   currentRequestTags: string[];
   currentFetchSoftTags: string[];
   currentFetchCacheMode: FetchCacheMode | null;
+  currentForceDynamicFetchDefault: boolean;
   dynamicFetchUrls: Set<string>;
   isFetchDedupeActive: boolean;
   currentFetchDedupeEntries: Map<string, FetchDedupeEntry[]>;
@@ -84,6 +85,7 @@ declare function setCurrentFetchSoftTags(tags: string[]): void;
  */
 declare function getCurrentFetchSoftTags(): string[];
 declare function setCurrentFetchCacheMode(mode: FetchCacheMode | null): void;
+declare function setCurrentForceDynamicFetchDefault(enabled: boolean): void;
 /**
  * Install the patched fetch and reset per-request tag state.
  * Returns a cleanup function that clears tags.
@@ -131,4 +133,4 @@ declare function ensureFetchPatch(): void;
  */
 declare function getOriginalFetch(): typeof globalThis.fetch;
 //#endregion
-export { FetchCacheMode, FetchCacheState, _resetPendingRefetches, addCollectedRequestTags, consumeDynamicFetchObservations, ensureFetchPatch, getCollectedFetchTags, getCurrentFetchSoftTags, getOriginalFetch, peekCacheableFetchObservations, peekDynamicFetchObservations, runWithFetchCache, runWithFetchDedupe, setCurrentFetchCacheMode, setCurrentFetchSoftTags, withFetchCache };
+export { FetchCacheMode, FetchCacheState, _resetPendingRefetches, addCollectedRequestTags, consumeDynamicFetchObservations, ensureFetchPatch, getCollectedFetchTags, getCurrentFetchSoftTags, getOriginalFetch, peekCacheableFetchObservations, peekDynamicFetchObservations, runWithFetchCache, runWithFetchDedupe, setCurrentFetchCacheMode, setCurrentFetchSoftTags, setCurrentForceDynamicFetchDefault, withFetchCache };

package/dist/shims/fetch-cache.js

@@ -1,6 +1,7 @@
 import { getOrCreateAls } from "./internal/als-registry.js";
 import { getRequestContext, isInsideUnifiedScope, runWithUnifiedStateMutation } from "./unified-request-context.js";
 import { getRequestExecutionContext } from "./request-context.js";
+import { markDynamicUsage } from "./headers.js";
 import { encodeCacheTags } from "../utils/encode-cache-tag.js";
 import { getDataCacheHandler } from "./cache.js";
 //#region src/shims/fetch-cache.ts
@@ -32,6 +33,7 @@ import { getDataCacheHandler } from "./cache.js";
 const HEADER_BLOCKLIST = ["traceparent", "tracestate"];
 const CACHE_KEY_PREFIX = "v3";
 const MAX_CACHE_KEY_BODY_BYTES = 1024 * 1024;
+const ONE_YEAR_SECONDS = 31536e3;
 var BodyTooLargeForCacheKeyError = class extends Error {
 	constructor() {
 		super("Fetch body too large for cache key generation");
@@ -292,6 +294,7 @@ const _fallbackState = _g[_FALLBACK_KEY] ??= {
 	currentRequestTags: [],
 	currentFetchSoftTags: [],
 	currentFetchCacheMode: null,
+	currentForceDynamicFetchDefault: false,
 	dynamicFetchUrls: /* @__PURE__ */ new Set(),
 	isFetchDedupeActive: false,
 	currentFetchDedupeEntries: /* @__PURE__ */ new Map()
@@ -309,6 +312,7 @@ function _resetFallbackState(isFetchDedupeActive) {
 	_fallbackState.currentRequestTags = [];
 	_fallbackState.currentFetchSoftTags = [];
 	_fallbackState.currentFetchCacheMode = null;
+	_fallbackState.currentForceDynamicFetchDefault = false;
 	_fallbackState.dynamicFetchUrls = /* @__PURE__ */ new Set();
 	_fallbackState.isFetchDedupeActive = isFetchDedupeActive;
 	_fallbackState.currentFetchDedupeEntries = /* @__PURE__ */ new Map();
@@ -319,6 +323,10 @@ function getFetchObservationUrl(input) {
 function recordDynamicFetchObservation(input) {
 	_getState().dynamicFetchUrls.add(getFetchObservationUrl(input));
 }
+function markUncachedFetchForPageOutput(input) {
+	recordDynamicFetchObservation(input);
+	markDynamicUsage();
+}
 function recordCacheableFetchObservation(input) {
 	_getState().cacheableFetchUrls.add(getFetchObservationUrl(input));
 }
@@ -382,16 +390,23 @@ function getCurrentFetchSoftTags() {
 function setCurrentFetchCacheMode(mode) {
 	_getState().currentFetchCacheMode = mode;
 }
+function setCurrentForceDynamicFetchDefault(enabled) {
+	_getState().currentForceDynamicFetchDefault = enabled;
+}
 function isNoStoreFetch(cacheDirective, nextOpts) {
-	return cacheDirective === "no-store" || cacheDirective === "no-cache" || nextOpts?.revalidate === false || nextOpts?.revalidate === 0;
+	return cacheDirective === "no-store" || cacheDirective === "no-cache" || nextOpts?.revalidate === 0;
 }
 function isCacheableFetch(cacheDirective, nextOpts) {
-	return cacheDirective === "force-cache" || typeof nextOpts?.revalidate === "number" && nextOpts.revalidate > 0;
+	return cacheDirective === "force-cache" || nextOpts?.revalidate === false || typeof nextOpts?.revalidate === "number" && nextOpts.revalidate > 0;
 }
 function hasExplicitRevalidateValue(nextOpts) {
 	return nextOpts?.revalidate !== void 0;
 }
-function resolveSegmentCacheDirective(cacheDirective, nextOpts, mode) {
+function isFalsyRevalidate(nextOpts) {
+	return !nextOpts?.revalidate;
+}
+function resolveSegmentCacheDirective(cacheDirective, nextOpts, mode, forceDynamicFetchDefault) {
+	if (forceDynamicFetchDefault && (!mode || mode === "auto") && (cacheDirective === void 0 || cacheDirective === "default") && isFalsyRevalidate(nextOpts)) return "no-store";
 	if (!mode || mode === "auto") return cacheDirective;
 	switch (mode) {
 		case "force-cache": return "force-cache";
@@ -457,6 +472,20 @@ function cloneDedupeResponse(response) {
 	const [body1, body2] = response.body.tee();
 	return [buildDedupeClone(body1, response), buildDedupeClone(body2, response)];
 }
+function buildCachedFetchResponse(data, input) {
+	const response = new Response(data.body, {
+		status: data.status ?? 200,
+		headers: data.headers
+	});
+	Object.defineProperty(response, "url", {
+		value: data.url ?? getFetchObservationUrl(input),
+		configurable: true,
+		enumerable: true,
+		writable: false
+	});
+	if (_responseBodyRegistry && response.body) _responseBodyRegistry.register(response, new WeakRef(response.body));
+	return response;
+}
 function dedupeFetch(input, init) {
 	const state = _getState();
 	if (!state.isFetchDedupeActive) return originalFetch(input, init);
@@ -507,25 +536,26 @@ function dedupeFetch(input, init) {
 function createPatchedFetch() {
 	return async function patchedFetch(input, init) {
 		const nextOpts = init?.next;
-		const cacheDirective = resolveSegmentCacheDirective(getFetchCacheDirective(input, init), nextOpts, _getState().currentFetchCacheMode);
+		const cacheDirective = resolveSegmentCacheDirective(getFetchCacheDirective(input, init), nextOpts, _getState().currentFetchCacheMode, _getState().currentForceDynamicFetchDefault);
 		if (!nextOpts && !cacheDirective) {
 			recordDynamicFetchObservation(input);
 			return dedupeFetch(input, init);
 		}
-		if (cacheDirective === "no-store" || cacheDirective === "no-cache" || nextOpts?.revalidate === false || nextOpts?.revalidate === 0) {
+		if (cacheDirective === "no-store" || cacheDirective === "no-cache" || nextOpts?.revalidate === 0) {
 			const cleanInit = stripNextFromInit(init, cacheDirective);
-			recordDynamicFetchObservation(input);
+			markUncachedFetchForPageOutput(input);
 			return dedupeFetch(input, cleanInit);
 		}
-		if (!(cacheDirective === "force-cache" || typeof nextOpts?.revalidate === "number" && nextOpts.revalidate > 0) && hasAuthHeaders(input, init)) {
+		if (!(cacheDirective === "force-cache" || nextOpts?.revalidate === false || typeof nextOpts?.revalidate === "number" && nextOpts.revalidate > 0) && hasAuthHeaders(input, init)) {
 			const cleanInit = stripNextFromInit(init, cacheDirective);
 			recordDynamicFetchObservation(input);
 			return dedupeFetch(input, cleanInit);
 		}
 		let revalidateSeconds;
-		if (cacheDirective === "force-cache") revalidateSeconds = nextOpts?.revalidate && typeof nextOpts.revalidate === "number" ? nextOpts.revalidate : 31536e3;
+		if (cacheDirective === "force-cache") revalidateSeconds = nextOpts?.revalidate && typeof nextOpts.revalidate === "number" ? nextOpts.revalidate : ONE_YEAR_SECONDS;
+		else if (nextOpts?.revalidate === false) revalidateSeconds = ONE_YEAR_SECONDS;
 		else if (typeof nextOpts?.revalidate === "number" && nextOpts.revalidate > 0) revalidateSeconds = nextOpts.revalidate;
-		else if (nextOpts?.tags && nextOpts.tags.length > 0) revalidateSeconds = 31536e3;
+		else if (nextOpts?.tags && nextOpts.tags.length > 0) revalidateSeconds = ONE_YEAR_SECONDS;
 		else {
 			const cleanInit = stripNextFromInit(init, cacheDirective);
 			recordDynamicFetchObservation(input);
@@ -560,10 +590,7 @@ function createPatchedFetch() {
 			});
 			if (cached?.value && cached.value.kind === "FETCH" && cached.cacheState !== "stale") {
 				const cachedData = cached.value.data;
-				return new Response(cachedData.body, {
-					status: cachedData.status ?? 200,
-					headers: cachedData.headers
-				});
+				return buildCachedFetchResponse(cachedData, input);
 			}
 			if (cached?.value && cached.value.kind === "FETCH" && cached.cacheState === "stale") {
 				const staleData = cached.value.data;
@@ -581,7 +608,7 @@ function createPatchedFetch() {
 							data: {
 								headers: freshHeaders,
 								body: freshBody,
-								url: typeof input === "string" ? input : input instanceof URL ? input.toString() : input.url,
+								url: freshResp.url,
 								status: freshResp.status
 							},
 							tags,
@@ -605,10 +632,7 @@ function createPatchedFetch() {
 					}, DEDUP_TIMEOUT_MS);
 					getRequestExecutionContext()?.waitUntil(refetchPromise);
 				}
-				return new Response(staleData.body, {
-					status: staleData.status ?? 200,
-					headers: staleData.headers
-				});
+				return buildCachedFetchResponse(staleData, input);
 			}
 		} catch (cacheErr) {
 			console.error("[vinext] fetch cache read error:", cacheErr);
@@ -627,7 +651,7 @@ function createPatchedFetch() {
 				data: {
 					headers,
 					body,
-					url: typeof input === "string" ? input : input instanceof URL ? input.toString() : input.url,
+					url: response.url,
 					status: cloned.status
 				},
 				tags,
@@ -700,6 +724,7 @@ async function runWithFetchCache(fn) {
 		currentRequestTags: [],
 		currentFetchSoftTags: [],
 		currentFetchCacheMode: null,
+		currentForceDynamicFetchDefault: false,
 		dynamicFetchUrls: /* @__PURE__ */ new Set(),
 		isFetchDedupeActive: true,
 		currentFetchDedupeEntries: /* @__PURE__ */ new Map()
@@ -738,4 +763,4 @@ function getOriginalFetch() {
 	return originalFetch;
 }
 //#endregion
-export { _resetPendingRefetches, addCollectedRequestTags, consumeDynamicFetchObservations, ensureFetchPatch, getCollectedFetchTags, getCurrentFetchSoftTags, getOriginalFetch, peekCacheableFetchObservations, peekDynamicFetchObservations, runWithFetchCache, runWithFetchDedupe, setCurrentFetchCacheMode, setCurrentFetchSoftTags, withFetchCache };
+export { _resetPendingRefetches, addCollectedRequestTags, consumeDynamicFetchObservations, ensureFetchPatch, getCollectedFetchTags, getCurrentFetchSoftTags, getOriginalFetch, peekCacheableFetchObservations, peekDynamicFetchObservations, runWithFetchCache, runWithFetchDedupe, setCurrentFetchCacheMode, setCurrentFetchSoftTags, setCurrentForceDynamicFetchDefault, withFetchCache };

package/dist/shims/hash-scroll.js

@@ -17,7 +17,12 @@ function scrollToHashTarget(hash) {
 		idElement.scrollIntoView({ behavior: "auto" });
 		return;
 	}
-	document.getElementsByName(fragment)[0]?.scrollIntoView({ behavior: "auto" });
+	const namedElement = document.getElementsByName(fragment)[0];
+	if (namedElement) {
+		namedElement.scrollIntoView({ behavior: "auto" });
+		return;
+	}
+	window.scrollTo(0, 0);
 }
 function scrollToHashTargetOnNextFrame(hash) {
 	requestAnimationFrame(() => {

package/dist/shims/headers.js

@@ -3,7 +3,8 @@ import { getRequestContext, isInsideUnifiedScope, runWithUnifiedStateMutation }
 import { MIDDLEWARE_SET_COOKIE_HEADER } from "../server/headers.js";
 import { buildRequestHeadersFromMiddlewareResponse } from "../server/middleware-request-headers.js";
 import { serializeSetCookie, validateCookieAttributeValue, validateCookieName } from "./internal/cookie-serialize.js";
-import { parseCookieHeader } from "./internal/parse-cookie-header.js";
+import { parseEdgeRequestCookieHeader } from "../utils/parse-cookie.js";
+import { createPprFallbackShellSuspensePromise } from "./ppr-fallback-shell.js";
 //#region src/shims/headers.ts
 /**
 * next/headers shim
@@ -81,7 +82,7 @@ function setCookieNameValue(setCookie) {
 function rebuildCookiesFromHeader(ctx, cookieHeader) {
 	ctx.cookies.clear();
 	if (cookieHeader === null) return;
-	const nextCookies = parseCookieHeader(cookieHeader);
+	const nextCookies = parseEdgeRequestCookieHeader(cookieHeader);
 	for (const [name, value] of nextCookies) ctx.cookies.set(name, value);
 }
 function mergeMiddlewareSetCookies(ctx, rawHeader) {
@@ -414,6 +415,26 @@ function _decorateRejectedRequestApiPromise(error) {
 		throw normalizedError;
 	} }));
 }
+function _decorateSuspendingRequestApiPromise(promise) {
+	return new Proxy(promise, {
+		get(promiseTarget, prop) {
+			if (prop === "then" || prop === "catch" || prop === "finally") {
+				const value = Reflect.get(promiseTarget, prop, promiseTarget);
+				return typeof value === "function" ? value.bind(promiseTarget) : value;
+			}
+			throw promise;
+		},
+		getOwnPropertyDescriptor() {
+			throw promise;
+		},
+		has() {
+			throw promise;
+		},
+		ownKeys() {
+			throw promise;
+		}
+	});
+}
 function _sealHeaders(headers) {
 	return new Proxy(headers, { get(target, prop) {
 		if (typeof prop === "string" && _HEADERS_MUTATING_METHODS.has(prop)) throw new ReadonlyHeadersError();
@@ -485,7 +506,7 @@ function headersContextFromRequest(request, options) {
 	let _cookies = null;
 	function getCookies() {
 		if (_cookies) return _cookies;
-		_cookies = parseCookieHeader(headersProxy.get("cookie") || "");
+		_cookies = parseEdgeRequestCookieHeader(headersProxy.get("cookie") || "");
 		return _cookies;
 	}
 	return {
@@ -512,6 +533,8 @@ function headers() {
 	if (!state.headersContext) return _decorateRejectedRequestApiPromise(/* @__PURE__ */ new Error("headers() can only be called from a Server Component, Route Handler, or Server Action. Make sure you're not calling it from a Client Component."));
 	if (state.headersContext.accessError) return _decorateRejectedRequestApiPromise(state.headersContext.accessError);
 	markDynamicUsage();
+	const fallbackShellPromise = createPprFallbackShellSuspensePromise("`headers()`");
+	if (fallbackShellPromise) return _decorateSuspendingRequestApiPromise(fallbackShellPromise);
 	return _getOrCreateDecoratedRequestApiPromise(_decoratedHeadersPromises, _getReadonlyHeaders(state.headersContext));
 }
 /**
@@ -529,6 +552,8 @@ function cookies() {
 	if (!state.headersContext) return _decorateRejectedRequestApiPromise(/* @__PURE__ */ new Error("cookies() can only be called from a Server Component, Route Handler, or Server Action."));
 	if (state.headersContext.accessError) return _decorateRejectedRequestApiPromise(state.headersContext.accessError);
 	markDynamicUsage();
+	const fallbackShellPromise = createPprFallbackShellSuspensePromise("`cookies()`");
+	if (fallbackShellPromise) return _decorateSuspendingRequestApiPromise(fallbackShellPromise);
 	return _getOrCreateDecoratedRequestApiPromise(_decoratedCookiesPromises, _areCookiesMutableInCurrentPhase() ? _getMutableCookies(state.headersContext) : _getReadonlyCookies(state.headersContext));
 }
 /** Accumulated Set-Cookie headers from cookies().set() / .delete() calls */
@@ -572,7 +597,7 @@ function ensureContextDraftModeSecret(ctx) {
 function isDraftModeRequest(request, draftModeSecret) {
 	const cookieHeader = request.headers.get("cookie");
 	if (!cookieHeader) return false;
-	return parseCookieHeader(cookieHeader).get(DRAFT_MODE_COOKIE) === validateDraftModeSecret(draftModeSecret);
+	return parseEdgeRequestCookieHeader(cookieHeader).get(DRAFT_MODE_COOKIE) === validateDraftModeSecret(draftModeSecret);
 }
 function draftModeCookieAttributes() {
 	if (typeof process !== "undefined" && process.env?.NODE_ENV === "development") return "Path=/; HttpOnly; SameSite=Lax";

package/dist/shims/image.js

@@ -175,6 +175,13 @@ function sanitizeBlurDataURL(url) {
 function isRemoteUrl(src) {
 	return src.startsWith("http://") || src.startsWith("https://") || src.startsWith("//");
 }
+function isSvgUrl(src) {
+	try {
+		return new URL(src, "http://vinext.local").pathname.toLowerCase().endsWith(".svg");
+	} catch {
+		return false;
+	}
+}
 function getFillStyle(style, backgroundStyle) {
 	return {
 		position: "absolute",
@@ -414,7 +421,7 @@ const Image = forwardRef(function Image({ src: srcProp, alt, width, height, fill
 		}
 	}
 	const imgQuality = quality ?? 75;
-	const isSvg = src.endsWith(".svg");
+	const isSvg = isSvgUrl(src);
 	const skipOptimization = _unoptimized === true || isSvg && !__dangerouslyAllowSVG;
 	const srcSet = imgWidth && !fill && !skipOptimization ? generateSrcSet(src, imgWidth, imgQuality) : imgWidth && !fill ? RESPONSIVE_WIDTHS.filter((w) => w <= imgWidth * 2).map((w) => `${src} ${w}w`).join(", ") || `${src} ${imgWidth}w` : void 0;
 	const optimizedSrc = skipOptimization ? src : imgWidth ? imageOptimizationUrl(src, imgWidth, imgQuality) : imageOptimizationUrl(src, RESPONSIVE_WIDTHS[0], imgQuality);
@@ -483,7 +490,7 @@ function getImageProps(props) {
 		width: imgWidth ?? 0,
 		quality: imgQuality
 	}) : src;
-	const isSvg = resolvedSrc.endsWith(".svg");
+	const isSvg = isSvgUrl(resolvedSrc);
 	const skipOpt = _unoptimized === true || isSvg && !__dangerouslyAllowSVG || blockedInProd || !!loader || isRemoteUrl(resolvedSrc);
 	const optimizedSrc = skipOpt ? resolvedSrc : imgWidth ? imageOptimizationUrl(resolvedSrc, imgWidth, imgQuality) : imageOptimizationUrl(resolvedSrc, RESPONSIVE_WIDTHS[0], imgQuality);
 	const srcSet = imgWidth && !fill && !isRemoteUrl(resolvedSrc) && !loader && !skipOpt ? generateSrcSet(resolvedSrc, imgWidth, imgQuality) : void 0;

package/dist/shims/internal/als-registry.js

@@ -38,6 +38,33 @@ import { AsyncLocalStorage } from "node:async_hooks";
 */
 const _g = globalThis;
 /**
+* No-op AsyncLocalStorage used when the runtime does not provide a usable
+* `AsyncLocalStorage` constructor.
+*
+* In browser/client bundles `node:async_hooks` can resolve to a stub without a
+* usable constructor (e.g. Vite's `__vite-browser-external`). Constructing such
+* a value with `new` throws `TypeError: AsyncLocalStorage is not a constructor`
+* at module-eval time, crashing every client-reachable shim that calls
+* `getOrCreateAls` on import (request-context, headers, cache, …).
+*
+* Mirrors Next.js' `FakeAsyncLocalStorage` (and this repo's
+* `async-hooks-stub.ts` client virtual module): `getStore()` returns
+* `undefined` so shims fall back to their non-ALS code path, and the mutating
+* methods are best-effort no-ops that still invoke the callback.
+* See: https://github.com/vercel/next.js/blob/canary/packages/next/src/server/app-render/async-local-storage.ts
+*/
+var NoopAsyncLocalStorage = class {
+	getStore() {}
+	run(_store, fn, ...args) {
+		return fn(...args);
+	}
+	exit(fn, ...args) {
+		return fn(...args);
+	}
+	enterWith(_store) {}
+	disable() {}
+};
+/**
 * Get (or lazily create) the AsyncLocalStorage registered on `globalThis`
 * under `Symbol.for(key)`. Multiple callers — including callers in different
 * module instances — that pass the same `key` receive the same ALS instance.
@@ -47,7 +74,7 @@ const _g = globalThis;
 */
 function getOrCreateAls(key) {
 	const sym = Symbol.for(key);
-	return _g[sym] ??= new AsyncLocalStorage();
+	return _g[sym] ??= typeof AsyncLocalStorage === "function" ? new AsyncLocalStorage() : new NoopAsyncLocalStorage();
 }
 //#endregion
 export { getOrCreateAls };