vinext 0.0.55 → 0.1.0

package/dist/plugins/og-assets.d.ts

@@ -13,14 +13,38 @@ import { Plugin } from "vite";
  */
 declare function createOgInlineFetchAssetsPlugin(): Plugin;
 /**
- * The `vinext:og-assets` Vite plugin.
+ * Copy a single root copy of each requested WASM asset from `sourceDir` into
+ * `outDir`, skipping any asset whose source is missing or whose destination
+ * already exists.
  *
- * Copies @vercel/og binary assets (e.g. resvg.wasm) to the RSC output
- * directory for production builds. The edge build inlines fonts as base64 via
- * `vinext:og-inline-fetch-assets`; this plugin is a safety net to ensure
- * resvg.wasm exists in the output directory for the Node.js disk-read fallback.
+ * Extracted as a pure, dependency-injected helper so it can be unit-tested
+ * against a temp source directory without depending on the real @vercel/og
+ * install (whose `yoga.wasm` is only materialized as a side effect of the
+ * `vinext:og-font-patch` transform during a build).
  */
-declare const ogAssetsPlugin: Plugin;
+declare function copyMissingOgWasm(opts: {
+  outDir: string;
+  sourceDir: string;
+  assets: readonly string[];
+}): void;
+/**
+ * Create the `vinext:og-assets` Vite plugin.
+ *
+ * Ensures each @vercel/og WASM module (resvg.wasm, yoga.wasm) ships exactly once
+ * in the RSC output, with every loader strategy resolving to that single file:
+ *
+ *   1. `generateBundle` (post): if the bundler already emitted the WASM as a
+ *      hashed asset (from the `import("./x.wasm?module")` path), rewrite the
+ *      Node.js fallback reference `new URL("./x.wasm", import.meta.url)` in each
+ *      chunk to point at that emitted asset (a sibling under `_next/static/`).
+ *      This deduplicates without copying a second root file.
+ *   2. `writeBundle` (post): for any referenced WASM that was NOT emitted as an
+ *      asset (e.g. a build that inlined or skipped it), copy a single root copy
+ *      from @vercel/og's dist so the Node.js disk-read fallback still works.
+ *
+ * The decision keys off "did the bundler emit this asset?", never the deploy
+ * target — so it helps Node/self-hosted builds as well as Cloudflare Workers.
+ */
+declare function createOgAssetsPlugin(): Plugin;
 //#endregion
-export { createOgInlineFetchAssetsPlugin, ogAssetsPlugin };
-//# sourceMappingURL=og-assets.d.ts.map
+export { copyMissingOgWasm, createOgAssetsPlugin, createOgInlineFetchAssetsPlugin };

package/dist/plugins/og-assets.js

@@ -1,6 +1,7 @@
 import { createRequire } from "node:module";
 import fs from "node:fs";
 import path from "node:path";
+import MagicString from "magic-string";
 //#region src/plugins/og-assets.ts
 /**
 * Create the `vinext:og-inline-fetch-assets` Vite plugin.
@@ -75,43 +76,134 @@ function createOgInlineFetchAssetsPlugin() {
 		}
 	};
 }
+const OG_WASM_ASSETS = ["resvg.wasm", "yoga.wasm"];
 /**
-* The `vinext:og-assets` Vite plugin.
+* Find an emitted WASM asset in the output bundle whose name corresponds to the
+* given base file (e.g. base `resvg.wasm` matches the emitted `resvg-HASH.wasm`).
 *
-* Copies @vercel/og binary assets (e.g. resvg.wasm) to the RSC output
-* directory for production builds. The edge build inlines fonts as base64 via
-* `vinext:og-inline-fetch-assets`; this plugin is a safety net to ensure
-* resvg.wasm exists in the output directory for the Node.js disk-read fallback.
+* The bundler emits the `import("./resvg.wasm?module")` dynamic import as a
+* hashed asset. When it exists, both loader strategies can point at the same
+* physical file — no second copy needed.
+*
+* @returns the emitted asset's `fileName` (relative to outDir), or null.
 */
