@farming-labs/theme 0.1.30 → 0.1.33

package/dist/docs-api.mjs

@@ -34,6 +34,14 @@ 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_MCP_ROUTE = "/api/docs/mcp";
+const DEFAULT_MCP_PUBLIC_ROUTE = "/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";
 const DEFAULT_AGENT_FEEDBACK_PAYLOAD_SCHEMA = {
 	type: "object",
@@ -147,7 +155,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,6 +198,10 @@ 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: {
@@ -205,8 +218,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,
@@ -227,6 +246,9 @@ function buildAgentSpec({ origin, entry, i18n, search, mcp, feedback, llms }) {
 		mcp: {
 			enabled: mcp.enabled,
 			endpoint: mcp.route,
+			defaultEndpoint: DEFAULT_MCP_PUBLIC_ROUTE,
+			publicEndpoint: DEFAULT_MCP_PUBLIC_ROUTE,
+			canonicalEndpoint: DEFAULT_MCP_ROUTE,
 			name: mcp.name,
 			version: mcp.version,
 			tools: mcp.tools
@@ -768,6 +790,13 @@ function resolveMarkdownRequest(entry, url, request) {
 	}
 	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}`];
@@ -1088,12 +1117,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/docs-page-client.mjs

@@ -165,7 +165,7 @@ function DocsPageClient({ tocEnabled, tocStyle = "default", breadcrumbEnabled =
 	const [browserPath, setBrowserPath] = useState(null);
 	const pathname = usePathname();
 	const activeLocale = resolveClientLocale(useWindowSearchParams(), locale);
-	const llmsLangParam = activeLocale ? `&lang=${encodeURIComponent(activeLocale)}` : "";
+	const llmsLangQuery = activeLocale ? `?lang=${encodeURIComponent(activeLocale)}` : "";
 	const pageDescription = description ?? descriptionMap?.[pathname.replace(/\/$/, "") || "/"];
 	const normalizedPath = (browserPath ?? pathname).replace(/\/$/, "") || "/";
 	const isChangelogRoute = !!(changelogBasePath && (normalizedPath === changelogBasePath || normalizedPath.startsWith(`${changelogBasePath}/`)));
@@ -361,13 +361,13 @@ function DocsPageClient({ tocEnabled, tocStyle = "default", breadcrumbEnabled =
 							llmsTxtEnabled && /* @__PURE__ */ jsxs("span", {
 								className: "fd-llms-txt-links",
 								children: [/* @__PURE__ */ jsx("a", {
-									href: `/api/docs?format=llms${llmsLangParam}`,
+									href: `/llms.txt${llmsLangQuery}`,
 									target: "_blank",
 									rel: "noopener noreferrer",
 									className: "fd-llms-txt-link",
 									children: "llms.txt"
 								}), /* @__PURE__ */ jsx("a", {
-									href: `/api/docs?format=llms-full${llmsLangParam}`,
+									href: `/llms-full.txt${llmsLangQuery}`,
 									target: "_blank",
 									rel: "noopener noreferrer",
 									className: "fd-llms-txt-link",

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.30",
+  "version": "0.1.33",
   "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.30"
+    "@farming-labs/docs": "0.1.33"
   },
   "peerDependencies": {
     "@farming-labs/docs": ">=0.0.1",