sourcey 3.4.1 → 3.4.4

package/dist/components/openapi/Security.js

@@ -1,4 +1,4 @@
-import { jsx as _jsx, jsxs as _jsxs } from "preact/jsx-runtime";
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "preact/jsx-runtime";
 import { useContext } from "preact/hooks";
 import { SpecContext } from "../../renderer/context.js";
 import { SectionLabel } from "../ui/SectionLabel.js";
@@ -26,7 +26,5 @@ export function SecurityDefinitions() {
     const schemes = Object.entries(spec.securitySchemes);
     if (!schemes.length)
         return null;
-    return (_jsxs("div", { id: "authentication", class: "py-8 border-t border-[rgb(var(--color-gray-100))] dark:border-[rgb(var(--color-gray-800))]", "data-traverse-target": "authentication", children: [_jsx("h2", { class: "text-xl font-bold text-[rgb(var(--color-gray-900))] dark:text-[rgb(var(--color-gray-200))] mb-4", children: "Authentication" }), _jsx("div", { class: "params-list", children: schemes.map(([name, scheme]) => (_jsxs("div", { class: "param-item", children: [_jsxs("div", { class: "param-header", children: [_jsx("code", { class: "param-name", children: name }), _jsx("span", { class: "param-type", children: _jsx("span", { class: "json-property-type", children: scheme.type }) })] }), _jsxs("div", { class: "param-description", children: [scheme.description && _jsx(Markdown, { content: scheme.description }), scheme.type === "apiKey" && (_jsxs("p", { class: "mt-1", children: ["API Key: ", _jsx("code", { class: "text-xs font-medium", children: scheme.name }), " in ", scheme.in] })), scheme.type === "http" && (_jsxs("p", { class: "mt-1", children: ["Scheme: ", scheme.scheme, scheme.bearerFormat && ` (${scheme.bearerFormat})`] })), scheme.type === "oauth2" && scheme.flows && (_jsx("div", { class: "mt-2 space-y-2", children: Object.entries(scheme.flows).map(([flowType, flow]) => (_jsxs("div", { children: [_jsx("strong", { class: "text-[rgb(var(--color-gray-900))] dark:text-[rgb(var(--color-gray-200))]", children: flowType }), flow?.authorizationUrl && (_jsxs("p", { class: "mt-1", children: ["Authorization: ", _jsx("code", { class: "text-xs", children: flow.authorizationUrl })] })), flow?.tokenUrl && (_jsxs("p", { class: "mt-1", children: ["Token: ", _jsx("code", { class: "text-xs", children: flow.tokenUrl })] })), flow?.scopes && Object.keys(flow.scopes).length > 0 && (_jsxs("p", { class: "mt-1", children: ["Scopes:", " ", Object.entries(flow.scopes)
-                                                        .map(([s, desc]) => `${s} — ${desc}`)
-                                                        .join(", ")] }))] }, flowType))) })), scheme.type === "openIdConnect" && scheme.openIdConnectUrl && (_jsxs("p", { class: "mt-1", children: ["OpenID Connect:", " ", _jsx("a", { href: scheme.openIdConnectUrl, class: "text-[rgb(var(--color-primary))] dark:text-[rgb(var(--color-primary-light))]", children: scheme.openIdConnectUrl })] }))] })] }, name))) })] }));
+    return (_jsxs("div", { id: "authentication", class: "py-8 border-t border-[rgb(var(--color-gray-100))] dark:border-[rgb(var(--color-gray-800))]", "data-traverse-target": "authentication", children: [_jsx("h2", { class: "text-xl font-bold text-[rgb(var(--color-gray-900))] dark:text-[rgb(var(--color-gray-200))] mb-4", children: "Authentication" }), _jsx("div", { class: "params-list", children: schemes.map(([name, scheme]) => (_jsxs("div", { class: "param-item", children: [_jsxs("div", { class: "param-header", children: [_jsx("code", { class: "param-name", children: name }), _jsx("span", { class: "param-type", children: _jsx("span", { class: "json-property-type", children: scheme.type }) })] }), _jsxs("div", { class: "param-description", children: [scheme.description && _jsx(Markdown, { content: scheme.description }), scheme.type === "apiKey" && (_jsxs("p", { class: "mt-1", children: ["API Key: ", _jsx("code", { class: "text-xs font-medium", children: scheme.name }), " in ", scheme.in] })), scheme.type === "http" && (_jsxs("p", { class: "mt-1", children: ["Scheme: ", scheme.scheme, scheme.bearerFormat && ` (${scheme.bearerFormat})`] })), scheme.type === "oauth2" && scheme.flows && (_jsx("div", { class: "mt-2 space-y-4", children: Object.entries(scheme.flows).map(([flowType, flow]) => (_jsxs("div", { children: [_jsx("strong", { class: "text-[rgb(var(--color-gray-900))] dark:text-[rgb(var(--color-gray-200))]", children: flowType }), _jsxs("dl", { class: "mt-2 text-sm", children: [flow?.authorizationUrl && (_jsxs(_Fragment, { children: [_jsx("dt", { class: "text-[rgb(var(--color-gray-500))] mt-2", children: "Authorization URL" }), _jsx("dd", { children: _jsx("code", { class: "text-xs", children: flow.authorizationUrl }) })] })), flow?.tokenUrl && (_jsxs(_Fragment, { children: [_jsx("dt", { class: "text-[rgb(var(--color-gray-500))] mt-2", children: "Token URL" }), _jsx("dd", { children: _jsx("code", { class: "text-xs", children: flow.tokenUrl }) })] }))] }), flow?.scopes && Object.keys(flow.scopes).length > 0 && (_jsxs("div", { class: "mt-3", children: [_jsx("span", { class: "text-sm text-[rgb(var(--color-gray-500))]", children: "Scopes" }), _jsx("ul", { class: "mt-1 space-y-1", children: Object.entries(flow.scopes).map(([s, desc]) => (_jsxs("li", { class: "text-sm", children: [_jsx("code", { class: "text-xs font-medium text-[rgb(var(--color-gray-800))] dark:text-[rgb(var(--color-gray-200))]", children: s }), _jsxs("span", { class: "text-[rgb(var(--color-gray-500))] ml-2", children: ["\u2014 ", desc] })] }, s))) })] }))] }, flowType))) })), scheme.type === "openIdConnect" && scheme.openIdConnectUrl && (_jsxs("p", { class: "mt-1", children: ["OpenID Connect:", " ", _jsx("a", { href: scheme.openIdConnectUrl, class: "text-[rgb(var(--color-primary-ink))] dark:text-[rgb(var(--color-primary-light))]", children: scheme.openIdConnectUrl })] }))] })] }, name))) })] }));
 }

