reroute-js 1.0.0-alpha.6 → 1.0.0-alpha.7

package/core/src/ssr/lib/seed.d.ts

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

package/core/src/ssr/lib/serialize.d.ts

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

package/core/src/ssr/lib/setup.d.ts

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

package/core/src/ssr/lib/styles.d.ts

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

package/core/src/ssr/lib/template.d.ts

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

package/core/src/ssr/lib/types.d.ts

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

package/core/src/ssr/render.d.ts

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

package/core/src/ssr/stream.d.ts

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

package/elysia/index.d.ts

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

package/elysia/index.js

@@ -1,5 +1,5 @@
 /**
- * reroute-js v1.0.0-alpha.6
+ * reroute-js v1.0.0-alpha.7
  *
  * @license MIT
  * @copyright 2026 stewones <hi@stewan.io>
@@ -480,9 +480,30 @@ function hreflangTags(baseUrl, collection, name, locales, defaultLocale) {
 var init_pathname = () => {};
 
 // packages/core/src/i18n/resolve.ts
+function canonicalLocale(value, availableLocales) {
+  return availableLocales.find((l) => l.toLowerCase() === value.toLowerCase()) || value;
+}
+function parseLangParam(search, isAvailable, availableLocales) {
+  if (!search)
+    return;
+  const params = new URLSearchParams(search.startsWith("?") ? search.slice(1) : search);
+  const raw = params.get("lang") ?? undefined;
+  if (!isAvailable(raw))
+    return;
+  return canonicalLocale(raw, availableLocales);
+}
+function stripLangParam(search) {
+  if (!search)
+    return "";
+  const params = new URLSearchParams(search.startsWith("?") ? search.slice(1) : search);
+  params.delete("lang");
+  const rest = params.toString();
+  return rest ? `?${rest}` : "";
+}
 function resolveLocale(input) {
   const {
     pathname,
+    search,
     cookieHeader,
     acceptLanguage,
     availableLocales,
@@ -493,14 +514,32 @@ function resolveLocale(input) {
   const parsed = parseContentPath(pathname, availableLocales, collections);
   const availableLower = new Set(availableLocales.map((l) => l.toLowerCase()));
   const isAvailable = (locale) => !!locale && availableLower.has(locale.toLowerCase());
+  const routingPathname = parsed?.routingPathname ?? pathname.split("?")[0];
+  const restSearch = stripLangParam(search);
+  const queryLocale = parseLangParam(search, isAvailable, availableLocales);
+  if (queryLocale) {
+    const target = parsed ? localizeContentHref(parsed.collection, parsed.name, queryLocale, defaultLocale) : routingPathname;
+    return {
+      locale: queryLocale,
+      routingPathname,
+      fromPath: false,
+      fromQuery: true,
+      redirectTo: `${target}${restSearch}`,
+      parsed: parsed ? {
+        ...parsed,
+        locale: queryLocale === defaultLocale ? undefined : queryLocale
+      } : undefined
+    };
+  }
   if (parsed?.locale && isAvailable(parsed.locale)) {
-    const locale = availableLocales.find((l) => l.toLowerCase() === parsed.locale?.toLowerCase()) || parsed.locale;
+    const locale = canonicalLocale(parsed.locale, availableLocales);
     if (locale === defaultLocale && parsed.pathname !== parsed.routingPathname) {
       return {
         locale,
         routingPathname: parsed.routingPathname,
         fromPath: true,
-        redirectTo: parsed.routingPathname,
+        fromQuery: false,
+        redirectTo: `${parsed.routingPathname}${restSearch}`,
         parsed: { ...parsed, locale }
       };
     }
@@ -508,17 +547,18 @@ function resolveLocale(input) {
       locale,
       routingPathname: parsed.routingPathname,
       fromPath: true,
+      fromQuery: false,
       parsed: { ...parsed, locale }
     };
   }
-  const routingPathname = parsed?.routingPathname ?? pathname.split("?")[0];
   const cookieLocale = parseCookieValue(cookieHeader, cookieName);
   if (isAvailable(cookieLocale)) {
-    const locale = availableLocales.find((l) => l.toLowerCase() === cookieLocale.toLowerCase()) || cookieLocale;
+    const locale = canonicalLocale(cookieLocale, availableLocales);
     return {
       locale,
       routingPathname,
       fromPath: false,
+      fromQuery: false,
       parsed: parsed ? { ...parsed, locale: undefined } : undefined
     };
   }
@@ -527,13 +567,14 @@ function resolveLocale(input) {
     locale: negotiated,
     routingPathname,
     fromPath: false,
+    fromQuery: false,
     parsed: parsed ? { ...parsed, locale: undefined } : undefined
   };
 }
 function contentNegotiateRedirect(resolution, defaultLocale, enabled) {
   if (!enabled)
     return;
-  if (resolution.fromPath)
+  if (resolution.fromPath || resolution.fromQuery)
     return;
   if (resolution.locale === defaultLocale)
     return;
@@ -4164,6 +4205,25 @@ __export(exports_index_generator, {
   generateLLMsIndex: () => generateLLMsIndex
 });
 import { pathToFileURL as pathToFileURL6 } from "node:url";
+function oneLine(value) {
+  return value.replace(/\s+/g, " ").trim();
+}
+function stringField(record, key) {
+  const value = record?.[key];
+  if (typeof value !== "string")
+    return;
+  const trimmed = oneLine(value);
+  return trimmed.length > 0 ? trimmed : undefined;
+}
+function metaFromUnknown(meta) {
+  if (!meta || typeof meta !== "object")
+    return {};
+  const record = meta;
+  return {
+    title: stringField(record, "title") ?? stringField(record, "name"),
+    description: stringField(record, "description") ?? stringField(record, "excerpt")
+  };
+}
 async function discoverStaticRoutes(cwd, isWatchMode) {
   const routes = [];
   try {
@@ -4180,8 +4240,11 @@ async function discoverStaticRoutes(cwd, isWatchMode) {
         if (pattern.includes("[404]") || pattern.includes("[layout]") || pattern.includes("[skeleton]") || pattern.includes(":")) {
           continue;
         }
+        const { title, description } = metaFromUnknown(route?.meta);
         routes.push({
-          path: pattern
+          path: pattern,
+          title,
+          description
         });
       }
     }
@@ -4204,11 +4267,13 @@ function createRouteEntriesFromItems(items, collection) {
   for (const item of items) {
     const href = String(item.href || "");
     if (href) {
-      const title = item.meta?.title || item.meta?.name || item.name;
+      const fromMeta = metaFromUnknown(item.meta);
+      const title = fromMeta.title || (typeof item.name === "string" ? item.name : undefined);
       routes.push({
         path: href,
         section: collection,
-        title
+        title,
+        description: fromMeta.description
       });
     }
   }
@@ -4274,9 +4339,13 @@ function createEntriesFromArray(array, routePath) {
       continue;
     const identifier = extractIdentifier(item);
     if (identifier) {
+      const fromItem = metaFromUnknown(item);
+      const fromMeta = metaFromUnknown(item.meta);
       entries.push({
         path: `${routePath}/${identifier}`,
-        section: routePath.split("/").filter(Boolean)[0]
+        section: routePath.split("/").filter(Boolean)[0],
+        title: fromItem.title ?? fromMeta.title,
+        description: fromItem.description ?? fromMeta.description
       });
     }
   }
@@ -4382,13 +4451,21 @@ function formatRouteUrl(routePath, baseUrl) {
 function getRouteTitle(route) {
   return route.title || (route.path === "/" ? "Home" : route.path.split("/").pop() || "Page");
 }
-function addRootRoutes(parts, rootRoutes, baseUrl, isScoped) {
+function formatIndexLine(route, url, summaries) {
+  const link = `- [${getRouteTitle(route)}](${url})`;
+  if (!(summaries && route.description))
+    return link;
+  return `${link}: ${route.description}`;
+}
+function summariesEnabled(llmsConfig) {
+  return llmsConfig?.indexSummaries !== false;
+}
+function addRootRoutes(parts, rootRoutes, baseUrl, isScoped, llmsConfig) {
   if (isScoped || rootRoutes.length === 0)
     return;
+  const summaries = summariesEnabled(llmsConfig);
   for (const route of rootRoutes) {
-    const title = getRouteTitle(route);
-    const url = formatRouteUrl(route.path, baseUrl);
-    parts.push(`- [${title}](${url})`);
+    parts.push(formatIndexLine(route, formatRouteUrl(route.path, baseUrl), summaries));
   }
   parts.push("");
 }
@@ -4399,10 +4476,9 @@ function addCollectionSection(parts, collection, routes, baseUrl, llmsConfig) {
   const sectionName = collection.charAt(0).toUpperCase() + collection.slice(1);
   parts.push(`## ${sectionName}`);
   parts.push("");
+  const summaries = summariesEnabled(llmsConfig);
   for (const route of filteredRoutes) {
-    const title = route.title || route.path.split("/").pop() || "Untitled";
-    const url = `${baseUrl}${route.path}.txt`;
-    parts.push(`- [${title}](${url})`);
+    parts.push(formatIndexLine(route, `${baseUrl}${route.path}.txt`, summaries));
   }
   parts.push("");
 }
@@ -4420,10 +4496,9 @@ function addSSRDataSection(parts, routePattern, routes, baseUrl, isScoped, targe
   const sectionName = routeSection?.charAt(0).toUpperCase() + routeSection?.slice(1) || "Content";
   parts.push(`## ${sectionName}`);
   parts.push("");
+  const summaries = summariesEnabled(llmsConfig);
   for (const route of filteredRoutes) {
-    const title = route.title || route.path.split("/").pop() || "Untitled";
-    const url = `${baseUrl}${route.path}.txt`;
-    parts.push(`- [${title}](${url})`);
+    parts.push(formatIndexLine(route, `${baseUrl}${route.path}.txt`, summaries));
   }
   parts.push("");
 }
@@ -4437,10 +4512,9 @@ function addStaticSection(parts, section, routes, baseUrl, isScoped, targetColle
   const sectionName = section.charAt(0).toUpperCase() + section.slice(1);
   parts.push(`## ${sectionName}`);
   parts.push("");
+  const summaries = summariesEnabled(llmsConfig);
   for (const route of filteredRoutes) {
-    const title = route.title || route.path.split("/").pop() || "Untitled";
-    const url = `${baseUrl}${route.path}.txt`;
-    parts.push(`- [${title}](${url})`);
+    parts.push(formatIndexLine(route, `${baseUrl}${route.path}.txt`, summaries));
   }
   parts.push("");
 }
@@ -4454,7 +4528,7 @@ async function generateLLMsIndex(options) {
   const collectionsMap = await discoverCollectionRoutes(cwd, collections2, isWatchMode, llmsConfig);
   const ssrDataRoutes = await discoverSSRDataRoutes(cwd, staticRoutes, isWatchMode);
   const { sections, rootRoutes } = groupStaticRoutes(staticRoutes, llmsConfig);
-  addRootRoutes(parts, rootRoutes, baseUrl, isScoped);
+  addRootRoutes(parts, rootRoutes, baseUrl, isScoped, llmsConfig);
   for (const [collection, routes] of collectionsMap.entries()) {
     if (routes.length > 0) {
       addCollectionSection(parts, collection, routes, baseUrl, llmsConfig);
@@ -4473,9 +4547,6 @@ async function generateLLMsIndex(options) {
   parts.push("---");
   parts.push("");
   parts.push("Formats: .txt | .md | Accept: text/plain | Accept: text/markdown");
-  if (!isScoped && baseUrl) {
-    parts.push(`Full dump: ${baseUrl}/llms-full.txt`);
-  }
   return parts.join(`
 `);
 }
@@ -8909,7 +8980,7 @@ async function listContentCollections(cwd) {
     return [];
   }
 }
-async function resolveI18nForRequest(cwd, pathname, headers2, collections2) {
+async function resolveI18nForRequest(cwd, pathname, headers2, collections2, search) {
   const i18n2 = await loadI18nState(cwd);
   const disabled = {
     enabled: false,
@@ -8926,6 +8997,7 @@ async function resolveI18nForRequest(cwd, pathname, headers2, collections2) {
   const knownCollections = collections2?.length ? collections2 : await listContentCollections(cwd);
   const resolution = resolveLocale({
     pathname,
+    search,
     cookieHeader: headers2.cookie,
     acceptLanguage: headers2["accept-language"],
     availableLocales: i18n2.locales,
@@ -8986,9 +9058,10 @@ function isOtelAvailable3() {
     return false;
   }
 }
-async function applyI18nForSSR(cwd, pathname, headers2, set, fallbackLang) {
-  const i18nResult = await resolveI18nForRequest(cwd, pathname, headers2);
-  if (i18nResult.redirectTo && i18nResult.redirectTo !== pathname) {
+async function applyI18nForSSR(cwd, pathname, headers2, set, fallbackLang, search = "") {
+  const i18nResult = await resolveI18nForRequest(cwd, pathname, headers2, undefined, search);
+  const current = `${pathname}${search}`;
+  if (i18nResult.redirectTo && i18nResult.redirectTo !== current) {
     const redirectHeaders = {
       Location: i18nResult.redirectTo
     };
@@ -9083,7 +9156,7 @@ function registerSSRRoutes(app, options) {
     request.headers.forEach((value, key) => {
       headers2[key.toLowerCase()] = value;
     });
-    const i18n2 = await applyI18nForSSR(cwd, pathname, headers2, set, lang);
+    const i18n2 = await applyI18nForSSR(cwd, pathname, headers2, set, lang, url.search);
     if (i18n2.redirect)
       return i18n2.redirect;
     const parentSpan = store.telemetrySpan;
@@ -9963,4 +10036,4 @@ export {
   reroute
 };
 
-//# debugId=0148350251EC358E64756E2164756E21
+//# debugId=40A8A1EA3D8ED46164756E2164756E21