@farming-labs/svelte 0.1.58 → 0.1.59

package/dist/markdown.d.ts

@@ -9,14 +9,17 @@
  *   - Tables, lists, inline formatting, headings with anchor IDs
  */
 import { type DocsTheme } from "@farming-labs/docs";
+import { type SerializedOpenDocsProvider } from "@farming-labs/docs/server";
 interface RenderMarkdownOptions {
     theme?: DocsTheme;
+    icons?: Record<string, string>;
+    openDocsProviders?: SerializedOpenDocsProvider[];
 }
 /**
  * Render a markdown string to HTML with full syntax highlighting,
  * callouts, tables, tabs, and copy-to-clipboard support.
  *
- * Designed for server-side use in SvelteKit `+page.server` loaders.
+ * Designed for server-side use in SvelteKit page loaders.
  */
 export declare function renderMarkdown(content: string, options?: RenderMarkdownOptions): Promise<string>;
 export {};

package/dist/markdown.js

@@ -9,8 +9,9 @@
  *   - Tables, lists, inline formatting, headings with anchor IDs
  */
 import { resolveDocsAgentMdxContent } from "@farming-labs/docs";
+import { parsePromptStringArray, resolvePromptProviderChoices, sanitizePromptText, } from "@farming-labs/docs/server";
 import { createHighlighter } from "shiki";
