vinext 0.0.49 → 0.0.51

package/dist/shims/url-utils.js

@@ -6,6 +6,14 @@ import { hasBasePath, stripBasePath } from "../utils/base-path.js";
 * Used by link.tsx, navigation.ts, and router.ts to normalize
 * same-origin absolute URLs to local paths for client-side navigation.
 */
+const ABSOLUTE_URL_REGEX = /^[a-zA-Z][a-zA-Z\d+\-.]*?:/;
+function isAbsoluteUrl(url) {
+	const firstChar = url.charCodeAt(0);
+	return (firstChar >= 65 && firstChar <= 90 || firstChar >= 97 && firstChar <= 122) && ABSOLUTE_URL_REGEX.test(url);
+}
+function isAbsoluteOrProtocolRelativeUrl(url) {
+	return isAbsoluteUrl(url) || url.startsWith("//");
+}
 /**
 * If `url` is an absolute same-origin URL, return the local path
 * (pathname + search + hash). Returns null for truly external URLs
@@ -36,10 +44,66 @@ function toSameOriginAppPath(url, basePath) {
 	}
 }
 /**
+* Split a path string into pathname, query, and hash without depending on
+* the URL constructor (which would resolve relative paths against an origin).
+*
+* Ported from Next.js: packages/next/src/shared/lib/router/utils/parse-path.ts
+*/
+function parsePath(path) {
+	const hashIndex = path.indexOf("#");
+	const queryIndex = path.indexOf("?");
+	const hasQuery = queryIndex > -1 && (hashIndex < 0 || queryIndex < hashIndex);
+	if (hasQuery || hashIndex > -1) return {
+		pathname: path.substring(0, hasQuery ? queryIndex : hashIndex),
+		query: hasQuery ? path.substring(queryIndex, hashIndex > -1 ? hashIndex : void 0) : "",
+		hash: hashIndex > -1 ? path.slice(hashIndex) : ""
+	};
+	return {
+		pathname: path,
+		query: "",
+		hash: ""
+	};
+}
+/**
+* Drop trailing slashes from a route while preserving the bare root.
+*
+* Ported from Next.js: packages/next/src/shared/lib/router/utils/remove-trailing-slash.ts
+*/
+function removeRouteTrailingSlash(route) {
+	return route.replace(/\/$/, "") || "/";
+}
+/**
+* Normalise the trailing slash of a local URL according to the
+* `trailingSlash` config option in `next.config.js`. Used by the `<Link>`
+* shim so that rendered `href` attributes match the canonical URL form
+* (which is what the server-side redirect would otherwise enforce).
+*
+* Behaviour matches Next.js's client-side `normalizePathTrailingSlash`:
+* packages/next/src/client/normalize-trailing-slash.ts
+*
+* - Absolute URLs (`http://`, `https://`, `//`) and non-local strings are
+*   returned unchanged.
+* - Paths whose final segment looks like a filename (`...\.ext`) have any
+*   trailing slash stripped even when `trailingSlash: true`, mirroring the
+*   `.well-known`-aware redirect rule shipped in `routes-manifest.json`.
+* - Query strings and hash fragments are preserved verbatim.
+* - Idempotent: already-canonical paths round-trip unchanged.
+*/
+function normalizePathTrailingSlash(path, trailingSlash) {
+	if (!path.startsWith("/") || path.startsWith("//")) return path;
+	const { pathname, query, hash } = parsePath(path);
+	if (trailingSlash) {
+		if (/\.[^/]+\/?$/.test(pathname)) return `${removeRouteTrailingSlash(pathname)}${query}${hash}`;
+		if (pathname.endsWith("/")) return `${pathname}${query}${hash}`;
+		return `${pathname}/${query}${hash}`;
+	}
+	return `${removeRouteTrailingSlash(pathname)}${query}${hash}`;
+}
+/**
 * Prepend basePath to a local path for browser URLs / fetches.
 */
 function withBasePath(path, basePath) {
-	if (!basePath || !path.startsWith("/") || path.startsWith("http://") || path.startsWith("https://") || path.startsWith("//")) return path;
+	if (!basePath || !path.startsWith("/") || isAbsoluteOrProtocolRelativeUrl(path)) return path;
 	return basePath + path;
 }
 /**
@@ -49,7 +113,7 @@ function withBasePath(path, basePath) {
 function resolveRelativeHref(href, currentUrl, basePath = "") {
 	const base = currentUrl ?? (typeof window !== "undefined" ? window.location.href : void 0);
 	if (!base) return href;
-	if (href.startsWith("/") || href.startsWith("http://") || href.startsWith("https://") || href.startsWith("//")) return href;
+	if (href.startsWith("/") || isAbsoluteOrProtocolRelativeUrl(href)) return href;
 	try {
 		const resolved = new URL(href, base);
 		return (basePath && resolved.pathname === basePath ? "" : basePath ? stripBasePath(resolved.pathname, basePath) : resolved.pathname) + resolved.search + resolved.hash;
@@ -68,7 +132,16 @@ function toBrowserNavigationHref(href, currentUrl, basePath = "") {
 	if (resolved.startsWith("?") || resolved.startsWith("#")) return basePath + resolved;
 	return withBasePath(resolved, basePath);
 }
+function isHashOnlyBrowserUrlChange(href, currentHref, basePath = "") {
+	try {
+		const current = new URL(currentHref);
+		const next = new URL(href, currentHref);
+		return stripBasePath(current.pathname, basePath) === stripBasePath(next.pathname, basePath) && current.search === next.search && next.hash !== "";
+	} catch {
+		return false;
+	}
+}
 //#endregion
-export { resolveRelativeHref, toBrowserNavigationHref, toSameOriginAppPath, toSameOriginPath, withBasePath };
+export { isAbsoluteOrProtocolRelativeUrl, isAbsoluteUrl, isHashOnlyBrowserUrlChange, normalizePathTrailingSlash, resolveRelativeHref, toBrowserNavigationHref, toSameOriginAppPath, toSameOriginPath, withBasePath };
 
 //# sourceMappingURL=url-utils.js.map

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/**\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 * Prepend basePath to a local path for browser URLs / fetches.\n */\nexport function withBasePath(path: string, basePath: string): string {\n  if (\n    !basePath ||\n    !path.startsWith(\"/\") ||\n    path.startsWith(\"http://\") ||\n    path.startsWith(\"https://\") ||\n    path.startsWith(\"//\")\n  ) {\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 (\n    href.startsWith(\"/\") ||\n    href.startsWith(\"http://\") ||\n    href.startsWith(\"https://\") ||\n    href.startsWith(\"//\")\n  ) {\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"],"mappings":";;;;;;;;;;;;;AAaA,SAAgB,iBAAiB,KAA4B;AAC3D,KAAI,OAAO,WAAW,YAAa,QAAO;AAC1C,KAAI;EACF,MAAM,SAAS,IAAI,WAAW,KAAK,GAAG,IAAI,IAAI,KAAK,OAAO,SAAS,OAAO,GAAG,IAAI,IAAI,IAAI;AACzF,MAAI,OAAO,WAAW,OAAO,SAAS,OACpC,QAAO,OAAO,WAAW,OAAO,SAAS,OAAO;SAE5C;AAGR,QAAO;;;;;;;AAQT,SAAgB,oBAAoB,KAAa,UAAiC;CAChF,MAAM,YAAY,iBAAiB,IAAI;AACvC,KAAI,aAAa,QAAQ,CAAC,SAAU,QAAO;AAE3C,KAAI;EACF,MAAM,SAAS,IAAI,IAAI,WAAW,sBAAsB;AACxD,MAAI,CAAC,YAAY,OAAO,UAAU,SAAS,CACzC,QAAO;AAGT,SADiB,cAAc,OAAO,UAAU,SAAS,GACvC,OAAO,SAAS,OAAO;SACnC;AACN,SAAO;;;;;;AAOX,SAAgB,aAAa,MAAc,UAA0B;AACnE,KACE,CAAC,YACD,CAAC,KAAK,WAAW,IAAI,IACrB,KAAK,WAAW,UAAU,IAC1B,KAAK,WAAW,WAAW,IAC3B,KAAK,WAAW,KAAK,CAErB,QAAO;AAGT,QAAO,WAAW;;;;;;AAOpB,SAAgB,oBAAoB,MAAc,YAAqB,WAAW,IAAY;CAC5F,MAAM,OAAO,eAAe,OAAO,WAAW,cAAc,OAAO,SAAS,OAAO,KAAA;AAEnF,KAAI,CAAC,KAAM,QAAO;AAElB,KACE,KAAK,WAAW,IAAI,IACpB,KAAK,WAAW,UAAU,IAC1B,KAAK,WAAW,WAAW,IAC3B,KAAK,WAAW,KAAK,CAErB,QAAO;AAGT,KAAI;EACF,MAAM,WAAW,IAAI,IAAI,MAAM,KAAK;AAOpC,UALE,YAAY,SAAS,aAAa,WAC9B,KACA,WACE,cAAc,SAAS,UAAU,SAAS,GAC1C,SAAS,YACC,SAAS,SAAS,SAAS;SACvC;AACN,SAAO;;;;;;;AAQX,SAAgB,wBAAwB,MAAc,YAAqB,WAAW,IAAY;CAChG,MAAM,WAAW,oBAAoB,MAAM,YAAY,SAAS;AAEhE,KAAI,CAAC,SACH,QAAO,aAAa,UAAU,SAAS;AAGzC,KAAI,aAAa,GACf,QAAO;AAGT,KAAI,SAAS,WAAW,IAAI,IAAI,SAAS,WAAW,IAAI,CACtD,QAAO,WAAW;AAGpB,QAAO,aAAa,UAAU,SAAS"}
+{"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"}

package/dist/shims/use-merged-ref.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-merged-ref.js","names":[],"sources":["../../src/shims/use-merged-ref.ts"],"sourcesContent":["\"use client\";\n\nimport { useCallback, useRef, type Ref } from \"react\";\n\n// Ported from Next.js: packages/next/src/client/use-merged-ref.ts\n// This is a compatibility hook to support React 18 and 19 refs.\n// In 19, a cleanup function from refs may be returned.\n// In 18, returning a cleanup function creates a warning.\n// Since we take userspace refs, we don't know ahead of time if a cleanup function will be returned.\n// This implements cleanup functions with the old behavior in 18.\n// We know refs are always called alternating with `null` and then `T`.\n// So a call with `null` means we need to call the previous cleanup functions.\nexport function useMergedRef<TElement>(refA: Ref<TElement>, refB: Ref<TElement>): Ref<TElement> {\n  const cleanupA = useRef<(() => void) | null>(null);\n  const cleanupB = useRef<(() => void) | null>(null);\n\n  return useCallback(\n    (current: TElement | null): void => {\n      if (current === null) {\n        const cleanupFnA = cleanupA.current;\n        if (cleanupFnA) {\n          cleanupA.current = null;\n          cleanupFnA();\n        }\n        const cleanupFnB = cleanupB.current;\n        if (cleanupFnB) {\n          cleanupB.current = null;\n          cleanupFnB();\n        }\n      } else {\n        if (refA) {\n          cleanupA.current = applyRef(refA, current);\n        }\n        if (refB) {\n          cleanupB.current = applyRef(refB, current);\n        }\n      }\n    },\n    [refA, refB],\n  );\n}\n\nfunction applyRef<TElement>(refA: NonNullable<Ref<TElement>>, current: TElement) {\n  if (typeof refA === \"function\") {\n    const cleanup = refA(current);\n    if (typeof cleanup === \"function\") {\n      return cleanup;\n    } else {\n      return () => refA(null);\n    }\n  } else {\n    refA.current = current;\n    return () => {\n      refA.current = null;\n    };\n  }\n}\n"],"mappings":";;;AAYA,SAAgB,aAAuB,MAAqB,MAAoC;CAC9F,MAAM,WAAW,OAA4B,KAAK;CAClD,MAAM,WAAW,OAA4B,KAAK;AAElD,QAAO,aACJ,YAAmC;AAClC,MAAI,YAAY,MAAM;GACpB,MAAM,aAAa,SAAS;AAC5B,OAAI,YAAY;AACd,aAAS,UAAU;AACnB,gBAAY;;GAEd,MAAM,aAAa,SAAS;AAC5B,OAAI,YAAY;AACd,aAAS,UAAU;AACnB,gBAAY;;SAET;AACL,OAAI,KACF,UAAS,UAAU,SAAS,MAAM,QAAQ;AAE5C,OAAI,KACF,UAAS,UAAU,SAAS,MAAM,QAAQ;;IAIhD,CAAC,MAAM,KAAK,CACb;;AAGH,SAAS,SAAmB,MAAkC,SAAmB;AAC/E,KAAI,OAAO,SAAS,YAAY;EAC9B,MAAM,UAAU,KAAK,QAAQ;AAC7B,MAAI,OAAO,YAAY,WACrB,QAAO;MAEP,cAAa,KAAK,KAAK;QAEpB;AACL,OAAK,UAAU;AACf,eAAa;AACX,QAAK,UAAU"}
+{"version":3,"file":"use-merged-ref.js","names":[],"sources":["../../src/shims/use-merged-ref.ts"],"sourcesContent":["\"use client\";\n\nimport { useCallback, useRef, type Ref } from \"react\";\n\n// Ported from Next.js: packages/next/src/client/use-merged-ref.ts\n// This is a compatibility hook to support React 18 and 19 refs.\n// In 19, a cleanup function from refs may be returned.\n// In 18, returning a cleanup function creates a warning.\n// Since we take userspace refs, we don't know ahead of time if a cleanup function will be returned.\n// This implements cleanup functions with the old behavior in 18.\n// We know refs are always called alternating with `null` and then `T`.\n// So a call with `null` means we need to call the previous cleanup functions.\nexport function useMergedRef<TElement>(refA: Ref<TElement>, refB: Ref<TElement>): Ref<TElement> {\n  const cleanupA = useRef<(() => void) | null>(null);\n  const cleanupB = useRef<(() => void) | null>(null);\n\n  return useCallback(\n    (current: TElement | null): void => {\n      if (current === null) {\n        const cleanupFnA = cleanupA.current;\n        if (cleanupFnA) {\n          cleanupA.current = null;\n          cleanupFnA();\n        }\n        const cleanupFnB = cleanupB.current;\n        if (cleanupFnB) {\n          cleanupB.current = null;\n          cleanupFnB();\n        }\n      } else {\n        if (refA) {\n          cleanupA.current = applyRef(refA, current);\n        }\n        if (refB) {\n          cleanupB.current = applyRef(refB, current);\n        }\n      }\n    },\n    [refA, refB],\n  );\n}\n\nfunction applyRef<TElement>(refA: NonNullable<Ref<TElement>>, current: TElement) {\n  if (typeof refA === \"function\") {\n    const cleanup = refA(current);\n    if (typeof cleanup === \"function\") {\n      return cleanup;\n    } else {\n      return () => refA(null);\n    }\n  } else {\n    refA.current = current;\n    return () => {\n      refA.current = null;\n    };\n  }\n}\n"],"mappings":";;;AAYA,SAAgB,aAAuB,MAAqB,MAAoC;CAC9F,MAAM,WAAW,OAA4B,KAAK;CAClD,MAAM,WAAW,OAA4B,KAAK;CAElD,OAAO,aACJ,YAAmC;EAClC,IAAI,YAAY,MAAM;GACpB,MAAM,aAAa,SAAS;GAC5B,IAAI,YAAY;IACd,SAAS,UAAU;IACnB,YAAY;;GAEd,MAAM,aAAa,SAAS;GAC5B,IAAI,YAAY;IACd,SAAS,UAAU;IACnB,YAAY;;SAET;GACL,IAAI,MACF,SAAS,UAAU,SAAS,MAAM,QAAQ;GAE5C,IAAI,MACF,SAAS,UAAU,SAAS,MAAM,QAAQ;;IAIhD,CAAC,MAAM,KAAK,CACb;;AAGH,SAAS,SAAmB,MAAkC,SAAmB;CAC/E,IAAI,OAAO,SAAS,YAAY;EAC9B,MAAM,UAAU,KAAK,QAAQ;EAC7B,IAAI,OAAO,YAAY,YACrB,OAAO;OAEP,aAAa,KAAK,KAAK;QAEpB;EACL,KAAK,UAAU;EACf,aAAa;GACX,KAAK,UAAU"}

