sourcey 3.5.10 → 3.6.1

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,mBAAmB,EAA8B,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACvG,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAiBlD,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,cAAc,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,oBAAoB,EAAE,mBAAmB,EAAE,CAAC;CAC7C;AAED;;;GAGG;AACH,wBAAsB,SAAS,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,CAkB3E;AAMD,MAAM,WAAW,gBAAgB;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,oBAAoB,EAAE,mBAAmB,EAAE,CAAC;IAC5C,gBAAgB,EAAE,OAAO,wBAAwB,EAAE,qBAAqB,EAAE,CAAC;IAC3E,wDAAwD;IACxD,MAAM,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;CACtC;AAED,wBAAsB,aAAa,CAAC,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,eAAe,CAAC,CAoF5F;AA4CD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAG1D,YAAY,EACV,cAAc,EACd,mBAAmB,EACnB,aAAa,EACb,gBAAgB,EAChB,mBAAmB,EACnB,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,mBAAmB,EAEnB,cAAc,EACf,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAmBlD,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,cAAc,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,oBAAoB,EAAE,mBAAmB,EAAE,CAAC;CAC7C;AAED;;;GAGG;AACH,wBAAsB,SAAS,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,CAkB3E;AAMD,MAAM,WAAW,gBAAgB;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,oBAAoB,EAAE,mBAAmB,EAAE,CAAC;IAC5C,gBAAgB,EAAE,OAAO,wBAAwB,EAAE,qBAAqB,EAAE,CAAC;IAC3E,kBAAkB,EAAE,OAAO,0BAA0B,EAAE,uBAAuB,EAAE,CAAC;IACjF,wDAAwD;IACxD,MAAM,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;CACtC;AAED,wBAAsB,aAAa,CAAC,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,eAAe,CAAC,CAgG5F;AA8CD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC9F,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAG1D,YAAY,EACV,cAAc,EACd,mBAAmB,EACnB,aAAa,EACb,gBAAgB,EAChB,mBAAmB,EACnB,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,iBAAiB,CAAC;AAEzB,YAAY,EACV,oBAAoB,EACpB,kBAAkB,EAClB,qBAAqB,EACrB,gBAAgB,EAChB,mBAAmB,EACnB,oBAAoB,EACpB,iBAAiB,EACjB,oBAAoB,EACpB,aAAa,EACb,oBAAoB,GACrB,MAAM,qBAAqB,CAAC;AAE7B,YAAY,EACV,aAAa,EACb,qBAAqB,EACrB,WAAW,EACX,eAAe,GAChB,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -5,7 +5,7 @@ import { loadConfig, configFromSpec } from "./config.js";
 import { buildSiteNavigation } from "./core/navigation.js";
 import { buildSearchIndex } from "./core/search-indexer.js";
 import { generateLlmsTxt, generateLlmsFullTxt } from "./renderer/llms.js";
