@farming-labs/docs 0.1.36 → 0.1.37

package/dist/cli/index.mjs

@@ -69,7 +69,7 @@ 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");

package/dist/index.d.mts

@@ -1,5 +1,6 @@
-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-ByCOEOnE.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-HA-ofcyh.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
 /**
@@ -119,4 +120,179 @@ declare function buildPageTwitter(page: Pick<PageFrontmatter, "title" | "descrip
 declare function normalizeDocsRelated(value: unknown): ResolvedDocsRelatedLink[];
 declare function renderDocsRelatedMarkdownLines(related: ResolvedDocsRelatedLink[] | undefined): string[];
 //#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 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, buildDocsSearchDocuments, buildPageOpenGraph, buildPageTwitter, createAlgoliaSearchAdapter, createCustomSearchAdapter, createMcpSearchAdapter, createSimpleSearchAdapter, createTheme, createTypesenseSearchAdapter, deepMerge, defineDocs, extendTheme, normalizeDocsRelated, performDocsSearch, renderDocsRelatedMarkdownLines, resolveChangelogConfig, resolveDocsI18n, resolveDocsLocale, resolveDocsPath, resolveOGImage, resolveSearchRequestConfig, resolveTitle };
+//#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

@@ -266,4 +266,262 @@ function buildPageTwitter(page, ogConfig, baseUrl) {
 }
 
 //#endregion
-export { buildDocsSearchDocuments, buildPageOpenGraph, buildPageTwitter, createAlgoliaSearchAdapter, createCustomSearchAdapter, createMcpSearchAdapter, createSimpleSearchAdapter, createTheme, createTypesenseSearchAdapter, deepMerge, defineDocs, extendTheme, normalizeDocsRelated, performDocsSearch, renderDocsRelatedMarkdownLines, 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 { D as DocsSearchConfig, G as OrderingItem, N as DocsSearchSourcePage, v as DocsMcpConfig } from "./types-ByCOEOnE.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

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

@@ -1,4 +1,4 @@
-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-ByCOEOnE.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/server.d.mts

@@ -1,6 +1,6 @@
-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-ByCOEOnE.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-HA-ofcyh.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/{types-ByCOEOnE.d.mts → types-CP2NmW5c.d.mts}

@@ -596,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 {
@@ -604,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;
   /**
@@ -1599,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
    */

package/package.json

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