package/dist/shims/web-vitals.d.ts

@@ -1,26 +1,9 @@
+import { MetricType } from "web-vitals";
+
 //#region src/shims/web-vitals.d.ts
-/**
- * next/web-vitals shim
- *
- * Provides useReportWebVitals() — a no-op hook for compatibility.
- * In real Next.js, this sends Core Web Vitals to an analytics endpoint.
- * Apps can use the web-vitals library directly instead.
- */
-type WebVitalsMetric = {
-  id: string;
-  name: string;
-  value: number;
-  rating?: "good" | "needs-improvement" | "poor";
-  delta: number;
-  navigationType?: "navigate" | "reload" | "back-forward" | "prerender";
-};
+type WebVitalsMetric = MetricType;
 type ReportWebVitalsCallback = (metric: WebVitalsMetric) => void;
-/**
- * Register a callback to receive Core Web Vitals metrics.
- * No-op in our implementation — use the `web-vitals` library directly
- * for production metrics collection.
- */
-declare function useReportWebVitals(_callback: ReportWebVitalsCallback): void;
+declare function useReportWebVitals(callback: ReportWebVitalsCallback): void;
 //#endregion
 export { type ReportWebVitalsCallback, type WebVitalsMetric, useReportWebVitals };
 //# sourceMappingURL=web-vitals.d.ts.map

