@farming-labs/svelte 0.1.84 → 0.1.86

package/dist/server.d.ts

@@ -54,6 +54,7 @@ export interface DocsServer {
         nextPage: PageNode | null;
         editOnGithub?: string;
         lastModified: string;
+        structuredData: string;
     }>;
     GET: (event: RequestEvent) => Promise<Response>;
     POST: (event: RequestEvent) => Promise<Response>;

package/dist/server.js

@@ -30,7 +30,7 @@
 import fs from "node:fs";
 import path from "node:path";
 import matter from "gray-matter";
-import { applySidebarFolderIndexBehavior, buildDocsAskAIContext, buildDocsAgentDiscoverySpec, createDocsSitemapResponse, createDocsAgentTraceContext, createDocsAgentTraceId, emitDocsAgentTraceEvent, emitDocsAnalyticsEvent, formatDocsAskAIPackageHints, findDocsMarkdownPage, getDocsMarkdownVaryHeader, isDocsAgentDiscoveryRequest, isDocsSkillRequest, normalizeDocsRelated, performDocsSearch, renderDocsMarkdownDocument, renderDocsMarkdownNotFound, renderDocsSkillDocument, readDocsSitemapManifestFromContentMap, stripGeneratedAgentProvenance, resolveDocsAgentMdxContent, resolvePageSidebarFolderIndexBehavior, resolveAskAISearchRequestConfig, resolveSearchRequestConfig, resolveDocsI18n, resolveDocsLlmsTxtFormat, resolveDocsLocale, resolveDocsMarkdownRequest, resolveDocsPath, resolvePageReadingTime, resolveReadingTimeOptions, resolveDocsSkillFormat, } from "@farming-labs/docs";
+import { applySidebarFolderIndexBehavior, buildDocsAskAIContext, buildDocsAgentDiscoverySpec, createDocsSitemapResponse, createDocsAgentTraceContext, createDocsAgentTraceId, emitDocsAgentTraceEvent, emitDocsAnalyticsEvent, formatDocsAskAIPackageHints, findDocsMarkdownPage, getDocsMarkdownVaryHeader, isDocsAgentDiscoveryRequest, isDocsSkillRequest, normalizeDocsRelated, performDocsSearch, renderDocsMarkdownDocument, renderDocsMarkdownNotFound, renderDocsSkillDocument, readDocsSitemapManifestFromContentMap, stripGeneratedAgentProvenance, resolveDocsAgentMdxContent, resolvePageSidebarFolderIndexBehavior, resolveAskAISearchRequestConfig, resolveSearchRequestConfig, resolveDocsI18n, resolveDocsLlmsTxtFormat, resolveDocsLocale, resolveDocsMarkdownRequest, resolveDocsMetadataBaseUrl, resolveDocsPath, resolvePageReadingTime, resolveReadingTimeOptions, resolveDocsSitemapPageLastmod, resolveDocsSkillFormat, renderDocsPageStructuredDataJson, toDocsMarkdownUrl, } from "@farming-labs/docs";
 import { createDocsMcpHttpHandler, readDocsSitemapManifest, resolveDocsMcpConfig, serializeDocsIconRegistry, serializeOpenDocsProviders, } from "@farming-labs/docs/server";
 import { loadDocsNavTree, loadDocsContent, flattenNavTree } from "./content.js";
 import { renderMarkdown } from "./markdown.js";
