sourcey 3.6.0 → 3.6.2

package/dist/renderer/changelog-feed.js

@@ -1,12 +1,15 @@
+import { renderMarkdownInline } from "../utils/markdown.js";
 export function generateChangelogFeeds(page, options) {
     const buildDate = options.buildDate ?? new Date();
-    const updated = page.changelog.versions
-        .map((version) => version.date ? new Date(`${version.date}T00:00:00Z`) : null)
-        .find(Boolean) ?? buildDate;
+    const datedVersions = page.changelog.versions
+        .map((version) => (version.date ? new Date(`${version.date}T00:00:00Z`).getTime() : NaN))
+        .filter(Number.isFinite);
+    const updated = datedVersions.length ? new Date(Math.max(...datedVersions)) : buildDate;
     const title = options.title ?? [options.siteName, page.title].filter(Boolean).join(" ").trim();
     const description = options.description ?? page.description ?? `${page.title} feed`;
     const feedId = toFeedId(options.atomPath);
-    const atomEntries = page.changelog.versions.map((version) => {
+    const atomEntries = page.changelog.versions
+        .map((version) => {
         const href = options.versionHref(version);
         const content = renderVersionHtml(version);
         const updatedAt = version.date ? new Date(`${version.date}T00:00:00Z`) : updated;
@@ -20,25 +23,28 @@ export function generateChangelogFeeds(page, options) {
             `    <content type="html">${escapeXml(content)}</content>`,
             "  </entry>",
         ].join("\n");
-    }).join("\n");
+    })
+        .join("\n");
     const atom = [
         `<?xml version="1.0" encoding="UTF-8"?>`,
         `<feed xmlns="http://www.w3.org/2005/Atom">`,
         `  <title>${escapeXml(title)}</title>`,
         `  <id>${escapeXml(feedId)}</id>`,
         `  <updated>${updated.toISOString()}</updated>`,
+        `  <author><name>${escapeXml(options.siteName || title)}</name></author>`,
         `  <subtitle>${escapeXml(description)}</subtitle>`,
         `  <link rel="self" href="${escapeXml(options.atomPath)}" />`,
         `  <link href="${escapeXml(options.pagePath)}" />`,
         page.changelog.versions.length ? atomEntries : "",
         `</feed>`,
-    ].filter(Boolean).join("\n");
-    const rssItems = page.changelog.versions.map((version) => {
+    ]
+        .filter(Boolean)
+        .join("\n");
+    const rssItems = page.changelog.versions
+        .map((version) => {
         const href = options.versionHref(version);
         const label = version.version ?? "Unreleased";
-        const pubDate = version.date
-            ? new Date(`${version.date}T00:00:00Z`)
-            : updated;
+        const pubDate = version.date ? new Date(`${version.date}T00:00:00Z`) : updated;
         return [
             "    <item>",
             `      <title>${escapeXml(label)}</title>`,
@@ -48,7 +54,8 @@ export function generateChangelogFeeds(page, options) {
             `      <description>${escapeXml(renderVersionHtml(version))}</description>`,
             "    </item>",
         ].join("\n");
-    }).join("\n");
+    })
+        .join("\n");
     const rss = [
         `<?xml version="1.0" encoding="UTF-8"?>`,
         `<rss version="2.0">`,
@@ -59,15 +66,19 @@ export function generateChangelogFeeds(page, options) {
         page.changelog.versions.length ? rssItems : "",
         `  </channel>`,
         `</rss>`,
-    ].filter(Boolean).join("\n");
+    ]
+        .filter(Boolean)
+        .join("\n");
     return { atom, rss };
 }
 function renderVersionHtml(version) {
-    const summary = version.summary ? `<p>${escapeHtml(version.summary)}</p>` : "";
-    const sections = version.sections.map((section) => {
+    const summary = version.summary ? `<p>${renderMarkdownInline(version.summary)}</p>` : "";
+    const sections = version.sections
+        .map((section) => {
         const items = section.entries.map((entry) => `<li>${entry.html}</li>`).join("");
         return `<section><h3>${escapeHtml(section.label)}</h3><ul>${items}</ul></section>`;
-    }).join("");
+    })
+        .join("");
     return `<article><h2>${escapeHtml(version.version ?? "Unreleased")}</h2>${summary}${sections}</article>`;
 }
 function escapeXml(value) {
@@ -79,10 +90,7 @@ function escapeXml(value) {
         .replace(/'/g, "&apos;");
 }
 function escapeHtml(value) {
-    return value
-        .replace(/&/g, "&amp;")
-        .replace(/</g, "&lt;")
-        .replace(/>/g, "&gt;");
+    return value.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
 }
 function toFeedId(value) {
     if (value.startsWith("http://") || value.startsWith("https://"))

package/dist/renderer/context.d.ts

@@ -63,6 +63,7 @@ export declare const PageContext: import("preact").Context<CurrentPage>;
  */
 export interface SiteConfig {
     name: string;
+    titleSeparator: string;
     siteUrl?: string;
     baseUrl: string;
     prettyUrls: PrettyUrls;

package/dist/renderer/context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/renderer/context.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC9E,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,uBAAuB,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAEnG,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,mEAAmE;IACnE,UAAU,EAAE,OAAO,CAAC;IACpB,oCAAoC;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,oEAAoE;IACpE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iDAAiD;IACjD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,wDAAwD;IACxD,cAAc,CAAC,EAAE,aAAa,EAAE,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,cAAc,CAAC;IACrB,OAAO,EAAE,aAAa,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,MAAM,WAAW,GACnB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,cAAc,CAAA;CAAE,GACtC;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,EAAE,YAAY,CAAA;CAAE,GAC5C;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,SAAS,EAAE,aAAa,CAAA;CAAE,CAAC;AAEpD;;GAEG;AACH,eAAO,MAAM,WAAW,0CAA+C,CAAC;AAExE;;GAEG;AACH,eAAO,MAAM,cAAc,yCAGzB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,iBAAiB,0CAA+C,CAAC;AAE9E;;GAEG;AACH,eAAO,MAAM,WAAW,uCAA4C,CAAC;AAErE;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,UAAU,CAAC;IACvB,KAAK,EAAE,aAAa,CAAC;IACrB,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACxD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,MAAM,EAAE;QAAE,KAAK,EAAE,UAAU,EAAE,CAAC;QAAC,OAAO,CAAC,EAAE;YAAE,IAAI,EAAE,QAAQ,CAAC;YAAC,KAAK,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAC;IAC3F,MAAM,EAAE;QAAE,KAAK,EAAE,UAAU,EAAE,CAAA;KAAE,CAAC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,uBAAuB,CAAC;CACpC;AAED,eAAO,MAAM,WAAW,sCAA2C,CAAC"}
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/renderer/context.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC9E,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,uBAAuB,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAEnG,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,mEAAmE;IACnE,UAAU,EAAE,OAAO,CAAC;IACpB,oCAAoC;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,oEAAoE;IACpE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iDAAiD;IACjD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,wDAAwD;IACxD,cAAc,CAAC,EAAE,aAAa,EAAE,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,cAAc,CAAC;IACrB,OAAO,EAAE,aAAa,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,MAAM,WAAW,GACnB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,cAAc,CAAA;CAAE,GACtC;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,EAAE,YAAY,CAAA;CAAE,GAC5C;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,SAAS,EAAE,aAAa,CAAA;CAAE,CAAC;AAEpD;;GAEG;AACH,eAAO,MAAM,WAAW,0CAA+C,CAAC;AAExE;;GAEG;AACH,eAAO,MAAM,cAAc,yCAGzB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,iBAAiB,0CAA+C,CAAC;AAE9E;;GAEG;AACH,eAAO,MAAM,WAAW,uCAA4C,CAAC;AAErE;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,UAAU,CAAC;IACvB,KAAK,EAAE,aAAa,CAAC;IACrB,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACxD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,MAAM,EAAE;QAAE,KAAK,EAAE,UAAU,EAAE,CAAC;QAAC,OAAO,CAAC,EAAE;YAAE,IAAI,EAAE,QAAQ,CAAC;YAAC,KAAK,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAC;IAC3F,MAAM,EAAE;QAAE,KAAK,EAAE,UAAU,EAAE,CAAA;KAAE,CAAC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,uBAAuB,CAAC;CACpC;AAED,eAAO,MAAM,WAAW,sCAA2C,CAAC"}

package/dist/renderer/html-builder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"html-builder.d.ts","sourceRoot":"","sources":["../../src/renderer/html-builder.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1F,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AA2B5D,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,QAAQ;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,WAAW,CAAC;IACzB,IAAI,EAAE,cAAc,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,iEAAiE;IACjE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,aAAa,EAAE,CAAC;CAClC;AAED,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,QAAQ,EACd,IAAI,EAAE,UAAU,EAChB,OAAO,CAAC,EAAE;IACR,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GACA,aAAa,CAcf;AAED;;GAEG;AACH,wBAAsB,SAAS,CAC7B,KAAK,EAAE,QAAQ,EAAE,EACjB,UAAU,EAAE,cAAc,EAC1B,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,UAAU,EAChB,OAAO,CAAC,EAAE;IACR,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,UAAU,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;CAC3C,GACA,OAAO,CAAC,WAAW,CAAC,CA8EtB"}
+{"version":3,"file":"html-builder.d.ts","sourceRoot":"","sources":["../../src/renderer/html-builder.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1F,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAiC5D,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,QAAQ;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,WAAW,CAAC;IACzB,IAAI,EAAE,cAAc,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,iEAAiE;IACjE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,aAAa,EAAE,CAAC;CAClC;AAED,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,QAAQ,EACd,IAAI,EAAE,UAAU,EAChB,OAAO,CAAC,EAAE;IACR,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GACA,aAAa,CAcf;AAED;;GAEG;AACH,wBAAsB,SAAS,CAC7B,KAAK,EAAE,QAAQ,EAAE,EACjB,UAAU,EAAE,cAAc,EAC1B,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,UAAU,EAChB,OAAO,CAAC,EAAE;IACR,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,UAAU,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;CAC3C,GACA,OAAO,CAAC,WAAW,CAAC,CA8EtB"}

package/dist/renderer/html-builder.js

@@ -7,6 +7,7 @@ import preact from "@preact/preset-vite";
 import { renderPage } from "./static-renderer.js";
 import { withActivePage } from "../core/navigation.js";
 import { isAbsoluteHttpUrl, toAbsoluteUrl, toPublicPath } from "../site-url.js";
+import { escapeHtml as escapeXml } from "../utils/html.js";
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const projectRoot = resolve(__dirname, "../..");
 async function exists(path) {
@@ -27,8 +28,8 @@ async function resolveAssetPaths() {
     const distClient = resolve(projectRoot, "dist/client/index.js");
     const srcCss = resolve(projectRoot, "src/themes/default/sourcey.css");
     const distCss = resolve(projectRoot, "dist/themes/default/sourcey.css");
-    const clientEntry = await exists(srcClient) ? srcClient : distClient;
-    const sourceyCssPath = await exists(srcCss) ? srcCss : distCss;
+    const clientEntry = (await exists(srcClient)) ? srcClient : distClient;
+    const sourceyCssPath = (await exists(srcCss)) ? srcCss : distCss;
     return { clientEntry, sourceyCssPath };
 }
 export function createRenderOptions(page, site, options) {
@@ -88,7 +89,7 @@ export async function buildSite(pages, navigation, outputDir, site, options) {
     const urls = pages.map((page) => {
         const publicPath = toPublicPath(page.outputPath, site.baseUrl, site.prettyUrls);
         const loc = site.siteUrl ? toAbsoluteUrl(publicPath, site.siteUrl) : publicPath;
-        return `  <url><loc>${loc}</loc></url>`;
+        return `  <url><loc>${escapeXml(loc)}</loc></url>`;
     });
     const sitemap = [
         `<?xml version="1.0" encoding="UTF-8"?>`,

package/dist/renderer/llms.js

@@ -41,7 +41,7 @@ export function generateLlmsTxt(pages, navigation, site) {
                 if (op.hidden)
                     continue;
                 const opLabel = op.summary ?? operationDisplayName(op);
-                const opSummary = [operationKind(op), firstLine(op.description)].filter(Boolean).join(" — ");
+                const opSummary = [operationKind(op), firstLine(op.description)].filter(Boolean).join(" - ");
                 lines.push(`- [${opLabel}](${href(page)}#${operationAnchor(op)})${opSummary ? `: ${opSummary}` : ""}`);
             }
         }
@@ -92,6 +92,15 @@ function appendMarkdownPage(lines, page, site) {
         lines.push(doc.description);
         lines.push("");
     }
+    const isRustdoc = doc.sourcePath?.startsWith("rustdoc/");
+    if (isRustdoc) {
+        const body = stripHtmlPreservingRustDoctests(doc.html);
+        if (body) {
+            lines.push(body);
+            lines.push("");
+        }
+        return;
+    }
     const body = stripHtml(doc.html);
     if (body) {
         lines.push(body);
@@ -207,7 +216,7 @@ function appendOperation(lines, op) {
             const type = param.schema
                 ? formatSchemaType(param.schema)
                 : firstContentSchemaType(param.content);
-            const desc = param.description ? ` — ${firstLine(param.description)}` : "";
+            const desc = param.description ? ` - ${firstLine(param.description)}` : "";
             lines.push(`- \`${param.name}\` (${param.in}, ${type}, ${req})${desc}`);
         }
         lines.push("");
@@ -337,6 +346,52 @@ function stripHtml(html) {
         .replace(/\s+/g, " ")
         .trim();
 }
+/**
+ * Like stripHtml but preserves rustdoc doctest <pre><code> blocks as
+ * fenced ```rust ... ``` so they remain useful as runnable examples in
+ * llms-full.txt. Section headings and item names are also kept.
+ */
+function stripHtmlPreservingRustDoctests(html) {
+    const tokens = [];
+    const sectionRe = /<section class="rust-item rust-([a-z_]+) api-item"[^>]*>([\s\S]*?)<\/section>/g;
+    let lastIndex = 0;
+    let prose = "";
+    for (const match of html.matchAll(sectionRe)) {
+        prose += html.slice(lastIndex, match.index ?? 0);
+        lastIndex = (match.index ?? 0) + match[0].length;
+        tokens.push(formatRustItemForLlms(match[2], match[1]));
+    }
+    prose += html.slice(lastIndex);
+    const proseText = stripHtml(prose);
+    const parts = [];
+    if (proseText)
+        parts.push(proseText);
+    if (tokens.length > 0)
+        parts.push(tokens.join("\n\n"));
+    return parts.join("\n\n").trim();
+}
+function formatRustItemForLlms(inner, kind) {
+    const titleMatch = inner.match(/<h4[^>]*class="[^"]*code-header[^"]*"[^>]*>([\s\S]*?)<\/h4>/);
+    const title = titleMatch ? stripHtml(titleMatch[1]) : "";
+    const docMatch = inner.match(/<div class="docblock[^"]*"[^>]*>([\s\S]*?)<\/div>/);
+    const docText = docMatch ? stripHtml(docMatch[1]) : "";
+    // The visible doctest renders through the shared Shiki code block. Match the
+    // `rust-doctest-code` wrapper (exact class, so the hidden `-full` variant is
+    // skipped), pull the inner Shiki <code>, then strip span tags while keeping
+    // line breaks so the extracted code stays readable.
+    const doctests = Array.from(inner.matchAll(/<div class="rust-doctest-code" id="[^"]*">[\s\S]*?<pre class="shiki[^"]*"[^>]*><code[^>]*>([\s\S]*?)<\/code><\/pre>/g)).map((m) => decodeEntities(m[1].replace(/<[^>]+>/g, "")).replace(/\n{3,}/g, "\n\n").trimEnd());
+    const out = [];
+    if (title)
+        out.push(`#### ${kind}: ${title}`);
+    if (docText)
+        out.push(docText);
+    for (const code of doctests) {
+        out.push("```rust");
+        out.push(code);
+        out.push("```");
+    }
+    return out.join("\n");
+}
 function decodeEntities(text) {
     return text
         .replace(/&nbsp;/g, " ")

package/dist/site-assembly.d.ts

@@ -1,4 +1,5 @@
 import { type GodocLoaderDiagnostic } from "./core/godoc-loader.js";
+import { type RustdocLoaderDiagnostic } from "./core/rustdoc-loader.js";
 import type { PrettyUrls, ResolvedConfig, ResolvedTab } from "./config.js";
 import type { DocsPage } from "./core/markdown-loader.js";
 import type { SiteTab } from "./core/navigation.js";
@@ -12,10 +13,14 @@ export interface SiteAssembly {
     pageMap: Map<string, SitePage>;
     changelogDiagnostics: ChangelogDiagnostic[];
     godocDiagnostics: GodocLoaderDiagnostic[];
+    rustdocDiagnostics: RustdocLoaderDiagnostic[];
     extraFiles: Map<string, string | Buffer>;
 }
 export declare function assembleSite(config: ResolvedConfig): Promise<SiteAssembly>;
 export declare function formatGodocDiagnostic(diag: GodocLoaderDiagnostic): string;
+export declare function enforceGodocDiagnostics(diagnostics: GodocLoaderDiagnostic[]): void;
+export declare function enforceRustdocDiagnostics(diagnostics: RustdocLoaderDiagnostic[]): void;
+export declare function formatRustdocDiagnostic(diagnostic: RustdocLoaderDiagnostic): string;
 export declare function collectDocsPagesByTab(pageMap: Map<string, SitePage>, tabs: ResolvedTab[]): Map<string, DocsPage[]>;
 export declare function rebuildMarkdownTabNavigation(pageMap: Map<string, SitePage>, siteTabs: SiteTab[], tabs: ResolvedTab[], tabSlug: string, prettyUrls: PrettyUrls): void;
 export declare function enforceChangelogDiagnostics(diagnostics: ChangelogDiagnostic[], strictChangelog?: boolean): void;

package/dist/site-assembly.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"site-assembly.d.ts","sourceRoot":"","sources":["../src/site-assembly.ts"],"names":[],"mappings":"AASA,OAAO,EAAgB,KAAK,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAIlF,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC3E,OAAO,KAAK,EAAiB,QAAQ,EAAgB,MAAM,2BAA2B,CAAC;AAEvF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,KAAK,EACV,mBAAmB,EAEnB,cAAc,EACf,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAGxD,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,WAAW,EAAE,cAAc,CAAC;IAC5B,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IACzC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAC/B,oBAAoB,EAAE,mBAAmB,EAAE,CAAC;IAC5C,gBAAgB,EAAE,qBAAqB,EAAE,CAAC;IAC1C,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;CAC1C;AAED,wBAAsB,YAAY,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,YAAY,CAAC,CAmIhF;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,qBAAqB,GAAG,MAAM,CAKzE;AAED,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,EAC9B,IAAI,EAAE,WAAW,EAAE,GAClB,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAC,CAoBzB;AAED,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,EAC9B,QAAQ,EAAE,OAAO,EAAE,EACnB,IAAI,EAAE,WAAW,EAAE,EACnB,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,UAAU,GACrB,IAAI,CAsBN;AAaD,wBAAgB,2BAA2B,CACzC,WAAW,EAAE,mBAAmB,EAAE,EAClC,eAAe,UAAQ,GACtB,IAAI,CAYN;AAED,wBAAgB,yBAAyB,CAAC,UAAU,EAAE,mBAAmB,GAAG,MAAM,CAIjF;AAED,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,mBAAmB,GAAG,MAAM,CAI9E;AAED,wBAAgB,0BAA0B,CAAC,WAAW,EAAE,mBAAmB,EAAE,GAAG,MAAM,EAAE,CAEvF;AAED,wBAAsB,eAAe,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,UAAU,CAAC,CA4BjF;AAED,wBAAgB,iBAAiB,IAAI,cAAc,CAUlD;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,MAAM,EAAE,cAAc,GAAG,IAAI,CA6FpF"}
+{"version":3,"file":"site-assembly.d.ts","sourceRoot":"","sources":["../src/site-assembly.ts"],"names":[],"mappings":"AASA,OAAO,EAAgB,KAAK,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAClF,OAAO,EAAkB,KAAK,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AAIxF,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC3E,OAAO,KAAK,EAAiB,QAAQ,EAAgB,MAAM,2BAA2B,CAAC;AAEvF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,KAAK,EACV,mBAAmB,EAEnB,cAAc,EACf,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAGxD,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,WAAW,EAAE,cAAc,CAAC;IAC5B,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IACzC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAC/B,oBAAoB,EAAE,mBAAmB,EAAE,CAAC;IAC5C,gBAAgB,EAAE,qBAAqB,EAAE,CAAC;IAC1C,kBAAkB,EAAE,uBAAuB,EAAE,CAAC;IAC9C,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;CAC1C;AAED,wBAAsB,YAAY,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,YAAY,CAAC,CAiKhF;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,qBAAqB,GAAG,MAAM,CAKzE;AAED,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,qBAAqB,EAAE,GAAG,IAAI,CAGlF;AAED,wBAAgB,yBAAyB,CAAC,WAAW,EAAE,uBAAuB,EAAE,GAAG,IAAI,CAGtF;AAUD,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,uBAAuB,GAAG,MAAM,CAMnF;AAUD,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,EAC9B,IAAI,EAAE,WAAW,EAAE,GAClB,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAC,CAoBzB;AAED,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,EAC9B,QAAQ,EAAE,OAAO,EAAE,EACnB,IAAI,EAAE,WAAW,EAAE,EACnB,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,UAAU,GACrB,IAAI,CAsBN;AAaD,wBAAgB,2BAA2B,CACzC,WAAW,EAAE,mBAAmB,EAAE,EAClC,eAAe,UAAQ,GACtB,IAAI,CAYN;AAED,wBAAgB,yBAAyB,CAAC,UAAU,EAAE,mBAAmB,GAAG,MAAM,CAIjF;AAED,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,mBAAmB,GAAG,MAAM,CAI9E;AAED,wBAAgB,0BAA0B,CAAC,WAAW,EAAE,mBAAmB,EAAE,GAAG,MAAM,EAAE,CAEvF;AAED,wBAAsB,eAAe,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,UAAU,CAAC,CA6BjF;AAED,wBAAgB,iBAAiB,IAAI,cAAc,CAUlD;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,MAAM,EAAE,cAAc,GAAG,IAAI,CA6FpF"}

package/dist/site-assembly.js

@@ -8,6 +8,7 @@ import { normalizeMcpSpec } from "./core/mcp-normalizer.js";
 import { loadDocsPage, slugFromPath } from "./core/markdown-loader.js";
 import { loadDoxygenTab } from "./core/doxygen-loader.js";
 import { loadGodocTab } from "./core/godoc-loader.js";
+import { loadRustdocTab } from "./core/rustdoc-loader.js";
 import { buildNavFromSpec, buildNavFromPages } from "./core/navigation.js";
 import { generateChangelogFeeds } from "./renderer/changelog-feed.js";
 import { pageOutputPath, tabIndexOutputPath, tabPath } from "./config.js";
@@ -19,6 +20,7 @@ export async function assembleSite(config) {
     const siteTabs = [];
     const changelogDiagnostics = [];
     const godocDiagnostics = [];
+    const rustdocDiagnostics = [];
     for (const tab of config.tabs) {
         if (tab.source.kind === "openapi" || tab.source.kind === "mcp") {
             const spec = specsBySlug.get(tab.slug);
@@ -36,7 +38,7 @@ export async function assembleSite(config) {
             continue;
         }
         if (tab.source.kind === "doxygen") {
-            const { pages, navTab } = await loadDoxygenTab(tab.source.config, tab.slug, tab.label);
+            const { pages, navTab } = await loadDoxygenTab(tab.source.config, tab.slug, tab.label, config.titleSeparator);
             for (const [slug, page] of pages) {
                 const outputPath = pageOutputPath(tab.slug, slug, config.prettyUrls);
                 pageMap.set(outputPath, {
@@ -70,6 +72,26 @@ export async function assembleSite(config) {
             siteTabs.push(navTab);
             continue;
         }
+        if (tab.source.kind === "rustdoc") {
+            const { pages, navTab, diagnostics } = await loadRustdocTab(tab.source.config, tab.slug, tab.label, {
+                repo: config.repo,
+                editBranch: config.editBranch,
+                editBasePath: tab.source.config.sourceBasePath,
+            });
+            rustdocDiagnostics.push(...diagnostics);
+            for (const [slug, page] of pages) {
+                const outputPath = pageOutputPath(tab.slug, slug, config.prettyUrls);
+                pageMap.set(outputPath, {
+                    outputPath,
+                    currentPage: { kind: "markdown", markdown: page },
+                    spec: primarySpec,
+                    tabSlug: tab.slug,
+                    pageSlug: slug,
+                });
+            }
+            siteTabs.push(navTab);
+            continue;
+        }
         if (tab.source.kind !== "markdown")
             continue;
         const pagesByPath = new Map();
@@ -121,6 +143,7 @@ export async function assembleSite(config) {
         pageMap,
         changelogDiagnostics,
         godocDiagnostics,
+        rustdocDiagnostics,
         extraFiles,
     };
 }
@@ -130,6 +153,37 @@ export function formatGodocDiagnostic(diag) {
     const loc = diag.file ? ` ${diag.file}${diag.line ? `:${diag.line}` : ""}` : "";
     return `[${sev}] ${diag.code}${where}${loc} ${diag.message}`;
 }
+export function enforceGodocDiagnostics(diagnostics) {
+    const error = diagnostics.find((diagnostic) => diagnostic.severity === "error");
+    if (error)
+        throw new Error(formatGodocFailure(error));
+}
+export function enforceRustdocDiagnostics(diagnostics) {
+    const error = diagnostics.find((diagnostic) => diagnostic.severity === "error");
+    if (error)
+        throw new Error(formatRustdocFailure(error));
+}
+function formatGodocFailure(diagnostic) {
+    const where = diagnostic.package ? ` (${diagnostic.package})` : "";
+    const loc = diagnostic.file
+        ? ` ${diagnostic.file}${diagnostic.line ? `:${diagnostic.line}` : ""}`
+        : "";
+    return `[${diagnostic.code}]${where}${loc}: ${diagnostic.message}`;
+}
+export function formatRustdocDiagnostic(diagnostic) {
+    const location = diagnostic.file
+        ? ` ${diagnostic.file}${diagnostic.line ? `:${diagnostic.line}` : ""}`
+        : "";
+    const cratePrefix = diagnostic.crate ? ` [${diagnostic.crate}]` : "";
+    return `[${diagnostic.severity.toUpperCase()}] ${diagnostic.code}${cratePrefix}${location} ${diagnostic.message}`;
+}
+function formatRustdocFailure(diagnostic) {
+    const location = diagnostic.file
+        ? ` ${diagnostic.file}${diagnostic.line ? `:${diagnostic.line}` : ""}`
+        : "";
+    const cratePrefix = diagnostic.crate ? ` (${diagnostic.crate})` : "";
+    return `[${diagnostic.code}]${cratePrefix}${location}: ${diagnostic.message}`;
+}
 export function collectDocsPagesByTab(pageMap, tabs) {
     const docsPagesByTab = new Map();
     for (const tab of tabs) {
@@ -217,6 +271,7 @@ export async function buildSiteConfig(config) {
     const customCSS = await loadCustomCSS(config.theme.css);
     return {
         name: config.name,
+        titleSeparator: config.titleSeparator,
         siteUrl: config.siteUrl,
         baseUrl: config.baseUrl,
         prettyUrls: config.prettyUrls,
@@ -433,7 +488,7 @@ function isSearchableDocsSitePage(page) {
     return page.currentPage.kind === "markdown" || isMainChangelogSitePage(page);
 }
 function isDocsSource(kind) {
-    return kind === "markdown" || kind === "doxygen" || kind === "godoc";
+    return kind === "markdown" || kind === "doxygen" || kind === "godoc" || kind === "rustdoc";
 }
 function createFeedLinks(atomPath, rssPath, title) {
     return [