package/dist/components/ui/SectionLabel.js

@@ -4,5 +4,5 @@ import { jsx as _jsx, jsxs as _jsxs } from "preact/jsx-runtime";
  * Used for "Body", "Parameters", "Response" sections.
  */
 export function SectionLabel({ children, meta }) {
-    return (_jsxs("div", { class: "flex items-baseline border-b pb-2.5 border-[rgb(var(--color-gray-100))] dark:border-[rgb(var(--color-gray-800))] w-full mb-4", children: [_jsx("h4", { class: "flex-1 mb-0 text-sm font-semibold text-[rgb(var(--color-gray-900))] dark:text-[rgb(var(--color-gray-200))]", children: children }), meta && (_jsx("div", { class: "flex items-center gap-2 text-xs font-medium font-mono text-[rgb(var(--color-gray-500))]", children: meta }))] }));
+    return (_jsxs("div", { class: "flex items-baseline border-b pb-2.5 border-[rgb(var(--color-gray-100))] dark:border-[rgb(var(--color-gray-800))] w-full mb-4", children: [_jsx("h3", { class: "flex-1 mb-0 text-sm font-semibold text-[rgb(var(--color-gray-900))] dark:text-[rgb(var(--color-gray-200))]", children: children }), meta && (_jsx("div", { class: "flex items-center gap-2 text-xs font-medium font-mono text-[rgb(var(--color-gray-500))]", children: meta }))] }));
 }

package/dist/config.js

