@farming-labs/theme 0.1.29 → 0.1.32

package/dist/docs-api.mjs

@@ -34,6 +34,12 @@ const FILE_EXTS = [
 ];
 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_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";
 const DEFAULT_AGENT_FEEDBACK_PAYLOAD_SCHEMA = {
 	type: "object",
@@ -147,7 +153,8 @@ function resolveAgentFeedbackRequest(url, feedback) {
 }
 function resolveAgentSpecRequest(url) {
 	if (url.searchParams.get("agent")?.trim() === "spec") return true;
-	return normalizeUrlPath(url.pathname) === DEFAULT_AGENT_SPEC_ROUTE;
+	const pathname = normalizeUrlPath(url.pathname);
+	return pathname === DEFAULT_AGENT_SPEC_ROUTE || pathname === DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE || pathname === DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE;
 }
 function isSearchEnabled(search) {
 	if (search === false) return false;
@@ -189,10 +196,15 @@ function buildAgentSpec({ origin, entry, i18n, search, mcp, feedback, llms }) {
 		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: "text/markdown",
 			pagePattern: `/${normalizedEntry}/{slug}.md`,
 			rootPage: `/${normalizedEntry}.md`,
 			apiPattern: `${DEFAULT_DOCS_API_ROUTE}?format=markdown&path={slug}`,
@@ -204,8 +216,14 @@ function buildAgentSpec({ origin, entry, i18n, search, mcp, feedback, llms }) {
 		},
 		llms: {
 			enabled: llms.enabled,
+			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`
+			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,
@@ -741,15 +759,39 @@ function findDocsMcpPage(entry, pages, requestedPath) {
 	for (const page of pages) if (normalizePathSegment(page.slug) === normalizedSlug) return page;
 	return null;
 }
-function resolveMarkdownRequest(entry, url) {
+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 resolveMarkdownRequest(entry, url, request) {
 	if (url.searchParams.get("format")?.trim() === "markdown") return { requestedPath: url.searchParams.get("path")?.trim() ?? "" };
 	const pathname = normalizeUrlPath(url.pathname);
 	const normalizedEntry = `/${normalizePathSegment(entry)}`;
 	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 resolveLlmsTxtFormat(url) {
+	const pathname = normalizeUrlPath(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 format === "llms" || format === "llms-full" ? format : null;
+}
 function renderMarkdownDocument(page) {
 	if ("agentRawContent" in page && page.agentRawContent !== void 0) return page.agentRawContent;
 	const lines = [`# ${page.title}`, `URL: ${page.url}`];
@@ -1054,7 +1096,7 @@ function createDocsAPI(options) {
 					"X-Robots-Tag": "noindex"
 				} });
 			}
-			const markdownRequest = resolveMarkdownRequest(entry, url);
+			const markdownRequest = resolveMarkdownRequest(entry, url, request);
 			if (markdownRequest) {
 				const document = await getMarkdownDocument(ctx, markdownRequest.requestedPath);
 				if (!document) return new Response("Not Found", {
@@ -1070,12 +1112,12 @@ function createDocsAPI(options) {
 					"X-Robots-Tag": "noindex"
 				} });
 			}
-			const format = url.searchParams.get("format");
-			if (format === "llms") return new Response(getLlmsContent(ctx).llmsTxt, { headers: {
+			const llmsFormat = resolveLlmsTxtFormat(url);
+			if (llmsFormat === "llms") return new Response(getLlmsContent(ctx).llmsTxt, { headers: {
 				"Content-Type": "text/plain; charset=utf-8",
 				"Cache-Control": "public, max-age=3600"
 			} });
-			if (format === "llms-full") return new Response(getLlmsContent(ctx).llmsFullTxt, { headers: {
+			if (llmsFormat === "llms-full") return new Response(getLlmsContent(ctx).llmsFullTxt, { headers: {
 				"Content-Type": "text/plain; charset=utf-8",
 				"Cache-Control": "public, max-age=3600"
 			} });

package/dist/index.d.mts

@@ -11,9 +11,10 @@ import { DocsFeedback, DocsFeedbackProps } from "./docs-feedback.mjs";
 import { PageActions } from "./page-actions.mjs";
 import { withLangInUrl } from "./i18n.mjs";
 import { HoverLink, HoverLinkProps } from "./hover-link.mjs";
+import { Agent } from "./mdx.mjs";
 import { DocsLayout } from "fumadocs-ui/layouts/docs";
 import { AIConfig, BreadcrumbConfig, ChangelogConfig, ChangelogFrontmatter, CopyMarkdownConfig, DocsConfig, DocsFeedbackData, DocsFeedbackValue, DocsMetadata, DocsNav, DocsTheme, FeedbackConfig, FontStyle, OGConfig, OpenDocsConfig, OpenDocsProvider, PageActionsConfig, PageFrontmatter, SidebarConfig, ThemeToggleConfig, TypographyConfig, UIConfig, createTheme, deepMerge, defineDocs, extendTheme } from "@farming-labs/docs";
 import { DocsBody, DocsPage } from "fumadocs-ui/layouts/docs/page";
 import { Tab, Tabs } from "fumadocs-ui/components/tabs";
 import { CodeBlock, CodeBlockTab, CodeBlockTabs, CodeBlockTabsList, CodeBlockTabsTrigger, Pre } from "fumadocs-ui/components/codeblock";
-export { type AIConfig, type BreadcrumbConfig, type ChangelogConfig, type ChangelogFrontmatter, CodeBlock, CodeBlockTab, CodeBlockTabs, CodeBlockTabsList, CodeBlockTabsTrigger, CommandGridUIDefaults, ConcreteUIDefaults, type CopyMarkdownConfig, DocsBody, DocsClientHooks, DocsCommandSearch, type DocsConfig, DocsFeedback, type DocsFeedbackData, type DocsFeedbackProps, type DocsFeedbackValue, DocsLayout, type DocsMetadata, type DocsNav, DocsPage, DocsPageClient, type DocsTheme, type FeedbackConfig, type FontStyle, DefaultUIDefaults as FumadocsUIDefaults, HardlineUIDefaults, HoverLink, type HoverLinkProps, type OGConfig, type OpenDocsConfig, type OpenDocsProvider, PageActions, type PageActionsConfig, type PageFrontmatter, Pre, RootProvider, type SidebarConfig, Tab, Tabs, type ThemeToggleConfig, type TypographyConfig, type UIConfig, commandGrid, concrete, createDocsLayout, createDocsMetadata, createPageMetadata, createTheme, deepMerge, defineDocs, extendTheme, fumadocs, hardline, withLangInUrl };
+export { type AIConfig, Agent, type BreadcrumbConfig, type ChangelogConfig, type ChangelogFrontmatter, CodeBlock, CodeBlockTab, CodeBlockTabs, CodeBlockTabsList, CodeBlockTabsTrigger, CommandGridUIDefaults, ConcreteUIDefaults, type CopyMarkdownConfig, DocsBody, DocsClientHooks, DocsCommandSearch, type DocsConfig, DocsFeedback, type DocsFeedbackData, type DocsFeedbackProps, type DocsFeedbackValue, DocsLayout, type DocsMetadata, type DocsNav, DocsPage, DocsPageClient, type DocsTheme, type FeedbackConfig, type FontStyle, DefaultUIDefaults as FumadocsUIDefaults, HardlineUIDefaults, HoverLink, type HoverLinkProps, type OGConfig, type OpenDocsConfig, type OpenDocsProvider, PageActions, type PageActionsConfig, type PageFrontmatter, Pre, RootProvider, type SidebarConfig, Tab, Tabs, type ThemeToggleConfig, type TypographyConfig, type UIConfig, commandGrid, concrete, createDocsLayout, createDocsMetadata, createPageMetadata, createTheme, deepMerge, defineDocs, extendTheme, fumadocs, hardline, withLangInUrl };

package/dist/index.mjs

@@ -11,10 +11,11 @@ import { ConcreteUIDefaults, concrete } from "./concrete/index.mjs";
 import { HardlineUIDefaults, hardline } from "./hardline/index.mjs";
 import { DocsClientHooks } from "./docs-client-hooks.mjs";
 import { HoverLink } from "./hover-link.mjs";
+import { Agent } from "./mdx.mjs";
 import { DocsLayout } from "fumadocs-ui/layouts/docs";
 import { createTheme, deepMerge, defineDocs, extendTheme } from "@farming-labs/docs";
 import { DocsBody, DocsPage } from "fumadocs-ui/layouts/docs/page";
 import { Tab, Tabs } from "fumadocs-ui/components/tabs";
 import { CodeBlock, CodeBlockTab, CodeBlockTabs, CodeBlockTabsList, CodeBlockTabsTrigger, Pre } from "fumadocs-ui/components/codeblock";
 
-export { CodeBlock, CodeBlockTab, CodeBlockTabs, CodeBlockTabsList, CodeBlockTabsTrigger, CommandGridUIDefaults, ConcreteUIDefaults, DocsBody, DocsClientHooks, DocsCommandSearch, DocsFeedback, DocsLayout, DocsPage, DocsPageClient, DefaultUIDefaults as FumadocsUIDefaults, HardlineUIDefaults, HoverLink, PageActions, Pre, RootProvider, Tab, Tabs, commandGrid, concrete, createDocsLayout, createDocsMetadata, createPageMetadata, createTheme, deepMerge, defineDocs, extendTheme, fumadocs, hardline, withLangInUrl };
+export { Agent, CodeBlock, CodeBlockTab, CodeBlockTabs, CodeBlockTabsList, CodeBlockTabsTrigger, CommandGridUIDefaults, ConcreteUIDefaults, DocsBody, DocsClientHooks, DocsCommandSearch, DocsFeedback, DocsLayout, DocsPage, DocsPageClient, DefaultUIDefaults as FumadocsUIDefaults, HardlineUIDefaults, HoverLink, PageActions, Pre, RootProvider, Tab, Tabs, commandGrid, concrete, createDocsLayout, createDocsMetadata, createPageMetadata, createTheme, deepMerge, defineDocs, extendTheme, fumadocs, hardline, withLangInUrl };

package/dist/mdx.d.mts

@@ -1,5 +1,5 @@
-import { HoverLink } from "./hover-link.mjs";
 import { MDXImg } from "./mdx-img.mjs";
+import { HoverLink } from "./hover-link.mjs";
 import React from "react";
 import { CodeBlockCopyData, DocsTheme } from "@farming-labs/docs";
 import * as react_jsx_runtime0 from "react/jsx-runtime";

package/dist/mdx.mjs

@@ -1,6 +1,6 @@
-import { HoverLink } from "./hover-link.mjs";
 import { MDXImg } from "./mdx-img.mjs";
 import { createPreWithCopyCallback } from "./code-block-copy-wrapper.mjs";
+import { HoverLink } from "./hover-link.mjs";
 import React from "react";
 import { Tab, Tabs } from "fumadocs-ui/components/tabs";
 import defaultMdxComponents from "fumadocs-ui/mdx";

package/package.json

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