vinext 1.0.0-beta.8 → 1.0.0

package/dist/utils/prerender-output-paths.js

@@ -3,18 +3,25 @@
 * Determine the HTML output file path for a prerendered URL.
 * Respects trailingSlash config.
 */
-function getOutputPath(urlPath, trailingSlash) {
-	if (urlPath === "/") return "index.html";
-	const clean = urlPath.replace(/^\//, "");
+function getOutputPath(urlPath, trailingSlash, basePath = "") {
+	if (urlPath === "/" && basePath === "") return "index.html";
+	const clean = (basePath === "" ? urlPath : urlPath === "/" ? trailingSlash ? `${basePath}/` : basePath : `${basePath}${urlPath}`).replace(/^\//, "").replace(/\/$/, "");
 	if (trailingSlash) return `${clean}/index.html`;
 	return `${clean}.html`;
 }
-/**
-* Determine the RSC output file path for a prerendered URL.
-* "/blog/hello-world" -> "blog/hello-world.rsc"
-* "/"                 -> "index.rsc"
-*/
-function getRscOutputPath(urlPath) {
+/** Determine the Flight payload path for a prerendered App Router URL. */
+function getRscOutputPath(urlPath, options = {
+	mode: "default",
+	trailingSlash: false
+}) {
+	if (options.mode === "export") {
+		if (urlPath === "/") {
+			const cleanBasePath = options.basePath?.replace(/^\//, "");
+			return cleanBasePath ? `${cleanBasePath}/index.txt` : "index.txt";
+		}
+		const clean = (options.basePath ? `${options.basePath}${urlPath}` : urlPath).replace(/^\//, "").replace(/\/$/, "");
+		return options.trailingSlash ? `${clean}/index.txt` : `${clean}.txt`;
+	}
 	if (urlPath === "/") return "index.rsc";
 	return urlPath.replace(/^\//, "") + ".rsc";
 }

package/dist/utils/project.d.ts

@@ -10,29 +10,19 @@
  * Ensure package.json has "type": "module".
  * Returns true if it was added (i.e. it wasn't already there).
  */
-declare function ensureESModule(root: string): boolean;
+export declare function ensureESModule(root: string): boolean;
 /**
  * Rename CJS config files (that use `module.exports`) to .cjs
  * to avoid breakage when "type": "module" is added.
  * Returns array of [oldName, newName] pairs that were renamed.
  */
-declare function renameCJSConfigs(root: string): Array<[string, string]>;
-/**
- * Ensure the project is configured for ESM before Vite loads vite.config.ts.
- *
- * This mirrors what `vinext init` does, but is applied lazily at dev/build
- * time for projects that were set up before `vinext init` added the step.
- *
- * Side effects: may rename `.js` CJS config files to `.cjs` and add
- * `"type": "module"` to package.json.
- *
- * @returns Object describing what was changed, or null if nothing was done.
- */
-declare function ensureViteConfigCompatibility(root: string): {
+export declare function renameCJSConfigs(root: string): Array<[string, string]>;
+/** Preserve the old CLI's ESM migration for projects with a legacy Vite config. */
+export declare function ensureViteConfigCompatibility(root: string): {
   renamed: Array<[string, string]>;
   addedTypeModule: boolean;
 } | null;
-type PackageManagerName = "pnpm" | "yarn" | "bun" | "npm";
+export type PackageManagerName = "pnpm" | "yarn" | "bun" | "npm";
 /**
  * Detect which package manager name is used.
  * Priority:
@@ -41,12 +31,12 @@ type PackageManagerName = "pnpm" | "yarn" | "bun" | "npm";
  * 3) invoking CLI user agent (npm_config_user_agent)
  * 4) npm fallback
  */
-declare function detectPackageManagerName(root: string, env?: Record<string, string | undefined>): PackageManagerName;
+export declare function detectPackageManagerName(root: string, env?: Record<string, string | undefined>): PackageManagerName;
 /**
  * Detect which package manager install command to use.
  * Returns the dev-install command string (e.g. "pnpm add -D").
  */
-declare function detectPackageManager(root: string): string;
+export declare function detectPackageManager(root: string): string;
 /**
  * Walk from `start` up to the filesystem root looking for a path inside
  * node_modules. Returns the first absolute path found, or null.
@@ -58,18 +48,18 @@ declare function detectPackageManager(root: string): string;
  * @param subPath - Path relative to a node_modules dir, e.g. ".bin/wrangler"
  *                  or "@cloudflare/vite-plugin"
  */
-declare function findInNodeModules(start: string, subPath: string): string | null;
+export declare function findInNodeModules(start: string, subPath: string): string | null;
 /**
  * Check if a vite.config file exists in the project root.
  */
-declare function hasViteConfig(root: string): boolean;
+export 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: {
+export declare function findViteConfigPath(root: string): string | undefined;
+export declare function formatMissingCloudflarePluginError(options: {
   isAppRouter: boolean;
   configFile?: string;
 }): string;
-type ProjectInfo = {
+export type ProjectInfo = {
   root: string;
   isAppRouter: boolean;
   isPagesRouter: boolean;
@@ -92,13 +82,13 @@ type ProjectInfo = {
   nativeModulesToStub: string[];
 };
 /** Check whether a wrangler config file exists in the given directory. */
-declare function hasWranglerConfig(root: string): boolean;
+export 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;
+export declare function detectProject(root: string): ProjectInfo;
 type MissingDep = {
   name: string;
   version: string;
@@ -107,8 +97,8 @@ type MissingDep = {
  * 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,
+export declare function isPackageResolvable(root: string, packageName: string): boolean;
+export declare function getMissingDeps(info: ProjectInfo,
 /** Override for testing — defaults to `isPackageResolvable` */
 _isResolvable?: (root: string, pkg: string) => boolean): MissingDep[];
 /**
@@ -116,10 +106,9 @@ _isResolvable?: (root: string, pkg: string) => boolean): MissingDep[];
  * or null. Used to locate conventional `app`/`pages` directories that may live
  * at the root or under `src/`.
  */
-declare function findDir(root: string, ...candidates: string[]): string | null;
+export declare function findDir(root: string, ...candidates: string[]): string | null;
 /**
  * Check if the project uses App Router (has an app/ directory).
  */
-declare function hasAppDir(root: string): boolean;
-//#endregion
-export { PackageManagerName, ProjectInfo, detectPackageManager, detectPackageManagerName, detectProject, ensureESModule, ensureViteConfigCompatibility, findDir, findInNodeModules, findViteConfigPath, formatMissingCloudflarePluginError, getMissingDeps, hasAppDir, hasViteConfig, hasWranglerConfig, isPackageResolvable, renameCJSConfigs };
+export declare function hasAppDir(root: string): boolean;
+//#endregion

package/dist/utils/project.js

@@ -61,40 +61,31 @@ function renameCJSConfigs(root) {
 	}
 	return renamed;
 }
-/**
-* Ensure the project is configured for ESM before Vite loads vite.config.ts.
-*
-* This mirrors what `vinext init` does, but is applied lazily at dev/build
-* time for projects that were set up before `vinext init` added the step.
-*
-* Side effects: may rename `.js` CJS config files to `.cjs` and add
-* `"type": "module"` to package.json.
-*
-* @returns Object describing what was changed, or null if nothing was done.
-*/
+/** Preserve the old CLI's ESM migration for projects with a legacy Vite config. */
 function ensureViteConfigCompatibility(root) {
-	if (!hasViteConfig(root)) return null;
+	const config = findViteConfigPath(root);
+	if (!config || !/\.(?:ts|js)$/.test(config)) return null;
 	const pkgPath = path.join(root, "package.json");
 	if (!fs.existsSync(pkgPath)) return null;
-	let pkg;
 	try {
-		pkg = JSON.parse(fs.readFileSync(pkgPath, "utf-8"));
+		const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf-8"));
+		if (pkg.type !== void 0) return null;
+		if (config.endsWith(".js") && /\b(?:module\.exports|require\s*\()/.test(fs.readFileSync(config, "utf-8"))) return null;
+		for (const fileName of CJS_CONFIG_FILES) {
+			const source = path.join(root, fileName);
+			const destination = path.join(root, fileName.replace(/\.js$/, ".cjs"));
+			if (fs.existsSync(source) && fs.existsSync(destination) && /\bmodule\.exports\b|\brequire\s*\(/.test(fs.readFileSync(source, "utf-8"))) return null;
+		}
+		const renamed = renameCJSConfigs(root);
+		pkg.type = "module";
+		fs.writeFileSync(pkgPath, JSON.stringify(pkg, null, 2) + "\n", "utf-8");
+		return {
+			renamed,
+			addedTypeModule: true
+		};
 	} catch {
 		return null;
 	}
-	if (pkg.type === "module") return null;
-	if (pkg.type !== void 0) return null;
-	const renamed = renameCJSConfigs(root);
-	let addedTypeModule = false;
-	try {
-		pkg.type = "module";
-		fs.writeFileSync(pkgPath, JSON.stringify(pkg, null, 2) + "\n", "utf-8");
-		addedTypeModule = true;
-	} catch {}
-	return {
-		renamed,
-		addedTypeModule
-	};
 }
 /**
 * Walk from `start` up to the filesystem root, calling `check` on each
@@ -226,7 +217,7 @@ function detectProject(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 hasWrangler = isPackageResolvable(root, "wrangler/package.json");
 	const pkgPath = path.join(root, "package.json");
 	let pkg = null;
 	if (fs.existsSync(pkgPath)) try {
@@ -386,7 +377,7 @@ function getMissingDeps(info, _isResolvable = isPackageResolvable) {
 		name: "@cloudflare/vite-plugin",
 		version: "latest"
 	});
-	if (!info.hasWrangler) missing.push({
+	if (!info.hasWrangler && !fs.existsSync(path.join(info.root, "cloudflare.config.ts"))) missing.push({
 		name: "wrangler",
 		version: "latest"
 	});

package/dist/utils/promise.d.ts

@@ -1,4 +1,3 @@
 //#region src/utils/promise.d.ts
-declare function isPromiseLike(value: unknown): value is PromiseLike<unknown>;
-//#endregion
-export { isPromiseLike };
+export declare function isPromiseLike(value: unknown): value is PromiseLike<unknown>;
+//#endregion

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

@@ -1,29 +1,28 @@
 //#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";
+export 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";
+export 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";
+export 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";
+export declare const VINEXT_PRERENDER_SPECULATIVE_HEADER = "x-vinext-prerender-speculative";
 /** Logical hostname carried only by authenticated Node revalidation loopbacks. */
-declare const VINEXT_REVALIDATE_HOST_HEADER = "x-vinext-revalidate-host";
+export declare const VINEXT_REVALIDATE_HOST_HEADER = "x-vinext-revalidate-host";
 /** Prefix for forwarded request headers (e.g. `x-middleware-request-cookie`). */
-declare const MIDDLEWARE_REQUEST_HEADER_PREFIX = "x-middleware-request-";
+export 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";
+export 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";
+export 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";
+export declare const MIDDLEWARE_CACHE_HEADER = "x-middleware-cache";
 /** Skip-middleware signal. */
-declare const MIDDLEWARE_SKIP_HEADER = "x-middleware-skip";
+export declare const MIDDLEWARE_SKIP_HEADER = "x-middleware-skip";
 /** Generic prefix for all middleware internal headers. */
-declare const MIDDLEWARE_HEADER_PREFIX = "x-middleware-";
+export declare const MIDDLEWARE_HEADER_PREFIX = "x-middleware-";
 /** Authenticates an internal Pages Router on-demand revalidation request. */
-declare const PRERENDER_REVALIDATE_HEADER = "x-prerender-revalidate";
+export declare const PRERENDER_REVALIDATE_HEADER = "x-prerender-revalidate";
 /** Restricts on-demand revalidation to paths that were already generated. */
-declare const PRERENDER_REVALIDATE_ONLY_GENERATED_HEADER = "x-prerender-revalidate-if-generated";
-//#endregion
-export { MIDDLEWARE_CACHE_HEADER, MIDDLEWARE_HEADER_PREFIX, MIDDLEWARE_OVERRIDE_HEADERS, MIDDLEWARE_REQUEST_HEADER_PREFIX, MIDDLEWARE_SET_COOKIE_HEADER, MIDDLEWARE_SKIP_HEADER, PRERENDER_REVALIDATE_HEADER, PRERENDER_REVALIDATE_ONLY_GENERATED_HEADER, VINEXT_MW_CTX_HEADER, VINEXT_PRERENDER_ROUTE_PARAMS_HEADER, VINEXT_PRERENDER_SECRET_HEADER, VINEXT_PRERENDER_SPECULATIVE_HEADER, VINEXT_REVALIDATE_HOST_HEADER };
+export declare const PRERENDER_REVALIDATE_ONLY_GENERATED_HEADER = "x-prerender-revalidate-if-generated";
+//#endregion

package/dist/utils/public-file-path.d.ts

@@ -1,5 +1,4 @@
 //#region src/utils/public-file-path.d.ts
 /** Precompute keys for both encoded requests and decoded proxy/dev variants. */
-declare function publicFilePathVariants(pathname: string): string[];
-//#endregion
-export { publicFilePathVariants };
+export declare function publicFilePathVariants(pathname: string): string[];
+//#endregion

package/dist/utils/public-routes.d.ts

@@ -1,4 +1,3 @@
 //#region src/utils/public-routes.d.ts
-declare function scanPublicFileRoutes(root: string, configuredPublicDir?: string | false): string[];
-//#endregion
-export { scanPublicFileRoutes };
+export declare function scanPublicFileRoutes(root: string, configuredPublicDir?: string | false): string[];
+//#endregion

package/dist/utils/query.d.ts

@@ -4,15 +4,15 @@
  * Matches Next.js behavior: ?a=1&a=2 → { a: ['1', '2'] }
  */
 type UrlQueryValue = string | number | boolean | null | undefined;
-type UrlQuery = Record<string, UrlQueryValue | readonly UrlQueryValue[]>;
-declare function addQueryParam(obj: Record<string, string | string[]>, key: string, value: string): void;
+export type UrlQuery = Record<string, UrlQueryValue | readonly UrlQueryValue[]>;
+export declare function addQueryParam(obj: Record<string, string | string[]>, key: string, value: string): void;
 /**
  * Merge pathname-derived dynamic route params into a query object.
  *
  * Route params must win over same-name URL search params so `/posts/123?id=456`
  * still exposes `id: "123"` to Pages Router APIs.
  */
-declare function mergeRouteParamsIntoQuery(query: Record<string, string | string[]>, params: Record<string, string | string[]>): Record<string, string | string[]>;
+export declare function mergeRouteParamsIntoQuery(query: Record<string, string | string[]>, params: Record<string, string | string[]>): Record<string, string | string[]>;
 /**
  * Parse a URL's query string into a Record, with multi-value keys promoted to arrays.
  *
@@ -22,8 +22,14 @@ declare function mergeRouteParamsIntoQuery(query: Record<string, string | string
  * `split("?")[1]` preserves the rest of the query so values like `<Link href>`
  * targets keep their own query strings intact.
  */
-declare function parseQueryString(url: string): Record<string, string | string[]>;
-declare function urlQueryToSearchParams(query: UrlQuery): URLSearchParams;
+export declare function parseQueryString(url: string): Record<string, string | string[]>;
+/**
+ * Convert URLSearchParams into the record an App Router page receives as
+ * `searchParams`, with repeated keys promoted to arrays. The record has no
+ * prototype, so a key such as `__proto__` stays an ordinary entry.
+ */
+export declare function searchParamsToRecord(searchParams: URLSearchParams | null | undefined): Record<string, string | string[]>;
+export declare function urlQueryToSearchParams(query: UrlQuery): URLSearchParams;
 /**
  * Merge the original request URL's query parameters into a rewrite-target URL.
  *
@@ -39,11 +45,10 @@ declare function urlQueryToSearchParams(query: UrlQuery): URLSearchParams;
  * the origin differs from the original — external rewrites are proxied
  * elsewhere and shouldn't have local query params smuggled in.
  */
-declare function mergeRewriteQuery(originalUrl: string, rewriteUrl: string): string;
+export declare function mergeRewriteQuery(originalUrl: string, rewriteUrl: string): string;
 /**
  * Append query parameters to a URL while preserving any existing query string
  * and fragment identifier.
  */
-declare function appendSearchParamsToUrl(url: string, params: Iterable<[string, string]>): string;
-//#endregion
-export { UrlQuery, addQueryParam, appendSearchParamsToUrl, mergeRewriteQuery, mergeRouteParamsIntoQuery, parseQueryString, urlQueryToSearchParams };
+export declare function appendSearchParamsToUrl(url: string, params: Iterable<[string, string]>): string;
+//#endregion

package/dist/utils/query.js

@@ -45,6 +45,27 @@ function parseQueryString(url) {
 	return query;
 }
 /**
+* Convert URLSearchParams into the record an App Router page receives as
+* `searchParams`, with repeated keys promoted to arrays. The record has no
+* prototype, so a key such as `__proto__` stays an ordinary entry.
+*/
+function searchParamsToRecord(searchParams) {
+	const record = Object.create(null);
+	searchParams?.forEach((value, key) => {
+		const currentValue = record[key];
+		if (Array.isArray(currentValue)) {
+			record[key] = [...currentValue, value];
+			return;
+		}
+		if (currentValue !== void 0) {
+			record[key] = [currentValue, value];
+			return;
+		}
+		record[key] = value;
+	});
+	return record;
+}
+/**
 * Convert a Next.js-style query object into URLSearchParams while preserving
 * repeated keys for array values.
 *
@@ -119,4 +140,4 @@ function appendSearchParamsToUrl(url, params) {
 	return `${base}${search ? `?${search}` : ""}${hash}`;
 }
 //#endregion
-export { addQueryParam, appendSearchParamsToUrl, mergeRewriteQuery, mergeRouteParamsIntoQuery, parseQueryString, urlQueryToSearchParams };
+export { addQueryParam, appendSearchParamsToUrl, mergeRewriteQuery, mergeRouteParamsIntoQuery, parseQueryString, searchParamsToRecord, urlQueryToSearchParams };

package/dist/utils/react-compiler-support.d.ts

@@ -7,14 +7,13 @@
  * The plugin factory only returns `vite:react-compiler` when the installed
  * version understands the option, so its presence is what we probe for.
  */
-declare const REACT_COMPILER_PLUGIN_NAME = "vite:react-compiler";
+export declare const REACT_COMPILER_PLUGIN_NAME = "vite:react-compiler";
 /** Whether the user asked for the React Compiler through vinext's `react` option. */
-declare function isReactCompilerRequested(reactOptions: unknown): boolean;
+export declare function isReactCompilerRequested(reactOptions: unknown): boolean;
 /** Whether a plugin entry is the React Compiler plugin. */
-declare function isReactCompilerPlugin(plugin: unknown): boolean;
+export declare function isReactCompilerPlugin(plugin: unknown): boolean;
 /** Whether the resolved @vitejs/plugin-react actually registered the compiler. */
-declare function hasReactCompilerPlugin(plugins: readonly unknown[]): boolean;
+export declare function hasReactCompilerPlugin(plugins: readonly unknown[]): boolean;
 /** Message for when `react: { compiler: true }` cannot be honored. */
-declare function reactCompilerUnsupportedMessage(installCommand: string): string;
-//#endregion
-export { REACT_COMPILER_PLUGIN_NAME, hasReactCompilerPlugin, isReactCompilerPlugin, isReactCompilerRequested, reactCompilerUnsupportedMessage };
+export declare function reactCompilerUnsupportedMessage(installCommand: string): string;
+//#endregion

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

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

package/dist/utils/react-version.js

@@ -12,7 +12,25 @@ function getDependencyUpgradeDeps(root, recommendations) {
 	}
 	return [];
 }
-function getReactUpgradeDeps(root) {
+function getReactUpgradeDeps(root, options = {}) {
+	if (options.fromManifest) {
+		const pkg = JSON.parse(fs.readFileSync(path.join(root, "package.json"), "utf-8"));
+		for (const name of ["react", "react-dom"]) {
+			const declared = pkg.dependencies?.[name] ?? pkg.devDependencies?.[name];
+			const version = /^[~^]?([0-9]+(?:\.[0-9]+){0,2}(?:-[0-9A-Za-z.*-]+)?)(?:\.[x*])?$/.exec(declared ?? "")?.[1];
+			if (version && (version.includes("-") || isVersionBelow(version, [
+				19,
+				2,
+				6
+			]))) {
+				const upgrades = ["react@latest", "react-dom@latest"];
+				const rsdw = pkg.dependencies?.["react-server-dom-webpack"] ?? pkg.devDependencies?.["react-server-dom-webpack"];
+				if (rsdw && rsdw !== "latest") upgrades.push("react-server-dom-webpack@latest");
+				return upgrades;
+			}
+		}
+		return [];
+	}
 	return getDependencyUpgradeDeps(root, { react: {
 		minimumVersion: [
 			19,

package/dist/utils/record.d.ts

@@ -1,4 +1,3 @@
 //#region src/utils/record.d.ts
-declare function isUnknownRecord(value: unknown): value is Record<string, unknown>;
-//#endregion
-export { isUnknownRecord };
+export declare function isUnknownRecord(value: unknown): value is Record<string, unknown>;
+//#endregion

package/dist/utils/redirect-digest.d.ts

@@ -1,9 +1,8 @@
 //#region src/utils/redirect-digest.d.ts
-type RedirectDigest = {
+export type RedirectDigest = {
   status: number;
   type: string | null;
   url: string;
 };
-declare function parseRedirectDigest(digest: string): RedirectDigest | null;
-//#endregion
-export { RedirectDigest, parseRedirectDigest };
+export declare function parseRedirectDigest(digest: string): RedirectDigest | null;
+//#endregion

package/dist/utils/regex-safety.d.ts

@@ -1,8 +1,7 @@
 //#region src/utils/regex-safety.d.ts
-type RegexSafetyIssue = "nested repetition" | "ambiguous alternatives under repetition" | "ambiguous sequence expansion" | "overlapping sequential repetition" | "analysis budget exceeded";
-declare function analyzeRegexSafety(pattern: string, options?: {
+export type RegexSafetyIssue = "nested repetition" | "ambiguous alternatives under repetition" | "ambiguous sequence expansion" | "overlapping sequential repetition" | "analysis budget exceeded";
+export declare function analyzeRegexSafety(pattern: string, options?: {
   ignoreCase?: boolean;
 }): RegexSafetyIssue | null;
-declare function regexAtomsMayOverlap(left: string, right: string, ignoreCase?: boolean): boolean;
-//#endregion
-export { RegexSafetyIssue, analyzeRegexSafety, regexAtomsMayOverlap };
+export declare function regexAtomsMayOverlap(left: string, right: string, ignoreCase?: boolean): boolean;
+//#endregion

package/dist/utils/regex.d.ts

@@ -1,4 +1,3 @@
 //#region src/utils/regex.d.ts
-declare function escapeRegExp(value: string): string;
-//#endregion
-export { escapeRegExp };
+export declare function escapeRegExp(value: string): string;
+//#endregion

package/dist/utils/safe-json-file.d.ts

@@ -10,8 +10,7 @@
  * Callers that need a default value other than `null` should map the result:
  *   `readJsonFile<string[]>(p) ?? []`
  */
-declare function readJsonFile<T>(filePath: string, options?: {
+export declare function readJsonFile<T>(filePath: string, options?: {
   onError?: (err: unknown) => void;
 }): T | null;
-//#endregion
-export { readJsonFile };
+//#endregion

package/dist/utils/sorted-array.d.ts

@@ -3,6 +3,5 @@ type SortedStringPosition = Readonly<{
   found: boolean;
   index: number;
 }>;
-declare function findSortedStringPosition(values: readonly string[], candidate: string): SortedStringPosition;
-//#endregion
-export { findSortedStringPosition };
+export declare function findSortedStringPosition(values: readonly string[], candidate: string): SortedStringPosition;
+//#endregion

package/dist/utils/text-stream.d.ts

@@ -13,7 +13,7 @@
  * Drain a UTF-8 byte stream and return the full decoded text. The stream
  * reader is released on both success and failure.
  */
-declare function readStreamAsText(stream: ReadableStream<Uint8Array>): Promise<string>;
+export declare function readStreamAsText(stream: ReadableStream<Uint8Array>): Promise<string>;
 /**
  * Drain a UTF-8 byte stream up to `maxBytes` of *raw* input, returning the
  * decoded text. If the raw size limit is exceeded, cancellation is signalled
@@ -23,6 +23,5 @@ declare function readStreamAsText(stream: ReadableStream<Uint8Array>): Promise<s
  * The size check is on raw bytes (pre-decode) to bound memory before
  * paying the decoder cost.
  */
-declare function readStreamAsTextWithLimit(stream: ReadableStream<Uint8Array>, maxBytes: number, onLimitExceeded: () => never): Promise<string>;
-//#endregion
-export { readStreamAsText, readStreamAsTextWithLimit };
+export declare function readStreamAsTextWithLimit(stream: ReadableStream<Uint8Array>, maxBytes: number, onLimitExceeded: () => never): Promise<string>;
+//#endregion

package/dist/utils/vinext-root.d.ts

@@ -18,6 +18,5 @@
  * If an explicit root is provided (e.g. from a test fixture), it is returned
  * as-is after resolving to an absolute path.
  */
-declare function resolveVinextPackageRoot(explicitRoot?: string): string;
-//#endregion
-export { resolveVinextPackageRoot };
+export declare function resolveVinextPackageRoot(explicitRoot?: string): string;
+//#endregion

package/dist/utils/virtual-module.d.ts

@@ -1,5 +1,4 @@
 //#region src/utils/virtual-module.d.ts
-declare const VIRTUAL_PREFIX = "\0";
-declare const VIRTUAL_MODULE_ID_RE: RegExp;
-//#endregion
-export { VIRTUAL_MODULE_ID_RE, VIRTUAL_PREFIX };
+export declare const VIRTUAL_PREFIX = "\0";
+export declare const VIRTUAL_MODULE_ID_RE: RegExp;
+//#endregion

package/dist/utils/vite-cli-invocation.d.ts

@@ -0,0 +1,21 @@
+import { InlineConfig } from "vite";
+//#region src/utils/vite-cli-invocation.d.ts
+type Command = "dev" | "build";
+type Invocation = {
+  command: Command;
+  mode: string;
+  root: string;
+  rootArg?: string;
+  configFile?: string;
+};
+export declare function valueOptionName(arg: string): string;
+export declare function findViteRoot(command: Command, args: string[]): {
+  root: string | undefined;
+  shouldPreflight: boolean;
+};
+export declare function getViteCliInvocation(argv?: string[]): Invocation | undefined;
+/** Only the config loaded by the outer CLI may claim its dev lifecycle. */
+export declare function isViteCliConfigFile(configFile: string, inlineConfig?: Pick<InlineConfig, "root" | "configFile">): boolean;
+export declare function isViteCliInvocation(command: Command, argv?: string[]): boolean;
+export declare function claimViteCliBuildInvocation(argv?: string[]): boolean;
+//#endregion