@farming-labs/theme 0.1.85 → 0.1.88

package/dist/docs-api.d.mts

@@ -54,6 +54,8 @@ interface DocsAPIOptions {
   feedback?: boolean | FeedbackConfig;
   /** MCP configuration used for the agent discovery spec. */
   mcp?: boolean | DocsMcpConfig;
+  /** llms.txt configuration. Enabled by default; set false to opt out. */
+  llmsTxt?: boolean | LlmsTxtOptions;
   /** Sitemap configuration used for sitemap.xml and sitemap.md. */
   sitemap?: boolean | DocsSitemapConfig;
   /** Robots.txt generation policy used for the agent discovery spec. */
@@ -72,6 +74,12 @@ interface DocsMCPAPIOptions {
   analytics?: boolean | DocsAnalyticsConfig;
   observability?: boolean | DocsObservabilityConfig;
 }
+interface LlmsTxtOptions {
+  enabled?: boolean;
+  siteTitle?: string;
+  siteDescription?: string;
+  baseUrl?: string;
+}
 /**
  * Create a unified docs API route handler.
  *

package/dist/docs-api.mjs

@@ -3,7 +3,7 @@ import { getNextAppDir } from "./get-app-dir.mjs";
 import fs from "node:fs";
 import path from "node:path";
 import matter from "gray-matter";
-import { buildDocsAskAIContext, createDocsAgentTraceContext, createDocsAgentTraceId, createDocsSitemapResponse, emitDocsAgentTraceEvent, emitDocsAnalyticsEvent, formatDocsAskAIPackageHints, getDocsMarkdownVaryHeader, hasDocsMarkdownSignatureAgent, normalizeDocsRelated, performDocsSearch, renderDocsMarkdownNotFound, renderDocsRelatedMarkdownLines, resolveAskAISearchRequestConfig, resolveChangelogConfig, resolveDocsI18n, resolveDocsLocale, resolveDocsSitemapConfig, resolvePageSidebarFolderIndexBehavior, resolveSearchRequestConfig } from "@farming-labs/docs";
+import { buildDocsAskAIContext, createDocsAgentTraceContext, createDocsAgentTraceId, createDocsSitemapResponse, emitDocsAgentTraceEvent, emitDocsAnalyticsEvent, formatDocsAskAIPackageHints, getDocsMarkdownVaryHeader, hasDocsMarkdownSignatureAgent, normalizeDocsRelated, performDocsSearch, renderDocsMarkdownNotFound, renderDocsRelatedMarkdownLines, resolveAskAISearchRequestConfig, resolveChangelogConfig, resolveDocsI18n, resolveDocsLocale, resolveDocsSitemapConfig, resolvePageSidebarFolderIndexBehavior, resolveSearchRequestConfig, toDocsMarkdownUrl } from "@farming-labs/docs";
 import { createDocsMcpHttpHandler, createFilesystemDocsMcpSource, readDocsSitemapManifest, resolveDocsMcpConfig } from "@farming-labs/docs/server";
 
 //#region src/docs-api.ts
@@ -1495,14 +1495,21 @@ function readLlmsTxtConfig(root) {
 		const configPath = path.join(root, `docs.config.${ext}`);
 		if (fs.existsSync(configPath)) try {
 			const content = fs.readFileSync(configPath, "utf-8");
-			if (!content.includes("llmsTxt")) return { enabled: false };
-			if (/llmsTxt\s*:\s*true/.test(content)) return { enabled: true };
+			const navTitleMatch = content.match(/nav\s*:\s*\{[^}]*title\s*:\s*["']([^"']+)["']/s);
+			if (!content.includes("llmsTxt")) return {
+				enabled: true,
+				siteTitle: navTitleMatch?.[1]
+			};
+			if (/llmsTxt\s*:\s*true/.test(content)) return {
+				enabled: true,
+				siteTitle: navTitleMatch?.[1]
+			};
+			if (/llmsTxt\s*:\s*false/.test(content)) return { enabled: false };
 			const enabledMatch = content.match(/llmsTxt\s*:\s*\{[^}]*enabled\s*:\s*(true|false)/s);
 			if (enabledMatch && enabledMatch[1] === "false") return { enabled: false };
 			const baseUrlMatch = content.match(/llmsTxt\s*:\s*\{[^}]*baseUrl\s*:\s*["']([^"']+)["']/s);
 			const siteTitleMatch = content.match(/llmsTxt\s*:\s*\{[^}]*siteTitle\s*:\s*["']([^"']+)["']/s);
 			const siteDescMatch = content.match(/llmsTxt\s*:\s*\{[^}]*siteDescription\s*:\s*["']([^"']+)["']/s);
-			const navTitleMatch = content.match(/nav\s*:\s*\{[^}]*title\s*:\s*["']([^"']+)["']/s);
 			return {
 				enabled: true,
 				baseUrl: baseUrlMatch?.[1],
@@ -1511,7 +1518,19 @@ function readLlmsTxtConfig(root) {
 			};
 		} catch {}
 	}
-	return { enabled: false };
+	return { enabled: true };
+}
+function resolveLlmsTxtConfig(input, fallback) {
+	if (input === void 0) return fallback;
+	if (typeof input === "boolean") return input ? {
+		...fallback,
+		enabled: true
+	} : { enabled: false };
+	return {
+		...fallback,
+		...input,
+		enabled: input.enabled ?? true
+	};
 }
 function readSitemapConfig(root) {
 	for (const ext of FILE_EXTS) {
@@ -1569,7 +1588,7 @@ function generateLlmsTxt(indexes, options) {
 	if (siteDescription) llmsTxt += `> ${siteDescription}\n\n`;
 	llmsTxt += `## Pages\n\n`;
 	for (const page of indexes) {
-		llmsTxt += `- [${page.title}](${baseUrl}${page.url})`;
+		llmsTxt += `- [${page.title}](${baseUrl}${toDocsMarkdownUrl(page.url)})`;
 		if (page.description) llmsTxt += `: ${page.description}`;
 		llmsTxt += `\n`;
 	}
@@ -1622,7 +1641,7 @@ function createDocsAPI(options) {
 	const i18n = resolveDocsI18n(options?.i18n ?? readI18nConfig(root));
 	const aiConfig = options?.ai ?? readAIConfig(root);
 	const searchConfig = options?.search;
-	const llmsConfig = readLlmsTxtConfig(root);
+	const llmsConfig = resolveLlmsTxtConfig(options?.llmsTxt, readLlmsTxtConfig(root));
 	const sitemapConfig = options?.sitemap ?? readSitemapConfig(root);
 	const robotsConfig = options?.robots ?? readRobotsConfig(root);
 	const mcpConfig = resolveDocsMcpConfig(options?.mcp ?? readMcpConfig(root), { defaultName: llmsConfig.siteTitle ?? "Documentation" });
@@ -1903,6 +1922,15 @@ function createDocsAPI(options) {
 				} });
 			}
 			const llmsFormat = resolveLlmsTxtFormat(url);
+			if (llmsFormat === "llms" || llmsFormat === "llms-full") {
+				if (!llmsConfig.enabled) return new Response("Not Found", {
+					status: 404,
+					headers: {
+						"Content-Type": "text/plain; charset=utf-8",
+						"X-Robots-Tag": "noindex"
+					}
+				});
+			}
 			if (llmsFormat === "llms") {
 				await emitDocsAnalyticsEvent(analytics, {
 					type: "llms_request",

package/dist/docs-layout.mjs

@@ -636,7 +636,7 @@ function createDocsLayout(config, options) {
 	const readingTimeOptions = resolveReadingTimeOptions(config.readingTime);
 	const readingTimeEnabledByDefault = readingTimeOptions.enabled;
 	const readingTimeWordsPerMinute = readingTimeOptions.wordsPerMinute ?? 220;
-	const llmsTxtEnabled = resolveBool(config.llmsTxt);
+	const llmsTxtEnabled = resolveEnabledByDefault(config.llmsTxt);
 	const feedbackConfig = resolveFeedbackConfig(config.feedback);
 	const openDocsProviders = (pageActions?.openDocs && typeof pageActions.openDocs === "object" && pageActions.openDocs.providers ? pageActions.openDocs.providers : void 0)?.map((p) => ({
 		name: p.name,
@@ -795,6 +795,11 @@ function resolveBool(v) {
 	if (typeof v === "boolean") return v;
 	return v.enabled !== false;
 }
+function resolveEnabledByDefault(v) {
+	if (v === void 0) return true;
+	if (typeof v === "boolean") return v;
+	return v.enabled !== false;
+}
 function resolveFeedbackConfig(feedback) {
 	const defaults = {
 		enabled: false,

package/dist/tanstack-layout.mjs

@@ -181,6 +181,11 @@ function resolveBool(value) {
 	if (typeof value === "boolean") return value;
 	return value.enabled !== false;
 }
+function resolveEnabledByDefault(value) {
+	if (value === void 0) return true;
+	if (typeof value === "boolean") return value;
+	return value.enabled !== false;
+}
 function resolveFeedbackConfig(feedback) {
 	const defaults = {
 		enabled: false,
@@ -237,7 +242,7 @@ function TanstackDocsLayout({ config, tree, locale, description, readingTime, la
 	const lastUpdatedEnabled = lastUpdatedRaw !== false && (typeof lastUpdatedRaw !== "object" || lastUpdatedRaw.enabled !== false);
 	const lastUpdatedPosition = typeof lastUpdatedRaw === "object" ? lastUpdatedRaw.position ?? "footer" : "footer";
 	const readingTimeEnabled = resolveReadingTimeOptions(config.readingTime).enabled;
-	const llmsTxtEnabled = resolveBool(config.llmsTxt);
+	const llmsTxtEnabled = resolveEnabledByDefault(config.llmsTxt);
 	const feedbackConfig = resolveFeedbackConfig(config.feedback);
 	const staticExport = !!config.staticExport;
 	const openDocsProviders = (pageActions?.openDocs && typeof pageActions.openDocs === "object" && pageActions.openDocs.providers ? pageActions.openDocs.providers : void 0)?.map((provider) => ({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@farming-labs/theme",
-  "version": "0.1.85",
+  "version": "0.1.88",
   "description": "Theme package for @farming-labs/docs — layout, provider, MDX components, and styles",
   "keywords": [
     "docs",
@@ -139,7 +139,7 @@
     "tsdown": "^0.20.3",
     "typescript": "^5.9.3",
     "vitest": "^3.2.4",
-    "@farming-labs/docs": "0.1.85"
+    "@farming-labs/docs": "0.1.88"
   },
   "peerDependencies": {
     "@farming-labs/docs": ">=0.0.1",