@lacspace/llms-txt 1.2.1 → 1.3.0

package/README.md

@@ -120,6 +120,48 @@ export function GET() {
 }
 ```
 
+## Advanced (new)
+
+All additive and backward-compatible — `llmsTxt`, `llmsFullTxt`, `parseLlmsTxt`, `llmsTxtFromSitemap` and the `*Response` helpers keep their existing behavior.
+
+### Build from routes
+
+`llmsTxtFromRoutes(routes, meta)` turns a flat list of `{ title, url, notes?, section? }` into an `llms.txt`, grouping by `section` (first-seen order preserved).
+
+```ts
+import { llmsTxtFromRoutes } from "@lacspace/llms-txt";
+
+llmsTxtFromRoutes(
+  [
+    { title: "Home", url: "https://acme.com/", section: "Start" },
+    { title: "API", url: "https://acme.com/api", notes: "reference", section: "Docs" },
+    { title: "CLI", url: "https://acme.com/cli", section: "Docs" },
+  ],
+  { title: "Acme", summary: "Acme docs", defaultSection: "Docs" },
+);
+```
+
+### Sitemap: XML string, auto-sections, dedupe
+
+`llmsTxtFromSitemap` now accepts a **raw sitemap XML string** as well as an array, de-duplicates repeated URLs, and can derive sections from the first path segment with `sectionFromPath: true`. The original array signature is unchanged.
+
+```ts
+llmsTxtFromSitemap(sitemapXmlString, { title: "Acme", sectionFromPath: true });
+// "/docs/intro" → "## Docs", "/blog/hello" → "## Blog"
+```
+
+### Sort links within sections
+
+`llmsTxt(doc, { sort })` — and the `sort` option on `llmsTxtFromRoutes` / `llmsTxtFromSitemap` — orders the links inside each section. Sections keep their array order.
+
+```ts
+llmsTxt(doc, { sort: "title" });        // ascending by title
+llmsTxt(doc, { sort: "url-desc" });     // descending by url
+llmsTxt(doc, { sort: (a, b) => /* custom */ 0 });
+```
+
+`parseLlmsTxt` round-trips what `llmsTxt` produces (title, summary, details, sections and links).
+
 ## Licensing
 
 This package is **free** under the **[Lacspace Free Licence](https://lacspace.com/licenses/lacspace-free-1.0)** — MIT-equivalent freedoms. Use it in personal and commercial projects at no cost; just keep the notice.

package/dist/index.cjs

@@ -1,13 +1,21 @@
 'use strict';
 
 // src/index.ts
-function llmsTxt(doc) {
+function sortLinks(links, sort) {
+  if (!sort) return links;
+  const copy = links.slice();
+  if (typeof sort === "function") return copy.sort(sort);
+  const [field, dir] = sort.split("-");
+  const factor = dir === "desc" ? -1 : 1;
+  return copy.sort((a, b) => factor * a[field].localeCompare(b[field]));
+}
+function llmsTxt(doc, opts = {}) {
   const out = [`# ${doc.title}`];
   if (doc.summary) out.push("", `> ${doc.summary}`);
   if (doc.details) out.push("", doc.details.trim());
   for (const section of doc.sections) {
     out.push("", `## ${section.title}`, "");
-    for (const l of section.links) {
+    for (const l of sortLinks(section.links, opts.sort)) {
       out.push(`- [${l.title}](${l.url})${l.notes ? `: ${l.notes}` : ""}`);
     }
   }
@@ -58,24 +66,83 @@ function titleFromUrl(url) {
   }
   const seg = path.split("/").filter(Boolean).pop();
   if (!seg) return "Home";
-  return decodeURIComponent(seg).replace(/\.[a-z]+$/i, "").replace(/[-_]+/g, " ").replace(/\b\w/g, (c) => c.toUpperCase());
+  let decoded;
+  try {
+    decoded = decodeURIComponent(seg);
+  } catch {
+    decoded = seg;
+  }
+  return decoded.replace(/\.[a-z]+$/i, "").replace(/[-_]+/g, " ").replace(/\b\w/g, (c) => c.toUpperCase());
+}
+function sectionFromUrl(url) {
+  let path;
+  try {
+    path = new URL(url).pathname;
+  } catch {
+    path = url;
+  }
+  const seg = path.split("/").filter(Boolean)[0];
+  if (!seg) return "Home";
+  let decoded;
+  try {
+    decoded = decodeURIComponent(seg);
+  } catch {
+    decoded = seg;
+  }
+  return decoded.replace(/\.[a-z]+$/i, "").replace(/[-_]+/g, " ").replace(/\b\w/g, (c) => c.toUpperCase());
+}
+function parseSitemapXml(xml) {
+  const out = [];
+  const re = /<loc>\s*([\s\S]*?)\s*<\/loc>/gi;
+  let m;
+  while (m = re.exec(xml)) {
+    const loc = m[1].trim().replace(/&amp;/g, "&").replace(/&lt;/g, "<").replace(/&gt;/g, ">").replace(/&quot;/g, '"').replace(/&apos;/g, "'");
+    if (loc) out.push({ loc });
+  }
+  return out;
 }
 function llmsTxtFromSitemap(entries, meta) {
+  const list = typeof entries === "string" ? parseSitemapXml(entries) : entries;
   const bySection = /* @__PURE__ */ new Map();
-  for (const e of entries) {
+  const order = [];
+  const seen = /* @__PURE__ */ new Set();
+  for (const e of list) {
     const url = e.url ?? e.loc;
-    if (!url) continue;
-    const section = e.section ?? meta.defaultSection ?? "Pages";
-    if (!bySection.has(section)) bySection.set(section, []);
+    if (!url || seen.has(url)) continue;
+    seen.add(url);
+    const section = e.section ?? (meta.sectionFromPath ? sectionFromUrl(url) : meta.defaultSection ?? "Pages");
+    if (!bySection.has(section)) {
+      bySection.set(section, []);
+      order.push(section);
+    }
     bySection.get(section).push({ title: e.title ?? titleFromUrl(url), url });
   }
   const doc = {
     title: meta.title,
     summary: meta.summary,
     details: meta.details,
-    sections: [...bySection].map(([title, links]) => ({ title, links }))
+    sections: order.map((title) => ({ title, links: bySection.get(title) }))
+  };
+  return llmsTxt(doc, { sort: meta.sort });
+}
+function llmsTxtFromRoutes(routes, meta) {
+  const bySection = /* @__PURE__ */ new Map();
+  const order = [];
+  for (const r of routes) {
+    const section = r.section ?? meta.defaultSection ?? "Docs";
+    if (!bySection.has(section)) {
+      bySection.set(section, []);
+      order.push(section);
+    }
+    bySection.get(section).push({ title: r.title, url: r.url, notes: r.notes });
+  }
+  const doc = {
+    title: meta.title,
+    summary: meta.summary,
+    details: meta.details,
+    sections: order.map((title) => ({ title, links: bySection.get(title) }))
   };
-  return llmsTxt(doc);
+  return llmsTxt(doc, { sort: meta.sort });
 }
 function llmsTxtResponse(doc, init = {}) {
   return new Response(llmsTxt(doc), {
@@ -93,6 +160,7 @@ function llmsFullTxtResponse(doc, init = {}) {
 exports.llmsFullTxt = llmsFullTxt;
 exports.llmsFullTxtResponse = llmsFullTxtResponse;
 exports.llmsTxt = llmsTxt;
+exports.llmsTxtFromRoutes = llmsTxtFromRoutes;
 exports.llmsTxtFromSitemap = llmsTxtFromSitemap;
 exports.llmsTxtResponse = llmsTxtResponse;
 exports.parseLlmsTxt = parseLlmsTxt;

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * @lacspace/llms-txt\n * Generate and parse llms.txt and llms-full.txt (the llmstxt.org standard).\n *\n * llms.txt is a Markdown file at your site root that gives LLMs a curated map of\n * your most useful content; llms-full.txt inlines the full text so a model can\n * read everything in one request.\n *\n * Zero dependencies · isomorphic · fully typed.\n */\n\nexport interface LlmsLink {\n  title: string;\n  url: string;\n  /** Short note shown after the link. */\n  notes?: string;\n}\n\nexport interface LlmsSection {\n  title: string;\n  links: LlmsLink[];\n}\n\nexport interface LlmsDoc {\n  /** The site / project name (rendered as the H1). */\n  title: string;\n  /** One-line summary (rendered as a blockquote). */\n  summary?: string;\n  /** Free-form Markdown shown before the sections. */\n  details?: string;\n  sections: LlmsSection[];\n}\n\n/**\n * Render an `llms.txt` document.\n * @example\n * llmsTxt({\n *   title: \"Lacspace\",\n *   summary: \"Open-source TypeScript packages and products.\",\n *   sections: [{ title: \"Docs\", links: [{ title: \"Packages\", url: \"https://lacspace.com/packages\" }] }],\n * });\n */\nexport function llmsTxt(doc: LlmsDoc): string {\n  const out: string[] = [`# ${doc.title}`];\n  if (doc.summary) out.push(\"\", `> ${doc.summary}`);\n  if (doc.details) out.push(\"\", doc.details.trim());\n  for (const section of doc.sections) {\n    out.push(\"\", `## ${section.title}`, \"\");\n    for (const l of section.links) {\n      out.push(`- [${l.title}](${l.url})${l.notes ? `: ${l.notes}` : \"\"}`);\n    }\n  }\n  return out.join(\"\\n\") + \"\\n\";\n}\n\nexport interface LlmsFullSection {\n  title: string;\n  /** Full Markdown content for this section. */\n  content: string;\n  /** Optional source URL, added as a heading link. */\n  url?: string;\n}\n\nexport interface LlmsFullDoc {\n  title: string;\n  summary?: string;\n  sections: LlmsFullSection[];\n}\n\n/** Render an `llms-full.txt` document with the full content inlined. */\nexport function llmsFullTxt(doc: LlmsFullDoc): string {\n  const out: string[] = [`# ${doc.title}`];\n  if (doc.summary) out.push(\"\", `> ${doc.summary}`);\n  for (const section of doc.sections) {\n    out.push(\"\", \"---\", \"\", `## ${section.title}`);\n    if (section.url) out.push(\"\", `Source: ${section.url}`);\n    out.push(\"\", section.content.trim());\n  }\n  return out.join(\"\\n\") + \"\\n\";\n}\n\n/** Parse an `llms.txt` string back into a structured document. */\nexport function parseLlmsTxt(txt: string): LlmsDoc {\n  const lines = txt.split(/\\r?\\n/);\n  const doc: LlmsDoc = { title: \"\", sections: [] };\n  let current: LlmsSection | null = null;\n  const detailBuf: string[] = [];\n  const linkRe = /^-\\s*\\[([^\\]]+)\\]\\(([^)]+)\\)\\s*(?::\\s*(.*))?$/;\n\n  for (const raw of lines) {\n    const line = raw.trimEnd();\n    if (line.startsWith(\"# \")) {\n      doc.title = line.slice(2).trim();\n    } else if (line.startsWith(\"> \")) {\n      doc.summary = (doc.summary ? doc.summary + \" \" : \"\") + line.slice(2).trim();\n    } else if (line.startsWith(\"## \")) {\n      current = { title: line.slice(3).trim(), links: [] };\n      doc.sections.push(current);\n    } else if (current && linkRe.test(line)) {\n      const m = line.match(linkRe)!;\n      current.links.push({ title: m[1]!, url: m[2]!, notes: m[3]?.trim() || undefined });\n    } else if (!current && line && !line.startsWith(\"#\")) {\n      detailBuf.push(line);\n    }\n  }\n  const details = detailBuf.join(\"\\n\").trim();\n  if (details) doc.details = details;\n  return doc;\n}\n\n/* ------------------------------ from sitemap ------------------------------ */\n\n/** A sitemap-ish entry — accepts `url` or `loc`, plus optional title/section. */\nexport interface SitemapEntryLike {\n  url?: string;\n  loc?: string;\n  title?: string;\n  section?: string;\n}\n\nfunction titleFromUrl(url: string): string {\n  let path: string;\n  try {\n    path = new URL(url).pathname;\n  } catch {\n    path = url;\n  }\n  const seg = path.split(\"/\").filter(Boolean).pop();\n  if (!seg) return \"Home\";\n  return decodeURIComponent(seg).replace(/\\.[a-z]+$/i, \"\").replace(/[-_]+/g, \" \").replace(/\\b\\w/g, (c) => c.toUpperCase());\n}\n\n/**\n * Build an `llms.txt` from a list of sitemap entries — group by `section`,\n * derive titles from the URL when not given. Pairs with `@lacspace/sitemap`.\n */\nexport function llmsTxtFromSitemap(\n  entries: SitemapEntryLike[],\n  meta: { title: string; summary?: string; details?: string; defaultSection?: string },\n): string {\n  const bySection = new Map<string, LlmsLink[]>();\n  for (const e of entries) {\n    const url = e.url ?? e.loc;\n    if (!url) continue;\n    const section = e.section ?? meta.defaultSection ?? \"Pages\";\n    if (!bySection.has(section)) bySection.set(section, []);\n    bySection.get(section)!.push({ title: e.title ?? titleFromUrl(url), url });\n  }\n  const doc: LlmsDoc = {\n    title: meta.title,\n    summary: meta.summary,\n    details: meta.details,\n    sections: [...bySection].map(([title, links]) => ({ title, links })),\n  };\n  return llmsTxt(doc);\n}\n\n/* ------------------------------ adapters ------------------------------ */\n\n/** `llms.txt` as a Fetch/edge `Response` (text/plain) for app/llms.txt/route.ts. */\nexport function llmsTxtResponse(doc: LlmsDoc, init: ResponseInit = {}): Response {\n  return new Response(llmsTxt(doc), {\n    ...init,\n    headers: { \"content-type\": \"text/plain; charset=utf-8\", ...(init.headers ?? {}) },\n  });\n}\n\n/** `llms-full.txt` as a Fetch/edge `Response` (text/plain). */\nexport function llmsFullTxtResponse(doc: LlmsFullDoc, init: ResponseInit = {}): Response {\n  return new Response(llmsFullTxt(doc), {\n    ...init,\n    headers: { \"content-type\": \"text/plain; charset=utf-8\", ...(init.headers ?? {}) },\n  });\n}\n"]}
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * @lacspace/llms-txt\n * Generate and parse llms.txt and llms-full.txt (the llmstxt.org standard).\n *\n * llms.txt is a Markdown file at your site root that gives LLMs a curated map of\n * your most useful content; llms-full.txt inlines the full text so a model can\n * read everything in one request.\n *\n * Zero dependencies · isomorphic · fully typed.\n */\n\nexport interface LlmsLink {\n  title: string;\n  url: string;\n  /** Short note shown after the link. */\n  notes?: string;\n}\n\nexport interface LlmsSection {\n  title: string;\n  links: LlmsLink[];\n}\n\nexport interface LlmsDoc {\n  /** The site / project name (rendered as the H1). */\n  title: string;\n  /** One-line summary (rendered as a blockquote). */\n  summary?: string;\n  /** Free-form Markdown shown before the sections. */\n  details?: string;\n  sections: LlmsSection[];\n}\n\n/**\n * How to order the links inside each section.\n * - `\"title\"` / `\"url\"` — ascending by that field\n * - `\"title-desc\"` / `\"url-desc\"` — descending\n * - a comparator — full control\n * Sections keep their array order; only the links within a section are sorted.\n */\nexport type LinkSort =\n  | \"title\"\n  | \"url\"\n  | \"title-desc\"\n  | \"url-desc\"\n  | ((a: LlmsLink, b: LlmsLink) => number);\n\n/** Options accepted by the rendering helpers. */\nexport interface LlmsTxtOptions {\n  /** Order links within each section. Omit to keep the given order. */\n  sort?: LinkSort;\n}\n\nfunction sortLinks(links: LlmsLink[], sort?: LinkSort): LlmsLink[] {\n  if (!sort) return links;\n  const copy = links.slice();\n  if (typeof sort === \"function\") return copy.sort(sort);\n  const [field, dir] = sort.split(\"-\") as [\"title\" | \"url\", \"desc\" | undefined];\n  const factor = dir === \"desc\" ? -1 : 1;\n  return copy.sort((a, b) => factor * a[field].localeCompare(b[field]));\n}\n\n/**\n * Render an `llms.txt` document.\n * @param opts optional rendering options (e.g. `{ sort: \"title\" }`).\n * @example\n * llmsTxt({\n *   title: \"Lacspace\",\n *   summary: \"Open-source TypeScript packages and products.\",\n *   sections: [{ title: \"Docs\", links: [{ title: \"Packages\", url: \"https://lacspace.com/packages\" }] }],\n * });\n */\nexport function llmsTxt(doc: LlmsDoc, opts: LlmsTxtOptions = {}): string {\n  const out: string[] = [`# ${doc.title}`];\n  if (doc.summary) out.push(\"\", `> ${doc.summary}`);\n  if (doc.details) out.push(\"\", doc.details.trim());\n  for (const section of doc.sections) {\n    out.push(\"\", `## ${section.title}`, \"\");\n    for (const l of sortLinks(section.links, opts.sort)) {\n      out.push(`- [${l.title}](${l.url})${l.notes ? `: ${l.notes}` : \"\"}`);\n    }\n  }\n  return out.join(\"\\n\") + \"\\n\";\n}\n\nexport interface LlmsFullSection {\n  title: string;\n  /** Full Markdown content for this section. */\n  content: string;\n  /** Optional source URL, added as a heading link. */\n  url?: string;\n}\n\nexport interface LlmsFullDoc {\n  title: string;\n  summary?: string;\n  sections: LlmsFullSection[];\n}\n\n/** Render an `llms-full.txt` document with the full content inlined. */\nexport function llmsFullTxt(doc: LlmsFullDoc): string {\n  const out: string[] = [`# ${doc.title}`];\n  if (doc.summary) out.push(\"\", `> ${doc.summary}`);\n  for (const section of doc.sections) {\n    out.push(\"\", \"---\", \"\", `## ${section.title}`);\n    if (section.url) out.push(\"\", `Source: ${section.url}`);\n    out.push(\"\", section.content.trim());\n  }\n  return out.join(\"\\n\") + \"\\n\";\n}\n\n/** Parse an `llms.txt` string back into a structured document. */\nexport function parseLlmsTxt(txt: string): LlmsDoc {\n  const lines = txt.split(/\\r?\\n/);\n  const doc: LlmsDoc = { title: \"\", sections: [] };\n  let current: LlmsSection | null = null;\n  const detailBuf: string[] = [];\n  const linkRe = /^-\\s*\\[([^\\]]+)\\]\\(([^)]+)\\)\\s*(?::\\s*(.*))?$/;\n\n  for (const raw of lines) {\n    const line = raw.trimEnd();\n    if (line.startsWith(\"# \")) {\n      doc.title = line.slice(2).trim();\n    } else if (line.startsWith(\"> \")) {\n      doc.summary = (doc.summary ? doc.summary + \" \" : \"\") + line.slice(2).trim();\n    } else if (line.startsWith(\"## \")) {\n      current = { title: line.slice(3).trim(), links: [] };\n      doc.sections.push(current);\n    } else if (current && linkRe.test(line)) {\n      const m = line.match(linkRe)!;\n      current.links.push({ title: m[1]!, url: m[2]!, notes: m[3]?.trim() || undefined });\n    } else if (!current && line && !line.startsWith(\"#\")) {\n      detailBuf.push(line);\n    }\n  }\n  const details = detailBuf.join(\"\\n\").trim();\n  if (details) doc.details = details;\n  return doc;\n}\n\n/* ------------------------------ from sitemap ------------------------------ */\n\n/** A sitemap-ish entry — accepts `url` or `loc`, plus optional title/section. */\nexport interface SitemapEntryLike {\n  url?: string;\n  loc?: string;\n  title?: string;\n  section?: string;\n}\n\nfunction titleFromUrl(url: string): string {\n  let path: string;\n  try {\n    path = new URL(url).pathname;\n  } catch {\n    path = url;\n  }\n  const seg = path.split(\"/\").filter(Boolean).pop();\n  if (!seg) return \"Home\";\n  let decoded: string;\n  try {\n    decoded = decodeURIComponent(seg);\n  } catch {\n    // Malformed percent-encoding — fall back to the raw segment instead of throwing.\n    decoded = seg;\n  }\n  return decoded.replace(/\\.[a-z]+$/i, \"\").replace(/[-_]+/g, \" \").replace(/\\b\\w/g, (c) => c.toUpperCase());\n}\n\n/** First path segment of a URL, title-cased, for auto-sectioning (\"/docs/x\" → \"Docs\"). */\nfunction sectionFromUrl(url: string): string {\n  let path: string;\n  try {\n    path = new URL(url).pathname;\n  } catch {\n    path = url;\n  }\n  const seg = path.split(\"/\").filter(Boolean)[0];\n  if (!seg) return \"Home\";\n  let decoded: string;\n  try {\n    decoded = decodeURIComponent(seg);\n  } catch {\n    decoded = seg;\n  }\n  return decoded.replace(/\\.[a-z]+$/i, \"\").replace(/[-_]+/g, \" \").replace(/\\b\\w/g, (c) => c.toUpperCase());\n}\n\n/** Pull `<loc>` values out of a sitemap (or sitemap-index) XML string. */\nfunction parseSitemapXml(xml: string): SitemapEntryLike[] {\n  const out: SitemapEntryLike[] = [];\n  const re = /<loc>\\s*([\\s\\S]*?)\\s*<\\/loc>/gi;\n  let m: RegExpExecArray | null;\n  while ((m = re.exec(xml))) {\n    const loc = m[1]!\n      .trim()\n      .replace(/&amp;/g, \"&\")\n      .replace(/&lt;/g, \"<\")\n      .replace(/&gt;/g, \">\")\n      .replace(/&quot;/g, '\"')\n      .replace(/&apos;/g, \"'\");\n    if (loc) out.push({ loc });\n  }\n  return out;\n}\n\n/** Meta / options for {@link llmsTxtFromSitemap}. */\nexport interface SitemapToLlmsMeta extends LlmsTxtOptions {\n  title: string;\n  summary?: string;\n  details?: string;\n  /** Fallback section name when an entry has none. Default `\"Pages\"`. */\n  defaultSection?: string;\n  /**\n   * When an entry has no explicit `section`, derive one from the first path\n   * segment (\"/docs/x\" → \"Docs\") instead of using {@link defaultSection}.\n   */\n  sectionFromPath?: boolean;\n}\n\n/**\n * Build an `llms.txt` from sitemap entries — accepts either an **array** of\n * `{ loc | url, title?, section? }` entries or a raw **sitemap XML string**.\n * Groups by `section` (or, with `sectionFromPath`, by the first path segment),\n * derives titles from the URL when not given, and de-duplicates repeated URLs.\n * Pairs with `@lacspace/sitemap`. The original array signature is unchanged.\n */\nexport function llmsTxtFromSitemap(\n  entries: SitemapEntryLike[] | string,\n  meta: SitemapToLlmsMeta,\n): string {\n  const list = typeof entries === \"string\" ? parseSitemapXml(entries) : entries;\n  const bySection = new Map<string, LlmsLink[]>();\n  const order: string[] = [];\n  const seen = new Set<string>();\n  for (const e of list) {\n    const url = e.url ?? e.loc;\n    if (!url || seen.has(url)) continue;\n    seen.add(url);\n    const section =\n      e.section ?? (meta.sectionFromPath ? sectionFromUrl(url) : meta.defaultSection ?? \"Pages\");\n    if (!bySection.has(section)) {\n      bySection.set(section, []);\n      order.push(section);\n    }\n    bySection.get(section)!.push({ title: e.title ?? titleFromUrl(url), url });\n  }\n  const doc: LlmsDoc = {\n    title: meta.title,\n    summary: meta.summary,\n    details: meta.details,\n    sections: order.map((title) => ({ title, links: bySection.get(title)! })),\n  };\n  return llmsTxt(doc, { sort: meta.sort });\n}\n\n/* ------------------------------ from routes ------------------------------ */\n\n/** A single route/page entry for {@link llmsTxtFromRoutes}. */\nexport interface LlmsRoute {\n  title: string;\n  url: string;\n  notes?: string;\n  /** Section heading to group under. Defaults to {@link RoutesToLlmsMeta.defaultSection}. */\n  section?: string;\n}\n\n/** Meta / options for {@link llmsTxtFromRoutes}. */\nexport interface RoutesToLlmsMeta extends LlmsTxtOptions {\n  title: string;\n  summary?: string;\n  details?: string;\n  /** Section name for routes with no `section`. Default `\"Docs\"`. */\n  defaultSection?: string;\n}\n\n/**\n * Build an `llms.txt` from a flat list of route entries, grouping by `section`\n * (first-seen order preserved). Titles and notes are used verbatim.\n * @example\n * llmsTxtFromRoutes(\n *   [\n *     { title: \"Home\", url: \"https://acme.com/\", section: \"Start\" },\n *     { title: \"API\", url: \"https://acme.com/api\", notes: \"reference\", section: \"Docs\" },\n *   ],\n *   { title: \"Acme\", summary: \"Acme docs\" },\n * );\n */\nexport function llmsTxtFromRoutes(routes: LlmsRoute[], meta: RoutesToLlmsMeta): string {\n  const bySection = new Map<string, LlmsLink[]>();\n  const order: string[] = [];\n  for (const r of routes) {\n    const section = r.section ?? meta.defaultSection ?? \"Docs\";\n    if (!bySection.has(section)) {\n      bySection.set(section, []);\n      order.push(section);\n    }\n    bySection.get(section)!.push({ title: r.title, url: r.url, notes: r.notes });\n  }\n  const doc: LlmsDoc = {\n    title: meta.title,\n    summary: meta.summary,\n    details: meta.details,\n    sections: order.map((title) => ({ title, links: bySection.get(title)! })),\n  };\n  return llmsTxt(doc, { sort: meta.sort });\n}\n\n/* ------------------------------ adapters ------------------------------ */\n\n/** `llms.txt` as a Fetch/edge `Response` (text/plain) for app/llms.txt/route.ts. */\nexport function llmsTxtResponse(doc: LlmsDoc, init: ResponseInit = {}): Response {\n  return new Response(llmsTxt(doc), {\n    ...init,\n    headers: { \"content-type\": \"text/plain; charset=utf-8\", ...(init.headers ?? {}) },\n  });\n}\n\n/** `llms-full.txt` as a Fetch/edge `Response` (text/plain). */\nexport function llmsFullTxtResponse(doc: LlmsFullDoc, init: ResponseInit = {}): Response {\n  return new Response(llmsFullTxt(doc), {\n    ...init,\n    headers: { \"content-type\": \"text/plain; charset=utf-8\", ...(init.headers ?? {}) },\n  });\n}\n"]}

package/dist/index.d.cts

@@ -27,8 +27,22 @@ interface LlmsDoc {
     details?: string;
     sections: LlmsSection[];
 }
+/**
+ * How to order the links inside each section.
+ * - `"title"` / `"url"` — ascending by that field
+ * - `"title-desc"` / `"url-desc"` — descending
+ * - a comparator — full control
+ * Sections keep their array order; only the links within a section are sorted.
+ */
+type LinkSort = "title" | "url" | "title-desc" | "url-desc" | ((a: LlmsLink, b: LlmsLink) => number);
+/** Options accepted by the rendering helpers. */
+interface LlmsTxtOptions {
+    /** Order links within each section. Omit to keep the given order. */
+    sort?: LinkSort;
+}
 /**
  * Render an `llms.txt` document.
+ * @param opts optional rendering options (e.g. `{ sort: "title" }`).
  * @example
  * llmsTxt({
  *   title: "Lacspace",
@@ -36,7 +50,7 @@ interface LlmsDoc {
  *   sections: [{ title: "Docs", links: [{ title: "Packages", url: "https://lacspace.com/packages" }] }],
  * });
  */
-declare function llmsTxt(doc: LlmsDoc): string;
+declare function llmsTxt(doc: LlmsDoc, opts?: LlmsTxtOptions): string;
 interface LlmsFullSection {
     title: string;
     /** Full Markdown content for this section. */
@@ -60,19 +74,59 @@ interface SitemapEntryLike {
     title?: string;
     section?: string;
 }
+/** Meta / options for {@link llmsTxtFromSitemap}. */
+interface SitemapToLlmsMeta extends LlmsTxtOptions {
+    title: string;
+    summary?: string;
+    details?: string;
+    /** Fallback section name when an entry has none. Default `"Pages"`. */
+    defaultSection?: string;
+    /**
+     * When an entry has no explicit `section`, derive one from the first path
+     * segment ("/docs/x" → "Docs") instead of using {@link defaultSection}.
+     */
+    sectionFromPath?: boolean;
+}
 /**
- * Build an `llms.txt` from a list of sitemap entries — group by `section`,
- * derive titles from the URL when not given. Pairs with `@lacspace/sitemap`.
+ * Build an `llms.txt` from sitemap entries — accepts either an **array** of
+ * `{ loc | url, title?, section? }` entries or a raw **sitemap XML string**.
+ * Groups by `section` (or, with `sectionFromPath`, by the first path segment),
+ * derives titles from the URL when not given, and de-duplicates repeated URLs.
+ * Pairs with `@lacspace/sitemap`. The original array signature is unchanged.
  */
-declare function llmsTxtFromSitemap(entries: SitemapEntryLike[], meta: {
+declare function llmsTxtFromSitemap(entries: SitemapEntryLike[] | string, meta: SitemapToLlmsMeta): string;
+/** A single route/page entry for {@link llmsTxtFromRoutes}. */
+interface LlmsRoute {
+    title: string;
+    url: string;
+    notes?: string;
+    /** Section heading to group under. Defaults to {@link RoutesToLlmsMeta.defaultSection}. */
+    section?: string;
+}
+/** Meta / options for {@link llmsTxtFromRoutes}. */
+interface RoutesToLlmsMeta extends LlmsTxtOptions {
     title: string;
     summary?: string;
     details?: string;
+    /** Section name for routes with no `section`. Default `"Docs"`. */
     defaultSection?: string;
-}): string;
+}
+/**
+ * Build an `llms.txt` from a flat list of route entries, grouping by `section`
+ * (first-seen order preserved). Titles and notes are used verbatim.
+ * @example
+ * llmsTxtFromRoutes(
+ *   [
+ *     { title: "Home", url: "https://acme.com/", section: "Start" },
+ *     { title: "API", url: "https://acme.com/api", notes: "reference", section: "Docs" },
+ *   ],
+ *   { title: "Acme", summary: "Acme docs" },
+ * );
+ */
+declare function llmsTxtFromRoutes(routes: LlmsRoute[], meta: RoutesToLlmsMeta): string;
 /** `llms.txt` as a Fetch/edge `Response` (text/plain) for app/llms.txt/route.ts. */
 declare function llmsTxtResponse(doc: LlmsDoc, init?: ResponseInit): Response;
 /** `llms-full.txt` as a Fetch/edge `Response` (text/plain). */
 declare function llmsFullTxtResponse(doc: LlmsFullDoc, init?: ResponseInit): Response;
 
-export { type LlmsDoc, type LlmsFullDoc, type LlmsFullSection, type LlmsLink, type LlmsSection, type SitemapEntryLike, llmsFullTxt, llmsFullTxtResponse, llmsTxt, llmsTxtFromSitemap, llmsTxtResponse, parseLlmsTxt };
+export { type LinkSort, type LlmsDoc, type LlmsFullDoc, type LlmsFullSection, type LlmsLink, type LlmsRoute, type LlmsSection, type LlmsTxtOptions, type RoutesToLlmsMeta, type SitemapEntryLike, type SitemapToLlmsMeta, llmsFullTxt, llmsFullTxtResponse, llmsTxt, llmsTxtFromRoutes, llmsTxtFromSitemap, llmsTxtResponse, parseLlmsTxt };

package/dist/index.d.ts

@@ -27,8 +27,22 @@ interface LlmsDoc {
     details?: string;
     sections: LlmsSection[];
 }
+/**
+ * How to order the links inside each section.
+ * - `"title"` / `"url"` — ascending by that field
+ * - `"title-desc"` / `"url-desc"` — descending
+ * - a comparator — full control
+ * Sections keep their array order; only the links within a section are sorted.
+ */
+type LinkSort = "title" | "url" | "title-desc" | "url-desc" | ((a: LlmsLink, b: LlmsLink) => number);
+/** Options accepted by the rendering helpers. */
+interface LlmsTxtOptions {
+    /** Order links within each section. Omit to keep the given order. */
+    sort?: LinkSort;
+}
 /**
  * Render an `llms.txt` document.
+ * @param opts optional rendering options (e.g. `{ sort: "title" }`).
  * @example
  * llmsTxt({
  *   title: "Lacspace",
@@ -36,7 +50,7 @@ interface LlmsDoc {
  *   sections: [{ title: "Docs", links: [{ title: "Packages", url: "https://lacspace.com/packages" }] }],
  * });
  */
-declare function llmsTxt(doc: LlmsDoc): string;
+declare function llmsTxt(doc: LlmsDoc, opts?: LlmsTxtOptions): string;
 interface LlmsFullSection {
     title: string;
     /** Full Markdown content for this section. */
@@ -60,19 +74,59 @@ interface SitemapEntryLike {
     title?: string;
     section?: string;
 }
+/** Meta / options for {@link llmsTxtFromSitemap}. */
+interface SitemapToLlmsMeta extends LlmsTxtOptions {
+    title: string;
+    summary?: string;
+    details?: string;
+    /** Fallback section name when an entry has none. Default `"Pages"`. */
+    defaultSection?: string;
+    /**
+     * When an entry has no explicit `section`, derive one from the first path
+     * segment ("/docs/x" → "Docs") instead of using {@link defaultSection}.
+     */
+    sectionFromPath?: boolean;
+}
 /**
- * Build an `llms.txt` from a list of sitemap entries — group by `section`,
- * derive titles from the URL when not given. Pairs with `@lacspace/sitemap`.
+ * Build an `llms.txt` from sitemap entries — accepts either an **array** of
+ * `{ loc | url, title?, section? }` entries or a raw **sitemap XML string**.
+ * Groups by `section` (or, with `sectionFromPath`, by the first path segment),
+ * derives titles from the URL when not given, and de-duplicates repeated URLs.
+ * Pairs with `@lacspace/sitemap`. The original array signature is unchanged.
  */
-declare function llmsTxtFromSitemap(entries: SitemapEntryLike[], meta: {
+declare function llmsTxtFromSitemap(entries: SitemapEntryLike[] | string, meta: SitemapToLlmsMeta): string;
+/** A single route/page entry for {@link llmsTxtFromRoutes}. */
+interface LlmsRoute {
+    title: string;
+    url: string;
+    notes?: string;
+    /** Section heading to group under. Defaults to {@link RoutesToLlmsMeta.defaultSection}. */
+    section?: string;
+}
+/** Meta / options for {@link llmsTxtFromRoutes}. */
+interface RoutesToLlmsMeta extends LlmsTxtOptions {
     title: string;
     summary?: string;
     details?: string;
+    /** Section name for routes with no `section`. Default `"Docs"`. */
     defaultSection?: string;
-}): string;
+}
+/**
+ * Build an `llms.txt` from a flat list of route entries, grouping by `section`
+ * (first-seen order preserved). Titles and notes are used verbatim.
+ * @example
+ * llmsTxtFromRoutes(
+ *   [
+ *     { title: "Home", url: "https://acme.com/", section: "Start" },
+ *     { title: "API", url: "https://acme.com/api", notes: "reference", section: "Docs" },
+ *   ],
+ *   { title: "Acme", summary: "Acme docs" },
+ * );
+ */
+declare function llmsTxtFromRoutes(routes: LlmsRoute[], meta: RoutesToLlmsMeta): string;
 /** `llms.txt` as a Fetch/edge `Response` (text/plain) for app/llms.txt/route.ts. */
 declare function llmsTxtResponse(doc: LlmsDoc, init?: ResponseInit): Response;
 /** `llms-full.txt` as a Fetch/edge `Response` (text/plain). */
 declare function llmsFullTxtResponse(doc: LlmsFullDoc, init?: ResponseInit): Response;
 
-export { type LlmsDoc, type LlmsFullDoc, type LlmsFullSection, type LlmsLink, type LlmsSection, type SitemapEntryLike, llmsFullTxt, llmsFullTxtResponse, llmsTxt, llmsTxtFromSitemap, llmsTxtResponse, parseLlmsTxt };
+export { type LinkSort, type LlmsDoc, type LlmsFullDoc, type LlmsFullSection, type LlmsLink, type LlmsRoute, type LlmsSection, type LlmsTxtOptions, type RoutesToLlmsMeta, type SitemapEntryLike, type SitemapToLlmsMeta, llmsFullTxt, llmsFullTxtResponse, llmsTxt, llmsTxtFromRoutes, llmsTxtFromSitemap, llmsTxtResponse, parseLlmsTxt };

package/dist/index.js

@@ -1,11 +1,19 @@
 // src/index.ts
-function llmsTxt(doc) {
+function sortLinks(links, sort) {
+  if (!sort) return links;
+  const copy = links.slice();
+  if (typeof sort === "function") return copy.sort(sort);
+  const [field, dir] = sort.split("-");
+  const factor = dir === "desc" ? -1 : 1;
+  return copy.sort((a, b) => factor * a[field].localeCompare(b[field]));
+}
+function llmsTxt(doc, opts = {}) {
   const out = [`# ${doc.title}`];
   if (doc.summary) out.push("", `> ${doc.summary}`);
   if (doc.details) out.push("", doc.details.trim());
   for (const section of doc.sections) {
     out.push("", `## ${section.title}`, "");
-    for (const l of section.links) {
+    for (const l of sortLinks(section.links, opts.sort)) {
       out.push(`- [${l.title}](${l.url})${l.notes ? `: ${l.notes}` : ""}`);
     }
   }
@@ -56,24 +64,83 @@ function titleFromUrl(url) {
   }
   const seg = path.split("/").filter(Boolean).pop();
   if (!seg) return "Home";
-  return decodeURIComponent(seg).replace(/\.[a-z]+$/i, "").replace(/[-_]+/g, " ").replace(/\b\w/g, (c) => c.toUpperCase());
+  let decoded;
+  try {
+    decoded = decodeURIComponent(seg);
+  } catch {
+    decoded = seg;
+  }
+  return decoded.replace(/\.[a-z]+$/i, "").replace(/[-_]+/g, " ").replace(/\b\w/g, (c) => c.toUpperCase());
+}
+function sectionFromUrl(url) {
+  let path;
+  try {
+    path = new URL(url).pathname;
+  } catch {
+    path = url;
+  }
+  const seg = path.split("/").filter(Boolean)[0];
+  if (!seg) return "Home";
+  let decoded;
+  try {
+    decoded = decodeURIComponent(seg);
+  } catch {
+    decoded = seg;
+  }
+  return decoded.replace(/\.[a-z]+$/i, "").replace(/[-_]+/g, " ").replace(/\b\w/g, (c) => c.toUpperCase());
+}
+function parseSitemapXml(xml) {
+  const out = [];
+  const re = /<loc>\s*([\s\S]*?)\s*<\/loc>/gi;
+  let m;
+  while (m = re.exec(xml)) {
+    const loc = m[1].trim().replace(/&amp;/g, "&").replace(/&lt;/g, "<").replace(/&gt;/g, ">").replace(/&quot;/g, '"').replace(/&apos;/g, "'");
+    if (loc) out.push({ loc });
+  }
+  return out;
 }
 function llmsTxtFromSitemap(entries, meta) {
+  const list = typeof entries === "string" ? parseSitemapXml(entries) : entries;
   const bySection = /* @__PURE__ */ new Map();
-  for (const e of entries) {
+  const order = [];
+  const seen = /* @__PURE__ */ new Set();
+  for (const e of list) {
     const url = e.url ?? e.loc;
-    if (!url) continue;
-    const section = e.section ?? meta.defaultSection ?? "Pages";
-    if (!bySection.has(section)) bySection.set(section, []);
+    if (!url || seen.has(url)) continue;
+    seen.add(url);
+    const section = e.section ?? (meta.sectionFromPath ? sectionFromUrl(url) : meta.defaultSection ?? "Pages");
+    if (!bySection.has(section)) {
+      bySection.set(section, []);
+      order.push(section);
+    }
     bySection.get(section).push({ title: e.title ?? titleFromUrl(url), url });
   }
   const doc = {
     title: meta.title,
     summary: meta.summary,
     details: meta.details,
-    sections: [...bySection].map(([title, links]) => ({ title, links }))
+    sections: order.map((title) => ({ title, links: bySection.get(title) }))
+  };
+  return llmsTxt(doc, { sort: meta.sort });
+}
+function llmsTxtFromRoutes(routes, meta) {
+  const bySection = /* @__PURE__ */ new Map();
+  const order = [];
+  for (const r of routes) {
+    const section = r.section ?? meta.defaultSection ?? "Docs";
+    if (!bySection.has(section)) {
+      bySection.set(section, []);
+      order.push(section);
+    }
+    bySection.get(section).push({ title: r.title, url: r.url, notes: r.notes });
+  }
+  const doc = {
+    title: meta.title,
+    summary: meta.summary,
+    details: meta.details,
+    sections: order.map((title) => ({ title, links: bySection.get(title) }))
   };
-  return llmsTxt(doc);
+  return llmsTxt(doc, { sort: meta.sort });
 }
 function llmsTxtResponse(doc, init = {}) {
   return new Response(llmsTxt(doc), {
@@ -88,6 +155,6 @@ function llmsFullTxtResponse(doc, init = {}) {
   });
 }
 
-export { llmsFullTxt, llmsFullTxtResponse, llmsTxt, llmsTxtFromSitemap, llmsTxtResponse, parseLlmsTxt };
+export { llmsFullTxt, llmsFullTxtResponse, llmsTxt, llmsTxtFromRoutes, llmsTxtFromSitemap, llmsTxtResponse, parseLlmsTxt };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * @lacspace/llms-txt\n * Generate and parse llms.txt and llms-full.txt (the llmstxt.org standard).\n *\n * llms.txt is a Markdown file at your site root that gives LLMs a curated map of\n * your most useful content; llms-full.txt inlines the full text so a model can\n * read everything in one request.\n *\n * Zero dependencies · isomorphic · fully typed.\n */\n\nexport interface LlmsLink {\n  title: string;\n  url: string;\n  /** Short note shown after the link. */\n  notes?: string;\n}\n\nexport interface LlmsSection {\n  title: string;\n  links: LlmsLink[];\n}\n\nexport interface LlmsDoc {\n  /** The site / project name (rendered as the H1). */\n  title: string;\n  /** One-line summary (rendered as a blockquote). */\n  summary?: string;\n  /** Free-form Markdown shown before the sections. */\n  details?: string;\n  sections: LlmsSection[];\n}\n\n/**\n * Render an `llms.txt` document.\n * @example\n * llmsTxt({\n *   title: \"Lacspace\",\n *   summary: \"Open-source TypeScript packages and products.\",\n *   sections: [{ title: \"Docs\", links: [{ title: \"Packages\", url: \"https://lacspace.com/packages\" }] }],\n * });\n */\nexport function llmsTxt(doc: LlmsDoc): string {\n  const out: string[] = [`# ${doc.title}`];\n  if (doc.summary) out.push(\"\", `> ${doc.summary}`);\n  if (doc.details) out.push(\"\", doc.details.trim());\n  for (const section of doc.sections) {\n    out.push(\"\", `## ${section.title}`, \"\");\n    for (const l of section.links) {\n      out.push(`- [${l.title}](${l.url})${l.notes ? `: ${l.notes}` : \"\"}`);\n    }\n  }\n  return out.join(\"\\n\") + \"\\n\";\n}\n\nexport interface LlmsFullSection {\n  title: string;\n  /** Full Markdown content for this section. */\n  content: string;\n  /** Optional source URL, added as a heading link. */\n  url?: string;\n}\n\nexport interface LlmsFullDoc {\n  title: string;\n  summary?: string;\n  sections: LlmsFullSection[];\n}\n\n/** Render an `llms-full.txt` document with the full content inlined. */\nexport function llmsFullTxt(doc: LlmsFullDoc): string {\n  const out: string[] = [`# ${doc.title}`];\n  if (doc.summary) out.push(\"\", `> ${doc.summary}`);\n  for (const section of doc.sections) {\n    out.push(\"\", \"---\", \"\", `## ${section.title}`);\n    if (section.url) out.push(\"\", `Source: ${section.url}`);\n    out.push(\"\", section.content.trim());\n  }\n  return out.join(\"\\n\") + \"\\n\";\n}\n\n/** Parse an `llms.txt` string back into a structured document. */\nexport function parseLlmsTxt(txt: string): LlmsDoc {\n  const lines = txt.split(/\\r?\\n/);\n  const doc: LlmsDoc = { title: \"\", sections: [] };\n  let current: LlmsSection | null = null;\n  const detailBuf: string[] = [];\n  const linkRe = /^-\\s*\\[([^\\]]+)\\]\\(([^)]+)\\)\\s*(?::\\s*(.*))?$/;\n\n  for (const raw of lines) {\n    const line = raw.trimEnd();\n    if (line.startsWith(\"# \")) {\n      doc.title = line.slice(2).trim();\n    } else if (line.startsWith(\"> \")) {\n      doc.summary = (doc.summary ? doc.summary + \" \" : \"\") + line.slice(2).trim();\n    } else if (line.startsWith(\"## \")) {\n      current = { title: line.slice(3).trim(), links: [] };\n      doc.sections.push(current);\n    } else if (current && linkRe.test(line)) {\n      const m = line.match(linkRe)!;\n      current.links.push({ title: m[1]!, url: m[2]!, notes: m[3]?.trim() || undefined });\n    } else if (!current && line && !line.startsWith(\"#\")) {\n      detailBuf.push(line);\n    }\n  }\n  const details = detailBuf.join(\"\\n\").trim();\n  if (details) doc.details = details;\n  return doc;\n}\n\n/* ------------------------------ from sitemap ------------------------------ */\n\n/** A sitemap-ish entry — accepts `url` or `loc`, plus optional title/section. */\nexport interface SitemapEntryLike {\n  url?: string;\n  loc?: string;\n  title?: string;\n  section?: string;\n}\n\nfunction titleFromUrl(url: string): string {\n  let path: string;\n  try {\n    path = new URL(url).pathname;\n  } catch {\n    path = url;\n  }\n  const seg = path.split(\"/\").filter(Boolean).pop();\n  if (!seg) return \"Home\";\n  return decodeURIComponent(seg).replace(/\\.[a-z]+$/i, \"\").replace(/[-_]+/g, \" \").replace(/\\b\\w/g, (c) => c.toUpperCase());\n}\n\n/**\n * Build an `llms.txt` from a list of sitemap entries — group by `section`,\n * derive titles from the URL when not given. Pairs with `@lacspace/sitemap`.\n */\nexport function llmsTxtFromSitemap(\n  entries: SitemapEntryLike[],\n  meta: { title: string; summary?: string; details?: string; defaultSection?: string },\n): string {\n  const bySection = new Map<string, LlmsLink[]>();\n  for (const e of entries) {\n    const url = e.url ?? e.loc;\n    if (!url) continue;\n    const section = e.section ?? meta.defaultSection ?? \"Pages\";\n    if (!bySection.has(section)) bySection.set(section, []);\n    bySection.get(section)!.push({ title: e.title ?? titleFromUrl(url), url });\n  }\n  const doc: LlmsDoc = {\n    title: meta.title,\n    summary: meta.summary,\n    details: meta.details,\n    sections: [...bySection].map(([title, links]) => ({ title, links })),\n  };\n  return llmsTxt(doc);\n}\n\n/* ------------------------------ adapters ------------------------------ */\n\n/** `llms.txt` as a Fetch/edge `Response` (text/plain) for app/llms.txt/route.ts. */\nexport function llmsTxtResponse(doc: LlmsDoc, init: ResponseInit = {}): Response {\n  return new Response(llmsTxt(doc), {\n    ...init,\n    headers: { \"content-type\": \"text/plain; charset=utf-8\", ...(init.headers ?? {}) },\n  });\n}\n\n/** `llms-full.txt` as a Fetch/edge `Response` (text/plain). */\nexport function llmsFullTxtResponse(doc: LlmsFullDoc, init: ResponseInit = {}): Response {\n  return new Response(llmsFullTxt(doc), {\n    ...init,\n    headers: { \"content-type\": \"text/plain; charset=utf-8\", ...(init.headers ?? {}) },\n  });\n}\n"]}
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * @lacspace/llms-txt\n * Generate and parse llms.txt and llms-full.txt (the llmstxt.org standard).\n *\n * llms.txt is a Markdown file at your site root that gives LLMs a curated map of\n * your most useful content; llms-full.txt inlines the full text so a model can\n * read everything in one request.\n *\n * Zero dependencies · isomorphic · fully typed.\n */\n\nexport interface LlmsLink {\n  title: string;\n  url: string;\n  /** Short note shown after the link. */\n  notes?: string;\n}\n\nexport interface LlmsSection {\n  title: string;\n  links: LlmsLink[];\n}\n\nexport interface LlmsDoc {\n  /** The site / project name (rendered as the H1). */\n  title: string;\n  /** One-line summary (rendered as a blockquote). */\n  summary?: string;\n  /** Free-form Markdown shown before the sections. */\n  details?: string;\n  sections: LlmsSection[];\n}\n\n/**\n * How to order the links inside each section.\n * - `\"title\"` / `\"url\"` — ascending by that field\n * - `\"title-desc\"` / `\"url-desc\"` — descending\n * - a comparator — full control\n * Sections keep their array order; only the links within a section are sorted.\n */\nexport type LinkSort =\n  | \"title\"\n  | \"url\"\n  | \"title-desc\"\n  | \"url-desc\"\n  | ((a: LlmsLink, b: LlmsLink) => number);\n\n/** Options accepted by the rendering helpers. */\nexport interface LlmsTxtOptions {\n  /** Order links within each section. Omit to keep the given order. */\n  sort?: LinkSort;\n}\n\nfunction sortLinks(links: LlmsLink[], sort?: LinkSort): LlmsLink[] {\n  if (!sort) return links;\n  const copy = links.slice();\n  if (typeof sort === \"function\") return copy.sort(sort);\n  const [field, dir] = sort.split(\"-\") as [\"title\" | \"url\", \"desc\" | undefined];\n  const factor = dir === \"desc\" ? -1 : 1;\n  return copy.sort((a, b) => factor * a[field].localeCompare(b[field]));\n}\n\n/**\n * Render an `llms.txt` document.\n * @param opts optional rendering options (e.g. `{ sort: \"title\" }`).\n * @example\n * llmsTxt({\n *   title: \"Lacspace\",\n *   summary: \"Open-source TypeScript packages and products.\",\n *   sections: [{ title: \"Docs\", links: [{ title: \"Packages\", url: \"https://lacspace.com/packages\" }] }],\n * });\n */\nexport function llmsTxt(doc: LlmsDoc, opts: LlmsTxtOptions = {}): string {\n  const out: string[] = [`# ${doc.title}`];\n  if (doc.summary) out.push(\"\", `> ${doc.summary}`);\n  if (doc.details) out.push(\"\", doc.details.trim());\n  for (const section of doc.sections) {\n    out.push(\"\", `## ${section.title}`, \"\");\n    for (const l of sortLinks(section.links, opts.sort)) {\n      out.push(`- [${l.title}](${l.url})${l.notes ? `: ${l.notes}` : \"\"}`);\n    }\n  }\n  return out.join(\"\\n\") + \"\\n\";\n}\n\nexport interface LlmsFullSection {\n  title: string;\n  /** Full Markdown content for this section. */\n  content: string;\n  /** Optional source URL, added as a heading link. */\n  url?: string;\n}\n\nexport interface LlmsFullDoc {\n  title: string;\n  summary?: string;\n  sections: LlmsFullSection[];\n}\n\n/** Render an `llms-full.txt` document with the full content inlined. */\nexport function llmsFullTxt(doc: LlmsFullDoc): string {\n  const out: string[] = [`# ${doc.title}`];\n  if (doc.summary) out.push(\"\", `> ${doc.summary}`);\n  for (const section of doc.sections) {\n    out.push(\"\", \"---\", \"\", `## ${section.title}`);\n    if (section.url) out.push(\"\", `Source: ${section.url}`);\n    out.push(\"\", section.content.trim());\n  }\n  return out.join(\"\\n\") + \"\\n\";\n}\n\n/** Parse an `llms.txt` string back into a structured document. */\nexport function parseLlmsTxt(txt: string): LlmsDoc {\n  const lines = txt.split(/\\r?\\n/);\n  const doc: LlmsDoc = { title: \"\", sections: [] };\n  let current: LlmsSection | null = null;\n  const detailBuf: string[] = [];\n  const linkRe = /^-\\s*\\[([^\\]]+)\\]\\(([^)]+)\\)\\s*(?::\\s*(.*))?$/;\n\n  for (const raw of lines) {\n    const line = raw.trimEnd();\n    if (line.startsWith(\"# \")) {\n      doc.title = line.slice(2).trim();\n    } else if (line.startsWith(\"> \")) {\n      doc.summary = (doc.summary ? doc.summary + \" \" : \"\") + line.slice(2).trim();\n    } else if (line.startsWith(\"## \")) {\n      current = { title: line.slice(3).trim(), links: [] };\n      doc.sections.push(current);\n    } else if (current && linkRe.test(line)) {\n      const m = line.match(linkRe)!;\n      current.links.push({ title: m[1]!, url: m[2]!, notes: m[3]?.trim() || undefined });\n    } else if (!current && line && !line.startsWith(\"#\")) {\n      detailBuf.push(line);\n    }\n  }\n  const details = detailBuf.join(\"\\n\").trim();\n  if (details) doc.details = details;\n  return doc;\n}\n\n/* ------------------------------ from sitemap ------------------------------ */\n\n/** A sitemap-ish entry — accepts `url` or `loc`, plus optional title/section. */\nexport interface SitemapEntryLike {\n  url?: string;\n  loc?: string;\n  title?: string;\n  section?: string;\n}\n\nfunction titleFromUrl(url: string): string {\n  let path: string;\n  try {\n    path = new URL(url).pathname;\n  } catch {\n    path = url;\n  }\n  const seg = path.split(\"/\").filter(Boolean).pop();\n  if (!seg) return \"Home\";\n  let decoded: string;\n  try {\n    decoded = decodeURIComponent(seg);\n  } catch {\n    // Malformed percent-encoding — fall back to the raw segment instead of throwing.\n    decoded = seg;\n  }\n  return decoded.replace(/\\.[a-z]+$/i, \"\").replace(/[-_]+/g, \" \").replace(/\\b\\w/g, (c) => c.toUpperCase());\n}\n\n/** First path segment of a URL, title-cased, for auto-sectioning (\"/docs/x\" → \"Docs\"). */\nfunction sectionFromUrl(url: string): string {\n  let path: string;\n  try {\n    path = new URL(url).pathname;\n  } catch {\n    path = url;\n  }\n  const seg = path.split(\"/\").filter(Boolean)[0];\n  if (!seg) return \"Home\";\n  let decoded: string;\n  try {\n    decoded = decodeURIComponent(seg);\n  } catch {\n    decoded = seg;\n  }\n  return decoded.replace(/\\.[a-z]+$/i, \"\").replace(/[-_]+/g, \" \").replace(/\\b\\w/g, (c) => c.toUpperCase());\n}\n\n/** Pull `<loc>` values out of a sitemap (or sitemap-index) XML string. */\nfunction parseSitemapXml(xml: string): SitemapEntryLike[] {\n  const out: SitemapEntryLike[] = [];\n  const re = /<loc>\\s*([\\s\\S]*?)\\s*<\\/loc>/gi;\n  let m: RegExpExecArray | null;\n  while ((m = re.exec(xml))) {\n    const loc = m[1]!\n      .trim()\n      .replace(/&amp;/g, \"&\")\n      .replace(/&lt;/g, \"<\")\n      .replace(/&gt;/g, \">\")\n      .replace(/&quot;/g, '\"')\n      .replace(/&apos;/g, \"'\");\n    if (loc) out.push({ loc });\n  }\n  return out;\n}\n\n/** Meta / options for {@link llmsTxtFromSitemap}. */\nexport interface SitemapToLlmsMeta extends LlmsTxtOptions {\n  title: string;\n  summary?: string;\n  details?: string;\n  /** Fallback section name when an entry has none. Default `\"Pages\"`. */\n  defaultSection?: string;\n  /**\n   * When an entry has no explicit `section`, derive one from the first path\n   * segment (\"/docs/x\" → \"Docs\") instead of using {@link defaultSection}.\n   */\n  sectionFromPath?: boolean;\n}\n\n/**\n * Build an `llms.txt` from sitemap entries — accepts either an **array** of\n * `{ loc | url, title?, section? }` entries or a raw **sitemap XML string**.\n * Groups by `section` (or, with `sectionFromPath`, by the first path segment),\n * derives titles from the URL when not given, and de-duplicates repeated URLs.\n * Pairs with `@lacspace/sitemap`. The original array signature is unchanged.\n */\nexport function llmsTxtFromSitemap(\n  entries: SitemapEntryLike[] | string,\n  meta: SitemapToLlmsMeta,\n): string {\n  const list = typeof entries === \"string\" ? parseSitemapXml(entries) : entries;\n  const bySection = new Map<string, LlmsLink[]>();\n  const order: string[] = [];\n  const seen = new Set<string>();\n  for (const e of list) {\n    const url = e.url ?? e.loc;\n    if (!url || seen.has(url)) continue;\n    seen.add(url);\n    const section =\n      e.section ?? (meta.sectionFromPath ? sectionFromUrl(url) : meta.defaultSection ?? \"Pages\");\n    if (!bySection.has(section)) {\n      bySection.set(section, []);\n      order.push(section);\n    }\n    bySection.get(section)!.push({ title: e.title ?? titleFromUrl(url), url });\n  }\n  const doc: LlmsDoc = {\n    title: meta.title,\n    summary: meta.summary,\n    details: meta.details,\n    sections: order.map((title) => ({ title, links: bySection.get(title)! })),\n  };\n  return llmsTxt(doc, { sort: meta.sort });\n}\n\n/* ------------------------------ from routes ------------------------------ */\n\n/** A single route/page entry for {@link llmsTxtFromRoutes}. */\nexport interface LlmsRoute {\n  title: string;\n  url: string;\n  notes?: string;\n  /** Section heading to group under. Defaults to {@link RoutesToLlmsMeta.defaultSection}. */\n  section?: string;\n}\n\n/** Meta / options for {@link llmsTxtFromRoutes}. */\nexport interface RoutesToLlmsMeta extends LlmsTxtOptions {\n  title: string;\n  summary?: string;\n  details?: string;\n  /** Section name for routes with no `section`. Default `\"Docs\"`. */\n  defaultSection?: string;\n}\n\n/**\n * Build an `llms.txt` from a flat list of route entries, grouping by `section`\n * (first-seen order preserved). Titles and notes are used verbatim.\n * @example\n * llmsTxtFromRoutes(\n *   [\n *     { title: \"Home\", url: \"https://acme.com/\", section: \"Start\" },\n *     { title: \"API\", url: \"https://acme.com/api\", notes: \"reference\", section: \"Docs\" },\n *   ],\n *   { title: \"Acme\", summary: \"Acme docs\" },\n * );\n */\nexport function llmsTxtFromRoutes(routes: LlmsRoute[], meta: RoutesToLlmsMeta): string {\n  const bySection = new Map<string, LlmsLink[]>();\n  const order: string[] = [];\n  for (const r of routes) {\n    const section = r.section ?? meta.defaultSection ?? \"Docs\";\n    if (!bySection.has(section)) {\n      bySection.set(section, []);\n      order.push(section);\n    }\n    bySection.get(section)!.push({ title: r.title, url: r.url, notes: r.notes });\n  }\n  const doc: LlmsDoc = {\n    title: meta.title,\n    summary: meta.summary,\n    details: meta.details,\n    sections: order.map((title) => ({ title, links: bySection.get(title)! })),\n  };\n  return llmsTxt(doc, { sort: meta.sort });\n}\n\n/* ------------------------------ adapters ------------------------------ */\n\n/** `llms.txt` as a Fetch/edge `Response` (text/plain) for app/llms.txt/route.ts. */\nexport function llmsTxtResponse(doc: LlmsDoc, init: ResponseInit = {}): Response {\n  return new Response(llmsTxt(doc), {\n    ...init,\n    headers: { \"content-type\": \"text/plain; charset=utf-8\", ...(init.headers ?? {}) },\n  });\n}\n\n/** `llms-full.txt` as a Fetch/edge `Response` (text/plain). */\nexport function llmsFullTxtResponse(doc: LlmsFullDoc, init: ResponseInit = {}): Response {\n  return new Response(llmsFullTxt(doc), {\n    ...init,\n    headers: { \"content-type\": \"text/plain; charset=utf-8\", ...(init.headers ?? {}) },\n  });\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lacspace/llms-txt",
-  "version": "1.2.1",
+  "version": "1.3.0",
   "description": "Generate and parse llms.txt and llms-full.txt (the llmstxt.org standard) — a Markdown map of your site for LLMs. Zero-dependency, isomorphic.",
   "type": "module",
   "main": "./dist/index.cjs",