@farming-labs/svelte 0.1.36 → 0.1.38

package/dist/content.d.ts

@@ -5,7 +5,7 @@
  * extracts frontmatter, and builds a navigation tree compatible
  * with @farming-labs/docs DocsConfig.
  */
-import type { OrderingItem } from "@farming-labs/docs";
+import { type OrderingItem, type ResolvedDocsRelatedLink } from "@farming-labs/docs";
 export interface PageNode {
     type: "page";
     name: string;
@@ -30,11 +30,14 @@ export interface ContentPage {
     url: string;
     title: string;
     description?: string;
+    related?: ResolvedDocsRelatedLink[];
     icon?: string;
     content: string;
     rawContent: string;
     agentContent?: string;
     agentRawContent?: string;
+    agentFallbackContent?: string;
+    agentFallbackRawContent?: string;
 }
 /**
  * Scan a content directory and return all docs pages.

package/dist/content.js

@@ -8,6 +8,7 @@
 import fs from "node:fs";
 import path from "node:path";
 import matter from "gray-matter";
+import { normalizeDocsRelated, resolveDocsAgentMdxContent, } from "@farming-labs/docs";
 /**
  * Scan a content directory and return all docs pages.
  * Expects a flat or nested structure of `.md` files:
@@ -35,6 +36,9 @@ export function loadDocsContent(contentDir, entry = "docs") {
                 continue;
             const raw = fs.readFileSync(full, "utf-8");
             const { data, content } = matter(raw);
+            const humanRawContent = resolveDocsAgentMdxContent(content, "human");
+            const pageAgentRawContent = resolveDocsAgentMdxContent(content, "agent");
+            const related = normalizeDocsRelated(data.related);
             const baseName = name.replace(/\.(md|mdx|svx)$/, "");
             const isIndex = baseName === "index" || baseName === "page" || baseName === "+page";
             const slug = isIndex ? slugParts.join("/") : [...slugParts, baseName].join("/");
@@ -47,9 +51,16 @@ export function loadDocsContent(contentDir, entry = "docs") {
                 url,
                 title,
                 description: data.description,
+                ...(related.length > 0 ? { related } : {}),
                 icon: data.icon,
-                content: stripMarkdown(content),
-                rawContent: content,
+                content: stripMarkdown(humanRawContent),
+                rawContent: humanRawContent,
+                ...(pageAgentRawContent !== humanRawContent
+                    ? {
+                        agentFallbackContent: stripMarkdown(pageAgentRawContent),
+                        agentFallbackRawContent: pageAgentRawContent,
+                    }
+                    : {}),
                 ...agentDoc,
             });
         }

package/dist/markdown.d.ts

@@ -8,7 +8,7 @@
  *   - Callouts / admonitions (GitHub `[!NOTE]` and `**Note:**` styles)
  *   - Tables, lists, inline formatting, headings with anchor IDs
  */
-import type { DocsTheme } from "@farming-labs/docs";
+import { type DocsTheme } from "@farming-labs/docs";
 interface RenderMarkdownOptions {
     theme?: DocsTheme;
 }

package/dist/markdown.js

@@ -8,6 +8,7 @@
  *   - Callouts / admonitions (GitHub `[!NOTE]` and `**Note:**` styles)
  *   - Tables, lists, inline formatting, headings with anchor IDs
  */
+import { resolveDocsAgentMdxContent } from "@farming-labs/docs";
 import { createHighlighter } from "shiki";
 let highlighterPromise;
 function getHighlighter() {
@@ -242,7 +243,7 @@ export async function renderMarkdown(content, options = {}) {
     if (!content)
         return "";
     const hl = await getHighlighter();
-    let result = content;
+    let result = resolveDocsAgentMdxContent(content, "human");
     // ── Tabs blocks: <Tabs items={[...]}> ... </Tabs> ──
     const tabsBlocks = [];
     result = result.replace(/<Tabs\s+items=\{?\[([^\]]+)\]\}?>([\s\S]*?)<\/Tabs>/g, (_, itemsStr, body) => {

package/dist/server.js

@@ -30,8 +30,8 @@
 import fs from "node:fs";
 import path from "node:path";
 import matter from "gray-matter";
-import { performDocsSearch, resolveSearchRequestConfig, resolveDocsI18n, resolveDocsLocale, resolveDocsPath, } from "@farming-labs/docs";
-import { createDocsMcpHttpHandler } from "@farming-labs/docs/server";
+import { buildDocsAgentDiscoverySpec, findDocsMarkdownPage, isDocsAgentDiscoveryRequest, normalizeDocsRelated, performDocsSearch, renderDocsMarkdownDocument, resolveDocsAgentMdxContent, resolveSearchRequestConfig, resolveDocsI18n, resolveDocsLlmsTxtFormat, resolveDocsLocale, resolveDocsMarkdownRequest, resolveDocsPath, } from "@farming-labs/docs";
+import { createDocsMcpHttpHandler, resolveDocsMcpConfig } from "@farming-labs/docs/server";
 import { loadDocsNavTree, loadDocsContent, flattenNavTree } from "./content.js";
 import { renderMarkdown } from "./markdown.js";
 export { createSvelteApiReference } from "./api-reference.js";
@@ -252,6 +252,9 @@ function searchIndexFromMap(contentMap, dirPrefix, entry) {
         const slug = isIdx ? segments.join("/") : [...segments, base].join("/");
         const url = slug ? `/${entry}/${slug}` : `/${entry}`;
         const { data, content } = matter(raw);
+        const humanRawContent = resolveDocsAgentMdxContent(content, "human");
+        const pageAgentRawContent = resolveDocsAgentMdxContent(content, "agent");
+        const related = normalizeDocsRelated(data.related);
         const agentDoc = isIdx ? readAgentDocFromMap(contentMap, dirPrefix, slug) : undefined;
         const title = data.title ?? base.replace(/-/g, " ").replace(/\b\w/g, (c) => c.toUpperCase());
         pages.push({
@@ -259,9 +262,16 @@ function searchIndexFromMap(contentMap, dirPrefix, entry) {
             url,
             title,
             description: data.description,
+            ...(related.length > 0 ? { related } : {}),
             icon: data.icon,
-            content: stripMarkdownText(content),
-            rawContent: content,
+            content: stripMarkdownText(humanRawContent),
+            rawContent: humanRawContent,
+            ...(pageAgentRawContent !== humanRawContent
+                ? {
+                    agentFallbackContent: stripMarkdownText(pageAgentRawContent),
+                    agentFallbackRawContent: pageAgentRawContent,
+                }
+                : {}),
             ...agentDoc,
         });
     }
@@ -447,7 +457,8 @@ export function createDocsServer(config = {}) {
             });
         }
         const { data, content } = matter(raw);
-        const html = await renderMarkdown(content, { theme: config.theme });
+        const humanRawContent = resolveDocsAgentMdxContent(content, "human");
+        const html = await renderMarkdown(humanRawContent, { 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;
@@ -512,6 +523,11 @@ export function createDocsServer(config = {}) {
     const llmsBaseUrl = typeof llmsTxtConfig === "object" ? (llmsTxtConfig.baseUrl ?? "") : "";
     const llmsTitle = typeof llmsTxtConfig === "object" ? (llmsTxtConfig.siteTitle ?? llmsSiteTitle) : llmsSiteTitle;
     const llmsDesc = typeof llmsTxtConfig === "object" ? llmsTxtConfig.siteDescription : undefined;
+    const llmsEnabled = llmsTxtConfig !== false &&
+        !(llmsTxtConfig && typeof llmsTxtConfig === "object" && llmsTxtConfig.enabled === false);
+    const mcpConfig = resolveDocsMcpConfig(config.mcp, {
+        defaultName: llmsTitle,
+    });
     const llmsCache = new Map();
     function getLlmsContent(ctx) {
         const key = ctx.locale ?? "__default__";
@@ -548,13 +564,70 @@ export function createDocsServer(config = {}) {
             return locale;
         return i18n.defaultLocale;
     }
+    function getMarkdownDocument(ctx, requestedPath) {
+        const page = findDocsMarkdownPage(entry, getSearchIndex(ctx), requestedPath);
+        return page ? renderDocsMarkdownDocument(page) : null;
+    }
     // ─── GET /api/docs?query=… | ?format=llms | ?format=llms-full ──
     async function GET(event) {
         const ctx = resolveContextFromRequest(event.request);
-        const format = event.url.searchParams.get("format");
-        if (format === "llms" || format === "llms-full") {
+        if (isDocsAgentDiscoveryRequest(event.url)) {
+            return new Response(JSON.stringify(buildDocsAgentDiscoverySpec({
+                origin: event.url.origin,
+                entry,
+                i18n,
+                search: config.search,
+                mcp: mcpConfig,
+                llms: {
+                    enabled: llmsEnabled,
+                    baseUrl: llmsBaseUrl || undefined,
+                    siteTitle: llmsTitle,
+                    siteDescription: llmsDesc,
+                },
+                markdown: {
+                    acceptHeader: false,
+                },
+            }), null, 2), {
+                headers: {
+                    "Content-Type": "application/json; charset=utf-8",
+                    "Cache-Control": "public, max-age=0, s-maxage=3600",
+                    "X-Robots-Tag": "noindex",
+                },
+            });
+        }
+        const markdownRequest = resolveDocsMarkdownRequest(entry, event.url, event.request);
+        if (markdownRequest) {
+            const document = getMarkdownDocument(ctx, markdownRequest.requestedPath);
+            if (!document) {
+                return new Response("Not Found", {
+                    status: 404,
+                    headers: {
+                        "Content-Type": "text/plain; charset=utf-8",
+                        "X-Robots-Tag": "noindex",
+                    },
+                });
+            }
+            return new Response(document, {
+                headers: {
+                    "Content-Type": "text/markdown; charset=utf-8",
+                    "Cache-Control": "public, max-age=0, s-maxage=3600",
+                    "X-Robots-Tag": "noindex",
+                },
+            });
+        }
+        const llmsFormat = resolveDocsLlmsTxtFormat(event.url);
+        if (llmsFormat === "llms" || llmsFormat === "llms-full") {
+            if (!llmsEnabled) {
+                return new Response("Not Found", {
+                    status: 404,
+                    headers: {
+                        "Content-Type": "text/plain; charset=utf-8",
+                        "X-Robots-Tag": "noindex",
+                    },
+                });
+            }
             const llmsContent = getLlmsContent(ctx);
-            return new Response(format === "llms-full" ? llmsContent.llmsFullTxt : llmsContent.llmsTxt, {
+            return new Response(llmsFormat === "llms-full" ? llmsContent.llmsFullTxt : llmsContent.llmsTxt, {
                 headers: {
                     "Content-Type": "text/plain; charset=utf-8",
                     "Cache-Control": "public, max-age=3600",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@farming-labs/svelte",
-  "version": "0.1.36",
+  "version": "0.1.38",
   "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.36"
+    "@farming-labs/docs": "0.1.38"
   },
   "peerDependencies": {
     "@farming-labs/docs": "*"