@@ -13,8 +13,8 @@ const DEFAULT_COLORS = {
     dark: "79 70 229",
 };
 const DEFAULT_FONTS = {
-    sans: "'Inter', -apple-system, BlinkMacSystemFont, 'Segoe UI', system-ui, sans-serif",
-    mono: "'Geist Mono', 'SF Mono', 'Fira Code', 'Cascadia Code', Consolas, monospace",
+    sans: "ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif",
+    mono: "ui-monospace, 'SF Mono', 'Cascadia Code', Consolas, 'Liberation Mono', Menlo, monospace",
 };
 const DEFAULT_LAYOUT = {
     sidebar: "18rem",
@@ -73,7 +73,7 @@ export async function resolveConfigFromRaw(raw, configDir) {
         name: raw.name ?? "",
         theme,
         logo,
-        favicon: raw.favicon,
+        favicon: raw.favicon && !raw.favicon.startsWith("http") && !raw.favicon.startsWith("data:") ? resolve(configDir, raw.favicon) : raw.favicon,
         repo: raw.repo,
         editBranch: raw.editBranch,
         editBasePath: raw.editBasePath,

package/dist/core/doxygen-loader.d.ts

@@ -5,5 +5,6 @@ export interface DoxygenResult {
     pages: Map<string, MarkdownPage>;
     navTab: SiteTab;
 }
+export declare function normalizeDoxygenDescription(description: string, markdown: string): string;
 export declare function loadDoxygenTab(config: ResolvedDoxygenConfig, tabSlug: string, tabLabel: string): Promise<DoxygenResult>;
 //# sourceMappingURL=doxygen-loader.d.ts.map

package/dist/core/doxygen-loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"doxygen-loader.d.ts","sourceRoot":"","sources":["../../src/core/doxygen-loader.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAqB,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAE7E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,KAAK,EAAE,OAAO,EAA6B,MAAM,iBAAiB,CAAC;AAM1E,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACjC,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,wBAAsB,cAAc,CAClC,MAAM,EAAE,qBAAqB,EAC7B,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,aAAa,CAAC,CA4FxB"}
+{"version":3,"file":"doxygen-loader.d.ts","sourceRoot":"","sources":["../../src/core/doxygen-loader.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAqB,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAE7E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,KAAK,EAAE,OAAO,EAA6B,MAAM,iBAAiB,CAAC;AAM1E,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACjC,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,wBAAgB,2BAA2B,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAMzF;AAED,wBAAsB,cAAc,CAClC,MAAM,EAAE,qBAAqB,EAC7B,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,aAAa,CAAC,CA6FxB"}

package/dist/core/doxygen-loader.js

@@ -1,5 +1,13 @@
 import { generate } from "moxygen";
-import { renderMarkdown, extractHeadings } from "../utils/markdown.js";
+import { renderMarkdown, extractHeadings, extractFirstParagraph, stripMarkdownLinks } from "../utils/markdown.js";
+export function normalizeDoxygenDescription(description, markdown) {
+    if (!description)
+        return "";
+    if (!description.includes("{#ref "))
+        return description;
+    const firstParagraph = extractFirstParagraph(markdown);
+    return firstParagraph || description;
+}
 export async function loadDoxygenTab(config, tabSlug, tabLabel) {
     const generated = await generate({
         directory: config.xml,
@@ -11,11 +19,12 @@ export async function loadDoxygenTab(config, tabSlug, tabLabel) {
     for (const page of generated) {
         if (!page.markdown.trim())
             continue;
+        const description = normalizeDoxygenDescription(page.description, page.markdown);
         const html = renderMarkdown(page.markdown);
         const headings = extractHeadings(page.markdown);
         pages.set(page.slug, {
             title: page.title,
-            description: page.description,
+            description,
             slug: page.slug,
             html,
             headings,
@@ -130,7 +139,7 @@ function buildRichIndex(groupMap, pages) {
             continue;
         const typeCount = items.filter((i) => i.kind !== "group" && i.kind !== "namespace").length;
         const href = `${groupEntry.slug}.html`;
-        const desc = page.description || "";
+        const desc = stripMarkdownLinks(page.description || "");
         const meta = typeCount > 0
             ? `<p style="margin:0.5rem 0 0;font-size:0.8rem;opacity:0.5">${typeCount} type${typeCount !== 1 ? "s" : ""}</p>`
             : "";

package/dist/core/markdown-loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"markdown-loader.d.ts","sourceRoot":"","sources":["../../src/core/markdown-loader.ts"],"names":[],"mappings":"AAKA,OAAO,EAAmC,KAAK,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAMzF,MAAM,WAAW,YAAY;IAC3B,kCAAkC;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,wCAAwC;IACxC,WAAW,EAAE,MAAM,CAAC;IACpB,qDAAqD;IACrD,IAAI,EAAE,MAAM,CAAC;IACb,yBAAyB;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,qDAAqD;IACrD,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,sEAAsE;IACtE,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,YAAY,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AA4TxD;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,YAAY,CAAC,CAmBvB;AAUD;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAIrD"}
+{"version":3,"file":"markdown-loader.d.ts","sourceRoot":"","sources":["../../src/core/markdown-loader.ts"],"names":[],"mappings":"AAKA,OAAO,EAAmC,KAAK,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAMzF,MAAM,WAAW,YAAY;IAC3B,kCAAkC;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,wCAAwC;IACxC,WAAW,EAAE,MAAM,CAAC;IACpB,qDAAqD;IACrD,IAAI,EAAE,MAAM,CAAC;IACb,yBAAyB;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,qDAAqD;IACrD,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,sEAAsE;IACtE,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,YAAY,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAmcxD;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,YAAY,CAAC,CAmBvB;AAUD;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAIrD"}

package/dist/core/markdown-loader.js

@@ -16,6 +16,47 @@ function parseFrontmatter(raw) {
     const meta = parseYaml(match[1]) ?? {};
     return { meta, body: match[2] };
 }
+const FENCED_BLOCK_TOKEN = "@@SOURCEY_FENCED_BLOCK_";
+function protectFencedCodeBlocks(input) {
+    const blocks = [];
+    const output = [];
+    const lines = input.split("\n");
+    let fence = null;
+    let buffer = [];
+    const pushProtectedBlock = () => {
+        const index = blocks.push(buffer.join("\n")) - 1;
+        output.push(`${FENCED_BLOCK_TOKEN}${index}@@`);
+        buffer = [];
+    };
+    for (const line of lines) {
+        const stripped = line.replace(/^ {1,3}/, "");
+        const fenceMatch = stripped.match(/^(`{3,}|~{3,})(.*)$/);
+        if (!fence) {
+            if (!fenceMatch) {
+                output.push(line);
+                continue;
+            }
+            fence = { char: fenceMatch[1][0], length: fenceMatch[1].length };
+            buffer.push(line);
+            continue;
+        }
+        buffer.push(line);
+        if (fenceMatch &&
+            fenceMatch[1][0] === fence.char &&
+            fenceMatch[1].length >= fence.length &&
+            !fenceMatch[2].trim()) {
+            pushProtectedBlock();
+            fence = null;
+        }
+    }
+    if (buffer.length > 0) {
+        output.push(...buffer);
+    }
+    return { text: output.join("\n"), blocks };
+}
+function restoreFencedCodeBlocks(input, blocks) {
+    return blocks.reduce((text, block, index) => text.replaceAll(`${FENCED_BLOCK_TOKEN}${index}@@`, block), input);
+}
 // ---------------------------------------------------------------------------
 // Component preprocessor: transforms MDX-style JSX components into HTML
 // ---------------------------------------------------------------------------
@@ -24,7 +65,8 @@ function parseFrontmatter(raw) {
  * a single rendering path in preprocessDirectives.
  */
 function preprocessComponents(body) {
-    let html = body;
+    const { text, blocks } = protectFencedCodeBlocks(body);
+    let html = text;
     // <Steps> <Step title="...">content</Step> ... </Steps> → :::steps numbered list
     html = html.replace(/<Steps>\s*([\s\S]*?)\s*<\/Steps>/g, (_m, inner) => {
         const steps = [];
@@ -56,7 +98,46 @@ function preprocessComponents(body) {
     html = html.replace(/<Accordion\s+title="([^"]*)">\s*([\s\S]*?)\s*<\/Accordion>/g, (_m, title, content) => {
         return `:::accordion{title="${title}"}\n${content.trim()}\n:::`;
     });
-    return html;
+    // <Tabs> <Tab title="...">content</Tab> ... </Tabs> → :::tabs with ::tab children
+    html = html.replace(/<Tabs>\s*([\s\S]*?)\s*<\/Tabs>/g, (_m, inner) => {
+        const tabs = [];
+        inner.replace(/\s*<Tab\s+title="([^"]*)">\s*([\s\S]*?)\s*<\/Tab>/g, (_tm, title, content) => {
+            tabs.push(`::tab{title="${title}"}\n${content.trim()}\n::`);
+            return "";
+        });
+        return `:::tabs\n${tabs.join("\n")}\n:::`;
+    });
+    // <CodeGroup> with titled fenced code blocks → :::code-group
+    html = html.replace(/<CodeGroup>\s*([\s\S]*?)\s*<\/CodeGroup>/g, (_m, inner) => `:::code-group\n${inner.trim()}\n:::`);
+    // <Note>, <Warning>, <Tip>, <Info> → :::callout directives
+    for (const type of ["note", "warning", "tip", "info"]) {
+        const tag = type.charAt(0).toUpperCase() + type.slice(1);
+        html = html.replace(new RegExp(`<${tag}(?:\\s+title="([^"]*)")?\\s*>\\s*([\\s\\S]*?)\\s*<\\/${tag}>`, "g"), (_m, title, content) => {
+            const titleSuffix = title ? ` ${title}` : "";
+            return `:::${type}${titleSuffix}\n${content.trim()}\n:::`;
+        });
+    }
+    // <Video src="..." title="..." /> → ::video[url]{title="..."}
+    html = html.replace(/<Video\s+([^>]*?)\s*\/?\s*>/g, (_m, attrs) => {
+        const src = attrs.match(/src="([^"]*)"/)?.[1] ?? "";
+        const title = attrs.match(/title="([^"]*)"/)?.[1];
+        const titleAttr = title ? `{title="${title}"}` : "";
+        return `::video[${src}]${titleAttr}`;
+    });
+    // <Iframe src="..." title="..." height="..." /> → ::iframe[url]{attrs}
+    html = html.replace(/<Iframe\s+([^>]*?)\s*\/?\s*>/g, (_m, attrs) => {
+        const src = attrs.match(/src="([^"]*)"/)?.[1] ?? "";
+        const title = attrs.match(/title="([^"]*)"/)?.[1];
+        const height = attrs.match(/height="([^"]*)"/)?.[1];
+        const parts = [];
+        if (title)
+            parts.push(`title="${title}"`);
+        if (height)
+            parts.push(`height="${height}"`);
+        const attrStr = parts.length ? `{${parts.join(" ")}}` : "";
+        return `::iframe[${src}]${attrStr}`;
+    });
+    return restoreFencedCodeBlocks(html, blocks);
 }
 // ---------------------------------------------------------------------------
 // Directive preprocessor: transforms :::directive blocks into HTML
@@ -128,7 +209,8 @@ function splitChildren(content, marker) {
  * from other directive types cannot collide.
  */
 function preprocessDirectives(body) {
-    let html = body;
+    const { text, blocks } = protectFencedCodeBlocks(body);
+    let html = text;
     // Callouts: :::note, :::warning, :::tip, :::info (optional title)
     html = html.replace(/^:::(note|warning|tip|info)(?:[^\S\n]+(.+))?\s*\n([\s\S]*?)^:::\s*$/gm, (_m, type, title, content) => {
         const label = title?.trim() || type.charAt(0).toUpperCase() + type.slice(1);
@@ -142,14 +224,30 @@ ${body ? `<div class="callout-content">\n\n${body}\n\n</div>` : ""}
     html = html.replace(/^:::steps\s*\n([\s\S]*?)^:::\s*$/gm, (_m, content) => {
         const lines = content.trim().split("\n");
         const steps = [];
+        let fenceMarker = "";
         for (const line of lines) {
-            const sm = line.match(/^\d+\.\s+(.+)/);
+            // Track fenced code blocks so we don't mis-detect numbered
+            // lines inside them as step titles.  A closing fence must use
+            // the same character, at least as many repeats, and no info string.
+            const stripped = line.replace(/^ {1,3}/, "");
+            const fm = stripped.match(/^(`{3,}|~{3,})(.*)/);
+            if (fm) {
+                if (!fenceMarker) {
+                    fenceMarker = fm[1];
+                }
+                else if (fm[1][0] === fenceMarker[0] &&
+                    fm[1].length >= fenceMarker.length &&
+                    !fm[2].trim()) {
+                    fenceMarker = "";
+                }
+            }
+            const sm = !fenceMarker && line.match(/^\d+\.\s+(.+)/);
             if (sm) {
                 steps.push({ title: sm[1], body: [] });
             }
             else if (steps.length > 0) {
                 // Strip up to 3 leading spaces (markdown list indent)
-                steps[steps.length - 1].body.push(line.replace(/^ {1,3}/, ""));
+                steps[steps.length - 1].body.push(stripped);
             }
         }
         const items = steps
@@ -177,15 +275,16 @@ ${s.body.join("\n").trim()}
     });
     // Code Group: :::code-group with titled fenced code blocks
     html = html.replace(/^:::code-group\s*\n([\s\S]*?)^:::\s*$/gm, (_m, content) => {
-        const blocks = [];
+        const restoredContent = restoreFencedCodeBlocks(content, blocks);
+        const codeBlocks = [];
         const re = /```(\w+)\s+title="([^"]*)"\s*\n([\s\S]*?)```/g;
         let match;
-        while ((match = re.exec(content)) !== null) {
-            blocks.push({ title: match[2], body: `\`\`\`${match[1]}\n${match[3]}\`\`\`` });
+        while ((match = re.exec(restoredContent)) !== null) {
+            codeBlocks.push({ title: match[2], body: `\`\`\`${match[1]}\n${match[3]}\`\`\`` });
         }
-        if (blocks.length === 0)
-            return content;
-        return `\n\n${buildTabbedHtml(blocks, nextId("cg"), "directive-code-group")}\n\n`;
+        if (codeBlocks.length === 0)
+            return restoredContent;
+        return `\n\n${buildTabbedHtml(codeBlocks, nextId("cg"), "directive-code-group")}\n\n`;
     });
     // Card Group: :::card-group{cols="N"} with ::card children
     html = html.replace(/^:::card-group(?:\{([^}]*)\})?\s*\n([\s\S]*?)^:::\s*$/gm, (_m, attrsRaw, content) => {
@@ -227,7 +326,7 @@ ${content.trim()}
             return match;
         return `<div class="accordion-group not-prose">\n${match.trim()}\n</div>`;
     });
-    return html;
+    return restoreFencedCodeBlocks(html, blocks);
 }
 // ---------------------------------------------------------------------------
 // Public API

package/dist/dev-server.js

@@ -439,7 +439,7 @@ async function buildSiteConfig(config) {
         name: config.name,
         theme: config.theme,
         logo: logo?.light ? logo : undefined,
-        favicon: config.favicon,
+        favicon: config.favicon ? await resolveAssetUrl(config.favicon) : undefined,
         repo: config.repo,
         editBranch: config.editBranch,
         editBasePath: config.editBasePath,
@@ -459,6 +459,7 @@ async function loadCustomCSS(paths) {
 const MIME_TYPES = {
     ".png": "image/png", ".jpg": "image/jpeg", ".jpeg": "image/jpeg",
     ".gif": "image/gif", ".svg": "image/svg+xml", ".webp": "image/webp",
+    ".ico": "image/x-icon",
 };
 async function resolveAssetUrl(pathOrUrl) {
     if (!pathOrUrl || pathOrUrl.startsWith("http://") || pathOrUrl.startsWith("https://") || pathOrUrl.startsWith("data:")) {

package/dist/index.js

@@ -158,7 +158,7 @@ async function buildSiteConfig(config) {
         name: config.name,
         theme: config.theme,
         logo: logo?.light ? logo : undefined,
-        favicon: config.favicon,
+        favicon: config.favicon ? await resolveAssetUrl(config.favicon) : undefined,
         repo: config.repo,
         editBranch: config.editBranch,
         editBasePath: config.editBasePath,

package/dist/init.js

@@ -243,7 +243,7 @@ import { myFunction } from "my-package";
                     build: "sourcey build",
                 },
                 dependencies: {
-                    sourcey: "^3.3.5",
+                    sourcey: "^3.4.3",
                 },
             }, null, 2);
             writeFileSync(resolve(targetDir, "package.json"), pkg + "\n");

package/dist/themes/default/main.css

@@ -23,6 +23,7 @@
   --color-primary: 99 102 241;
   --color-primary-light: 129 140 248;
   --color-primary-dark: 79 70 229;
+  --color-primary-ink: 79 70 229;
 
   /* Backgrounds */
   --color-background-light: 255 255 255;
@@ -70,7 +71,6 @@
   --method-prompt: #2563eb;
 
   /* Typography */
-  --font-sans: 'Inter', -apple-system, BlinkMacSystemFont, 'Segoe UI', system-ui, sans-serif;
-  --font-mono: 'Geist Mono', 'SF Mono', 'Fira Code', 'Cascadia Code', Consolas, monospace;
+  --font-sans: ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;
+  --font-mono: ui-monospace, 'SF Mono', 'Cascadia Code', Consolas, 'Liberation Mono', Menlo, monospace;
 }
-

package/dist/themes/default/sourcey.css

@@ -9,15 +9,19 @@
 
 /* ── Page Description (display font) ─────────────────────────────── */
 
-@import url('https://fonts.googleapis.com/css2?family=Playfair+Display:ital@0;1&display=swap');
-
 #sourcey .page-description {
-  font-family: 'Playfair Display', Georgia, serif;
-  font-size: 1.375rem;
-  line-height: 1.4;
+  font-family: ui-serif, Georgia, Cambria, "Times New Roman", serif;
+  font-size: 1.125rem;
+  line-height: 1.35;
   font-style: italic;
   color: rgb(var(--color-gray-600));
 }
+@media (min-width: 1024px) {
+  #sourcey .page-description {
+    font-size: 1.375rem;
+    line-height: 1.4;
+  }
+}
 .dark #sourcey .page-description {
   color: rgb(var(--color-gray-400));
 }
@@ -86,6 +90,12 @@ h1[id], h2[id], h3[id], h4[id], h5[id], h6[id] {
   overflow-x: auto;
   -webkit-overflow-scrolling: touch;
 }
+#sourcey .table-wrap table {
+  margin: 0;
+}
+#sourcey .prose :where(thead th):not(:where([class~=not-prose],[class~=not-prose] *)) {
+  padding-top: .571429em;
+}
 
 /* ── Prose Video (::video directive) ──────────────────────────────── */
 
@@ -245,7 +255,7 @@ h1[id], h2[id], h3[id], h4[id], h5[id], h6[id] {
   background: rgb(var(--color-gray-800) / 0.4);
 }
 #sourcey .nav-link.active {
-  color: rgb(var(--color-primary));
+  color: rgb(var(--color-primary-ink));
   background: rgb(var(--color-primary) / 0.08);
   font-weight: 500;
 }
@@ -261,12 +271,15 @@ h1[id], h2[id], h3[id], h4[id], h5[id], h6[id] {
   padding-left: 0.75rem;
   transition: color 0.15s, border-color 0.15s;
 }
+#sourcey #toc ul ul .toc-item {
+  margin-left: 0.75rem;
+}
 .dark #sourcey #toc .toc-item {
   border-left-color: rgb(var(--color-gray-700));
 }
 #sourcey #toc .toc-item.active {
-  color: rgb(var(--color-primary));
-  border-left-color: rgb(var(--color-primary));
+  color: rgb(var(--color-primary-ink));
+  border-left-color: rgb(var(--color-primary-ink));
 }
 .dark #sourcey #toc .toc-item.active {
   color: rgb(var(--color-primary-light));
