sourcey 3.4.1 → 3.4.3

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;AAwXxD;;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

@@ -56,6 +56,45 @@ 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:::`;
     });
+    // <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 html;
 }
 // ---------------------------------------------------------------------------

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,

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));
 }
@@ -245,7 +249,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 +265,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 +317,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 +518,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 +800,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 +839,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 +905,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 +1081,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.3",
   "description": "Open source documentation platform. API references, guides, static output.",
   "type": "module",
   "engines": {