@farming-labs/theme 0.1.90 → 0.1.93

package/dist/docs-api.mjs

@@ -935,10 +935,11 @@ function resolveMarkdownRequest(entry, url, request) {
 	}
 	return null;
 }
-function renderMarkdownDocument(page) {
+function renderMarkdownDocument(page, options = {}) {
 	if ("agentRawContent" in page && page.agentRawContent !== void 0) return page.agentRawContent;
 	const relatedLines = renderDocsRelatedMarkdownLines(page.related);
 	const lines = [`# ${page.title}`, `URL: ${page.url}`];
+	if (options.llmsEnabled !== false) lines.push("LLM index: /llms.txt");
 	if (page.description) lines.push(`Description: ${page.description}`);
 	lines.push(...relatedLines);
 	lines.push("", page.agentFallbackRawContent ?? page.rawContent ?? page.content);
@@ -1735,11 +1736,11 @@ function createDocsAPI(options) {
 		for (const docsDir of ctx.docsDirs) if (isHiddenFolderIndexPageDir(relativeSlug ? path.join(docsDir, ...relativeSlug.split("/")) : docsDir)) return null;
 		for (const source of getMarkdownSources(ctx)) {
 			const page = findDocsMcpPage(ctx.entryPath, await source.getPages(), requestedPath);
-			if (page) return renderMarkdownDocument(page);
+			if (page) return renderMarkdownDocument(page, { llmsEnabled: llmsConfig.enabled });
 		}
 		const fallbackPage = getIndexes(ctx).find((page) => normalizeUrlPath(page.url) === normalizedRequest);
-		if (fallbackPage) return renderMarkdownDocument(fallbackPage);
-		for (const page of getIndexes(ctx)) if (normalizePathSegment(page.url.replace(/^\/+/, "").replace(`${ctx.entryPath}/`, "")) === normalizePathSegment(requestedPath.replace(/^\/+/, "").replace(/\.md$/i, ""))) return renderMarkdownDocument(page);
+		if (fallbackPage) return renderMarkdownDocument(fallbackPage, { llmsEnabled: llmsConfig.enabled });
+		for (const page of getIndexes(ctx)) if (normalizePathSegment(page.url.replace(/^\/+/, "").replace(`${ctx.entryPath}/`, "")) === normalizePathSegment(requestedPath.replace(/^\/+/, "").replace(/\.md$/i, ""))) return renderMarkdownDocument(page, { llmsEnabled: llmsConfig.enabled });
 		return null;
 	}
 	function getLlmsContent(ctx) {

package/dist/docs-page-client.mjs

@@ -13,6 +13,17 @@ import { usePathname, useRouter } from "fumadocs-core/framework";
 import { Fragment as Fragment$1, jsx, jsxs } from "react/jsx-runtime";
 
 //#region src/docs-page-client.tsx
+const agentLlmsDirectiveStyle = {
+	position: "absolute",
+	width: 1,
+	height: 1,
+	padding: 0,
+	margin: -1,
+	overflow: "hidden",
+	clip: "rect(0, 0, 0, 0)",
+	whiteSpace: "nowrap",
+	border: 0
+};
 /**
 * Path-based breadcrumb that shows only parent / current folder.
 * Skips the entry segment (e.g. "docs"). Parent is clickable.
@@ -343,97 +354,108 @@ function DocsPageClient({ tocEnabled, tocStyle = "default", breadcrumbEnabled =
 		belowTitle: belowTitleBlock
 	}), titlePortalHost) : null;
 	const renderedChildren = Children.toArray(decoratedChildren);
-	return /* @__PURE__ */ jsxs(Fragment$1, { children: [structuredDataJson && /* @__PURE__ */ jsx("script", {
-		type: "application/ld+json",
-		dangerouslySetInnerHTML: { __html: escapeJsonLdForScript(structuredDataJson) }
-	}), /* @__PURE__ */ jsxs(DocsPage, {
-		full: false,
-		toc,
-		tableOfContent: {
-			enabled: effectiveTocEnabled,
-			style: fdTocStyle
-		},
-		tableOfContentPopover: {
-			enabled: effectiveTocEnabled,
-			style: fdTocStyle
-		},
-		breadcrumb: { enabled: false },
-		footer: { enabled: !isChangelogRoute },
-		children: [
-			effectiveBreadcrumbEnabled && /* @__PURE__ */ jsx(PathBreadcrumb, {
-				pathname,
-				entry,
-				locale: activeLocale
-			}),
-			showActionsAboveTitle && /* @__PURE__ */ jsxs("div", {
-				className: "fd-below-title-block not-prose",
-				children: [/* @__PURE__ */ jsx("div", {
-					className: "fd-actions-portal",
-					"data-actions-alignment": pageActionsAlignment,
-					children: /* @__PURE__ */ jsx(PageActions, {
-						copyMarkdown,
-						openDocs,
-						providers: openDocsProviders,
-						alignment: pageActionsAlignment,
-						githubFileUrl,
-						analytics
-					})
-				}), readingTimeBlock]
-			}),
-			!showReadingTimeAboveTitle && !showReadingTimeBelowTitle ? readingTimeBlock : null,
-			/* @__PURE__ */ jsxs(DocsBody, {
-				style: {
-					display: "flex",
-					flexDirection: "column"
-				},
-				children: [
-					/* @__PURE__ */ jsx("div", {
-						style: { flex: 1 },
-						children: renderedChildren
-					}),
-					titleDecorationsPortal,
-					!isChangelogRoute && feedbackEnabled && /* @__PURE__ */ jsx(DocsFeedback, {
-						pathname: normalizedPath,
-						entry,
-						locale: activeLocale,
-						question: feedbackQuestion,
-						placeholder: feedbackPlaceholder,
-						positiveLabel: feedbackPositiveLabel,
-						negativeLabel: feedbackNegativeLabel,
-						submitLabel: feedbackSubmitLabel,
-						onFeedback: feedbackOnFeedback,
-						analytics
-					}),
-					showFooter && /* @__PURE__ */ jsxs("div", {
-						className: "not-prose fd-page-footer",
-						children: [
-							githubFileUrl && /* @__PURE__ */ jsx(EditOnGitHub, { href: githubFileUrl }),
-							llmsTxtEnabled && /* @__PURE__ */ jsxs("span", {
-								className: "fd-llms-txt-links",
-								children: [/* @__PURE__ */ jsx("a", {
-									href: `/llms.txt${llmsLangQuery}`,
-									target: "_blank",
-									rel: "noopener noreferrer",
-									className: "fd-llms-txt-link",
-									children: "llms.txt"
-								}), /* @__PURE__ */ jsx("a", {
-									href: `/llms-full.txt${llmsLangQuery}`,
-									target: "_blank",
-									rel: "noopener noreferrer",
-									className: "fd-llms-txt-link",
-									children: "llms-full.txt"
-								})]
-							}),
-							showLastUpdatedInFooter && lastModified && /* @__PURE__ */ jsxs("span", {
-								className: "fd-last-updated-footer",
-								children: ["Last updated ", lastModified]
-							})
-						]
-					})
-				]
-			})
-		]
-	})] });
+	return /* @__PURE__ */ jsxs(Fragment$1, { children: [
+		structuredDataJson && /* @__PURE__ */ jsx("script", {
+			type: "application/ld+json",
+			dangerouslySetInnerHTML: { __html: escapeJsonLdForScript(structuredDataJson) }
+		}),
+		llmsTxtEnabled && /* @__PURE__ */ jsx("a", {
+			href: `/llms.txt${llmsLangQuery}`,
+			className: "fd-agent-llms-directive",
+			style: agentLlmsDirectiveStyle,
+			tabIndex: -1,
+			"aria-hidden": "true",
+			children: "llms.txt"
+		}),
+		/* @__PURE__ */ jsxs(DocsPage, {
+			full: false,
+			toc,
+			tableOfContent: {
+				enabled: effectiveTocEnabled,
+				style: fdTocStyle
+			},
+			tableOfContentPopover: {
+				enabled: effectiveTocEnabled,
+				style: fdTocStyle
+			},
+			breadcrumb: { enabled: false },
+			footer: { enabled: !isChangelogRoute },
+			children: [
+				effectiveBreadcrumbEnabled && /* @__PURE__ */ jsx(PathBreadcrumb, {
+					pathname,
+					entry,
+					locale: activeLocale
+				}),
+				showActionsAboveTitle && /* @__PURE__ */ jsxs("div", {
+					className: "fd-below-title-block not-prose",
+					children: [/* @__PURE__ */ jsx("div", {
+						className: "fd-actions-portal",
+						"data-actions-alignment": pageActionsAlignment,
+						children: /* @__PURE__ */ jsx(PageActions, {
+							copyMarkdown,
+							openDocs,
+							providers: openDocsProviders,
+							alignment: pageActionsAlignment,
+							githubFileUrl,
+							analytics
+						})
+					}), readingTimeBlock]
+				}),
+				!showReadingTimeAboveTitle && !showReadingTimeBelowTitle ? readingTimeBlock : null,
+				/* @__PURE__ */ jsxs(DocsBody, {
+					style: {
+						display: "flex",
+						flexDirection: "column"
+					},
+					children: [
+						/* @__PURE__ */ jsx("div", {
+							style: { flex: 1 },
+							children: renderedChildren
+						}),
+						titleDecorationsPortal,
+						!isChangelogRoute && feedbackEnabled && /* @__PURE__ */ jsx(DocsFeedback, {
+							pathname: normalizedPath,
+							entry,
+							locale: activeLocale,
+							question: feedbackQuestion,
+							placeholder: feedbackPlaceholder,
+							positiveLabel: feedbackPositiveLabel,
+							negativeLabel: feedbackNegativeLabel,
+							submitLabel: feedbackSubmitLabel,
+							onFeedback: feedbackOnFeedback,
+							analytics
+						}),
+						showFooter && /* @__PURE__ */ jsxs("div", {
+							className: "not-prose fd-page-footer",
+							children: [
+								githubFileUrl && /* @__PURE__ */ jsx(EditOnGitHub, { href: githubFileUrl }),
+								llmsTxtEnabled && /* @__PURE__ */ jsxs("span", {
+									className: "fd-llms-txt-links",
+									children: [/* @__PURE__ */ jsx("a", {
+										href: `/llms.txt${llmsLangQuery}`,
+										target: "_blank",
+										rel: "noopener noreferrer",
+										className: "fd-llms-txt-link",
+										children: "llms.txt"
+									}), /* @__PURE__ */ jsx("a", {
+										href: `/llms-full.txt${llmsLangQuery}`,
+										target: "_blank",
+										rel: "noopener noreferrer",
+										className: "fd-llms-txt-link",
+										children: "llms-full.txt"
+									})]
+								}),
+								showLastUpdatedInFooter && lastModified && /* @__PURE__ */ jsxs("span", {
+									className: "fd-last-updated-footer",
+									children: ["Last updated ", lastModified]
+								})
+							]
+						})
+					]
+				})
+			]
+		})
+	] });
 }
 
 //#endregion

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@farming-labs/theme",
-  "version": "0.1.90",
+  "version": "0.1.93",
   "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.90"
+    "@farming-labs/docs": "0.1.93"
   },
   "peerDependencies": {
     "@farming-labs/docs": ">=0.0.1",