vinext 1.0.0-beta.3 → 1.0.0-beta.5

package/dist/build/static-export.d.ts

@@ -1,24 +1,32 @@
 import { ResolvedNextConfig } from "../config/next-config.js";
 import { Route } from "../routing/pages-router.js";
 import { AppRoute } from "../routing/app-route-graph.js";
-
 //#region src/build/static-export.d.ts
 type StaticExportOptions = {
   /**
    * Absolute path to the pre-built Pages Router server bundle
    * (e.g. `dist/server/entry.js`).
    */
-  pagesBundlePath: string; /** Discovered page routes (excludes API routes) */
-  routes: Route[]; /** Discovered API routes */
-  apiRoutes: Route[]; /** Pages directory path */
-  pagesDir: string; /** Output directory for static files */
-  outDir: string; /** Resolved next.config.js */
+  pagesBundlePath: string;
+  /** Discovered page routes (excludes API routes) */
+  routes: Route[];
+  /** Discovered API routes */
+  apiRoutes: Route[];
+  /** Pages directory path */
+  pagesDir: string;
+  /** Output directory for static files */
+  outDir: string;
+  /** Resolved next.config.js */
   config: ResolvedNextConfig;
 };
 type StaticExportResult = {
-  /** Number of HTML files generated */pageCount: number; /** Generated file paths (relative to outDir) */
-  files: string[]; /** Warnings encountered */
-  warnings: string[]; /** Errors encountered (non-fatal, specific pages) */
+  /** Number of HTML files generated */
+  pageCount: number;
+  /** Generated file paths (relative to outDir) */
+  files: string[];
+  /** Warnings encountered */
+  warnings: string[];
+  /** Errors encountered (non-fatal, specific pages) */
   errors: Array<{
     route: string;
     error: string;
@@ -31,7 +39,8 @@ type StaticExportResult = {
  */
 declare function staticExportPages(options: StaticExportOptions): Promise<StaticExportResult>;
 type AppStaticExportOptions = {
-  /** Discovered app routes */routes: AppRoute[];
+  /** Discovered app routes */
+  routes: AppRoute[];
   /**
    * App directory path. When provided, static export scans it for file-based
    * metadata assets such as icon.png and sitemap.xml.
@@ -41,8 +50,10 @@ type AppStaticExportOptions = {
    * Absolute path to the pre-built RSC handler bundle
    * (e.g. `dist/server/index.js`).
    */
-  rscBundlePath: string; /** Output directory */
-  outDir: string; /** Resolved next.config.js */
+  rscBundlePath: string;
+  /** Output directory */
+  outDir: string;
+  /** Resolved next.config.js */
   config: ResolvedNextConfig;
 };
 /**

package/dist/cache/cache-adapters-virtual.d.ts

@@ -11,7 +11,8 @@ type CacheAdapterDescriptor<O extends Record<string, unknown> = Record<string, u
    * Module specifier (or absolute path, e.g. from `require.resolve(...)`) whose
    * default export is a cache adapter factory.
    */
-  adapter: string; /** JSON-serializable options forwarded to the factory at runtime. */
+  adapter: string;
+  /** JSON-serializable options forwarded to the factory at runtime. */
   options?: O;
 };
 /**
@@ -20,7 +21,9 @@ type CacheAdapterDescriptor<O extends Record<string, unknown> = Record<string, u
  * from a worker entry.
  */
 type VinextCacheConfig = {
-  /** Page-level ISR serving strategy (CDN cache adapter). */cdn?: CacheAdapterDescriptor; /** Data cache (fetch / `"use cache"` / `unstable_cache`) handler. */
+  /** Page-level ISR serving strategy (CDN cache adapter). */
+  cdn?: CacheAdapterDescriptor;
+  /** Data cache (fetch / `"use cache"` / `unstable_cache`) handler. */
   data?: CacheAdapterDescriptor;
 };
 /** Public virtual module id imported by the server entries. */

package/dist/check.js

@@ -295,12 +295,12 @@ const CONFIG_SUPPORT = {
 		detail: "not recognized; instrumentation files are enabled automatically"
 	},
 	skipMiddlewareUrlNormalize: {
-		status: "unsupported",
-		detail: "not recognized; use of this option is ignored"
+		status: "partial",
+		detail: "preserves raw Pages Router _next/data URLs passed to middleware"
 	},
 	skipProxyUrlNormalize: {
-		status: "unsupported",
-		detail: "not recognized; use of this option is ignored"
+		status: "partial",
+		detail: "preserves raw Pages Router _next/data URLs passed to proxy"
 	},
 	"i18n.domains": {
 		status: "partial",

package/dist/cli-args.d.ts

@@ -3,12 +3,13 @@
  * CLI argument parser for the vinext CLI.
  *
  * Parses flags for `vinext dev`, `vinext start`, `vinext build`, etc.
- * Validates that value-taking flags (`--port`, `--hostname`) have actual values
+ * Validates that value-taking flags (`--port`, `--hostname`, `--mode`) have actual values
  * rather than silently consuming the next flag or returning NaN/undefined.
  */
 type ParsedArgs = {
   port?: number;
   hostname?: string;
+  mode?: string;
   help?: boolean;
   verbose?: boolean;
   turbopack?: boolean;

package/dist/cli-args.js

@@ -96,6 +96,10 @@ function parseArgs(args) {
 				result.hostname = takeValue(arg, args, i);
 				i++;
 				break;
+			case "--mode":
+				result.mode = takeValue(arg, args, i);
+				i++;
+				break;
 			default: {
 				const eqRaw = tryEqualsForm(arg, "port");
 				if (eqRaw !== null) {
@@ -108,6 +112,12 @@ function parseArgs(args) {
 					result.hostname = hostRaw;
 					break;
 				}
+				const modeRaw = tryEqualsForm(arg, "mode");
+				if (modeRaw !== null) {
+					if (modeRaw === "") throw new Error(`--mode requires a value, but none was provided.`);
+					result.mode = modeRaw;
+					break;
+				}
 				const prerenderConcurrencyRaw = tryEqualsForm(arg, "prerender-concurrency");
 				if (prerenderConcurrencyRaw !== null) {
 					result.prerenderConcurrency = parsePositiveIntegerArg(prerenderConcurrencyRaw, "--prerender-concurrency");

package/dist/cli-dev-config.d.ts

@@ -1,5 +1,4 @@
 import { Plugin, ServerOptions } from "vite";
-
 //#region src/cli-dev-config.d.ts
 type DevServerCliOptions = {
   port?: number;

package/dist/cli.d.ts

@@ -1 +1 @@
-export { };
+export {}

package/dist/cli.js

@@ -6,6 +6,7 @@ import { parseArgs } from "./cli-args.js";
 import { createDevServerConfigPlugin, normalizeDevServerHostname } from "./cli-dev-config.js";
 import { PHASE_PRODUCTION_BUILD } from "./shims/constants.js";
 import { createRscCompatibilityId, findVinextNextConfigInPlugins, loadNextConfig, resolveNextConfig, resolveNextConfigInput } from "./config/next-config.js";
+import { loadDotenv } from "./config/dotenv.js";
 import { generateRouteTypes } from "./typegen.js";
 import { clearPagesClientAssetsBuildMetadata } from "./build/pages-client-assets-module.js";
 import { runWithPreviewBuildCredentials } from "./build/preview-credentials.js";
@@ -16,7 +17,6 @@ import { emitPrerenderPathManifest } from "./build/prerender-paths.js";
 import { getReactUpgradeDeps } from "./utils/react-version.js";
 import { init } from "./init.js";
 import { resolveInitOptions } from "./init-platform.js";
-import { loadDotenv } from "./config/dotenv.js";
 import { resolveVinextPackageRoot } from "./utils/vinext-root.js";
 import { emitStandaloneOutput } from "./build/standalone.js";
 import { cleanBuildOutput } from "./build/clean-output.js";
@@ -125,7 +125,7 @@ function createBuildLogger(vite) {
 function hasPagesDir() {
 	return fs.existsSync(path.join(process.cwd(), "pages")) || fs.existsSync(path.join(process.cwd(), "src", "pages"));
 }
-async function loadBuildViteConfigMetadata(vite, root) {
+async function loadBuildViteConfigMetadata(vite, root, mode) {
 	if (!hasViteConfig(root)) return {
 		nextConfig: null,
 		prerenderConfig: null,
@@ -133,7 +133,7 @@ async function loadBuildViteConfigMetadata(vite, root) {
 	};
 	const loaded = await vite.loadConfigFromFile({
 		command: "build",
-		mode: "production"
+		mode
 	}, void 0, root);
 	const emptyOutDir = loaded?.config.build?.emptyOutDir;
 	return {
@@ -148,14 +148,16 @@ async function loadBuildViteConfigMetadata(vite, root) {
 * project, Vite will merge our config with it (theirs takes precedence).
 * If there's no vite.config, this provides everything needed.
 */
-function buildViteConfig(overrides = {}, logger) {
+function buildViteConfig(overrides = {}, logger, mode) {
 	if (hasViteConfig(process.cwd())) return {
 		root: process.cwd(),
+		...mode ? { mode } : {},
 		...logger ? { customLogger: logger } : {},
 		...overrides
 	};
 	return {
 		root: process.cwd(),
+		...mode ? { mode } : {},
 		configFile: false,
 		plugins: [vinext()],
 		resolve: { dedupe: [
@@ -274,10 +276,12 @@ async function dev() {
 async function buildApp() {
 	const parsed = parseArgs(rawArgs);
 	if (parsed.help) return printHelp("build");
+	const buildMode = parsed.mode ?? "production";
+	if (!process.env.NODE_ENV) Reflect.set(process.env, "NODE_ENV", "production");
 	if (parsed.precompress) process.env.VINEXT_PRECOMPRESS = "1";
 	loadDotenv({
 		root: process.cwd(),
-		mode: "production"
+		mode: buildMode
 	});
 	applyViteConfigCompatibility(process.cwd());
 	const vite = await loadVite();
@@ -285,7 +289,7 @@ async function buildApp() {
 	console.log(`\n  vinext build  (Vite ${getViteVersion()})\n`);
 	const root = toSlash(process.cwd());
 	const isApp = hasAppDir(root);
-	const buildConfigMetadata = await loadBuildViteConfigMetadata(vite, root);
+	const buildConfigMetadata = await loadBuildViteConfigMetadata(vite, root, buildMode);
 	const resolvedNextConfig = await resolveNextConfig(buildConfigMetadata.nextConfig ? await resolveNextConfigInput(buildConfigMetadata.nextConfig, PHASE_PRODUCTION_BUILD) : await loadNextConfig(root, PHASE_PRODUCTION_BUILD), root);
 	process.env.__VINEXT_SHARED_BUILD_ID = resolvedNextConfig.buildId;
 	process.env.__VINEXT_SHARED_RSC_COMPATIBILITY_ID = createRscCompatibilityId(resolvedNextConfig);
@@ -322,7 +326,7 @@ async function buildApp() {
 	if (pagesClientAssetsBuildSession) process.env.__VINEXT_PAGES_CLIENT_ASSETS_BUILD_SESSION = pagesClientAssetsBuildSession;
 	await runWithPreviewBuildCredentials(async () => {
 		try {
-			const config = buildViteConfig({}, logger);
+			const config = buildViteConfig({}, logger, buildMode);
 			await (await vite.createBuilder(config)).buildApp();
 			if (isHybrid) {
 				console.log("  Building Pages Router server (hybrid)...");
@@ -331,13 +335,14 @@ async function buildApp() {
 				if (hasViteConfig(process.cwd())) {
 					const loaded = await vite.loadConfigFromFile({
 						command: "build",
-						mode: "production",
+						mode: buildMode,
 						isSsrBuild: true
 					}, void 0, root);
 					if (loaded?.config.plugins) userTransformPlugins = loaded.config.plugins.flat(Infinity).filter((p) => !!p && typeof p.name === "string" && !p.name.startsWith("vinext:") && !p.name.startsWith("vite:react") && !p.name.startsWith("rsc:") && p.name !== "vite-rsc-load-module-dev-proxy" && !p.name.startsWith("vite-plugin-cloudflare"));
 				}
 				await vite.build({
 					root,
+					mode: buildMode,
 					configFile: false,
 					plugins: [...userTransformPlugins, vinext({ disableAppRouter: true })],
 					resolve: { dedupe: [
@@ -536,6 +541,7 @@ function printHelp(cmd) {
                          to vinext({ prerender: true }) and takes priority.
     --prerender-concurrency <count>
                          Maximum number of routes to pre-render in parallel
+    --mode <mode>        Load .env.<mode>* files and pass mode to Vite
     --precompress        Precompress static assets at build time (.br, .gz, .zst)
     -h, --help           Show this help
 `);

package/dist/client/client-rewrite-matcher.d.ts

@@ -0,0 +1,12 @@
+import { RequestContext } from "../config/request-context.js";
+import { BasePathMatchState } from "../config/config-matchers.js";
+import { ClientRewrite } from "./client-rewrites.js";
+//#region src/client/client-rewrite-matcher.d.ts
+declare function matchClientRewrite(pathname: string, rewrite: ClientRewrite, context: RequestContext, basePathState: BasePathMatchState): {
+  kind: "rewrite";
+  destination: string;
+} | {
+  kind: "server";
+} | null;
+//#endregion
+export { matchClientRewrite };

package/dist/client/client-rewrite-matcher.js

@@ -0,0 +1,20 @@
+import { isExternalUrl } from "../utils/external-url.js";
+import { matchRewrite } from "../config/config-matchers.js";
+//#region src/client/client-rewrite-matcher.ts
+function matchClientRewrite(pathname, rewrite, context, basePathState) {
+	const destination = matchRewrite(pathname, [{
+		source: rewrite.source,
+		destination: rewrite.destination ?? "/",
+		has: rewrite.has,
+		locale: rewrite.locale,
+		basePath: rewrite.basePath
+	}], context, basePathState);
+	if (destination === null) return null;
+	if (rewrite.requiresServerEvaluation || isExternalUrl(destination)) return { kind: "server" };
+	return {
+		kind: "rewrite",
+		destination
+	};
+}
+//#endregion
+export { matchClientRewrite };

package/dist/client/client-rewrites.d.ts

@@ -0,0 +1,31 @@
+import { HasCondition, NextRewrite, ResolvedNextConfig } from "../config/next-config.js";
+//#region src/client/client-rewrites.d.ts
+type ClientHasCondition = Omit<HasCondition, "type"> & {
+  type: "host" | "query";
+};
+type ClientRewriteFields = Pick<NextRewrite, "basePath" | "locale" | "source"> & {
+  has?: ClientHasCondition[];
+};
+/**
+ * Rewrite data that is safe to publish in a browser bundle.
+ *
+ * Rules that require server-only data deliberately omit both the destination
+ * and the data that made server evaluation necessary. The client can still
+ * use browser-authoritative conditions as a prefilter before handing the
+ * navigation to the server.
+ */
+type ClientRewrite = (ClientRewriteFields & {
+  destination: string;
+  requiresServerEvaluation?: never;
+}) | (ClientRewriteFields & {
+  destination?: never;
+  requiresServerEvaluation: true;
+});
+type ClientRewrites = {
+  afterFiles: ClientRewrite[];
+  beforeFiles: ClientRewrite[];
+  fallback: ClientRewrite[];
+};
+declare function toClientRewrites(rewrites: ResolvedNextConfig["rewrites"]): ClientRewrites;
+//#endregion
+export { ClientRewrite, ClientRewrites, toClientRewrites };

package/dist/client/client-rewrites.js

@@ -0,0 +1,41 @@
+import { isExternalUrl } from "../utils/external-url.js";
+//#region src/client/client-rewrites.ts
+function isClientHasCondition(condition) {
+	switch (condition.type) {
+		case "host":
+		case "query": return true;
+		case "cookie":
+		case "header": return false;
+		default: return false;
+	}
+}
+function toClientRewrite(rewrite) {
+	const clientHas = rewrite.has?.filter(isClientHasCondition);
+	const hasServerOnlyCondition = rewrite.has?.some((condition) => !isClientHasCondition(condition)) ?? false;
+	const common = {
+		source: rewrite.source,
+		has: clientHas?.length ? clientHas : void 0,
+		locale: rewrite.locale,
+		basePath: rewrite.basePath
+	};
+	if (isExternalUrl(rewrite.destination) || (rewrite.missing?.length ?? 0) > 0 || hasServerOnlyCondition) return {
+		...common,
+		requiresServerEvaluation: true
+	};
+	return {
+		source: rewrite.source,
+		destination: rewrite.destination,
+		has: common.has,
+		locale: rewrite.locale,
+		basePath: rewrite.basePath
+	};
+}
+function toClientRewrites(rewrites) {
+	return {
+		beforeFiles: rewrites.beforeFiles.map(toClientRewrite),
+		afterFiles: rewrites.afterFiles.map(toClientRewrite),
+		fallback: rewrites.fallback.map(toClientRewrite)
+	};
+}
+//#endregion
+export { toClientRewrites };

package/dist/client/dev-error-overlay.d.ts

@@ -1,5 +1,4 @@
 import { ReportedError, dismissOverlay } from "./dev-error-overlay-store.js";
-
 //#region src/client/dev-error-overlay.d.ts
 declare const DEV_ERROR_OVERLAY_HOST_ID = "__vinext_dev_error_overlay_root";
 declare const DEV_ERROR_OVERLAY_MOUNT_ID = "__vinext_dev_error_overlay_mount";

package/dist/client/empty-module.d.ts

@@ -1 +1 @@
-export { };
+export {}

package/dist/client/index.d.ts

@@ -0,0 +1,2 @@
+import { getVinextReact } from "./react-instance.js";
+export { getVinextReact };

package/dist/client/index.js

@@ -0,0 +1,2 @@
+import { getVinextReact } from "./react-instance.js";
+export { getVinextReact };

package/dist/client/instrumentation-client-state.d.ts

@@ -1,5 +1,4 @@
 import { ClientInstrumentationHooks } from "./instrumentation-client.js";
-
 //#region src/client/instrumentation-client-state.d.ts
 declare function normalizeClientInstrumentationHooks(hooks: ClientInstrumentationHooks): ClientInstrumentationHooks | null;
 declare function setClientInstrumentationHooks(hooks: ClientInstrumentationHooks | null): ClientInstrumentationHooks | null;

package/dist/client/navigation-runtime.d.ts

@@ -1,6 +1,5 @@
 import { RouteManifest } from "../routing/app-route-graph.js";
 import { AppRouterScrollIntent } from "../shims/app-router-scroll-state.js";
-
 //#region src/client/navigation-runtime.d.ts
 type NavigationRuntimeSnapshot = {
   pathname: string;
@@ -14,10 +13,20 @@ type NavigationRuntimeRscBootstrap = {
   nav?: NavigationRuntimeSnapshot;
   params?: Record<string, string | string[]>;
   rsc: NavigationRuntimeRscChunk[];
+  /**
+   * Client reuse bound in seconds resolved from the initial render's completed
+   * `cacheLife` — the done-script sibling of `dynamicStaleTimeSeconds`, which
+   * carries the `experimental.staleTimes` config value instead.
+   */
+  staleTimeSeconds?: number;
 };
 type NavigationRuntimeKind = "navigate" | "traverse" | "refresh";
 type NavigationRuntimeHistoryUpdateMode = "push" | "replace";
 type NavigationRuntimeVisibleCommitMode = "transition" | "synchronous";
+type NavigationRuntimePrefetchRouterState = {
+  pathAndSearch: string;
+  routeId: string;
+};
 type NavigationRuntimeTraversalIntent = {
   direction: "back" | "forward" | "unknown";
   historyState: unknown;
@@ -29,6 +38,7 @@ type NavigationRuntimeFunctions = {
   commitHashNavigation?: (href: string, historyUpdateMode: NavigationRuntimeHistoryUpdateMode, scroll: boolean) => void;
   navigateExternal?: (href: string, historyUpdateMode: NavigationRuntimeHistoryUpdateMode) => Promise<void>;
   navigate?: NavigationRuntimeNavigate;
+  getPrefetchRouterState?: () => NavigationRuntimePrefetchRouterState | null;
   /**
    * Called at the start of every App Router navigation so the <Link> shim can
    * reset any link that is still showing a `useLinkStatus()` pending state but
@@ -38,6 +48,7 @@ type NavigationRuntimeFunctions = {
    */
   notifyLinkNavigationStart?: () => void;
   pingVisibleLinks?: () => void;
+  preparePrefetchResponse?: (response: Response) => Promise<unknown>;
 };
 type NavigationRuntimeBootstrap = {
   routeManifest: RouteManifest | null;

package/dist/client/navigation-runtime.js

@@ -31,7 +31,7 @@ function readRuntimeWindow() {
 }
 function isNavigationRuntimeFunctions(value) {
 	if (!isUnknownRecord(value)) return false;
-	return isOptionalRuntimeFunction(Reflect.get(value, "clearNavigationCaches")) && isOptionalRuntimeFunction(Reflect.get(value, "commitHashNavigation")) && isOptionalRuntimeFunction(Reflect.get(value, "navigateExternal")) && isOptionalRuntimeFunction(Reflect.get(value, "navigate")) && isOptionalRuntimeFunction(Reflect.get(value, "notifyLinkNavigationStart")) && isOptionalRuntimeFunction(Reflect.get(value, "pingVisibleLinks"));
+	return isOptionalRuntimeFunction(Reflect.get(value, "clearNavigationCaches")) && isOptionalRuntimeFunction(Reflect.get(value, "commitHashNavigation")) && isOptionalRuntimeFunction(Reflect.get(value, "navigateExternal")) && isOptionalRuntimeFunction(Reflect.get(value, "navigate")) && isOptionalRuntimeFunction(Reflect.get(value, "getPrefetchRouterState")) && isOptionalRuntimeFunction(Reflect.get(value, "notifyLinkNavigationStart")) && isOptionalRuntimeFunction(Reflect.get(value, "pingVisibleLinks")) && isOptionalRuntimeFunction(Reflect.get(value, "preparePrefetchResponse"));
 }
 function isNavigationRuntimeRscChunk(value) {
 	if (typeof value === "string") return true;
@@ -55,7 +55,11 @@ function isNavigationRuntimeRscBootstrap(value) {
 	const nav = Reflect.get(value, "nav");
 	const params = Reflect.get(value, "params");
 	const rsc = Reflect.get(value, "rsc");
-	return (done === void 0 || typeof done === "boolean") && (dynamicStaleTimeSeconds === void 0 || typeof dynamicStaleTimeSeconds === "number" && Number.isFinite(dynamicStaleTimeSeconds) && dynamicStaleTimeSeconds >= 0) && (initialCacheKind === void 0 || initialCacheKind === "dynamic" || initialCacheKind === "static") && (nav === void 0 || isNavigationRuntimeSnapshot(nav)) && (params === void 0 || isNavigationRuntimeParams(params)) && Array.isArray(rsc) && rsc.every(isNavigationRuntimeRscChunk);
+	const staleTimeSeconds = Reflect.get(value, "staleTimeSeconds");
+	return (done === void 0 || typeof done === "boolean") && isOptionalStaleTimeSeconds(dynamicStaleTimeSeconds) && (initialCacheKind === void 0 || initialCacheKind === "dynamic" || initialCacheKind === "static") && (nav === void 0 || isNavigationRuntimeSnapshot(nav)) && (params === void 0 || isNavigationRuntimeParams(params)) && Array.isArray(rsc) && rsc.every(isNavigationRuntimeRscChunk) && isOptionalStaleTimeSeconds(staleTimeSeconds);
+}
+function isOptionalStaleTimeSeconds(value) {
+	return value === void 0 || typeof value === "number" && Number.isFinite(value) && value >= 0;
 }
 function isReadonlyStringArray(value) {
 	return Array.isArray(value) && value.every((entry) => typeof entry === "string");

package/dist/client/pages-router-link-navigation.d.ts

@@ -26,32 +26,14 @@ type PagesRouterLinkNavigation = {
   locale?: string | false;
   interpolateDynamicRoute?: boolean;
 };
-declare function resolvePagesRouterQueryOnlyHref(href: string, {
-  asPath,
-  basePath,
-  fallbackHref,
-  locales
-}: {
+declare function resolvePagesRouterQueryOnlyHref(href: string, { asPath, basePath, fallbackHref, locales }: {
   asPath?: string;
   basePath: string;
   fallbackHref: string;
   locales?: readonly string[];
 }): string;
-declare function navigatePagesRouterLink(router: PagesRouterLinkRuntime, {
-  href,
-  as,
-  replace,
-  scroll,
-  shallow,
-  locale,
-  interpolateDynamicRoute
-}: PagesRouterLinkNavigation): Promise<void>;
-declare function navigatePagesRouterLinkWithFallback({
-  router,
-  loadRouter,
-  navigation,
-  fallback
-}: {
+declare function navigatePagesRouterLink(router: PagesRouterLinkRuntime, { href, as, replace, scroll, shallow, locale, interpolateDynamicRoute }: PagesRouterLinkNavigation): Promise<void>;
+declare function navigatePagesRouterLinkWithFallback({ router, loadRouter, navigation, fallback }: {
   router?: PagesRouterLinkRuntime;
   loadRouter: () => Promise<PagesRouterLinkRuntime | undefined>;
   navigation: PagesRouterLinkNavigation;

package/dist/client/react-instance-bootstrap.d.ts

@@ -0,0 +1 @@
+export {}

package/dist/client/react-instance-bootstrap.js

@@ -0,0 +1,7 @@
+"use client";
+import { getVinextReact } from "./react-instance.js";
+import * as React$1 from "react";
+//#region src/client/react-instance-bootstrap.ts
+getVinextReact(React$1);
+//#endregion
+export {};

package/dist/client/react-instance.d.ts

@@ -0,0 +1,13 @@
+//#region src/client/react-instance.d.ts
+/**
+ * Return the React instance registered by the vinext browser entry.
+ *
+ * Module Federation remotes can call this with their local React namespace to
+ * reuse the host instance. The first browser registration wins so evaluating
+ * another copy of this module (for example after HMR) cannot replace it.
+ * Server and RSC environments always keep their condition-specific React
+ * instance local.
+ */
+declare function getVinextReact(reactInstance: typeof import("react")): typeof import("react");
+//#endregion
+export { getVinextReact };

package/dist/client/react-instance.js

@@ -0,0 +1,20 @@
+//#region src/client/react-instance.ts
+const VINEXT_CLIENT_REACT = Symbol.for("vinext.client.react");
+/**
+* Return the React instance registered by the vinext browser entry.
+*
+* Module Federation remotes can call this with their local React namespace to
+* reuse the host instance. The first browser registration wins so evaluating
+* another copy of this module (for example after HMR) cannot replace it.
+* Server and RSC environments always keep their condition-specific React
+* instance local.
+*/
+function getVinextReact(reactInstance) {
+	if (typeof window === "undefined") return reactInstance;
+	const registeredReact = Reflect.get(globalThis, VINEXT_CLIENT_REACT);
+	if (registeredReact !== void 0) return registeredReact;
+	Reflect.set(globalThis, VINEXT_CLIENT_REACT, reactInstance);
+	return reactInstance;
+}
+//#endregion
+export { getVinextReact };

package/dist/client/vinext-next-data.d.ts

@@ -1,5 +1,4 @@
 import { NEXT_DATA } from "../shims/internal/utils.js";
-
 //#region src/client/vinext-next-data.d.ts
 type VinextLinkPrefetchRoute = {
   canPrefetchLoadingShell: boolean;
@@ -26,11 +25,17 @@ type VinextPagesLinkPrefetchRoute = {
   requiresDynamicNavigationRequest?: boolean;
 };
 type VinextNextData = {
-  /** vinext-specific additions (not part of Next.js upstream). */__vinext?: {
-    /** Absolute URL of the page module for dynamic import. */pageModuleUrl?: string; /** Absolute URL of the `_app` module for dynamic import. */
-    appModuleUrl?: string; /** True when the Pages Router server has middleware/proxy configured. */
-    hasMiddleware?: boolean; /** True when build-time rewrites can affect the initial Pages Router ready state. */
-    hasRewrites?: boolean; /** Server-resolved Pages route URL used to hydrate fallback shells behind rewrites. */
+  /** vinext-specific additions (not part of Next.js upstream). */
+  __vinext?: {
+    /** Absolute URL of the page module for dynamic import. */
+    pageModuleUrl?: string;
+    /** Absolute URL of the `_app` module for dynamic import. */
+    appModuleUrl?: string;
+    /** True when the Pages Router server has middleware/proxy configured. */
+    hasMiddleware?: boolean;
+    /** True when build-time rewrites can affect the initial Pages Router ready state. */
+    hasRewrites?: boolean;
+    /** Server-resolved Pages route URL used to hydrate fallback shells behind rewrites. */
     routeUrl?: string;
   };
 } & NEXT_DATA;

package/dist/client/window-next.d.ts

@@ -55,11 +55,13 @@ type AppRouterPublicInstance = {
   forward: () => void;
   refresh: () => void;
   prefetch: (href: string, options?: {
+    kind?: "auto" | "full";
     onInvalidate?: () => void;
   }) => void;
   experimental_gesturePush?: (href: string, options?: {
     scroll?: boolean;
-  }) => void; /** Default placeholder, matches Next.js. */
+  }) => void;
+  /** Default placeholder, matches Next.js. */
   bfcacheId?: string;
 };
 /**
@@ -97,7 +99,8 @@ type PagesRouterPublicInstance = {
    * prefetch — App Router targets land here as `{ __appRouter: true }`.
    * See: `packages/next/src/shared/lib/router/router.ts:2525`.
    */
-  components: Record<string, unknown>; /** Persistent Pages Router static-data cache, matching Next.js `Router.sdc`. */
+  components: Record<string, unknown>;
+  /** Persistent Pages Router static-data cache, matching Next.js `Router.sdc`. */
   sdc: Record<string, Promise<Response>>;
 };
 declare global {

package/dist/config/config-matchers.d.ts

@@ -1,7 +1,6 @@
 import { HasCondition, NextHeader, NextI18nConfig, NextRedirect, NextRewrite } from "./next-config.js";
 import { RequestContext, normalizeHost, parseCookies, requestContextFromRequest } from "./request-context.js";
 import { isExternalUrl } from "../utils/external-url.js";
-
 //#region src/config/config-matchers.d.ts
 /**
  * Detect regex patterns vulnerable to catastrophic backtracking (ReDoS).
@@ -44,7 +43,8 @@ declare function escapeHeaderSource(source: string): string;
  * @see .nextjs-ref/packages/next/src/lib/load-custom-routes.ts:198-220
  */
 type BasePathMatchState = {
-  /** Configured `basePath` (without trailing slash) or "" when unset. */basePath: string;
+  /** Configured `basePath` (without trailing slash) or "" when unset. */
+  basePath: string;
   /**
    * True when the inbound request was originally under `basePath` (i.e.
    * the prod-server/handler stripped the prefix before the matcher runs).
@@ -69,9 +69,7 @@ type BasePathMatchState = {
  * individual header values), so the wider `string | string[]` type of
  * `middlewareHeaders` is safe to cast here.
  */
-declare function applyMiddlewareRequestHeaders(middlewareHeaders: Record<string, string | string[]>, request: Request, options?: {
-  preserveCredentialHeaders?: boolean;
-}): {
+declare function applyMiddlewareRequestHeaders(middlewareHeaders: Record<string, string | string[]>, request: Request): {
   request: Request;
   postMwReqCtx: RequestContext;
 };