vinext 0.1.7 → 0.2.0

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/typegen.js

@@ -1,5 +1,6 @@
 import { findDir } from "./utils/project.js";
 import { decodeRouteSegment, isInvisibleSegment } from "./routing/utils.js";
+import { normalizePathSeparators } from "./utils/path.js";
 import { patternToNextFormat } from "./routing/route-validation.js";
 import { compareStrings } from "./utils/compare.js";
 import "./routing/app-route-graph.js";
@@ -15,17 +16,17 @@ import "./.next/types/routes.d.ts";
 // see https://nextjs.org/docs/app/api-reference/config/typescript for more information.
 `;
 async function generateRouteTypes(options) {
-	const root = path.resolve(options.root);
-	const appDir = options.appDir ? path.resolve(options.appDir) : findDir(root, "app", path.join("src", "app"));
-	const outPath = path.join(root, ".next", "types", "routes.d.ts");
+	const root = normalizePathSeparators(path.resolve(options.root));
+	const appDir = options.appDir ? normalizePathSeparators(path.resolve(options.appDir)) : findDir(root, "app", "src/app");
+	const outPath = path.posix.join(root, ".next", "types", "routes.d.ts");
 	const content = appDir ? renderRouteTypes(await collectRouteTypeModel(appDir, options.pageExtensions)) : renderRouteTypes(emptyRouteTypeModel());
-	await fs.mkdir(path.dirname(outPath), { recursive: true });
+	await fs.mkdir(path.posix.dirname(outPath), { recursive: true });
 	await fs.writeFile(outPath, content, "utf-8");
 	await ensureNextEnvFile(root);
 	return outPath;
 }
 async function ensureNextEnvFile(root) {
-	const envPath = path.join(root, "next-env.d.ts");
+	const envPath = path.posix.join(root, "next-env.d.ts");
 	try {
 		await fs.writeFile(envPath, NEXT_ENV_FILE_CONTENT, {
 			encoding: "utf-8",

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);

package/dist/utils/path.d.ts

@@ -1,4 +1,5 @@
 //#region src/utils/path.d.ts
+declare const isWindows: boolean;
 /**
  * Convert Windows-style backslash path separators to forward slashes.
  *
@@ -19,4 +20,4 @@ declare function stripViteModuleQuery(id: string): string;
  *  files like `headers.js.ts`. */
 declare function stripJsExtension(name: string): string;
 //#endregion
-export { normalizePathSeparators, stripJsExtension, stripViteModuleQuery };
+export { isWindows, normalizePathSeparators, stripJsExtension, stripViteModuleQuery };

package/dist/utils/path.js

@@ -27,4 +27,4 @@ function stripJsExtension(name) {
 	return name.endsWith(".js") ? name.slice(0, -3) : name;
 }
 //#endregion
-export { normalizePathSeparators, stripJsExtension, stripViteModuleQuery };
+export { isWindows, normalizePathSeparators, stripJsExtension, stripViteModuleQuery };

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,15 +63,64 @@ 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
  * at the root or under `src/`.
+ *
+ * `root` and `candidates` must be forward-slash, and the returned path is
+ * forward-slash too: the candidate is joined with `path.posix.join`, which only
+ * stays canonical when its inputs already are.
  */
 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,16 +189,237 @@ 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,
 * or null. Used to locate conventional `app`/`pages` directories that may live
 * at the root or under `src/`.
+*
+* `root` and `candidates` must be forward-slash, and the returned path is
+* forward-slash too: the candidate is joined with `path.posix.join`, which only
+* stays canonical when its inputs already are.
 */
 function findDir(root, ...candidates) {
 	for (const candidate of candidates) {
-		const full = path.join(root, candidate);
+		const full = path.posix.join(root, candidate);
 		try {
 			if (fs.statSync(full).isDirectory()) return full;
 		} catch {}
@@ -205,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,17 @@
+//#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";
+/** 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";
+/** Generic prefix for all middleware internal headers. */
+declare const MIDDLEWARE_HEADER_PREFIX = "x-middleware-";
+//#endregion
+export { MIDDLEWARE_HEADER_PREFIX, MIDDLEWARE_OVERRIDE_HEADERS, MIDDLEWARE_REQUEST_HEADER_PREFIX, MIDDLEWARE_SET_COOKIE_HEADER, VINEXT_MW_CTX_HEADER, VINEXT_PRERENDER_ROUTE_PARAMS_HEADER, VINEXT_PRERENDER_SECRET_HEADER };

package/dist/utils/protocol-headers.js

@@ -0,0 +1,17 @@
+//#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";
+/** 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";
+/** Generic prefix for all middleware internal headers. */
+const MIDDLEWARE_HEADER_PREFIX = "x-middleware-";
+//#endregion
+export { MIDDLEWARE_HEADER_PREFIX, MIDDLEWARE_OVERRIDE_HEADERS, MIDDLEWARE_REQUEST_HEADER_PREFIX, MIDDLEWARE_SET_COOKIE_HEADER, VINEXT_MW_CTX_HEADER, VINEXT_PRERENDER_ROUTE_PARAMS_HEADER, VINEXT_PRERENDER_SECRET_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 };