@farming-labs/svelte 0.0.2-beta.21 → 0.0.2-beta.23

package/dist/content.js

@@ -35,9 +35,7 @@ export function loadDocsContent(contentDir, entry = "docs") {
             const { data, content } = matter(raw);
             const baseName = name.replace(/\.(md|mdx|svx)$/, "");
             const isIndex = baseName === "index" || baseName === "page" || baseName === "+page";
-            const slug = isIndex
-                ? slugParts.join("/")
-                : [...slugParts, baseName].join("/");
+            const slug = isIndex ? slugParts.join("/") : [...slugParts, baseName].join("/");
             const url = slug ? `/${entry}/${slug}` : `/${entry}`;
             const title = data.title ??
                 baseName.replace(/-/g, " ").replace(/\b\w/g, (c) => c.toUpperCase());

package/dist/index.d.ts

@@ -5,7 +5,7 @@
  * Provides content loading, navigation tree building, search,
  * and server-side markdown rendering for SvelteKit-based documentation sites.
  */
-export { loadDocsContent, loadDocsNavTree, flattenNavTree, type NavNode, type NavTree, type PageNode, type FolderNode } from "./content.js";
+export { loadDocsContent, loadDocsNavTree, flattenNavTree, type NavNode, type NavTree, type PageNode, type FolderNode, } from "./content.js";
 export { createMdsvexConfig } from "./config.js";
 export { renderMarkdown } from "./markdown.js";
 export { createDocsServer, type DocsServer } from "./server.js";

package/dist/index.js

@@ -5,7 +5,7 @@
  * Provides content loading, navigation tree building, search,
  * and server-side markdown rendering for SvelteKit-based documentation sites.
  */
-export { loadDocsContent, loadDocsNavTree, flattenNavTree } from "./content.js";
+export { loadDocsContent, loadDocsNavTree, flattenNavTree, } from "./content.js";
 export { createMdsvexConfig } from "./config.js";
 export { renderMarkdown } from "./markdown.js";
 export { createDocsServer } from "./server.js";

package/dist/markdown.js

@@ -74,10 +74,7 @@ function highlightCode(hl, code, lang) {
         };
     }
     catch {
-        const escaped = trimmedCode
-            .replace(/&/g, "&")
-            .replace(/</g, "&lt;")
-            .replace(/>/g, "&gt;");
+        const escaped = trimmedCode.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
         return {
             html: `<pre class="shiki"><code>${escaped}</code></pre>`,
             raw: trimmedCode,
@@ -128,9 +125,7 @@ export async function renderMarkdown(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 items = itemsStr.split(",").map((s) => s.trim().replace(/^["']|["']$/g, ""));
         const panels = [];
         const tabRegex = /<Tab\s+value=["']([^"']+)["']>([\s\S]*?)<\/Tab>/g;
         let tabMatch;

package/dist/server.js

@@ -65,9 +65,7 @@ function navTreeFromMap(contentMap, dirPrefix, entry, ordering) {
         const slug = dirParts.join("/");
         const url = slug ? `/${entry}/${slug}` : `/${entry}`;
         const fallbackTitle = dirParts.length > 0
-            ? dirParts[dirParts.length - 1]
-                .replace(/-/g, " ")
-                .replace(/\b\w/g, (c) => c.toUpperCase())
+            ? dirParts[dirParts.length - 1].replace(/-/g, " ").replace(/\b\w/g, (c) => c.toUpperCase())
             : "Documentation";
         dirs.push({
             parts: dirParts,
@@ -206,8 +204,7 @@ 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 title = data.title ??
-            base.replace(/-/g, " ").replace(/\b\w/g, (c) => c.toUpperCase());
+        const title = data.title ?? base.replace(/-/g, " ").replace(/\b\w/g, (c) => c.toUpperCase());
         pages.push({
             slug,
             url,
@@ -252,9 +249,7 @@ function findPageInMap(contentMap, dirPrefix, slug) {
 export function createDocsServer(config = {}) {
     const entry = config.entry ?? "docs";
     const githubRaw = config.github;
-    const github = typeof githubRaw === "string"
-        ? { url: githubRaw }
-        : githubRaw ?? null;
+    const github = typeof githubRaw === "string" ? { url: githubRaw } : (githubRaw ?? null);
     const githubRepo = github?.url;
     const githubBranch = github?.branch ?? "main";
     const githubContentPath = github?.directory;
@@ -350,7 +345,7 @@ export function createDocsServer(config = {}) {
         }
         const fallbackTitle = isIndex
             ? "Documentation"
-            : slug.split("/").pop()?.replace(/-/g, " ") ?? "Documentation";
+            : (slug.split("/").pop()?.replace(/-/g, " ") ?? "Documentation");
         return {
             tree,
             flatPages,
@@ -388,8 +383,51 @@ export function createDocsServer(config = {}) {
             .filter((r) => r.score > 0)
             .sort((a, b) => b.score - a.score);
     }
-    // ─── GET /api/docs?query=… — full-text search ────────────
+    // ─── llms.txt content builder ────────────────────────────────
+    const llmsSiteTitle = typeof config.nav === "object" &&
+        typeof config.nav?.title === "string"
+        ? config.nav.title
+        : "Documentation";
+    const llmsTxtConfig = config.llmsTxt;
+    const llmsBaseUrl = typeof llmsTxtConfig === "object" ? (llmsTxtConfig.baseUrl ?? "") : "";
+    const llmsTitle = typeof llmsTxtConfig === "object" ? (llmsTxtConfig.siteTitle ?? llmsSiteTitle) : llmsSiteTitle;
+    const llmsDesc = typeof llmsTxtConfig === "object" ? llmsTxtConfig.siteDescription : undefined;
+    function buildLlmsTxt(full) {
+        const pages = getSearchIndex();
+        let out = `# ${llmsTitle}\n\n`;
+        if (llmsDesc)
+            out += `> ${llmsDesc}\n\n`;
+        if (full) {
+            for (const page of pages) {
+                out += `## ${page.title}\n\n`;
+                out += `URL: ${llmsBaseUrl}${page.url}\n\n`;
+                if (page.description)
+                    out += `${page.description}\n\n`;
+                out += `${page.content}\n\n---\n\n`;
+            }
+        }
+        else {
+            out += `## Pages\n\n`;
+            for (const page of pages) {
+                out += `- [${page.title}](${llmsBaseUrl}${page.url})`;
+                if (page.description)
+                    out += `: ${page.description}`;
+                out += `\n`;
+            }
+        }
+        return out;
+    }
+    // ─── GET /api/docs?query=… | ?format=llms | ?format=llms-full ──
     function GET(event) {
+        const format = event.url.searchParams.get("format");
+        if (format === "llms" || format === "llms-full") {
+            return new Response(buildLlmsTxt(format === "llms-full"), {
+                headers: {
+                    "Content-Type": "text/plain; charset=utf-8",
+                    "Cache-Control": "public, max-age=3600",
+                },
+            });
+        }
         const query = event.url.searchParams.get("query")?.toLowerCase().trim();
         if (!query) {
             return new Response(JSON.stringify([]), {
@@ -456,7 +494,10 @@ export function createDocsServer(config = {}) {
         }
         const lastUserMessage = [...messages].reverse().find((m) => m.role === "user");
         if (!lastUserMessage) {
-            return new Response(JSON.stringify({ error: "At least one user message is required." }), { status: 400, headers: { "Content-Type": "application/json" } });
+            return new Response(JSON.stringify({ error: "At least one user message is required." }), {
+                status: 400,
+                headers: { "Content-Type": "application/json" },
+            });
         }
         const maxResults = aiConfig.maxResults ?? 5;
         const scored = searchByQuery(lastUserMessage.content.toLowerCase()).slice(0, maxResults);

package/package.json

@@ -1,7 +1,18 @@
 {
   "name": "@farming-labs/svelte",
-  "version": "0.0.2-beta.21",
+  "version": "0.0.2-beta.23",
   "description": "SvelteKit adapter for @farming-labs/docs — content loading and navigation utilities",
+  "keywords": [
+    "docs",
+    "documentation",
+    "svelte",
+    "sveltekit"
+  ],
+  "license": "MIT",
+  "author": "Farming Labs",
+  "files": [
+    "dist"
+  ],
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -32,17 +43,6 @@
       "default": "./dist/server.js"
     }
   },
-  "files": [
-    "dist"
-  ],
-  "keywords": [
-    "docs",
-    "svelte",
-    "sveltekit",
-    "documentation"
-  ],
-  "author": "Farming Labs",
-  "license": "MIT",
   "dependencies": {
     "gray-matter": "^4.0.3",
     "shiki": "^3.2.1"
@@ -50,7 +50,7 @@
   "devDependencies": {
     "@types/node": "^22.10.0",
     "typescript": "^5.9.3",
-    "@farming-labs/docs": "0.0.2-beta.21"
+    "@farming-labs/docs": "0.0.2-beta.23"
   },
   "peerDependencies": {
     "@farming-labs/docs": "*"