vinext 0.0.51 → 0.0.53

package/dist/shims/url-utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"url-utils.js","names":[],"sources":["../../src/shims/url-utils.ts"],"sourcesContent":["/**\n * Shared URL utilities for same-origin detection.\n *\n * Used by link.tsx, navigation.ts, and router.ts to normalize\n * same-origin absolute URLs to local paths for client-side navigation.\n */\nimport { hasBasePath, stripBasePath } from \"../utils/base-path.js\";\n\n// Mirrors Next.js's absolute URL classification:\n// packages/next/src/shared/lib/utils.ts\nconst ABSOLUTE_URL_REGEX = /^[a-zA-Z][a-zA-Z\\d+\\-.]*?:/;\n\nexport function isAbsoluteUrl(url: string): boolean {\n  const firstChar = url.charCodeAt(0);\n  const startsWithLetter =\n    (firstChar >= 65 && firstChar <= 90) || (firstChar >= 97 && firstChar <= 122);\n\n  return startsWithLetter && ABSOLUTE_URL_REGEX.test(url);\n}\n\nexport function isAbsoluteOrProtocolRelativeUrl(url: string): boolean {\n  return isAbsoluteUrl(url) || url.startsWith(\"//\");\n}\n\n/**\n * If `url` is an absolute same-origin URL, return the local path\n * (pathname + search + hash). Returns null for truly external URLs\n * or on the server (where origin is unknown).\n */\nexport function toSameOriginPath(url: string): string | null {\n  if (typeof window === \"undefined\") return null;\n  try {\n    const parsed = url.startsWith(\"//\") ? new URL(url, window.location.origin) : new URL(url);\n    if (parsed.origin === window.location.origin) {\n      return parsed.pathname + parsed.search + parsed.hash;\n    }\n  } catch {\n    // not a valid absolute URL — ignore\n  }\n  return null;\n}\n\n/**\n * If `url` is an absolute same-origin URL, return the app-relative path\n * (basePath stripped from the pathname, if configured). Returns null for\n * truly external URLs or on the server.\n */\nexport function toSameOriginAppPath(url: string, basePath: string): string | null {\n  const localPath = toSameOriginPath(url);\n  if (localPath == null || !basePath) return localPath;\n\n  try {\n    const parsed = new URL(localPath, \"http://vinext.local\");\n    if (!hasBasePath(parsed.pathname, basePath)) {\n      return null;\n    }\n    const pathname = stripBasePath(parsed.pathname, basePath);\n    return pathname + parsed.search + parsed.hash;\n  } catch {\n    return localPath;\n  }\n}\n\n/**\n * Split a path string into pathname, query, and hash without depending on\n * the URL constructor (which would resolve relative paths against an origin).\n *\n * Ported from Next.js: packages/next/src/shared/lib/router/utils/parse-path.ts\n */\nfunction parsePath(path: string): { pathname: string; query: string; hash: string } {\n  const hashIndex = path.indexOf(\"#\");\n  const queryIndex = path.indexOf(\"?\");\n  const hasQuery = queryIndex > -1 && (hashIndex < 0 || queryIndex < hashIndex);\n\n  if (hasQuery || hashIndex > -1) {\n    return {\n      pathname: path.substring(0, hasQuery ? queryIndex : hashIndex),\n      query: hasQuery ? path.substring(queryIndex, hashIndex > -1 ? hashIndex : undefined) : \"\",\n      hash: hashIndex > -1 ? path.slice(hashIndex) : \"\",\n    };\n  }\n\n  return { pathname: path, query: \"\", hash: \"\" };\n}\n\n/**\n * Drop trailing slashes from a route while preserving the bare root.\n *\n * Ported from Next.js: packages/next/src/shared/lib/router/utils/remove-trailing-slash.ts\n */\nfunction removeRouteTrailingSlash(route: string): string {\n  return route.replace(/\\/$/, \"\") || \"/\";\n}\n\n/**\n * Normalise the trailing slash of a local URL according to the\n * `trailingSlash` config option in `next.config.js`. Used by the `<Link>`\n * shim so that rendered `href` attributes match the canonical URL form\n * (which is what the server-side redirect would otherwise enforce).\n *\n * Behaviour matches Next.js's client-side `normalizePathTrailingSlash`:\n * packages/next/src/client/normalize-trailing-slash.ts\n *\n * - Absolute URLs (`http://`, `https://`, `//`) and non-local strings are\n *   returned unchanged.\n * - Paths whose final segment looks like a filename (`...\\.ext`) have any\n *   trailing slash stripped even when `trailingSlash: true`, mirroring the\n *   `.well-known`-aware redirect rule shipped in `routes-manifest.json`.\n * - Query strings and hash fragments are preserved verbatim.\n * - Idempotent: already-canonical paths round-trip unchanged.\n */\nexport function normalizePathTrailingSlash(path: string, trailingSlash: boolean): string {\n  if (!path.startsWith(\"/\") || path.startsWith(\"//\")) {\n    return path;\n  }\n\n  const { pathname, query, hash } = parsePath(path);\n\n  if (trailingSlash) {\n    if (/\\.[^/]+\\/?$/.test(pathname)) {\n      // Looks like a filename — strip trailing slash even with trailingSlash: true.\n      return `${removeRouteTrailingSlash(pathname)}${query}${hash}`;\n    }\n    if (pathname.endsWith(\"/\")) {\n      return `${pathname}${query}${hash}`;\n    }\n    return `${pathname}/${query}${hash}`;\n  }\n\n  return `${removeRouteTrailingSlash(pathname)}${query}${hash}`;\n}\n\n/**\n * Prepend basePath to a local path for browser URLs / fetches.\n */\nexport function withBasePath(path: string, basePath: string): string {\n  if (!basePath || !path.startsWith(\"/\") || isAbsoluteOrProtocolRelativeUrl(path)) {\n    return path;\n  }\n\n  return basePath + path;\n}\n\n/**\n * Resolve a potentially relative href against the current URL.\n * Handles: \"#hash\", \"?query\", \"?query#hash\", and relative paths.\n */\nexport function resolveRelativeHref(href: string, currentUrl?: string, basePath = \"\"): string {\n  const base = currentUrl ?? (typeof window !== \"undefined\" ? window.location.href : undefined);\n\n  if (!base) return href;\n\n  if (href.startsWith(\"/\") || isAbsoluteOrProtocolRelativeUrl(href)) {\n    return href;\n  }\n\n  try {\n    const resolved = new URL(href, base);\n    const pathname =\n      basePath && resolved.pathname === basePath\n        ? \"\"\n        : basePath\n          ? stripBasePath(resolved.pathname, basePath)\n          : resolved.pathname;\n    return pathname + resolved.search + resolved.hash;\n  } catch {\n    return href;\n  }\n}\n\n/**\n * Convert a local navigation target into the browser URL that should be used\n * for history entries, fetches, and onNavigate callbacks.\n */\nexport function toBrowserNavigationHref(href: string, currentUrl?: string, basePath = \"\"): string {\n  const resolved = resolveRelativeHref(href, currentUrl, basePath);\n\n  if (!basePath) {\n    return withBasePath(resolved, basePath);\n  }\n\n  if (resolved === \"\") {\n    return basePath;\n  }\n\n  if (resolved.startsWith(\"?\") || resolved.startsWith(\"#\")) {\n    return basePath + resolved;\n  }\n\n  return withBasePath(resolved, basePath);\n}\n\nexport function isHashOnlyBrowserUrlChange(\n  href: string,\n  currentHref: string,\n  basePath = \"\",\n): boolean {\n  try {\n    const current = new URL(currentHref);\n    const next = new URL(href, currentHref);\n    const currentPathname = stripBasePath(current.pathname, basePath);\n    const nextPathname = stripBasePath(next.pathname, basePath);\n    return currentPathname === nextPathname && current.search === next.search && next.hash !== \"\";\n  } catch {\n    return false;\n  }\n}\n"],"mappings":";;;;;;;;AAUA,MAAM,qBAAqB;AAE3B,SAAgB,cAAc,KAAsB;CAClD,MAAM,YAAY,IAAI,WAAW,EAAE;CAInC,QAFG,aAAa,MAAM,aAAa,MAAQ,aAAa,MAAM,aAAa,QAEhD,mBAAmB,KAAK,IAAI;;AAGzD,SAAgB,gCAAgC,KAAsB;CACpE,OAAO,cAAc,IAAI,IAAI,IAAI,WAAW,KAAK;;;;;;;AAQnD,SAAgB,iBAAiB,KAA4B;CAC3D,IAAI,OAAO,WAAW,aAAa,OAAO;CAC1C,IAAI;EACF,MAAM,SAAS,IAAI,WAAW,KAAK,GAAG,IAAI,IAAI,KAAK,OAAO,SAAS,OAAO,GAAG,IAAI,IAAI,IAAI;EACzF,IAAI,OAAO,WAAW,OAAO,SAAS,QACpC,OAAO,OAAO,WAAW,OAAO,SAAS,OAAO;SAE5C;CAGR,OAAO;;;;;;;AAQT,SAAgB,oBAAoB,KAAa,UAAiC;CAChF,MAAM,YAAY,iBAAiB,IAAI;CACvC,IAAI,aAAa,QAAQ,CAAC,UAAU,OAAO;CAE3C,IAAI;EACF,MAAM,SAAS,IAAI,IAAI,WAAW,sBAAsB;EACxD,IAAI,CAAC,YAAY,OAAO,UAAU,SAAS,EACzC,OAAO;EAGT,OADiB,cAAc,OAAO,UAAU,SACjC,GAAG,OAAO,SAAS,OAAO;SACnC;EACN,OAAO;;;;;;;;;AAUX,SAAS,UAAU,MAAiE;CAClF,MAAM,YAAY,KAAK,QAAQ,IAAI;CACnC,MAAM,aAAa,KAAK,QAAQ,IAAI;CACpC,MAAM,WAAW,aAAa,OAAO,YAAY,KAAK,aAAa;CAEnE,IAAI,YAAY,YAAY,IAC1B,OAAO;EACL,UAAU,KAAK,UAAU,GAAG,WAAW,aAAa,UAAU;EAC9D,OAAO,WAAW,KAAK,UAAU,YAAY,YAAY,KAAK,YAAY,KAAA,EAAU,GAAG;EACvF,MAAM,YAAY,KAAK,KAAK,MAAM,UAAU,GAAG;EAChD;CAGH,OAAO;EAAE,UAAU;EAAM,OAAO;EAAI,MAAM;EAAI;;;;;;;AAQhD,SAAS,yBAAyB,OAAuB;CACvD,OAAO,MAAM,QAAQ,OAAO,GAAG,IAAI;;;;;;;;;;;;;;;;;;;AAoBrC,SAAgB,2BAA2B,MAAc,eAAgC;CACvF,IAAI,CAAC,KAAK,WAAW,IAAI,IAAI,KAAK,WAAW,KAAK,EAChD,OAAO;CAGT,MAAM,EAAE,UAAU,OAAO,SAAS,UAAU,KAAK;CAEjD,IAAI,eAAe;EACjB,IAAI,cAAc,KAAK,SAAS,EAE9B,OAAO,GAAG,yBAAyB,SAAS,GAAG,QAAQ;EAEzD,IAAI,SAAS,SAAS,IAAI,EACxB,OAAO,GAAG,WAAW,QAAQ;EAE/B,OAAO,GAAG,SAAS,GAAG,QAAQ;;CAGhC,OAAO,GAAG,yBAAyB,SAAS,GAAG,QAAQ;;;;;AAMzD,SAAgB,aAAa,MAAc,UAA0B;CACnE,IAAI,CAAC,YAAY,CAAC,KAAK,WAAW,IAAI,IAAI,gCAAgC,KAAK,EAC7E,OAAO;CAGT,OAAO,WAAW;;;;;;AAOpB,SAAgB,oBAAoB,MAAc,YAAqB,WAAW,IAAY;CAC5F,MAAM,OAAO,eAAe,OAAO,WAAW,cAAc,OAAO,SAAS,OAAO,KAAA;CAEnF,IAAI,CAAC,MAAM,OAAO;CAElB,IAAI,KAAK,WAAW,IAAI,IAAI,gCAAgC,KAAK,EAC/D,OAAO;CAGT,IAAI;EACF,MAAM,WAAW,IAAI,IAAI,MAAM,KAAK;EAOpC,QALE,YAAY,SAAS,aAAa,WAC9B,KACA,WACE,cAAc,SAAS,UAAU,SAAS,GAC1C,SAAS,YACC,SAAS,SAAS,SAAS;SACvC;EACN,OAAO;;;;;;;AAQX,SAAgB,wBAAwB,MAAc,YAAqB,WAAW,IAAY;CAChG,MAAM,WAAW,oBAAoB,MAAM,YAAY,SAAS;CAEhE,IAAI,CAAC,UACH,OAAO,aAAa,UAAU,SAAS;CAGzC,IAAI,aAAa,IACf,OAAO;CAGT,IAAI,SAAS,WAAW,IAAI,IAAI,SAAS,WAAW,IAAI,EACtD,OAAO,WAAW;CAGpB,OAAO,aAAa,UAAU,SAAS;;AAGzC,SAAgB,2BACd,MACA,aACA,WAAW,IACF;CACT,IAAI;EACF,MAAM,UAAU,IAAI,IAAI,YAAY;EACpC,MAAM,OAAO,IAAI,IAAI,MAAM,YAAY;EAGvC,OAFwB,cAAc,QAAQ,UAAU,SAElC,KADD,cAAc,KAAK,UAAU,SACX,IAAI,QAAQ,WAAW,KAAK,UAAU,KAAK,SAAS;SACrF;EACN,OAAO"}
+{"version":3,"file":"url-utils.js","names":[],"sources":["../../src/shims/url-utils.ts"],"sourcesContent":["/**\n * Shared URL utilities for same-origin detection.\n *\n * Used by link.tsx, navigation.ts, and router.ts to normalize\n * same-origin absolute URLs to local paths for client-side navigation.\n */\nimport { hasBasePath, stripBasePath } from \"../utils/base-path.js\";\n\n// Mirrors Next.js's absolute URL classification:\n// packages/next/src/shared/lib/utils.ts\nconst ABSOLUTE_URL_REGEX = /^[a-zA-Z][a-zA-Z\\d+\\-.]*?:/;\n\nexport function isAbsoluteUrl(url: string): boolean {\n  const firstChar = url.charCodeAt(0);\n  const startsWithLetter =\n    (firstChar >= 65 && firstChar <= 90) || (firstChar >= 97 && firstChar <= 122);\n\n  return startsWithLetter && ABSOLUTE_URL_REGEX.test(url);\n}\n\nexport function isAbsoluteOrProtocolRelativeUrl(url: string): boolean {\n  return isAbsoluteUrl(url) || url.startsWith(\"//\");\n}\n\nexport function getWindowOrigin(): string | null {\n  if (typeof window === \"undefined\") return null;\n  const { origin, href } = window.location;\n  if (origin) return origin;\n  try {\n    return new URL(href).origin;\n  } catch {\n    return null;\n  }\n}\n\n/**\n * If `url` is an absolute same-origin URL, return the local path\n * (pathname + search + hash). Returns null for truly external URLs\n * or on the server (where origin is unknown).\n */\nexport function toSameOriginPath(url: string): string | null {\n  const origin = getWindowOrigin();\n  if (!origin) return null;\n  try {\n    const parsed = url.startsWith(\"//\") ? new URL(url, origin) : new URL(url);\n    if (parsed.origin === origin) {\n      return parsed.pathname + parsed.search + parsed.hash;\n    }\n  } catch {\n    // not a valid absolute URL — ignore\n  }\n  return null;\n}\n\n/**\n * If `url` is an absolute same-origin URL, return the app-relative path\n * (basePath stripped from the pathname, if configured). Returns null for\n * truly external URLs or on the server.\n */\nexport function toSameOriginAppPath(url: string, basePath: string): string | null {\n  const localPath = toSameOriginPath(url);\n  if (localPath == null || !basePath) return localPath;\n\n  try {\n    const parsed = new URL(localPath, \"http://vinext.local\");\n    if (!hasBasePath(parsed.pathname, basePath)) {\n      return null;\n    }\n    const pathname = stripBasePath(parsed.pathname, basePath);\n    return pathname + parsed.search + parsed.hash;\n  } catch {\n    return localPath;\n  }\n}\n\n/**\n * Split a path string into pathname, query, and hash without depending on\n * the URL constructor (which would resolve relative paths against an origin).\n *\n * Ported from Next.js: packages/next/src/shared/lib/router/utils/parse-path.ts\n */\nfunction parsePath(path: string): { pathname: string; query: string; hash: string } {\n  const hashIndex = path.indexOf(\"#\");\n  const queryIndex = path.indexOf(\"?\");\n  const hasQuery = queryIndex > -1 && (hashIndex < 0 || queryIndex < hashIndex);\n\n  if (hasQuery || hashIndex > -1) {\n    return {\n      pathname: path.substring(0, hasQuery ? queryIndex : hashIndex),\n      query: hasQuery ? path.substring(queryIndex, hashIndex > -1 ? hashIndex : undefined) : \"\",\n      hash: hashIndex > -1 ? path.slice(hashIndex) : \"\",\n    };\n  }\n\n  return { pathname: path, query: \"\", hash: \"\" };\n}\n\n/**\n * Drop trailing slashes from a route while preserving the bare root.\n *\n * Ported from Next.js: packages/next/src/shared/lib/router/utils/remove-trailing-slash.ts\n */\nfunction removeRouteTrailingSlash(route: string): string {\n  return route.replace(/\\/$/, \"\") || \"/\";\n}\n\n/**\n * Normalise the trailing slash of a local URL according to the\n * `trailingSlash` config option in `next.config.js`. Used by the `<Link>`\n * shim so that rendered `href` attributes match the canonical URL form\n * (which is what the server-side redirect would otherwise enforce).\n *\n * Behaviour matches Next.js's client-side `normalizePathTrailingSlash`:\n * packages/next/src/client/normalize-trailing-slash.ts\n *\n * - Absolute URLs (`http://`, `https://`, `//`) and non-local strings are\n *   returned unchanged.\n * - Paths whose final segment looks like a filename (`...\\.ext`) have any\n *   trailing slash stripped even when `trailingSlash: true`, mirroring the\n *   `.well-known`-aware redirect rule shipped in `routes-manifest.json`.\n * - Query strings and hash fragments are preserved verbatim.\n * - Idempotent: already-canonical paths round-trip unchanged.\n */\nexport function normalizePathTrailingSlash(path: string, trailingSlash: boolean): string {\n  if (!path.startsWith(\"/\") || path.startsWith(\"//\")) {\n    return path;\n  }\n\n  const { pathname, query, hash } = parsePath(path);\n\n  if (trailingSlash) {\n    if (/\\.[^/]+\\/?$/.test(pathname)) {\n      // Looks like a filename — strip trailing slash even with trailingSlash: true.\n      return `${removeRouteTrailingSlash(pathname)}${query}${hash}`;\n    }\n    if (pathname.endsWith(\"/\")) {\n      return `${pathname}${query}${hash}`;\n    }\n    return `${pathname}/${query}${hash}`;\n  }\n\n  return `${removeRouteTrailingSlash(pathname)}${query}${hash}`;\n}\n\n/**\n * Prepend basePath to a local path for browser URLs / fetches.\n */\nexport function withBasePath(path: string, basePath: string): string {\n  if (!basePath || !path.startsWith(\"/\") || isAbsoluteOrProtocolRelativeUrl(path)) {\n    return path;\n  }\n\n  return basePath + path;\n}\n\n/**\n * Resolve a potentially relative href against the current URL.\n * Handles: \"#hash\", \"?query\", \"?query#hash\", and relative paths.\n */\nexport function resolveRelativeHref(href: string, currentUrl?: string, basePath = \"\"): string {\n  const base = currentUrl ?? (typeof window !== \"undefined\" ? window.location.href : undefined);\n\n  if (!base) return href;\n\n  if (href.startsWith(\"/\") || isAbsoluteOrProtocolRelativeUrl(href)) {\n    return href;\n  }\n\n  try {\n    const resolved = new URL(href, base);\n    const pathname =\n      basePath && resolved.pathname === basePath\n        ? \"\"\n        : basePath\n          ? stripBasePath(resolved.pathname, basePath)\n          : resolved.pathname;\n    return pathname + resolved.search + resolved.hash;\n  } catch {\n    return href;\n  }\n}\n\n/**\n * Convert a local navigation target into the browser URL that should be used\n * for history entries, fetches, and onNavigate callbacks.\n */\nexport function toBrowserNavigationHref(href: string, currentUrl?: string, basePath = \"\"): string {\n  const resolved = resolveRelativeHref(href, currentUrl, basePath);\n\n  if (!basePath) {\n    return withBasePath(resolved, basePath);\n  }\n\n  if (resolved === \"\") {\n    return basePath;\n  }\n\n  if (resolved.startsWith(\"?\") || resolved.startsWith(\"#\")) {\n    return basePath + resolved;\n  }\n\n  return withBasePath(resolved, basePath);\n}\n\nexport function isHashOnlyBrowserUrlChange(\n  href: string,\n  currentHref: string,\n  basePath = \"\",\n): boolean {\n  try {\n    const current = new URL(currentHref);\n    const next = new URL(href, currentHref);\n    const currentPathname = stripBasePath(current.pathname, basePath);\n    const nextPathname = stripBasePath(next.pathname, basePath);\n    return currentPathname === nextPathname && current.search === next.search && next.hash !== \"\";\n  } catch {\n    return false;\n  }\n}\n"],"mappings":"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"}

