@farming-labs/docs 0.1.35 → 0.1.37

package/dist/cli/index.mjs

@@ -69,13 +69,13 @@ async function main() {
 		searchApiKey: typeof flags["search-api-key"] === "string" ? flags["search-api-key"] : void 0
 	};
 	if (!parsedCommand.command || parsedCommand.command === "init") {
-		const { init } = await import("../init-DwUjo2Kv.mjs");
+		const { init } = await import("../init-i5ySLGa2.mjs");
 		await init(initOptions);
 	} else if (parsedCommand.command === "mcp") {
 		const { runMcp } = await import("../mcp-DLP94P1H.mjs");
 		await runMcp(mcpOptions);
 	} else if (parsedCommand.command === "search" && subcommand === "sync") {
-		const { syncSearch } = await import("../search-CLaNOUrd.mjs");
+		const { syncSearch } = await import("../search-CNesqs89.mjs");
 		await syncSearch(searchSyncOptions);
 	} else if (parsedCommand.command === "search") {
 		console.error(pc.red(`Unknown search subcommand: ${subcommand ?? "(missing)"}`));

package/dist/index.d.mts

@@ -1,5 +1,6 @@
-import { $ as SidebarPageNode, A as DocsSearchResult, B as OGConfig, C as DocsSearchAdapterContext, D as DocsSearchDocument, E as DocsSearchConfig, F as FontStyle, G as PageActionsConfig, H as OpenDocsProvider, I as GithubConfig, J as PageTwitter, K as PageFrontmatter, L as LastUpdatedConfig, M as DocsSearchSourcePage, N as DocsTheme, O as DocsSearchEmbeddingsConfig, P as FeedbackConfig, Q as SidebarNode, R as LlmsTxtConfig, S as DocsSearchAdapter, T as DocsSearchChunkingConfig, U as OpenGraphImage, V as OpenDocsConfig, W as OrderingItem, X as SidebarConfig, Y as SidebarComponentProps, Z as SidebarFolderNode, _ as DocsI18nConfig, a as ApiReferenceRenderer, at as UIConfig, b as DocsMetadata, c as ChangelogFrontmatter, d as CustomDocsSearchConfig, et as SidebarTree, f as DocsAgentFeedbackContext, g as DocsFeedbackValue, h as DocsFeedbackData, i as ApiReferenceConfig, it as TypographyConfig, j as DocsSearchResultType, k as DocsSearchQuery, l as CodeBlockCopyData, m as DocsConfig, n as AgentFeedbackConfig, nt as ThemeToggleConfig, o as BreadcrumbConfig, p as DocsAgentFeedbackData, q as PageOpenGraph, r as AlgoliaDocsSearchConfig, rt as TypesenseDocsSearchConfig, s as ChangelogConfig, t as AIConfig, tt as SimpleDocsSearchConfig, u as CopyMarkdownConfig, v as DocsMcpConfig, w as DocsSearchAdapterFactory, x as DocsNav, y as DocsMcpToolsConfig, z as McpDocsSearchConfig } from "./types-CP8OcVgL.mjs";
-import { a as createSimpleSearchAdapter, c as resolveSearchRequestConfig, i as createMcpSearchAdapter, n as createAlgoliaSearchAdapter, o as createTypesenseSearchAdapter, r as createCustomSearchAdapter, s as performDocsSearch, t as buildDocsSearchDocuments } from "./search-zClNrbqL.mjs";
+import { $ as SidebarFolderNode, A as DocsSearchQuery, B as McpDocsSearchConfig, C as DocsSearchAdapter, D as DocsSearchConfig, E as DocsSearchChunkingConfig, F as FeedbackConfig, G as OrderingItem, H as OpenDocsConfig, I as FontStyle, J as PageOpenGraph, K as PageActionsConfig, L as GithubConfig, M as DocsSearchResultType, N as DocsSearchSourcePage, O as DocsSearchDocument, P as DocsTheme, Q as SidebarConfig, R as LastUpdatedConfig, S as DocsRelatedItem, T as DocsSearchAdapterFactory, U as OpenDocsProvider, V as OGConfig, W as OpenGraphImage, X as ResolvedDocsRelatedLink, Y as PageTwitter, Z as SidebarComponentProps, _ as DocsI18nConfig, a as ApiReferenceRenderer, at as TypesenseDocsSearchConfig, b as DocsMetadata, c as ChangelogFrontmatter, d as CustomDocsSearchConfig, et as SidebarNode, f as DocsAgentFeedbackContext, g as DocsFeedbackValue, h as DocsFeedbackData, i as ApiReferenceConfig, it as ThemeToggleConfig, j as DocsSearchResult, k as DocsSearchEmbeddingsConfig, l as CodeBlockCopyData, m as DocsConfig, n as AgentFeedbackConfig, nt as SidebarTree, o as BreadcrumbConfig, ot as TypographyConfig, p as DocsAgentFeedbackData, q as PageFrontmatter, r as AlgoliaDocsSearchConfig, rt as SimpleDocsSearchConfig, s as ChangelogConfig, st as UIConfig, t as AIConfig, tt as SidebarPageNode, u as CopyMarkdownConfig, v as DocsMcpConfig, w as DocsSearchAdapterContext, x as DocsNav, y as DocsMcpToolsConfig, z as LlmsTxtConfig } from "./types-CP2NmW5c.mjs";
+import { DocsMcpPage, DocsMcpResolvedConfig } from "./mcp.mjs";
+import { a as createSimpleSearchAdapter, c as resolveSearchRequestConfig, i as createMcpSearchAdapter, n as createAlgoliaSearchAdapter, o as createTypesenseSearchAdapter, r as createCustomSearchAdapter, s as performDocsSearch, t as buildDocsSearchDocuments } from "./search-BWqFW9rt.mjs";
 
 //#region src/define-docs.d.ts
 /**
@@ -115,4 +116,183 @@ declare function buildPageOpenGraph(page: Pick<PageFrontmatter, "title" | "descr
  */
 declare function buildPageTwitter(page: Pick<PageFrontmatter, "title" | "description" | "ogImage" | "openGraph" | "twitter">, ogConfig?: OGConfig, baseUrl?: string): PageTwitter | undefined;
 //#endregion
-export { type AIConfig, type AgentFeedbackConfig, type AlgoliaDocsSearchConfig, type ApiReferenceConfig, type ApiReferenceRenderer, type BreadcrumbConfig, type ChangelogConfig, type ChangelogEntrySummary, type ChangelogFrontmatter, type CodeBlockCopyData, type CopyMarkdownConfig, type CustomDocsSearchConfig, type DocsAgentFeedbackContext, type DocsAgentFeedbackData, type DocsConfig, type DocsFeedbackData, type DocsFeedbackValue, type DocsI18nConfig, type DocsMcpConfig, type DocsMcpToolsConfig, type DocsMetadata, type DocsNav, type DocsPathMatch, type DocsSearchAdapter, type DocsSearchAdapterContext, type DocsSearchAdapterFactory, type DocsSearchChunkingConfig, type DocsSearchConfig, type DocsSearchDocument, type DocsSearchEmbeddingsConfig, type DocsSearchQuery, type DocsSearchResult, type DocsSearchResultType, type DocsSearchSourcePage, type DocsTheme, type FeedbackConfig, type FontStyle, type GithubConfig, type LastUpdatedConfig, type LlmsTxtConfig, type McpDocsSearchConfig, type OGConfig, type OpenDocsConfig, type OpenDocsProvider, type OpenGraphImage, type OrderingItem, type PageActionsConfig, type PageFrontmatter, type PageOpenGraph, type PageTwitter, type ResolvedChangelogConfig, type ResolvedDocsI18n, type SidebarComponentProps, type SidebarConfig, type SidebarFolderNode, type SidebarNode, type SidebarPageNode, type SidebarTree, type SimpleDocsSearchConfig, type ThemeToggleConfig, type TypesenseDocsSearchConfig, type TypographyConfig, type UIConfig, buildDocsSearchDocuments, buildPageOpenGraph, buildPageTwitter, createAlgoliaSearchAdapter, createCustomSearchAdapter, createMcpSearchAdapter, createSimpleSearchAdapter, createTheme, createTypesenseSearchAdapter, deepMerge, defineDocs, extendTheme, performDocsSearch, resolveChangelogConfig, resolveDocsI18n, resolveDocsLocale, resolveDocsPath, resolveOGImage, resolveSearchRequestConfig, resolveTitle };
+//#region src/related.d.ts
+declare function normalizeDocsRelated(value: unknown): ResolvedDocsRelatedLink[];
+declare function renderDocsRelatedMarkdownLines(related: ResolvedDocsRelatedLink[] | undefined): string[];
+//#endregion
+//#region src/agent.d.ts
+declare const DEFAULT_DOCS_API_ROUTE = "/api/docs";
+declare const DEFAULT_AGENT_SPEC_ROUTE = "/api/docs/agent/spec";
+declare const DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE = "/.well-known/agent";
+declare const DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE = "/.well-known/agent.json";
+declare const DEFAULT_MCP_ROUTE = "/api/docs/mcp";
+declare const DEFAULT_MCP_PUBLIC_ROUTE = "/mcp";
+declare const DEFAULT_MCP_WELL_KNOWN_ROUTE = "/.well-known/mcp";
+declare const DEFAULT_LLMS_TXT_ROUTE = "/llms.txt";
+declare const DEFAULT_LLMS_FULL_TXT_ROUTE = "/llms-full.txt";
+declare const DEFAULT_LLMS_TXT_WELL_KNOWN_ROUTE = "/.well-known/llms.txt";
+declare const DEFAULT_LLMS_FULL_TXT_WELL_KNOWN_ROUTE = "/.well-known/llms-full.txt";
+declare const DEFAULT_AGENT_FEEDBACK_ROUTE = "/api/docs/agent/feedback";
+interface DocsAgentFeedbackDiscoveryConfig {
+  enabled?: boolean;
+  route?: string;
+  schemaRoute?: string;
+}
+interface DocsLlmsDiscoveryConfig {
+  enabled?: boolean;
+  baseUrl?: string;
+  siteTitle?: string;
+  siteDescription?: string;
+}
+interface DocsAgentDiscoverySpecOptions {
+  origin: string;
+  entry?: string;
+  i18n?: ResolvedDocsI18n | null;
+  search?: boolean | DocsSearchConfig;
+  mcp: DocsMcpResolvedConfig;
+  feedback?: DocsAgentFeedbackDiscoveryConfig;
+  llms?: DocsLlmsDiscoveryConfig;
+  markdown?: {
+    acceptHeader?: boolean;
+  };
+}
+interface DocsMarkdownPage {
+  slug?: string;
+  url: string;
+  title: string;
+  description?: string;
+  related?: ResolvedDocsRelatedLink[];
+  content: string;
+  rawContent?: string;
+  agentContent?: string;
+  agentRawContent?: string;
+  agentFallbackContent?: string;
+  agentFallbackRawContent?: string;
+}
+declare function normalizeDocsPathSegment(value: string): string;
+declare function normalizeDocsUrlPath(value: string): string;
+declare function isDocsAgentDiscoveryRequest(url: URL): boolean;
+declare function isDocsMcpRequest(url: URL): boolean;
+declare function isDocsPublicGetRequest(entry: string, url: URL, request: Request): boolean;
+declare function resolveDocsLlmsTxtFormat(url: URL): "llms" | "llms-full" | null;
+declare function resolveDocsMarkdownRequest(entry: string, url: URL, request: Request): {
+  requestedPath: string;
+} | null;
+declare function findDocsMarkdownPage<T extends DocsMarkdownPage>(entry: string, pages: T[], requestedPath: string): T | null;
+declare function renderDocsMarkdownDocument(page: DocsMcpPage | DocsSearchSourcePage): string;
+declare function renderDocsMarkdownDocument(page: DocsMarkdownPage): string;
+declare function resolveDocsAgentMdxContent(content: string, audience: "human" | "agent"): string;
+declare function buildDocsAgentDiscoverySpec({
+  origin,
+  entry,
+  i18n,
+  search,
+  mcp,
+  feedback,
+  llms,
+  markdown
+}: DocsAgentDiscoverySpecOptions): {
+  version: string;
+  name: string;
+  baseUrl: string;
+  site: {
+    title: string;
+    description: string | undefined;
+    entry: string;
+    baseUrl: string;
+  };
+  locales: {
+    enabled: boolean;
+    available: string[];
+    default: string | null;
+    queryParam: string;
+    fallbackQueryParam: string;
+  };
+  capabilities: {
+    markdownRoutes: boolean;
+    agentMdOverrides: boolean;
+    agentBlocks: boolean;
+    llms: boolean;
+    skills: boolean;
+    mcp: boolean;
+    search: boolean;
+    agentFeedback: boolean;
+    locales: boolean;
+  };
+  api: {
+    docs: string;
+    agentSpec: string;
+    agentSpecDefault: string;
+    agentSpecFallback: string;
+    agentSpecWellKnown: string;
+    agentSpecWellKnownJson: string;
+    agentSpecQuery: string;
+  };
+  markdown: {
+    enabled: boolean;
+    acceptHeader: string | null;
+    pagePattern: string;
+    rootPage: string;
+    apiPattern: string;
+    resolutionOrder: string[];
+  };
+  llms: {
+    enabled: boolean;
+    defaultTxt: string;
+    defaultFull: string;
+    txt: string;
+    full: string;
+    publicTxt: string;
+    publicFull: string;
+    wellKnownTxt: string;
+    wellKnownFull: string;
+  };
+  search: {
+    enabled: boolean;
+    endpoint: string;
+    method: string;
+    queryParam: string;
+    localeParam: string;
+  };
+  skills: {
+    enabled: boolean;
+    registry: string;
+    install: string;
+    recommended: {
+      name: string;
+      description: string;
+    }[];
+  };
+  mcp: {
+    enabled: boolean;
+    endpoint: string;
+    defaultEndpoint: string;
+    publicEndpoint: string;
+    wellKnownEndpoint: string;
+    publicEndpoints: string[];
+    canonicalEndpoint: string;
+    name: string;
+    version: string;
+    tools: {
+      listPages: boolean;
+      readPage: boolean;
+      searchDocs: boolean;
+      getNavigation: boolean;
+    };
+  };
+  feedback: {
+    enabled: boolean;
+    schema: string;
+    submit: string;
+    schemaQuery: string;
+    submitQuery: string;
+  };
+  instructions: {
+    preferMarkdownRoutes: boolean;
+    useMcpWhenAvailable: boolean;
+    readFeedbackSchemaBeforeSubmitting: boolean;
+    doNotAssumeFeedbackPayloadShape: boolean;
+  };
+};
+//#endregion
+export { type AIConfig, type AgentFeedbackConfig, type AlgoliaDocsSearchConfig, type ApiReferenceConfig, type ApiReferenceRenderer, type BreadcrumbConfig, type ChangelogConfig, type ChangelogEntrySummary, type ChangelogFrontmatter, type CodeBlockCopyData, type CopyMarkdownConfig, type CustomDocsSearchConfig, DEFAULT_AGENT_FEEDBACK_ROUTE, DEFAULT_AGENT_SPEC_ROUTE, DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE, DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE, DEFAULT_DOCS_API_ROUTE, DEFAULT_LLMS_FULL_TXT_ROUTE, DEFAULT_LLMS_FULL_TXT_WELL_KNOWN_ROUTE, DEFAULT_LLMS_TXT_ROUTE, DEFAULT_LLMS_TXT_WELL_KNOWN_ROUTE, DEFAULT_MCP_PUBLIC_ROUTE, DEFAULT_MCP_ROUTE, DEFAULT_MCP_WELL_KNOWN_ROUTE, type DocsAgentDiscoverySpecOptions, type DocsAgentFeedbackContext, type DocsAgentFeedbackData, type DocsAgentFeedbackDiscoveryConfig, type DocsConfig, type DocsFeedbackData, type DocsFeedbackValue, type DocsI18nConfig, type DocsLlmsDiscoveryConfig, type DocsMarkdownPage, type DocsMcpConfig, type DocsMcpToolsConfig, type DocsMetadata, type DocsNav, type DocsPathMatch, type DocsRelatedItem, type DocsSearchAdapter, type DocsSearchAdapterContext, type DocsSearchAdapterFactory, type DocsSearchChunkingConfig, type DocsSearchConfig, type DocsSearchDocument, type DocsSearchEmbeddingsConfig, type DocsSearchQuery, type DocsSearchResult, type DocsSearchResultType, type DocsSearchSourcePage, type DocsTheme, type FeedbackConfig, type FontStyle, type GithubConfig, type LastUpdatedConfig, type LlmsTxtConfig, type McpDocsSearchConfig, type OGConfig, type OpenDocsConfig, type OpenDocsProvider, type OpenGraphImage, type OrderingItem, type PageActionsConfig, type PageFrontmatter, type PageOpenGraph, type PageTwitter, type ResolvedChangelogConfig, type ResolvedDocsI18n, type ResolvedDocsRelatedLink, type SidebarComponentProps, type SidebarConfig, type SidebarFolderNode, type SidebarNode, type SidebarPageNode, type SidebarTree, type SimpleDocsSearchConfig, type ThemeToggleConfig, type TypesenseDocsSearchConfig, type TypographyConfig, type UIConfig, buildDocsAgentDiscoverySpec, buildDocsSearchDocuments, buildPageOpenGraph, buildPageTwitter, createAlgoliaSearchAdapter, createCustomSearchAdapter, createMcpSearchAdapter, createSimpleSearchAdapter, createTheme, createTypesenseSearchAdapter, deepMerge, defineDocs, extendTheme, findDocsMarkdownPage, isDocsAgentDiscoveryRequest, isDocsMcpRequest, isDocsPublicGetRequest, normalizeDocsPathSegment, normalizeDocsRelated, normalizeDocsUrlPath, performDocsSearch, renderDocsMarkdownDocument, renderDocsRelatedMarkdownLines, resolveChangelogConfig, resolveDocsAgentMdxContent, resolveDocsI18n, resolveDocsLlmsTxtFormat, resolveDocsLocale, resolveDocsMarkdownRequest, resolveDocsPath, resolveOGImage, resolveSearchRequestConfig, resolveTitle };

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import { a as createSimpleSearchAdapter, c as resolveSearchRequestConfig, i as createMcpSearchAdapter, n as createAlgoliaSearchAdapter, o as createTypesenseSearchAdapter, r as createCustomSearchAdapter, s as performDocsSearch, t as buildDocsSearchDocuments } from "./search-BS6C5N1i.mjs";
+import { a as createSimpleSearchAdapter, c as resolveSearchRequestConfig, i as createMcpSearchAdapter, l as normalizeDocsRelated, n as createAlgoliaSearchAdapter, o as createTypesenseSearchAdapter, r as createCustomSearchAdapter, s as performDocsSearch, t as buildDocsSearchDocuments, u as renderDocsRelatedMarkdownLines } from "./search-CfnJVeh-.mjs";
 
 //#region src/define-docs.ts
 /**
@@ -266,4 +266,262 @@ function buildPageTwitter(page, ogConfig, baseUrl) {
 }
 
 //#endregion
-export { buildDocsSearchDocuments, buildPageOpenGraph, buildPageTwitter, createAlgoliaSearchAdapter, createCustomSearchAdapter, createMcpSearchAdapter, createSimpleSearchAdapter, createTheme, createTypesenseSearchAdapter, deepMerge, defineDocs, extendTheme, performDocsSearch, resolveChangelogConfig, resolveDocsI18n, resolveDocsLocale, resolveDocsPath, resolveOGImage, resolveSearchRequestConfig, resolveTitle };
+//#region src/agent.ts
+const DEFAULT_DOCS_API_ROUTE = "/api/docs";
+const DEFAULT_AGENT_SPEC_ROUTE = "/api/docs/agent/spec";
+const DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE = "/.well-known/agent";
+const DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE = "/.well-known/agent.json";
+const DEFAULT_MCP_ROUTE = "/api/docs/mcp";
+const DEFAULT_MCP_PUBLIC_ROUTE = "/mcp";
+const DEFAULT_MCP_WELL_KNOWN_ROUTE = "/.well-known/mcp";
+const DEFAULT_LLMS_TXT_ROUTE = "/llms.txt";
+const DEFAULT_LLMS_FULL_TXT_ROUTE = "/llms-full.txt";
+const DEFAULT_LLMS_TXT_WELL_KNOWN_ROUTE = "/.well-known/llms.txt";
+const DEFAULT_LLMS_FULL_TXT_WELL_KNOWN_ROUTE = "/.well-known/llms-full.txt";
+const DEFAULT_AGENT_FEEDBACK_ROUTE = "/api/docs/agent/feedback";
+function normalizeDocsPathSegment(value) {
+	return value.replace(/^\/+|\/+$/g, "");
+}
+function normalizeDocsUrlPath(value) {
+	const normalized = value.replace(/\/+/g, "/");
+	if (normalized === "/") return normalized;
+	return normalized.replace(/\/+$/, "");
+}
+function isDocsAgentDiscoveryRequest(url) {
+	const pathname = normalizeDocsUrlPath(url.pathname);
+	if (pathname === DEFAULT_DOCS_API_ROUTE && url.searchParams.get("agent")?.trim() === "spec") return true;
+	return pathname === DEFAULT_AGENT_SPEC_ROUTE || pathname === DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE || pathname === DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE;
+}
+function isDocsMcpRequest(url) {
+	const pathname = normalizeDocsUrlPath(url.pathname);
+	return pathname === DEFAULT_MCP_ROUTE || pathname === DEFAULT_MCP_PUBLIC_ROUTE || pathname === DEFAULT_MCP_WELL_KNOWN_ROUTE;
+}
+function isDocsPublicGetRequest(entry, url, request) {
+	const pathname = normalizeDocsUrlPath(url.pathname);
+	if (pathname === DEFAULT_DOCS_API_ROUTE || pathname === DEFAULT_MCP_ROUTE) return false;
+	return isDocsAgentDiscoveryRequest(url) || resolveDocsLlmsTxtFormat(url) !== null || resolveDocsMarkdownRequest(entry, url, request) !== null;
+}
+function resolveDocsLlmsTxtFormat(url) {
+	const pathname = normalizeDocsUrlPath(url.pathname);
+	if (pathname === DEFAULT_LLMS_TXT_ROUTE || pathname === DEFAULT_LLMS_TXT_WELL_KNOWN_ROUTE) return "llms";
+	if (pathname === DEFAULT_LLMS_FULL_TXT_ROUTE || pathname === DEFAULT_LLMS_FULL_TXT_WELL_KNOWN_ROUTE) return "llms-full";
+	const format = url.searchParams.get("format");
+	return pathname === DEFAULT_DOCS_API_ROUTE && (format === "llms" || format === "llms-full") ? format : null;
+}
+function resolveDocsMarkdownRequest(entry, url, request) {
+	const pathname = normalizeDocsUrlPath(url.pathname);
+	const format = url.searchParams.get("format")?.trim();
+	if (pathname === DEFAULT_DOCS_API_ROUTE && format === "markdown") return { requestedPath: url.searchParams.get("path")?.trim() ?? "" };
+	const normalizedEntry = `/${normalizeDocsPathSegment(entry) || "docs"}`;
+	if (pathname === `${normalizedEntry}.md`) return { requestedPath: "" };
+	const slugPrefix = `${normalizedEntry}/`;
+	if (pathname.startsWith(slugPrefix) && pathname.endsWith(".md")) return { requestedPath: pathname.slice(slugPrefix.length, -3) };
+	if (acceptsMarkdown(request)) {
+		if (pathname === normalizedEntry) return { requestedPath: "" };
+		if (pathname.startsWith(slugPrefix)) return { requestedPath: pathname.slice(slugPrefix.length) };
+	}
+	return null;
+}
+function findDocsMarkdownPage(entry, pages, requestedPath) {
+	const normalizedRequest = normalizeRequestedMarkdownPath(entry, requestedPath);
+	for (const page of pages) if (normalizeDocsUrlPath(page.url) === normalizedRequest) return page;
+	const normalizedSlug = normalizeDocsPathSegment(requestedPath.replace(/^\//, "").replace(/\.md$/i, ""));
+	for (const page of pages) if (page.slug !== void 0 && normalizeDocsPathSegment(page.slug) === normalizedSlug) return page;
+	return null;
+}
+function renderDocsMarkdownDocument(page) {
+	if (page.agentRawContent !== void 0) return page.agentRawContent;
+	const relatedLines = renderDocsRelatedMarkdownLines(page.related);
+	const lines = [`# ${page.title}`, `URL: ${page.url}`];
+	if (page.description) lines.push(`Description: ${page.description}`);
+	lines.push(...relatedLines);
+	lines.push("", page.agentFallbackRawContent ?? page.rawContent ?? page.content);
+	return lines.join("\n");
+}
+function resolveDocsAgentMdxContent(content, audience) {
+	const lines = content.split("\n");
+	const output = [];
+	let fenceMarker = null;
+	let agentDepth = 0;
+	for (const line of lines) {
+		const trimmed = line.trim();
+		const fenceMatch = trimmed.match(/^(`{3,}|~{3,})/);
+		if (fenceMatch) {
+			if (!fenceMarker) fenceMarker = fenceMatch[1];
+			else if (trimmed.startsWith(fenceMarker)) fenceMarker = null;
+			if (audience === "agent" || agentDepth === 0) output.push(line);
+			continue;
+		}
+		if (!fenceMarker) {
+			if (/^<Agent(?:\s[^>]*)?\/>$/.test(trimmed)) continue;
+			const singleLineMatch = line.match(/^(\s*)<Agent(?:\s[^>]*)?>([\s\S]*?)<\/Agent>\s*$/);
+			if (singleLineMatch) {
+				if (audience === "agent" && singleLineMatch[2]) output.push(`${singleLineMatch[1]}${singleLineMatch[2]}`);
+				continue;
+			}
+			if (line.match(/^(\s*)<Agent(?:\s[^>]*)?>\s*$/)) {
+				agentDepth += 1;
+				continue;
+			}
+			const openWithContentMatch = line.match(/^(\s*)<Agent(?:\s[^>]*)?>(.*)$/);
+			if (openWithContentMatch) {
+				agentDepth += 1;
+				if (audience === "agent" && openWithContentMatch[2]) output.push(`${openWithContentMatch[1]}${openWithContentMatch[2]}`);
+				continue;
+			}
+			const closeWithContentMatch = line.match(/^(.*)<\/Agent>\s*$/);
+			if (closeWithContentMatch && agentDepth > 0) {
+				if (audience === "agent" && closeWithContentMatch[1].trim()) output.push(closeWithContentMatch[1]);
+				agentDepth = Math.max(0, agentDepth - 1);
+				continue;
+			}
+			if (/^<\/Agent>\s*$/.test(trimmed) && agentDepth > 0) {
+				agentDepth = Math.max(0, agentDepth - 1);
+				continue;
+			}
+		}
+		if (agentDepth > 0 && audience === "human") continue;
+		output.push(line);
+	}
+	return output.join("\n").replace(/\n{3,}/g, "\n\n").trim();
+}
+function buildDocsAgentDiscoverySpec({ origin, entry = "docs", i18n = null, search, mcp, feedback, llms, markdown }) {
+	const normalizedEntry = normalizeDocsPathSegment(entry) || "docs";
+	const localesEnabled = i18n !== null;
+	const searchEnabled = isSearchEnabled(search);
+	const feedbackRoute = feedback?.route ?? DEFAULT_AGENT_FEEDBACK_ROUTE;
+	const feedbackSchemaRoute = feedback?.schemaRoute ?? `${feedbackRoute}/schema`;
+	const llmsEnabled = llms?.enabled ?? true;
+	return {
+		version: "1",
+		name: "@farming-labs/docs",
+		baseUrl: origin,
+		site: {
+			title: llms?.siteTitle ?? "Documentation",
+			description: llms?.siteDescription,
+			entry: normalizedEntry,
+			baseUrl: llms?.baseUrl ?? origin
+		},
+		locales: {
+			enabled: localesEnabled,
+			available: i18n?.locales ?? [],
+			default: i18n?.defaultLocale ?? null,
+			queryParam: "lang",
+			fallbackQueryParam: "locale"
+		},
+		capabilities: {
+			markdownRoutes: true,
+			agentMdOverrides: true,
+			agentBlocks: true,
+			llms: llmsEnabled,
+			skills: true,
+			mcp: mcp.enabled,
+			search: searchEnabled,
+			agentFeedback: feedback?.enabled ?? false,
+			locales: localesEnabled
+		},
+		api: {
+			docs: DEFAULT_DOCS_API_ROUTE,
+			agentSpec: DEFAULT_AGENT_SPEC_ROUTE,
+			agentSpecDefault: DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE,
+			agentSpecFallback: DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE,
+			agentSpecWellKnown: DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE,
+			agentSpecWellKnownJson: DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE,
+			agentSpecQuery: `${DEFAULT_DOCS_API_ROUTE}?agent=spec`
+		},
+		markdown: {
+			enabled: true,
+			acceptHeader: markdown?.acceptHeader === false ? null : "text/markdown",
+			pagePattern: `/${normalizedEntry}/{slug}.md`,
+			rootPage: `/${normalizedEntry}.md`,
+			apiPattern: `${DEFAULT_DOCS_API_ROUTE}?format=markdown&path={slug}`,
+			resolutionOrder: [
+				"agent.md",
+				"Agent blocks",
+				"page markdown"
+			]
+		},
+		llms: {
+			enabled: llmsEnabled,
+			defaultTxt: DEFAULT_LLMS_TXT_ROUTE,
+			defaultFull: DEFAULT_LLMS_FULL_TXT_ROUTE,
+			txt: `${DEFAULT_DOCS_API_ROUTE}?format=llms`,
+			full: `${DEFAULT_DOCS_API_ROUTE}?format=llms-full`,
+			publicTxt: DEFAULT_LLMS_TXT_ROUTE,
+			publicFull: DEFAULT_LLMS_FULL_TXT_ROUTE,
+			wellKnownTxt: DEFAULT_LLMS_TXT_WELL_KNOWN_ROUTE,
+			wellKnownFull: DEFAULT_LLMS_FULL_TXT_WELL_KNOWN_ROUTE
+		},
+		search: {
+			enabled: searchEnabled,
+			endpoint: `${DEFAULT_DOCS_API_ROUTE}?query={query}`,
+			method: "GET",
+			queryParam: "query",
+			localeParam: "lang"
+		},
+		skills: {
+			enabled: true,
+			registry: "skills.sh",
+			install: "npx skills add farming-labs/docs",
+			recommended: [{
+				name: "getting-started",
+				description: "Use for installation, init, framework setup, theme CSS, and first docs.config wiring."
+			}]
+		},
+		mcp: {
+			enabled: mcp.enabled,
+			endpoint: mcp.route,
+			defaultEndpoint: DEFAULT_MCP_PUBLIC_ROUTE,
+			publicEndpoint: DEFAULT_MCP_PUBLIC_ROUTE,
+			wellKnownEndpoint: DEFAULT_MCP_WELL_KNOWN_ROUTE,
+			publicEndpoints: [DEFAULT_MCP_PUBLIC_ROUTE, DEFAULT_MCP_WELL_KNOWN_ROUTE],
+			canonicalEndpoint: DEFAULT_MCP_ROUTE,
+			name: mcp.name,
+			version: mcp.version,
+			tools: mcp.tools
+		},
+		feedback: {
+			enabled: feedback?.enabled ?? false,
+			schema: feedbackSchemaRoute,
+			submit: feedbackRoute,
+			schemaQuery: `${DEFAULT_DOCS_API_ROUTE}?feedback=agent&schema=1`,
+			submitQuery: `${DEFAULT_DOCS_API_ROUTE}?feedback=agent`
+		},
+		instructions: {
+			preferMarkdownRoutes: true,
+			useMcpWhenAvailable: true,
+			readFeedbackSchemaBeforeSubmitting: true,
+			doNotAssumeFeedbackPayloadShape: true
+		}
+	};
+}
+function acceptsMarkdown(request) {
+	const accept = request.headers.get("accept");
+	if (!accept) return false;
+	return accept.split(",").map((value) => value.trim()).some((value) => {
+		const [mediaType, ...params] = value.split(";").map((part) => part.trim().toLowerCase());
+		if (mediaType !== "text/markdown") return false;
+		const qualityParam = params.find((param) => param.split("=", 1)[0]?.trim() === "q");
+		if (!qualityParam) return true;
+		const qualityValue = qualityParam.slice(qualityParam.indexOf("=") + 1).trim();
+		const quality = Number.parseFloat(qualityValue);
+		return Number.isFinite(quality) ? quality > 0 : true;
+	});
+}
+function normalizeRequestedMarkdownPath(entry, requestedPath) {
+	const normalizedEntry = `/${normalizeDocsPathSegment(entry) || "docs"}`;
+	const trimmed = requestedPath.trim().replace(/\.md$/i, "");
+	if (!trimmed) return normalizedEntry;
+	const normalized = normalizeDocsUrlPath(trimmed.startsWith("/") ? trimmed : `/${trimmed}`);
+	if (normalized === normalizedEntry || normalized.startsWith(`${normalizedEntry}/`)) return normalized;
+	const slug = normalizeDocsPathSegment(trimmed);
+	return slug ? normalizeDocsUrlPath(`${normalizedEntry}/${slug}`) : normalizedEntry;
+}
+function isSearchEnabled(search) {
+	if (search === false) return false;
+	if (search && typeof search === "object" && search.enabled === false) return false;
+	return true;
+}
+
+//#endregion
+export { DEFAULT_AGENT_FEEDBACK_ROUTE, DEFAULT_AGENT_SPEC_ROUTE, DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE, DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE, DEFAULT_DOCS_API_ROUTE, DEFAULT_LLMS_FULL_TXT_ROUTE, DEFAULT_LLMS_FULL_TXT_WELL_KNOWN_ROUTE, DEFAULT_LLMS_TXT_ROUTE, DEFAULT_LLMS_TXT_WELL_KNOWN_ROUTE, DEFAULT_MCP_PUBLIC_ROUTE, DEFAULT_MCP_ROUTE, DEFAULT_MCP_WELL_KNOWN_ROUTE, buildDocsAgentDiscoverySpec, buildDocsSearchDocuments, buildPageOpenGraph, buildPageTwitter, createAlgoliaSearchAdapter, createCustomSearchAdapter, createMcpSearchAdapter, createSimpleSearchAdapter, createTheme, createTypesenseSearchAdapter, deepMerge, defineDocs, extendTheme, findDocsMarkdownPage, isDocsAgentDiscoveryRequest, isDocsMcpRequest, isDocsPublicGetRequest, normalizeDocsPathSegment, normalizeDocsRelated, normalizeDocsUrlPath, performDocsSearch, renderDocsMarkdownDocument, renderDocsRelatedMarkdownLines, resolveChangelogConfig, resolveDocsAgentMdxContent, resolveDocsI18n, resolveDocsLlmsTxtFormat, resolveDocsLocale, resolveDocsMarkdownRequest, resolveDocsPath, resolveOGImage, resolveSearchRequestConfig, resolveTitle };

package/dist/{init-DwUjo2Kv.mjs → init-i5ySLGa2.mjs}

@@ -247,6 +247,14 @@ function sveltePageConfigImport(useAlias) {
 function svelteLayoutServerImport(useAlias) {
 	return useAlias ? "$lib/docs.server" : "../../lib/docs.server";
 }
+function svelteRouteServerImport(filePath, useAlias) {
+	if (useAlias) return "$lib/docs.server";
+	return relativeImport(filePath, "src/lib/docs.server.ts");
+}
+function svelteRouteConfigImport(filePath, useAlias) {
+	if (useAlias) return "$lib/docs.config";
+	return relativeImport(filePath, "src/lib/docs.config.ts");
+}
 function astroServerConfigImport(useAlias) {
 	return useAlias ? "@/lib/docs.config" : "./docs.config";
 }
@@ -258,6 +266,14 @@ function astroPageServerImport(useAlias, depth) {
 	if (useAlias) return "@/lib/docs.server";
 	return `${"../".repeat(depth)}lib/docs.server`;
 }
+function astroRouteServerImport(filePath, useAlias) {
+	if (useAlias) return "@/lib/docs.server";
+	return relativeImport(filePath, "src/lib/docs.server.ts");
+}
+function astroRouteConfigImport(filePath, useAlias) {
+	if (useAlias) return "@/lib/docs.config";
+	return relativeImport(filePath, "src/lib/docs.config.ts");
+}
 function docsConfigTemplate(cfg) {
 	if (cfg.theme === "custom" && cfg.customThemeName) {
 		const exportName = getThemeExportName(cfg.customThemeName);
@@ -811,13 +827,27 @@ function DocsIndexPage() {
 }
 function tanstackDocsCatchAllRouteTemplate(opts) {
 	const entryUrl = `/${opts.entry.replace(/^\/+|\/+$/g, "")}`;
+	const serverImport = opts.useAlias ? "@/lib/docs.server" : relativeImport(opts.filePath, "src/lib/docs.server.ts");
 	return `\
 import { createFileRoute, notFound } from "@tanstack/react-router";
+import { isDocsPublicGetRequest } from "@farming-labs/docs";
 import { TanstackDocsPage } from "@farming-labs/tanstack-start/react";
 import { loadDocPage } from "${tanstackDocsFunctionsImport(opts)}";
+import { docsServer } from "${serverImport}";
 import docsConfig from "${tanstackDocsConfigImport(opts.filePath)}";
 
 export const Route = createFileRoute("${entryUrl}/$")({
+  server: {
+    handlers: {
+      GET: async ({ request }) => {
+        const url = new URL(request.url);
+        if (isDocsPublicGetRequest(${JSON.stringify(opts.entry)}, url, request)) {
+          return docsServer.GET({ request });
+        }
+        return undefined;
+      },
+    },
+  },
   loader: async ({ location }) => {
     try {
       return await loadDocPage({ data: { pathname: location.pathname } });
@@ -865,6 +895,46 @@ export const Route = createFileRoute("/api/docs")({
 });
 `;
 }
+function tanstackDocsPublicRouteTemplate(useAlias, filePath, entry) {
+	return `\
+import { createFileRoute } from "@tanstack/react-router";
+import { isDocsMcpRequest, isDocsPublicGetRequest } from "@farming-labs/docs";
+import { docsServer } from "${useAlias ? "@/lib/docs.server" : relativeImport(filePath, "src/lib/docs.server.ts")}";
+
+const docsEntry = ${JSON.stringify(entry)};
+
+async function handlePublicDocsRequest(request: Request) {
+  const url = new URL(request.url);
+  const method = request.method.toUpperCase();
+
+  if (isDocsMcpRequest(url)) {
+    if (method === "POST") return docsServer.MCP.POST({ request });
+    if (method === "DELETE") return docsServer.MCP.DELETE({ request });
+    if (method === "GET" || method === "HEAD") return docsServer.MCP.GET({ request });
+    return new Response("Method Not Allowed", {
+      status: 405,
+      headers: { Allow: "GET, HEAD, POST, DELETE" },
+    });
+  }
+
+  if ((method === "GET" || method === "HEAD") && isDocsPublicGetRequest(docsEntry, url, request)) {
+    return docsServer.GET({ request });
+  }
+
+  return new Response("Not Found", { status: 404 });
+}
+
+export const Route = createFileRoute("/$")({
+  server: {
+    handlers: {
+      GET: async ({ request }) => handlePublicDocsRequest(request),
+      POST: async ({ request }) => handlePublicDocsRequest(request),
+      DELETE: async ({ request }) => handlePublicDocsRequest(request),
+    },
+  },
+});
+`;
+}
 function tanstackApiReferenceRouteTemplate(opts) {
 	const routePath = `/${opts.apiReferencePath}${opts.catchAll ? "/$" : "/"}`;
 	return `\
@@ -1038,6 +1108,7 @@ src/lib/docs.functions.ts
 src/routes/${cfg.entry}/index.tsx
 src/routes/${cfg.entry}/$.tsx
 src/routes/api/docs.ts
+src/routes/$.ts
 \`\`\`
 `;
 	}
@@ -1192,7 +1263,7 @@ const contentFiles = import.meta.glob("/${cfg.entry ?? "docs"}/**/*.{md,mdx,svx}
   eager: true,
 }) as Record<string, string>;
 
