vinext 1.3.1 → 1.4.1

package/README.md

@@ -137,7 +137,7 @@ files to `.cjs`) when an unambiguous default Vite config requires the ESM migrat
 `"type": "commonjs"` is never changed. Direct `vite dev` and `vite build` do not perform these
 wrapper compatibility steps.
 
-`@vinext/cloudflare deploy` options: `--preview`, `--env <name>`, `--name <name>`, `--skip-build`, `--dry-run`, `--warm-cache`, `--traffic-aware-warm-cache`.
+`@vinext/cloudflare deploy` options: `--preview`, `--env <name>`, `--name <name>`, `--vite-config <path>`, `--skip-build`, `--dry-run`, `--warm-cache`, `--traffic-aware-warm-cache`.
 
 `vinext init` prompts for a deployment target, defaulting to Cloudflare. Agents must ask the
 user which target they want, then pass `--platform=cloudflare` or `--platform=node`.
@@ -147,6 +147,8 @@ Other options: `--port <port>` (default: 3001), `--skip-check`, `--force`.
 Cloudflare init uses `cf` and `cloudflare.config.ts` by default. Both `vinext init`
 and `create-vinext-app` accept `--legacy-wrangler-cloudflare-init` to retain the
 legacy Wrangler setup. Existing Wrangler configs are not automatically migrated.
+If a root Wrangler config belongs to another Worker, `vinext init --ignore-wrangler-config`
+sets up `cloudflare.config.ts` and leaves that file untouched.
 `vinext init --name <name>` sets the Worker name in the generated config instead of
 deriving it from `package.json`. An existing config keeps its own Worker name, and init
 prints a warning.
@@ -360,7 +362,8 @@ The init command also auto-detects and fixes common migration issues:
 - Resolves tsconfig.json path aliases automatically with Vite's native resolver
 - Detects MDX usage and configures `@mdx-js/rollup`
 - Renames CJS config files (postcss.config.js, etc.) to `.cjs` when needed
-- Detects native Node.js modules (sharp, resvg, satori, lightningcss, @napi-rs/canvas) and auto-stubs them for Workers. If you encounter others that need stubbing, PRs are welcome.
+
+vinext does not stub native Node.js modules such as `sharp`, `@resvg/resvg-js` or `@napi-rs/canvas`. Workers cannot load Node-API addons, so importing one into Worker code fails the build or the request. If a dependency imports one on a code path that never runs on Workers, alias it to a module of your own with `resolve.alias` in `vite.config.ts`. Configs generated by earlier versions of `vinext init` may contain `resolve.alias` entries pointing at `empty-stub.js`, a file init never created; delete them.
 
 Both App Router and Pages Router work on Workers with full client-side hydration.
 
@@ -656,26 +659,26 @@ Every `next/*` import is shimmed to a Vite-compatible implementation.
 
 ### Server features
 