package/dist/typegen.d.ts

@@ -0,0 +1,10 @@
+//#region src/typegen.d.ts
+type GenerateRouteTypesOptions = {
+  root: string;
+  appDir?: string | null;
+  pageExtensions?: readonly string[];
+};
+declare function generateRouteTypes(options: GenerateRouteTypesOptions): Promise<string>;
+//#endregion
+export { generateRouteTypes };
+//# sourceMappingURL=typegen.d.ts.map

package/dist/typegen.js

@@ -0,0 +1,242 @@
+import { decodeRouteSegment } from "./routing/utils.js";
+import { patternToNextFormat } from "./routing/route-validation.js";
+import { isInvisibleSegment } from "./routing/app-route-graph.js";
+import { appRouteGraph } from "./routing/app-router.js";
+import path from "node:path";
+import fs from "node:fs/promises";
+//#region src/typegen.ts
+const NEXT_ENV_FILE_CONTENT = `/// <reference types="next" />
+/// <reference types="next/image-types/global" />
+import "./.next/types/routes.d.ts";
+
+// NOTE: This file should not be edited
+// 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) : await findAppDir(root);
+	const outPath = path.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.writeFile(outPath, content, "utf-8");
+	await ensureNextEnvFile(root);
+	return outPath;
+}
+async function ensureNextEnvFile(root) {
+	const envPath = path.join(root, "next-env.d.ts");
+	try {
+		await fs.writeFile(envPath, NEXT_ENV_FILE_CONTENT, {
+			encoding: "utf-8",
+			flag: "wx"
+		});
+	} catch (error) {
+		if (error.code !== "EEXIST") throw error;
+	}
+}
+function emptyRouteTypeModel() {
+	return {
+		pageRoutes: [],
+		layoutRoutes: [],
+		routeHandlerRoutes: [],
+		params: /* @__PURE__ */ new Map(),
+		layoutSlots: /* @__PURE__ */ new Map()
+	};
+}
+async function collectRouteTypeModel(appDir, pageExtensions) {
+	const graph = await appRouteGraph(appDir, pageExtensions);
+	const model = emptyRouteTypeModel();
+	const segmentGraph = graph.routeManifest.segmentGraph;
+	const layoutRouteKeys = createLayoutRouteKeyMap(segmentGraph.layouts.values());
+	const pageRouteSet = /* @__PURE__ */ new Set();
+	const layoutRouteSet = /* @__PURE__ */ new Set();
+	const routeHandlerRouteSet = /* @__PURE__ */ new Set();
+	for (const route of segmentGraph.pages.values()) {
+		const routeEntry = segmentGraph.routes.get(route.routeId);
+		addRoute(model.pageRoutes, pageRouteSet, model.params, patternToNextFormat(route.pattern), paramsForPatternParts(routeEntry?.patternParts ?? []));
+	}
+	for (const route of segmentGraph.routeHandlers.values()) {
+		const routeEntry = segmentGraph.routes.get(route.routeId);
+		addRoute(model.routeHandlerRoutes, routeHandlerRouteSet, model.params, patternToNextFormat(route.pattern), paramsForPatternParts(routeEntry?.patternParts ?? []));
+	}
+	for (const layout of segmentGraph.layouts.values()) {
+		const route = layoutRouteKeys.get(layout.treePath) ?? treePathToRouteLiteral(layout.treePath);
+		addRoute(model.layoutRoutes, layoutRouteSet, model.params, route, paramsForPatternParts(layout.patternParts));
+	}
+	const layoutSlotSets = /* @__PURE__ */ new Map();
+	for (const slot of segmentGraph.slots.values()) {
+		const layoutRoute = layoutRouteKeyForSlot(slot, segmentGraph.layouts, layoutRouteKeys);
+		if (!layoutRoute) continue;
+		let slotNames = layoutSlotSets.get(layoutRoute);
+		if (!slotNames) {
+			slotNames = /* @__PURE__ */ new Set();
+			layoutSlotSets.set(layoutRoute, slotNames);
+			model.layoutSlots.set(layoutRoute, []);
+		}
+		if (!slotNames.has(slot.name)) {
+			slotNames.add(slot.name);
+			model.layoutSlots.get(layoutRoute)?.push(slot.name);
+		}
+	}
+	model.pageRoutes.sort(compareStrings);
+	model.layoutRoutes.sort(compareStrings);
+	model.routeHandlerRoutes.sort(compareStrings);
+	for (const slotNames of model.layoutSlots.values()) slotNames.sort(compareStrings);
+	return model;
+}
+async function findAppDir(root) {
+	for (const rel of ["app", path.join("src", "app")]) {
+		const candidate = path.join(root, rel);
+		try {
+			if ((await fs.stat(candidate)).isDirectory()) return candidate;
+		} catch {}
+	}
+	return null;
+}
+function renderRouteTypes(model) {
+	const allRoutes = uniqueSorted([
+		...model.pageRoutes,
+		...model.layoutRoutes,
+		...model.routeHandlerRoutes
+	]);
+	return `// This file is generated by vinext. Do not edit.
+import type * as React from "react";
+
+declare global {
+  type PageProps<Route extends VinextRouteTypes.PageRoute = VinextRouteTypes.PageRoute> = {
+    params: Promise<VinextRouteTypes.ParamMap[Route]>;
+    searchParams: Promise<Record<string, string | string[] | undefined>>;
+  };
+
+  type LayoutProps<Route extends VinextRouteTypes.LayoutRoute> = {
+    params: Promise<VinextRouteTypes.ParamMap[Route]>;
+    children: React.ReactNode;
+  } & {
+    [K in VinextRouteTypes.LayoutSlotMap[Route]]: React.ReactNode;
+  };
+
+  type RouteContext<Route extends VinextRouteTypes.RouteHandlerRoute = VinextRouteTypes.RouteHandlerRoute> = {
+    params: Promise<VinextRouteTypes.ParamMap[Route]>;
+  };
+}
+
+declare namespace VinextRouteTypes {
+  type PageRoute = ${routeUnion(model.pageRoutes)};
+  type LayoutRoute = ${routeUnion(model.layoutRoutes)};
+  type RouteHandlerRoute = ${routeUnion(model.routeHandlerRoutes)};
+  type AppRoute = ${routeUnion(allRoutes)};
+
+  interface ParamMap {
+${renderParamMap(allRoutes, model.params)}
+  }
+
+  interface LayoutSlotMap {
+${renderLayoutSlotMap(model.layoutRoutes, model.layoutSlots)}
+  }
+}
+
+export {};
+`;
+}
+function renderParamMap(routes, params) {
+	if (routes.length === 0) return "    [route: string]: {};\n";
+	return routes.map((route) => `    ${quote(route)}: ${renderParamShape(params.get(route) ?? /* @__PURE__ */ new Map())};`).join("\n");
+}
+function renderParamShape(params) {
+	if (params.size === 0) return "{}";
+	return `{ ${Array.from(params.entries()).sort(([left], [right]) => compareStrings(left, right)).map(([name, kind]) => {
+		const optional = kind === "string[]?";
+		const valueType = optional ? "string[]" : kind;
+		return `${propertyName(name)}${optional ? "?" : ""}: ${valueType};`;
+	}).join(" ")} }`;
+}
+function renderLayoutSlotMap(layoutRoutes, layoutSlots) {
+	if (layoutRoutes.length === 0) return "    [route: string]: never;\n";
+	return layoutRoutes.map((route) => {
+		const slots = layoutSlots.get(route) ?? [];
+		return `    ${quote(route)}: ${routeUnion(slots)};`;
+	}).join("\n");
+}
+function paramsForPatternParts(patternParts) {
+	const params = /* @__PURE__ */ new Map();
+	for (const part of patternParts) {
+		if (!part.startsWith(":")) continue;
+		if (part.endsWith("+")) params.set(part.slice(1, -1), "string[]");
+		else if (part.endsWith("*")) params.set(part.slice(1, -1), "string[]?");
+		else params.set(part.slice(1), "string");
+	}
+	return params;
+}
+function createLayoutRouteKeyMap(layouts) {
+	const treePathsByRoute = /* @__PURE__ */ new Map();
+	for (const { treePath } of layouts) {
+		const route = treePathToRouteLiteral(treePath);
+		const treePaths = treePathsByRoute.get(route) ?? [];
+		treePaths.push(treePath);
+		treePathsByRoute.set(route, treePaths);
+	}
+	const keys = /* @__PURE__ */ new Map();
+	for (const [route, treePaths] of treePathsByRoute) for (const treePath of treePaths) keys.set(treePath, treePaths.length === 1 ? route : treePathToScopedLayoutRouteLiteral(treePath));
+	return keys;
+}
+function layoutRouteKeyForSlot(slot, layouts, layoutRouteKeys) {
+	if (!slot.ownerLayoutId) return null;
+	const layout = layouts.get(slot.ownerLayoutId);
+	if (!layout) throw new Error(`[vinext] App route graph invariant violated: slot ${slot.id} references missing owner layout ${slot.ownerLayoutId}`);
+	return layoutRouteKeys.get(layout.treePath) ?? treePathToRouteLiteral(layout.treePath);
+}
+/** Convert a layout tree path to its URL route literal, stripping invisible segments. */
+function treePathToRouteLiteral(treePath) {
+	if (treePath === "/") return "/";
+	const segments = treePath.split("/").filter(Boolean).filter((segment) => !isInvisibleSegment(segment)).map((segment) => decodeRouteSegment(segment));
+	return segments.length === 0 ? "/" : `/${segments.join("/")}`;
+}
+/**
+* Convert a layout tree path to a scoped route literal that preserves
+* route-group and `@slot` segments. Used only as a fallback key when multiple
+* layouts collapse to the same URL route literal, so consumers can keep their
+* slot/params typings distinct.
+*/
+function treePathToScopedLayoutRouteLiteral(treePath) {
+	if (treePath === "/") return "/";
+	const segments = treePath.split("/").filter(Boolean).filter((segment) => segment !== ".").map((segment) => decodeRouteSegment(segment));
+	return segments.length === 0 ? "/" : `/${segments.join("/")}`;
+}
+function addRoute(routes, seen, params, route, paramShape) {
+	if (!seen.has(route)) {
+		seen.add(route);
+		routes.push(route);
+	}
+	const existingParamShape = params.get(route);
+	if (existingParamShape) {
+		if (!paramShapesEqual(existingParamShape, paramShape)) throw new Error(`[vinext] Conflicting route param shapes generated for ${route}`);
+		return;
+	}
+	params.set(route, paramShape);
+}
+function paramShapesEqual(left, right) {
+	if (left.size !== right.size) return false;
+	for (const [name, kind] of left) if (right.get(name) !== kind) return false;
+	return true;
+}
+function uniqueSorted(values) {
+	return Array.from(new Set(values)).sort(compareStrings);
+}
+function routeUnion(routes) {
+	if (routes.length === 0) return "never";
+	return routes.map(quote).join(" | ");
+}
+function propertyName(name) {
+	return /^[A-Za-z_$][\w$]*$/.test(name) ? name : quote(name);
+}
+function quote(value) {
+	return JSON.stringify(value);
+}
+function compareStrings(left, right) {
+	if (left < right) return -1;
+	if (left > right) return 1;
+	return 0;
+}
+//#endregion
+export { generateRouteTypes };
+
+//# sourceMappingURL=typegen.js.map

package/dist/typegen.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"typegen.js","names":[],"sources":["../src/typegen.ts"],"sourcesContent":["import fs from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { isInvisibleSegment } from \"./routing/app-route-graph.js\";\nimport { appRouteGraph } from \"./routing/app-router.js\";\nimport { patternToNextFormat } from \"./routing/route-validation.js\";\nimport { decodeRouteSegment } from \"./routing/utils.js\";\n\ntype GenerateRouteTypesOptions = {\n  root: string;\n  appDir?: string | null;\n  pageExtensions?: readonly string[];\n};\n\ntype ParamShape = Map<string, \"string\" | \"string[]\" | \"string[]?\">;\n\nconst NEXT_ENV_FILE_CONTENT = `/// <reference types=\"next\" />\n/// <reference types=\"next/image-types/global\" />\nimport \"./.next/types/routes.d.ts\";\n\n// NOTE: This file should not be edited\n// see https://nextjs.org/docs/app/api-reference/config/typescript for more information.\n`;\n\nexport async function generateRouteTypes(options: GenerateRouteTypesOptions): Promise<string> {\n  const root = path.resolve(options.root);\n  const appDir = options.appDir ? path.resolve(options.appDir) : await findAppDir(root);\n  const outPath = path.join(root, \".next\", \"types\", \"routes.d.ts\");\n\n  const content = appDir\n    ? renderRouteTypes(await collectRouteTypeModel(appDir, options.pageExtensions))\n    : renderRouteTypes(emptyRouteTypeModel());\n\n  await fs.mkdir(path.dirname(outPath), { recursive: true });\n  await fs.writeFile(outPath, content, \"utf-8\");\n  await ensureNextEnvFile(root);\n  return outPath;\n}\n\nasync function ensureNextEnvFile(root: string): Promise<void> {\n  const envPath = path.join(root, \"next-env.d.ts\");\n  try {\n    await fs.writeFile(envPath, NEXT_ENV_FILE_CONTENT, { encoding: \"utf-8\", flag: \"wx\" });\n  } catch (error) {\n    if ((error as NodeJS.ErrnoException).code !== \"EEXIST\") throw error;\n  }\n}\n\ntype RouteTypeModel = {\n  pageRoutes: string[];\n  layoutRoutes: string[];\n  routeHandlerRoutes: string[];\n  params: Map<string, ParamShape>;\n  layoutSlots: Map<string, string[]>;\n};\n\nfunction emptyRouteTypeModel(): RouteTypeModel {\n  return {\n    pageRoutes: [],\n    layoutRoutes: [],\n    routeHandlerRoutes: [],\n    params: new Map(),\n    layoutSlots: new Map(),\n  };\n}\n\nasync function collectRouteTypeModel(\n  appDir: string,\n  pageExtensions?: readonly string[],\n): Promise<RouteTypeModel> {\n  const graph = await appRouteGraph(appDir, pageExtensions);\n  const model = emptyRouteTypeModel();\n  const segmentGraph = graph.routeManifest.segmentGraph;\n  const layoutRouteKeys = createLayoutRouteKeyMap(segmentGraph.layouts.values());\n  const pageRouteSet = new Set<string>();\n  const layoutRouteSet = new Set<string>();\n  const routeHandlerRouteSet = new Set<string>();\n\n  for (const route of segmentGraph.pages.values()) {\n    const routeEntry = segmentGraph.routes.get(route.routeId);\n    addRoute(\n      model.pageRoutes,\n      pageRouteSet,\n      model.params,\n      patternToNextFormat(route.pattern),\n      paramsForPatternParts(routeEntry?.patternParts ?? []),\n    );\n  }\n\n  for (const route of segmentGraph.routeHandlers.values()) {\n    const routeEntry = segmentGraph.routes.get(route.routeId);\n    addRoute(\n      model.routeHandlerRoutes,\n      routeHandlerRouteSet,\n      model.params,\n      patternToNextFormat(route.pattern),\n      paramsForPatternParts(routeEntry?.patternParts ?? []),\n    );\n  }\n\n  for (const layout of segmentGraph.layouts.values()) {\n    const route = layoutRouteKeys.get(layout.treePath) ?? treePathToRouteLiteral(layout.treePath);\n    addRoute(\n      model.layoutRoutes,\n      layoutRouteSet,\n      model.params,\n      route,\n      paramsForPatternParts(layout.patternParts),\n    );\n  }\n\n  const layoutSlotSets = new Map<string, Set<string>>();\n  for (const slot of segmentGraph.slots.values()) {\n    const layoutRoute = layoutRouteKeyForSlot(slot, segmentGraph.layouts, layoutRouteKeys);\n    if (!layoutRoute) continue;\n\n    let slotNames = layoutSlotSets.get(layoutRoute);\n    if (!slotNames) {\n      slotNames = new Set();\n      layoutSlotSets.set(layoutRoute, slotNames);\n      model.layoutSlots.set(layoutRoute, []);\n    }\n    if (!slotNames.has(slot.name)) {\n      slotNames.add(slot.name);\n      model.layoutSlots.get(layoutRoute)?.push(slot.name);\n    }\n  }\n\n  // Sort all collected route lists once after collection. addRoute() and the\n  // slot loop above intentionally skip per-insertion sorts to keep collection\n  // O(n) — the rendered output relies on stable sorted order, so the single\n  // pass here is enough.\n  model.pageRoutes.sort(compareStrings);\n  model.layoutRoutes.sort(compareStrings);\n  model.routeHandlerRoutes.sort(compareStrings);\n  for (const slotNames of model.layoutSlots.values()) slotNames.sort(compareStrings);\n\n  return model;\n}\n\nasync function findAppDir(root: string): Promise<string | null> {\n  for (const rel of [\"app\", path.join(\"src\", \"app\")]) {\n    const candidate = path.join(root, rel);\n    try {\n      const stat = await fs.stat(candidate);\n      if (stat.isDirectory()) return candidate;\n    } catch {\n      // Try the next conventional app directory.\n    }\n  }\n  return null;\n}\n\nfunction renderRouteTypes(model: RouteTypeModel): string {\n  const allRoutes = uniqueSorted([\n    ...model.pageRoutes,\n    ...model.layoutRoutes,\n    ...model.routeHandlerRoutes,\n  ]);\n\n  return `// This file is generated by vinext. Do not edit.\nimport type * as React from \"react\";\n\ndeclare global {\n  type PageProps<Route extends VinextRouteTypes.PageRoute = VinextRouteTypes.PageRoute> = {\n    params: Promise<VinextRouteTypes.ParamMap[Route]>;\n    searchParams: Promise<Record<string, string | string[] | undefined>>;\n  };\n\n  type LayoutProps<Route extends VinextRouteTypes.LayoutRoute> = {\n    params: Promise<VinextRouteTypes.ParamMap[Route]>;\n    children: React.ReactNode;\n  } & {\n    [K in VinextRouteTypes.LayoutSlotMap[Route]]: React.ReactNode;\n  };\n\n  type RouteContext<Route extends VinextRouteTypes.RouteHandlerRoute = VinextRouteTypes.RouteHandlerRoute> = {\n    params: Promise<VinextRouteTypes.ParamMap[Route]>;\n  };\n}\n\ndeclare namespace VinextRouteTypes {\n  type PageRoute = ${routeUnion(model.pageRoutes)};\n  type LayoutRoute = ${routeUnion(model.layoutRoutes)};\n  type RouteHandlerRoute = ${routeUnion(model.routeHandlerRoutes)};\n  type AppRoute = ${routeUnion(allRoutes)};\n\n  interface ParamMap {\n${renderParamMap(allRoutes, model.params)}\n  }\n\n  interface LayoutSlotMap {\n${renderLayoutSlotMap(model.layoutRoutes, model.layoutSlots)}\n  }\n}\n\nexport {};\n`;\n}\n\nfunction renderParamMap(\n  routes: readonly string[],\n  params: ReadonlyMap<string, ParamShape>,\n): string {\n  if (routes.length === 0) return \"    [route: string]: {};\\n\";\n\n  return routes\n    .map((route) => `    ${quote(route)}: ${renderParamShape(params.get(route) ?? new Map())};`)\n    .join(\"\\n\");\n}\n\nfunction renderParamShape(params: ParamShape): string {\n  if (params.size === 0) return \"{}\";\n\n  const fields = Array.from(params.entries())\n    .sort(([left], [right]) => compareStrings(left, right))\n    .map(([name, kind]) => {\n      const optional = kind === \"string[]?\";\n      const valueType = optional ? \"string[]\" : kind;\n      return `${propertyName(name)}${optional ? \"?\" : \"\"}: ${valueType};`;\n    });\n\n  return `{ ${fields.join(\" \")} }`;\n}\n\nfunction renderLayoutSlotMap(\n  layoutRoutes: readonly string[],\n  layoutSlots: ReadonlyMap<string, readonly string[]>,\n): string {\n  if (layoutRoutes.length === 0) return \"    [route: string]: never;\\n\";\n\n  return layoutRoutes\n    .map((route) => {\n      const slots = layoutSlots.get(route) ?? [];\n      return `    ${quote(route)}: ${routeUnion(slots)};`;\n    })\n    .join(\"\\n\");\n}\n\nfunction paramsForPatternParts(patternParts: readonly string[]): ParamShape {\n  const params: ParamShape = new Map();\n  for (const part of patternParts) {\n    if (!part.startsWith(\":\")) continue;\n\n    if (part.endsWith(\"+\")) {\n      params.set(part.slice(1, -1), \"string[]\");\n    } else if (part.endsWith(\"*\")) {\n      params.set(part.slice(1, -1), \"string[]?\");\n    } else {\n      params.set(part.slice(1), \"string\");\n    }\n  }\n  return params;\n}\n\nfunction createLayoutRouteKeyMap(layouts: Iterable<{ treePath: string }>): Map<string, string> {\n  const treePathsByRoute = new Map<string, string[]>();\n  for (const { treePath } of layouts) {\n    const route = treePathToRouteLiteral(treePath);\n    const treePaths = treePathsByRoute.get(route) ?? [];\n    treePaths.push(treePath);\n    treePathsByRoute.set(route, treePaths);\n  }\n\n  const keys = new Map<string, string>();\n  for (const [route, treePaths] of treePathsByRoute) {\n    for (const treePath of treePaths) {\n      keys.set(\n        treePath,\n        treePaths.length === 1 ? route : treePathToScopedLayoutRouteLiteral(treePath),\n      );\n    }\n  }\n  return keys;\n}\n\nfunction layoutRouteKeyForSlot(\n  slot: { id: string; ownerLayoutId: string | null },\n  layouts: ReadonlyMap<string, { treePath: string }>,\n  layoutRouteKeys: ReadonlyMap<string, string>,\n): string | null {\n  if (!slot.ownerLayoutId) return null;\n\n  const layout = layouts.get(slot.ownerLayoutId);\n  if (!layout) {\n    throw new Error(\n      `[vinext] App route graph invariant violated: slot ${slot.id} references missing owner layout ${slot.ownerLayoutId}`,\n    );\n  }\n\n  return layoutRouteKeys.get(layout.treePath) ?? treePathToRouteLiteral(layout.treePath);\n}\n\n/** Convert a layout tree path to its URL route literal, stripping invisible segments. */\nfunction treePathToRouteLiteral(treePath: string): string {\n  if (treePath === \"/\") return \"/\";\n\n  const segments = treePath\n    .split(\"/\")\n    .filter(Boolean)\n    .filter((segment) => !isInvisibleSegment(segment))\n    .map((segment) => decodeRouteSegment(segment));\n  return segments.length === 0 ? \"/\" : `/${segments.join(\"/\")}`;\n}\n\n/**\n * Convert a layout tree path to a scoped route literal that preserves\n * route-group and `@slot` segments. Used only as a fallback key when multiple\n * layouts collapse to the same URL route literal, so consumers can keep their\n * slot/params typings distinct.\n */\nfunction treePathToScopedLayoutRouteLiteral(treePath: string): string {\n  if (treePath === \"/\") return \"/\";\n\n  const segments = treePath\n    .split(\"/\")\n    .filter(Boolean)\n    .filter((segment) => segment !== \".\")\n    .map((segment) => decodeRouteSegment(segment));\n  return segments.length === 0 ? \"/\" : `/${segments.join(\"/\")}`;\n}\n\nfunction addRoute(\n  routes: string[],\n  seen: Set<string>,\n  params: Map<string, ParamShape>,\n  route: string,\n  paramShape: ParamShape,\n): void {\n  if (!seen.has(route)) {\n    seen.add(route);\n    routes.push(route);\n  }\n  const existingParamShape = params.get(route);\n  if (existingParamShape) {\n    if (!paramShapesEqual(existingParamShape, paramShape)) {\n      throw new Error(`[vinext] Conflicting route param shapes generated for ${route}`);\n    }\n    return;\n  }\n  params.set(route, paramShape);\n}\n\nfunction paramShapesEqual(left: ParamShape, right: ParamShape): boolean {\n  if (left.size !== right.size) return false;\n  for (const [name, kind] of left) {\n    if (right.get(name) !== kind) return false;\n  }\n  return true;\n}\n\nfunction uniqueSorted(values: readonly string[]): string[] {\n  return Array.from(new Set(values)).sort(compareStrings);\n}\n\nfunction routeUnion(routes: readonly string[]): string {\n  if (routes.length === 0) return \"never\";\n  return routes.map(quote).join(\" | \");\n}\n\nfunction propertyName(name: string): string {\n  return /^[A-Za-z_$][\\w$]*$/.test(name) ? name : quote(name);\n}\n\nfunction quote(value: string): string {\n  return JSON.stringify(value);\n}\n\nfunction compareStrings(left: string, right: string): number {\n  if (left < right) return -1;\n  if (left > right) return 1;\n  return 0;\n}\n"],"mappings":"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"}