package/dist/shims/web-vitals.js

@@ -1,10 +1,23 @@
+import { useEffect, useRef } from "react";
+import { onCLS, onFCP, onFID, onINP, onLCP, onTTFB } from "web-vitals";
 //#region src/shims/web-vitals.ts
-/**
-* Register a callback to receive Core Web Vitals metrics.
-* No-op in our implementation — use the `web-vitals` library directly
-* for production metrics collection.
-*/
-function useReportWebVitals(_callback) {}
+function useReportWebVitals(callback) {
+	const callbackRef = useRef(callback);
+	useEffect(() => {
+		callbackRef.current = callback;
+	}, [callback]);
+	useEffect(() => {
+		const reportWebVitals = (metric) => {
+			callbackRef.current(metric);
+		};
+		onCLS(reportWebVitals);
+		onFID(reportWebVitals);
+		onLCP(reportWebVitals);
+		onINP(reportWebVitals);
+		onFCP(reportWebVitals);
+		onTTFB(reportWebVitals);
+	}, []);
+}
 //#endregion
 export { useReportWebVitals };
 

package/dist/shims/web-vitals.js.map

@@ -1 +1 @@
-{"version":3,"file":"web-vitals.js","names":[],"sources":["../../src/shims/web-vitals.ts"],"sourcesContent":["/**\n * next/web-vitals shim\n *\n * Provides useReportWebVitals() — a no-op hook for compatibility.\n * In real Next.js, this sends Core Web Vitals to an analytics endpoint.\n * Apps can use the web-vitals library directly instead.\n */\n\ntype WebVitalsMetric = {\n  id: string;\n  name: string;\n  value: number;\n  rating?: \"good\" | \"needs-improvement\" | \"poor\";\n  delta: number;\n  navigationType?: \"navigate\" | \"reload\" | \"back-forward\" | \"prerender\";\n};\n\ntype ReportWebVitalsCallback = (metric: WebVitalsMetric) => void;\n\n/**\n * Register a callback to receive Core Web Vitals metrics.\n * No-op in our implementation — use the `web-vitals` library directly\n * for production metrics collection.\n */\nexport function useReportWebVitals(_callback: ReportWebVitalsCallback): void {\n  // No-op — apps should use the web-vitals library directly\n  // or their own analytics integration.\n}\n\nexport type { WebVitalsMetric, ReportWebVitalsCallback };\n"],"mappings":";;;;;;AAwBA,SAAgB,mBAAmB,WAA0C"}
+{"version":3,"file":"web-vitals.js","names":[],"sources":["../../src/shims/web-vitals.ts"],"sourcesContent":["import { useEffect, useRef } from \"react\";\nimport { onCLS, onFID, onLCP, onINP, onFCP, onTTFB, type MetricType } from \"web-vitals\";\n\ntype WebVitalsMetric = MetricType;\ntype ReportWebVitalsCallback = (metric: WebVitalsMetric) => void;\n\nexport function useReportWebVitals(callback: ReportWebVitalsCallback): void {\n  const callbackRef = useRef(callback);\n\n  useEffect(() => {\n    callbackRef.current = callback;\n  }, [callback]);\n\n  useEffect(() => {\n    const reportWebVitals = (metric: WebVitalsMetric) => {\n      callbackRef.current(metric);\n    };\n\n    onCLS(reportWebVitals);\n    onFID(reportWebVitals);\n    onLCP(reportWebVitals);\n    onINP(reportWebVitals);\n    onFCP(reportWebVitals);\n    onTTFB(reportWebVitals);\n  }, []);\n}\n\nexport type { WebVitalsMetric, ReportWebVitalsCallback };\n"],"mappings":";;;AAMA,SAAgB,mBAAmB,UAAyC;CAC1E,MAAM,cAAc,OAAO,SAAS;CAEpC,gBAAgB;EACd,YAAY,UAAU;IACrB,CAAC,SAAS,CAAC;CAEd,gBAAgB;EACd,MAAM,mBAAmB,WAA4B;GACnD,YAAY,QAAQ,OAAO;;EAG7B,MAAM,gBAAgB;EACtB,MAAM,gBAAgB;EACtB,MAAM,gBAAgB;EACtB,MAAM,gBAAgB;EACtB,MAAM,gBAAgB;EACtB,OAAO,gBAAgB;IACtB,EAAE,CAAC"}

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

