sourcey 3.3.10 → 3.4.1

package/dist/themes/default/sourcey.css

@@ -7,6 +7,38 @@
  * utilities in generated HTML.
  */
 
+/* ── 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-style: italic;
+  color: rgb(var(--color-gray-600));
+}
+.dark #sourcey .page-description {
+  color: rgb(var(--color-gray-400));
+}
+
+/* ── Page Top Gradient ────────────────────────────────────────────── */
+
+#sourcey #page::before {
+  content: "";
+  position: fixed;
+  top: 0;
+  left: 0;
+  right: 0;
+  height: 400px;
+  background: linear-gradient(to bottom, rgb(var(--color-primary) / 0.03), transparent);
+  pointer-events: none;
+  z-index: -1;
+}
+.dark #sourcey #page::before {
+  background: none;
+}
+
 /* ── Scroll Offset (clears fixed navbar on anchor clicks) ──────────── */
 
 [data-traverse-target],
@@ -55,6 +87,43 @@ 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 Iframe (::iframe directive) ────────────────────────────── */
+
+#sourcey .prose-iframe {
+  width: 100%;
+  margin: 1.5rem 0;
+  border-radius: var(--radius);
+  overflow: hidden;
+  border: 1px solid rgb(var(--color-stone-950) / 0.1);
+}
+.dark #sourcey .prose-iframe {
+  border-color: rgb(255 255 255 / 0.1);
+}
+#sourcey .prose-iframe iframe {
+  width: 100%;
+  height: 100%;
+  display: block;
+}
+
 /* ── Prose Code Block (fenced code in markdown pages) ─────────────── */
 
 #sourcey .prose-code-block {
@@ -159,39 +228,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) ─────────── */
@@ -480,7 +559,7 @@ h1[id], h2[id], h3[id], h4[id], h5[id], h6[id] {
 
 #sourcey .steps {
   margin-left: 0.875rem;
-  margin-top: 2.5rem;
+  margin-top: 1rem;
   margin-bottom: 1.5rem;
 }
 
@@ -1025,11 +1104,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;
 }
@@ -1080,30 +1158,25 @@ h1[id], h2[id], h3[id], h4[id], h5[id], h6[id] {
   position: fixed;
   inset: 0;
   z-index: 500;
-  background: rgb(var(--color-overlay) / 0.4);
-  backdrop-filter: blur(4px);
-  -webkit-backdrop-filter: blur(4px);
-  align-items: flex-start;
-  justify-content: center;
-  padding-top: 15vh;
+  background: transparent;
 }
 
 #sourcey #search-dialog.open {
-  display: flex;
+  display: block;
 }
 
 #sourcey .search-dialog-inner {
-  width: 100%;
-  max-width: 540px;
+  position: absolute;
   background: rgb(var(--color-background-light));
   border-radius: var(--radius);
-  box-shadow: 0 16px 48px rgb(var(--color-overlay) / 0.2);
+  border: 1px solid rgb(var(--color-gray-200) / 0.7);
+  box-shadow: 0 8px 32px rgb(var(--color-overlay) / 0.12);
   overflow: hidden;
-  margin: 0 1rem;
 }
 .dark #sourcey .search-dialog-inner {
   background: rgb(var(--color-gray-900));
-  box-shadow: 0 16px 48px rgb(var(--color-overlay) / 0.5);
+  border-color: rgb(var(--color-gray-700) / 0.5);
+  box-shadow: 0 8px 32px rgb(var(--color-overlay) / 0.4);
 }
 
 #sourcey .search-input-row {
@@ -1173,7 +1246,8 @@ h1[id], h2[id], h3[id], h4[id], h5[id], h6[id] {
   gap: 0.25rem;
 }
 
-#sourcey .search-footer kbd {
+#sourcey .search-footer kbd,
+#sourcey #search-open kbd {
   display: inline-flex;
   align-items: center;
   justify-content: center;
@@ -1188,7 +1262,8 @@ h1[id], h2[id], h3[id], h4[id], h5[id], h6[id] {
   background: rgb(var(--color-gray-50));
   color: rgb(var(--color-gray-500));
 }
-.dark #sourcey .search-footer kbd {
+.dark #sourcey .search-footer kbd,
+.dark #sourcey #search-open kbd {
   border-color: rgb(var(--color-gray-700));
   background: rgb(var(--color-gray-800));
   color: rgb(var(--color-gray-400));
@@ -1249,6 +1324,9 @@ h1[id], h2[id], h3[id], h4[id], h5[id], h6[id] {
 #sourcey .search-result-method.method-put { background: var(--method-put); }
 #sourcey .search-result-method.method-delete { background: var(--method-delete); }
 #sourcey .search-result-method.method-patch { background: var(--method-patch); }
+#sourcey .search-result-method.method-tool { background: var(--method-tool); }
+#sourcey .search-result-method.method-resource { background: var(--method-resource); }
+#sourcey .search-result-method.method-prompt { background: var(--method-prompt); }
 
 #sourcey .search-result-path {
   font-family: var(--font-mono);

package/dist/utils/icons.d.ts

@@ -6,6 +6,10 @@
  * Each value is the inner path content (no wrapping <svg>).
  * Render with: `<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.5">${path}</svg>`
  */
+/**
+ * Return raw inner SVG content for a named icon, or undefined.
+ */
+export declare function iconPath(name: string): string | undefined;
 /**
  * Render a Heroicon as an inline SVG string.
  * Returns empty string if the icon name is not found.

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

@@ -1 +1 @@
-{"version":3,"file":"icons.d.ts","sourceRoot":"","sources":["../../src/utils/icons.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAgFH;;;GAGG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAI/C"}
+{"version":3,"file":"icons.d.ts","sourceRoot":"","sources":["../../src/utils/icons.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAgFH;;GAEG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAEzD;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAI/C"}

package/dist/utils/icons.js

@@ -46,6 +46,12 @@ const icons = {
     info: '<path stroke-linecap="round" stroke-linejoin="round" d="m11.25 11.25.041-.02a.75.75 0 0 1 1.063.852l-.708 2.836a.75.75 0 0 0 1.063.853l.041-.021M21 12a9 9 0 1 1-18 0 9 9 0 0 1 18 0Zm-9-3.75h.008v.008H12V8.25Z"/>',
     warning: '<path stroke-linecap="round" stroke-linejoin="round" d="M12 9v3.75m-9.303 3.376c-.866 1.5.217 3.374 1.948 3.374h14.71c1.73 0 2.813-1.874 1.948-3.374L13.949 3.378c-.866-1.5-3.032-1.5-3.898 0L2.697 16.126ZM12 15.75h.007v.008H12v-.008Z"/>',
 };
+/**
+ * Return raw inner SVG content for a named icon, or undefined.
+ */
+export function iconPath(name) {
+    return icons[name];
+}
 /**
  * Render a Heroicon as an inline SVG string.
  * Returns empty string if the icon name is not found.

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

package/dist/utils/markdown.js

@@ -16,8 +16,104 @@ 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-]+)/);
+    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 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 = 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>
+</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`;
+            },
+        },
+    ],
+};
+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({
+const marked = new Marked(videoExtension, iframeExtension, {
     renderer: {
         code({ text, lang }) {
             return renderCodeBlock(text, lang);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sourcey",
-  "version": "3.3.10",
+  "version": "3.4.1",
   "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": {