@farming-labs/svelte 0.0.50 → 0.0.51

package/dist/markdown.d.ts

@@ -8,10 +8,15 @@
  *   - Callouts / admonitions (GitHub `[!NOTE]` and `**Note:**` styles)
  *   - Tables, lists, inline formatting, headings with anchor IDs
  */
+import type { DocsTheme } from "@farming-labs/docs";
+interface RenderMarkdownOptions {
+    theme?: DocsTheme;
+}
 /**
  * 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.
  */
-export declare function renderMarkdown(content: string): Promise<string>;
+export declare function renderMarkdown(content: string, options?: RenderMarkdownOptions): Promise<string>;
+export {};

package/dist/markdown.js

@@ -43,6 +43,126 @@ function slugify(text) {
         .replace(/-+/g, "-")
         .trim();
 }
+const hoverLinkDefaults = {
+    linkLabel: "Open page",
+    showIndicator: false,
+    align: "center",
+    side: "bottom",
+    sideOffset: 12,
+};
+function escapeHtml(value) {
+    return value
+        .replace(/&/g, "&")
+        .replace(/</g, "&lt;")
+        .replace(/>/g, "&gt;")
+        .replace(/"/g, "&quot;");
+}
+function parseJsxAttributes(source) {
+    const attrs = {};
+    const pattern = /([A-Za-z_:][-.\w:]*)(?:=(?:"([^"]*)"|'([^']*)'|\{([^}]*)\}))?/g;
+    let match;
+    while ((match = pattern.exec(source)) !== null) {
+        const [, name, doubleQuoted, singleQuoted, braced] = match;
+        const rawValue = doubleQuoted ?? singleQuoted ?? braced;
+        attrs[name] = rawValue === undefined ? true : rawValue.trim();
+    }
+    return attrs;
+}
+function toBoolean(value, fallback) {
+    if (typeof value === "boolean")
+        return value;
+    if (typeof value === "string") {
+        if (value === "true")
+            return true;
+        if (value === "false")
+            return false;
+        return fallback;
+    }
+    return fallback;
+}
+function toStringValue(value) {
+    return typeof value === "string" ? value : undefined;
+}
+function toNumberValue(value) {
+    if (typeof value === "number")
+        return Number.isFinite(value) ? value : undefined;
+    if (typeof value !== "string")
+        return undefined;
+    const parsed = Number(value);
+    return Number.isFinite(parsed) ? parsed : undefined;
+}
+function normalizeHoverAlign(value) {
+    if (value === "start" || value === "end")
+        return value;
+    return "center";
+}
+function normalizeHoverSide(value) {
+    if (value === "top" || value === "right" || value === "left")
+        return value;
+    return "bottom";
+}
+function resolveHoverLinkOptions(theme) {
+    const configured = theme?.ui?.components?.HoverLink;
+    const base = { ...hoverLinkDefaults };
+    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);
+    const href = toStringValue(attrs.href);
+    const title = toStringValue(attrs.title);
+    const description = toStringValue(attrs.description);
+    if (!href || !title || !description)
+        return children;
+    const linkLabel = toStringValue(attrs.linkLabel) ??
+        toStringValue(defaults.linkLabel) ??
+        hoverLinkDefaults.linkLabel;
+    const previewLabel = toStringValue(attrs.previewLabel) ?? toStringValue(defaults.previewLabel);
+    const showIndicator = attrs.showIndicator !== undefined
+        ? toBoolean(attrs.showIndicator, hoverLinkDefaults.showIndicator)
+        : toBoolean(defaults.showIndicator, hoverLinkDefaults.showIndicator);
+    const external = attrs.external !== undefined
+        ? toBoolean(attrs.external, false)
+        : toBoolean(defaults.external, false);
+    const align = normalizeHoverAlign(toStringValue(attrs.align) ?? toStringValue(defaults.align));
+    const side = normalizeHoverSide(toStringValue(attrs.side) ?? toStringValue(defaults.side));
+    const sideOffset = toNumberValue(attrs.sideOffset) ??
+        toNumberValue(defaults.sideOffset) ??
+        hoverLinkDefaults.sideOffset;
+    const targetAttrs = external ? ' target="_blank" rel="noopener noreferrer"' : "";
+    const triggerHtml = escapeHtml(children.trim()) || escapeHtml(title);
+    const indicatorHtml = showIndicator
+        ? '<span class="fd-hover-link-indicator" aria-hidden="true">+</span>'
+        : "";
+    const previewHtml = previewLabel
+        ? `<span class="fd-hover-link-preview-label">${escapeHtml(previewLabel)}</span>`
+        : "";
+    return (`<span class="fd-hover-link" data-hover-link data-align="${align}" data-side="${side}" style="--fd-hover-link-side-offset:${sideOffset}px">` +
+        `<button type="button" class="fd-hover-link-trigger" aria-haspopup="dialog" aria-expanded="false">${triggerHtml}${indicatorHtml}</button>` +
+        `<span class="fd-hover-link-popover" role="dialog" aria-hidden="true">` +
+        `<span class="fd-hover-link-card">` +
+        `<span class="fd-hover-link-body">` +
+        previewHtml +
+        `<a href="${escapeHtml(href)}" class="fd-hover-link-title"${targetAttrs}>${escapeHtml(title)}</a>` +
+        `<span class="fd-hover-link-description">${escapeHtml(description)}</span>` +
+        `</span>` +
+        `<span class="fd-hover-link-footer">` +
+        `<a href="${escapeHtml(href)}" class="fd-hover-link-cta"${targetAttrs}>${escapeHtml(linkLabel)}<span aria-hidden="true">→</span></a>` +
+        `</span>` +
+        `</span>` +
+        `</span>` +
+        `</span>`);
+}
 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>',