@@ -0,0 +1,69 @@
+//#region src/utils/asset-prefix.d.ts
+/**
+ * Shared helpers for next.config `assetPrefix`.
+ *
+ * Mirrors Next.js semantics: `assetPrefix` is prepended to every JS/CSS/image/
+ * 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 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.
+ *  - An absolute URL like `"https://cdn.example.com"` makes asset URLs fully
+ *    qualified. Runtime serving on the deployment origin is a no-op — the CDN
+ *    serves the assets directly.
+ *
+ * The path component of the asset URL after the prefix is always
+ * `/_next/static/<filename>` to match Next.js's convention. This is the
+ * convention upstream test suites assert against.
+ *
+ * @see https://nextjs.org/docs/app/api-reference/config/next-config-js/assetPrefix
+ */
+/**
+ * Suffix appended to the assetPrefix (or used standalone when no prefix is
+ * configured) to form the leading portion of every emitted asset URL.
+ * Matches Next.js: assets always live under `/_next/static/`.
+ */
+declare const ASSET_PREFIX_URL_DIR = "_next/static";
+/** Whether `assetPrefix` is an absolute URL (vs a path prefix). */
+declare function isAbsoluteAssetPrefix(assetPrefix: string): boolean;
+/**
+ * Compute the on-disk `build.assetsDir` for the given `assetPrefix`.
+ *
+ *  - Path prefix (`/cdn`): write to `cdn/_next/static/` so the on-disk layout
+ *    matches the URL — the Cloudflare ASSETS binding (and any static file
+ *    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`.
+ */
+declare function resolveAssetsDir(assetPrefix: string): string;
+/**
+ * Build the URL prefix to apply to emitted asset URLs. Returns the full URL
+ * prefix including the `_next/static/` directory, with a trailing slash.
+ *
+ * Examples:
+ *  - `""` → `"/_next/static/"`
+ *  - `"/cdn"` → `"/cdn/_next/static/"`
+ *  - `"https://cdn.example.com"` → `"https://cdn.example.com/_next/static/"`
+ *  - `"https://cdn.example.com/sub"` → `"https://cdn.example.com/sub/_next/static/"`
+ */
+declare function resolveAssetUrlPrefix(assetPrefix: string): string;
+/**
+ * Extract the path portion of `assetPrefix` for use in runtime URL matching.
+ *
+ *  - For a path prefix: returns it verbatim (e.g. `/custom-asset-prefix`).
+ *  - For an absolute URL: returns its pathname stripped of trailing slashes
+ *    (e.g. `"https://cdn.example.com/sub"` → `/sub`, plain origin → `""`).
+ *  - For empty input: returns `""`.
+ *
+ * Used by the prod server and Cloudflare worker entry to recognise asset
+ * requests that arrive at the deployment origin under the configured prefix.
+ */
+declare function assetPrefixPathname(assetPrefix: string): string;
+//#endregion
+export { ASSET_PREFIX_URL_DIR, assetPrefixPathname, isAbsoluteAssetPrefix, resolveAssetUrlPrefix, resolveAssetsDir };
+//# sourceMappingURL=asset-prefix.d.ts.map