package/dist/utils/asset-prefix.d.ts

@@ -6,8 +6,9 @@
  * static asset URL emitted in the page. It is distinct from `basePath`, which
  * affects route URLs.
  *
- *  - A `assetPrefix` of `""` (empty) means "no prefix" — behaviour matches the
- *    historical default.
+ *  - A `assetPrefix` of `""` (empty) means "no prefix". URLs are emitted as
+ *    `/_next/static/...` (Next.js's canonical convention) and assets are
+ *    written to `dist/client/_next/static/...` so the on-disk layout matches.
  *  - A path prefix like `"/custom-asset-prefix"` is applied as a URL prefix
  *    relative to the deployment origin. The prod server must also serve assets
  *    under that prefix.
@@ -37,8 +38,14 @@ declare function isAbsoluteAssetPrefix(assetPrefix: string): boolean;
  *    server) serves them directly without a runtime rewrite.
  *  - Absolute URL (with or without path component): write to `_next/static/`.
  *    Runtime serving is best-effort — the CDN is expected to serve these.
- *  - Empty: keep the historical default of `assets/`, preserving disk layout
- *    for projects that haven't opted into `assetPrefix`.
+ *  - Empty: write to `_next/static/` so the on-disk layout matches the URL
+ *    Next.js itself emits (and that the Next.js client runtime + upstream
+ *    test suites assert against). This makes `assetPrefix` consistent in
+ *    both the configured and unconfigured cases — the URL contract is
+ *    always `/<prefix?>/_next/static/...`, and the on-disk layout mirrors
+ *    it 1:1 so the static-file layer can serve hits and return
+ *    `404 + "Not Found"` on misses without any URL-shape special-casing
+ *    upstream of it.
  */
 declare function resolveAssetsDir(assetPrefix: string): string;
 /**
@@ -64,6 +71,27 @@ declare function resolveAssetUrlPrefix(assetPrefix: string): string;
  * requests that arrive at the deployment origin under the configured prefix.
  */
 declare function assetPrefixPathname(assetPrefix: string): string;
