sourcey 3.6.0 → 3.6.1

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/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,CA4BjF;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);
@@ -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) {
@@ -433,7 +487,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 [

package/dist/themes/default/sourcey.css

@@ -1893,3 +1893,303 @@ h1[id], h2[id], h3[id], h4[id], h5[id], h6[id] {
 #sourcey .godoc-type .godoc-symbol {
   word-break: break-word;
 }
+
+/* ── Rust API rendering (rustdoc adapter) ────────────────────────── */
+/* Shared API primitives (api-*) introduced for rustdoc and reusable
+   by godoc/doxygen in a follow-on retrofit. Class names mirror
+   rustdoc's DOM so deep-links from a rustdoc URL line up with
+   sourcey output. */
+
+#sourcey .rust-item {
+  border-top: 1px solid rgb(var(--color-gray-200));
+  padding-top: 1rem;
+  margin-top: 1.25rem;
+}
+.dark #sourcey .rust-item {
+  border-top-color: rgb(var(--color-gray-800));
+}
+
+#sourcey .code-header,
+#sourcey .rust-signature {
+  font-family: ui-monospace, "SF Mono", "Cascadia Code", Consolas, "Liberation Mono", Menlo, monospace;
+  font-size: 0.9375rem;
+  color: rgb(var(--color-gray-900));
+  white-space: pre-wrap;
+  word-break: break-word;
+}
+.dark #sourcey .code-header,
+.dark #sourcey .rust-signature {
+  color: rgb(var(--color-gray-100));
+}
+
+#sourcey .rust-signature .kw {
+  color: rgb(var(--color-rose-600));
+  font-weight: 600;
+}
+.dark #sourcey .rust-signature .kw {
+  color: rgb(var(--color-rose-300));
+}
+
+#sourcey .rust-signature .ident {
+  color: rgb(var(--color-indigo-600));
+}
+.dark #sourcey .rust-signature .ident {
+  color: rgb(var(--color-indigo-300));
+}
+
+#sourcey .rust-signature .lifetime {
+  color: rgb(var(--color-amber-700));
+  font-style: italic;
+}
+.dark #sourcey .rust-signature .lifetime {
+  color: rgb(var(--color-amber-300));
+}
+
+#sourcey .api-rightside,
+#sourcey .rightside {
+  float: right;
+  font-size: 0.8125rem;
+  color: rgb(var(--color-gray-500));
+}
+
+#sourcey .api-since,
+#sourcey .since {
+  font-feature-settings: "tnum";
+}
+
+#sourcey .api-srclink,
+#sourcey .srclink {
+  color: rgb(var(--color-indigo-600));
+  text-decoration: none;
+}
+#sourcey .api-srclink:hover,
+#sourcey .srclink:hover {
+  text-decoration: underline;
+}
+.dark #sourcey .api-srclink,
+.dark #sourcey .srclink {
+  color: rgb(var(--color-indigo-300));
+}
+
+#sourcey .docblock,
+#sourcey .rust-doc {
+  color: rgb(var(--color-gray-700));
+  margin-top: 0.5rem;
+}
+.dark #sourcey .docblock,
+.dark #sourcey .rust-doc {
+  color: rgb(var(--color-gray-300));
+}
+
+#sourcey .stab,
+#sourcey .api-stab {
+  display: block;
+  margin: 0.5rem 0;
+  padding: 0.5rem 0.75rem;
+  border-radius: 0.375rem;
+  font-size: 0.875rem;
+  border: 1px solid transparent;
+}
+#sourcey .stab.unstable,
+#sourcey .api-stab-unstable {
+  background-color: rgb(var(--color-amber-50));
+  border-color: rgb(var(--color-amber-200));
+  color: rgb(var(--color-amber-900));
+}
+#sourcey .stab.deprecated,
+#sourcey .api-stab-deprecated {
+  background-color: rgb(var(--color-rose-50));
+  border-color: rgb(var(--color-rose-200));
+  color: rgb(var(--color-rose-900));
+}
+#sourcey .stab.portability,
+#sourcey .api-stab-portability {
+  background-color: rgb(var(--color-emerald-50));
+  border-color: rgb(var(--color-emerald-200));
+  color: rgb(var(--color-emerald-900));
+}
+.dark #sourcey .stab.unstable,
+.dark #sourcey .api-stab-unstable {
+  background-color: rgba(251, 191, 36, 0.08);
+  border-color: rgba(251, 191, 36, 0.25);
+  color: rgb(var(--color-amber-200));
+}
+.dark #sourcey .stab.deprecated,
+.dark #sourcey .api-stab-deprecated {
+  background-color: rgba(244, 63, 94, 0.08);
+  border-color: rgba(244, 63, 94, 0.25);
+  color: rgb(var(--color-rose-200));
+}
+.dark #sourcey .stab.portability,
+.dark #sourcey .api-stab-portability {
+  background-color: rgba(16, 185, 129, 0.08);
+  border-color: rgba(16, 185, 129, 0.25);
+  color: rgb(var(--color-emerald-200));
+}
+
+/* Collapsible trait-impl block. Chevron pattern mirrors .godoc-example so the
+   disclosure reads the same across adapters. */
+#sourcey .api-toggle {
+  margin: 0.75rem 0;
+  border: 1px solid rgb(var(--color-gray-200));
+  border-radius: 6px;
+  background: rgba(var(--color-gray-50), 0.4);
+}
+.dark #sourcey .api-toggle {
+  border-color: rgb(var(--color-gray-800));
+}
+#sourcey .api-toggle > summary {
+  cursor: pointer;
+  padding: 0.5rem 0.875rem;
+  list-style: none;
+  font-family: var(--font-mono);
+  font-size: 0.8125rem;
+  color: rgb(var(--color-gray-700));
+}
+.dark #sourcey .api-toggle > summary {
+  color: rgb(var(--color-gray-300));
+}
+#sourcey .api-toggle > summary::-webkit-details-marker {
+  display: none;
+}
+#sourcey .api-toggle > summary::before {
+  content: "▸ ";
+  color: rgb(var(--color-gray-400));
+  margin-right: 0.25rem;
+}
+#sourcey .api-toggle[open] > summary::before {
+  content: "▾ ";
+}
+/* The impl header lives inside the summary; keep it inline with the chevron
+   and strip heading margins. */
+#sourcey .api-toggle > summary .rust-impl-header {
+  display: inline;
+  margin: 0;
+  font-size: inherit;
+}
+#sourcey .api-toggle-body {
+  padding: 0.25rem 0.875rem 0.5rem;
+  border-top: 1px solid rgb(var(--color-gray-200));
+}
+.dark #sourcey .api-toggle-body {
+  border-top-color: rgb(var(--color-gray-800));
+}
+/* Marker / auto / blanket trait impls: a quiet list, not expandable boxes. */
+#sourcey .rust-impl-rows {
+  margin: 0.5rem 0 0.75rem;
+}
+#sourcey .rust-impl-row {
+  padding: 0.2rem 0;
+}
+#sourcey .rust-impl-row .rust-impl-header {
+  display: inline;
+  margin: 0;
+  font-size: 0.8125rem;
+  font-weight: 400;
+  color: rgb(var(--color-gray-600));
+}
+.dark #sourcey .rust-impl-row .rust-impl-header {
+  color: rgb(var(--color-gray-400));
+}
+
+#sourcey .anchor,
+#sourcey .api-anchor {
+  margin-left: 0.4rem;
+  color: rgb(var(--color-gray-400));
+  text-decoration: none;
+  opacity: 0;
+  transition: opacity 0.1s ease;
+}
+#sourcey .section-header:hover .anchor,
+#sourcey .section-header:hover .api-anchor,
+#sourcey .code-header:hover .anchor,
+#sourcey .code-header:hover .api-anchor {
+  opacity: 1;
+}
+
+/* Inherent-impl methods and trait members render inline as their own sections.
+   Code (signatures, doctests) flows through the shared Shiki code block, so no
+   bespoke code styling lives here. */
+#sourcey .rust-member {
+  margin: 0.75rem 0;
+}
+#sourcey .rust-method-header {
+  margin: 0.5rem 0 0.25rem;
+}
+#sourcey .rust-doctest {
+  margin: 0.75rem 0;
+}
+
+#sourcey .rust-doctest-badges {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 0.25rem;
+  margin-bottom: 0.25rem;
+}
+#sourcey .rust-doctest-badge {
+  display: inline-block;
+  padding: 0.05rem 0.4rem;
+  font-size: 0.6875rem;
+  font-weight: 600;
+  border-radius: 0.25rem;
+  background-color: rgb(var(--color-gray-100));
+  color: rgb(var(--color-gray-700));
+  text-transform: lowercase;
+  letter-spacing: 0.02em;
+}
+.dark #sourcey .rust-doctest-badge {
+  background-color: rgb(var(--color-gray-800));
+  color: rgb(var(--color-gray-300));
+}
+#sourcey .rust-doctest-badge-should_panic,
+#sourcey .rust-doctest-badge-compile_fail {
+  background-color: rgb(var(--color-rose-100));
+  color: rgb(var(--color-rose-800));
+}
+#sourcey .rust-doctest-badge-no_run,
+#sourcey .rust-doctest-badge-ignore {
+  background-color: rgb(var(--color-amber-100));
+  color: rgb(var(--color-amber-800));
+}
+
+#sourcey .rust-doctest-controls {
+  display: flex;
+  gap: 0.5rem;
+  margin-top: 0.5rem;
+  font-size: 0.8125rem;
+}
+#sourcey .rust-doctest-run,
+#sourcey .rust-doctest-toggle-hidden {
+  cursor: pointer;
+  padding: 0.2rem 0.6rem;
+  border-radius: 0.375rem;
+  border: 1px solid rgb(var(--color-gray-300));
+  background-color: rgb(var(--color-white));
+  color: rgb(var(--color-gray-800));
+  text-decoration: none;
+  line-height: 1;
+}
+#sourcey .rust-doctest-run:hover,
+#sourcey .rust-doctest-toggle-hidden:hover {
+  background-color: rgb(var(--color-gray-50));
+}
+.dark #sourcey .rust-doctest-run,
+.dark #sourcey .rust-doctest-toggle-hidden {
+  background-color: rgb(var(--color-gray-900));
+  border-color: rgb(var(--color-gray-700));
+  color: rgb(var(--color-gray-200));
+}
+
+/* On the aggregated doctests page the code block already renders as a card, so
+   the section itself stays borderless. Just space the entries and accent the
+   heading so they don't read as cards within cards. */
+#sourcey .rust-doctests-index .rust-doctest {
+  margin: 1.5rem 0;
+}
+#sourcey .rust-doctests-index .rust-doctest > h3 {
+  padding-left: 0.625rem;
+  border-left: 3px solid rgb(var(--color-emerald-500));
+}
+.dark #sourcey .rust-doctests-index .rust-doctest > h3 {
+  border-left-color: rgb(var(--color-emerald-400));
+}

