vinext 0.1.8 → 0.2.1

package/dist/shims/server.js

@@ -1,7 +1,8 @@
 import { hasBasePath, stripBasePath } from "../utils/base-path.js";
 import { getRequestExecutionContext } from "./request-context.js";
-import { MIDDLEWARE_NEXT_HEADER, MIDDLEWARE_REWRITE_HEADER, MIDDLEWARE_SET_COOKIE_HEADER } from "../server/headers.js";
-import { encodeMiddlewareRequestHeaders } from "../server/middleware-request-headers.js";
+import { MIDDLEWARE_SET_COOKIE_HEADER } from "../utils/protocol-headers.js";
+import { MIDDLEWARE_NEXT_HEADER, MIDDLEWARE_REWRITE_HEADER } from "../server/headers.js";
+import { encodeMiddlewareRequestHeaders } from "../utils/middleware-request-headers.js";
 import { serializeSetCookie, validateCookieName } from "./internal/cookie-serialize.js";
 import { parseEdgeRequestCookieHeader } from "../utils/parse-cookie.js";
 import { assertSafeNavigationUrl } from "./url-safety.js";

package/dist/shims/slot.js

@@ -166,12 +166,9 @@ function mergeElements(prev, next, options = {}) {
 	const preserveElementIds = typeof options === "boolean" ? [] : options.preserveElementIds ?? [];
 	const preservePreviousSlotIds = typeof options === "boolean" ? [] : options.preservePreviousSlotIds ?? [];
 	const merged = { ...next };
-	for (const id of preserveElementIds) {
-		if (Object.hasOwn(merged, id)) continue;
-		if (Object.hasOwn(prev, id)) {
-			const value = prev[id];
-			if (value !== void 0) merged[id] = value;
-		}
+	for (const id of preserveElementIds) if (Object.hasOwn(prev, id)) {
+		const value = prev[id];
+		if (value !== void 0) merged[id] = value;
 	}
 	const slotKeys = new Set([...Object.keys(prev), ...Object.keys(next)].filter((key) => AppElementsWire.isSlotId(key)));
 	if (clearAbsentSlots) {

package/dist/shims/unified-request-context.js

@@ -36,6 +36,7 @@ function createRequestContext(opts) {
 		currentFetchCacheMode: null,
 		currentForceDynamicFetchDefault: false,
 		dynamicFetchUrls: /* @__PURE__ */ new Set(),
+		refreshStaleFetchesInForeground: false,
 		isFetchDedupeActive: false,
 		currentFetchDedupeEntries: /* @__PURE__ */ new Map(),
 		executionContext: _getInheritedExecutionContext(),

package/dist/typegen.js

@@ -1,6 +1,6 @@
 import { findDir } from "./utils/project.js";
-import { decodeRouteSegment, isInvisibleSegment } from "./routing/utils.js";
 import { normalizePathSeparators } from "./utils/path.js";
+import { decodeRouteSegment, isInvisibleSegment } from "./routing/utils.js";
 import { patternToNextFormat } from "./routing/route-validation.js";
 import { compareStrings } from "./utils/compare.js";
 import "./routing/app-route-graph.js";

package/dist/utils/client-runtime-metadata.d.ts

@@ -1,6 +1,7 @@
 //#region src/utils/client-runtime-metadata.d.ts
 type ClientRuntimeMetadata = {
   clientEntryFile?: string;
+  appBootstrapPreinitModules?: string[];
   lazyChunks?: string[];
   dynamicPreloads?: Record<string, string[]>;
 };
@@ -24,22 +25,5 @@ declare function computeClientRuntimeMetadata(opts: {
   assetPrefix: string;
   includeClientEntry?: boolean | "pages-client-entry";
 }): ClientRuntimeMetadata;
-/**
- * Serialize runtime metadata into the `globalThis.__VINEXT_*` assignment script
- * that the Cloudflare `closeBundle` hook prepends to the worker entry. Returns
- * `""` when there is nothing to inject.
- *
- * Both the App Router and Pages Router closeBundle paths call this (and the
- * deploy tests mirror it), so the injection shape stays in one place. The caller
- * decides which fields to pass — e.g. App Router only forwards `clientEntryFile`
- * for mixed app+pages builds (where `computeClientRuntimeMetadata` was asked for
- * the Pages client entry); pure App Router leaves it undefined.
- */
-declare function buildRuntimeGlobalsScript(input: {
-  clientEntryFile?: string | null;
-  ssrManifest?: Record<string, string[]> | null;
-  lazyChunks?: string[] | null;
-  dynamicPreloads?: Record<string, string[]> | null;
-}): string;
 //#endregion
-export { buildRuntimeGlobalsScript, computeClientRuntimeMetadata };
+export { computeClientRuntimeMetadata };

package/dist/utils/client-runtime-metadata.js

@@ -1,10 +1,34 @@
-import { resolveAssetsDir } from "./asset-prefix.js";
+import { isAbsoluteAssetPrefix, resolveAssetsDir } from "./asset-prefix.js";
 import { manifestFileWithAssetPrefix, manifestFileWithBase } from "./manifest-paths.js";
 import { findClientEntryFile, findPagesClientEntryFile, readClientBuildManifest } from "./client-build-manifest.js";
 import { findClientEntryFileFromVinextManifest, findPagesClientEntryFileFromVinextManifest, readClientEntryManifest } from "./client-entry-manifest.js";
 import { computeDynamicImportPreloads, computeLazyChunks, dynamicImportPreloadsWithBase } from "./lazy-chunks.js";
 import path from "node:path";
 //#region src/utils/client-runtime-metadata.ts
+function collectAppBootstrapPreinitModules(buildManifest, appBrowserEntry, applyBase) {
+	if (!appBrowserEntry) return void 0;
+	const entryKey = Object.keys(buildManifest).find((key) => buildManifest[key].file === appBrowserEntry);
+	if (!entryKey) return void 0;
+	const modules = [];
+	const seenFiles = /* @__PURE__ */ new Set();
+	const visitedChunks = /* @__PURE__ */ new Set();
+	function visit(key) {
+		if (visitedChunks.has(key)) return;
+		visitedChunks.add(key);
+		const chunk = buildManifest[key];
+		if (!chunk) return;
+		for (const importedKey of chunk.imports ?? []) {
+			const importedChunk = buildManifest[importedKey];
+			if (importedChunk?.file.endsWith(".js") && !seenFiles.has(importedChunk.file)) {
+				seenFiles.add(importedChunk.file);
+				modules.push(applyBase(importedChunk.file));
+			}
+			visit(importedKey);
+		}
+	}
+	visit(entryKey);
+	return modules.length > 0 ? modules : void 0;
+}
 /**
 * Read the client build manifest and compute runtime metadata used by
 * Cloudflare worker entry injection and Node production server startup.
@@ -21,9 +45,9 @@ import path from "node:path";
 */
 function computeClientRuntimeMetadata(opts) {
 	const buildManifest = readClientBuildManifest(path.join(opts.clientDir, ".vite", "manifest.json"));
+	const clientEntryManifest = readClientEntryManifest(opts.clientDir);
 	const metadata = {};
 	if (opts.includeClientEntry) {
-		const clientEntryManifest = readClientEntryManifest(opts.clientDir);
 		const entryOptions = {
 			buildManifest,
 			clientDir: opts.clientDir,
@@ -34,30 +58,15 @@ function computeClientRuntimeMetadata(opts) {
 		if (entry) metadata.clientEntryFile = entry;
 	}
 	if (!buildManifest) return metadata;
+	metadata.appBootstrapPreinitModules = collectAppBootstrapPreinitModules(buildManifest, clientEntryManifest?.appBrowserEntry, (file) => {
+		const url = manifestFileWithAssetPrefix(file, opts.assetBase, opts.assetPrefix);
+		return isAbsoluteAssetPrefix(opts.assetPrefix) ? url : "/" + url;
+	});
 	const lazyChunks = computeLazyChunks(buildManifest).map((file) => manifestFileWithBase(file, opts.assetBase));
 	if (lazyChunks.length > 0) metadata.lazyChunks = lazyChunks;
 	const dynamicPreloads = dynamicImportPreloadsWithBase(computeDynamicImportPreloads(buildManifest), (file) => manifestFileWithAssetPrefix(file, opts.assetBase, opts.assetPrefix));
 	if (Object.keys(dynamicPreloads).length > 0) metadata.dynamicPreloads = dynamicPreloads;
 	return metadata;
 }
-/**
-* Serialize runtime metadata into the `globalThis.__VINEXT_*` assignment script
-* that the Cloudflare `closeBundle` hook prepends to the worker entry. Returns
-* `""` when there is nothing to inject.
-*
-* Both the App Router and Pages Router closeBundle paths call this (and the
-* deploy tests mirror it), so the injection shape stays in one place. The caller
-* decides which fields to pass — e.g. App Router only forwards `clientEntryFile`
-* for mixed app+pages builds (where `computeClientRuntimeMetadata` was asked for
-* the Pages client entry); pure App Router leaves it undefined.
-*/
-function buildRuntimeGlobalsScript(input) {
-	const globals = [];
-	if (input.clientEntryFile) globals.push(`globalThis.__VINEXT_CLIENT_ENTRY__ = ${JSON.stringify(input.clientEntryFile)};`);
-	if (input.ssrManifest && Object.keys(input.ssrManifest).length > 0) globals.push(`globalThis.__VINEXT_SSR_MANIFEST__ = ${JSON.stringify(input.ssrManifest)};`);
-	if (input.lazyChunks && input.lazyChunks.length > 0) globals.push(`globalThis.__VINEXT_LAZY_CHUNKS__ = ${JSON.stringify(input.lazyChunks)};`);
-	if (input.dynamicPreloads && Object.keys(input.dynamicPreloads).length > 0) globals.push(`globalThis.__VINEXT_DYNAMIC_PRELOADS__ = ${JSON.stringify(input.dynamicPreloads)};`);
-	return globals.join("\n");
-}
 //#endregion
-export { buildRuntimeGlobalsScript, computeClientRuntimeMetadata };
+export { computeClientRuntimeMetadata };

package/dist/utils/dev-stack-sourcemap-endpoint.d.ts

@@ -0,0 +1,4 @@
+//#region src/utils/dev-stack-sourcemap-endpoint.d.ts
+declare const VINEXT_ORIGINAL_STACK_TRACE_ENDPOINT = "/__vinext_original-stack-trace";
+//#endregion
+export { VINEXT_ORIGINAL_STACK_TRACE_ENDPOINT };

package/dist/{server → utils}/dev-stack-sourcemap-endpoint.js

@@ -1,4 +1,4 @@
-//#region src/server/dev-stack-sourcemap-endpoint.ts
+//#region src/utils/dev-stack-sourcemap-endpoint.ts
 const VINEXT_ORIGINAL_STACK_TRACE_ENDPOINT = "/__vinext_original-stack-trace";
 //#endregion
 export { VINEXT_ORIGINAL_STACK_TRACE_ENDPOINT };

package/dist/utils/domain-locale.d.ts

@@ -1,7 +1,10 @@
-import { NextI18nConfig } from "../config/next-config.js";
-
 //#region src/utils/domain-locale.d.ts
-type DomainLocale = NonNullable<NextI18nConfig["domains"]>[number];
+type DomainLocale = {
+  domain: string;
+  defaultLocale: string;
+  locales?: string[];
+  http?: boolean;
+};
 declare function normalizeDomainHostname(hostname: string | null | undefined): string | undefined;
 /**
  * Match a configured domain either by hostname or locale.

package/dist/{server → utils}/middleware-request-headers.d.ts

@@ -1,4 +1,4 @@
-//#region src/server/middleware-request-headers.d.ts
+//#region src/utils/middleware-request-headers.d.ts
 type MiddlewareHeaderValue = string | string[];
 type MiddlewareHeaderSource = Headers | Record<string, MiddlewareHeaderValue>;
 type BuildRequestHeadersOptions = {

package/dist/{server → utils}/middleware-request-headers.js

@@ -1,5 +1,5 @@
-import { MIDDLEWARE_OVERRIDE_HEADERS, MIDDLEWARE_REQUEST_HEADER_PREFIX } from "./headers.js";
-//#region src/server/middleware-request-headers.ts
+import { MIDDLEWARE_OVERRIDE_HEADERS, MIDDLEWARE_REQUEST_HEADER_PREFIX } from "./protocol-headers.js";
+//#region src/utils/middleware-request-headers.ts
 const CREDENTIAL_REQUEST_HEADERS = ["authorization", "cookie"];
 function getMiddlewareHeaderValue(source, key) {
 	if (source instanceof Headers) return source.get(key);
@@ -59,7 +59,7 @@ function buildRequestHeadersFromMiddlewareResponse(baseHeaders, middlewareHeader
 	return nextHeaders;
 }
 function shouldKeepMiddlewareHeader(key) {
-	return key === "x-middleware-override-headers" || key === "x-middleware-set-cookie" || key.startsWith("x-middleware-request-");
+	return key === "x-middleware-override-headers" || key === "x-middleware-cache" || key === "x-middleware-set-cookie" || key.startsWith("x-middleware-request-");
 }
 //#endregion
 export { buildRequestHeadersFromMiddlewareResponse, encodeMiddlewareRequestHeaders, shouldKeepMiddlewareHeader };

package/dist/utils/project.d.ts

@@ -1,6 +1,7 @@
 //#region src/utils/project.d.ts
 /**
- * Shared project utilities — used by both `vinext init` and `vinext deploy`.
+ * Shared project utilities used by `vinext init`, the vinext plugin, and
+ * platform packages such as `@vinext/cloudflare`.
  *
  * These functions detect and modify project configuration without touching
  * any Next.js source files, config files, or tsconfig.json.
@@ -62,6 +63,49 @@ declare function findInNodeModules(start: string, subPath: string): string | nul
  * Check if a vite.config file exists in the project root.
  */
 declare function hasViteConfig(root: string): boolean;
+/** Return the config file Vite will load, using Vite's default precedence. */
+declare function findViteConfigPath(root: string): string | undefined;
+declare function formatMissingCloudflarePluginError(options: {
+  isAppRouter: boolean;
+  configFile?: string;
+}): string;
+type ProjectInfo = {
+  root: string;
+  isAppRouter: boolean;
+  isPagesRouter: boolean;
+  hasViteConfig: boolean;
+  hasWranglerConfig: boolean;
+  hasWorkerEntry: boolean;
+  hasCloudflarePlugin: boolean;
+  hasRscPlugin: boolean;
+  hasWrangler: boolean;
+  projectName: string; /** Pages that use `revalidate` (ISR) */
+  hasISR: boolean; /** package.json has "type": "module" */
+  hasTypeModule: boolean; /** .mdx files detected in app/ or pages/ */
+  hasMDX: boolean; /** CodeHike is a dependency */
+  hasCodeHike: boolean; /** Native Node modules that need stubbing for Workers */
+  nativeModulesToStub: string[];
+};
+/** Check whether a wrangler config file exists in the given directory. */
+declare function hasWranglerConfig(root: string): boolean;
+/**
+ * Detect the project structure, routing mode, relevant config files, and
+ * deploy-related dependencies. This lives in core because `vinext init`, the
+ * Vite plugin, and platform packages all need the same project facts.
+ */
+declare function detectProject(root: string): ProjectInfo;
+type MissingDep = {
+  name: string;
+  version: string;
+};
+/**
+ * Check if a package is resolvable from a given root directory using Node's
+ * module resolution. Handles hoisting, pnpm symlinks, monorepos, and Yarn PnP.
+ */
+declare function isPackageResolvable(root: string, packageName: string): boolean;
+declare function getMissingDeps(info: ProjectInfo, /** Override for testing — defaults to `isPackageResolvable` */
+
+_isResolvable?: (root: string, pkg: string) => boolean): MissingDep[];
 /**
  * Return the first candidate directory (resolved against `root`) that exists,
  * or null. Used to locate conventional `app`/`pages` directories that may live
@@ -74,7 +118,9 @@ declare function hasViteConfig(root: string): boolean;
 declare function findDir(root: string, ...candidates: string[]): string | null;
 /**
  * Check if the project uses App Router (has an app/ directory).
+ *
+ * `root` must be forward-slash — it is passed straight to `findDir`.
  */
 declare function hasAppDir(root: string): boolean;
 //#endregion
-export { detectPackageManager, detectPackageManagerName, ensureESModule, ensureViteConfigCompatibility, findDir, findInNodeModules, hasAppDir, hasViteConfig, renameCJSConfigs };
+export { ProjectInfo, detectPackageManager, detectPackageManagerName, detectProject, ensureESModule, ensureViteConfigCompatibility, findDir, findInNodeModules, findViteConfigPath, formatMissingCloudflarePluginError, getMissingDeps, hasAppDir, hasViteConfig, hasWranglerConfig, isPackageResolvable, renameCJSConfigs };

package/dist/utils/project.js

@@ -1,8 +1,10 @@
+import { createRequire } from "node:module";
 import fs from "node:fs";
 import path from "node:path";
 //#region src/utils/project.ts
 /**
-* Shared project utilities — used by both `vinext init` and `vinext deploy`.
+* Shared project utilities used by `vinext init`, the vinext plugin, and
+* platform packages such as `@vinext/cloudflare`.
 *
 * These functions detect and modify project configuration without touching
 * any Next.js source files, config files, or tsconfig.json.
@@ -187,7 +189,224 @@ function findInNodeModules(start, subPath) {
 * Check if a vite.config file exists in the project root.
 */
 function hasViteConfig(root) {
-	return fs.existsSync(path.join(root, "vite.config.ts")) || fs.existsSync(path.join(root, "vite.config.js")) || fs.existsSync(path.join(root, "vite.config.mjs"));
+	return findViteConfigPath(root) !== void 0;
+}
+/** Return the config file Vite will load, using Vite's default precedence. */
+function findViteConfigPath(root) {
+	return [
+		"vite.config.js",
+		"vite.config.mjs",
+		"vite.config.ts",
+		"vite.config.cjs",
+		"vite.config.mts",
+		"vite.config.cts"
+	].map((fileName) => path.join(root, fileName)).find((candidate) => fs.existsSync(candidate));
+}
+function formatMissingCloudflarePluginError(options) {
+	const cfArg = options.isAppRouter ? "{\n      viteEnvironment: { name: \"rsc\", childEnvironments: [\"ssr\"] },\n    }" : "";
+	const configRef = options.configFile ? options.configFile : "your Vite config";
+	return `[vinext] Missing @cloudflare/vite-plugin in ${configRef}.\n\n  Cloudflare Workers builds require the cloudflare() plugin.\n  Run \`vinext init --platform=cloudflare\` to update ${configRef}.\n\n  Expected plugin shape:\n\n    cloudflare(${cfArg})`;
+}
+/** Check whether a wrangler config file exists in the given directory. */
+function hasWranglerConfig(root) {
+	return fs.existsSync(path.join(root, "wrangler.jsonc")) || fs.existsSync(path.join(root, "wrangler.json")) || fs.existsSync(path.join(root, "wrangler.toml")) || fs.existsSync(path.join(root, "cloudflare.config.ts"));
+}
+/**
+* Detect the project structure, routing mode, relevant config files, and
+* deploy-related dependencies. This lives in core because `vinext init`, the
+* Vite plugin, and platform packages all need the same project facts.
+*/
+function detectProject(root) {
+	const hasApp = resolveProjectDir(root, "app") !== null;
+	const hasPages = resolveProjectDir(root, "pages") !== null;
+	const isAppRouter = hasApp;
+	const isPagesRouter = !hasApp && hasPages;
+	const hasViteConfigFile = hasViteConfig(root);
+	const wranglerConfigExists = hasWranglerConfig(root);
+	const hasWorkerEntry = fs.existsSync(path.join(root, "worker", "index.ts")) || fs.existsSync(path.join(root, "worker", "index.js"));
+	const hasCloudflarePlugin = findInNodeModules(root, "@cloudflare/vite-plugin") !== null;
+	const hasRscPlugin = findInNodeModules(root, "@vitejs/plugin-rsc") !== null;
+	const hasWrangler = findInNodeModules(root, ".bin/wrangler") !== null || findInNodeModules(root, ".bin/cf") !== null;
+	const pkgPath = path.join(root, "package.json");
+	let pkg = null;
+	if (fs.existsSync(pkgPath)) try {
+		pkg = JSON.parse(fs.readFileSync(pkgPath, "utf-8"));
+	} catch {}
+	let projectName = path.basename(root);
+	if (pkg?.name && typeof pkg.name === "string") projectName = pkg.name.replace(/^@[^/]+\//, "").toLowerCase().replace(/[^a-z0-9-]/g, "-").replace(/-+/g, "-").replace(/^-|-$/g, "");
+	const hasTypeModule = pkg?.type === "module";
+	let hasISR = false;
+	let hasMDX = detectMDXFromConfig(root);
+	if (isAppRouter) {
+		const appDir = resolveProjectDir(root, "app");
+		if (appDir) {
+			const found = scanTreeForDetection(appDir, {
+				isr: true,
+				mdx: !hasMDX
+			});
+			hasISR = found.isr;
+			hasMDX = hasMDX || found.mdx;
+		}
+	}
+	if (hasPages) {
+		const pagesDir = resolveProjectDir(root, "pages");
+		if (pagesDir) {
+			const found = scanTreeForDetection(pagesDir, {
+				isr: !hasISR,
+				mdx: !hasMDX
+			});
+			hasISR = hasISR || found.isr;
+			hasMDX = hasMDX || found.mdx;
+		}
+	}
+	hasISR = hasISR || detectCacheComponents(root);
+	const allDeps = {
+		...pkg?.dependencies,
+		...pkg?.devDependencies
+	};
+	const hasCodeHike = "codehike" in allDeps;
+	const nativeModulesToStub = detectNativeModules(allDeps);
+	return {
+		root,
+		isAppRouter,
+		isPagesRouter,
+		hasViteConfig: hasViteConfigFile,
+		hasWranglerConfig: wranglerConfigExists,
+		hasWorkerEntry,
+		hasCloudflarePlugin,
+		hasRscPlugin,
+		hasWrangler,
+		projectName,
+		hasISR,
+		hasTypeModule,
+		hasMDX,
+		hasCodeHike,
+		nativeModulesToStub
+	};
+}
+const ISR_PATTERN = /export\s+(?:const\s+revalidate\s*=|(?:async\s+)?function\s+getStaticProps\b|const\s+getStaticProps\s*=|\{[^}]*\bgetStaticProps\b[^}]*\})/;
+const ISR_SCANNABLE_EXTENSION = /\.(ts|tsx|js|jsx)$/;
+function resolveProjectDir(root, name) {
+	const rootDir = path.join(root, name);
+	try {
+		if (fs.statSync(rootDir).isDirectory()) return rootDir;
+	} catch {}
+	const srcDir = path.join(root, "src", name);
+	try {
+		if (fs.statSync(srcDir).isDirectory()) return srcDir;
+	} catch {}
+	return null;
+}
+function scanTreeForDetection(dir, want) {
+	const found = {
+		isr: false,
+		mdx: false
+	};
+	const walk = (current) => {
+		let entries;
+		try {
+			entries = fs.readdirSync(current, { withFileTypes: true });
+		} catch {
+			return;
+		}
+		for (const entry of entries) {
+			if ((!want.isr || found.isr) && (!want.mdx || found.mdx)) return;
+			const fullPath = path.join(current, entry.name);
+			if (entry.isDirectory()) {
+				if (entry.name.startsWith(".") || entry.name === "node_modules") continue;
+				walk(fullPath);
+			} else if (entry.isFile()) {
+				if (want.mdx && !found.mdx && entry.name.endsWith(".mdx")) found.mdx = true;
+				if (want.isr && !found.isr && ISR_SCANNABLE_EXTENSION.test(entry.name)) try {
+					if (ISR_PATTERN.test(fs.readFileSync(fullPath, "utf-8"))) found.isr = true;
+				} catch {}
+			}
+		}
+	};
+	walk(dir);
+	return found;
+}
+function detectMDXFromConfig(root) {
+	for (const f of [
+		"next.config.ts",
+		"next.config.mts",
+		"next.config.mjs",
+		"next.config.js",
+		"next.config.cjs"
+	]) {
+		const p = path.join(root, f);
+		if (fs.existsSync(p)) try {
+			const content = fs.readFileSync(p, "utf-8");
+			if (/pageExtensions.*mdx/i.test(content) || /@next\/mdx/.test(content)) return true;
+		} catch {}
+	}
+	return false;
+}
+function detectCacheComponents(root) {
+	for (const fileName of [
+		"next.config.ts",
+		"next.config.mts",
+		"next.config.mjs",
+		"next.config.js",
+		"next.config.cjs"
+	]) {
+		const configPath = path.join(root, fileName);
+		if (!fs.existsSync(configPath)) continue;
+		try {
+			if (/\bcacheComponents\s*:\s*true\b/.test(fs.readFileSync(configPath, "utf-8"))) return true;
+		} catch {}
+	}
+	return false;
+}
+const NATIVE_MODULES_TO_STUB = [
+	"@resvg/resvg-js",
+	"satori",
+	"lightningcss",
+	"@napi-rs/canvas",
+	"sharp"
+];
+function detectNativeModules(allDeps) {
+	return NATIVE_MODULES_TO_STUB.filter((mod) => mod in allDeps);
+}
+/**
+* Check if a package is resolvable from a given root directory using Node's
+* module resolution. Handles hoisting, pnpm symlinks, monorepos, and Yarn PnP.
+*/
+function isPackageResolvable(root, packageName) {
+	try {
+		createRequire(path.join(root, "package.json")).resolve(packageName);
+		return true;
+	} catch {
+		return false;
+	}
+}
+function getMissingDeps(info, _isResolvable = isPackageResolvable) {
+	const missing = [];
+	if (!info.hasCloudflarePlugin) missing.push({
+		name: "@cloudflare/vite-plugin",
+		version: "latest"
+	});
+	if (!info.hasWrangler) missing.push({
+		name: "wrangler",
+		version: "latest"
+	});
+	if (!_isResolvable(info.root, "@vitejs/plugin-react")) missing.push({
+		name: "@vitejs/plugin-react",
+		version: "latest"
+	});
+	if (info.isAppRouter && !info.hasRscPlugin) missing.push({
+		name: "@vitejs/plugin-rsc",
+		version: "latest"
+	});
+	if (info.isAppRouter && !_isResolvable(info.root, "react-server-dom-webpack")) missing.push({
+		name: "react-server-dom-webpack",
+		version: "latest"
+	});
+	if (info.hasMDX && !_isResolvable(info.root, "@mdx-js/rollup")) missing.push({
+		name: "@mdx-js/rollup",
+		version: "latest"
+	});
+	return missing;
 }
 /**
 * Return the first candidate directory (resolved against `root`) that exists,
@@ -209,9 +428,11 @@ function findDir(root, ...candidates) {
 }
 /**
 * Check if the project uses App Router (has an app/ directory).
+*
+* `root` must be forward-slash — it is passed straight to `findDir`.
 */
 function hasAppDir(root) {
-	return findDir(root, "app", path.join("src", "app")) !== null;
+	return findDir(root, "app", "src/app") !== null;
 }
 //#endregion
-export { detectPackageManager, detectPackageManagerName, ensureESModule, ensureViteConfigCompatibility, findDir, findInNodeModules, hasAppDir, hasViteConfig, renameCJSConfigs };
+export { detectPackageManager, detectPackageManagerName, detectProject, ensureESModule, ensureViteConfigCompatibility, findDir, findInNodeModules, findViteConfigPath, formatMissingCloudflarePluginError, getMissingDeps, hasAppDir, hasViteConfig, hasWranglerConfig, isPackageResolvable, renameCJSConfigs };

package/dist/utils/protocol-headers.d.ts

@@ -0,0 +1,23 @@
+//#region src/utils/protocol-headers.d.ts
+/** Serialized middleware context (JSON) forwarded from dev server to RSC entry. */
+declare const VINEXT_MW_CTX_HEADER = "x-vinext-mw-ctx";
+/** Build-time prerender authentication secret. */
+declare const VINEXT_PRERENDER_SECRET_HEADER = "x-vinext-prerender-secret";
+/** URL-encoded JSON route params for build-time prerender renders. */
+declare const VINEXT_PRERENDER_ROUTE_PARAMS_HEADER = "x-vinext-prerender-route-params";
+/** Indicates a build-time prerender render is probing whether a route can be static. */
+declare const VINEXT_PRERENDER_SPECULATIVE_HEADER = "x-vinext-prerender-speculative";
+/** Prefix for forwarded request headers (e.g. `x-middleware-request-cookie`). */
+declare const MIDDLEWARE_REQUEST_HEADER_PREFIX = "x-middleware-request-";
+/** Comma-separated list of header names that middleware wants to override. */
+declare const MIDDLEWARE_OVERRIDE_HEADERS = "x-middleware-override-headers";
+/** Carries cookies set by middleware for same-render reads. */
+declare const MIDDLEWARE_SET_COOKIE_HEADER = "x-middleware-set-cookie";
+/** Signals Pages Router prefetch cache opt-out. */
+declare const MIDDLEWARE_CACHE_HEADER = "x-middleware-cache";
+/** Skip-middleware signal. */
+declare const MIDDLEWARE_SKIP_HEADER = "x-middleware-skip";
+/** Generic prefix for all middleware internal headers. */
+declare const MIDDLEWARE_HEADER_PREFIX = "x-middleware-";
+//#endregion
+export { MIDDLEWARE_CACHE_HEADER, MIDDLEWARE_HEADER_PREFIX, MIDDLEWARE_OVERRIDE_HEADERS, MIDDLEWARE_REQUEST_HEADER_PREFIX, MIDDLEWARE_SET_COOKIE_HEADER, MIDDLEWARE_SKIP_HEADER, VINEXT_MW_CTX_HEADER, VINEXT_PRERENDER_ROUTE_PARAMS_HEADER, VINEXT_PRERENDER_SECRET_HEADER, VINEXT_PRERENDER_SPECULATIVE_HEADER };

package/dist/utils/protocol-headers.js

@@ -0,0 +1,23 @@
+//#region src/utils/protocol-headers.ts
+/** Serialized middleware context (JSON) forwarded from dev server to RSC entry. */
+const VINEXT_MW_CTX_HEADER = "x-vinext-mw-ctx";
+/** Build-time prerender authentication secret. */
+const VINEXT_PRERENDER_SECRET_HEADER = "x-vinext-prerender-secret";
+/** URL-encoded JSON route params for build-time prerender renders. */
+const VINEXT_PRERENDER_ROUTE_PARAMS_HEADER = "x-vinext-prerender-route-params";
+/** Indicates a build-time prerender render is probing whether a route can be static. */
+const VINEXT_PRERENDER_SPECULATIVE_HEADER = "x-vinext-prerender-speculative";
+/** Prefix for forwarded request headers (e.g. `x-middleware-request-cookie`). */
+const MIDDLEWARE_REQUEST_HEADER_PREFIX = "x-middleware-request-";
+/** Comma-separated list of header names that middleware wants to override. */
+const MIDDLEWARE_OVERRIDE_HEADERS = "x-middleware-override-headers";
+/** Carries cookies set by middleware for same-render reads. */
+const MIDDLEWARE_SET_COOKIE_HEADER = "x-middleware-set-cookie";
+/** Signals Pages Router prefetch cache opt-out. */
+const MIDDLEWARE_CACHE_HEADER = "x-middleware-cache";
+/** Skip-middleware signal. */
+const MIDDLEWARE_SKIP_HEADER = "x-middleware-skip";
+/** Generic prefix for all middleware internal headers. */
+const MIDDLEWARE_HEADER_PREFIX = "x-middleware-";
+//#endregion
+export { MIDDLEWARE_CACHE_HEADER, MIDDLEWARE_HEADER_PREFIX, MIDDLEWARE_OVERRIDE_HEADERS, MIDDLEWARE_REQUEST_HEADER_PREFIX, MIDDLEWARE_SET_COOKIE_HEADER, MIDDLEWARE_SKIP_HEADER, VINEXT_MW_CTX_HEADER, VINEXT_PRERENDER_ROUTE_PARAMS_HEADER, VINEXT_PRERENDER_SECRET_HEADER, VINEXT_PRERENDER_SPECULATIVE_HEADER };

package/dist/utils/react-version.d.ts

@@ -0,0 +1,4 @@
+//#region src/utils/react-version.d.ts
+declare function getReactUpgradeDeps(root: string): string[];
+//#endregion
+export { getReactUpgradeDeps };

package/dist/utils/react-version.js

@@ -0,0 +1,44 @@
+import { createRequire } from "node:module";
+import fs from "node:fs";
+import path from "node:path";
+//#region src/utils/react-version.ts
+function getDependencyUpgradeDeps(root, recommendations) {
+	const req = createRequire(path.join(root, "package.json"));
+	for (const [dependency, recommendation] of Object.entries(recommendations)) try {
+		const version = findPackageVersion(req.resolve(dependency), dependency);
+		if (version && isVersionBelow(version, recommendation.minimumVersion)) return recommendation.upgrades;
+	} catch {
+		continue;
+	}
+	return [];
+}
+function getReactUpgradeDeps(root) {
+	return getDependencyUpgradeDeps(root, { react: {
+		minimumVersion: [
+			19,
+			2,
+			6
+		],
+		upgrades: ["react@latest", "react-dom@latest"]
+	} });
+}
+function isVersionBelow(version, minimum) {
+	const current = version.split(".").map((part) => parseInt(part, 10));
+	for (let index = 0; index < minimum.length; index++) if ((current[index] ?? 0) !== minimum[index]) return (current[index] ?? 0) < minimum[index];
+	return false;
+}
+/** Walk up from a resolved module entry to find its package version. */
+function findPackageVersion(resolvedEntry, packageName) {
+	let dir = path.dirname(resolvedEntry);
+	while (dir !== path.dirname(dir)) {
+		const candidate = path.join(dir, "package.json");
+		try {
+			const pkg = JSON.parse(fs.readFileSync(candidate, "utf-8"));
+			if (pkg.name === packageName) return pkg.version ?? null;
+		} catch {}
+		dir = path.dirname(dir);
+	}
+	return null;
+}
+//#endregion
+export { getReactUpgradeDeps };

package/dist/utils/vite-version.d.ts

@@ -5,9 +5,11 @@ declare function getDepOptimizeNodeEnvOptions(viteMajorVersion: number, nodeEnvD
     transform: {
       define: Record<string, string>;
     };
+    moduleTypes?: Record<string, "jsx">;
   };
   esbuildOptions?: {
     define: Record<string, string>;
+    loader?: Record<string, "jsx">;
   };
 };
 /**