-import { assembleSite, buildSiteConfig, collectDocsPagesByTab, createMinimalSpec, enforceChangelogDiagnostics, } from "./site-assembly.js";
+import { assembleSite, buildSiteConfig, collectDocsPagesByTab, createMinimalSpec, enforceChangelogDiagnostics, enforceGodocDiagnostics, enforceRustdocDiagnostics, } from "./site-assembly.js";
 /**
  * Build API documentation from a single OpenAPI/Swagger spec.
  * Wraps the spec in a single-tab site and renders through the modern layout.
@@ -29,12 +29,14 @@ export async function buildDocs(options) {
 }
 export async function buildSiteDocs(options = {}) {
     const outputDir = resolve(options.outputDir ?? "dist");
-    const config = options.config ?? await loadConfig(options.configDir);
+    const config = options.config ?? (await loadConfig(options.configDir));
     const assembled = await assembleSite(config);
     const site = await buildSiteConfig(config);
     const sitePages = Array.from(assembled.pageMap.values());
     const navigation = buildSiteNavigation(assembled.siteTabs);
     enforceChangelogDiagnostics(assembled.changelogDiagnostics, options.strictChangelog);
+    enforceGodocDiagnostics(assembled.godocDiagnostics);
+    enforceRustdocDiagnostics(assembled.rustdocDiagnostics);
     const docsPagesByTab = collectDocsPagesByTab(assembled.pageMap, config.tabs);
     const searchIndex = buildSearchIndex(assembled.specsBySlug, docsPagesByTab, navigation, config.baseUrl || "/", config.search.featured, config.prettyUrls);
     const llmsTxt = generateLlmsTxt(sitePages, navigation, site);
@@ -50,22 +52,30 @@ export async function buildSiteDocs(options = {}) {
                 const ogMeta = describePageForOg(page, config.name || "API", config.changelog.ogImages);
                 if (!ogMeta)
                     return;
-                const ogPath = `_og/${page.outputPath.replace(/\.html$/, ".png")}`;
-                const png = await generateOgImage({
-                    title: ogMeta.title,
-                    description: ogMeta.description,
-                    siteName: config.name,
-                    theme: config.theme,
-                    logo: site.logo?.light,
-                });
-                page.ogImagePath = ogPath;
-                ogImages.set(ogPath, png);
+                try {
+                    const ogPath = `_og/${page.outputPath.replace(/\.html$/, ".png")}`;
+                    const png = await generateOgImage({
+                        title: ogMeta.title,
+                        description: ogMeta.description,
+                        siteName: config.name,
+                        theme: config.theme,
+                        logo: site.logo?.light,
+                    });
+                    page.ogImagePath = ogPath;
+                    ogImages.set(ogPath, png);
+                }
+                catch (error) {
+                    const message = error instanceof Error ? error.message : String(error);
+                    console.warn(`Sourcey: skipping OG image for ${page.outputPath}: ${message}`);
+                }
             }));
         }
     }
     else {
         const staticOg = config.ogImage;
-        if (staticOg.startsWith("http://") || staticOg.startsWith("https://") || staticOg.startsWith("data:")) {
+        if (staticOg.startsWith("http://") ||
+            staticOg.startsWith("https://") ||
+            staticOg.startsWith("data:")) {
             for (const page of sitePages) {
                 page.ogImagePath = staticOg;
             }
@@ -93,6 +103,7 @@ export async function buildSiteDocs(options = {}) {
         pageCount: sitePages.length,
         changelogDiagnostics: assembled.changelogDiagnostics,
         godocDiagnostics: assembled.godocDiagnostics,
+        rustdocDiagnostics: assembled.rustdocDiagnostics,
         _specs: assembled.specsBySlug,
     };
 }
@@ -112,7 +123,7 @@ function describePageForOg(page, defaultSiteName, changelogPermalinkOg) {
             if (!version)
                 return null;
             return {
-                title: `${version.version ?? "Unreleased"} — ${changelog.title}`,
+                title: `${version.version ?? "Unreleased"} - ${changelog.title}`,
                 description: version.summary || summarizeVersion(version),
             };
         }
@@ -131,4 +142,5 @@ function summarizeVersion(version) {
     return summary || undefined;
 }
 export { defineConfig } from "./config.js";
+export { doxygen, godoc, markdown, mcp, mkdocs, openapi, rustdoc } from "./adapters/index.js";
 export { resolveInternalLinks } from "./site-assembly.js";

package/dist/init.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../src/init.ts"],"names":[],"mappings":"AA4DA,eAAO,MAAM,IAAI,qDAyPf,CAAC"}
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../src/init.ts"],"names":[],"mappings":"AA4DA,eAAO,MAAM,IAAI,qDAoQf,CAAC"}

package/dist/init.js

@@ -79,7 +79,9 @@ export const init = defineCommand({
             }
         }
         if (existsSync(resolve(targetDir, "sourcey.config.ts"))) {
-            consola.error("sourcey.config.ts already exists in " + (targetDir === cwd ? "this directory" : relative(cwd, targetDir)) + ".");
+            consola.error("sourcey.config.ts already exists in " +
+                (targetDir === cwd ? "this directory" : relative(cwd, targetDir)) +
+                ".");
             process.exit(1);
         }
         // -- Auto-detect sources --
@@ -155,42 +157,45 @@ export const init = defineCommand({
                 process.exit(0);
         }
         // -- Generate files --
-        const pages = withExample
-            ? `["introduction", "quickstart"]`
-            : `["introduction"]`;
+        const pages = withExample ? `["introduction", "quickstart"]` : `["introduction"]`;
         // Build tabs array — paths relative from targetDir to cwd
         const relPath = (file) => {
             const abs = resolve(cwd, file);
             const rel = relative(targetDir, abs);
             return rel.startsWith(".") ? rel : "./" + rel;
         };
+        const imports = new Set(["defineConfig", "markdown"]);
         let tabs = `      {
         tab: "Documentation",
         slug: "",
-        groups: [
-          {
-            group: "Getting Started",
-            pages: ${pages},
-          },
-        ],
+        source: markdown({
+          groups: [
+            {
+              group: "Getting Started",
+              pages: ${pages},
+            },
+          ],
+        }),
       },`;
         if (addOpenAPI) {
+            imports.add("openapi");
             tabs += `
       {
         tab: "API Reference",
         slug: "api",
-        openapi: "${relPath(addOpenAPI)}",
+        source: openapi("${relPath(addOpenAPI)}"),
       },`;
         }
         if (addDoxygen) {
+            imports.add("doxygen");
             tabs += `
       {
-        tab: "API Reference",
-        slug: "api",
-        doxygen: { xml: "${relPath(addDoxygen.xmlDir)}" },
+        tab: "C++ Reference",
+        slug: "cpp-api",
+        source: doxygen({ xml: "${relPath(addDoxygen.xmlDir)}" }),
       },`;
         }
-        const config = `import { defineConfig } from "sourcey";
+        const config = `import { ${[...imports].join(", ")} } from "sourcey";
 
 export default defineConfig({
   name: "${name}",
@@ -247,7 +252,7 @@ import { myFunction } from "my-package";
                     build: "sourcey build",
                 },
                 dependencies: {
-                    sourcey: "^3.4.3",
+                    sourcey: "^3.6.0",
                 },
             }, null, 2);
             writeFileSync(resolve(targetDir, "package.json"), pkg + "\n");

package/dist/renderer/changelog-feed.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"changelog-feed.d.ts","sourceRoot":"","sources":["../../src/renderer/changelog-feed.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,kBAAkB,CAAC;AAEnE,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,IAAI,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,OAAO,EAAE,0BAA0B,GAAG,MAAM,CAAC;CAC1D;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;CACb;AAED,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,aAAa,EACnB,OAAO,EAAE,oBAAoB,GAC5B,kBAAkB,CAsEpB"}
+{"version":3,"file":"changelog-feed.d.ts","sourceRoot":"","sources":["../../src/renderer/changelog-feed.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,kBAAkB,CAAC;AAGnE,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,IAAI,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,OAAO,EAAE,0BAA0B,GAAG,MAAM,CAAC;CAC1D;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;CACb;AAED,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,aAAa,EACnB,OAAO,EAAE,oBAAoB,GAC5B,kBAAkB,CA8EpB"}

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;AACvF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,KAAK,EAAE,mBAAmB,EAA8B,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACvG,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,CA2HhF;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,CAgBzB;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,CAuEpF"}
+{"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"}