@@ -365,6 +365,7 @@ export function createDocsServer(config = {}) {
     const preloaded = rawPreloaded
         ? Object.fromEntries(Object.entries(rawPreloaded).map(([k, v]) => [k.startsWith("/") ? k : `/${k}`, v]))
         : undefined;
+    const preloadedSitemapManifest = readDocsSitemapManifestFromContentMap(preloaded);
     const ordering = config.ordering;
     const aiConfig = config.ai ?? {};
     // Allow top-level apiKey as a shorthand
@@ -432,9 +433,11 @@ export function createDocsServer(config = {}) {
         const flatPages = flattenNavTree(tree);
         const slug = ctx.slug;
         const isIndex = slug === "";
+        const currentUrl = isIndex ? `/${entry}` : `/${entry}/${slug}`;
         let raw;
         let relPath;
         let lastModified;
+        let lastModifiedIso;
         if (preloaded) {
             const result = findPageInMap(preloaded, ctx.dirPrefix, slug);
             if (!result) {
@@ -444,11 +447,16 @@ export function createDocsServer(config = {}) {
             }
             raw = result.raw;
             relPath = result.relPath;
-            lastModified = new Date().toLocaleDateString("en-US", {
+            const manifestLastmod = resolveDocsSitemapPageLastmod(preloadedSitemapManifest, currentUrl);
+            const lastModifiedDate = manifestLastmod
+                ? new Date(`${manifestLastmod}T00:00:00`)
+                : new Date();
+            lastModified = lastModifiedDate.toLocaleDateString("en-US", {
                 year: "numeric",
                 month: "long",
                 day: "numeric",
             });
+            lastModifiedIso = manifestLastmod ? `${manifestLastmod}T00:00:00.000Z` : undefined;
         }
         else {
             let filePath = null;
@@ -487,6 +495,7 @@ export function createDocsServer(config = {}) {
             }
             raw = fs.readFileSync(filePath, "utf-8");
             const stat = fs.statSync(filePath);
+            lastModifiedIso = stat.mtime.toISOString();
             lastModified = stat.mtime.toLocaleDateString("en-US", {
                 year: "numeric",
                 month: "long",
@@ -506,7 +515,6 @@ export function createDocsServer(config = {}) {
                 ? config.pageActions.openDocs.providers
                 : undefined),
         });
-        const currentUrl = isIndex ? `/${entry}` : `/${entry}/${slug}`;
         const currentIndex = flatPages.findIndex((p) => p.url === currentUrl);
         const previousPage = currentIndex > 0 ? flatPages[currentIndex - 1] : null;
         const nextPage = currentIndex < flatPages.length - 1 ? flatPages[currentIndex + 1] : null;
@@ -519,12 +527,22 @@ export function createDocsServer(config = {}) {
         const fallbackTitle = isIndex
             ? "Documentation"
             : (slug.split("/").pop()?.replace(/-/g, " ") ?? "Documentation");
+        const title = data.title ?? fallbackTitle;
+        const description = data.description;
+        const structuredData = renderDocsPageStructuredDataJson({
+            title,
+            description,
+            url: currentUrl,
+            baseUrl: resolveDocsMetadataBaseUrl(config),
+            entry,
+            dateModified: lastModifiedIso,
+        });
         return {
             tree,
             flatPages,
             url: currentUrl,
-            title: data.title ?? fallbackTitle,
-            description: data.description,
+            title,
+            description,
             html,
             readingTime,
             entry,
@@ -534,6 +552,7 @@ export function createDocsServer(config = {}) {
             nextPage,
             editOnGithub,
             lastModified,
+            structuredData,
         };
     }
     // ─── Search index ──────────────────────────────────────────
@@ -578,7 +597,7 @@ export function createDocsServer(config = {}) {
         }
         llmsTxt += `## Pages\n\n`;
         for (const page of pages) {
-            llmsTxt += `- [${page.title}](${llmsBaseUrl}${page.url})`;
+            llmsTxt += `- [${page.title}](${llmsBaseUrl}${toDocsMarkdownUrl(page.url)})`;
             if (page.description)
                 llmsTxt += `: ${page.description}`;
             llmsTxt += `\n`;
@@ -665,8 +684,7 @@ export function createDocsServer(config = {}) {
             siteTitle: llmsTitle,
             baseUrl: llmsBaseUrl || event.url.origin,
             pages: getSearchIndex(ctx),
-            manifest: readDocsSitemapManifestFromContentMap(preloaded) ??
-                readDocsSitemapManifest(rootDir, config.sitemap),
+            manifest: preloadedSitemapManifest ?? readDocsSitemapManifest(rootDir, config.sitemap),
         });
         if (sitemapResponse)
             return sitemapResponse;

package/package.json

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