package/dist/utils/asset-prefix.js

@@ -0,0 +1,91 @@
+//#region src/utils/asset-prefix.ts
+/**
+* Shared helpers for next.config `assetPrefix`.
+*
+* Mirrors Next.js semantics: `assetPrefix` is prepended to every JS/CSS/image/
+* 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 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.
+*  - An absolute URL like `"https://cdn.example.com"` makes asset URLs fully
+*    qualified. Runtime serving on the deployment origin is a no-op — the CDN
+*    serves the assets directly.
+*
+* The path component of the asset URL after the prefix is always
+* `/_next/static/<filename>` to match Next.js's convention. This is the
+* convention upstream test suites assert against.
+*
+* @see https://nextjs.org/docs/app/api-reference/config/next-config-js/assetPrefix
+*/
+/**
+* Suffix appended to the assetPrefix (or used standalone when no prefix is
+* configured) to form the leading portion of every emitted asset URL.
+* Matches Next.js: assets always live under `/_next/static/`.
+*/
+const ASSET_PREFIX_URL_DIR = "_next/static";
+/** Whether `assetPrefix` is an absolute URL (vs a path prefix). */
+function isAbsoluteAssetPrefix(assetPrefix) {
+	return /^https?:\/\//i.test(assetPrefix);
+}
+/**
+* Compute the on-disk `build.assetsDir` for the given `assetPrefix`.
+*
+*  - Path prefix (`/cdn`): write to `cdn/_next/static/` so the on-disk layout
+*    matches the URL — the Cloudflare ASSETS binding (and any static file
+*    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`.
+*/
+function resolveAssetsDir(assetPrefix) {
+	if (!assetPrefix) return "assets";
+	if (isAbsoluteAssetPrefix(assetPrefix)) return ASSET_PREFIX_URL_DIR;
+	let stripped = assetPrefix;
+	while (stripped.startsWith("/")) stripped = stripped.slice(1);
+	return `${stripped}/${ASSET_PREFIX_URL_DIR}`;
+}
+/**
+* Build the URL prefix to apply to emitted asset URLs. Returns the full URL
+* prefix including the `_next/static/` directory, with a trailing slash.
+*
+* Examples:
+*  - `""` → `"/_next/static/"`
+*  - `"/cdn"` → `"/cdn/_next/static/"`
+*  - `"https://cdn.example.com"` → `"https://cdn.example.com/_next/static/"`
+*  - `"https://cdn.example.com/sub"` → `"https://cdn.example.com/sub/_next/static/"`
+*/
+function resolveAssetUrlPrefix(assetPrefix) {
+	if (!assetPrefix) return `/${ASSET_PREFIX_URL_DIR}/`;
+	return `${assetPrefix}/${ASSET_PREFIX_URL_DIR}/`;
+}
+/**
+* Extract the path portion of `assetPrefix` for use in runtime URL matching.
+*
+*  - For a path prefix: returns it verbatim (e.g. `/custom-asset-prefix`).
+*  - For an absolute URL: returns its pathname stripped of trailing slashes
+*    (e.g. `"https://cdn.example.com/sub"` → `/sub`, plain origin → `""`).
+*  - For empty input: returns `""`.
+*
+* Used by the prod server and Cloudflare worker entry to recognise asset
+* requests that arrive at the deployment origin under the configured prefix.
+*/
+function assetPrefixPathname(assetPrefix) {
+	if (!assetPrefix) return "";
+	if (!isAbsoluteAssetPrefix(assetPrefix)) return assetPrefix;
+	try {
+		let pathname = new URL(assetPrefix).pathname;
+		while (pathname.endsWith("/")) pathname = pathname.slice(0, -1);
+		return pathname === "" ? "" : pathname;
+	} catch {
+		return "";
+	}
+}
+//#endregion
+export { ASSET_PREFIX_URL_DIR, assetPrefixPathname, isAbsoluteAssetPrefix, resolveAssetUrlPrefix, resolveAssetsDir };
+
+//# sourceMappingURL=asset-prefix.js.map

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

@@ -0,0 +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"}

package/dist/utils/base-path.d.ts

