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

package/README.md

@@ -670,7 +670,9 @@ src/client/routes/blog/content/
 - Flat files under `content/` are the default locale; nest under `content/{locale}/` for translations
 - Collections without locale folders behave as before
 - Default-locale prefix (`/blog/en-US/...`) 302s to the unprefixed URL
-- Optional negotiate: `Accept-Language` / cookie can 302 default content URLs to a localized path (`i18n.redirectContentOnNegotiate`, default `true`)
+- A locale segment in the URL always wins over cookie / `Accept-Language`
+- `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`)
 
 ### UI Strings
 
@@ -1165,8 +1167,8 @@ export default defineConfig({
 Your site now supports:
 - `.txt` and `.md` extensions on any route (e.g., `/blog/post.txt`, `/about.md`)
 - Accept header content negotiation (`Accept: text/plain`, `Accept: text/markdown`)
-- `/llms.txt` - Index of all content organized by section
-- `/llms-full.txt` - Complete site content in one file
+- `/llms.txt` - Index of all content: title, description, and link per page
+- `/llms-full.txt` - Complete site content in one file (optional; large)
 
 #### How It Works
 

package/cli/bin.d.ts

@@ -1,5 +1,5 @@
 /**
- * reroute-js v1.0.0-alpha.5
+ * reroute-js v1.0.0-alpha.7
  *
  * @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.5
+ * reroute-js v1.0.0-alpha.7
  *
  * @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.5";
+    return "1.0.0-alpha.7";
   }
   const possiblePaths = [
     path.join(import.meta.dir, "../../../../package.json"),
@@ -86,7 +86,7 @@ async function getVersion() {
 }
 async function getCommit() {
   if (true) {
-    return "403cf32";
+    return "19dcaf7";
   }
   return "dev";
 }
@@ -818,9 +818,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,
@@ -831,14 +852,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 }
       };
     }
@@ -846,17 +885,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
     };
   }
@@ -865,13 +905,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;
@@ -4502,6 +4543,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 {
@@ -4518,8 +4578,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
         });
       }
     }
@@ -4542,11 +4605,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
       });
     }
   }
@@ -4612,9 +4677,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
       });
     }
   }
@@ -4720,13 +4789,21 @@ function formatRouteUrl(routePath, baseUrl) {
 function getRouteTitle(route) {
   return route.title || (route.path === "/" ? "Home" : route.path.split("/").pop() || "Page");
 }
-function addRootRoutes(parts, rootRoutes, baseUrl, isSingleCollection) {
-  if (isSingleCollection || rootRoutes.length === 0)
+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("");
 }
@@ -4737,19 +4814,18 @@ 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("");
 }
-function shouldIncludeSection(section, isSingleCollection, targetCollection) {
-  return !isSingleCollection || section === targetCollection;
+function shouldIncludeSection(section, isScoped, targetCollection) {
+  return !isScoped || section === targetCollection;
 }
-function addSSRDataSection(parts, routePattern, routes, baseUrl, isSingleCollection, targetCollection, llmsConfig) {
+function addSSRDataSection(parts, routePattern, routes, baseUrl, isScoped, targetCollection, llmsConfig) {
   const routeSection = routePattern.split("/").filter(Boolean)[0];
-  if (!shouldIncludeSection(routeSection, isSingleCollection, targetCollection)) {
+  if (!shouldIncludeSection(routeSection, isScoped, targetCollection)) {
     return;
   }
   const filteredRoutes = routes.filter((r) => !shouldExcludeRoute(r.path, llmsConfig?.excludeRoutes));
@@ -4758,15 +4834,14 @@ function addSSRDataSection(parts, routePattern, routes, baseUrl, isSingleCollect
   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("");
 }
-function addStaticSection(parts, section, routes, baseUrl, isSingleCollection, targetCollection, collectionsMap, llmsConfig) {
-  if (!shouldIncludeSection(section, isSingleCollection, targetCollection)) {
+function addStaticSection(parts, section, routes, baseUrl, isScoped, targetCollection, collectionsMap, llmsConfig) {
+  if (!shouldIncludeSection(section, isScoped, targetCollection)) {
     return;
   }
   const filteredRoutes = routes.filter((r) => !shouldExcludeRoute(r.path, llmsConfig?.excludeRoutes));
@@ -4775,24 +4850,23 @@ function addStaticSection(parts, section, routes, baseUrl, isSingleCollection, t
   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("");
 }
 async function generateLLMsIndex(options) {
   const { cwd, collections: collections2, baseUrl, isWatchMode, llmsConfig } = options;
+  const targetCollection = options.targetCollection ?? null;
+  const isScoped = targetCollection !== null;
   const parts = [];
   addIndexHeader(parts, llmsConfig);
   const staticRoutes = await discoverStaticRoutes(cwd, isWatchMode);
   const collectionsMap = await discoverCollectionRoutes(cwd, collections2, isWatchMode, llmsConfig);
   const ssrDataRoutes = await discoverSSRDataRoutes(cwd, staticRoutes, isWatchMode);
-  const isSingleCollection = collections2.length === 1;
-  const targetCollection = isSingleCollection ? collections2[0] : null;
   const { sections, rootRoutes } = groupStaticRoutes(staticRoutes, llmsConfig);
-  addRootRoutes(parts, rootRoutes, baseUrl, isSingleCollection);
+  addRootRoutes(parts, rootRoutes, baseUrl, isScoped, llmsConfig);
   for (const [collection, routes] of collectionsMap.entries()) {
     if (routes.length > 0) {
       addCollectionSection(parts, collection, routes, baseUrl, llmsConfig);
@@ -4800,12 +4874,12 @@ async function generateLLMsIndex(options) {
   }
   for (const [routePattern, routes] of ssrDataRoutes.entries()) {
     if (routes.length > 0) {
-      addSSRDataSection(parts, routePattern, routes, baseUrl, isSingleCollection, targetCollection, llmsConfig);
+      addSSRDataSection(parts, routePattern, routes, baseUrl, isScoped, targetCollection, llmsConfig);
     }
   }
   for (const [section, routes] of sections.entries()) {
     if (routes.length > 0) {
-      addStaticSection(parts, section, routes, baseUrl, isSingleCollection, targetCollection, collectionsMap, llmsConfig);
+      addStaticSection(parts, section, routes, baseUrl, isScoped, targetCollection, collectionsMap, llmsConfig);
     }
   }
   parts.push("---");
@@ -4868,6 +4942,9 @@ async function discoverAllRoutes(cwd, collections2, isWatchMode, llmsConfig) {
   }
   return allRoutes;
 }
+function routeBelongsToCollection(path3, collection) {
+  return path3 === `/${collection}` || path3.startsWith(`/${collection}/`);
+}
 function formatContentBlock(content, routePath, baseUrl) {
   const parts = [];
   const lines = content.split(`
@@ -4937,7 +5014,9 @@ function buildFooter(parts) {
 async function generateLLMsFullContent(options) {
   const { cwd, collections: collections2, baseUrl, isWatchMode, llmsConfig } = options;
   const parts = buildHeader(baseUrl, llmsConfig);
-  const allRoutes = await discoverAllRoutes(cwd, collections2, isWatchMode, llmsConfig);
+  const discovered = await discoverAllRoutes(cwd, collections2, isWatchMode, llmsConfig);
+  const targetCollection = options.targetCollection;
+  const allRoutes = targetCollection ? discovered.filter((route) => routeBelongsToCollection(route.path, targetCollection)) : discovered;
   const maxItems = llmsConfig?.maxItems || 1e4;
   const routesToProcess = allRoutes.slice(0, maxItems);
   const extracted = await extractRouteContents(routesToProcess, options);
@@ -107077,7 +107156,7 @@ async function getVersionString2() {
 }
 async function getVersion2() {
   if (true) {
-    return "1.0.0-alpha.5";
+    return "1.0.0-alpha.7";
   }
   const possiblePaths = [
     path3.join(import.meta.dir, "../../../package.json"),
@@ -107094,10 +107173,10 @@ async function getVersion2() {
 }
 async function getCommit2() {
   if (true) {
-    return "403cf32";
+    return "19dcaf7";
   }
   return "dev";
 }
 main();
 
-//# debugId=CD4585F819A6C03E64756E2164756E21
+//# debugId=958B942751A1FF3B64756E2164756E21