reroute-js 1.0.0-alpha.39 → 1.0.0-alpha.40

package/README.md

@@ -678,6 +678,37 @@ src/client/routes/blog/content/
 - `setLocale()` writes `?lang=` and the server 302s to the canonical content URL (and sets the cookie). That is the only way to leave a URL that already has a locale in the path
 - Optional negotiate: `Accept-Language` / cookie can 302 **unprefixed** content URLs to a localized path (`i18n.redirectContentOnNegotiate`, default `true`)
 
+### Locale-prefixed pages (`i18n.prefixPages`)
+
+Off by default. With `prefixPages: true` every page carries its locale in the URL, so each response depends on its URL alone and a CDN that caches by URL never serves one visitor's language to the next:
+
+| URL | Locale |
+|-----|--------|
+| `/compare` | default |
+| `/pt-BR/compare`, `/pt-BR` | pt-BR |
+| `/help/pt-BR/slug` | pt-BR (content keeps its format) |
+
+- The cookie and `Accept-Language` never pick a page's locale, and page/data responses send no `Set-Cookie`
+- `/en-US/compare` 301s to `/compare`; a prefix in front of a content URL (`/pt-BR/help/slug`) 301s to `/help/pt-BR/slug`
+- `?lang=xx` 302s to that locale's URL (and only that redirect sets the cookie); `setLocale()` uses it
+- `<Link to="/compare">` renders `/pt-BR/compare` on a pt-BR page; a path that names a locale (`/pt-BR/...`) is left as written, and a link to another locale loads the document
+- `ssr.data` gets the full path as `pathname` (`/pt-BR/compare`), so data is keyed and cached per locale; routes, layouts and params match the unprefixed path
+- Every page gets `hreflang` alternates for each locale plus `x-default`; the sitemap lists each page once per locale
+- `unprefixedPaths: ['/portfolio', '/auth']`: pages that keep one URL for every locale (a PWA scope, a universal link, a payment return). `/portfolio` covers `/portfolio/...`, not `/portfolios`. A prefixed one (`/pt-BR/portfolio`) 301s to its bare URL; otherwise its locale comes from `?lang=`, the cookie or `Accept-Language`, as without `prefixPages`, and it may set the cookie, so don't let a CDN cache it. `Link` leaves them as written, they get no `hreflang`, and the sitemap lists them once. A link from a locale-prefixed page to one loads the document
+- `useRouter().routingPathname` is the path routes match (`/pt-BR/compare` → `/compare`): compare it, not `pathname`, to literals such as `'/'`
+
+#### One URL per page, the CDN picks the locale (`localeParam`)
+
+For pages shared as one link (a public profile), where `/pt-BR/...` URLs don't fit: a CDN reads the visitor's language and adds it as a query parameter that is part of its cache key, and the page renders in that locale.
+
+```ts
+i18n: { localeParam: '__locale' },
+```
+
+- The page's locale is that parameter (a content URL's segment still wins), else the default. The cookie, `Accept-Language` and `?lang=` are never read, nothing redirects and no cookie is set, so each response is a function of its URL and the CDN may cache it
+- The CDN adds the parameter to every request, `/__reroute_data` included (reroute reads it from the data request's own query). With Cloudflare, a URL Rewrite Transform Rule: when `starts_with(lower(http.request.headers["accept-language"][0]), "pt")`, set the query to `concat(http.request.uri.query, "&__locale=pt-BR")`
+- Without the CDN (local dev), pages render in the default locale; add `?__locale=pt-BR` to see another
+
 ### UI Strings
 
 ```tsx
@@ -719,6 +750,9 @@ export default defineConfig({
     localesDir: 'locales',               // catalog directory
     cookie: 'reroute-locale',
     redirectContentOnNegotiate: true,   // 302 default content → localized URL
+    prefixPages: false,                 // true: /pt-BR/compare, URL-only locale
+    unprefixedPaths: [],                // with prefixPages: paths never prefixed
+    localeParam: '',                    // '__locale': a CDN names the locale in the query
   },
 });
 ```

package/cli/bin.d.ts

@@ -1,5 +1,5 @@
 /**
- * reroute-js v1.0.0-alpha.39
+ * reroute-js v1.0.0-alpha.40
  *
  * @license MIT
  * @copyright 2026 stewones <hi@stewan.io>

package/cli/bin.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env bun
 // @bun
 /**
- * reroute-js v1.0.0-alpha.39
+ * reroute-js v1.0.0-alpha.40
  *
  * @license MIT
  * @copyright 2026 stewones <hi@stewan.io>
@@ -68,7 +68,7 @@ async function getVersionString() {
 }
 async function getVersion() {
   if (true) {
-    return "1.0.0-alpha.39";
+    return "1.0.0-alpha.40";
   }
   const possiblePaths = [
     path.join(import.meta.dir, "../../../../package.json"),
@@ -86,7 +86,7 @@ async function getVersion() {
 }
 async function getCommit() {
   if (true) {
-    return "f8c30d1";
+    return "90d5401";
   }
   return "dev";
 }
@@ -624,6 +624,9 @@ async function discoverI18n(cwd, options = {}) {
   const defaultLocale = options.defaultLocale ?? DEFAULT_LOCALE;
   const cookie = options.cookie ?? DEFAULT_COOKIE;
   const redirectContentOnNegotiate = options.redirectContentOnNegotiate ?? true;
+  const prefixPages = options.prefixPages ?? false;
+  const unprefixedPaths = options.unprefixedPaths ?? [];
+  const localeParam = options.localeParam ?? "";
   const absDir = join3(cwd, localesDir);
   const disabled = {
     enabled: false,
@@ -632,6 +635,9 @@ async function discoverI18n(cwd, options = {}) {
     localesDir,
     cookie,
     redirectContentOnNegotiate,
+    prefixPages,
+    unprefixedPaths,
+    localeParam,
     catalogs: {}
   };
   let catalogs;
@@ -655,6 +661,9 @@ async function discoverI18n(cwd, options = {}) {
     localesDir,
     cookie,
     redirectContentOnNegotiate,
+    prefixPages,
+    unprefixedPaths,
+    localeParam,
     catalogs
   };
 }
@@ -755,11 +764,15 @@ var exports_pathname = {};
 __export(exports_pathname, {
   contentKey: () => contentKey,
   hreflangTags: () => hreflangTags,
+  isUnprefixedPath: () => isUnprefixedPath,
   localizeContentHref: () => localizeContentHref,
   localizeHref: () => localizeHref,
+  localizePagePath: () => localizePagePath,
   looksLikeLocale: () => looksLikeLocale,
   normalizePathname: () => normalizePathname,
+  pageHreflangTags: () => pageHreflangTags,
   parseContentPath: () => parseContentPath,
+  parseLocalePrefix: () => parseLocalePrefix,
   toOgLocale: () => toOgLocale
 });
 function looksLikeLocale(segment) {
@@ -807,13 +820,36 @@ function localizeContentHref(collection, name, locale, defaultLocale) {
   }
   return `/${collection}/${locale}/${name}`;
 }
-function localizeHref(to, locale, defaultLocale, availableLocales = [], collections) {
+function parseLocalePrefix(pathname, availableLocales) {
+  const [, segment = "", ...rest] = normalizePathname(pathname).split("/");
+  const locale = availableLocales.find((l) => l.toLowerCase() === segment.toLowerCase());
+  if (!locale)
+    return;
+  return { locale, segment, routingPathname: `/${rest.join("/")}` };
+}
+function localizePagePath(pathname, locale, defaultLocale) {
+  if (locale === defaultLocale)
+    return pathname;
+  return pathname === "/" ? `/${locale}` : `/${locale}${pathname}`;
+}
+function isUnprefixedPath(pathname, unprefixedPaths = []) {
+  const path2 = normalizePathname(pathname);
+  return unprefixedPaths.some((prefix) => {
+    const base = prefix.replace(/\/+$/, "");
+    return base === "" || path2 === base || path2.startsWith(`${base}/`);
+  });
+}
+function localizeHref(to, locale, defaultLocale, availableLocales = [], collections, prefixPages) {
   try {
     const url = new URL(to, "http://local");
-    const parsed = parseContentPath(url.pathname, availableLocales, collections);
-    if (!parsed)
+    const parsed = parseContentPath(url.pathname, availableLocales, prefixPages ? collections ?? [] : collections);
+    if (parsed) {
+      url.pathname = localizeContentHref(parsed.collection, parsed.name, locale, defaultLocale);
+    } else if (prefixPages && to.startsWith("/") && url.origin === "http://local" && !/\.[^/]+$/.test(url.pathname) && !parseLocalePrefix(url.pathname, availableLocales) && !isUnprefixedPath(url.pathname, prefixPages.unprefixedPaths)) {
+      url.pathname = localizePagePath(url.pathname, locale, defaultLocale);
+    } else {
       return to;
-    url.pathname = localizeContentHref(parsed.collection, parsed.name, locale, defaultLocale);
+    }
     return `${url.pathname}${url.search}${url.hash}`;
   } catch {
     return to;
@@ -828,18 +864,20 @@ function contentKey(collection, name, locale, defaultLocale = "en-US") {
 function toOgLocale(locale) {
   return locale.replace(/-/g, "_");
 }
-function hreflangTags(baseUrl, collection, name, locales, defaultLocale) {
+function alternateLinks(baseUrl, locales, defaultLocale, pathFor) {
   const base = baseUrl.replace(/\/$/, "");
-  const tags = [];
-  for (const locale of locales) {
-    const path2 = localizeContentHref(collection, name, locale, defaultLocale);
-    tags.push(`<link rel="alternate" hreflang="${locale}" href="${base}${path2}" />`);
-  }
-  const defaultPath = localizeContentHref(collection, name, defaultLocale, defaultLocale);
-  tags.push(`<link rel="alternate" hreflang="x-default" href="${base}${defaultPath}" />`);
-  return tags.join(`
+  return [...locales, "x-default"].map((hreflang) => {
+    const path2 = pathFor(hreflang === "x-default" ? defaultLocale : hreflang);
+    return `<link rel="alternate" hreflang="${hreflang}" href="${base}${path2}" />`;
+  }).join(`
 `);
 }
+function hreflangTags(baseUrl, collection, name, locales, defaultLocale) {
+  return alternateLinks(baseUrl, locales, defaultLocale, (locale) => localizeContentHref(collection, name, locale, defaultLocale));
+}
+function pageHreflangTags(baseUrl, routingPathname, locales, defaultLocale) {
+  return alternateLinks(baseUrl, locales, defaultLocale, (locale) => localizePagePath(routingPathname, locale, defaultLocale));
+}
 var init_pathname = () => {};
 
 // packages/core/src/i18n/resolve.ts
@@ -863,7 +901,71 @@ function stripLangParam(search) {
   const rest = params.toString();
   return rest ? `?${rest}` : "";
 }
+function unprefix(pagePathname, search, defaultLocale) {
+  const query = search ? `?${search.replace(/^\?/, "")}` : "";
+  return {
+    locale: defaultLocale,
+    routingPathname: pagePathname,
+    fromPath: true,
+    fromQuery: false,
+    redirectTo: `${pagePathname}${query}`,
+    permanent: true,
+    urlOnly: true
+  };
+}
+function resolvePrefixedLocale(input) {
+  const prefix = parseLocalePrefix(input.pathname, input.availableLocales);
+  const pagePathname = prefix?.routingPathname ?? normalizePathname(input.pathname);
+  if (!isUnprefixedPath(pagePathname, input.unprefixedPaths)) {
+    return resolvePrefixedPage(input, prefix, pagePathname);
+  }
+  return prefix ? unprefix(pagePathname, input.search, input.defaultLocale) : resolveNegotiatedLocale(input);
+}
+function resolvePrefixedPage(input, prefix, pagePathname) {
+  const { search, availableLocales, defaultLocale } = input;
+  const isAvailable = (locale2) => !!locale2 && availableLocales.some((l) => l.toLowerCase() === locale2.toLowerCase());
+  const parsed = parseContentPath(pagePathname, availableLocales, input.collections ?? []);
+  const urlLocale = parsed?.locale ?? prefix?.locale ?? defaultLocale;
+  const queryLocale = parseLangParam(search, isAvailable, availableLocales);
+  const locale = queryLocale ?? urlLocale;
+  const misplaced = !!prefix && (!!parsed || prefix.locale === defaultLocale || prefix.segment !== prefix.locale);
+  const defaultSegment = !prefix && parsed?.locale === defaultLocale;
+  const canonical = parsed ? localizeContentHref(parsed.collection, parsed.name, locale, defaultLocale) : localizePagePath(pagePathname, locale, defaultLocale);
+  return {
+    locale,
+    routingPathname: parsed?.routingPathname ?? pagePathname,
+    fromPath: !!(parsed?.locale || prefix),
+    fromQuery: !!queryLocale,
+    redirectTo: queryLocale || misplaced || defaultSegment ? `${canonical}${stripLangParam(search)}` : undefined,
+    permanent: !queryLocale && (misplaced || defaultSegment),
+    urlOnly: true,
+    parsed: parsed ? { ...parsed, locale } : undefined
+  };
+}
+function resolveParamLocale(input, localeParam) {
+  const { pathname, search, availableLocales, defaultLocale } = input;
+  const parsed = parseContentPath(pathname, availableLocales, input.collections);
+  const named = new URLSearchParams(search ?? "").get(localeParam);
+  const param = named ? availableLocales.find((l) => l.toLowerCase() === named.toLowerCase()) : undefined;
+  const pathLocale = parsed?.locale && canonicalLocale(parsed.locale, availableLocales);
+  const locale = pathLocale || param || defaultLocale;
+  return {
+    locale,
+    routingPathname: parsed?.routingPathname ?? normalizePathname(pathname),
+    fromPath: !!pathLocale,
+    fromQuery: false,
+    urlOnly: true,
+    parsed: parsed ? { ...parsed, locale: pathLocale || undefined } : undefined
+  };
+}
 function resolveLocale(input) {
+  if (input.prefixPages)
+    return resolvePrefixedLocale(input);
+  if (input.localeParam)
+    return resolveParamLocale(input, input.localeParam);
+  return resolveNegotiatedLocale(input);
+}
+function resolveNegotiatedLocale(input) {
   const {
     pathname,
     search,
@@ -1754,7 +1856,9 @@ function matchRoutes(routes, pathname) {
 // packages/core/src/ssr/lib/content-path.ts
 var exports_content_path = {};
 __export(exports_content_path, {
-  resolveContentPathParts: () => resolveContentPathParts
+  pagePathname: () => pagePathname,
+  resolveContentPathParts: () => resolveContentPathParts,
+  routingPathname: () => routingPathname
 });
 function resolveContentPathParts(pathname) {
   const pathOnly = pathname.split("?")[0].split("#")[0];
@@ -1792,6 +1896,17 @@ function resolveContentPathParts(pathname) {
     routingPathname: `/${parts.join("/")}`
   };
 }
+function pagePathname(pathname) {
+  const pathOnly = pathname.split("?")[0].split("#")[0];
+  const i18n = globalThis.__REROUTE_I18N__;
+  if (!i18n?.prefixPages)
+    return pathOnly;
+  return parseLocalePrefix(pathOnly, i18n.locales || [])?.routingPathname ?? pathOnly;
+}
+function routingPathname(pathname) {
+  const page = pagePathname(pathname);
+  return resolveContentPathParts(page)?.routingPathname ?? page;
+}
 var init_content_path = __esm(() => {
   init_pathname();
 });
@@ -2034,7 +2149,7 @@ async function computeLayoutData(pathname, clientDir, _cwd, isWatchMode, options
   try {
     const layouts = routesModule?.layouts;
     const routes = routesModule?.routes;
-    const matchingLayouts = getMatchingLayouts(pathname, layouts, routes);
+    const matchingLayouts = getMatchingLayouts(routingPathname(pathname), layouts, routes);
     for (const layout of matchingLayouts) {
       try {
         const layoutStatus = await processLayout(layout, pathname, clientDir, isWatchMode, streaming, maxAgeMs, searchParams, ssrData, pendingTasks, options.headers);
@@ -2063,6 +2178,7 @@ function mergeLayoutData(ssrData, pathname) {
 }
 var init_layouts2 = __esm(() => {
   init_cache();
+  init_content_path();
   init_imports();
   init_layouts();
 });
@@ -2107,9 +2223,7 @@ async function computeRouteData(pathname, clientDir, _cwd, isWatchMode, options,
     }).catch(() => {}));
   };
   try {
-    const resolved = resolveContentPathParts(pathname);
-    const pathnameOnly = (resolved?.routingPathname || pathname).split("?")[0];
-    const match = typeof routesModule?.matchRoute === "function" ? routesModule.matchRoute(pathnameOnly) : null;
+    const match = typeof routesModule?.matchRoute === "function" ? routesModule.matchRoute(routingPathname(pathname)) : null;
     const route = match?.route;
     const params = match?.params || {};
     if (!route || typeof route.path !== "string") {
@@ -3105,9 +3219,8 @@ async function extractPageMetadata(pathname, clientDir, cwd, isWatchMode, curren
   let perPageHead = "";
   let pageLang;
   let statusOverride = currentStatusOverride;
-  const resolved = resolveContentPathParts(pathname);
-  const routingPathname = resolved?.routingPathname || pathname;
-  await extractLayoutMetadata(routingPathname, clientDir, cwd, isWatchMode, (head) => {
+  const routingPathname2 = routingPathname(pathname);
+  await extractLayoutMetadata(routingPathname2, pathname, clientDir, cwd, isWatchMode, (head) => {
     perPageHead += head;
   }, (lang) => {
     if (!pageLang)
@@ -3143,11 +3256,14 @@ ${ogMetaTags}`;
   }, (lang) => {
     pageLang = lang;
   }, ogConfig, titleSuffix, baseUrl);
-  const routeResult = await extractRouteMetadata(pathname, clientDir, cwd, isWatchMode, statusOverride, ssrData, ogConfig, titleSuffix, routingPathname);
+  const routeResult = await extractRouteMetadata(pathname, clientDir, cwd, isWatchMode, statusOverride, ssrData, ogConfig, titleSuffix, routingPathname2);
   perPageHead += routeResult.head;
   if (routeResult.lang)
     pageLang = routeResult.lang;
   statusOverride = routeResult.statusOverride;
+  if (baseUrl && !(statusOverride && statusOverride >= 400)) {
+    perPageHead += pageI18nHead(baseUrl, pathname);
+  }
   return {
     perPageHead,
     pageLang,
@@ -3155,7 +3271,7 @@ ${ogMetaTags}`;
     ssrExport: routeResult.ssrExport
   };
 }
-async function processLayoutForMetadata(layout, clientDir, isWatchMode, addHead, setLang, ogConfig, titleSuffix) {
+async function processLayoutForMetadata(layout, requestPathname, clientDir, isWatchMode, addHead, setLang, ogConfig, titleSuffix) {
   if (typeof layout?.path !== "string")
     return;
   try {
@@ -3164,7 +3280,7 @@ async function processLayoutForMetadata(layout, clientDir, isWatchMode, addHead,
     if (meta)
       addHead(buildHeadFromMeta(meta, ogConfig, titleSuffix));
     if (ssr) {
-      const ssrHead = extractSSRHead(ssr, undefined, ogConfig, undefined, meta, titleSuffix);
+      const ssrHead = extractSSRHead(ssr, requestPathname, undefined, ogConfig, undefined, meta, titleSuffix);
       if (ssrHead)
         addHead(`
 ${ssrHead}`);
@@ -3174,15 +3290,36 @@ ${ssrHead}`);
     }
   } catch {}
 }
-async function extractLayoutMetadata(pathname, clientDir, cwd, isWatchMode, addHead, setLang, ogConfig, titleSuffix) {
+async function extractLayoutMetadata(pathname, requestPathname, clientDir, cwd, isWatchMode, addHead, setLang, ogConfig, titleSuffix) {
   try {
     const m = await loadRoutesModule(cwd, isWatchMode);
     const matchingLayouts = getMatchingLayouts(pathname, m?.layouts, m?.routes);
     for (const layout of matchingLayouts) {
-      await processLayoutForMetadata(layout, clientDir, isWatchMode, addHead, setLang, ogConfig, titleSuffix);
+      await processLayoutForMetadata(layout, requestPathname, clientDir, isWatchMode, addHead, setLang, ogConfig, titleSuffix);
     }
   } catch {}
 }
+function readI18n() {
+  return globalThis.__REROUTE_I18N__;
+}
+function isContentUrl(i18n, collection) {
+  return !i18n.prefixPages || !!i18n.collections?.includes(collection);
+}
+function pageI18nHead(baseUrl, pathname) {
+  const i18n = readI18n();
+  if (!(i18n?.enabled && i18n.prefixPages && i18n.locales))
+    return "";
+  if (i18n.locales.length < 2)
+    return "";
+  const resolved = resolveContentPathParts(pathname);
+  if (resolved && isContentUrl(i18n, resolved.collection))
+    return "";
+  const page = pagePathname(pathname);
+  if (isUnprefixedPath(page, i18n.unprefixedPaths))
+    return "";
+  return `
+${pageHreflangTags(baseUrl, page, i18n.locales, i18n.defaultLocale || "en-US")}`;
+}
 function resolveContentLocales(collection, name, fallbackLocales) {
   const g = globalThis;
   const byCollection = g.__REROUTE_COLLECTIONS__;
@@ -3222,15 +3359,15 @@ function extractContentMetadata(pathname, addHead, setLang, ogConfig, titleSuffi
     const meta = exp?.meta;
     const ssr = exp?.ssr;
     addHead(buildHeadFromMeta(meta, ogConfig, titleSuffix));
-    const ssrHead = extractSSRHead(ssr, undefined, ogConfig, undefined, meta, titleSuffix);
+    const ssrHead = extractSSRHead(ssr, pathname, undefined, ogConfig, undefined, meta, titleSuffix);
     if (ssrHead)
       addHead(`
 ${ssrHead}`);
     const lang = extractSSRLang(ssr);
     if (lang)
       setLang(lang);
-    const i18n = g.__REROUTE_I18N__;
-    if (i18n?.enabled && baseUrl && i18n.locales && i18n.locales.length > 1) {
+    const i18n = readI18n();
+    if (i18n?.enabled && baseUrl && i18n.locales && i18n.locales.length > 1 && isContentUrl(i18n, resolved.collection)) {
       const locales = resolveContentLocales(resolved.collection, resolved.name, i18n.locales);
       addContentI18nHead(addHead, baseUrl, resolved.collection, resolved.name, locales, i18n.defaultLocale || "en-US", i18n.locale || i18n.defaultLocale || "en-US");
     }
@@ -3256,9 +3393,9 @@ function getContentMetaFromExports(pathname) {
     return;
   }
 }
-async function extractMatchedRouteMetadata(pathname, clientDir, m, isWatchMode, statusOverride, ssrData, ogConfig, titleSuffix, routingPathname) {
+async function extractMatchedRouteMetadata(pathname, clientDir, m, isWatchMode, statusOverride, ssrData, ogConfig, titleSuffix, routingPathname2) {
   const pathnameOnly = pathname.split("?")[0];
-  const matchPath = (routingPathname || pathname).split("?")[0];
+  const matchPath = (routingPathname2 || pathname).split("?")[0];
   const match = typeof m.matchRoute === "function" ? m.matchRoute(matchPath) : null;
   const r = match?.route;
   if (!r) {
@@ -3283,7 +3420,7 @@ async function extractMatchedRouteMetadata(pathname, clientDir, m, isWatchMode,
         }
         const contentMeta = getContentMetaFromExports(pathnameOnly);
         const headMeta = contentMeta || meta;
-        const ssrHead = extractSSRHead(ssr, routeData, ogConfig, head, headMeta, titleSuffix);
+        const ssrHead = extractSSRHead(ssr, pathname, routeData, ogConfig, head, headMeta, titleSuffix);
         if (ssrHead)
           head += `
 ${ssrHead}`;
@@ -3299,7 +3436,7 @@ ${ssrHead}`;
   }
   return { head: "", statusOverride };
 }
-async function extractRouteMetadata(pathname, clientDir, cwd, isWatchMode, currentStatusOverride, ssrData, ogConfig, titleSuffix, routingPathname) {
+async function extractRouteMetadata(pathname, clientDir, cwd, isWatchMode, currentStatusOverride, ssrData, ogConfig, titleSuffix, routingPathname2) {
   let head = "";
   let lang;
   let statusOverride = currentStatusOverride;
@@ -3309,14 +3446,14 @@ async function extractRouteMetadata(pathname, clientDir, cwd, isWatchMode, curre
     if (!m) {
       return { head, lang, statusOverride: statusOverride || 404 };
     }
-    const matchPath = (routingPathname || pathname).split("?")[0];
+    const matchPath = (routingPathname2 || pathname).split("?")[0];
     const match = typeof m.matchRoute === "function" ? m.matchRoute(matchPath) : null;
     const r = match?.route;
     if (!r) {
       statusOverride = statusOverride || 404;
     }
     if (r && typeof r.path === "string") {
-      const result = await extractMatchedRouteMetadata(pathname, clientDir, m, isWatchMode, statusOverride, ssrData, ogConfig, titleSuffix, routingPathname);
+      const result = await extractMatchedRouteMetadata(pathname, clientDir, m, isWatchMode, statusOverride, ssrData, ogConfig, titleSuffix, routingPathname2);
       head = result.head;
       lang = result.lang;
       statusOverride = result.statusOverride;
@@ -3356,7 +3493,7 @@ async function extractNotFoundMetadata(pathname, clientDir, routesModule, isWatc
       const { meta, ssr } = await loadModuleMetaAndSSR(chosen, abs, isWatchMode);
       if (meta)
         head += buildHeadFromMeta(meta, ogConfig, titleSuffix);
-      const ssrHead = extractSSRHead(ssr, undefined, ogConfig, undefined, meta, titleSuffix);
+      const ssrHead = extractSSRHead(ssr, pathname, undefined, ogConfig, undefined, meta, titleSuffix);
       if (ssrHead)
         head += `
 ${ssrHead}`;
@@ -3419,13 +3556,17 @@ function generateMissingOGTags(head, ogConfig) {
 ${additionalTags.join(`
 `)}` : "";
 }
-function extractSSRHead(ssr, data, ogConfig, existingHead, meta, titleSuffix) {
+function extractSSRHead(ssr, pathname, data, ogConfig, existingHead, meta, titleSuffix) {
   if (!ssr)
     return "";
   let headContent = "";
   if (typeof ssr.head === "function") {
     try {
-      const result = ssr.head({ data, meta });
+      const result = ssr.head({
+        pathname,
+        data,
+        meta
+      });
       if (typeof result === "string")
         headContent = result;
       else if (Array.isArray(result))
@@ -6557,18 +6698,43 @@ function createStaticEntry(route, baseUrl, defaultChangefreq, defaultPriority) {
     priority: route.priority !== undefined ? route.priority : loc === "/" ? 1 : defaultPriority
   };
 }
-function collectAllEntries(discovery4, baseUrl, changefreq, priority, excludeRoutes) {
+function localizePageEntry(entry, baseUrl, i18n) {
+  const base = baseUrl.replace(/\/$/, "");
+  if (!(i18n && entry.loc.startsWith(base)))
+    return [entry];
+  const path3 = entry.loc.slice(base.length) || "/";
+  if (parseContentPath(path3, i18n.locales, i18n.collections))
+    return [entry];
+  if (isUnprefixedPath(path3, i18n.unprefixedPaths))
+    return [entry];
+  const { locales, defaultLocale } = i18n;
+  const urlFor = (locale) => `${base}${localizePagePath(path3, locale, defaultLocale)}`;
+  const alternates = [
+    ...locales.map((locale) => ({ hreflang: locale, href: urlFor(locale) })),
+    { hreflang: "x-default", href: urlFor(defaultLocale) }
+  ];
+  return locales.map((locale) => ({
+    ...entry,
+    loc: urlFor(locale),
+    alternates
+  }));
+}
+function collectAllEntries(discovery4, baseUrl, changefreq, priority, excludeRoutes, i18n) {
   const allEntries = [];
+  const addPage = (entry) => {
+    allEntries.push(...localizePageEntry(entry, baseUrl, i18n));
+  };
   for (const route of discovery4.staticRoutes) {
     if (shouldIncludeRoute(route.pattern, excludeRoutes)) {
-      allEntries.push(createStaticEntry(route, baseUrl, changefreq, priority));
+      addPage(createStaticEntry(route, baseUrl, changefreq, priority));
     }
   }
   for (const [_collection, entries] of discovery4.collections.entries()) {
     allEntries.push(...entries);
   }
   for (const [_pattern, entries] of discovery4.ssrDataRoutes.entries()) {
-    allEntries.push(...entries);
+    for (const entry of entries)
+      addPage(entry);
   }
   return allEntries;
 }
@@ -6614,7 +6780,7 @@ async function generateSitemap(discovery4, baseUrl, options = {}) {
     priority = 0.5,
     maxUrlsPerPage = DEFAULT_MAX_URLS
   } = options;
-  const allEntries = collectAllEntries(discovery4, baseUrl, changefreq, priority, options.excludeRoutes);
+  const allEntries = collectAllEntries(discovery4, baseUrl, changefreq, priority, options.excludeRoutes, options.i18n);
   sortEntries(allEntries);
   const needsIndex = allEntries.length > maxUrlsPerPage;
   if (needsIndex) {
@@ -6674,7 +6840,9 @@ function escapeXml2(unsafe) {
   return unsafe.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&apos;");
 }
 var DEFAULT_MAX_URLS = 50000;
-var init_generator2 = () => {};
+var init_generator2 = __esm(() => {
+  init_pathname();
+});
 
 // packages/core/src/sitemap/index.ts
 var init_sitemap = __esm(() => {
@@ -6944,7 +7112,10 @@ function generateMetaUpdateScript(ctx, ssrDataSnapshot) {
   }
   let headResult;
   try {
-    headResult = ctx.ssrExport.head({ data: routeData });
+    headResult = ctx.ssrExport.head({
+      pathname: ctx.pathname,
+      data: routeData
+    });
   } catch (err) {
     console.error("[reroute] Error calling ssr.head() at stream end:", err);
     return "";
@@ -7164,6 +7335,7 @@ __export(exports_core, {
   inlineThemeCSS: () => inlineThemeCSS,
   isCompressible: () => isCompressible,
   isThenable: () => isThenable,
+  isUnprefixedPath: () => isUnprefixedPath,
   join: () => join2,
   layoutCovers: () => layoutCovers,
   layoutWraps: () => layoutWraps,
@@ -7176,6 +7348,7 @@ __export(exports_core, {
   loadRoutesModule: () => loadRoutesModule,
   localizeContentHref: () => localizeContentHref,
   localizeHref: () => localizeHref,
+  localizePagePath: () => localizePagePath,
   looksLikeLocale: () => looksLikeLocale,
   lookupMessage: () => lookupMessage,
   markPageHead: () => markPageHead,
@@ -7186,8 +7359,10 @@ __export(exports_core, {
   mergeVary: () => mergeVary,
   negotiateLocale: () => negotiateLocale,
   normalizePathname: () => normalizePathname,
+  pageHreflangTags: () => pageHreflangTags,
   parseContentPath: () => parseContentPath,
   parseCookieValue: () => parseCookieValue,
+  parseLocalePrefix: () => parseLocalePrefix,
   performSSRSetup: () => performSSRSetup,
   preloadContentModule: () => preloadContentModule,
   processCollections: () => processCollections,
@@ -9822,6 +9997,9 @@ async function generate(cwd, args = [], options = {}) {
       locales: i18n2.locales,
       cookie: i18n2.cookie,
       redirectContentOnNegotiate: i18n2.redirectContentOnNegotiate,
+      prefixPages: i18n2.prefixPages,
+      unprefixedPaths: i18n2.unprefixedPaths,
+      localeParam: i18n2.localeParam,
       catalogs: i18n2.catalogs
     }, null, 2));
     if (i18n2.enabled && !showPerformance) {
@@ -10306,6 +10484,9 @@ async function startGenWatch(cwd, args) {
               locales: watchI18n.locales,
               cookie: watchI18n.cookie,
               redirectContentOnNegotiate: watchI18n.redirectContentOnNegotiate,
+              prefixPages: watchI18n.prefixPages,
+              unprefixedPaths: watchI18n.unprefixedPaths,
+              localeParam: watchI18n.localeParam,
               catalogs: watchI18n.catalogs
             }, null, 2));
             await buildContentChunks(cwd, args, watchI18n.defaultLocale, watchPaths.routesDir);
@@ -108844,7 +109025,7 @@ async function getVersionString2() {
 }
 async function getVersion2() {
   if (true) {
-    return "1.0.0-alpha.39";
+    return "1.0.0-alpha.40";
   }
   const possiblePaths = [
     path3.join(import.meta.dir, "../../../package.json"),
@@ -108861,10 +109042,10 @@ async function getVersion2() {
 }
 async function getCommit2() {
   if (true) {
-    return "f8c30d1";
+    return "90d5401";
   }
   return "dev";
 }
 main();
 
-//# debugId=9CD3B704ACE54A9D64756E2164756E21
+//# debugId=4DCB742915D0BED964756E2164756E21