@@ -15,6 +15,12 @@ declare function hasBasePath(pathname: string, basePath: string): boolean;
  * boundary. Returns the original pathname when it is outside the basePath.
  */
 declare function stripBasePath(pathname: string, basePath: string): string;
+/**
+ * Add the configured basePath to a pathname unless it is already inside that
+ * basePath. Query strings and hashes must be handled by callers before calling
+ * this pathname-only helper.
+ */
+declare function addBasePathToPathname(pathname: string, basePath: string | undefined): string;
 /**
  * Remove trailing slashes from a pathname while preserving the root "/".
  * Collapses any number of trailing slashes ("/a//" → "/a"). Used by the
@@ -22,5 +28,5 @@ declare function stripBasePath(pathname: string, basePath: string): string;
  */
 declare function removeTrailingSlash(pathname: string): string;
 //#endregion
-export { hasBasePath, removeTrailingSlash, stripBasePath };
+export { addBasePathToPathname, hasBasePath, removeTrailingSlash, stripBasePath };
 //# sourceMappingURL=base-path.d.ts.map

package/dist/utils/base-path.js

@@ -22,6 +22,15 @@ function stripBasePath(pathname, basePath) {
 	return pathname.slice(basePath.length) || "/";
 }
 /**
+* Add the configured basePath to a pathname unless it is already inside that
+* basePath. Query strings and hashes must be handled by callers before calling
+* this pathname-only helper.
+*/
+function addBasePathToPathname(pathname, basePath) {
+	if (!basePath || hasBasePath(pathname, basePath)) return pathname;
+	return pathname === "/" ? basePath : `${basePath}${pathname}`;
+}
+/**
 * Remove trailing slashes from a pathname while preserving the root "/".
 * Collapses any number of trailing slashes ("/a//" → "/a"). Used by the
 * trailing-slash redirect path and route pattern normalization.
@@ -33,6 +42,6 @@ function removeTrailingSlash(pathname) {
 	return end === 0 ? "/" : pathname.slice(0, end);
 }
 //#endregion
-export { hasBasePath, removeTrailingSlash, stripBasePath };
+export { addBasePathToPathname, hasBasePath, removeTrailingSlash, stripBasePath };
 
 //# sourceMappingURL=base-path.js.map

package/dist/utils/base-path.js.map

@@ -1 +1 @@
-{"version":3,"file":"base-path.js","names":[],"sources":["../../src/utils/base-path.ts"],"sourcesContent":["/**\n * Shared basePath helpers.\n *\n * Next.js only treats a pathname as being under basePath when it is an exact\n * match (\"/app\") or starts with the basePath followed by a path separator\n * (\"/app/...\"). Prefix-only matches like \"/application\" must be left intact.\n */\n\n/**\n * Check whether a pathname is inside the configured basePath.\n */\nexport function hasBasePath(pathname: string, basePath: string): boolean {\n  if (!basePath) return false;\n  return pathname === basePath || pathname.startsWith(basePath + \"/\");\n}\n\n/**\n * Strip the basePath prefix from a pathname when it matches on a segment\n * boundary. Returns the original pathname when it is outside the basePath.\n */\nexport function stripBasePath(pathname: string, basePath: string): string {\n  if (!hasBasePath(pathname, basePath)) return pathname;\n  return pathname.slice(basePath.length) || \"/\";\n}\n\n/**\n * Remove trailing slashes from a pathname while preserving the root \"/\".\n * Collapses any number of trailing slashes (\"/a//\" → \"/a\"). Used by the\n * trailing-slash redirect path and route pattern normalization.\n */\nexport function removeTrailingSlash(pathname: string): string {\n  if (pathname === \"/\") return \"/\";\n  let end = pathname.length;\n  while (end > 0 && pathname.charCodeAt(end - 1) === 47 /* \"/\" */) end--;\n  return end === 0 ? \"/\" : pathname.slice(0, end);\n}\n"],"mappings":";;;;;;;;;;;AAWA,SAAgB,YAAY,UAAkB,UAA2B;AACvE,KAAI,CAAC,SAAU,QAAO;AACtB,QAAO,aAAa,YAAY,SAAS,WAAW,WAAW,IAAI;;;;;;AAOrE,SAAgB,cAAc,UAAkB,UAA0B;AACxE,KAAI,CAAC,YAAY,UAAU,SAAS,CAAE,QAAO;AAC7C,QAAO,SAAS,MAAM,SAAS,OAAO,IAAI;;;;;;;AAQ5C,SAAgB,oBAAoB,UAA0B;AAC5D,KAAI,aAAa,IAAK,QAAO;CAC7B,IAAI,MAAM,SAAS;AACnB,QAAO,MAAM,KAAK,SAAS,WAAW,MAAM,EAAE,KAAK,GAAc;AACjE,QAAO,QAAQ,IAAI,MAAM,SAAS,MAAM,GAAG,IAAI"}
+{"version":3,"file":"base-path.js","names":[],"sources":["../../src/utils/base-path.ts"],"sourcesContent":["/**\n * Shared basePath helpers.\n *\n * Next.js only treats a pathname as being under basePath when it is an exact\n * match (\"/app\") or starts with the basePath followed by a path separator\n * (\"/app/...\"). Prefix-only matches like \"/application\" must be left intact.\n */\n\n/**\n * Check whether a pathname is inside the configured basePath.\n */\nexport function hasBasePath(pathname: string, basePath: string): boolean {\n  if (!basePath) return false;\n  return pathname === basePath || pathname.startsWith(basePath + \"/\");\n}\n\n/**\n * Strip the basePath prefix from a pathname when it matches on a segment\n * boundary. Returns the original pathname when it is outside the basePath.\n */\nexport function stripBasePath(pathname: string, basePath: string): string {\n  if (!hasBasePath(pathname, basePath)) return pathname;\n  return pathname.slice(basePath.length) || \"/\";\n}\n\n/**\n * Add the configured basePath to a pathname unless it is already inside that\n * basePath. Query strings and hashes must be handled by callers before calling\n * this pathname-only helper.\n */\nexport function addBasePathToPathname(pathname: string, basePath: string | undefined): string {\n  if (!basePath || hasBasePath(pathname, basePath)) return pathname;\n  return pathname === \"/\" ? basePath : `${basePath}${pathname}`;\n}\n\n/**\n * Remove trailing slashes from a pathname while preserving the root \"/\".\n * Collapses any number of trailing slashes (\"/a//\" → \"/a\"). Used by the\n * trailing-slash redirect path and route pattern normalization.\n */\nexport function removeTrailingSlash(pathname: string): string {\n  if (pathname === \"/\") return \"/\";\n  let end = pathname.length;\n  while (end > 0 && pathname.charCodeAt(end - 1) === 47 /* \"/\" */) end--;\n  return end === 0 ? \"/\" : pathname.slice(0, end);\n}\n"],"mappings":";;;;;;;;;;;AAWA,SAAgB,YAAY,UAAkB,UAA2B;CACvE,IAAI,CAAC,UAAU,OAAO;CACtB,OAAO,aAAa,YAAY,SAAS,WAAW,WAAW,IAAI;;;;;;AAOrE,SAAgB,cAAc,UAAkB,UAA0B;CACxE,IAAI,CAAC,YAAY,UAAU,SAAS,EAAE,OAAO;CAC7C,OAAO,SAAS,MAAM,SAAS,OAAO,IAAI;;;;;;;AAQ5C,SAAgB,sBAAsB,UAAkB,UAAsC;CAC5F,IAAI,CAAC,YAAY,YAAY,UAAU,SAAS,EAAE,OAAO;CACzD,OAAO,aAAa,MAAM,WAAW,GAAG,WAAW;;;;;;;AAQrD,SAAgB,oBAAoB,UAA0B;CAC5D,IAAI,aAAa,KAAK,OAAO;CAC7B,IAAI,MAAM,SAAS;CACnB,OAAO,MAAM,KAAK,SAAS,WAAW,MAAM,EAAE,KAAK,IAAc;CACjE,OAAO,QAAQ,IAAI,MAAM,SAAS,MAAM,GAAG,IAAI"}

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;AAChF,QAAO,UAAU,QAAQ,OAAO,UAAU,YAAY,CAAC,MAAM,QAAQ,MAAM;;AAG7E,SAAS,gBACP,KACA,OACqC;CACrC,MAAM,QAAQ,MAAM;AACpB,QAAO,gBAAgB,MAAM,GAAG,QAAQ,KAAA;;AAG1C,SAAgB,4BACd,KACA,OACoB;CAEpB,MAAM,QADe,gBAAgB,KAAK,eAAe,GAC5B,UAAU,MAAM;AAC7C,QAAO,OAAO,UAAU,WAAW,QAAQ,KAAA"}
+{"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"}

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;AAC/F,KAAI,CAAC,SAAU,QAAO,KAAA;AACtB,QAAO,SAAS,MAAM,KAAK,EAAE,CAAC,IAAI,MAAM,CAAC,MAAM,KAAK,EAAE,CAAC,IAAI,aAAa,IAAI,KAAA;;;;;;;;;AAU9E,SAAgB,mBACd,aACA,UACA,gBAC0B;AAC1B,KAAI,CAAC,aAAa,OAAQ,QAAO,KAAA;CAEjC,MAAM,qBAAqB,wBAAwB,SAAS;CAC5D,MAAM,mBAAmB,gBAAgB,aAAa;AAEtD,MAAK,MAAM,QAAQ,YAEjB,KACE,uBAFqB,wBAAwB,KAAK,OAAO,IAGzD,qBAAqB,KAAK,cAAc,aAAa,IACrD,KAAK,SAAS,MAAM,WAAW,OAAO,aAAa,KAAK,iBAAiB,CAEzE,QAAO;;AAOb,SAAgB,gBAAgB,MAAc,QAAgB,eAA+B;CAC3F,MAAM,mBAAmB,OAAO,aAAa;AAC7C,KAAI,qBAAqB,cAAc,aAAa,CAAE,QAAO;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;AAEzB,KAAI,uBAAuB,gBAAgB,mBAAmB,WAAW,GAAG,aAAa,GAAG,CAC1F,QAAO,KAAK,WAAW,IAAI,GAAG,OAAO;AAGvC,QAAO,IAAI,SAAS;;AAGtB,SAAS,aAAa,MAAc,WAAW,IAAY;AACzD,KAAI,CAAC,SAAU,QAAO;AACtB,QAAO,WAAW;;AAGpB,SAAgB,mBACd,KACA,QACA,EACE,UACA,iBACA,eAMkB;AACpB,KAAI,CAAC,aAAa,OAAQ,QAAO,KAAA;CAEjC,MAAM,eAAe,mBAAmB,aAAa,KAAA,GAAW,OAAO;AACvE,KAAI,CAAC,aAAc,QAAO,KAAA;CAE1B,MAAM,gBAAgB,mBAAmB,aAAa,mBAAmB,KAAA,EAAU;CACnF,MAAM,gBAAgB,gBAAgB,KAAK,QAAQ,aAAa,cAAc;AAE9E,KACE,iBACA,wBAAwB,cAAc,OAAO,KAAK,wBAAwB,aAAa,OAAO,CAK9F;AAIF,QAAO,GADQ,OAAO,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\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"}