+/**
+ * Whether the incoming request pathname targets the canonical `_next/static/`
+ * tree, after stripping any configured `basePath` and `assetPrefix` path
+ * component.
+ *
+ * Used by the Cloudflare worker entry to recognise asset-shaped requests
+ * that the ASSETS binding didn't serve, so they can short-circuit with a
+ * plain-text 404 instead of falling through to the RSC handler (which
+ * would render the full HTML 404 page). Mirrors Next.js's behaviour in
+ * `packages/next/src/server/lib/router-server.ts` where
+ * `realRequestPathname` is stripped of basePath/assetPrefix/i18n locale
+ * before the `startsWith('/_next/static/')` check.
+ *
+ *  - `pathname`: incoming request pathname (with leading slash, no query).
+ *  - `basePath`: configured `basePath` (e.g. `"/docs"`) or `""`.
+ *  - `assetPathPrefix`: path component of `assetPrefix` (e.g. `"/cdn"`) or
+ *    `""`. Use `assetPrefixPathname()` to derive this from a raw assetPrefix.
+ *
+ * @see https://github.com/vercel/next.js/blob/canary/packages/next/src/server/lib/router-server.ts
+ */
+declare function isNextStaticPath(pathname: string, basePath: string, assetPathPrefix: string): boolean;
 //#endregion