-| Feature                                    |     | Notes                                                                                       |
-| ------------------------------------------ | --- | ------------------------------------------------------------------------------------------- |
-| SSR (Pages Router)                         | ✅  | Streaming, `_app`/`_document`, `__NEXT_DATA__`, hydration                                   |
-| SSR (App Router)                           | ✅  | RSC pipeline, nested layouts, streaming, nav context for client components                  |
-| `getStaticProps`                           | ✅  | Props, redirect, notFound, revalidate                                                       |
-| `getStaticPaths`                           | ✅  | `fallback: false`, `true`, `"blocking"`                                                     |
-| `getServerSideProps`                       | ✅  | Full context including locale                                                               |
-| ISR                                        | ✅  | Stale-while-revalidate, pluggable `CacheHandler`, background regeneration                   |
-| Server Actions (`"use server"`)            | ✅  | Action execution, FormData, re-render after mutation, `redirect()` in actions               |
-| React Server Components                    | ✅  | Via `@vitejs/plugin-rsc`. `"use client"` boundaries work correctly                          |
-| Streaming SSR                              | ✅  | Both routers                                                                                |
-| Metadata API                               | ✅  | `metadata`, `generateMetadata`, `viewport`, `generateViewport`, title templates             |
-| `generateStaticParams`                     | ✅  | With `dynamicParams` enforcement                                                            |
-| Metadata file routes                       | ✅  | sitemap.xml, robots.txt, manifest, favicon, OG images (static + dynamic)                    |
-| Static export (`output: 'export'`)         | ✅  | Generates static HTML/JSON for all routes                                                   |
-| Standalone output (`output: 'standalone'`) | ✅  | Generates `dist/standalone` with `server.js`, build artifacts, and runtime deps             |
-| `connection()`                             | ✅  | Forces dynamic rendering                                                                    |
-| `"use cache"` directive                    | ✅  | File-level and function-level. `cacheLife()` profiles, `cacheTag()`, stale-while-revalidate |
-| `instrumentation.ts`                       | ✅  | `register()`, `onRequestError()`, and [framework tracing](docs/tracing.mdx)                 |
-| Route segment config                       | 🟡  | `revalidate`, `dynamic`, `dynamicParams`, `runtime` (not placement). No `preferredRegion`   |
+| Feature                                    |     | Notes                                                                                                                                                                      |
+| ------------------------------------------ | --- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| SSR (Pages Router)                         | ✅  | Streaming, `_app`/`_document`, `__NEXT_DATA__`, hydration                                                                                                                  |
+| SSR (App Router)                           | ✅  | RSC pipeline, nested layouts, streaming, nav context for client components                                                                                                 |
+| `getStaticProps`                           | ✅  | Props, redirect, notFound, revalidate                                                                                                                                      |
+| `getStaticPaths`                           | ✅  | `fallback: false`, `true`, `"blocking"`                                                                                                                                    |
+| `getServerSideProps`                       | ✅  | Full context including locale                                                                                                                                              |
+| ISR                                        | ✅  | Stale-while-revalidate, pluggable `CacheHandler`, background regeneration                                                                                                  |
+| Server Actions (`"use server"`)            | ✅  | Action execution, FormData, re-render after mutation, `redirect()` in actions                                                                                              |
+| React Server Components                    | ✅  | Via `@vitejs/plugin-rsc`. `"use client"` boundaries work correctly                                                                                                         |
+| Streaming SSR                              | ✅  | Both routers                                                                                                                                                               |
+| Metadata API                               | ✅  | `metadata`, `generateMetadata`, `viewport`, `generateViewport`, title templates                                                                                            |
+| `generateStaticParams`                     | ✅  | With `dynamicParams` enforcement                                                                                                                                           |
+| Metadata file routes                       | ✅  | sitemap.xml, robots.txt, manifest, favicon, OG images (static + dynamic)                                                                                                   |
+| Static export (`output: 'export'`)         | ✅  | Generates static HTML/JSON for all routes                                                                                                                                  |
+| Standalone output (`output: 'standalone'`) | ✅  | Generates `dist/standalone` with `server.js`, build artifacts, and runtime deps                                                                                            |
+| `connection()`                             | ✅  | Forces dynamic rendering                                                                                                                                                   |
+| `"use cache"` directive                    | ✅  | File-level and function-level. `cacheLife()` with built-in and next.config `cacheLife` (or legacy `experimental.cacheLife`) profiles, `cacheTag()`, stale-while-revalidate |
+| `instrumentation.ts`                       | ✅  | `register()`, `onRequestError()`, and [framework tracing](docs/tracing.mdx)                                                                                                |
+| Route segment config                       | 🟡  | `revalidate`, `dynamic`, `dynamicParams`, `runtime` (not placement). No `preferredRegion`                                                                                  |
 
 ### Configuration
 

package/THIRD_PARTY_LICENSES.md

@@ -49,3 +49,50 @@ SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
 CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
 OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
 OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+## iconv-lite (version 0.4.24)
+
+Copyright (c) 2011 Alexander Shtuchkin
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+## safer-buffer (version 2.1.2)
+
+MIT License
+
+Copyright (c) 2018 Nikita Skovoroda <chalkerx@gmail.com>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/_virtual/_rolldown/runtime.js

@@ -1,4 +1,4 @@
-import "node:module";
+import { createRequire } from "node:module";
 //#region \0rolldown/runtime.js
 var __create = Object.create;
 var __defProp = Object.defineProperty;
@@ -21,5 +21,6 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 	value: mod,
 	enumerable: true
 }) : target, mod));
+var __require = /* #__PURE__ */ (() => createRequire(import.meta.url))();
 //#endregion
-export { __commonJSMin, __toESM };
+export { __commonJSMin, __require, __toESM };

package/dist/build/prerender.js

@@ -12,10 +12,10 @@ import { NoOpCacheHandler, getCacheHandler, setCacheHandler } from "../shims/cac
 import { headersContextFromRequest, runWithHeadersContext } from "../shims/headers.js";
 import { _consumeRequestScopedCacheLife } from "../shims/cache-request-state.js";
 import { normalizeStaticPathsEntry } from "../routing/route-pattern.js";