-let highlighterPromise;
+let highlighterPromise = null;
 function getHighlighter() {
     if (!highlighterPromise) {
         highlighterPromise = createHighlighter({
@@ -51,6 +52,21 @@ const hoverLinkDefaults = {
     side: "bottom",
     sideOffset: 12,
 };
+const promptDefaults = {
+    actions: ["copy"],
+    copyLabel: "Copy prompt",
+    copiedLabel: "Copied",
+    openLabel: "Open in",
+    copyIcon: "copy",
+    copiedIcon: "check",
+    openIcon: "arrowUpRight",
+};
+const promptActionIcons = {
+    copy: '<svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><rect x="9" y="9" width="13" height="13" rx="2" ry="2" /><path d="M5 15H4a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h9a2 2 0 0 1 2 2v1" /></svg>',
+    check: '<svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><polyline points="20 6 9 17 4 12" /></svg>',
+    arrowUpRight: '<svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M18 13v6a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2V8a2 2 0 0 1 2-2h6" /><polyline points="15 3 21 3 21 9" /><line x1="10" y1="14" x2="21" y2="3" /></svg>',
+    chevronDown: '<svg width="12" height="12" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><polyline points="6 9 12 15 18 9" /></svg>',
+};
 function escapeHtml(value) {
     return value
         .replace(/&/g, "&amp;")
@@ -117,6 +133,21 @@ function resolveHoverLinkOptions(theme) {
     }
     return base;
 }
+function resolvePromptOptions(theme) {
+    const configured = theme?.ui?.components?.Prompt;
+    const base = { ...promptDefaults };
+    if (typeof configured === "function") {
+        const resolved = configured(base);
+        if (resolved && typeof resolved === "object") {
+            return { ...base, ...resolved };
+        }
+        return base;
+    }
+    if (configured && typeof configured === "object") {
+        return { ...base, ...configured };
+    }
+    return base;
+}
 function renderHoverLink(attrSource, children, theme) {
     const attrs = parseJsxAttributes(attrSource);
     const defaults = resolveHoverLinkOptions(theme);
@@ -164,6 +195,120 @@ function renderHoverLink(attrSource, children, theme) {
         `</span>` +
         `</span>`);
 }
+function resolvePromptIconName(value) {
+    if (value === false)
+        return false;
+    if (typeof value !== "string")
+        return undefined;
+    const trimmed = value.trim();
+    if (!trimmed)
+        return undefined;
+    if (trimmed === "false")
+        return false;
+    return trimmed;
+}
+function renderPromptIconHtml(name, iconRegistry) {
+    if (!name)
+        return "";
+    const registryMatch = iconRegistry?.[name];
+    if (registryMatch)
+        return registryMatch;
+    return promptActionIcons[name] ?? "";
+}
+function renderPrompt(attrSource, children, options) {
+    const attrs = parseJsxAttributes(attrSource);
+    const defaults = resolvePromptOptions(options.theme);
+    const title = toStringValue(attrs.title) ?? toStringValue(defaults.title);
+    const description = toStringValue(attrs.description) ?? toStringValue(defaults.description);
+    const iconName = toStringValue(attrs.icon) ?? toStringValue(defaults.icon);
+    const showTitle = attrs.showTitle !== undefined
+        ? toBoolean(attrs.showTitle, true)
+        : toBoolean(defaults.showTitle, true);
+    const showDescription = attrs.showDescription !== undefined
+        ? toBoolean(attrs.showDescription, true)
+        : toBoolean(defaults.showDescription, true);
+    const showPrompt = attrs.showPrompt !== undefined
+        ? toBoolean(attrs.showPrompt, false)
+        : toBoolean(defaults.showPrompt, false);
+    const actions = parsePromptStringArray(attrs.actions ?? defaults.actions) ?? ["copy"];
+    const providers = resolvePromptProviderChoices(options.openDocsProviders, parsePromptStringArray(attrs.providers ?? defaults.providers)) ?? [];
+    const copyLabel = toStringValue(attrs.copyLabel) ?? toStringValue(defaults.copyLabel) ?? promptDefaults.copyLabel;
+    const copiedLabel = toStringValue(attrs.copiedLabel) ??
+        toStringValue(defaults.copiedLabel) ??
+        promptDefaults.copiedLabel;
+    const openLabel = toStringValue(attrs.openLabel) ?? toStringValue(defaults.openLabel) ?? promptDefaults.openLabel;
+    const copyIcon = resolvePromptIconName(attrs.copyIcon ?? defaults.copyIcon);
+    const copiedIcon = resolvePromptIconName(attrs.copiedIcon ?? defaults.copiedIcon);
+    const openIcon = resolvePromptIconName(attrs.openIcon ?? defaults.openIcon);
+    const promptText = sanitizePromptText(dedentCode(children.trim()));
+    if (!promptText)
+        return "";
+    const cardIconHtml = iconName && options.icons?.[iconName] ? options.icons[iconName] : "";
+    const copyIconHtml = renderPromptIconHtml(copyIcon, options.icons);
+    const copiedIconHtml = renderPromptIconHtml(copiedIcon, options.icons);
+    const openIconHtml = renderPromptIconHtml(openIcon, options.icons);
+    const showCopy = actions.includes("copy");
+    const showOpen = actions.includes("open") && providers.length > 0;
+    const escapedPrompt = escapeHtml(promptText);
+    const singleProvider = showOpen && providers.length === 1 ? providers[0] : null;
+    let actionsHtml = "";
+    if (showCopy || showOpen) {
+        actionsHtml += '<div class="fd-prompt-actions">';
+        if (showCopy) {
+            actionsHtml +=
+                `<button type="button" class="fd-prompt-action-btn" data-prompt-copy>` +
+                    `<span class="fd-prompt-action-icon">${copyIconHtml}</span>` +
+                    `<span data-prompt-copy-label="${escapeHtml(copiedLabel)}" data-prompt-default-label="${escapeHtml(copyLabel)}">${escapeHtml(copyLabel)}</span>` +
+                    `<span class="fd-prompt-action-icon fd-prompt-action-icon-copied" hidden>${copiedIconHtml}</span>` +
+                    `</button>`;
+        }
+        if (singleProvider) {
+            actionsHtml +=
+                `<button type="button" class="fd-prompt-action-btn" data-prompt-open-direct data-url-template="${escapeHtml(singleProvider.urlTemplate)}">` +
+                    `<span class="fd-prompt-action-icon">${openIconHtml}</span>` +
+                    `<span>${escapeHtml(openLabel)} ${escapeHtml(singleProvider.name)}</span>` +
+                    `</button>`;
+        }
+        else if (showOpen) {
+            actionsHtml +=
+                `<div class="fd-prompt-dropdown" data-prompt-dropdown>` +
+                    `<button type="button" class="fd-prompt-action-btn" aria-expanded="false" data-prompt-trigger>` +
+                    `<span class="fd-prompt-action-icon">${openIconHtml}</span>` +
+                    `<span>${escapeHtml(openLabel)}</span>` +
+                    `<span class="fd-prompt-action-chevron">${promptActionIcons.chevronDown}</span>` +
+                    `</button>` +
+                    `<div class="fd-prompt-menu" role="menu" hidden data-prompt-menu>`;
+            for (const provider of providers) {
+                actionsHtml +=
+                    `<button type="button" role="menuitem" class="fd-prompt-menu-item" data-prompt-open-provider data-url-template="${escapeHtml(provider.urlTemplate)}">` +
+                        (provider.iconHtml
+                            ? `<span class="fd-prompt-menu-icon">${provider.iconHtml}</span>`
+                            : "") +
+                        `<span class="fd-prompt-menu-label">${escapeHtml(openLabel)} ${escapeHtml(provider.name)}</span>` +
+                        `</button>`;
+            }
+            actionsHtml += `</div></div>`;
+        }
+        actionsHtml += `</div>`;
+    }
+    return (`<div class="fd-prompt" data-prompt-card>` +
+        (cardIconHtml || (showTitle && title) || (showDescription && description)
+            ? `<div class="fd-prompt-header">` +
+                (cardIconHtml ? `<span class="fd-prompt-icon">${cardIconHtml}</span>` : "") +
+                `<div class="fd-prompt-copy">` +
+                (showTitle && title ? `<p class="fd-prompt-title">${escapeHtml(title)}</p>` : "") +
+                (showDescription && description
+                    ? `<p class="fd-prompt-description">${escapeHtml(description)}</p>`
+                    : "") +
+                `</div></div>`
+            : "") +
+        `<div data-prompt-text hidden aria-hidden="true">${escapedPrompt}</div>` +
+        (showPrompt
+            ? `<div class="fd-prompt-body"><pre class="fd-prompt-code">${escapedPrompt}</pre></div>`
+            : "") +
+        actionsHtml +
+        `</div>`);
+}
 const calloutIcons = {
     note: '<svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><circle cx="12" cy="12" r="10"/><line x1="12" y1="16" x2="12" y2="12"/><line x1="12" y1="8" x2="12.01" y2="8"/></svg>',
     warning: '<svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M10.29 3.86L1.82 18a2 2 0 001.71 3h16.94a2 2 0 001.71-3L13.71 3.86a2 2 0 00-3.42 0z"/><line x1="12" y1="9" x2="12" y2="13"/><line x1="12" y1="17" x2="12.01" y2="17"/></svg>',
@@ -237,7 +382,7 @@ function dedentCode(raw) {
  * Render a markdown string to HTML with full syntax highlighting,
  * callouts, tables, tabs, and copy-to-clipboard support.
  *
- * Designed for server-side use in SvelteKit `+page.server` loaders.
+ * Designed for server-side use in SvelteKit page loaders.
  */
 export async function renderMarkdown(content, options = {}) {
     if (!content)
@@ -294,6 +439,12 @@ export async function renderMarkdown(content, options = {}) {
         hoverLinkBlocks.push(renderHoverLink(attrSource, children, options.theme));
         return placeholder;
     });
+    const promptBlocks = [];
+    result = result.replace(/<Prompt(?:\s+([^>]*?))?>([\s\S]*?)<\/Prompt>/g, (_, attrSource, children) => {
+        const placeholder = `%%PROMPT_${promptBlocks.length}%%`;
+        promptBlocks.push(renderPrompt(attrSource ?? "", children, options));
+        return placeholder;
+    });
     // Inline code
     result = result.replace(/`([^`]+)`/g, "<code>$1</code>");
     // Headings (h4 → h1 order to avoid prefix collisions)
@@ -334,6 +485,8 @@ export async function renderMarkdown(content, options = {}) {
     result = result.replace(/\*\*\*(.+?)\*\*\*/g, "<strong><em>$1</em></strong>");
     result = result.replace(/\*\*(.+?)\*\*/g, "<strong>$1</strong>");
     result = result.replace(/\*(.+?)\*/g, "<em>$1</em>");
+    // Images — before links so ![alt](url) is not captured as a link
+    result = result.replace(/!\[([^\]]*)\]\(([^)]+)\)/g, (_, alt, src) => `<img src="${src}" alt="${alt.replace(/"/g, "&quot;")}" class="fd-docs-content-img" loading="lazy" decoding="async" />`);
     // Links
     result = result.replace(/\[([^\]]+)\]\(([^)]+)\)/g, '<a href="$2">$1</a>');
     // Horizontal rules
@@ -384,7 +537,7 @@ export async function renderMarkdown(content, options = {}) {
             return "";
         if (/^<(h[1-6]|pre|ul|ol|blockquote|hr|table|div)/.test(block))
             return block;
-        if (/^%%(CODEBLOCK|CALLOUT|TABS)_\d+%%$/.test(block))
+        if (/^%%(CODEBLOCK|CALLOUT|TABS|PROMPT|HOVERLINK)_\d+%%$/.test(block))
             return block;
         return `<p>${block}</p>`;
     })