@@ -310,7 +323,7 @@ h1[id], h2[id], h3[id], h4[id], h5[id], h6[id] {
 }
 
 #sourcey .response-tab.active {
-  color: rgb(var(--color-primary));
+  color: rgb(var(--color-primary-ink));
 }
 .dark #sourcey .response-tab.active {
   color: rgb(var(--color-primary-light));
@@ -511,7 +524,7 @@ h1[id], h2[id], h3[id], h4[id], h5[id], h6[id] {
   font-family: var(--font-mono);
   font-size: 0.875rem;
   font-weight: 600;
-  color: rgb(var(--color-primary));
+  color: rgb(var(--color-primary-ink));
   background: transparent;
   border: none;
   padding: 0;
@@ -793,16 +806,17 @@ h1[id], h2[id], h3[id], h4[id], h5[id], h6[id] {
 
 #sourcey .callout {
   margin: 1.25rem 0;
-  border-radius: var(--radius);
-  border: 1px solid rgb(var(--color-gray-200) / 0.7);
-  border-left-width: 3px;
+  border: none;
+  border-left: 1px solid;
+  border-radius: 0;
   padding: 0.875rem 1rem;
   font-size: 0.875rem;
   line-height: 1.6;
   color: rgb(var(--color-gray-700));
+  border-left-color: rgb(var(--color-gray-300));
 }
 .dark #sourcey .callout {
-  border-color: rgb(var(--color-gray-800) / 0.5);
+  border-left-color: rgb(var(--color-gray-700));
   color: rgb(var(--color-gray-400));
 }
 
