@farming-labs/astro 0.0.38 → 0.0.43

package/dist/astro/src/markdown.js

@@ -0,0 +1,279 @@
+/**
+ * Server-side markdown rendering with Shiki syntax highlighting.
+ *
+ * Converts raw markdown content to HTML, supporting:
+ *   - Fenced code blocks with dual-theme syntax highlighting
+ *   - Copy-to-clipboard buttons on code blocks
+ *   - Tabbed code blocks (`<Tabs>` / `<Tab>` syntax)
+ *   - Callouts / admonitions (GitHub `[!NOTE]` and `**Note:**` styles)
+ *   - Tables, lists, inline formatting, headings with anchor IDs
+ */
+import { createHighlighter } from "shiki";
+let highlighterPromise = null;
+function getHighlighter() {
+    if (!highlighterPromise) {
+        highlighterPromise = createHighlighter({
+            themes: ["github-light", "github-dark"],
+            langs: [
+                "javascript",
+                "typescript",
+                "jsx",
+                "tsx",
+                "json",
+                "bash",
+                "shellscript",
+                "html",
+                "css",
+                "markdown",
+                "yaml",
+                "sql",
+                "python",
+                "dotenv",
+            ],
+        });
+    }
+    return highlighterPromise;
+}
+function slugify(text) {
+    return text
+        .toLowerCase()
+        .replace(/<[^>]+>/g, "")
+        .replace(/[^\w\s-]/g, "")
+        .replace(/\s+/g, "-")
+        .replace(/-+/g, "-")
+        .trim();
+}
+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>',
+    tip: '<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="M9 18h6"/><path d="M10 22h4"/><path d="M15.09 14c.18-.98.65-1.74 1.41-2.5A4.65 4.65 0 0018 8 6 6 0 006 8c0 1 .23 2.23 1.5 3.5A4.61 4.61 0 019 14"/></svg>',
+    important: '<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="M21 15a2 2 0 01-2 2H7l-4 4V5a2 2 0 012-2h14a2 2 0 012 2z"/></svg>',
+    caution: '<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="15" y1="9" x2="9" y2="15"/><line x1="9" y1="9" x2="15" y2="15"/></svg>',
+};
+function renderCallout(type, content) {
+    const icon = calloutIcons[type] || calloutIcons.note;
+    const label = type.charAt(0).toUpperCase() + type.slice(1);
+    return `<div class="fd-callout fd-callout-${type}" role="note"><div class="fd-callout-indicator" role="none"></div><div class="fd-callout-icon">${icon}</div><div class="fd-callout-content"><p class="fd-callout-title">${label}</p><p>${content}</p></div></div>`;
+}
+function highlightCode(hl, code, lang) {
+    if (lang === "sh" || lang === "shell")
+        lang = "bash";
+    if (lang === "env")
+        lang = "dotenv";
+    const supported = hl.getLoadedLanguages();
+    if (!supported.includes(lang))
+        lang = "text";
+    const trimmedCode = code.replace(/\n$/, "");
+    try {
+        return {
+            html: hl.codeToHtml(trimmedCode, {
+                lang,
+                themes: { light: "github-light", dark: "github-dark" },
+            }),
+            raw: trimmedCode,
+        };
+    }
+    catch {
+        const escaped = trimmedCode.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
+        return {
+            html: `<pre class="shiki"><code>${escaped}</code></pre>`,
+            raw: trimmedCode,
+        };
+    }
+}
+function parseMeta(meta) {
+    const lang = (meta.split(/\s/)[0] || "text").toLowerCase();
+    const titleMatch = meta.match(/title=["']([^"']+)["']/);
+    return { lang, title: titleMatch ? titleMatch[1] : null };
+}
+function wrapCodeWithCopy(html, rawCode, title, language) {
+    const escapedRaw = rawCode
+        .replace(/&/g, "&amp;")
+        .replace(/"/g, "&quot;")
+        .replace(/</g, "&lt;")
+        .replace(/>/g, "&gt;");
+    const dataLang = language ? ` data-language="${String(language).replace(/"/g, "&quot;")}"` : "";
+    const copyBtn = `<button class="fd-copy-btn" data-code="${escapedRaw}" title="Copy code"><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 01-2-2V4a2 2 0 012-2h9a2 2 0 012 2v1"/></svg></button>`;
+    if (title) {
+        return `<div class="fd-codeblock fd-codeblock--titled"${dataLang}><div class="fd-codeblock-title"><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="M15 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V7Z"/><path d="M14 2v4a2 2 0 0 0 2 2h4"/></svg><span class="fd-codeblock-title-text">${title}</span>${copyBtn}</div><div class="fd-codeblock-content">${html}</div></div>`;
+    }
+    return `<div class="fd-codeblock"${dataLang}>${copyBtn}<div class="fd-codeblock-content">${html}</div></div>`;
+}
+function dedentCode(raw) {
+    const lines = raw.replace(/\n$/, "").split("\n");
+    const indent = lines.reduce((min, l) => {
+        if (!l.trim())
+            return min;
+        const spaces = l.match(/^(\s*)/)?.[1].length ?? 0;
+        return Math.min(min, spaces);
+    }, Infinity);
+    if (indent > 0 && indent < Infinity) {
+        return lines.map((l) => l.slice(indent)).join("\n");
+    }
+    return 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 Astro page loaders.
+ */
+export async function renderMarkdown(content) {
+    if (!content)
+        return "";
+    const hl = await getHighlighter();
+    let result = content;
+    // ── Tabs blocks: <Tabs items={[...]}> ... </Tabs> ──
+    const tabsBlocks = [];
+    result = result.replace(/<Tabs\s+items=\{?\[([^\]]+)\]\}?>([\s\S]*?)<\/Tabs>/g, (_, itemsStr, body) => {
+        const items = itemsStr.split(",").map((s) => s.trim().replace(/^["']|["']$/g, ""));
+        const panels = [];
+        const tabRegex = /<Tab\s+value=["']([^"']+)["']>([\s\S]*?)<\/Tab>/g;
+        let tabMatch;
+        while ((tabMatch = tabRegex.exec(body)) !== null) {
+            const tabValue = tabMatch[1];
+            const tabContent = tabMatch[2].trim();
+            const codeMatch = tabContent.match(/```([^\n]*)\n([\s\S]*?)```/);
+            if (codeMatch) {
+                const { lang, title } = parseMeta(codeMatch[1]);
+                const dedented = dedentCode(codeMatch[2]);
+                const { html, raw } = highlightCode(hl, dedented, lang);
+                panels.push({ value: tabValue, html: wrapCodeWithCopy(html, raw, title, lang) });
+            }
+            else {
+                panels.push({ value: tabValue, html: `<p>${tabContent}</p>` });
+            }
+        }
+        let tabsHtml = `<div class="fd-tabs" data-tabs>`;
+        tabsHtml += `<div class="fd-tabs-list" role="tablist">`;
+        for (let i = 0; i < items.length; i++) {
+            tabsHtml += `<button role="tab" class="fd-tab-trigger${i === 0 ? " fd-tab-active" : ""}" data-tab-value="${items[i]}" aria-selected="${i === 0}">${items[i]}</button>`;
+        }
+        tabsHtml += `</div>`;
+        for (let i = 0; i < panels.length; i++) {
+            tabsHtml += `<div class="fd-tab-panel${i === 0 ? " fd-tab-panel-active" : ""}" data-tab-panel="${panels[i].value}" role="tabpanel">${panels[i].html}</div>`;
+        }
+        tabsHtml += `</div>`;
+        const placeholder = `%%TABS_${tabsBlocks.length}%%`;
+        tabsBlocks.push(tabsHtml);
+        return placeholder;
+    });
+    // ── Fenced code blocks ──
+    const codeBlocks = [];
+    result = result.replace(/```([^\n]*)\n([\s\S]*?)```/g, (_, meta, code) => {
+        const { lang, title } = parseMeta(meta);
+        const { html, raw } = highlightCode(hl, code, lang);
+        const placeholder = `%%CODEBLOCK_${codeBlocks.length}%%`;
+        codeBlocks.push(wrapCodeWithCopy(html, raw, title, lang));
+        return placeholder;
+    });
+    // Inline code
+    result = result.replace(/`([^`]+)`/g, "<code>$1</code>");
+    // Headings (h4 → h1 order to avoid prefix collisions)
+    result = result.replace(/^#### (.+)$/gm, (_, text) => {
+        return `<h4 id="${slugify(text)}">${text}</h4>`;
+    });
+    result = result.replace(/^### (.+)$/gm, (_, text) => {
+        return `<h3 id="${slugify(text)}">${text}</h3>`;
+    });
+    result = result.replace(/^## (.+)$/gm, (_, text) => {
+        return `<h2 id="${slugify(text)}">${text}</h2>`;
+    });
+    result = result.replace(/^# (.+)$/gm, "<h1>$1</h1>");
+    // ── Callouts / blockquotes (before inline formatting) ──
+    const calloutBlocks = [];
+    result = result.replace(/(?:^>\s*.+\n?)+/gm, (block) => {
+        const lines = block.split("\n").filter(Boolean);
+        const inner = lines.map((l) => l.replace(/^>\s?/, "")).join("\n");
+        const ghMatch = inner.match(/^\[!(NOTE|WARNING|TIP|IMPORTANT|CAUTION)\]\s*\n?([\s\S]*)/i);
+        if (ghMatch) {
+            const type = ghMatch[1].toLowerCase();
+            const calloutContent = ghMatch[2].trim();
+            const placeholder = `%%CALLOUT_${calloutBlocks.length}%%`;
+            calloutBlocks.push(renderCallout(type, calloutContent));
+            return placeholder;
+        }
+        const boldMatch = inner.match(/^\*\*(Note|Warning|Tip|Important|Caution):\*\*\s*([\s\S]*)/i);
+        if (boldMatch) {
+            const type = boldMatch[1].toLowerCase();
+            const calloutContent = boldMatch[2].trim();
+            const placeholder = `%%CALLOUT_${calloutBlocks.length}%%`;
+            calloutBlocks.push(renderCallout(type, calloutContent));
+            return placeholder;
+        }
+        return `<blockquote><p>${inner}</p></blockquote>`;
+    });
+    // Inline formatting
+    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
+    result = result.replace(/^---$/gm, "<hr />");
+    // Tables
+    result = result.replace(/^\|(.+)\|\n\|[-| ]+\|\n((?:\|.+\|\n?)+)/gm, (_, headerRow, bodyRows) => {
+        const headers = headerRow
+            .split("|")
+            .map((h) => h.trim())
+            .filter(Boolean);
+        const rows = bodyRows
+            .trim()
+            .split("\n")
+            .map((row) => row
+            .split("|")
+            .map((c) => c.trim())
+            .filter(Boolean));
+        const headerHtml = headers.map((h) => `<th>${h}</th>`).join("");
+        const rowsHtml = rows
+            .map((row) => `<tr>${row.map((c) => `<td>${c}</td>`).join("")}</tr>`)
+            .join("");
+        return `<div class="fd-table-wrapper"><table><thead><tr>${headerHtml}</tr></thead><tbody>${rowsHtml}</tbody></table></div>`;
+    });
+    // Unordered lists
+    result = result.replace(/(?:^- .+\n?)+/gm, (block) => {
+        const items = block
+            .split("\n")
+            .filter((l) => l.startsWith("- "))
+            .map((l) => `<li>${l.slice(2)}</li>`)
+            .join("");
+        return `<ul>${items}</ul>`;
+    });
+    // Ordered lists
+    result = result.replace(/(?:^\d+\. .+\n?)+/gm, (block) => {
+        const items = block
+            .split("\n")
+            .filter((l) => /^\d+\. /.test(l))
+            .map((l) => `<li>${l.replace(/^\d+\. /, "")}</li>`)
+            .join("");
+        return `<ol>${items}</ol>`;
+    });
+    // Wrap remaining bare text in <p> tags
+    result = result
+        .split("\n\n")
+        .map((block) => {
+        block = block.trim();
+        if (!block)
+            return "";
+        if (/^<(h[1-6]|pre|ul|ol|blockquote|hr|table|div)/.test(block))
+            return block;
+        if (/^%%(CODEBLOCK|CALLOUT|TABS)_\d+%%$/.test(block))
+            return block;
+        return `<p>${block}</p>`;
+    })
+        .join("\n");
+    // Restore placeholders
+    for (let i = 0; i < codeBlocks.length; i++) {
+        result = result.replace(`%%CODEBLOCK_${i}%%`, codeBlocks[i]);
+    }
+    for (let i = 0; i < calloutBlocks.length; i++) {
+        result = result.replace(`%%CALLOUT_${i}%%`, calloutBlocks[i]);
+    }
+    for (let i = 0; i < tabsBlocks.length; i++) {
+        result = result.replace(`%%TABS_${i}%%`, tabsBlocks[i]);
+    }
+    return result;
+}
+//# sourceMappingURL=markdown.js.map

package/dist/astro/src/markdown.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.js","sourceRoot":"","sources":["../../../src/markdown.ts"],"names":[],"mappings":"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"}

package/dist/astro/src/server.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Server-side helpers for Astro docs routes.
+ *
+ * `createDocsServer(config)` returns all the functions needed for
+ * a complete docs site: `load` for getting page data, `GET` for search,
+ * and `POST` for AI chat.
+ *
+ * @example
+ * ```ts
+ * // src/lib/docs.server.ts
+ * import { createDocsServer } from "@farming-labs/astro/server";
+ * import config from "./docs.config";
+ *
+ * const contentFiles = import.meta.glob("/docs/**\/*.{md,mdx}", {
+ *   query: "?raw", import: "default", eager: true,
+ * }) as Record<string, string>;
+ *
+ * export const { load, GET, POST } = createDocsServer({
+ *   ...config,
+ *   _preloadedContent: contentFiles,
+ * });
+ * ```
+ *
+ * ```ts
+ * // src/pages/docs/[...slug].astro
+ * import { load } from "../../lib/docs.server";
+ * const data = await load(Astro.url.pathname);
+ * ```
+ */
+import { loadDocsNavTree } from "./content.js";
+import type { PageNode } from "./content.js";
+export { createAstroApiReference } from "./api-reference.js";
+export interface DocsServer {
+    load: (pathname: string) => Promise<{
+        tree: ReturnType<typeof loadDocsNavTree>;
+        flatPages: PageNode[];
+        title: string;
+        description?: string;
+        html: string;
+        rawMarkdown?: string;
+        entry?: string;
+        locale?: string;
+        slug?: string;
+        previousPage: PageNode | null;
+        nextPage: PageNode | null;
+        editOnGithub?: string;
+        lastModified: string;
+    }>;
+    GET: (context: {
+        request: Request;
+    }) => Response;
+    POST: (context: {
+        request: Request;
+    }) => Promise<Response>;
+}
+/**
+ * Create all server-side functions needed for an Astro docs site.
+ *
+ * @param config - The `DocsConfig` object (from `defineDocs()` in `docs.config.ts`).
+ *
+ * Pass `_preloadedContent` (from `import.meta.glob`) to bundle markdown files
+ * at build time — required for serverless deployments (Vercel, Netlify, etc.)
+ * where the filesystem is not available at runtime.
+ */
+export declare function createDocsServer(config?: Record<string, any>): DocsServer;
+//# sourceMappingURL=server.d.ts.map

package/dist/astro/src/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../../src/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAMH,OAAO,EAAE,eAAe,EAAmC,MAAM,cAAc,CAAC;AAEhF,OAAO,KAAK,EAAE,QAAQ,EAAiC,MAAM,cAAc,CAAC;AAC5E,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAkE7D,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC;QAClC,IAAI,EAAE,UAAU,CAAC,OAAO,eAAe,CAAC,CAAC;QACzC,SAAS,EAAE,QAAQ,EAAE,CAAC;QACtB,KAAK,EAAE,MAAM,CAAC;QACd,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,YAAY,EAAE,QAAQ,GAAG,IAAI,CAAC;QAC9B,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAC;QAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC,CAAC;IACH,GAAG,EAAE,CAAC,OAAO,EAAE;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,KAAK,QAAQ,CAAC;IACjD,IAAI,EAAE,CAAC,OAAO,EAAE;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;CAC5D;AA8QD;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM,GAAG,UAAU,CAuc7E"}