@@ -402,5 +555,8 @@ export async function renderMarkdown(content, options = {}) {
     for (let i = 0; i < hoverLinkBlocks.length; i++) {
         result = result.replace(`%%HOVERLINK_${i}%%`, hoverLinkBlocks[i]);
     }
+    for (let i = 0; i < promptBlocks.length; i++) {
+        result = result.replace(`%%PROMPT_${i}%%`, promptBlocks[i]);
+    }
     return result;
 }

package/dist/server.js

@@ -31,7 +31,7 @@ import fs from "node:fs";
 import path from "node:path";
 import matter from "gray-matter";
 import { applySidebarFolderIndexBehavior, buildDocsAgentDiscoverySpec, findDocsMarkdownPage, isDocsAgentDiscoveryRequest, isDocsSkillRequest, normalizeDocsRelated, performDocsSearch, renderDocsMarkdownDocument, renderDocsSkillDocument, stripGeneratedAgentProvenance, resolveDocsAgentMdxContent, resolvePageSidebarFolderIndexBehavior, resolveSearchRequestConfig, resolveDocsI18n, resolveDocsLlmsTxtFormat, resolveDocsLocale, resolveDocsMarkdownRequest, resolveDocsPath, resolvePageReadingTime, resolveReadingTimeOptions, resolveDocsSkillFormat, } from "@farming-labs/docs";