@@ -831,50 +845,26 @@ h1[id], h2[id], h3[id], h4[id], h5[id], h6[id] {
 }
 
 /* Note — blue */
-#sourcey .callout-note {
-  border-left-color: #3b82f6;
-  background: rgb(59 130 246 / 0.04);
-}
-.dark #sourcey .callout-note {
-  border-left-color: #60a5fa;
-  background: rgb(59 130 246 / 0.06);
-}
+#sourcey .callout-note { border-left-color: #3b82f6; }
+.dark #sourcey .callout-note { border-left-color: #60a5fa; }
 #sourcey .callout-note .callout-title { color: #3b82f6; }
 .dark #sourcey .callout-note .callout-title { color: #60a5fa; }
 
 /* Warning — amber */
-#sourcey .callout-warning {
-  border-left-color: #f59e0b;
-  background: rgb(245 158 11 / 0.04);
-}
-.dark #sourcey .callout-warning {
-  border-left-color: #fbbf24;
-  background: rgb(245 158 11 / 0.06);
-}
+#sourcey .callout-warning { border-left-color: #f59e0b; }
+.dark #sourcey .callout-warning { border-left-color: #fbbf24; }
 #sourcey .callout-warning .callout-title { color: #f59e0b; }
 .dark #sourcey .callout-warning .callout-title { color: #fbbf24; }
 
 /* Tip — green */
