sourcey 3.4.0 → 3.4.3

package/dist/utils/markdown.js

@@ -16,6 +16,27 @@ export function renderCodeBlock(text, lang) {
 <div class="prose-code-content">${shiki}</div>
 </div>`;
 }
+/* ── Shared directive helpers ─────────────────────────────────────── */
+function parseDirectiveAttrs(raw) {
+    const attrs = {};
+    for (const [, k, v] of raw.matchAll(/(\w+)="([^"]*)"/g))
+        attrs[k] = v;
+    return attrs;
+}
+function escAttr(s) {
+    return s.replace(/&/g, "&amp;").replace(/"/g, "&quot;").replace(/</g, "&lt;");
+}
+function requireHttps(url) {
+    try {
+        const u = new URL(url);
+        if (u.protocol !== "https:" && u.protocol !== "http:")
+            return null;
+        return u.href;
+    }
+    catch {
+        return null;
+    }
+}
 function parseVideoUrl(url) {
     // YouTube
     let m = url.match(/(?:youtube\.com\/watch\?v=|youtu\.be\/)([\w-]+)/);
@@ -42,15 +63,13 @@ const videoExtension = {
                 const match = src.match(/^::video\[([^\]]+)\](?:\{([^}]*)\})?/);
                 if (!match)
                     return undefined;
-                const url = match[1];
-                const attrs = match[2] ?? "";
-                const titleMatch = attrs.match(/title="([^"]*)"/);
-                return { type: "video", raw: match[0], url, title: titleMatch?.[1] ?? "" };
+                const attrs = parseDirectiveAttrs(match[2] ?? "");
+                return { type: "video", raw: match[0], url: match[1], title: attrs.title ?? "" };
             },
             renderer(token) {
                 const { url, title } = token;
                 const parsed = parseVideoUrl(url);
-                const safeTitle = title.replace(/"/g, "&quot;").replace(/</g, "&lt;");
+                const safeTitle = escAttr(title);
                 if (parsed.type === "iframe") {
                     return `<div class="prose-video not-prose">
 <iframe src="${parsed.src}" title="${safeTitle}" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen loading="lazy"></iframe>
@@ -65,8 +84,36 @@ const videoExtension = {
         },
     ],
 };
+const iframeExtension = {
+    extensions: [
+        {
+            name: "iframe",
+            level: "block",
+            start(src) {
+                return src.match(/::iframe\[/)?.index;
+            },
+            tokenizer(src) {
+                const match = src.match(/^::iframe\[([^\]]+)\](?:\{([^}]*)\})?/);
+                if (!match)
+                    return undefined;
+                const attrs = parseDirectiveAttrs(match[2] ?? "");
+                const height = parseInt(attrs.height ?? "", 10);
+                return { type: "iframe", raw: match[0], url: match[1], title: attrs.title ?? "", height: Number.isFinite(height) ? height : 400 };
+            },
+            renderer(token) {
+                const { url, title, height } = token;
+                const safeUrl = requireHttps(url);
+                if (!safeUrl)
+                    return `<p>[iframe: invalid URL]</p>\n`;
+                return `<div class="prose-iframe not-prose" style="height:${height}px">
+<iframe src="${escAttr(safeUrl)}" title="${escAttr(title)}" frameborder="0" loading="lazy" allowfullscreen></iframe>
+</div>\n`;
+            },
+        },
+    ],
+};
 /** Singleton Marked instance — code blocks get Shiki + prose wrapper, headings get IDs. */
-const marked = new Marked(videoExtension, {
+const marked = new Marked(videoExtension, iframeExtension, {
     renderer: {
         code({ text, lang }) {
             return renderCodeBlock(text, lang);
@@ -110,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.0",
+  "version": "3.4.3",
   "description": "Open source documentation platform. API references, guides, static output.",
   "type": "module",
   "engines": {