-export const { load, GET, POST } = createDocsServer({
+export const { load, GET, POST, MCP } = createDocsServer({
   ...config,
   _preloadedContent: contentFiles,
 });
@@ -1237,6 +1308,91 @@ import config from "${useAlias ? "$lib/docs.config" : relativeImport(filePath, "
 export const GET = createSvelteApiReference(config);
 `;
 }
+function svelteDocsApiRouteTemplate(filePath, useAlias) {
+	return `\
+export { GET, POST } from "${svelteRouteServerImport(filePath, useAlias)}";
+`;
+}
+function svelteDocsPublicHookTemplate(filePath, useAlias) {
+	const serverImport = svelteRouteServerImport(filePath, useAlias);
+	return `\
+import { isDocsMcpRequest, isDocsPublicGetRequest } from "@farming-labs/docs";
+import type { Handle } from "@sveltejs/kit";
+import config from "${svelteRouteConfigImport(filePath, useAlias)}";
+import { GET, MCP } from "${serverImport}";
+
+const docsEntry = config.entry ?? "docs";
+
+export const handle: Handle = async ({ event, resolve }) => {
+  const method = event.request.method.toUpperCase();
+
+  if (isDocsMcpRequest(event.url)) {
+    if (method === "POST") return MCP.POST({ request: event.request });
+    if (method === "DELETE") return MCP.DELETE({ request: event.request });
+    if (method === "GET" || method === "HEAD") return MCP.GET({ request: event.request });
+    return new Response("Method Not Allowed", {
+      status: 405,
+      headers: { Allow: "GET, HEAD, POST, DELETE" },
+    });
+  }
+
+  if ((method === "GET" || method === "HEAD") && isDocsPublicGetRequest(docsEntry, event.url, event.request)) {
+    return GET({ url: event.url, request: event.request });
+  }
+
+  return resolve(event);
+};
+`;
+}
+function injectSvelteDocsPublicHook(content, filePath, useAlias) {
+	if (content.includes("isDocsPublicGetRequest") || content.includes("docsPublicHandle")) return null;
+	if (/export\s*{\s*handle\b/.test(content)) return null;
+	const serverImport = svelteRouteServerImport(filePath, useAlias);
+	const configImport = svelteRouteConfigImport(filePath, useAlias);
+	let next = content.trimEnd();
+	let hasExistingHandle = false;
+	for (const [pattern, replacement] of [
+		[/\bexport\s+const\s+handle(\s*:\s*[^=]+)?\s*=/, "const existingHandle$1 ="],
+		[/\bexport\s+async\s+function\s+handle\b/, "async function existingHandle"],
+		[/\bexport\s+function\s+handle\b/, "function existingHandle"]
+	]) if (pattern.test(next)) {
+		next = next.replace(pattern, replacement);
+		next = next.replace(/const existingHandle(:[^=\n]*?)\s+=/, "const existingHandle$1 =");
+		hasExistingHandle = true;
+		break;
+	}
+	const imports = [
+		"import { isDocsMcpRequest, isDocsPublicGetRequest } from \"@farming-labs/docs\";",
+		...next.includes("Handle") ? [] : ["import type { Handle } from \"@sveltejs/kit\";"],
+		...hasExistingHandle && !next.includes("sequence") ? ["import { sequence } from \"@sveltejs/kit/hooks\";"] : [],
+		`import docsConfig from "${configImport}";`,
+		`import { GET as docsGET, MCP as docsMCP } from "${serverImport}";`
+	];
+	const docsHandle = `\
+const docsEntry = docsConfig.entry ?? "docs";
+
+const docsPublicHandle: Handle = async ({ event, resolve }) => {
+  const method = event.request.method.toUpperCase();
+
+  if (isDocsMcpRequest(event.url)) {
+    if (method === "POST") return docsMCP.POST({ request: event.request });
+    if (method === "DELETE") return docsMCP.DELETE({ request: event.request });
+    if (method === "GET" || method === "HEAD") return docsMCP.GET({ request: event.request });
+    return new Response("Method Not Allowed", {
+      status: 405,
+      headers: { Allow: "GET, HEAD, POST, DELETE" },
+    });
+  }
+
+  if ((method === "GET" || method === "HEAD") && isDocsPublicGetRequest(docsEntry, event.url, event.request)) {
+    return docsGET({ url: event.url, request: event.request });
+  }
+
+  return resolve(event);
+};`;
+	const exportLine = hasExistingHandle ? "export const handle = sequence(docsPublicHandle, existingHandle);" : "export const handle = docsPublicHandle;";
+	return `${imports.join("\n")}\n${next}\n\n${docsHandle}\n\n${exportLine}\n`;
+}
 function svelteRootLayoutTemplate(globalCssRelPath) {
 	let cssImport;
 	if (globalCssRelPath.startsWith("src/")) cssImport = "./" + globalCssRelPath.slice(4);
@@ -1354,10 +1510,12 @@ ${cfg.entry}/                   # Markdown content
   quickstart/
     page.md                    # /${cfg.entry}/quickstart
 src/
+  hooks.server.ts             # Public docs aliases
   lib/
     docs.config.ts             # Docs configuration
     docs.server.ts             # Server-side docs loader
   routes/
+    api/docs/+server.ts        # Search/AI API route
     ${cfg.entry}/
       +layout.svelte           # Docs layout
       +layout.server.js        # Layout data loader
@@ -1509,7 +1667,7 @@ const contentFiles = import.meta.glob("/${cfg.entry ?? "docs"}/**/*.{md,mdx}", {
   eager: true,
 }) as Record<string, string>;
 
-export const { load, GET, POST } = createDocsServer({
+export const { load, GET, POST, MCP } = createDocsServer({
   ...config,
   _preloadedContent: contentFiles,
 });
@@ -1619,6 +1777,86 @@ export const POST: APIRoute = async ({ request }) => {
 };
 `;
 }
+function astroDocsMiddlewareTemplate(filePath, useAlias) {
+	const serverImport = astroRouteServerImport(filePath, useAlias);
+	return `\
+import { isDocsMcpRequest, isDocsPublicGetRequest } from "@farming-labs/docs";
+import type { MiddlewareHandler } from "astro";
+import config from "${astroRouteConfigImport(filePath, useAlias)}";
+import { GET, MCP } from "${serverImport}";
+
+const docsEntry = config.entry ?? "docs";
+
+export const onRequest: MiddlewareHandler = async (context, next) => {
+  const method = context.request.method.toUpperCase();
+
+  if (isDocsMcpRequest(context.url)) {
+    if (method === "POST") return MCP.POST({ request: context.request });
+    if (method === "DELETE") return MCP.DELETE({ request: context.request });
+    if (method === "GET" || method === "HEAD") return MCP.GET({ request: context.request });
+    return new Response("Method Not Allowed", {
+      status: 405,
+      headers: { Allow: "GET, HEAD, POST, DELETE" },
+    });
+  }
+
+  if ((method === "GET" || method === "HEAD") && isDocsPublicGetRequest(docsEntry, context.url, context.request)) {
+    return GET({ request: context.request });
+  }
+
+  return next();
+};
+`;
+}
+function injectAstroDocsMiddleware(content, filePath, useAlias) {
+	if (content.includes("isDocsPublicGetRequest") || content.includes("docsPublicMiddleware")) return null;
+	if (/export\s*{\s*onRequest\b/.test(content)) return null;
+	const serverImport = astroRouteServerImport(filePath, useAlias);
+	const configImport = astroRouteConfigImport(filePath, useAlias);
+	let next = content.trimEnd();
+	let hasExistingMiddleware = false;
+	for (const [pattern, replacement] of [
+		[/\bexport\s+const\s+onRequest(\s*:\s*[^=]+)?\s*=/, "const existingOnRequest$1 ="],
+		[/\bexport\s+async\s+function\s+onRequest\b/, "async function existingOnRequest"],
+		[/\bexport\s+function\s+onRequest\b/, "function existingOnRequest"]
+	]) if (pattern.test(next)) {
+		next = next.replace(pattern, replacement);
+		next = next.replace(/const existingOnRequest(:[^=\n]*?)\s+=/, "const existingOnRequest$1 =");
+		hasExistingMiddleware = true;
+		break;
+	}
+	const imports = [
+		"import { isDocsMcpRequest, isDocsPublicGetRequest } from \"@farming-labs/docs\";",
+		...next.includes("MiddlewareHandler") ? [] : ["import type { MiddlewareHandler } from \"astro\";"],
+		...hasExistingMiddleware && !next.includes("sequence") ? ["import { sequence } from \"astro:middleware\";"] : [],
+		`import docsConfig from "${configImport}";`,
+		`import { GET as docsGET, MCP as docsMCP } from "${serverImport}";`
+	];
+	const docsMiddleware = `\
+const docsEntry = docsConfig.entry ?? "docs";
+
+const docsPublicMiddleware: MiddlewareHandler = async (context, next) => {
+  const method = context.request.method.toUpperCase();
+
+  if (isDocsMcpRequest(context.url)) {
+    if (method === "POST") return docsMCP.POST({ request: context.request });
+    if (method === "DELETE") return docsMCP.DELETE({ request: context.request });
+    if (method === "GET" || method === "HEAD") return docsMCP.GET({ request: context.request });
+    return new Response("Method Not Allowed", {
+      status: 405,
+      headers: { Allow: "GET, HEAD, POST, DELETE" },
+    });
+  }
+
+  if ((method === "GET" || method === "HEAD") && isDocsPublicGetRequest(docsEntry, context.url, context.request)) {
+    return docsGET({ request: context.request });
+  }
+
+  return next();
+};`;
+	const exportLine = hasExistingMiddleware ? "export const onRequest = sequence(docsPublicMiddleware, existingOnRequest);" : "export const onRequest = docsPublicMiddleware;";
+	return `${imports.join("\n")}\n${next}\n\n${docsMiddleware}\n\n${exportLine}\n`;
+}
 function astroApiReferenceRouteTemplate(filePath) {
 	return `\
 import { createAstroApiReference } from "@farming-labs/astro/api-reference";
@@ -1730,6 +1968,7 @@ ${cfg.entry}/                   # Markdown content
   quickstart/
     page.md                    # /${cfg.entry}/quickstart
 src/
+  middleware.ts                # Public docs aliases
   lib/
     docs.config.ts             # Docs configuration
     docs.server.ts             # Server-side docs loader
@@ -1862,66 +2101,20 @@ export default defineDocs({
 });
 `;
 }
-function nuxtDocsServerTemplate(cfg) {
-	const contentDirName = cfg.entry ?? "docs";
+function nuxtServerApiDocsRouteTemplate(cfg) {
 	return `\
-import { createDocsServer } from "@farming-labs/nuxt/server";
+import { defineDocsHandler } from "@farming-labs/nuxt/server";
 import config from "${cfg.useAlias ? "~/docs.config" : "../../docs.config"}";
 
-const contentFiles = import.meta.glob("/${contentDirName}/**/*.{md,mdx}", {
-  query: "?raw",
-  import: "default",
-  eager: true,
-}) as Record<string, string>;
-
-export const docsServer = createDocsServer({
-  ...config,
-  _preloadedContent: contentFiles,
-});
-`;
-}
-function nuxtServerApiDocsGetTemplate() {
-	return `\
-import { getRequestURL } from "h3";
-import { docsServer } from "../utils/docs-server";
-
-export default defineEventHandler((event) => {
-  const url = getRequestURL(event);
-  const request = new Request(url.href, {
-    method: event.method,
-    headers: event.headers,
-  });
-  return docsServer.GET({ request });
-});
-`;
-}
-function nuxtServerApiDocsPostTemplate() {
-	return `\
-import { getRequestURL, readRawBody } from "h3";
-import { docsServer } from "../utils/docs-server";
-
-export default defineEventHandler(async (event) => {
-  const url = getRequestURL(event);
-  const body = await readRawBody(event);
-  const request = new Request(url.href, {
-    method: "POST",
-    headers: event.headers,
-    body: body ?? undefined,
-  });
-  return docsServer.POST({ request });
-});
+export default defineDocsHandler(config, useStorage);
 `;
 }
-function nuxtServerApiDocsLoadTemplate() {
+function nuxtServerDocsPublicMiddlewareTemplate(cfg) {
 	return `\
-import { getQuery } from "h3";
-import { docsServer } from "../../utils/docs-server";
+import { defineDocsPublicHandler } from "@farming-labs/nuxt/server";
+import config from "${cfg.useAlias ? "~/docs.config" : "../../docs.config"}";
 
-export default defineEventHandler(async (event) => {
-  const query = getQuery(event);
-  const pathname = (query.pathname as string) ?? "/docs";
-  return docsServer.load(pathname);
-});
+export default defineDocsPublicHandler(config, useStorage);
 `;
 }
 function nuxtServerApiReferenceRouteTemplate(filePath, useAlias) {
@@ -1942,7 +2135,7 @@ const route = useRoute();
 const pathname = computed(() => route.path);
 
 const { data, error } = await useAsyncData(\`docs-\${pathname.value}\`, () =>
-  $fetch("/api/docs/load", {
+  $fetch("/api/docs", {
     query: { pathname: pathname.value },
   })
 );
@@ -1979,6 +2172,7 @@ export default defineNuxtConfig({
 
   nitro: {
     moduleSideEffects: ["@farming-labs/nuxt/server"],
+    serverAssets: [{ baseName: "${cfg.entry}", dir: "${cfg.entry}" }],
   },
 });
 `;
@@ -2065,11 +2259,8 @@ ${cfg.entry}/                   # Markdown content
   installation/page.md
   quickstart/page.md
 server/
-  utils/docs-server.ts          # createDocsServer + preloaded content
-  api/docs/
-    load.get.ts                 # Page data API
-    docs.get.ts                 # Search API
-    docs.post.ts                # AI chat API
+  api/docs.ts                   # Page data, search, and AI chat API
+  middleware/docs-public.ts     # llms.txt, .well-known, .md, and MCP aliases
 pages/
   ${cfg.entry}/[[...slug]].vue   # Docs catch-all page
 docs.config.ts
@@ -3091,6 +3282,7 @@ function scaffoldTanstackStart(cwd, cfg, globalCssRelPath, write, skipped, writt
 	const docsIndexRoute = `${routeDir}/index.tsx`;
 	const docsCatchAllRoute = `${routeDir}/$.tsx`;
 	const apiRoute = "src/routes/api/docs.ts";
+	const publicRoute = "src/routes/$.ts";
 	write(docsIndexRoute, tanstackDocsIndexRouteTemplate({
 		entry: cfg.entry,
 		filePath: docsIndexRoute,
@@ -3104,6 +3296,7 @@ function scaffoldTanstackStart(cwd, cfg, globalCssRelPath, write, skipped, writt
 		projectName: cfg.projectName
 	}));
 	write(apiRoute, tanstackApiDocsRouteTemplate(cfg.useAlias, apiRoute));
+	write(publicRoute, tanstackDocsPublicRouteTemplate(cfg.useAlias, publicRoute, cfg.entry));
 	if (cfg.apiReference) {
 		const apiReferenceIndexRoute = `src/routes/${cfg.apiReference.path}.index.ts`;
 		const apiReferenceCatchAllRoute = `src/routes/${cfg.apiReference.path}.$.ts`;
@@ -3168,6 +3361,18 @@ function scaffoldSvelteKit(cwd, cfg, globalCssRelPath, write, skipped, written)
 	write(`src/routes/${cfg.entry}/+layout.server.js`, svelteDocsLayoutServerTemplate(cfg));
 	write(`src/routes/${cfg.entry}/[...slug]/+page.svelte`, svelteDocsPageTemplate(cfg));
 	if (cfg.i18n?.locales.length) write(`src/routes/${cfg.entry}/+page.svelte`, svelteDocsPageTemplate(cfg));
+	const apiDocsRoute = "src/routes/api/docs/+server.ts";
+	const publicHook = "src/hooks.server.ts";
+	write(apiDocsRoute, svelteDocsApiRouteTemplate(apiDocsRoute, cfg.useAlias));
+	const publicHookPath = path.join(cwd, publicHook);
+	const existingPublicHook = readFileSafe(publicHookPath);
+	if (existingPublicHook) {
+		const injected = injectSvelteDocsPublicHook(existingPublicHook, publicHook, cfg.useAlias);
+		if (injected) {
+			writeFileSafe(publicHookPath, injected, true);
+			written.push(`${publicHook} (composed docs public hook)`);
+		} else skipped.push(`${publicHook} (already configured or could not compose docs public hook)`);
+	} else write(publicHook, svelteDocsPublicHookTemplate(publicHook, cfg.useAlias));
 	if (cfg.apiReference) {
 		const apiReferenceIndexRoute = `src/routes/${cfg.apiReference.path}/+server.ts`;
 		const apiReferenceCatchAllRoute = `src/routes/${cfg.apiReference.path}/[...slug]/+server.ts`;
@@ -3215,6 +3420,16 @@ function scaffoldAstro(cwd, cfg, globalCssRelPath, write, skipped, written) {
 	write(`src/pages/${cfg.entry}/index.astro`, astroDocsIndexTemplate(cfg));
 	write(`src/pages/${cfg.entry}/[...slug].astro`, astroDocsPageTemplate(cfg));
 	write(`src/pages/api/${cfg.entry}.ts`, astroApiRouteTemplate(cfg));
+	const middleware = "src/middleware.ts";
+	const middlewarePath = path.join(cwd, middleware);
+	const existingMiddleware = readFileSafe(middlewarePath);
+	if (existingMiddleware) {
+		const injected = injectAstroDocsMiddleware(existingMiddleware, middleware, cfg.useAlias);
+		if (injected) {
+			writeFileSafe(middlewarePath, injected, true);
+			written.push(`${middleware} (composed docs public middleware)`);
+		} else skipped.push(`${middleware} (already configured or could not compose docs public middleware)`);
+	} else write(middleware, astroDocsMiddlewareTemplate(middleware, cfg.useAlias));
 	if (cfg.apiReference) {
 		const apiReferenceIndexRoute = `src/pages/${cfg.apiReference.path}/index.ts`;
 		const apiReferenceCatchAllRoute = `src/pages/${cfg.apiReference.path}/[...slug].ts`;
@@ -3256,10 +3471,8 @@ function scaffoldNuxt(cwd, cfg, globalCssRelPath, write, skipped, written) {
 		write(`themes/${baseName}.css`, customThemeCssTemplate(baseName));
 	}
 	write("docs.config.ts", nuxtDocsConfigTemplate(cfg));
-	write("server/utils/docs-server.ts", nuxtDocsServerTemplate(cfg));
-	write("server/api/docs.get.ts", nuxtServerApiDocsGetTemplate());
-	write("server/api/docs.post.ts", nuxtServerApiDocsPostTemplate());
-	write("server/api/docs/load.get.ts", nuxtServerApiDocsLoadTemplate());
+	write("server/api/docs.ts", nuxtServerApiDocsRouteTemplate(cfg));
+	write("server/middleware/docs-public.ts", nuxtServerDocsPublicMiddlewareTemplate(cfg));
 	write(`pages/${cfg.entry}/[[...slug]].vue`, nuxtDocsPageTemplate(cfg));
 	if (cfg.apiReference) {
 		const apiReferenceIndexRoute = `server/routes/${cfg.apiReference.path}/index.ts`;

package/dist/mcp.d.mts

@@ -1,4 +1,4 @@
-import { E as DocsSearchConfig, W as OrderingItem, v as DocsMcpConfig } from "./types-CP8OcVgL.mjs";
+import { D as DocsSearchConfig, G as OrderingItem, N as DocsSearchSourcePage, v as DocsMcpConfig } from "./types-CP2NmW5c.mjs";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 
 //#region src/mcp.d.ts
@@ -7,6 +7,7 @@ interface DocsMcpPage {
   url: string;
   title: string;
   description?: string;
+  related?: DocsSearchSourcePage["related"];
   icon?: string;
   content: string;
   rawContent?: string;

package/dist/mcp.mjs

@@ -1,4 +1,4 @@
-import { s as performDocsSearch } from "./search-BS6C5N1i.mjs";
+import { l as normalizeDocsRelated, s as performDocsSearch, u as renderDocsRelatedMarkdownLines } from "./search-CfnJVeh-.mjs";
 import fs from "node:fs";
 import path from "node:path";
 import { randomUUID } from "node:crypto";
@@ -330,6 +330,7 @@ function scanFilesystemDocsPages(contentDirAbs, entry) {
 				url,
 				title,
 				description: data.description,
+				relatedInput: data.related,
 				icon: data.icon,
 				content: stripMarkdownForMcp(humanRawContent),
 				rawContent: humanRawContent,
@@ -341,7 +342,7 @@ function scanFilesystemDocsPages(contentDirAbs, entry) {
 		}
 	}
 	scan(contentDirAbs, []);
-	return pages;
+	return resolveRelatedForMcpPages(pages);
 }
 function readFilesystemAgentDoc(dir) {
 	const agentPath = path.join(dir, "agent.md");
@@ -352,6 +353,15 @@ function readFilesystemAgentDoc(dir) {
 		agentRawContent: content
 	};
 }
+function resolveRelatedForMcpPages(pages) {
+	return pages.map(({ relatedInput, ...page }) => {
+		const related = normalizeDocsRelated(relatedInput);
+		return related.length > 0 ? {
+			...page,
+			related
+		} : page;
+	});
+}
 function buildNavigationTreeFromPages(pages, siteTitle, ordering) {
 	const bySlug = new Map(pages.map((page) => [page.slug, page]));
 	const rootPage = bySlug.get("");
@@ -465,7 +475,8 @@ function toSearchSourcePages(pages) {
 		agentRawContent: page.agentRawContent,
 		agentFallbackContent: page.agentFallbackContent,
 		agentFallbackRawContent: page.agentFallbackRawContent,
-		description: page.description
+		description: page.description,
+		related: page.related
 	}));
 }
 function isSelfMcpSearchEndpoint(search, route) {
@@ -522,8 +533,10 @@ function normalizeUrlPath(value) {
 }
 function renderPageDocument(page) {
 	if (page.agentRawContent !== void 0) return page.agentRawContent;
+	const relatedLines = renderDocsRelatedMarkdownLines(page.related);
 	const lines = [`# ${page.title}`, `URL: ${page.url}`];
 	if (page.description) lines.push(`Description: ${page.description}`);
+	lines.push(...relatedLines);
 	lines.push("", page.agentFallbackRawContent ?? page.rawContent ?? page.content);
 	return lines.join("\n");
 }

package/dist/{search-zClNrbqL.d.mts → search-BWqFW9rt.d.mts}

@@ -1,4 +1,4 @@
-import { A as DocsSearchResult, D as DocsSearchDocument, E as DocsSearchConfig, M as DocsSearchSourcePage, S as DocsSearchAdapter, T as DocsSearchChunkingConfig, d as CustomDocsSearchConfig, r as AlgoliaDocsSearchConfig, rt as TypesenseDocsSearchConfig, w as DocsSearchAdapterFactory, z as McpDocsSearchConfig } from "./types-CP8OcVgL.mjs";
+import { B as McpDocsSearchConfig, C as DocsSearchAdapter, D as DocsSearchConfig, E as DocsSearchChunkingConfig, N as DocsSearchSourcePage, O as DocsSearchDocument, T as DocsSearchAdapterFactory, at as TypesenseDocsSearchConfig, d as CustomDocsSearchConfig, j as DocsSearchResult, r as AlgoliaDocsSearchConfig } from "./types-CP2NmW5c.mjs";
 
 //#region src/search.d.ts
 declare function buildDocsSearchDocuments(pages: DocsSearchSourcePage[], chunking?: DocsSearchChunkingConfig): DocsSearchDocument[];

package/dist/{search-CLaNOUrd.mjs → search-CNesqs89.mjs}

@@ -1,4 +1,4 @@
-import { n as createAlgoliaSearchAdapter, o as createTypesenseSearchAdapter, t as buildDocsSearchDocuments } from "./search-BS6C5N1i.mjs";
+import { n as createAlgoliaSearchAdapter, o as createTypesenseSearchAdapter, t as buildDocsSearchDocuments } from "./search-CfnJVeh-.mjs";
 import "./api-reference-BQ16eRPP.mjs";
 import { createFilesystemDocsMcpSource } from "./mcp.mjs";
 import "./server.mjs";

package/dist/{search-BS6C5N1i.mjs → search-CfnJVeh-.mjs}

@@ -1,3 +1,52 @@
+//#region src/related.ts
+function normalizeDocsRelated(value) {
+	if (!Array.isArray(value)) return [];
+	const seen = /* @__PURE__ */ new Set();
+	const links = [];
+	for (const item of value) {
+		const parsed = parseRelatedInput(item);
+		if (!parsed) continue;
+		const dedupeKey = normalizeRelatedLookupPath(parsed.href) ?? parsed.href;
+		if (seen.has(dedupeKey)) continue;
+		seen.add(dedupeKey);
+		links.push({ href: parsed.href });
+	}
+	return links;
+}
+function renderDocsRelatedMarkdownLines(related) {
+	if (!related?.length) return [];
+	return [`Related: ${related.map((link) => normalizeInlineText(link.href)).join(", ")}`];
+}
+function parseRelatedInput(value) {
+	if (typeof value === "string") {
+		const href = cleanString(value);
+		return href ? { href } : null;
+	}
+	return null;
+}
+function cleanString(value) {
+	if (typeof value !== "string") return void 0;
+	return value.trim() || void 0;
+}
+function normalizeRelatedLookupPath(value) {
+	const trimmed = value.trim();
+	if (!trimmed) return null;
+	let pathname = trimmed;
+	try {
+		pathname = new URL(trimmed, "https://docs.local").pathname;
+	} catch {
+		pathname = trimmed.split(/[?#]/, 1)[0] ?? trimmed;
+	}
+	pathname = pathname.replace(/\/+/g, "/").replace(/\.md$/i, "");
+	if (!pathname.startsWith("/")) pathname = `/${pathname}`;
+	if (pathname !== "/") pathname = pathname.replace(/\/+$/, "");
+	return pathname;
+}
+function normalizeInlineText(value) {
+	return value.replace(/\s+/g, " ").trim();
+}
+
+//#endregion
 //#region src/search.ts
 const DEFAULT_SEARCH_LIMIT = 10;
 const DEFAULT_MCP_PROTOCOL_VERSION = "2025-11-25";
@@ -668,4 +717,4 @@ function createCustomSearchAdapter(adapter) {
 }
 
 //#endregion
-export { createSimpleSearchAdapter as a, resolveSearchRequestConfig as c, createMcpSearchAdapter as i, createAlgoliaSearchAdapter as n, createTypesenseSearchAdapter as o, createCustomSearchAdapter as r, performDocsSearch as s, buildDocsSearchDocuments as t };
+export { createSimpleSearchAdapter as a, resolveSearchRequestConfig as c, createMcpSearchAdapter as i, normalizeDocsRelated as l, createAlgoliaSearchAdapter as n, createTypesenseSearchAdapter as o, createCustomSearchAdapter as r, performDocsSearch as s, buildDocsSearchDocuments as t, renderDocsRelatedMarkdownLines as u };

package/dist/server.d.mts

@@ -1,6 +1,6 @@
-import { A as DocsSearchResult, C as DocsSearchAdapterContext, D as DocsSearchDocument, E as DocsSearchConfig, M as DocsSearchSourcePage, S as DocsSearchAdapter, a as ApiReferenceRenderer, k as DocsSearchQuery, m as DocsConfig, w as DocsSearchAdapterFactory, z as McpDocsSearchConfig } from "./types-CP8OcVgL.mjs";
-import { a as createSimpleSearchAdapter, c as resolveSearchRequestConfig, i as createMcpSearchAdapter, n as createAlgoliaSearchAdapter, o as createTypesenseSearchAdapter, r as createCustomSearchAdapter, s as performDocsSearch, t as buildDocsSearchDocuments } from "./search-zClNrbqL.mjs";
+import { A as DocsSearchQuery, B as McpDocsSearchConfig, C as DocsSearchAdapter, D as DocsSearchConfig, N as DocsSearchSourcePage, O as DocsSearchDocument, T as DocsSearchAdapterFactory, a as ApiReferenceRenderer, j as DocsSearchResult, m as DocsConfig, w as DocsSearchAdapterContext } from "./types-CP2NmW5c.mjs";
 import { DocsMcpHttpHandlers, DocsMcpNavigationNode, DocsMcpNavigationTree, DocsMcpPage, DocsMcpResolvedConfig, DocsMcpSource, createDocsMcpHttpHandler, createDocsMcpServer, createFilesystemDocsMcpSource, normalizeDocsMcpRoute, resolveDocsMcpConfig, runDocsMcpStdio } from "./mcp.mjs";
+import { a as createSimpleSearchAdapter, c as resolveSearchRequestConfig, i as createMcpSearchAdapter, n as createAlgoliaSearchAdapter, o as createTypesenseSearchAdapter, r as createCustomSearchAdapter, s as performDocsSearch, t as buildDocsSearchDocuments } from "./search-BWqFW9rt.mjs";
 
 //#region src/api-reference.d.ts
 type HttpMethod = "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "OPTIONS" | "HEAD";

package/dist/server.mjs

@@ -1,4 +1,4 @@
-import { a as createSimpleSearchAdapter, c as resolveSearchRequestConfig, i as createMcpSearchAdapter, n as createAlgoliaSearchAdapter, o as createTypesenseSearchAdapter, r as createCustomSearchAdapter, s as performDocsSearch, t as buildDocsSearchDocuments } from "./search-BS6C5N1i.mjs";
+import { a as createSimpleSearchAdapter, c as resolveSearchRequestConfig, i as createMcpSearchAdapter, n as createAlgoliaSearchAdapter, o as createTypesenseSearchAdapter, r as createCustomSearchAdapter, s as performDocsSearch, t as buildDocsSearchDocuments } from "./search-CfnJVeh-.mjs";
 import { a as buildApiReferencePageTitle, c as resolveApiReferenceRenderer, i as buildApiReferenceOpenApiDocumentAsync, n as buildApiReferenceHtmlDocumentAsync, o as buildApiReferenceScalarCss, r as buildApiReferenceOpenApiDocument, s as resolveApiReferenceConfig, t as buildApiReferenceHtmlDocument } from "./api-reference-BQ16eRPP.mjs";
 import { createDocsMcpHttpHandler, createDocsMcpServer, createFilesystemDocsMcpSource, normalizeDocsMcpRoute, resolveDocsMcpConfig, runDocsMcpStdio } from "./mcp.mjs";
 

package/dist/{types-CP8OcVgL.d.mts → types-CP2NmW5c.d.mts}

@@ -242,9 +242,15 @@ interface PageTwitter {
   title?: string;
   description?: string;
 }
+type DocsRelatedItem = string;
+interface ResolvedDocsRelatedLink {
+  href: string;
+}
 interface PageFrontmatter {
   title: string;
   description?: string;
+  /** Related doc URLs rendered into machine-readable markdown routes and MCP page output. */
+  related?: DocsRelatedItem[];
   tags?: string[];
   icon?: string;
   /** Path to custom OG image for this page (shorthand). Ignored if `openGraph` is set. */
@@ -590,7 +596,7 @@ interface DocsMcpToolsConfig {
  * Built-in MCP server configuration.
  *
  * When enabled, adapters can expose a Streamable HTTP endpoint for your docs
- * at `/mcp` and `/.well-known/mcp` in Next.js, backed by the canonical `/api/docs/mcp` route.
+ * at `/mcp` and `/.well-known/mcp`, backed by the canonical `/api/docs/mcp` route.
  * The same config is also reused by the local `docs mcp` stdio command.
  */
 interface DocsMcpConfig {
@@ -598,7 +604,7 @@ interface DocsMcpConfig {
   enabled?: boolean;
   /**
    * Streamable HTTP route for the MCP endpoint.
-   * Defaults to `/api/docs/mcp`; Next.js also exposes it publicly at `/mcp` and `/.well-known/mcp`.
+   * Defaults to `/api/docs/mcp`; generated projects can also expose it publicly at `/mcp` and `/.well-known/mcp`.
    */
   route?: string;
   /**
@@ -620,6 +626,7 @@ interface DocsSearchSourcePage {
   url: string;
   content: string;
   description?: string;
+  related?: ResolvedDocsRelatedLink[];
   rawContent?: string;
   agentContent?: string;
   agentRawContent?: string;
@@ -1592,8 +1599,8 @@ interface DocsConfig {
   /**
    * Built-in MCP server for agent/assistant access to your docs content.
    *
-   * - omitted → enable the default MCP surface at `/mcp` and `/.well-known/mcp` in Next.js, backed by `/api/docs/mcp`
-   * - `true` → enable the default MCP surface at `/mcp` and `/.well-known/mcp` in Next.js, backed by `/api/docs/mcp`
+   * - omitted → enable the default MCP surface at `/mcp` and `/.well-known/mcp`, backed by `/api/docs/mcp`
+   * - `true` → enable the default MCP surface at `/mcp` and `/.well-known/mcp`, backed by `/api/docs/mcp`
    * - `{ route: "/api/docs/mcp" }` → enable with explicit route/config
    * - `false` or `{ enabled: false }` → disable MCP explicitly
    */
@@ -1811,4 +1818,4 @@ interface DocsConfig {
   og?: OGConfig;
 }
 //#endregion
-export { SidebarPageNode as $, DocsSearchResult as A, OGConfig as B, DocsSearchAdapterContext as C, DocsSearchDocument as D, DocsSearchConfig as E, FontStyle as F, PageActionsConfig as G, OpenDocsProvider as H, GithubConfig as I, PageTwitter as J, PageFrontmatter as K, LastUpdatedConfig as L, DocsSearchSourcePage as M, DocsTheme as N, DocsSearchEmbeddingsConfig as O, FeedbackConfig as P, SidebarNode as Q, LlmsTxtConfig as R, DocsSearchAdapter as S, DocsSearchChunkingConfig as T, OpenGraphImage as U, OpenDocsConfig as V, OrderingItem as W, SidebarConfig as X, SidebarComponentProps as Y, SidebarFolderNode as Z, DocsI18nConfig as _, ApiReferenceRenderer as a, UIConfig as at, DocsMetadata as b, ChangelogFrontmatter as c, CustomDocsSearchConfig as d, SidebarTree as et, DocsAgentFeedbackContext as f, DocsFeedbackValue as g, DocsFeedbackData as h, ApiReferenceConfig as i, TypographyConfig as it, DocsSearchResultType as j, DocsSearchQuery as k, CodeBlockCopyData as l, DocsConfig as m, AgentFeedbackConfig as n, ThemeToggleConfig as nt, BreadcrumbConfig as o, DocsAgentFeedbackData as p, PageOpenGraph as q, AlgoliaDocsSearchConfig as r, TypesenseDocsSearchConfig as rt, ChangelogConfig as s, AIConfig as t, SimpleDocsSearchConfig as tt, CopyMarkdownConfig as u, DocsMcpConfig as v, DocsSearchAdapterFactory as w, DocsNav as x, DocsMcpToolsConfig as y, McpDocsSearchConfig as z };
+export { SidebarFolderNode as $, DocsSearchQuery as A, McpDocsSearchConfig as B, DocsSearchAdapter as C, DocsSearchConfig as D, DocsSearchChunkingConfig as E, FeedbackConfig as F, OrderingItem as G, OpenDocsConfig as H, FontStyle as I, PageOpenGraph as J, PageActionsConfig as K, GithubConfig as L, DocsSearchResultType as M, DocsSearchSourcePage as N, DocsSearchDocument as O, DocsTheme as P, SidebarConfig as Q, LastUpdatedConfig as R, DocsRelatedItem as S, DocsSearchAdapterFactory as T, OpenDocsProvider as U, OGConfig as V, OpenGraphImage as W, ResolvedDocsRelatedLink as X, PageTwitter as Y, SidebarComponentProps as Z, DocsI18nConfig as _, ApiReferenceRenderer as a, TypesenseDocsSearchConfig as at, DocsMetadata as b, ChangelogFrontmatter as c, CustomDocsSearchConfig as d, SidebarNode as et, DocsAgentFeedbackContext as f, DocsFeedbackValue as g, DocsFeedbackData as h, ApiReferenceConfig as i, ThemeToggleConfig as it, DocsSearchResult as j, DocsSearchEmbeddingsConfig as k, CodeBlockCopyData as l, DocsConfig as m, AgentFeedbackConfig as n, SidebarTree as nt, BreadcrumbConfig as o, TypographyConfig as ot, DocsAgentFeedbackData as p, PageFrontmatter as q, AlgoliaDocsSearchConfig as r, SimpleDocsSearchConfig as rt, ChangelogConfig as s, UIConfig as st, AIConfig as t, SidebarPageNode as tt, CopyMarkdownConfig as u, DocsMcpConfig as v, DocsSearchAdapterContext as w, DocsNav as x, DocsMcpToolsConfig as y, LlmsTxtConfig as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@farming-labs/docs",
-  "version": "0.1.35",
+  "version": "0.1.37",
   "description": "Modern, flexible MDX-based docs framework — core types, config, and CLI",
   "keywords": [
     "docs",