-import { createRscRequestUrl } from "../server/app-rsc-cache-busting.js";
 import { readPrerenderSecret } from "./server-manifest.js";
 import { buildPregeneratedConcretePathTable } from "../server/prerender-manifest.js";
 import { concatUint8Arrays, decodeRscEmbeddedChunk } from "../server/app-rsc-embedded-chunks.js";
+import { createRscRequestUrl } from "../server/app-rsc-cache-busting.js";
 import { navigationRuntimeRscBootstrapExpression } from "../server/app-ssr-stream.js";
 import { encodePrerenderRouteParams, serializePrerenderRouteParamsHeader } from "../server/prerender-route-params.js";
 import { startProdServer } from "../server/prod-server.js";
@@ -608,12 +608,13 @@ async function prerenderPages({ routes, apiRoutes, pagesDir, outDir, config, mod
 					fs.writeFileSync(htmlFullPath, html, "utf-8");
 					outputFiles.push(htmlOutputPath);
 				}
+				const renderedRevalidate = isStaticPropsResponse ? readPrerenderCacheLifeHeader(response.headers)?.revalidate ?? false : revalidate;
 				result = {
 					route: route.pattern,
 					status: "rendered",
 					outputFiles,
-					revalidate,
-					...typeof revalidate === "number" ? { expire: config.expireTime } : {},
+					revalidate: renderedRevalidate,
+					...typeof renderedRevalidate === "number" ? { expire: config.expireTime } : {},
 					router: "pages",
 					...urlPath !== route.pattern ? { path: urlPath } : {},
 					...locale ? { locale } : {},

package/dist/build/report.d.ts

@@ -1,5 +1,4 @@
 import { AppRoute } from "../routing/app-route-graph.js";
-import { LayoutBuildClassification } from "./layout-classification-types.js";
 import { Route } from "../routing/pages-router.js";
 import { PrerenderResult } from "./prerender.js";
 //#region src/build/report.d.ts
@@ -77,19 +76,6 @@ export declare function extractExportConstNumber(code: string, name: string): nu
  *   null     — no `revalidate` key found (fully static)
  */
 export declare function extractGetStaticPropsRevalidate(code: string): number | false | null;
-/**
- * Classifies a layout file by its segment config exports (`dynamic`, `revalidate`).
- *
- * Returns a tagged `LayoutBuildClassification` carrying both the decision and
- * the specific segment-config field that produced it. `{ kind: "absent" }`
- * means no segment config is present and the caller should defer to the next
- * layer (module graph analysis).
- *
- * Unlike page classification, positive `revalidate` values are not meaningful
- * for layout skip decisions — ISR is a page-level concept. Only the extremes
- * (`revalidate = 0` → dynamic, `revalidate = Infinity` → static) are decisive.
- */
-export declare function classifyLayoutSegmentConfig(code: string): LayoutBuildClassification;
 /**
  * Classifies a Pages Router page file by reading its source and examining
  * which data-fetching exports it contains.

package/dist/build/report.js

@@ -392,56 +392,6 @@ function propertyName(key) {
 	return null;
 }
 /**
-* Classifies a layout file by its segment config exports (`dynamic`, `revalidate`).
-*
-* Returns a tagged `LayoutBuildClassification` carrying both the decision and
-* the specific segment-config field that produced it. `{ kind: "absent" }`
-* means no segment config is present and the caller should defer to the next
-* layer (module graph analysis).
-*
-* Unlike page classification, positive `revalidate` values are not meaningful
-* for layout skip decisions — ISR is a page-level concept. Only the extremes
-* (`revalidate = 0` → dynamic, `revalidate = Infinity` → static) are decisive.
-*/
-function classifyLayoutSegmentConfig(code) {
-	const program = parseRouteModule(code);
-	const dynamicValue = program ? extractExportConstStringFromProgram(program, "dynamic") : null;
-	if (dynamicValue === "force-dynamic") return {
-		kind: "dynamic",
-		reason: {
-			layer: "segment-config",
-			key: "dynamic",
-			value: "force-dynamic"
-		}
-	};
-	if (dynamicValue === "force-static" || dynamicValue === "error") return {
-		kind: "static",
-		reason: {
-			layer: "segment-config",
-			key: "dynamic",
-			value: dynamicValue
-		}
-	};
-	const revalidateValue = program ? extractExportConstNumberFromProgram(program, "revalidate") : null;
-	if (revalidateValue === Infinity) return {
-		kind: "static",
-		reason: {
-			layer: "segment-config",
-			key: "revalidate",
-			value: Infinity
-		}
-	};
-	if (revalidateValue === 0) return {
-		kind: "dynamic",
-		reason: {
-			layer: "segment-config",
-			key: "revalidate",
-			value: 0
-		}
-	};
-	return { kind: "absent" };
-}
-/**
 * Classifies a Pages Router page file by reading its source and examining
 * which data-fetching exports it contains.
 *
@@ -675,4 +625,4 @@ async function printBuildReport(options) {
 	}
 }
 //#endregion
-export { buildReportRows, classifyAppRoute, classifyAppRouteHandler, classifyLayoutSegmentConfig, classifyPagesRoute, extractExportConstNumber, extractExportConstString, extractGetStaticPropsRevalidate, extractMiddlewareMatcherConfig, extractMiddlewareMatcherConfigValue, formatBuildReport, getAppRouteRenderEntryPath, hasExportedName, hasNamedExport, hasRuntimeExportedName, printBuildReport };
+export { buildReportRows, classifyAppRoute, classifyAppRouteHandler, classifyPagesRoute, extractExportConstNumber, extractExportConstString, extractGetStaticPropsRevalidate, extractMiddlewareMatcherConfig, extractMiddlewareMatcherConfigValue, formatBuildReport, getAppRouteRenderEntryPath, hasExportedName, hasNamedExport, hasRuntimeExportedName, printBuildReport };

package/dist/check.js

@@ -243,13 +243,10 @@ const CONFIG_SUPPORT = {
 		status: "unsupported",
 		detail: "ignored; configure cache adapters with vinext({ cache }) in vite.config"
 	},
-	cacheLife: {
-		status: "unsupported",
-		detail: "custom cacheLife profiles are ignored; only the built-in profiles are available"
-	},
+	cacheLife: { status: "supported" },
 	"experimental.cacheLife": {
-		status: "unsupported",
-		detail: "custom cacheLife profiles are ignored; only the built-in profiles are available"
+		status: "supported",
+		detail: "legacy alias of cacheLife"
 	},
 	skipTrailingSlashRedirect: { status: "supported" },
 	"experimental.skipTrailingSlashRedirect": {
@@ -438,7 +435,7 @@ const LIBRARY_SUPPORT = {
 	},
 	"next-intl": {
 		status: "supported",
-		detail: "createNextIntlPlugin is only optional with the request config at (src/)i18n/request.*; its experimental messages, precompile and extract options don't work (they need webpack/Turbopack loaders)"
+		detail: "createNextIntlPlugin is only optional with the request config at (src/)i18n/request.*; its experimental extract option doesn't work (it needs a webpack/Turbopack loader)"
 	},
 	"@clerk/nextjs": {
 		status: "supported",

package/dist/cli.js

@@ -284,6 +284,9 @@ function printHelp(cmd) {
                          (Response Store or Workers Cache, default: prompt with No)
     --legacy-wrangler-cloudflare-init
                          Use the legacy Wrangler setup instead of cf
+    --ignore-wrangler-config
+                         Set up cf even if a root Wrangler config exists
+                         (use when it belongs to an unrelated Worker)
     --cdn-cache <type>   Cloudflare CDN cache: none, response-store, workers-cache,
                          static-assets, or data-cache
                          (default: none; response-store is the default cache choice)

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

@@ -3,6 +3,7 @@ export type Source = "server" | "vite" | "uncaught" | "caught" | "window-error"
 export type ReportedError = {
   id: number;
   source: Source;
+  name: string | undefined;
   message: string;
   stack: string | undefined;
   ignoredStackFrames: boolean[] | undefined;

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

@@ -1,9 +1,11 @@
 import { ReportedError, dismissOverlay } from "./dev-error-overlay-store.js";
+import { InitialDevServerErrorPayload } from "../server/dev-initial-server-error.js";
 //#region src/client/dev-error-overlay.d.ts
 export declare const DEV_ERROR_OVERLAY_HOST_ID = "__vinext_dev_error_overlay_root";
 export declare const DEV_ERROR_OVERLAY_MOUNT_ID = "__vinext_dev_error_overlay_mount";
 export declare function installDevErrorOverlay(): void;
 export declare function installReactRefreshErrorRecovery(): void;
+export declare function selectUnreportedInitialDevServerErrors(payloads: readonly InitialDevServerErrorPayload[], reported: readonly ReportedError[]): InitialDevServerErrorPayload[];
 export declare function reportInitialDevServerErrors(): void;
 type ViteHmrErrorPayload = {
   err?: ViteHmrError;

package/dist/client/dev-error-overlay.js

@@ -1,7 +1,7 @@
 import { isNavigationSignalError } from "../utils/navigation-signal.js";
-import { VINEXT_DEV_ERROR_RECOVERY_EVENT } from "../utils/dev-error-recovery-event.js";
 import { VINEXT_ORIGINAL_STACK_TRACE_ENDPOINT } from "../utils/dev-stack-sourcemap-endpoint.js";
 import { dismissOverlay, expandOverlay, getOverlaySnapshot, minimizeOverlay, reportToOverlay, setOverlayIndex, subscribeOverlay, updateOverlayErrorStack } from "./dev-error-overlay-store.js";
+import { VINEXT_DEV_ERROR_RECOVERY_EVENT } from "../utils/dev-error-recovery-event.js";
 import { Fragment, useEffect, useMemo, useState, useSyncExternalStore } from "react";
 import { Fragment as Fragment$1, jsx, jsxs } from "react/jsx-runtime";
 import { createRoot } from "react-dom/client";
@@ -11,6 +11,7 @@ const DEV_ERROR_OVERLAY_MOUNT_ID = "__vinext_dev_error_overlay_mount";
 const VITE_ERROR_HANDLER_DATA_KEY = "__vinext_vite_error_handler__";
 const REACT_REFRESH_RECOVERY_RETRY_DELAY_MS = 16;
 let reactRoot = null;
+let overlayHost = null;
 let installed = false;
 const reportedErrors = /* @__PURE__ */ new WeakSet();
 function rememberReported(error) {
@@ -81,12 +82,21 @@ function tryInstallReactRefreshErrorRecovery() {
 	});
 	return true;
 }
+function selectUnreportedInitialDevServerErrors(payloads, reported) {
+	const rethrownErrors = reported.filter((error) => error.source === "caught" || error.source === "uncaught" || error.source === "window-error");
+	return payloads.filter((payload) => {
+		const rethrownIndex = rethrownErrors.findIndex((error) => error.message === payload.message && (error.name || "Error") === (payload.name || "Error"));
+		if (rethrownIndex === -1) return true;
+		rethrownErrors.splice(rethrownIndex, 1);
+		return false;
+	});
+}
 function reportInitialDevServerErrors() {
 	if (typeof window === "undefined") return;
 	const errors = window.__VINEXT_INITIAL_DEV_ERRORS__;
 	if (!errors || errors.length === 0) return;
 	window.__VINEXT_INITIAL_DEV_ERRORS__ = [];
-	for (const payload of errors) {
+	for (const payload of selectUnreportedInitialDevServerErrors(errors, getOverlaySnapshot().errors)) {
 		const error = new Error(payload.message);
 		if (payload.name) error.name = payload.name;
 		if (payload.stack) error.stack = payload.stack;
@@ -130,6 +140,7 @@ function reportDevError(error, options) {
 	ensureMounted();
 	const id = reportToOverlay({
 		source: options.source,
+		name: error instanceof Error ? error.name : void 0,
 		message,
 		stack,
 		ignoredStackFrames: void 0,
@@ -176,8 +187,13 @@ function stringValue(value) {
 	return typeof value === "string" && value.length > 0 ? value : void 0;
 }
 function ensureMounted() {
-	if (reactRoot) return;
+	if (reactRoot) {
+		const host = overlayHost;
+		if (host && !host.isConnected) (document.body ?? document.documentElement).appendChild(host);
+		return;
+	}
 	const node = createDevErrorOverlayMountNode(document);
+	overlayHost = document.getElementById(DEV_ERROR_OVERLAY_HOST_ID);
 	reactRoot = createRoot(node);
 	reactRoot.render(/* @__PURE__ */ jsx(DevErrorOverlayApp, {}));
 }
@@ -1342,4 +1358,4 @@ const componentStackStyle = {
 	color: "var(--vinext-overlay-muted)"
 };
 //#endregion
-export { DEV_ERROR_OVERLAY_HOST_ID, DEV_ERROR_OVERLAY_MOUNT_ID, createDevErrorOverlayMountNode, createViteOpenInEditorUrl, devOnCaughtError, devOnUncaughtError, dismissOverlay, formatErrorInfoForClipboard, formatOverlayDisplayFile, formatViteOpenInEditorFile, installDevErrorOverlay, installReactRefreshErrorRecovery, installViteHmrErrorHandler, normalizeViteHmrError, reportInitialDevServerErrors };
+export { DEV_ERROR_OVERLAY_HOST_ID, DEV_ERROR_OVERLAY_MOUNT_ID, createDevErrorOverlayMountNode, createViteOpenInEditorUrl, devOnCaughtError, devOnUncaughtError, dismissOverlay, formatErrorInfoForClipboard, formatOverlayDisplayFile, formatViteOpenInEditorFile, installDevErrorOverlay, installReactRefreshErrorRecovery, installViteHmrErrorHandler, normalizeViteHmrError, reportInitialDevServerErrors, selectUnreportedInitialDevServerErrors };

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

@@ -1,5 +1,6 @@
 import { BrowserRouteManifest, BrowserRouteManifestWire } from "../routing/browser-route-manifest.js";
 import { AppRouterScrollIntent } from "../shims/app-router-scroll-state.js";
+import { CachedRscResponse } from "../shims/navigation.js";
 //#region src/client/navigation-runtime.d.ts
 type NavigationRuntimeSnapshot = {
   pathname: string;
@@ -42,7 +43,9 @@ type NavigationRuntimeTraversalIntent = {
 };
 export type NavigationRuntimeNavigate = (href: string, redirectDepth?: number, navigationKind?: NavigationRuntimeKind, historyUpdateMode?: NavigationRuntimeHistoryUpdateMode, previousNextUrlOverride?: string | null, programmaticTransition?: boolean, traversalIntent?: NavigationRuntimeTraversalIntent, scrollIntent?: AppRouterScrollIntent | null, visibleCommitMode?: NavigationRuntimeVisibleCommitMode, bypassNavigationCache?: boolean) => Promise<void>;
 export type NavigationRuntimeFunctions = {
-  clearNavigationCaches?: () => void;
+  clearNavigationCaches?: (options?: {
+    pingVisibleLinks?: boolean;
+  }) => void;
   commitHashNavigation?: (href: string, historyUpdateMode: NavigationRuntimeHistoryUpdateMode, scroll: boolean) => void;
   navigateExternal?: (href: string, historyUpdateMode: NavigationRuntimeHistoryUpdateMode) => Promise<void>;
   navigate?: NavigationRuntimeNavigate;
@@ -57,6 +60,15 @@ export type NavigationRuntimeFunctions = {
   notifyLinkNavigationStart?: () => void;
   pingVisibleLinks?: () => void;
   preparePrefetchResponse?: (response: Response) => Promise<unknown>;
+  /**
+   * The visited (BFCache) response a full prefetch can be fulfilled from, and
+   * until when a navigation would still reuse it (null if it wouldn't).
+   */
+  readVisitedResponseForFullPrefetch?: (rscUrls: readonly string[], interceptionContext: string | null, mountedSlotsHeader: string | null) => {
+    navigatedAt: number;
+    navigationFreshUntil: number | null;
+    response: CachedRscResponse;
+  } | null;
   claimCurrentHistoryTreeSnapshot?: (historyUpdateMode: NavigationRuntimeHistoryUpdateMode, previousHistoryState: unknown) => void;
   commitAppOwnedHistoryStateWrite?: (historyUpdateMode: NavigationRuntimeHistoryUpdateMode, previousHistoryState: unknown) => void;
   /**

package/dist/client/navigation-runtime.js

@@ -26,7 +26,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, "getPrefetchRouterState")) && isOptionalRuntimeFunction(Reflect.get(value, "notifyLinkNavigationStart")) && isOptionalRuntimeFunction(Reflect.get(value, "pingVisibleLinks")) && isOptionalRuntimeFunction(Reflect.get(value, "preparePrefetchResponse")) && isOptionalRuntimeFunction(Reflect.get(value, "claimCurrentHistoryTreeSnapshot")) && isOptionalRuntimeFunction(Reflect.get(value, "commitAppOwnedHistoryStateWrite")) && isOptionalRuntimeFunction(Reflect.get(value, "discardPendingNavigation")) && isOptionalRuntimeFunction(Reflect.get(value, "flushCommittingNavigationUrl")) && isOptionalRuntimeFunction(Reflect.get(value, "loadRouteManifest"));
+	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")) && isOptionalRuntimeFunction(Reflect.get(value, "readVisitedResponseForFullPrefetch")) && isOptionalRuntimeFunction(Reflect.get(value, "claimCurrentHistoryTreeSnapshot")) && isOptionalRuntimeFunction(Reflect.get(value, "commitAppOwnedHistoryStateWrite")) && isOptionalRuntimeFunction(Reflect.get(value, "discardPendingNavigation")) && isOptionalRuntimeFunction(Reflect.get(value, "flushCommittingNavigationUrl")) && isOptionalRuntimeFunction(Reflect.get(value, "loadRouteManifest"));
 }
 function isNavigationRuntimeRscChunk(value) {
 	if (typeof value === "string") return true;

package/dist/config/config-matchers.js

@@ -759,8 +759,10 @@ async function proxyExternalRequest(request, externalUrl) {
 	const destinationKeys = new Set(targetUrl.searchParams.keys());
 	for (const [key, value] of originalUrl.searchParams) if (!destinationKeys.has(key)) targetUrl.searchParams.append(key, value);
 	const headers = new Headers(request.headers);
+	const requestHost = headers.get("host") ?? "";
 	headers.set("host", targetUrl.host);
 	stripHopByHopRequestHeaders(headers);
+	headers.set("x-forwarded-host", requestHost);
 	const keysToDelete = [];
 	for (const key of headers.keys()) if (key.startsWith("x-middleware-") && !key.startsWith("x-middleware-request-")) keysToDelete.push(key);
 	for (const key of keysToDelete) headers.delete(key);

package/dist/config/destination-params.d.ts

@@ -25,7 +25,8 @@
  * `%XX` escapes a raw path capture already carries. A decoded `has` capture
  * carrying `#`, `/`, `?`, `@` or `:` then makes the host invalid instead of
  * moving the proxy to another host. Next.js substitutes the hostname verbatim
- * and can be retargeted this way; vinext is stricter.
+ * and can be retargeted this way; vinext is stricter. Params in a rewrite's
+ * path follow substituteRewritePath.
  *
  * https://github.com/vercel/next.js/blob/canary/packages/next/src/shared/lib/router/utils/prepare-destination.ts
  * https://github.com/vercel/next.js/blob/canary/packages/next/src/server/server-route-utils.ts

package/dist/config/destination-params.js

@@ -33,7 +33,8 @@ const _compiledDestinationParamCache = /* @__PURE__ */ new Map();
 * `%XX` escapes a raw path capture already carries. A decoded `has` capture
 * carrying `#`, `/`, `?`, `@` or `:` then makes the host invalid instead of
 * moving the proxy to another host. Next.js substitutes the hostname verbatim
-* and can be retargeted this way; vinext is stricter.
+* and can be retargeted this way; vinext is stricter. Params in a rewrite's
+* path follow substituteRewritePath.
 *
 * https://github.com/vercel/next.js/blob/canary/packages/next/src/shared/lib/router/utils/prepare-destination.ts
 * https://github.com/vercel/next.js/blob/canary/packages/next/src/server/server-route-utils.ts
@@ -49,7 +50,56 @@ function substituteDestinationParams(destination, params, kind) {
 	const queryIndex = beforeHash.indexOf("?");
 	const beforeQuery = queryIndex === -1 ? beforeHash : beforeHash.slice(0, queryIndex);
 	const authorityEnd = getAbsoluteUrlAuthorityEnd(beforeQuery.replace(paramRe, (token) => "x".repeat(token.length)));
-	return `${`${replaceParams(beforeQuery.slice(0, authorityEnd), encodeAuthorityParam)}${replaceParams(beforeQuery.slice(authorityEnd), (value) => value)}`}${queryIndex === -1 ? "" : `?${replaceParams(beforeHash.slice(queryIndex + 1), encodeRewriteQueryParamValue)}`}${replaceParams(hash, (value) => value)}`;
+	const [path, pathHash] = substituteRewritePath(beforeQuery.slice(authorityEnd), paramRe, params, authorityEnd > 0);
+	const query = queryIndex === -1 ? "" : `?${replaceParams(beforeHash.slice(queryIndex + 1), encodeRewriteQueryParamValue)}`;
+	return `${replaceParams(beforeQuery.slice(0, authorityEnd), encodeAuthorityParam)}${path}${query}${pathHash ?? replaceParams(hash, (value) => value)}`;
+}
+/**
+* Substitute params into a rewrite destination's path, returning the path and,
+* when a param carried a `#`, the hash it starts.
+*
+* Next.js inserts path params verbatim, splits the result at the first `#`
+* and escapes a `?` when it formats the URL. A decoded `has` capture can end
+* the path with `#`, but neither `?` nor `#` can displace the destination's
+* own query.
+*
+* An absolute destination is proxied with the URL parser, which removes tab
+* and newlines, trims trailing control characters and spaces, and resolves
+* `.`/`..` segments against the destination's literal path. Next.js sends a
+* param's control characters and spaces percent-encoded, as vinext does, and
+* its dot segments as written. A parsed URL cannot carry a `..` segment, so a
+* dot segment that a param is in or next to is escaped once more (`.` as
+* `%252E`, `%2e` as `%252e`) and stays inside the destination's path. The
+* destination's own dot segments still resolve.
+*
+* https://github.com/vercel/next.js/blob/canary/packages/next/src/shared/lib/router/utils/prepare-destination.ts
+* https://github.com/vercel/next.js/blob/canary/packages/next/src/shared/lib/router/utils/format-url.ts
+*/
+function substituteRewritePath(template, paramRe, params, absolute) {
+	const encodeParam = absolute ? encodeAbsoluteUrlPathParam : encodePathQueryDelimiter;
+	const paramRanges = [];
+	let substituted = "";
+	let templateIndex = 0;
+	for (const match of template.matchAll(paramRe)) {
+		substituted += template.slice(templateIndex, match.index);
+		const value = encodeParam(params[match[1]]);
+		paramRanges.push([substituted.length, substituted.length + value.length]);
+		substituted += value;
+		templateIndex = match.index + match[0].length;
+	}
+	substituted += template.slice(templateIndex);
+	const [path, hash] = substituted.split("#", 2);
+	const pathHash = hash === void 0 ? void 0 : hash ? `#${hash}` : "";
+	if (!absolute) return [path, pathHash];
+	return [path.replace(DOT_SEGMENT_RE, (segment, offset) => paramRanges.some(([start, end]) => start <= offset + segment.length && end >= offset) ? segment.replace(/\.|%(?=2e)/gi, (char) => char === "." ? "%252E" : "%25") : segment), pathHash];
+}
+const DOT_SEGMENT_RE = /(?<=^|[/\\])(?:\.|%2e){1,2}(?=[/\\]|$)/gi;
+function encodePathQueryDelimiter(value) {
+	return value.replaceAll("?", "%3F");
+}
+const ABSOLUTE_URL_PATH_PARAM_UNSAFE_RE = /[?\u0000- ]/g;
+function encodeAbsoluteUrlPathParam(value) {
+	return value.replace(ABSOLUTE_URL_PATH_PARAM_UNSAFE_RE, encodeURIComponent);
 }
 function getAbsoluteUrlAuthorityEnd(value) {
 	const scheme = /^[a-z][a-z0-9+.-]*:[/\\\t\n\r]*/i.exec(value);

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

@@ -1,3 +1,4 @@
+import { CacheLifeConfig } from "../utils/cache-life-profiles.js";
 import { PHASE_PRODUCTION_BUILD } from "../shims/constants.js";
 import { PluginOption } from "vite";
 //#region src/config/next-config.d.ts
@@ -102,6 +103,18 @@ export type MdxOptions = {
   rehypePlugins?: unknown[];
   recmaPlugins?: unknown[];
 };
+/**
+ * The webpack/Turbopack rule `createNextIntlPlugin` adds for its
+ * `experimental.messages` catalogs. vinext runs the same loader on the files it matches.
+ */
+export type NextIntlCatalogLoader = {
+  /** Absolute catalog directories (the rule's `include`). */
+  include: string[];
+  /** Catalog file extension test (the rule's `test`). */
+  test: RegExp;
+  /** The loader's `options`. */
+  options: Record<string, unknown>;
+};
 export type PrefetchInliningConfig = false | {
   maxBundleSize: number;
   maxSize: number;
@@ -352,6 +365,11 @@ export type ResolvedNextConfig = {
   /** Server globals injected into instrumentation.ts by wrapped webpack configs. */
   instrumentationServerValueInjections: Record<string, unknown>;
   cacheComponents: boolean;
+  /**
+   * `experimental.cachedNavigations`: lets the client cache the static stage of
+   * navigation responses. Requires `cacheComponents`.
+   */
+  cachedNavigations: boolean;
   appNavFailHandling: boolean;
   /**
    * Enables the experimental App Router gesture transition API:
@@ -374,6 +392,8 @@ export type ResolvedNextConfig = {
   i18n: NextI18nConfig | null;
   /** MDX remark/rehype/recma plugins extracted from @next/mdx config */
   mdx: MdxOptions | null;
+  /** next-intl's message catalog loader rule from `createNextIntlPlugin`. */
+  nextIntlCatalogLoader: NextIntlCatalogLoader | null;
   /** Explicit module aliases preserved from wrapped next.config plugins. */
   aliases: Record<string, string>;
   /** Extra allowed origins for dev server access (from allowedDevOrigins). */
@@ -532,6 +552,11 @@ export type ResolvedNextConfig = {
     dynamic: number;
     static: number;
   };
+  /**
+   * `cacheLife` profiles (or legacy `experimental.cacheLife`) merged over the
+   * built-ins with Next.js's rules; read by the `cacheLife()` shim.
+   */
+  cacheLife: Record<string, CacheLifeConfig>;
   /**
    * Mirrors Next.js `experimental.useLightningcss`. When `true`, switch
    * Vite's CSS pipeline from PostCSS to lightningcss for both transforms