sourcey 3.3.10 → 3.4.0

package/dist/themes/default/sourcey.css

@@ -55,6 +55,25 @@ h1[id], h2[id], h3[id], h4[id], h5[id], h6[id] {
   -webkit-overflow-scrolling: touch;
 }
 
+/* ── Prose Video (::video directive) ──────────────────────────────── */
+
+#sourcey .prose-video {
+  position: relative;
+  width: 100%;
+  padding-bottom: 56.25%; /* 16:9 */
+  margin: 1.5rem 0;
+  border-radius: var(--radius);
+  overflow: hidden;
+}
+#sourcey .prose-video iframe,
+#sourcey .prose-video video {
+  position: absolute;
+  top: 0;
+  left: 0;
+  width: 100%;
+  height: 100%;
+}
+
 /* ── Prose Code Block (fenced code in markdown pages) ─────────────── */
 
 #sourcey .prose-code-block {
@@ -159,39 +178,49 @@ h1[id], h2[id], h3[id], h4[id], h5[id], h6[id] {
   text-align: left;
   overflow-wrap: break-word;
   hyphens: auto;
-  border-left: 2px solid transparent;
+  border-radius: 0.375rem;
   width: 100%;
   color: rgb(var(--color-gray-700));
-  transition: color 0.15s, border-color 0.15s;
+  transition: color 0.15s, background-color 0.15s;
 }
 .dark #sourcey .nav-link {
   color: rgb(var(--color-gray-400));
 }
 #sourcey .nav-link:hover {
   color: rgb(var(--color-gray-900));
-  border-left-color: rgb(var(--color-gray-300));
+  background: rgb(var(--color-gray-100) / 0.6);
 }
 .dark #sourcey .nav-link:hover {
   color: rgb(var(--color-gray-300));
-  border-left-color: rgb(var(--color-gray-600));
+  background: rgb(var(--color-gray-800) / 0.4);
 }
 #sourcey .nav-link.active {
   color: rgb(var(--color-primary));
-  border-left-color: rgb(var(--color-primary));
+  background: rgb(var(--color-primary) / 0.08);
   font-weight: 500;
 }
 .dark #sourcey .nav-link.active {
   color: rgb(var(--color-primary-light));
-  border-left-color: rgb(var(--color-primary-light));
+  background: rgb(var(--color-primary-light) / 0.08);
 }
 
 /* ── TOC Active State ─────────────────────────────────────────────── */
 
+#sourcey #toc .toc-item {
+  border-left: 2px solid rgb(var(--color-gray-200));
+  padding-left: 0.75rem;
+  transition: color 0.15s, border-color 0.15s;
+}
+.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));
 }
 .dark #sourcey #toc .toc-item.active {
   color: rgb(var(--color-primary-light));
+  border-left-color: rgb(var(--color-primary-light));
 }
 
 /* ── Code Block Panels (language dropdown + response tabs) ─────────── */
@@ -1025,11 +1054,10 @@ h1[id], h2[id], h3[id], h4[id], h5[id], h6[id] {
   color: rgb(var(--color-primary-light));
 }
 
-/* Drawer nav items — larger touch targets, no border indicator */
+/* Drawer nav items — larger touch targets */
 #sourcey .mobile-nav-dialog .nav-link,
 #sourcey .mobile-nav-dialog .nav-link:hover,
 #sourcey .mobile-nav-dialog .nav-link.active {
-  border-left: none;
   padding-top: 0.5rem;
   padding-bottom: 0.5rem;
 }

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;AA8BD;;;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;AAuFD;;;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"}

package/dist/utils/markdown.js

@@ -16,8 +16,57 @@ export function renderCodeBlock(text, lang) {
 <div class="prose-code-content">${shiki}</div>
 </div>`;
 }
+function parseVideoUrl(url) {
+    // YouTube
+    let m = url.match(/(?:youtube\.com\/watch\?v=|youtu\.be\/)([\w-]+)/);
+    if (m)
+        return { src: `https://www.youtube-nocookie.com/embed/${m[1]}`, type: "iframe" };
+    // Vimeo
+    m = url.match(/vimeo\.com\/(\d+)/);
+    if (m)
+        return { src: `https://player.vimeo.com/video/${m[1]}`, type: "iframe" };
+    // Raw video
+    const ext = url.split(".").pop()?.toLowerCase();
+    const mime = ext === "webm" ? "video/webm" : "video/mp4";
+    return { src: url, type: "video", mime };
+}
+const videoExtension = {
+    extensions: [
+        {
+            name: "video",
+            level: "block",
+            start(src) {
+                return src.match(/::video\[/)?.index;
+            },
+            tokenizer(src) {
+                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] ?? "" };
+            },
+            renderer(token) {
+                const { url, title } = token;
+                const parsed = parseVideoUrl(url);
+                const safeTitle = title.replace(/"/g, "&quot;").replace(/</g, "&lt;");
+                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>
+</div>\n`;
+                }
+                return `<div class="prose-video not-prose">
+<video controls preload="metadata" title="${safeTitle}">
+<source src="${parsed.src}" type="${parsed.mime}" />
+</video>
+</div>\n`;
+            },
+        },
+    ],
+};
 /** Singleton Marked instance — code blocks get Shiki + prose wrapper, headings get IDs. */
-const marked = new Marked({
+const marked = new Marked(videoExtension, {
     renderer: {
         code({ text, lang }) {
             return renderCodeBlock(text, lang);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sourcey",
-  "version": "3.3.10",
+  "version": "3.4.0",
   "description": "Open source documentation platform. API references, guides, static output.",
   "type": "module",
   "engines": {
@@ -21,7 +21,7 @@
   ],
   "scripts": {
     "build": "tsc && cp -r src/themes dist/ && cp src/client/*.js dist/client/",
-    "dev": "tsc --watch",
+    "watch": "npm run build && tsc --watch --preserveWatchOutput",
     "test": "vitest run",
     "test:watch": "vitest",
     "lint": "eslint src/ test/",
@@ -39,6 +39,7 @@
     "jiti": "^2.6.1",
     "js-yaml": "^4.1.0",
     "marked": "^15.0.0",
+    "mcp-parser": "^0.2.0",
     "moxygen": "^2.1.1",
     "preact": "^10.28.4",
     "preact-render-to-string": "^6.6.6",
@@ -69,6 +70,9 @@
     "developer-documentation",
     "doxygen"
   ],
+  "funding": {
+    "url": "https://sourcey.com"
+  },
   "author": "Kam Low <oss@0state.com> (https://sourcey.com)",
   "license": "AGPL-3.0-only",
   "repository": {