@farming-labs/svelte 0.0.29 → 0.0.30

package/dist/server.d.ts

@@ -43,6 +43,8 @@ export interface DocsServer {
         title: string;
         description?: string;
         html: string;
+        entry?: string;
+        locale?: string;
         slug?: string;
         previousPage: PageNode | null;
         nextPage: PageNode | null;

package/dist/server.js

@@ -30,6 +30,7 @@
 import fs from "node:fs";
 import path from "node:path";
 import matter from "gray-matter";
+import { resolveDocsI18n, resolveDocsLocale, resolveDocsPath } from "@farming-labs/docs";
 import { loadDocsNavTree, loadDocsContent, flattenNavTree } from "./content.js";
 import { renderMarkdown } from "./markdown.js";
 function resolveAIModelAndProvider(aiConfig, requestedModelId) {
@@ -73,6 +74,25 @@ function stripMarkdownText(content) {
         .replace(/\n{3,}/g, "\n\n")
         .trim();
 }
+function normalizePathSegment(value) {
+    return value.replace(/^\/+|\/+$/g, "");
+}
+function joinPathParts(...parts) {
+    return parts
+        .map((part) => normalizePathSegment(part))
+        .filter(Boolean)
+        .join("/");
+}
+function toPosixPath(value) {
+    return value.replace(/\\\\/g, "/");
+}
+function buildDirPrefix(contentDir) {
+    const rel = path.isAbsolute(contentDir)
+        ? toPosixPath(path.relative(process.cwd(), contentDir))
+        : toPosixPath(contentDir);
+    const normalized = normalizePathSegment(rel);
+    return normalized ? `/${normalized}/` : "/";
+}
 function navTreeFromMap(contentMap, dirPrefix, entry, ordering) {
     const dirs = [];
     for (const key of Object.keys(contentMap)) {
@@ -272,15 +292,14 @@ function findPageInMap(contentMap, dirPrefix, slug) {
  */
 export function createDocsServer(config = {}) {
     const entry = config.entry ?? "docs";
+    const contentDirBase = config.contentDir ?? entry;
+    const i18n = resolveDocsI18n(config.i18n);
     const githubRaw = config.github;
     const github = typeof githubRaw === "string" ? { url: githubRaw } : (githubRaw ?? null);
     const githubRepo = github?.url;
     const githubBranch = github?.branch ?? "main";
     const githubContentPath = github?.directory;
-    const contentDir = path.resolve(config.contentDir ?? entry);
     const rawPreloaded = config._preloadedContent;
-    const contentDirRel = config.contentDir ?? entry;
-    const dirPrefix = `/${contentDirRel}/`;
     // Normalize keys: Vite's import.meta.glob may return paths without leading slash (e.g. "docs/...")
     const preloaded = rawPreloaded
         ? Object.fromEntries(Object.entries(rawPreloaded).map(([k, v]) => [k.startsWith("/") ? k : `/${k}`, v]))
@@ -291,20 +310,69 @@ export function createDocsServer(config = {}) {
     if (config.apiKey && !aiConfig.apiKey) {
         aiConfig.apiKey = config.apiKey;
     }
+    function resolveContentDirRel(locale) {
+        if (!locale)
+            return contentDirBase;
+        if (path.isAbsolute(contentDirBase))
+            return path.join(contentDirBase, locale);
+        return joinPathParts(contentDirBase, locale);
+    }
+    function resolveContextFromPath(pathname, locale) {
+        const match = resolveDocsPath(pathname, entry);
+        const contentDirRel = resolveContentDirRel(locale);
+        return {
+            ...match,
+            locale,
+            contentDirRel,
+            contentDirAbs: path.resolve(contentDirRel),
+            dirPrefix: buildDirPrefix(contentDirRel),
+        };
+    }
+    function resolveLocaleFromRequest(request) {
+        if (!i18n)
+            return undefined;
+        const url = new URL(request.url);
+        const direct = resolveDocsLocale(url.searchParams, i18n);
+        if (direct)
+            return direct;
+        const referrer = request.headers.get("referer") ?? request.headers.get("referrer");
+        if (referrer) {
+            try {
+                const refUrl = new URL(referrer);
+                const fromRef = resolveDocsLocale(refUrl.searchParams, i18n);
+                if (fromRef)
+                    return fromRef;
+            }
+            catch {
+                // ignore
+            }
+        }
+        return i18n.defaultLocale;
+    }
+    function resolveContextFromRequest(request) {
+        const locale = resolveLocaleFromRequest(request);
+        const url = new URL(request.url);
+        const pathnameParam = url.searchParams.get("pathname");
+        const referrer = request.headers.get("referer") ?? request.headers.get("referrer");
+        const refPath = referrer ? new URL(referrer).pathname : undefined;
+        const pathname = pathnameParam ?? refPath ?? `/${entry}`;
+        return resolveContextFromPath(pathname, locale);
+    }
     // ─── Unified load (tree + page content in one call) ────────
     async function load(event) {
+        const locale = resolveDocsLocale(event.url.searchParams, i18n) ?? i18n?.defaultLocale;
+        const ctx = resolveContextFromPath(event.url.pathname, locale);
         const tree = preloaded
-            ? navTreeFromMap(preloaded, dirPrefix, entry, ordering)
-            : loadDocsNavTree(contentDir, entry, ordering);
+            ? navTreeFromMap(preloaded, ctx.dirPrefix, entry, ordering)
+            : loadDocsNavTree(ctx.contentDirAbs, entry, ordering);
         const flatPages = flattenNavTree(tree);
-        const urlPrefix = new RegExp(`^/${entry}/?`);
-        const slug = event.url.pathname.replace(urlPrefix, "");
+        const slug = ctx.slug;
         const isIndex = slug === "";
         let raw;
         let relPath;
         let lastModified;
         if (preloaded) {
-            const result = findPageInMap(preloaded, dirPrefix, slug);
+            const result = findPageInMap(preloaded, ctx.dirPrefix, slug);
             if (!result) {
                 const err = new Error(`Page not found: /${entry}/${slug}`);
                 err.status = 404;
@@ -323,7 +391,7 @@ export function createDocsServer(config = {}) {
             relPath = "";
             if (isIndex) {
                 for (const name of ["page.md", "page.mdx", "index.md"]) {
-                    const candidate = path.join(contentDir, name);
+                    const candidate = path.join(ctx.contentDirAbs, name);
                     if (fs.existsSync(candidate)) {
                         filePath = candidate;
                         relPath = name;
@@ -333,17 +401,17 @@ export function createDocsServer(config = {}) {
             }
             else {
                 const candidates = [
-                    path.join(contentDir, slug, "page.md"),
-                    path.join(contentDir, slug, "page.mdx"),
-                    path.join(contentDir, slug, "index.md"),
-                    path.join(contentDir, slug, "index.svx"),
-                    path.join(contentDir, `${slug}.md`),
-                    path.join(contentDir, `${slug}.svx`),
+                    path.join(ctx.contentDirAbs, slug, "page.md"),
+                    path.join(ctx.contentDirAbs, slug, "page.mdx"),
+                    path.join(ctx.contentDirAbs, slug, "index.md"),
+                    path.join(ctx.contentDirAbs, slug, "index.svx"),
+                    path.join(ctx.contentDirAbs, `${slug}.md`),
+                    path.join(ctx.contentDirAbs, `${slug}.svx`),
                 ];
                 for (const candidate of candidates) {
                     if (fs.existsSync(candidate)) {
                         filePath = candidate;
-                        relPath = path.relative(contentDir, candidate);
+                        relPath = path.relative(ctx.contentDirAbs, candidate);
                         break;
                     }
                 }
@@ -369,7 +437,9 @@ export function createDocsServer(config = {}) {
         const nextPage = currentIndex < flatPages.length - 1 ? flatPages[currentIndex + 1] : null;
         let editOnGithub;
         if (githubRepo && githubContentPath) {
-            editOnGithub = `${githubRepo}/blob/${githubBranch}/${githubContentPath}/${relPath}`;
+            const trimmed = githubContentPath.replace(/\/+$/, "");
+            const localePrefix = ctx.locale ? `${ctx.locale}/` : "";
+            editOnGithub = `${githubRepo}/blob/${githubBranch}/${trimmed}/${localePrefix}${relPath}`;
         }
         const fallbackTitle = isIndex
             ? "Documentation"
@@ -380,6 +450,8 @@ export function createDocsServer(config = {}) {
             title: data.title ?? fallbackTitle,
             description: data.description,
             html,
+            entry,
+            locale: ctx.locale,
             ...(isIndex ? {} : { slug }),
             previousPage,
             nextPage,
@@ -388,17 +460,20 @@ export function createDocsServer(config = {}) {
         };
     }
     // ─── Search index ──────────────────────────────────────────
-    let searchIndex = null;
-    function getSearchIndex() {
-        if (!searchIndex) {
-            searchIndex = preloaded
-                ? searchIndexFromMap(preloaded, dirPrefix, entry)
-                : loadDocsContent(contentDir, entry);
-        }
-        return searchIndex;
+    const searchIndexByEntry = new Map();
+    function getSearchIndex(ctx) {
+        const key = ctx.locale ?? "__default__";
+        const cached = searchIndexByEntry.get(key);
+        if (cached)
+            return cached;
+        const index = preloaded
+            ? searchIndexFromMap(preloaded, ctx.dirPrefix, entry)
+            : loadDocsContent(ctx.contentDirAbs, entry);
+        searchIndexByEntry.set(key, index);
+        return index;
     }
-    function searchByQuery(query) {
-        const index = getSearchIndex();
+    function searchByQuery(query, ctx) {
+        const index = getSearchIndex(ctx);
         return index
             .map((page) => {
             const titleMatch = page.title.toLowerCase().includes(query) ? 10 : 0;
@@ -420,36 +495,42 @@ 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;
-    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`;
-            }
+    const llmsCache = new Map();
+    function getLlmsContent(ctx) {
+        const key = ctx.locale ?? "__default__";
+        const cached = llmsCache.get(key);
+        if (cached)
+            return cached;
+        const pages = getSearchIndex(ctx);
+        let llmsTxt = `# ${llmsTitle}\n\n`;
+        let llmsFullTxt = `# ${llmsTitle}\n\n`;
+        if (llmsDesc) {
+            llmsTxt += `> ${llmsDesc}\n\n`;
+            llmsFullTxt += `> ${llmsDesc}\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`;
-            }
+        llmsTxt += `## Pages\n\n`;
+        for (const page of pages) {
+            llmsTxt += `- [${page.title}](${llmsBaseUrl}${page.url})`;
+            if (page.description)
+                llmsTxt += `: ${page.description}`;
+            llmsTxt += `\n`;
+            llmsFullTxt += `## ${page.title}\n\n`;
+            llmsFullTxt += `URL: ${llmsBaseUrl}${page.url}\n\n`;
+            if (page.description)
+                llmsFullTxt += `${page.description}\n\n`;
+            llmsFullTxt += `${page.content}\n\n---\n\n`;
         }
-        return out;
+        const next = { llmsTxt, llmsFullTxt };
+        llmsCache.set(key, next);
+        return next;
     }
     // ─── GET /api/docs?query=… | ?format=llms | ?format=llms-full ──
     function GET(event) {
+        const ctx = resolveContextFromRequest(event.request);
         const format = event.url.searchParams.get("format");
         if (format === "llms" || format === "llms-full") {
-            return new Response(buildLlmsTxt(format === "llms-full"), {
+            const llmsContent = getLlmsContent(ctx);
+            return new Response(format === "llms-full" ? llmsContent.llmsFullTxt : llmsContent.llmsTxt, {
                 headers: {
                     "Content-Type": "text/plain; charset=utf-8",
                     "Cache-Control": "public, max-age=3600",
@@ -462,7 +543,7 @@ export function createDocsServer(config = {}) {
                 headers: { "Content-Type": "application/json" },
             });
         }
-        const results = searchByQuery(query)
+        const results = searchByQuery(query, ctx)
             .slice(0, 10)
             .map(({ title, url, description }) => ({
             content: title,
@@ -509,6 +590,7 @@ export function createDocsServer(config = {}) {
                 error: "AI is enabled but no API key was found. Set `apiKey` in your docs config `ai` section or add OPENAI_API_KEY to your environment.",
             }), { status: 500, headers: { "Content-Type": "application/json" } });
         }
+        const ctx = resolveContextFromRequest(event.request);
         let body;
         try {
             body = await event.request.json();
@@ -528,7 +610,7 @@ export function createDocsServer(config = {}) {
             });
         }
         const maxResults = aiConfig.maxResults ?? 5;
-        const scored = searchByQuery(lastUserMessage.content.toLowerCase()).slice(0, maxResults);
+        const scored = searchByQuery(lastUserMessage.content.toLowerCase(), ctx).slice(0, maxResults);
         const contextParts = scored.map((doc) => `## ${doc.title}\nURL: ${doc.url}\n${doc.description ? `Description: ${doc.description}\n` : ""}\n${doc.content}`);
         const context = contextParts.join("\n\n---\n\n");
         const systemPrompt = aiConfig.systemPrompt ?? DEFAULT_SYSTEM_PROMPT;

package/package.json

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