sourcey 3.5.10 → 3.6.1

package/dist/site-assembly.js

@@ -1,5 +1,5 @@
 import { readFile } from "node:fs/promises";
-import { extname, posix, resolve } from "node:path";
+import { extname, posix, relative, resolve } from "node:path";
 import { loadSpec } from "./core/loader.js";
 import { convertToOpenApi3 } from "./core/converter.js";
 import { parseSpec } from "./core/parser.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,8 +20,9 @@ export async function assembleSite(config) {
     const siteTabs = [];
     const changelogDiagnostics = [];
     const godocDiagnostics = [];
+    const rustdocDiagnostics = [];
     for (const tab of config.tabs) {
-        if (tab.openapi || tab.mcp) {
+        if (tab.source.kind === "openapi" || tab.source.kind === "mcp") {
             const spec = specsBySlug.get(tab.slug);
             const navTab = buildNavFromSpec(spec, tab.slug, config.prettyUrls);
             navTab.label = tab.label;
@@ -35,8 +37,8 @@ export async function assembleSite(config) {
             });
             continue;
         }
-        if (tab.doxygen) {
-            const { pages, navTab } = await loadDoxygenTab(tab.doxygen, tab.slug, tab.label);
+        if (tab.source.kind === "doxygen") {
+            const { pages, navTab } = await loadDoxygenTab(tab.source.config, tab.slug, tab.label);
             for (const [slug, page] of pages) {
                 const outputPath = pageOutputPath(tab.slug, slug, config.prettyUrls);
                 pageMap.set(outputPath, {
@@ -50,11 +52,11 @@ export async function assembleSite(config) {
             siteTabs.push(navTab);
             continue;
         }
-        if (tab.godoc) {
-            const { pages, navTab, diagnostics } = await loadGodocTab(tab.godoc, tab.slug, tab.label, {
+        if (tab.source.kind === "godoc") {
+            const { pages, navTab, diagnostics } = await loadGodocTab(tab.source.config, tab.slug, tab.label, {
                 repo: config.repo,
                 editBranch: config.editBranch,
-                editBasePath: tab.godoc.sourceBasePath,
+                editBasePath: tab.source.config.sourceBasePath,
             });
             godocDiagnostics.push(...diagnostics);
             for (const [slug, page] of pages) {
@@ -70,15 +72,37 @@ export async function assembleSite(config) {
             siteTabs.push(navTab);
             continue;
         }
-        if (!tab.groups)
+        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();
-        for (const group of tab.groups) {
+        for (const group of tab.source.groups) {
             for (const rp of group.pages) {
                 const slug = slugFromPath(rp.slug);
                 const page = await loadDocsPage(rp.file, slug, {
                     changelog: config.changelog.enabled,
                     repoUrl: config.repo,
+                    sourceRoot: rp.sourceRoot,
+                    preprocess: rp.preprocess,
                 });
                 pagesByPath.set(rp.slug, page);
                 const outputPath = pageOutputPath(tab.slug, slug, config.prettyUrls);
@@ -111,6 +135,7 @@ export async function assembleSite(config) {
     const sitePages = Array.from(pageMap.values());
     resolveInternalLinks(sitePages, config);
     const extraFiles = attachChangelogFeeds(sitePages, config);
+    await attachSourceAssets(extraFiles, config.tabs);
     return {
         siteTabs,
         primarySpec,
@@ -118,6 +143,7 @@ export async function assembleSite(config) {
         pageMap,
         changelogDiagnostics,
         godocDiagnostics,
+        rustdocDiagnostics,
         extraFiles,
     };
 }
@@ -127,16 +153,49 @@ 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) {
-        if (!tab.groups && !tab.doxygen && !tab.godoc)
+        if (!isDocsSource(tab.source.kind))
             continue;
         const tabPages = [];
         for (const [, page] of pageMap) {
             if (page.tabSlug !== tab.slug || !isSearchableDocsSitePage(page))
                 continue;
-            tabPages.push(page.currentPage.kind === "markdown" ? page.currentPage.markdown : page.currentPage.changelog);
+            tabPages.push(page.currentPage.kind === "markdown"
+                ? page.currentPage.markdown
+                : page.currentPage.changelog);
         }
         docsPagesByTab.set(tab.slug, tabPages);
     }
@@ -144,10 +203,10 @@ export function collectDocsPagesByTab(pageMap, tabs) {
 }
 export function rebuildMarkdownTabNavigation(pageMap, siteTabs, tabs, tabSlug, prettyUrls) {
     const tab = tabs.find((candidate) => candidate.slug === tabSlug);
-    if (!tab?.groups)
+    if (!tab || tab.source.kind !== "markdown")
         return;
     const pagesByPath = new Map();
-    for (const group of tab.groups) {
+    for (const group of tab.source.groups) {
         for (const rp of group.pages) {
             const slug = slugFromPath(rp.slug);
             const entry = pageMap.get(pageOutputPath(tab.slug, slug, prettyUrls));
@@ -241,6 +300,7 @@ export function createMinimalSpec() {
 }
 export function resolveInternalLinks(pages, config) {
     const pathMap = new Map();
+    addSourceAssetAliases(pathMap, config.tabs ?? []);
     for (const page of pages) {
         const out = page.outputPath;
         const clean = out.replace(/\/index\.html$/, "").replace(/\.html$/, "");
@@ -253,6 +313,10 @@ export function resolveInternalLinks(pages, config) {
             .replace(/^\/+/, "")
             .replace(/\.(md|mdx)$/, "");
         pathMap.set(sourceClean, out);
+        const sourceRelativeClean = getSourceRootRelativePath(page);
+        if (sourceRelativeClean) {
+            pathMap.set(sourceRelativeClean, out);
+        }
     }
     const repoBase = config.repo?.replace(/\/$/, "");
     const branch = config.editBranch;
@@ -263,6 +327,7 @@ export function resolveInternalLinks(pages, config) {
         if (!docsSourcePath)
             continue;
         if (page.currentPage.kind === "markdown") {
+            page.currentPage.markdown.description = rewriteMarkdownLinks(page.currentPage.markdown.description, page.outputPath, docsSourcePath, pathMap, sourceBase, prettyUrls);
             page.currentPage.markdown.html = rewriteHtmlLinks(page.currentPage.markdown.html, page.outputPath, docsSourcePath, pathMap, sourceBase, prettyUrls);
             continue;
         }
@@ -338,6 +403,15 @@ function attachChangelogFeeds(pages, config) {
     }
     return extraFiles;
 }
+async function attachSourceAssets(extraFiles, tabs) {
+    for (const tab of tabs) {
+        if (tab.source.kind !== "markdown")
+            continue;
+        for (const asset of tab.source.assets ?? []) {
+            extraFiles.set(tabPath(tab.slug, asset.outputPath), await readFile(asset.file));
+        }
+    }
+}
 function addPermalinkPages(pageMap, prettyUrls) {
     const changelogPages = Array.from(pageMap.values()).filter(isMainChangelogSitePage);
     for (const page of changelogPages) {
@@ -364,15 +438,15 @@ function addPermalinkPages(pageMap, prettyUrls) {
 async function loadSpecs(tabs) {
     const specsBySlug = new Map();
     for (const tab of tabs) {
-        if (tab.openapi) {
-            const loaded = await loadSpec(tab.openapi);
+        if (tab.source.kind === "openapi") {
+            const loaded = await loadSpec(tab.source.spec);
             const parsed = await parseSpec(loaded);
             const openapi3 = await convertToOpenApi3(parsed);
             specsBySlug.set(tab.slug, normalizeSpec(openapi3));
         }
-        else if (tab.mcp) {
+        else if (tab.source.kind === "mcp") {
             const { parse } = await import("mcp-parser");
-            const mcpSpec = await parse(tab.mcp);
+            const mcpSpec = await parse(tab.source.spec);
             specsBySlug.set(tab.slug, normalizeMcpSpec(mcpSpec));
         }
     }
@@ -395,7 +469,10 @@ const MIME_TYPES = {
     ".ico": "image/x-icon",
 };
 async function resolveAssetUrl(pathOrUrl) {
-    if (!pathOrUrl || pathOrUrl.startsWith("data:") || pathOrUrl.startsWith("http://") || pathOrUrl.startsWith("https://")) {
+    if (!pathOrUrl ||
+        pathOrUrl.startsWith("data:") ||
+        pathOrUrl.startsWith("http://") ||
+        pathOrUrl.startsWith("https://")) {
         return pathOrUrl;
     }
     const abs = resolve(pathOrUrl);
@@ -409,6 +486,9 @@ function isMainChangelogSitePage(page) {
 function isSearchableDocsSitePage(page) {
     return page.currentPage.kind === "markdown" || isMainChangelogSitePage(page);
 }
+function isDocsSource(kind) {
+    return kind === "markdown" || kind === "doxygen" || kind === "godoc" || kind === "rustdoc";
+}
 function createFeedLinks(atomPath, rssPath, title) {
     return [
         { href: atomPath, type: "application/atom+xml", title: `${title} Atom Feed` },
@@ -429,26 +509,74 @@ function getDocsSourcePath(page) {
         return page.currentPage.changelog.sourcePath;
     return undefined;
 }
+function getSourceRootRelativePath(page) {
+    if (page.currentPage.kind !== "markdown")
+        return undefined;
+    const markdown = page.currentPage.markdown;
+    if (!markdown.sourceRoot)
+        return undefined;
+    const sourceRoot = normalizeSourcePath(markdown.sourceRoot);
+    const sourcePath = normalizeSourcePath(markdown.sourcePath);
+    if (!sourcePath.startsWith(`${sourceRoot}/`))
+        return undefined;
+    return stripMarkdownExtension(sourcePath.slice(sourceRoot.length + 1));
+}
+function addSourceAssetAliases(pathMap, tabs) {
+    for (const tab of tabs) {
+        if (tab.source.kind !== "markdown")
+            continue;
+        for (const asset of tab.source.assets ?? []) {
+            const outputPath = tabPath(tab.slug, asset.outputPath);
+            pathMap.set(normalizeSourcePath(asset.outputPath), outputPath);
+            for (const sourceRoot of sourceRootsForMarkdownSource(tab.source)) {
+                const sourceRootPath = normalizeSourcePath(relative(process.cwd(), sourceRoot));
+                pathMap.set(posix.join(sourceRootPath, normalizeSourcePath(asset.outputPath)), outputPath);
+            }
+        }
+    }
+}
+function sourceRootsForMarkdownSource(source) {
+    const roots = new Set();
+    for (const group of source.groups) {
+        for (const page of group.pages) {
+            if (page.sourceRoot)
+                roots.add(page.sourceRoot);
+        }
+    }
+    return [...roots];
+}
+function normalizeSourcePath(value) {
+    return value.replace(/\\/g, "/").replace(/^\/+/, "");
+}
+function stripMarkdownExtension(value) {
+    return value.replace(/\.(md|mdx)$/, "");
+}
 function rewriteHtmlLinks(html, outputPath, docsSourcePath, pathMap, sourceBase, prettyUrls) {
-    return html.replace(/href="([^"]+)"/g, (match, href) => {
+    return html.replace(/\b(href|src)="([^"]+)"/g, (match, attr, href) => {
         const resolved = resolveInternalHref(href, outputPath, docsSourcePath, pathMap, sourceBase, prettyUrls);
-        return resolved ? `href="${resolved}"` : match;
+        return resolved ? `${attr}="${resolved}"` : match;
     });
 }
 function rewriteMarkdownLinks(markdown, outputPath, docsSourcePath, pathMap, sourceBase, prettyUrls) {
-    return markdown.replace(/\[([^\]]+)\]\(([^)]+)\)/g, (match, label, href) => {
+    return markdown.replace(/\[((?:`[^`]*`|[^\]])+)\]\(([^)]+)\)/g, (match, label, href) => {
         const resolved = resolveInternalHref(href, outputPath, docsSourcePath, pathMap, sourceBase, prettyUrls);
         return resolved ? `[${label}](${resolved})` : match;
     });
 }
 function resolveInternalHref(href, outputPath, docsSourcePath, pathMap, sourceBase, prettyUrls) {
-    if (href.startsWith("http://") || href.startsWith("https://") || href.startsWith("#") || href.startsWith("mailto:")) {
+    if (href.startsWith("http://") ||
+        href.startsWith("https://") ||
+        href.startsWith("#") ||
+        href.startsWith("mailto:")) {
         return null;
     }
     const [path, hash] = href.split("#", 2);
     const hashSuffix = hash ? `#${hash}` : "";
-    const sourcePath = path.replace(/\\/g, "/");
-    const clean = sourcePath.replace(/^\/+/, "").replace(/\/+$/, "").replace(/\.(md|mdx|html)$/, "");
+    const sourcePath = decodeHrefPath(path).replace(/\\/g, "/");
+    const clean = sourcePath
+        .replace(/^\/+/, "")
+        .replace(/\/+$/, "")
+        .replace(/\.(md|mdx|html)$/, "");
     const pageDir = outputPath.includes("/")
         ? outputPath.substring(0, outputPath.lastIndexOf("/"))
         : "";
@@ -490,6 +618,14 @@ function resolveInternalHref(href, outputPath, docsSourcePath, pathMap, sourceBa
     }
     return null;
 }
+function decodeHrefPath(path) {
+    try {
+        return decodeURIComponent(path);
+    }
+    catch {
+        return path;
+    }
+}
 /**
  * Rewrite an on-disk output path into the relative href that a user visits.
  * - `"slash"`: trims trailing `index.html`, leaves a directory-style `foo/`.
@@ -506,7 +642,7 @@ function toPrettyLink(target, prettyUrls) {
         return prettyUrls === "strip" ? withSlash.slice(0, -1) : withSlash;
     }
     if (prettyUrls === "strip" && target.endsWith(".html")) {
-        return target.slice(0, -(".html".length));
+        return target.slice(0, -".html".length);
     }
     return target;
 }

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"}