package/dist/utils/code-samples.d.ts

@@ -2,6 +2,7 @@ import type { NormalizedOperation } from "../core/types.js";
 import type { CodeSample } from "../core/types.js";
 /** Default languages when none configured. */
 export declare const DEFAULT_CODE_SAMPLE_LANGS: string[];
+export declare const SUPPORTED_CODE_SAMPLE_LANGS: readonly string[];
 /**
  * Generate code samples for an operation.
  *

package/dist/utils/code-samples.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"code-samples.d.ts","sourceRoot":"","sources":["../../src/utils/code-samples.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAuMnD,8CAA8C;AAC9C,eAAO,MAAM,yBAAyB,UAAmC,CAAC;AAM1E;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,EAAE,EAAE,mBAAmB,EACvB,SAAS,EAAE,MAAM,EACjB,KAAK,GAAE,MAAM,EAA8B,GAC1C,UAAU,EAAE,CAmBd"}
+{"version":3,"file":"code-samples.d.ts","sourceRoot":"","sources":["../../src/utils/code-samples.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAoNnD,8CAA8C;AAC9C,eAAO,MAAM,yBAAyB,UAAmC,CAAC;AAC1E,eAAO,MAAM,2BAA2B,mBAAyC,CAAC;AAMlF;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,EAAE,EAAE,mBAAmB,EACvB,SAAS,EAAE,MAAM,EACjB,KAAK,GAAE,MAAM,EAA8B,GAC1C,UAAU,EAAE,CAiBd"}