-export { ASSET_PREFIX_URL_DIR, assetPrefixPathname, isAbsoluteAssetPrefix, resolveAssetUrlPrefix, resolveAssetsDir };
+export { ASSET_PREFIX_URL_DIR, assetPrefixPathname, isAbsoluteAssetPrefix, isNextStaticPath, resolveAssetUrlPrefix, resolveAssetsDir };
 //# sourceMappingURL=asset-prefix.d.ts.map

package/dist/utils/asset-prefix.js

@@ -6,8 +6,9 @@
 * static asset URL emitted in the page. It is distinct from `basePath`, which
 * affects route URLs.
 *
-*  - A `assetPrefix` of `""` (empty) means "no prefix" — behaviour matches the
-*    historical default.
+*  - A `assetPrefix` of `""` (empty) means "no prefix". URLs are emitted as
+*    `/_next/static/...` (Next.js's canonical convention) and assets are
+*    written to `dist/client/_next/static/...` so the on-disk layout matches.
 *  - A path prefix like `"/custom-asset-prefix"` is applied as a URL prefix
 *    relative to the deployment origin. The prod server must also serve assets
 *    under that prefix.
@@ -39,11 +40,17 @@ function isAbsoluteAssetPrefix(assetPrefix) {
 *    server) serves them directly without a runtime rewrite.
 *  - Absolute URL (with or without path component): write to `_next/static/`.
 *    Runtime serving is best-effort — the CDN is expected to serve these.
-*  - Empty: keep the historical default of `assets/`, preserving disk layout
-*    for projects that haven't opted into `assetPrefix`.
+*  - Empty: write to `_next/static/` so the on-disk layout matches the URL
+*    Next.js itself emits (and that the Next.js client runtime + upstream
+*    test suites assert against). This makes `assetPrefix` consistent in
+*    both the configured and unconfigured cases — the URL contract is
+*    always `/<prefix?>/_next/static/...`, and the on-disk layout mirrors
+*    it 1:1 so the static-file layer can serve hits and return
+*    `404 + "Not Found"` on misses without any URL-shape special-casing
+*    upstream of it.
 */
 function resolveAssetsDir(assetPrefix) {
-	if (!assetPrefix) return "assets";
+	if (!assetPrefix) return ASSET_PREFIX_URL_DIR;
 	if (isAbsoluteAssetPrefix(assetPrefix)) return ASSET_PREFIX_URL_DIR;
 	let stripped = assetPrefix;
 	while (stripped.startsWith("/")) stripped = stripped.slice(1);
@@ -85,7 +92,33 @@ function assetPrefixPathname(assetPrefix) {
 		return "";
 	}
 }
+/**
+* Whether the incoming request pathname targets the canonical `_next/static/`
+* tree, after stripping any configured `basePath` and `assetPrefix` path
+* component.
+*
+* Used by the Cloudflare worker entry to recognise asset-shaped requests
+* that the ASSETS binding didn't serve, so they can short-circuit with a
+* plain-text 404 instead of falling through to the RSC handler (which
+* would render the full HTML 404 page). Mirrors Next.js's behaviour in
+* `packages/next/src/server/lib/router-server.ts` where
+* `realRequestPathname` is stripped of basePath/assetPrefix/i18n locale
+* before the `startsWith('/_next/static/')` check.
+*
+*  - `pathname`: incoming request pathname (with leading slash, no query).
+*  - `basePath`: configured `basePath` (e.g. `"/docs"`) or `""`.
+*  - `assetPathPrefix`: path component of `assetPrefix` (e.g. `"/cdn"`) or
+*    `""`. Use `assetPrefixPathname()` to derive this from a raw assetPrefix.
+*
+* @see https://github.com/vercel/next.js/blob/canary/packages/next/src/server/lib/router-server.ts
+*/
+function isNextStaticPath(pathname, basePath, assetPathPrefix) {
+	let p = pathname;
+	if (basePath && (p === basePath || p.startsWith(basePath + "/"))) p = p.slice(basePath.length) || "/";
+	if (assetPathPrefix && (p === assetPathPrefix || p.startsWith(assetPathPrefix + "/"))) p = p.slice(assetPathPrefix.length) || "/";
+	return p.startsWith(`/${ASSET_PREFIX_URL_DIR}/`);
+}
 //#endregion
-export { ASSET_PREFIX_URL_DIR, assetPrefixPathname, isAbsoluteAssetPrefix, resolveAssetUrlPrefix, resolveAssetsDir };
+export { ASSET_PREFIX_URL_DIR, assetPrefixPathname, isAbsoluteAssetPrefix, isNextStaticPath, resolveAssetUrlPrefix, resolveAssetsDir };
 
 //# sourceMappingURL=asset-prefix.js.map

package/dist/utils/asset-prefix.js.map

@@ -1 +1 @@
-{"version":3,"file":"asset-prefix.js","names":[],"sources":["../../src/utils/asset-prefix.ts"],"sourcesContent":["/**\n * Shared helpers for next.config `assetPrefix`.\n *\n * Mirrors Next.js semantics: `assetPrefix` is prepended to every JS/CSS/image/\n * static asset URL emitted in the page. It is distinct from `basePath`, which\n * affects route URLs.\n *\n *  - A `assetPrefix` of `\"\"` (empty) means \"no prefix\" — behaviour matches the\n *    historical default.\n *  - A path prefix like `\"/custom-asset-prefix\"` is applied as a URL prefix\n *    relative to the deployment origin. The prod server must also serve assets\n *    under that prefix.\n *  - An absolute URL like `\"https://cdn.example.com\"` makes asset URLs fully\n *    qualified. Runtime serving on the deployment origin is a no-op — the CDN\n *    serves the assets directly.\n *\n * The path component of the asset URL after the prefix is always\n * `/_next/static/<filename>` to match Next.js's convention. This is the\n * convention upstream test suites assert against.\n *\n * @see https://nextjs.org/docs/app/api-reference/config/next-config-js/assetPrefix\n */\n\n/**\n * Suffix appended to the assetPrefix (or used standalone when no prefix is\n * configured) to form the leading portion of every emitted asset URL.\n * Matches Next.js: assets always live under `/_next/static/`.\n */\nexport const ASSET_PREFIX_URL_DIR = \"_next/static\";\n\n/** Whether `assetPrefix` is an absolute URL (vs a path prefix). */\nexport function isAbsoluteAssetPrefix(assetPrefix: string): boolean {\n  return /^https?:\\/\\//i.test(assetPrefix);\n}\n\n/**\n * Compute the on-disk `build.assetsDir` for the given `assetPrefix`.\n *\n *  - Path prefix (`/cdn`): write to `cdn/_next/static/` so the on-disk layout\n *    matches the URL — the Cloudflare ASSETS binding (and any static file\n *    server) serves them directly without a runtime rewrite.\n *  - Absolute URL (with or without path component): write to `_next/static/`.\n *    Runtime serving is best-effort — the CDN is expected to serve these.\n *  - Empty: keep the historical default of `assets/`, preserving disk layout\n *    for projects that haven't opted into `assetPrefix`.\n */\nexport function resolveAssetsDir(assetPrefix: string): string {\n  if (!assetPrefix) return \"assets\";\n  if (isAbsoluteAssetPrefix(assetPrefix)) {\n    // Files on disk land at `_next/static/...`. The absolute URL is applied\n    // at URL-rendering time via renderBuiltUrl; on-disk path is irrelevant\n    // to the CDN.\n    return ASSET_PREFIX_URL_DIR;\n  }\n  // Path prefix — strip leading slash so the path joins cleanly with outDir.\n  // Use an explicit loop instead of `replace(/^\\/+/, \"\")` so CodeQL doesn't\n  // flag the regex as polynomial-time on uncontrolled input.\n  let stripped = assetPrefix;\n  while (stripped.startsWith(\"/\")) stripped = stripped.slice(1);\n  return `${stripped}/${ASSET_PREFIX_URL_DIR}`;\n}\n\n/**\n * Build the URL prefix to apply to emitted asset URLs. Returns the full URL\n * prefix including the `_next/static/` directory, with a trailing slash.\n *\n * Examples:\n *  - `\"\"` → `\"/_next/static/\"`\n *  - `\"/cdn\"` → `\"/cdn/_next/static/\"`\n *  - `\"https://cdn.example.com\"` → `\"https://cdn.example.com/_next/static/\"`\n *  - `\"https://cdn.example.com/sub\"` → `\"https://cdn.example.com/sub/_next/static/\"`\n */\nexport function resolveAssetUrlPrefix(assetPrefix: string): string {\n  if (!assetPrefix) return `/${ASSET_PREFIX_URL_DIR}/`;\n  return `${assetPrefix}/${ASSET_PREFIX_URL_DIR}/`;\n}\n\n/**\n * Extract the path portion of `assetPrefix` for use in runtime URL matching.\n *\n *  - For a path prefix: returns it verbatim (e.g. `/custom-asset-prefix`).\n *  - For an absolute URL: returns its pathname stripped of trailing slashes\n *    (e.g. `\"https://cdn.example.com/sub\"` → `/sub`, plain origin → `\"\"`).\n *  - For empty input: returns `\"\"`.\n *\n * Used by the prod server and Cloudflare worker entry to recognise asset\n * requests that arrive at the deployment origin under the configured prefix.\n */\nexport function assetPrefixPathname(assetPrefix: string): string {\n  if (!assetPrefix) return \"\";\n  if (!isAbsoluteAssetPrefix(assetPrefix)) return assetPrefix;\n  try {\n    let pathname = new URL(assetPrefix).pathname;\n    while (pathname.endsWith(\"/\")) pathname = pathname.slice(0, -1);\n    return pathname === \"\" ? \"\" : pathname;\n  } catch {\n    return \"\";\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4BA,MAAa,uBAAuB;;AAGpC,SAAgB,sBAAsB,aAA8B;CAClE,OAAO,gBAAgB,KAAK,YAAY;;;;;;;;;;;;;AAc1C,SAAgB,iBAAiB,aAA6B;CAC5D,IAAI,CAAC,aAAa,OAAO;CACzB,IAAI,sBAAsB,YAAY,EAIpC,OAAO;CAKT,IAAI,WAAW;CACf,OAAO,SAAS,WAAW,IAAI,EAAE,WAAW,SAAS,MAAM,EAAE;CAC7D,OAAO,GAAG,SAAS,GAAG;;;;;;;;;;;;AAaxB,SAAgB,sBAAsB,aAA6B;CACjE,IAAI,CAAC,aAAa,OAAO,IAAI,qBAAqB;CAClD,OAAO,GAAG,YAAY,GAAG,qBAAqB;;;;;;;;;;;;;AAchD,SAAgB,oBAAoB,aAA6B;CAC/D,IAAI,CAAC,aAAa,OAAO;CACzB,IAAI,CAAC,sBAAsB,YAAY,EAAE,OAAO;CAChD,IAAI;EACF,IAAI,WAAW,IAAI,IAAI,YAAY,CAAC;EACpC,OAAO,SAAS,SAAS,IAAI,EAAE,WAAW,SAAS,MAAM,GAAG,GAAG;EAC/D,OAAO,aAAa,KAAK,KAAK;SACxB;EACN,OAAO"}
+{"version":3,"file":"asset-prefix.js","names":[],"sources":["../../src/utils/asset-prefix.ts"],"sourcesContent":["/**\n * Shared helpers for next.config `assetPrefix`.\n *\n * Mirrors Next.js semantics: `assetPrefix` is prepended to every JS/CSS/image/\n * static asset URL emitted in the page. It is distinct from `basePath`, which\n * affects route URLs.\n *\n *  - A `assetPrefix` of `\"\"` (empty) means \"no prefix\". URLs are emitted as\n *    `/_next/static/...` (Next.js's canonical convention) and assets are\n *    written to `dist/client/_next/static/...` so the on-disk layout matches.\n *  - A path prefix like `\"/custom-asset-prefix\"` is applied as a URL prefix\n *    relative to the deployment origin. The prod server must also serve assets\n *    under that prefix.\n *  - An absolute URL like `\"https://cdn.example.com\"` makes asset URLs fully\n *    qualified. Runtime serving on the deployment origin is a no-op — the CDN\n *    serves the assets directly.\n *\n * The path component of the asset URL after the prefix is always\n * `/_next/static/<filename>` to match Next.js's convention. This is the\n * convention upstream test suites assert against.\n *\n * @see https://nextjs.org/docs/app/api-reference/config/next-config-js/assetPrefix\n */\n\n/**\n * Suffix appended to the assetPrefix (or used standalone when no prefix is\n * configured) to form the leading portion of every emitted asset URL.\n * Matches Next.js: assets always live under `/_next/static/`.\n */\nexport const ASSET_PREFIX_URL_DIR = \"_next/static\";\n\n/** Whether `assetPrefix` is an absolute URL (vs a path prefix). */\nexport function isAbsoluteAssetPrefix(assetPrefix: string): boolean {\n  return /^https?:\\/\\//i.test(assetPrefix);\n}\n\n/**\n * Compute the on-disk `build.assetsDir` for the given `assetPrefix`.\n *\n *  - Path prefix (`/cdn`): write to `cdn/_next/static/` so the on-disk layout\n *    matches the URL — the Cloudflare ASSETS binding (and any static file\n *    server) serves them directly without a runtime rewrite.\n *  - Absolute URL (with or without path component): write to `_next/static/`.\n *    Runtime serving is best-effort — the CDN is expected to serve these.\n *  - Empty: write to `_next/static/` so the on-disk layout matches the URL\n *    Next.js itself emits (and that the Next.js client runtime + upstream\n *    test suites assert against). This makes `assetPrefix` consistent in\n *    both the configured and unconfigured cases — the URL contract is\n *    always `/<prefix?>/_next/static/...`, and the on-disk layout mirrors\n *    it 1:1 so the static-file layer can serve hits and return\n *    `404 + \"Not Found\"` on misses without any URL-shape special-casing\n *    upstream of it.\n */\nexport function resolveAssetsDir(assetPrefix: string): string {\n  if (!assetPrefix) return ASSET_PREFIX_URL_DIR;\n  if (isAbsoluteAssetPrefix(assetPrefix)) {\n    // Files on disk land at `_next/static/...`. The absolute URL is applied\n    // at URL-rendering time via renderBuiltUrl; on-disk path is irrelevant\n    // to the CDN.\n    return ASSET_PREFIX_URL_DIR;\n  }\n  // Path prefix — strip leading slash so the path joins cleanly with outDir.\n  // Use an explicit loop instead of `replace(/^\\/+/, \"\")` so CodeQL doesn't\n  // flag the regex as polynomial-time on uncontrolled input.\n  let stripped = assetPrefix;\n  while (stripped.startsWith(\"/\")) stripped = stripped.slice(1);\n  return `${stripped}/${ASSET_PREFIX_URL_DIR}`;\n}\n\n/**\n * Build the URL prefix to apply to emitted asset URLs. Returns the full URL\n * prefix including the `_next/static/` directory, with a trailing slash.\n *\n * Examples:\n *  - `\"\"` → `\"/_next/static/\"`\n *  - `\"/cdn\"` → `\"/cdn/_next/static/\"`\n *  - `\"https://cdn.example.com\"` → `\"https://cdn.example.com/_next/static/\"`\n *  - `\"https://cdn.example.com/sub\"` → `\"https://cdn.example.com/sub/_next/static/\"`\n */\nexport function resolveAssetUrlPrefix(assetPrefix: string): string {\n  if (!assetPrefix) return `/${ASSET_PREFIX_URL_DIR}/`;\n  return `${assetPrefix}/${ASSET_PREFIX_URL_DIR}/`;\n}\n\n/**\n * Extract the path portion of `assetPrefix` for use in runtime URL matching.\n *\n *  - For a path prefix: returns it verbatim (e.g. `/custom-asset-prefix`).\n *  - For an absolute URL: returns its pathname stripped of trailing slashes\n *    (e.g. `\"https://cdn.example.com/sub\"` → `/sub`, plain origin → `\"\"`).\n *  - For empty input: returns `\"\"`.\n *\n * Used by the prod server and Cloudflare worker entry to recognise asset\n * requests that arrive at the deployment origin under the configured prefix.\n */\nexport function assetPrefixPathname(assetPrefix: string): string {\n  if (!assetPrefix) return \"\";\n  if (!isAbsoluteAssetPrefix(assetPrefix)) return assetPrefix;\n  try {\n    let pathname = new URL(assetPrefix).pathname;\n    while (pathname.endsWith(\"/\")) pathname = pathname.slice(0, -1);\n    return pathname === \"\" ? \"\" : pathname;\n  } catch {\n    return \"\";\n  }\n}\n\n/**\n * Whether the incoming request pathname targets the canonical `_next/static/`\n * tree, after stripping any configured `basePath` and `assetPrefix` path\n * component.\n *\n * Used by the Cloudflare worker entry to recognise asset-shaped requests\n * that the ASSETS binding didn't serve, so they can short-circuit with a\n * plain-text 404 instead of falling through to the RSC handler (which\n * would render the full HTML 404 page). Mirrors Next.js's behaviour in\n * `packages/next/src/server/lib/router-server.ts` where\n * `realRequestPathname` is stripped of basePath/assetPrefix/i18n locale\n * before the `startsWith('/_next/static/')` check.\n *\n *  - `pathname`: incoming request pathname (with leading slash, no query).\n *  - `basePath`: configured `basePath` (e.g. `\"/docs\"`) or `\"\"`.\n *  - `assetPathPrefix`: path component of `assetPrefix` (e.g. `\"/cdn\"`) or\n *    `\"\"`. Use `assetPrefixPathname()` to derive this from a raw assetPrefix.\n *\n * @see https://github.com/vercel/next.js/blob/canary/packages/next/src/server/lib/router-server.ts\n */\nexport function isNextStaticPath(\n  pathname: string,\n  basePath: string,\n  assetPathPrefix: string,\n): boolean {\n  let p = pathname;\n  if (basePath && (p === basePath || p.startsWith(basePath + \"/\"))) {\n    p = p.slice(basePath.length) || \"/\";\n  }\n  if (assetPathPrefix && (p === assetPathPrefix || p.startsWith(assetPathPrefix + \"/\"))) {\n    p = p.slice(assetPathPrefix.length) || \"/\";\n  }\n  return p.startsWith(`/${ASSET_PREFIX_URL_DIR}/`);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6BA,MAAa,uBAAuB;;AAGpC,SAAgB,sBAAsB,aAA8B;CAClE,OAAO,gBAAgB,KAAK,YAAY;;;;;;;;;;;;;;;;;;;AAoB1C,SAAgB,iBAAiB,aAA6B;CAC5D,IAAI,CAAC,aAAa,OAAO;CACzB,IAAI,sBAAsB,YAAY,EAIpC,OAAO;CAKT,IAAI,WAAW;CACf,OAAO,SAAS,WAAW,IAAI,EAAE,WAAW,SAAS,MAAM,EAAE;CAC7D,OAAO,GAAG,SAAS,GAAG;;;;;;;;;;;;AAaxB,SAAgB,sBAAsB,aAA6B;CACjE,IAAI,CAAC,aAAa,OAAO,IAAI,qBAAqB;CAClD,OAAO,GAAG,YAAY,GAAG,qBAAqB;;;;;;;;;;;;;AAchD,SAAgB,oBAAoB,aAA6B;CAC/D,IAAI,CAAC,aAAa,OAAO;CACzB,IAAI,CAAC,sBAAsB,YAAY,EAAE,OAAO;CAChD,IAAI;EACF,IAAI,WAAW,IAAI,IAAI,YAAY,CAAC;EACpC,OAAO,SAAS,SAAS,IAAI,EAAE,WAAW,SAAS,MAAM,GAAG,GAAG;EAC/D,OAAO,aAAa,KAAK,KAAK;SACxB;EACN,OAAO;;;;;;;;;;;;;;;;;;;;;;;AAwBX,SAAgB,iBACd,UACA,UACA,iBACS;CACT,IAAI,IAAI;CACR,IAAI,aAAa,MAAM,YAAY,EAAE,WAAW,WAAW,IAAI,GAC7D,IAAI,EAAE,MAAM,SAAS,OAAO,IAAI;CAElC,IAAI,oBAAoB,MAAM,mBAAmB,EAAE,WAAW,kBAAkB,IAAI,GAClF,IAAI,EAAE,MAAM,gBAAgB,OAAO,IAAI;CAEzC,OAAO,EAAE,WAAW,IAAI,qBAAqB,GAAG"}

package/dist/utils/cache-control-metadata.d.ts

@@ -1,5 +1,6 @@
+import { isUnknownRecord } from "./record.js";
+
 //#region src/utils/cache-control-metadata.d.ts
-declare function isUnknownRecord(value: unknown): value is Record<string, unknown>;
 declare function readCacheControlNumberField(ctx: Record<string, unknown> | undefined, field: string): number | undefined;
 //#endregion
 export { isUnknownRecord, readCacheControlNumberField };

package/dist/utils/cache-control-metadata.js

@@ -1,7 +1,5 @@
+import { isUnknownRecord } from "./record.js";
 //#region src/utils/cache-control-metadata.ts
-function isUnknownRecord(value) {
-	return value !== null && typeof value === "object" && !Array.isArray(value);
-}
 function readRecordField(ctx, field) {
 	const value = ctx?.[field];
 	return isUnknownRecord(value) ? value : void 0;

package/dist/utils/cache-control-metadata.js.map

@@ -1 +1 @@
-{"version":3,"file":"cache-control-metadata.js","names":[],"sources":["../../src/utils/cache-control-metadata.ts"],"sourcesContent":["export function isUnknownRecord(value: unknown): value is Record<string, unknown> {\n  return value !== null && typeof value === \"object\" && !Array.isArray(value);\n}\n\nfunction readRecordField(\n  ctx: Record<string, unknown> | undefined,\n  field: string,\n): Record<string, unknown> | undefined {\n  const value = ctx?.[field];\n  return isUnknownRecord(value) ? value : undefined;\n}\n\nexport function readCacheControlNumberField(\n  ctx: Record<string, unknown> | undefined,\n  field: string,\n): number | undefined {\n  const cacheControl = readRecordField(ctx, \"cacheControl\");\n  const value = cacheControl?.[field] ?? ctx?.[field];\n  return typeof value === \"number\" ? value : undefined;\n}\n"],"mappings":";AAAA,SAAgB,gBAAgB,OAAkD;CAChF,OAAO,UAAU,QAAQ,OAAO,UAAU,YAAY,CAAC,MAAM,QAAQ,MAAM;;AAG7E,SAAS,gBACP,KACA,OACqC;CACrC,MAAM,QAAQ,MAAM;CACpB,OAAO,gBAAgB,MAAM,GAAG,QAAQ,KAAA;;AAG1C,SAAgB,4BACd,KACA,OACoB;CAEpB,MAAM,QADe,gBAAgB,KAAK,eAChB,GAAG,UAAU,MAAM;CAC7C,OAAO,OAAO,UAAU,WAAW,QAAQ,KAAA"}
+{"version":3,"file":"cache-control-metadata.js","names":[],"sources":["../../src/utils/cache-control-metadata.ts"],"sourcesContent":["import { isUnknownRecord } from \"./record.js\";\nexport { isUnknownRecord } from \"./record.js\";\n\nfunction readRecordField(\n  ctx: Record<string, unknown> | undefined,\n  field: string,\n): Record<string, unknown> | undefined {\n  const value = ctx?.[field];\n  return isUnknownRecord(value) ? value : undefined;\n}\n\nexport function readCacheControlNumberField(\n  ctx: Record<string, unknown> | undefined,\n  field: string,\n): number | undefined {\n  const cacheControl = readRecordField(ctx, \"cacheControl\");\n  const value = cacheControl?.[field] ?? ctx?.[field];\n  return typeof value === \"number\" ? value : undefined;\n}\n"],"mappings":";;AAGA,SAAS,gBACP,KACA,OACqC;CACrC,MAAM,QAAQ,MAAM;CACpB,OAAO,gBAAgB,MAAM,GAAG,QAAQ,KAAA;;AAG1C,SAAgB,4BACd,KACA,OACoB;CAEpB,MAAM,QADe,gBAAgB,KAAK,eAChB,GAAG,UAAU,MAAM;CAC7C,OAAO,OAAO,UAAU,WAAW,QAAQ,KAAA"}

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

@@ -12,6 +12,7 @@ declare function normalizeDomainHostname(hostname: string | null | undefined): s
  */
 declare function detectDomainLocale(domainItems?: readonly DomainLocale[], hostname?: string, detectedLocale?: string): DomainLocale | undefined;
 declare function addLocalePrefix(path: string, locale: string, localeDefault: string): string;
+declare function getLocalePathPrefix(path: string, locales: readonly string[] | undefined): string | undefined;
 declare function getDomainLocaleUrl(url: string, locale: string, {
   basePath,
   currentHostname,
@@ -22,5 +23,5 @@ declare function getDomainLocaleUrl(url: string, locale: string, {
   domainItems?: readonly DomainLocale[];
 }): string | undefined;
 //#endregion
-export { DomainLocale, addLocalePrefix, detectDomainLocale, getDomainLocaleUrl, normalizeDomainHostname };
+export { DomainLocale, addLocalePrefix, detectDomainLocale, getDomainLocaleUrl, getLocalePathPrefix, normalizeDomainHostname };
 //# sourceMappingURL=domain-locale.d.ts.map

package/dist/utils/domain-locale.js

@@ -25,6 +25,14 @@ function addLocalePrefix(path, locale, localeDefault) {
 	if (normalizedPathname === localePrefix || normalizedPathname.startsWith(`${localePrefix}/`)) return path.startsWith("/") ? path : pathWithLeadingSlash;
 	return `/${locale}${pathWithLeadingSlash}`;
 }
+function getLocalePathPrefix(path, locales) {
+	if (!locales?.length) return void 0;
+	const pathWithLeadingSlash = path.startsWith("/") ? path : `/${path}`;
+	const firstSegment = (pathWithLeadingSlash.split(/[?#]/, 1)[0] ?? pathWithLeadingSlash).split("/").find(Boolean);
+	if (!firstSegment) return void 0;
+	const normalizedSegment = firstSegment.toLowerCase();
+	return locales.find((locale) => locale.toLowerCase() === normalizedSegment);
+}
 function withBasePath(path, basePath = "") {
 	if (!basePath) return path;
 	return basePath + path;
@@ -39,6 +47,6 @@ function getDomainLocaleUrl(url, locale, { basePath, currentHostname, domainItem
 	return `${`http${targetDomain.http ? "" : "s"}://`}${targetDomain.domain}${withBasePath(localizedPath, basePath)}`;
 }
 //#endregion
-export { addLocalePrefix, detectDomainLocale, getDomainLocaleUrl, normalizeDomainHostname };
+export { addLocalePrefix, detectDomainLocale, getDomainLocaleUrl, getLocalePathPrefix, normalizeDomainHostname };
 
 //# sourceMappingURL=domain-locale.js.map

package/dist/utils/domain-locale.js.map

@@ -1 +1 @@
-{"version":3,"file":"domain-locale.js","names":[],"sources":["../../src/utils/domain-locale.ts"],"sourcesContent":["import type { NextI18nConfig } from \"../config/next-config.js\";\n\nexport type DomainLocale = NonNullable<NextI18nConfig[\"domains\"]>[number];\n\nexport function normalizeDomainHostname(hostname: string | null | undefined): string | undefined {\n  if (!hostname) return undefined;\n  return hostname.split(\",\", 1)[0]?.trim().split(\":\", 1)[0]?.toLowerCase() || undefined;\n}\n\n/**\n * Match a configured domain either by hostname or locale.\n * When both are provided, the checks intentionally use OR semantics so the\n * same helper can cover Next.js's hostname lookup and preferred-locale lookup.\n * If both are passed, the first domain matching either input wins, so callers\n * should pass hostname or detectedLocale, not both.\n */\nexport function detectDomainLocale(\n  domainItems?: readonly DomainLocale[],\n  hostname?: string,\n  detectedLocale?: string,\n): DomainLocale | undefined {\n  if (!domainItems?.length) return undefined;\n\n  const normalizedHostname = normalizeDomainHostname(hostname);\n  const normalizedLocale = detectedLocale?.toLowerCase();\n\n  for (const item of domainItems) {\n    const domainHostname = normalizeDomainHostname(item.domain);\n    if (\n      normalizedHostname === domainHostname ||\n      normalizedLocale === item.defaultLocale.toLowerCase() ||\n      item.locales?.some((locale) => locale.toLowerCase() === normalizedLocale)\n    ) {\n      return item;\n    }\n  }\n\n  return undefined;\n}\n\nexport function addLocalePrefix(path: string, locale: string, localeDefault: string): string {\n  const normalizedLocale = locale.toLowerCase();\n  if (normalizedLocale === localeDefault.toLowerCase()) return path;\n\n  const pathWithLeadingSlash = path.startsWith(\"/\") ? path : `/${path}`;\n  const pathname = pathWithLeadingSlash.split(/[?#]/, 1)[0] ?? pathWithLeadingSlash;\n  const normalizedPathname = pathname.toLowerCase();\n  const localePrefix = `/${normalizedLocale}`;\n\n  if (normalizedPathname === localePrefix || normalizedPathname.startsWith(`${localePrefix}/`)) {\n    return path.startsWith(\"/\") ? path : pathWithLeadingSlash;\n  }\n\n  return `/${locale}${pathWithLeadingSlash}`;\n}\n\nfunction withBasePath(path: string, basePath = \"\"): string {\n  if (!basePath) return path;\n  return basePath + path;\n}\n\nexport function getDomainLocaleUrl(\n  url: string,\n  locale: string,\n  {\n    basePath,\n    currentHostname,\n    domainItems,\n  }: {\n    basePath?: string;\n    currentHostname?: string | null;\n    domainItems?: readonly DomainLocale[];\n  },\n): string | undefined {\n  if (!domainItems?.length) return undefined;\n\n  const targetDomain = detectDomainLocale(domainItems, undefined, locale);\n  if (!targetDomain) return undefined;\n\n  const currentDomain = detectDomainLocale(domainItems, currentHostname ?? undefined);\n  const localizedPath = addLocalePrefix(url, locale, targetDomain.defaultLocale);\n\n  if (\n    currentDomain &&\n    normalizeDomainHostname(currentDomain.domain) === normalizeDomainHostname(targetDomain.domain)\n  ) {\n    // Same-domain switches fall back to the caller's standard locale-prefix\n    // logic. This relies on __VINEXT_DEFAULT_LOCALE__ matching the current\n    // domain's defaultLocale, which the server entry keeps in sync.\n    return undefined;\n  }\n\n  const scheme = `http${targetDomain.http ? \"\" : \"s\"}://`;\n  return `${scheme}${targetDomain.domain}${withBasePath(localizedPath, basePath)}`;\n}\n"],"mappings":";AAIA,SAAgB,wBAAwB,UAAyD;CAC/F,IAAI,CAAC,UAAU,OAAO,KAAA;CACtB,OAAO,SAAS,MAAM,KAAK,EAAE,CAAC,IAAI,MAAM,CAAC,MAAM,KAAK,EAAE,CAAC,IAAI,aAAa,IAAI,KAAA;;;;;;;;;AAU9E,SAAgB,mBACd,aACA,UACA,gBAC0B;CAC1B,IAAI,CAAC,aAAa,QAAQ,OAAO,KAAA;CAEjC,MAAM,qBAAqB,wBAAwB,SAAS;CAC5D,MAAM,mBAAmB,gBAAgB,aAAa;CAEtD,KAAK,MAAM,QAAQ,aAEjB,IACE,uBAFqB,wBAAwB,KAAK,OAEb,IACrC,qBAAqB,KAAK,cAAc,aAAa,IACrD,KAAK,SAAS,MAAM,WAAW,OAAO,aAAa,KAAK,iBAAiB,EAEzE,OAAO;;AAOb,SAAgB,gBAAgB,MAAc,QAAgB,eAA+B;CAC3F,MAAM,mBAAmB,OAAO,aAAa;CAC7C,IAAI,qBAAqB,cAAc,aAAa,EAAE,OAAO;CAE7D,MAAM,uBAAuB,KAAK,WAAW,IAAI,GAAG,OAAO,IAAI;CAE/D,MAAM,sBADW,qBAAqB,MAAM,QAAQ,EAAE,CAAC,MAAM,sBACzB,aAAa;CACjD,MAAM,eAAe,IAAI;CAEzB,IAAI,uBAAuB,gBAAgB,mBAAmB,WAAW,GAAG,aAAa,GAAG,EAC1F,OAAO,KAAK,WAAW,IAAI,GAAG,OAAO;CAGvC,OAAO,IAAI,SAAS;;AAGtB,SAAS,aAAa,MAAc,WAAW,IAAY;CACzD,IAAI,CAAC,UAAU,OAAO;CACtB,OAAO,WAAW;;AAGpB,SAAgB,mBACd,KACA,QACA,EACE,UACA,iBACA,eAMkB;CACpB,IAAI,CAAC,aAAa,QAAQ,OAAO,KAAA;CAEjC,MAAM,eAAe,mBAAmB,aAAa,KAAA,GAAW,OAAO;CACvE,IAAI,CAAC,cAAc,OAAO,KAAA;CAE1B,MAAM,gBAAgB,mBAAmB,aAAa,mBAAmB,KAAA,EAAU;CACnF,MAAM,gBAAgB,gBAAgB,KAAK,QAAQ,aAAa,cAAc;CAE9E,IACE,iBACA,wBAAwB,cAAc,OAAO,KAAK,wBAAwB,aAAa,OAAO,EAK9F;CAIF,OAAO,GAAG,OADY,aAAa,OAAO,KAAK,IAAI,OAChC,aAAa,SAAS,aAAa,eAAe,SAAS"}
+{"version":3,"file":"domain-locale.js","names":[],"sources":["../../src/utils/domain-locale.ts"],"sourcesContent":["import type { NextI18nConfig } from \"../config/next-config.js\";\n\nexport type DomainLocale = NonNullable<NextI18nConfig[\"domains\"]>[number];\n\nexport function normalizeDomainHostname(hostname: string | null | undefined): string | undefined {\n  if (!hostname) return undefined;\n  return hostname.split(\",\", 1)[0]?.trim().split(\":\", 1)[0]?.toLowerCase() || undefined;\n}\n\n/**\n * Match a configured domain either by hostname or locale.\n * When both are provided, the checks intentionally use OR semantics so the\n * same helper can cover Next.js's hostname lookup and preferred-locale lookup.\n * If both are passed, the first domain matching either input wins, so callers\n * should pass hostname or detectedLocale, not both.\n */\nexport function detectDomainLocale(\n  domainItems?: readonly DomainLocale[],\n  hostname?: string,\n  detectedLocale?: string,\n): DomainLocale | undefined {\n  if (!domainItems?.length) return undefined;\n\n  const normalizedHostname = normalizeDomainHostname(hostname);\n  const normalizedLocale = detectedLocale?.toLowerCase();\n\n  for (const item of domainItems) {\n    const domainHostname = normalizeDomainHostname(item.domain);\n    if (\n      normalizedHostname === domainHostname ||\n      normalizedLocale === item.defaultLocale.toLowerCase() ||\n      item.locales?.some((locale) => locale.toLowerCase() === normalizedLocale)\n    ) {\n      return item;\n    }\n  }\n\n  return undefined;\n}\n\nexport function addLocalePrefix(path: string, locale: string, localeDefault: string): string {\n  const normalizedLocale = locale.toLowerCase();\n  if (normalizedLocale === localeDefault.toLowerCase()) return path;\n\n  const pathWithLeadingSlash = path.startsWith(\"/\") ? path : `/${path}`;\n  const pathname = pathWithLeadingSlash.split(/[?#]/, 1)[0] ?? pathWithLeadingSlash;\n  const normalizedPathname = pathname.toLowerCase();\n  const localePrefix = `/${normalizedLocale}`;\n\n  if (normalizedPathname === localePrefix || normalizedPathname.startsWith(`${localePrefix}/`)) {\n    return path.startsWith(\"/\") ? path : pathWithLeadingSlash;\n  }\n\n  return `/${locale}${pathWithLeadingSlash}`;\n}\n\nexport function getLocalePathPrefix(\n  path: string,\n  locales: readonly string[] | undefined,\n): string | undefined {\n  if (!locales?.length) return undefined;\n\n  const pathWithLeadingSlash = path.startsWith(\"/\") ? path : `/${path}`;\n  const pathname = pathWithLeadingSlash.split(/[?#]/, 1)[0] ?? pathWithLeadingSlash;\n  const firstSegment = pathname.split(\"/\").find(Boolean);\n  if (!firstSegment) return undefined;\n\n  const normalizedSegment = firstSegment.toLowerCase();\n  return locales.find((locale) => locale.toLowerCase() === normalizedSegment);\n}\n\nfunction withBasePath(path: string, basePath = \"\"): string {\n  if (!basePath) return path;\n  return basePath + path;\n}\n\nexport function getDomainLocaleUrl(\n  url: string,\n  locale: string,\n  {\n    basePath,\n    currentHostname,\n    domainItems,\n  }: {\n    basePath?: string;\n    currentHostname?: string | null;\n    domainItems?: readonly DomainLocale[];\n  },\n): string | undefined {\n  if (!domainItems?.length) return undefined;\n\n  const targetDomain = detectDomainLocale(domainItems, undefined, locale);\n  if (!targetDomain) return undefined;\n\n  const currentDomain = detectDomainLocale(domainItems, currentHostname ?? undefined);\n  const localizedPath = addLocalePrefix(url, locale, targetDomain.defaultLocale);\n\n  if (\n    currentDomain &&\n    normalizeDomainHostname(currentDomain.domain) === normalizeDomainHostname(targetDomain.domain)\n  ) {\n    // Same-domain switches fall back to the caller's standard locale-prefix\n    // logic. This relies on __VINEXT_DEFAULT_LOCALE__ matching the current\n    // domain's defaultLocale, which the server entry keeps in sync.\n    return undefined;\n  }\n\n  const scheme = `http${targetDomain.http ? \"\" : \"s\"}://`;\n  return `${scheme}${targetDomain.domain}${withBasePath(localizedPath, basePath)}`;\n}\n"],"mappings":";AAIA,SAAgB,wBAAwB,UAAyD;CAC/F,IAAI,CAAC,UAAU,OAAO,KAAA;CACtB,OAAO,SAAS,MAAM,KAAK,EAAE,CAAC,IAAI,MAAM,CAAC,MAAM,KAAK,EAAE,CAAC,IAAI,aAAa,IAAI,KAAA;;;;;;;;;AAU9E,SAAgB,mBACd,aACA,UACA,gBAC0B;CAC1B,IAAI,CAAC,aAAa,QAAQ,OAAO,KAAA;CAEjC,MAAM,qBAAqB,wBAAwB,SAAS;CAC5D,MAAM,mBAAmB,gBAAgB,aAAa;CAEtD,KAAK,MAAM,QAAQ,aAEjB,IACE,uBAFqB,wBAAwB,KAAK,OAEb,IACrC,qBAAqB,KAAK,cAAc,aAAa,IACrD,KAAK,SAAS,MAAM,WAAW,OAAO,aAAa,KAAK,iBAAiB,EAEzE,OAAO;;AAOb,SAAgB,gBAAgB,MAAc,QAAgB,eAA+B;CAC3F,MAAM,mBAAmB,OAAO,aAAa;CAC7C,IAAI,qBAAqB,cAAc,aAAa,EAAE,OAAO;CAE7D,MAAM,uBAAuB,KAAK,WAAW,IAAI,GAAG,OAAO,IAAI;CAE/D,MAAM,sBADW,qBAAqB,MAAM,QAAQ,EAAE,CAAC,MAAM,sBACzB,aAAa;CACjD,MAAM,eAAe,IAAI;CAEzB,IAAI,uBAAuB,gBAAgB,mBAAmB,WAAW,GAAG,aAAa,GAAG,EAC1F,OAAO,KAAK,WAAW,IAAI,GAAG,OAAO;CAGvC,OAAO,IAAI,SAAS;;AAGtB,SAAgB,oBACd,MACA,SACoB;CACpB,IAAI,CAAC,SAAS,QAAQ,OAAO,KAAA;CAE7B,MAAM,uBAAuB,KAAK,WAAW,IAAI,GAAG,OAAO,IAAI;CAE/D,MAAM,gBADW,qBAAqB,MAAM,QAAQ,EAAE,CAAC,MAAM,sBAC/B,MAAM,IAAI,CAAC,KAAK,QAAQ;CACtD,IAAI,CAAC,cAAc,OAAO,KAAA;CAE1B,MAAM,oBAAoB,aAAa,aAAa;CACpD,OAAO,QAAQ,MAAM,WAAW,OAAO,aAAa,KAAK,kBAAkB;;AAG7E,SAAS,aAAa,MAAc,WAAW,IAAY;CACzD,IAAI,CAAC,UAAU,OAAO;CACtB,OAAO,WAAW;;AAGpB,SAAgB,mBACd,KACA,QACA,EACE,UACA,iBACA,eAMkB;CACpB,IAAI,CAAC,aAAa,QAAQ,OAAO,KAAA;CAEjC,MAAM,eAAe,mBAAmB,aAAa,KAAA,GAAW,OAAO;CACvE,IAAI,CAAC,cAAc,OAAO,KAAA;CAE1B,MAAM,gBAAgB,mBAAmB,aAAa,mBAAmB,KAAA,EAAU;CACnF,MAAM,gBAAgB,gBAAgB,KAAK,QAAQ,aAAa,cAAc;CAE9E,IACE,iBACA,wBAAwB,cAAc,OAAO,KAAK,wBAAwB,aAAa,OAAO,EAK9F;CAIF,OAAO,GAAG,OADY,aAAa,OAAO,KAAK,IAAI,OAChC,aAAa,SAAS,aAAa,eAAe,SAAS"}

package/dist/utils/html-limited-bots.d.ts

@@ -0,0 +1,5 @@
+//#region src/utils/html-limited-bots.d.ts
+declare function getHtmlLimitedBotRegex(htmlLimitedBots: string | undefined): RegExp;
+//#endregion
+export { getHtmlLimitedBotRegex };
+//# sourceMappingURL=html-limited-bots.d.ts.map

package/dist/utils/html-limited-bots.js

@@ -0,0 +1,15 @@
+//#region src/utils/html-limited-bots.ts
+const HTML_LIMITED_BOT_UA_RE_STRING = String.raw`[\w-]+-Google|Google-[\w-]+|Chrome-Lighthouse|Slurp|DuckDuckBot|baiduspider|yandex|sogou|bitlybot|tumblr|vkShare|quora link preview|redditbot|ia_archiver|Bingbot|BingPreview|applebot|facebookexternalhit|facebookcatalog|Twitterbot|LinkedInBot|Slackbot|Discordbot|WhatsApp|SkypeUriPreview|Yeti|googleweblight`;
+const htmlLimitedBotRegexCache = /* @__PURE__ */ new Map();
+function getHtmlLimitedBotRegex(htmlLimitedBots) {
+	const source = htmlLimitedBots || HTML_LIMITED_BOT_UA_RE_STRING;
+	const cached = htmlLimitedBotRegexCache.get(source);
+	if (cached) return cached;
+	const regex = new RegExp(source, "i");
+	htmlLimitedBotRegexCache.set(source, regex);
+	return regex;
+}
+//#endregion
+export { getHtmlLimitedBotRegex };
+
+//# sourceMappingURL=html-limited-bots.js.map