package/dist/utils/encode-cache-tag.d.ts

@@ -0,0 +1,31 @@
+//#region src/utils/encode-cache-tag.d.ts
+/**
+ * Cache-tag canonicalisation.
+ *
+ * Tags can flow into HTTP headers (e.g. `x-next-cache-tags` on ISR responses,
+ * Cloudflare cache-tag headers, downstream Worker code) where Node's
+ * `validateHeaderValue` rejects any byte outside `\t\x20-\x7e` and crashes
+ * the response with `ERR_INVALID_CHAR`. Even on platforms with permissive
+ * header setters, divergence between storage form and wire form silently
+ * breaks invalidation when a `revalidateTag` call's tag does not byte-match
+ * the form that was stored.
+ *
+ * The fix is to apply this encoding at every public boundary so storage,
+ * comparison, and the wire all see the same ASCII-safe form. The fast-path
+ * returns the input unchanged for already-ASCII tags (the common case), so
+ * pre-encoded `%xx` input round-trips losslessly without `decodeURIComponent`
+ * mangling literal `%xx` characters.
+ *
+ * The replacement matches *runs* of out-of-class code units rather than each
+ * code unit individually so surrogate pairs (emoji, non-BMP characters) are
+ * handed to `encodeURIComponent` as a complete code point — a per-code-unit
+ * regex would split the pair and throw `URIError`.
+ *
+ * Mirrors Next.js's `packages/next/src/server/lib/encode-cache-tag.ts`
+ * (introduced in vercel/next.js#93601).
+ */
+declare function encodeCacheTag(tag: string): string;
+declare function encodeCacheTags(tags: readonly string[]): string[];
+//#endregion
+export { encodeCacheTag, encodeCacheTags };
+//# sourceMappingURL=encode-cache-tag.d.ts.map