@@ -118,7 +238,7 @@ function dedentCode(raw) {
  *
  * Designed for server-side use in SvelteKit `+page.server` loaders.
  */
-export async function renderMarkdown(content) {
+export async function renderMarkdown(content, options = {}) {
     if (!content)
         return "";
     const hl = await getHighlighter();
@@ -167,6 +287,12 @@ export async function renderMarkdown(content) {
         codeBlocks.push(wrapCodeWithCopy(html, raw, title, lang));
         return placeholder;
     });
+    const hoverLinkBlocks = [];
+    result = result.replace(/<HoverLink\s+([^>]*?)>([\s\S]*?)<\/HoverLink>/g, (_, attrSource, children) => {
+        const placeholder = `%%HOVERLINK_${hoverLinkBlocks.length}%%`;
+        hoverLinkBlocks.push(renderHoverLink(attrSource, children, options.theme));
+        return placeholder;
+    });
     // Inline code
     result = result.replace(/`([^`]+)`/g, "<code>$1</code>");
     // Headings (h4 → h1 order to avoid prefix collisions)
@@ -272,5 +398,8 @@ export async function renderMarkdown(content) {
     for (let i = 0; i < tabsBlocks.length; i++) {
         result = result.replace(`%%TABS_${i}%%`, tabsBlocks[i]);
     }
+    for (let i = 0; i < hoverLinkBlocks.length; i++) {
+        result = result.replace(`%%HOVERLINK_${i}%%`, hoverLinkBlocks[i]);
+    }
     return result;
 }

package/dist/server.js

@@ -431,7 +431,7 @@ export function createDocsServer(config = {}) {
             });
         }
         const { data, content } = matter(raw);
-        const html = await renderMarkdown(content);
+        const html = await renderMarkdown(content, { theme: config.theme });
         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.0.50",
+  "version": "0.0.51",
   "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.0.50"
+    "@farming-labs/docs": "0.0.51"
   },
   "peerDependencies": {
     "@farming-labs/docs": "*"