-import { createDocsMcpHttpHandler, resolveDocsMcpConfig } from "@farming-labs/docs/server";
+import { createDocsMcpHttpHandler, resolveDocsMcpConfig, serializeDocsIconRegistry, serializeOpenDocsProviders, } from "@farming-labs/docs/server";
 import { loadDocsNavTree, loadDocsContent, flattenNavTree } from "./content.js";
 import { renderMarkdown } from "./markdown.js";
 export { createSvelteApiReference } from "./api-reference.js";
@@ -489,7 +489,13 @@ export function createDocsServer(config = {}) {
             enabledByDefault: readingTimeOptions.enabled,
             wordsPerMinute: readingTimeOptions.wordsPerMinute,
         });
-        const html = await renderMarkdown(humanRawContent, { theme: config.theme });
+        const html = await renderMarkdown(humanRawContent, {
+            theme: config.theme,
+            icons: serializeDocsIconRegistry(config.icons),
+            openDocsProviders: serializeOpenDocsProviders(config.pageActions?.openDocs && typeof config.pageActions.openDocs === "object"
+                ? config.pageActions.openDocs.providers
+                : undefined),
+        });
         const currentUrl = isIndex ? `/${entry}` : `/${entry}/${slug}`;
         const currentIndex = flatPages.findIndex((p) => p.url === currentUrl);
         const previousPage = currentIndex > 0 ? flatPages[currentIndex - 1] : null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@farming-labs/svelte",
-  "version": "0.1.58",
+  "version": "0.1.59",
   "description": "SvelteKit adapter for @farming-labs/docs — content loading and navigation utilities",
   "keywords": [
     "docs",
@@ -56,7 +56,7 @@
   "devDependencies": {
     "@types/node": "^22.10.0",
     "typescript": "^5.9.3",
-    "@farming-labs/docs": "0.1.58"
+    "@farming-labs/docs": "0.1.59"
   },
   "peerDependencies": {
     "@farming-labs/docs": "*"