package/dist/utils/encode-cache-tag.js

@@ -0,0 +1,38 @@
+//#region src/utils/encode-cache-tag.ts
+/**
+* Cache-tag canonicalisation.
+*
+* Tags can flow into HTTP headers (e.g. `x-next-cache-tags` on ISR responses,
+* Cloudflare cache-tag headers, downstream Worker code) where Node's
+* `validateHeaderValue` rejects any byte outside `\t\x20-\x7e` and crashes
+* the response with `ERR_INVALID_CHAR`. Even on platforms with permissive
+* header setters, divergence between storage form and wire form silently
+* breaks invalidation when a `revalidateTag` call's tag does not byte-match
+* the form that was stored.
+*
+* The fix is to apply this encoding at every public boundary so storage,
+* comparison, and the wire all see the same ASCII-safe form. The fast-path
+* returns the input unchanged for already-ASCII tags (the common case), so
+* pre-encoded `%xx` input round-trips losslessly without `decodeURIComponent`
+* mangling literal `%xx` characters.
+*
+* The replacement matches *runs* of out-of-class code units rather than each
+* code unit individually so surrogate pairs (emoji, non-BMP characters) are
+* handed to `encodeURIComponent` as a complete code point — a per-code-unit
+* regex would split the pair and throw `URIError`.
+*
+* Mirrors Next.js's `packages/next/src/server/lib/encode-cache-tag.ts`
+* (introduced in vercel/next.js#93601).
+*/
+const OUT_OF_CLASS_CHAR = /[^\t\x20-\x7e]/;
+const OUT_OF_CLASS_RUN = /[^\t\x20-\x7e]+/g;
+function encodeCacheTag(tag) {
+	return OUT_OF_CLASS_CHAR.test(tag) ? tag.replace(OUT_OF_CLASS_RUN, (run) => encodeURIComponent(run)) : tag;
+}
+function encodeCacheTags(tags) {
+	return tags.map(encodeCacheTag);
+}
+//#endregion
+export { encodeCacheTag, encodeCacheTags };
+
+//# sourceMappingURL=encode-cache-tag.js.map

package/dist/utils/encode-cache-tag.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"encode-cache-tag.js","names":[],"sources":["../../src/utils/encode-cache-tag.ts"],"sourcesContent":["/**\n * Cache-tag canonicalisation.\n *\n * Tags can flow into HTTP headers (e.g. `x-next-cache-tags` on ISR responses,\n * Cloudflare cache-tag headers, downstream Worker code) where Node's\n * `validateHeaderValue` rejects any byte outside `\\t\\x20-\\x7e` and crashes\n * the response with `ERR_INVALID_CHAR`. Even on platforms with permissive\n * header setters, divergence between storage form and wire form silently\n * breaks invalidation when a `revalidateTag` call's tag does not byte-match\n * the form that was stored.\n *\n * The fix is to apply this encoding at every public boundary so storage,\n * comparison, and the wire all see the same ASCII-safe form. The fast-path\n * returns the input unchanged for already-ASCII tags (the common case), so\n * pre-encoded `%xx` input round-trips losslessly without `decodeURIComponent`\n * mangling literal `%xx` characters.\n *\n * The replacement matches *runs* of out-of-class code units rather than each\n * code unit individually so surrogate pairs (emoji, non-BMP characters) are\n * handed to `encodeURIComponent` as a complete code point — a per-code-unit\n * regex would split the pair and throw `URIError`.\n *\n * Mirrors Next.js's `packages/next/src/server/lib/encode-cache-tag.ts`\n * (introduced in vercel/next.js#93601).\n */\n\nconst OUT_OF_CLASS_CHAR = /[^\\t\\x20-\\x7e]/;\nconst OUT_OF_CLASS_RUN = /[^\\t\\x20-\\x7e]+/g;\n\nexport function encodeCacheTag(tag: string): string {\n  return OUT_OF_CLASS_CHAR.test(tag)\n    ? tag.replace(OUT_OF_CLASS_RUN, (run) => encodeURIComponent(run))\n    : tag;\n}\n\nexport function encodeCacheTags(tags: readonly string[]): string[] {\n  return tags.map(encodeCacheTag);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AA0BA,MAAM,oBAAoB;AAC1B,MAAM,mBAAmB;AAEzB,SAAgB,eAAe,KAAqB;CAClD,OAAO,kBAAkB,KAAK,IAAI,GAC9B,IAAI,QAAQ,mBAAmB,QAAQ,mBAAmB,IAAI,CAAC,GAC/D;;AAGN,SAAgB,gBAAgB,MAAmC;CACjE,OAAO,KAAK,IAAI,eAAe"}