-const ogAssetsPlugin = {
-	name: "vinext:og-assets",
-	apply: "build",
-	enforce: "post",
-	writeBundle: {
-		sequential: true,
-		order: "post",
-		async handler(options) {
-			if (this.environment?.name !== "rsc") return;
-			const outDir = options.dir;
-			if (!outDir) return;
-			const indexPath = path.join(outDir, "index.js");
-			if (!fs.existsSync(indexPath)) return;
-			const content = fs.readFileSync(indexPath, "utf-8");
-			const referencedAssets = ["resvg.wasm"].filter((asset) => content.includes(asset));
-			if (referencedAssets.length === 0) return;
-			try {
-				const ogPkgPath = createRequire(import.meta.url).resolve("@vercel/og/package.json");
-				const ogDistDir = path.join(path.dirname(ogPkgPath), "dist");
-				for (const asset of referencedAssets) {
-					const src = path.join(ogDistDir, asset);
-					const dest = path.join(outDir, asset);
-					if (fs.existsSync(src) && !fs.existsSync(dest)) fs.copyFileSync(src, dest);
+function findEmittedWasmAsset(bundle, baseName) {
+	const stem = baseName.replace(/\.wasm$/, "");
+	const re = new RegExp(`^${stem}(?:-[\\w-]+)?\\.wasm$`);
+	for (const output of Object.values(bundle)) {
+		if (output.type !== "asset") continue;
+		if (re.test(path.posix.basename(output.fileName))) return output.fileName;
+	}
+	return null;
+}
+/**
+* Build the regex that matches the Node.js fallback reference
+* `new URL("./<base>", import.meta.url)` for a given WASM base name.
+*
+* Handles all three quote styles ("'`) because the minifier may rewrite the
+* string literal (commonly to a template literal) by the time the chunk code
+* is available in generateBundle.
+*/
+function fallbackUrlRegex(baseName) {
+	const escaped = baseName.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+	return new RegExp(String.raw`new URL\(\s*(["'\`])\.\/${escaped}\1\s*,\s*import\.meta\.url\s*\)`, "g");
+}
+/**
+* Copy a single root copy of each requested WASM asset from `sourceDir` into
+* `outDir`, skipping any asset whose source is missing or whose destination
+* already exists.
+*
+* Extracted as a pure, dependency-injected helper so it can be unit-tested
+* against a temp source directory without depending on the real @vercel/og
+* install (whose `yoga.wasm` is only materialized as a side effect of the
+* `vinext:og-font-patch` transform during a build).
+*/
+function copyMissingOgWasm(opts) {
+	for (const asset of opts.assets) {
+		const src = path.join(opts.sourceDir, asset);
+		const dest = path.join(opts.outDir, asset);
+		if (fs.existsSync(src) && !fs.existsSync(dest)) fs.copyFileSync(src, dest);
+	}
+}
+/**
+* Create the `vinext:og-assets` Vite plugin.
+*
+* Ensures each @vercel/og WASM module (resvg.wasm, yoga.wasm) ships exactly once
+* in the RSC output, with every loader strategy resolving to that single file:
+*
+*   1. `generateBundle` (post): if the bundler already emitted the WASM as a
+*      hashed asset (from the `import("./x.wasm?module")` path), rewrite the
+*      Node.js fallback reference `new URL("./x.wasm", import.meta.url)` in each
+*      chunk to point at that emitted asset (a sibling under `_next/static/`).
+*      This deduplicates without copying a second root file.
+*   2. `writeBundle` (post): for any referenced WASM that was NOT emitted as an
+*      asset (e.g. a build that inlined or skipped it), copy a single root copy
+*      from @vercel/og's dist so the Node.js disk-read fallback still works.
+*
+* The decision keys off "did the bundler emit this asset?", never the deploy
+* target — so it helps Node/self-hosted builds as well as Cloudflare Workers.
+*/
+function createOgAssetsPlugin() {
+	let dedupedBases = /* @__PURE__ */ new Set();
+	return {
+		name: "vinext:og-assets",
+		apply: "build",
+		enforce: "post",
+		generateBundle: {
+			order: "post",
+			handler(_options, bundle) {
+				if (this.environment?.name !== "rsc") return;
+				dedupedBases = /* @__PURE__ */ new Set();
+				const chunks = Object.values(bundle).filter((o) => o.type === "chunk");
+				for (const base of OG_WASM_ASSETS) {
+					if (!chunks.some((c) => c.code.includes(base))) continue;
+					const emitted = findEmittedWasmAsset(bundle, base);
+					if (!emitted) continue;
+					for (const chunk of chunks) {
+						const re = fallbackUrlRegex(base);
+						const chunkDir = path.posix.dirname(chunk.fileName);
+						const rel = path.posix.relative(chunkDir, emitted);
+						const ref = rel.startsWith(".") ? rel : `./${rel}`;
+						const s = new MagicString(chunk.code);
+						let edited = false;
+						for (const m of chunk.code.matchAll(re)) {
+							const quote = m[1];
+							const start = m.index;
+							s.overwrite(start, start + m[0].length, `new URL(${quote}${ref}${quote}, import.meta.url)`);
+							edited = true;
+						}
+						if (!edited) continue;
+						chunk.code = s.toString();
+						if (chunk.map) chunk.map = s.generateMap({
+							hires: "boundary",
+							source: chunk.fileName
+						});
+					}
+					dedupedBases.add(base);
 				}
-			} catch {}
+			}
+		},
+		writeBundle: {
+			sequential: true,
+			order: "post",
+			async handler(options, bundle) {
+				if (this.environment?.name !== "rsc") return;
+				const outDir = options.dir;
+				if (!outDir) return;
+				const chunkCode = Object.values(bundle).map((output) => output.type === "chunk" ? output.code : "").join("\n");
+				const referencedAssets = OG_WASM_ASSETS.filter((asset) => chunkCode.includes(asset) && !dedupedBases.has(asset));
+				if (referencedAssets.length === 0) return;
+				try {
+					const ogPkgPath = createRequire(import.meta.url).resolve("@vercel/og/package.json");
+					copyMissingOgWasm({
+						outDir,
+						sourceDir: path.join(path.dirname(ogPkgPath), "dist"),
+						assets: referencedAssets
+					});
+				} catch {}
+			}
 		}
-	}
-};
+	};
+}
 //#endregion
-export { createOgInlineFetchAssetsPlugin, ogAssetsPlugin };
-
-//# sourceMappingURL=og-assets.js.map
+export { copyMissingOgWasm, createOgAssetsPlugin, createOgInlineFetchAssetsPlugin };

package/dist/plugins/optimize-imports.d.ts

@@ -34,5 +34,4 @@ declare function buildBarrelExportMap(packageName: string, resolveEntry: (pkg: s
  */
 declare function createOptimizeImportsPlugin(getNextConfig: () => ResolvedNextConfig | undefined, getRoot: () => string): Plugin;
 //#endregion
-export { DEFAULT_OPTIMIZE_PACKAGES, buildBarrelExportMap, createOptimizeImportsPlugin };
-//# sourceMappingURL=optimize-imports.d.ts.map
+export { DEFAULT_OPTIMIZE_PACKAGES, buildBarrelExportMap, createOptimizeImportsPlugin };

package/dist/plugins/optimize-imports.js

@@ -1,3 +1,4 @@
+import { getAstName } from "./ast-utils.js";
 import { createRequire } from "node:module";
 import path from "node:path";
 import { parseAst } from "vite";
@@ -15,13 +16,6 @@ async function readFileSafe(filepath) {
 		return null;
 	}
 }
-/** Extract the string name from an Identifier ({name}) or Literal ({value}) AST node.
-* Returns null for unexpected node shapes so callers can degrade gracefully rather than crash. */
-function astName(node) {
-	if (node.name !== void 0) return node.name;
-	if (typeof node.value === "string") return node.value;
-	return null;
-}
 /**
 * Packages whose barrel imports are automatically optimized.
 * Matches Next.js's built-in optimizePackageImports defaults plus radix-ui.
@@ -265,7 +259,7 @@ async function buildExportMapFromFile(filePath, readFile, cache, visited, initia
 					break;
 				case "ImportSpecifier":
 					if (spec.imported) {
-						const name = astName(spec.imported);
+						const name = getAstName(spec.imported);
 						if (name !== null) importBindings.set(spec.local.name, {
 							source,
 							isNamespace: false,
@@ -297,7 +291,7 @@ async function buildExportMapFromFile(filePath, readFile, cache, visited, initia
 			const rawSource = typeof node.source?.value === "string" ? node.source.value : null;
 			if (!rawSource) break;
 			if (node.exported) {
-				const name = astName(node.exported);
+				const name = getAstName(node.exported);
 				if (name !== null) exportMap.set(name, {
 					source: normalizeSource(rawSource),
 					isNamespace: true
@@ -339,8 +333,8 @@ async function buildExportMapFromFile(filePath, readFile, cache, visited, initia
 			if (rawSource) {
 				const source = normalizeSource(rawSource);
 				for (const spec of node.specifiers ?? []) if (spec.exported) {
-					const exported = astName(spec.exported);
-					const local = astName(spec.local);
+					const exported = getAstName(spec.exported);
+					const local = getAstName(spec.local);
 					if (exported !== null) exportMap.set(exported, {
 						source,
 						isNamespace: false,
@@ -349,8 +343,8 @@ async function buildExportMapFromFile(filePath, readFile, cache, visited, initia
 				}
 			} else if (node.specifiers && node.specifiers.length > 0) for (const spec of node.specifiers) {
 				if (!spec.exported) continue;
-				const exported = astName(spec.exported);
-				const local = astName(spec.local);
+				const exported = getAstName(spec.exported);
+				const local = getAstName(spec.local);
 				if (exported === null || local === null) continue;
 				const binding = importBindings.get(local);
 				if (binding) exportMap.set(exported, {
@@ -494,7 +488,7 @@ function createOptimizeImportsPlugin(getNextConfig, getRoot) {
 									allResolved = false;
 									break;
 								}
-								const imported = astName(spec.imported);
+								const imported = getAstName(spec.imported);
 								if (imported === null) {
 									allResolved = false;
 									break;
@@ -522,7 +516,7 @@ function createOptimizeImportsPlugin(getNextConfig, getRoot) {
 					if (!allResolved || specifiers.length === 0) {
 						if (allResolved === false) {
 							for (const spec of node.specifiers ?? []) if (spec.type === "ImportSpecifier" && spec.imported) {
-								const imported = astName(spec.imported);
+								const imported = getAstName(spec.imported);
 								if (imported !== null && !exportMap.has(imported)) {
 									console.debug(`[vinext:optimize-imports] skipping "${importSource}": could not resolve specifier "${imported}" in barrel export map`);
 									break;
@@ -579,5 +573,3 @@ function createOptimizeImportsPlugin(getNextConfig, getRoot) {
 }
 //#endregion
 export { DEFAULT_OPTIMIZE_PACKAGES, buildBarrelExportMap, createOptimizeImportsPlugin };
-
-//# sourceMappingURL=optimize-imports.js.map

package/dist/plugins/postcss.d.ts

@@ -23,5 +23,4 @@ declare function resolvePostcssStringPlugins(projectRoot: string): Promise<{
   plugins: unknown[];
 } | undefined>;
 //#endregion
-export { postcssCache, resolvePostcssStringPlugins };
-//# sourceMappingURL=postcss.d.ts.map
+export { postcssCache, resolvePostcssStringPlugins };

package/dist/plugins/postcss.js

@@ -90,5 +90,3 @@ async function resolvePostcssStringPluginsUncached(projectRoot) {
 }
 //#endregion
 export { postcssCache, resolvePostcssStringPlugins };
-
-//# sourceMappingURL=postcss.js.map

package/dist/plugins/remove-console.d.ts

@@ -12,5 +12,4 @@ type RemoveConsoleConfig = boolean | {
  */
 declare function removeConsoleCalls(code: string, config: RemoveConsoleConfig): string | null;
 //#endregion
-export { removeConsoleCalls };
-//# sourceMappingURL=remove-console.d.ts.map
+export { removeConsoleCalls };

package/dist/plugins/remove-console.js

@@ -172,5 +172,3 @@ function removeConsoleCalls(code, config) {
 }
 //#endregion
 export { removeConsoleCalls };
-
-//# sourceMappingURL=remove-console.js.map

package/dist/plugins/rsc-client-reference-loaders.d.ts

@@ -3,5 +3,4 @@ import { Plugin } from "vite";
 //#region src/plugins/rsc-client-reference-loaders.d.ts
 declare function createRscClientReferenceLoadersPlugin(): Plugin;
 //#endregion
-export { createRscClientReferenceLoadersPlugin };
-//# sourceMappingURL=rsc-client-reference-loaders.d.ts.map
+export { createRscClientReferenceLoadersPlugin };

package/dist/plugins/rsc-client-reference-loaders.js

@@ -44,5 +44,3 @@ function createRscClientReferenceLoadersPlugin() {
 }
 //#endregion
 export { createRscClientReferenceLoadersPlugin };
-
-//# sourceMappingURL=rsc-client-reference-loaders.js.map

package/dist/plugins/rsc-client-shim-excludes.d.ts

@@ -3,5 +3,4 @@ declare const VINEXT_OPTIMIZE_DEPS_EXCLUDE: readonly string[];
 declare const SSR_EXTERNAL_REACT_ENTRIES: readonly string[];
 declare function mergeOptimizeDepsExclude(...excludeGroups: readonly (readonly string[])[]): string[];
 //#endregion
-export { SSR_EXTERNAL_REACT_ENTRIES, VINEXT_OPTIMIZE_DEPS_EXCLUDE, mergeOptimizeDepsExclude };
-//# sourceMappingURL=rsc-client-shim-excludes.d.ts.map
+export { SSR_EXTERNAL_REACT_ENTRIES, VINEXT_OPTIMIZE_DEPS_EXCLUDE, mergeOptimizeDepsExclude };

package/dist/plugins/rsc-client-shim-excludes.js

@@ -33,5 +33,3 @@ function mergeOptimizeDepsExclude(...excludeGroups) {
 }
 //#endregion
 export { SSR_EXTERNAL_REACT_ENTRIES, VINEXT_OPTIMIZE_DEPS_EXCLUDE, mergeOptimizeDepsExclude };
-
-//# sourceMappingURL=rsc-client-shim-excludes.js.map

package/dist/plugins/sass.d.ts

@@ -30,5 +30,4 @@ type VitePreprocessorOptions = {
 };
 declare function buildSassPreprocessorOptions(sassOptions: Record<string, unknown> | null | undefined): VitePreprocessorOptions | undefined;
 //#endregion
-export { buildSassPreprocessorOptions };
-//# sourceMappingURL=sass.d.ts.map
+export { buildSassPreprocessorOptions };

package/dist/plugins/sass.js

@@ -18,5 +18,3 @@ function buildSassPreprocessorOptions(sassOptions) {
 }
 //#endregion
 export { buildSassPreprocessorOptions };
-
-//# sourceMappingURL=sass.js.map

package/dist/plugins/server-externals-manifest.d.ts

@@ -23,5 +23,4 @@ import { Plugin } from "vite";
  */
 declare function createServerExternalsManifestPlugin(): Plugin;
 //#endregion
-export { createServerExternalsManifestPlugin };
-//# sourceMappingURL=server-externals-manifest.d.ts.map
+export { createServerExternalsManifestPlugin };

package/dist/plugins/server-externals-manifest.js

@@ -79,5 +79,3 @@ function createServerExternalsManifestPlugin() {
 }
 //#endregion
 export { createServerExternalsManifestPlugin };
-
-//# sourceMappingURL=server-externals-manifest.js.map

package/dist/plugins/strip-server-exports.d.ts

@@ -10,5 +10,4 @@
  */
 declare function stripServerExports(code: string): string | null;
 //#endregion
-export { stripServerExports };
-//# sourceMappingURL=strip-server-exports.d.ts.map
+export { stripServerExports };

package/dist/plugins/strip-server-exports.js

@@ -66,5 +66,3 @@ function stripServerExports(code) {
 }
 //#endregion
 export { stripServerExports };
-
-//# sourceMappingURL=strip-server-exports.js.map

package/dist/routing/app-route-graph.d.ts

@@ -1,4 +1,5 @@
 import { ValidFileMatcher } from "./file-matcher.js";
+import { isInvisibleSegment } from "./utils.js";
 
 //#region src/routing/app-route-graph.d.ts
 type InterceptingRoute = {
@@ -264,13 +265,6 @@ declare function buildAppRouteGraph(appDir: string, matcher: ValidFileMatcher):
   routeManifest: RouteManifest;
 }>;
 declare function computeRootParamNames(routeSegments: readonly string[], layoutTreePositions: readonly number[]): string[];
-/**
- * Check whether a path segment is invisible in the URL (route groups, parallel slots, ".").
- *
- * Used by computeInterceptTarget, convertSegmentsToRouteParts, and
- * hasRemainingVisibleSegments — keep this the single source of truth.
- */
-declare function isInvisibleSegment(segment: string): boolean;
 /**
  * Convert filesystem path segments to URL route parts, skipping invisible segments
  * (route groups, @slots, ".") and converting dynamic segment syntax to Express-style
@@ -305,5 +299,4 @@ declare function computeAppRouteStaticSiblings(allRoutes: readonly {
   patternParts?: readonly string[] | null;
 }): string[];
 //#endregion
-export { AppRoute, AppRouteGraphParallelSlot, AppRouteGraphRoute, AppRouteSemanticIds, GraphVersion, InterceptingRoute, ParallelSlot, RootBoundaryId, RouteManifest, RouteManifestBoundary, RouteManifestBoundaryOutcome, RouteManifestDefault, RouteManifestInterception, RouteManifestLayout, RouteManifestPage, RouteManifestRootBoundary, RouteManifestRoute, RouteManifestRouteHandler, RouteManifestSlot, RouteManifestSlotBinding, RouteManifestSlotBindingState, RouteManifestTemplate, StaticSegmentGraph, buildAppRouteGraph, computeAppRouteStaticSiblings, computeRootParamNames, convertSegmentsToRouteParts, isInvisibleSegment };
-//# sourceMappingURL=app-route-graph.d.ts.map
+export { AppRoute, AppRouteGraphRoute, AppRouteSemanticIds, GraphVersion, RootBoundaryId, RouteManifest, RouteManifestInterception, RouteManifestRootBoundary, RouteManifestRoute, RouteManifestSlotBinding, StaticSegmentGraph, buildAppRouteGraph, computeAppRouteStaticSiblings, computeRootParamNames, convertSegmentsToRouteParts, isInvisibleSegment };

package/dist/routing/app-route-graph.js

@@ -1,6 +1,7 @@
-import { compareRoutes, decodeRouteSegment } from "./utils.js";
-import { scanWithExtensions } from "./file-matcher.js";
+import { compareRoutes, decodeRouteSegment, isInvisibleSegment } from "./utils.js";
+import { findFileWithExts, scanWithExtensions } from "./file-matcher.js";
 import { validateRoutePatterns } from "./route-validation.js";
+import { compareStrings } from "../utils/compare.js";
 import fs from "node:fs";
 import path from "node:path";
 import { createHash } from "node:crypto";
@@ -38,11 +39,7 @@ function createAppRouteGraphInterceptionId(slotId, sourcePattern, targetPattern)
 function createAppRouteGraphRootBoundaryId(treePath) {
 	return `root-boundary:${treePath}`;
 }
-function compareStableStrings(left, right) {
-	if (left < right) return -1;
-	if (left > right) return 1;
-	return 0;
-}
+const compareStableStrings = compareStrings;
 function sortedMapValues(map) {
 	return Array.from(map.entries()).sort(([left], [right]) => compareStableStrings(left, right)).map(([, value]) => value);
 }
@@ -1140,18 +1137,6 @@ function computeInterceptSourceMatchPattern(interceptParentDir, appDir) {
 	return "/" + urlSegments.join("/");
 }
 /**
-* Check whether a path segment is invisible in the URL (route groups, parallel slots, ".").
-*
-* Used by computeInterceptTarget, convertSegmentsToRouteParts, and
-* hasRemainingVisibleSegments — keep this the single source of truth.
-*/
-function isInvisibleSegment(segment) {
-	if (segment === ".") return true;
-	if (segment.startsWith("(") && segment.endsWith(")")) return true;
-	if (segment.startsWith("@")) return true;
-	return false;
-}
-/**
 * Compute the target URL pattern for an intercepting route.
 *
 * Interception conventions (..), (..)(..)" climb by *visible route segments*
@@ -1167,9 +1152,11 @@ function computeInterceptTarget(convention, interceptSegment, currentDir, interc
 	const routeSegments = path.relative(appDir, routeDir).split(path.sep).filter(Boolean);
 	let baseParts;
 	switch (convention) {
-		case ".":
-			baseParts = routeSegments;
+		case ".": {
+			const interceptParentDir = path.dirname(interceptRoot);
+			baseParts = path.relative(appDir, interceptParentDir).split(path.sep).filter(Boolean);
 			break;
+		}
 		case "..":
 		case "../..": {
 			const levelsToClimb = convention === ".." ? 1 : 2;
@@ -1229,13 +1216,7 @@ function markerForInterceptionConvention(convention) {
 * Find a file by name (without extension) in a directory.
 * Checks configured pageExtensions.
 */
-function findFile(dir, name, matcher) {
-	for (const ext of matcher.dottedExtensions) {
-		const filePath = path.join(dir, name + ext);
-		if (fs.existsSync(filePath)) return filePath;
-	}
-	return null;
-}
+const findFile = findFileWithExts;
 /**
 * Convert filesystem path segments to URL route parts, skipping invisible segments
 * (route groups, @slots, ".") and converting dynamic segment syntax to Express-style
@@ -1334,5 +1315,3 @@ function computeAppRouteStaticSiblings(allRoutes, matchedRoute) {
 }
 //#endregion
 export { buildAppRouteGraph, computeAppRouteStaticSiblings, computeRootParamNames, convertSegmentsToRouteParts, isInvisibleSegment };
-
-//# sourceMappingURL=app-route-graph.js.map

package/dist/routing/app-router.d.ts

@@ -27,5 +27,4 @@ declare function matchAppRoute(url: string, routes: AppRoute[]): {
   params: Record<string, string | string[]>;
 } | null;
 //#endregion
-export { type AppRoute, appRouteGraph, appRouter, computeAppRouteStaticSiblings, computeRootParamNames, convertSegmentsToRouteParts, invalidateAppRouteCache, matchAppRoute };
-//# sourceMappingURL=app-router.d.ts.map
+export { type AppRoute, appRouteGraph, appRouter, computeAppRouteStaticSiblings, computeRootParamNames, convertSegmentsToRouteParts, invalidateAppRouteCache, matchAppRoute };

package/dist/routing/app-router.js

@@ -57,5 +57,3 @@ function matchAppRoute(url, routes) {
 }
 //#endregion
 export { appRouteGraph, appRouter, computeAppRouteStaticSiblings, computeRootParamNames, convertSegmentsToRouteParts, invalidateAppRouteCache, matchAppRoute };
-
-//# sourceMappingURL=app-router.js.map

package/dist/routing/file-matcher.d.ts

@@ -18,6 +18,11 @@ type ValidFileMatcher = {
 declare function createValidFileMatcher(pageExtensions?: readonly string[] | null): ValidFileMatcher;
 /** Check if a file exists with any configured page extension. */
 declare function findFileWithExtensions(basePath: string, matcher: ValidFileMatcher): boolean;
+/**
+ * Find a file by basename and configured page extension in a directory.
+ * Returns the first matching absolute path, or null if not found.
+ */
+declare function findFileWithExts(dir: string, name: string, matcher: ValidFileMatcher): string | null;
 /**
  * Vite's default `resolve.extensions` covers `.tsx/.ts/.jsx/.js/.json` (and
  * `.mjs/.mts`). When the user configures `pageExtensions` with values Vite
@@ -43,5 +48,4 @@ declare function buildViteResolveExtensions(pageExtensions?: readonly string[] |
  */
 declare function scanWithExtensions(stem: string, cwd: string, extensions: readonly string[], exclude?: (name: string) => boolean): AsyncGenerator<string>;
 //#endregion
-export { ValidFileMatcher, buildViteResolveExtensions, createValidFileMatcher, findFileWithExtensions, normalizePageExtensions, scanWithExtensions };
-//# sourceMappingURL=file-matcher.d.ts.map
+export { ValidFileMatcher, buildViteResolveExtensions, createValidFileMatcher, findFileWithExtensions, findFileWithExts, normalizePageExtensions, scanWithExtensions };

package/dist/routing/file-matcher.js

@@ -1,4 +1,6 @@
+import { escapeRegExp } from "../utils/regex.js";
 import { existsSync } from "node:fs";
+import path from "node:path";
 import { glob } from "node:fs/promises";
 //#region src/routing/file-matcher.ts
 const DEFAULT_PAGE_EXTENSIONS = [
@@ -7,9 +9,6 @@ const DEFAULT_PAGE_EXTENSIONS = [
 	"jsx",
 	"js"
 ];
-function escapeRegex(value) {
-	return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
-}
 function normalizePageExtensions(pageExtensions) {
 	if (!Array.isArray(pageExtensions) || pageExtensions.length === 0) return [...DEFAULT_PAGE_EXTENSIONS];
 	const filtered = pageExtensions.filter((ext) => typeof ext === "string").map((ext) => ext.trim().replace(/^\.+/, "")).filter((ext) => ext.length > 0);
@@ -26,7 +25,7 @@ function buildExtensionGlob(stem, extensions) {
 function createValidFileMatcher(pageExtensions) {
 	const extensions = normalizePageExtensions(pageExtensions);
 	const dottedExtensions = extensions.map((ext) => `.${ext}`);
-	const extPattern = `(?:${extensions.map((ext) => escapeRegex(ext)).join("|")})`;
+	const extPattern = `(?:${extensions.map((ext) => escapeRegExp(ext)).join("|")})`;
 	const extensionRegex = new RegExp(`\\.${extPattern}$`);
 	const createLeafPattern = (fileNames) => {
 		const names = fileNames.length === 1 ? fileNames[0] : `(${fileNames.join("|")})`;
@@ -65,6 +64,17 @@ function findFileWithExtensions(basePath, matcher) {
 	return matcher.dottedExtensions.some((ext) => existsSync(basePath + ext));
 }
 /**
+* Find a file by basename and configured page extension in a directory.
+* Returns the first matching absolute path, or null if not found.
+*/
+function findFileWithExts(dir, name, matcher) {
+	for (const ext of matcher.dottedExtensions) {
+		const filePath = path.join(dir, name + ext);
+		if (existsSync(filePath)) return filePath;
+	}
+	return null;
+}
+/**
 * Vite's default `resolve.extensions` covers `.tsx/.ts/.jsx/.js/.json` (and
 * `.mjs/.mts`). When the user configures `pageExtensions` with values Vite
 * does not know about — e.g. `["platform.tsx", "tsx", "mdx"]` from the
@@ -113,6 +123,4 @@ async function* scanWithExtensions(stem, cwd, extensions, exclude) {
 	})) yield file;
 }
 //#endregion
-export { buildViteResolveExtensions, createValidFileMatcher, findFileWithExtensions, normalizePageExtensions, scanWithExtensions };
-
-//# sourceMappingURL=file-matcher.js.map
+export { buildViteResolveExtensions, createValidFileMatcher, findFileWithExtensions, findFileWithExts, normalizePageExtensions, scanWithExtensions };

package/dist/routing/pages-router.d.ts

@@ -45,5 +45,4 @@ declare function matchRoute(url: string, routes: Route[]): {
  */
 declare function apiRouter(pagesDir: string, pageExtensions?: readonly string[], matcher?: ValidFileMatcher): Promise<Route[]>;
 //#endregion
-export { Route, apiRouter, invalidateRouteCache, matchRoute, pagesRouter, patternToNextFormat };
-//# sourceMappingURL=pages-router.d.ts.map
+export { Route, apiRouter, invalidateRouteCache, matchRoute, pagesRouter, patternToNextFormat };

package/dist/routing/pages-router.js

@@ -161,5 +161,3 @@ async function scanApiRoutes(pagesDir, matcher) {
 }
 //#endregion
 export { apiRouter, invalidateRouteCache, matchRoute, pagesRouter, patternToNextFormat };
-
-//# sourceMappingURL=pages-router.js.map

package/dist/routing/route-matching.d.ts

@@ -24,5 +24,4 @@ declare function matchRouteWithTrie<R extends {
   params: Record<string, string | string[]>;
 } | null;
 //#endregion
-export { createRouteTrieCache, matchRouteWithTrie };
-//# sourceMappingURL=route-matching.d.ts.map
+export { createRouteTrieCache, matchRouteWithTrie };

package/dist/routing/route-matching.js

@@ -40,5 +40,3 @@ function matchRouteWithTrie(url, routes, cache) {
 }
 //#endregion
 export { createRouteTrieCache, matchRouteWithTrie };
-
-//# sourceMappingURL=route-matching.js.map