-#sourcey .callout-tip {
-  border-left-color: #22c55e;
-  background: rgb(34 197 94 / 0.04);
-}
-.dark #sourcey .callout-tip {
-  border-left-color: #4ade80;
-  background: rgb(34 197 94 / 0.06);
-}
+#sourcey .callout-tip { border-left-color: #22c55e; }
+.dark #sourcey .callout-tip { border-left-color: #4ade80; }
 #sourcey .callout-tip .callout-title { color: #22c55e; }
 .dark #sourcey .callout-tip .callout-title { color: #4ade80; }
 
 /* Info — violet */
-#sourcey .callout-info {
-  border-left-color: #8b5cf6;
-  background: rgb(139 92 246 / 0.04);
-}
-.dark #sourcey .callout-info {
-  border-left-color: #a78bfa;
-  background: rgb(139 92 246 / 0.06);
-}
+#sourcey .callout-info { border-left-color: #8b5cf6; }
+.dark #sourcey .callout-info { border-left-color: #a78bfa; }
 #sourcey .callout-info .callout-title { color: #8b5cf6; }
 .dark #sourcey .callout-info .callout-title { color: #a78bfa; }
 
@@ -921,7 +911,7 @@ h1[id], h2[id], h3[id], h4[id], h5[id], h6[id] {
 }
 
 #sourcey .directive-tab.active {
-  color: rgb(var(--color-primary));
+  color: rgb(var(--color-primary-ink));
 }
 .dark #sourcey .directive-tab.active {
   color: rgb(var(--color-primary-light));
@@ -1097,7 +1087,7 @@ h1[id], h2[id], h3[id], h4[id], h5[id], h6[id] {
   background: rgb(var(--color-gray-800));
 }
 .drawer-dropdown-item.active {
-  color: rgb(var(--color-primary));
+  color: rgb(var(--color-primary-ink));
   font-weight: 500;
 }
 .dark .drawer-dropdown-item.active {

package/dist/utils/markdown.d.ts

@@ -14,6 +14,16 @@ export interface PageHeading {
  * No rendering needed; pure token walk.
  */
 export declare function extractHeadings(input: string): PageHeading[];
+/**
+ * Extract the first paragraph token from markdown.
+ * Useful for generated docs where a summary paragraph is embedded in the body.
+ */
+export declare function extractFirstParagraph(input?: string): string;
+/**
+ * Replace markdown links with their visible labels.
+ * Useful when rendering inside an existing clickable container.
+ */
+export declare function stripMarkdownLinks(input?: string): string;
 /**
  * Render Markdown to HTML.
  */

package/dist/utils/markdown.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"markdown.d.ts","sourceRoot":"","sources":["../../src/utils/markdown.ts"],"names":[],"mappings":"AAKA;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CASnE;AAED,4CAA4C;AAC5C,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,CAAC,GAAG,CAAC,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;CACZ;AAgJD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,EAAE,CAe5D;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAGrD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAG3D"}
+{"version":3,"file":"markdown.d.ts","sourceRoot":"","sources":["../../src/utils/markdown.ts"],"names":[],"mappings":"AAKA;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CASnE;AAED,4CAA4C;AAC5C,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,CAAC,GAAG,CAAC,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;CACZ;AAgJD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,EAAE,CAe5D;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAY5D;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAGzD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAGrD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAG3D"}

package/dist/utils/markdown.js

@@ -157,6 +157,35 @@ export function extractHeadings(input) {
     }
     return headings;
 }
+/**
+ * Extract the first paragraph token from markdown.
+ * Useful for generated docs where a summary paragraph is embedded in the body.
+ */
+export function extractFirstParagraph(input) {
+    if (!input)
+        return "";
+    const tokens = marked.lexer(input);
+    for (const token of tokens) {
+        if (token.type === "paragraph") {
+            const raw = token.raw.trim();
+            if (!raw)
+                continue;
+            if (!raw.replace(/<[^>]+>/g, "").trim())
+                continue;
+            return raw;
+        }
+    }
+    return "";
+}
+/**
+ * Replace markdown links with their visible labels.
+ * Useful when rendering inside an existing clickable container.
+ */
+export function stripMarkdownLinks(input) {
+    if (!input)
+        return "";
+    return input.replace(/\[([^\]]+)\]\(([^)]+)\)/g, "$1");
+}
 /**
  * Render Markdown to HTML.
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sourcey",
-  "version": "3.4.1",
+  "version": "3.4.4",
   "description": "Open source documentation platform. API references, guides, static output.",
   "type": "module",
   "engines": {