@farming-labs/theme 0.0.2-beta.22 → 0.0.2-beta.24

package/dist/ai-search-dialog.d.mts

@@ -1,10 +1,12 @@
 //#region src/ai-search-dialog.d.ts
+type LoaderVariant = "shimmer-dots" | "circular" | "dots" | "typing" | "wave" | "bars" | "pulse" | "pulse-dot" | "terminal" | "text-blink" | "text-shimmer" | "loading-dots";
 declare function DocsSearchDialog({
   open,
   onOpenChange,
   api,
   suggestedQuestions,
   aiLabel,
+  loaderVariant,
   loadingComponentHtml
 }: {
   open: boolean;
@@ -12,6 +14,7 @@ declare function DocsSearchDialog({
   api?: string;
   suggestedQuestions?: string[];
   aiLabel?: string;
+  loaderVariant?: LoaderVariant;
   loadingComponentHtml?: string;
 }): any;
 type FloatingPosition = "bottom-right" | "bottom-left" | "bottom-center";
@@ -23,6 +26,7 @@ declare function FloatingAIChat({
   triggerComponentHtml,
   suggestedQuestions,
   aiLabel,
+  loaderVariant,
   loadingComponentHtml
 }: {
   api?: string;
@@ -31,6 +35,7 @@ declare function FloatingAIChat({
   triggerComponentHtml?: string;
   suggestedQuestions?: string[];
   aiLabel?: string;
+  loaderVariant?: LoaderVariant;
   loadingComponentHtml?: string;
 }): any;
 declare function AIModalDialog({
@@ -39,6 +44,7 @@ declare function AIModalDialog({
   api,
   suggestedQuestions,
   aiLabel,
+  loaderVariant,
   loadingComponentHtml
 }: {
   open: boolean;
@@ -46,6 +52,7 @@ declare function AIModalDialog({
   api?: string;
   suggestedQuestions?: string[];
   aiLabel?: string;
+  loaderVariant?: LoaderVariant;
   loadingComponentHtml?: string;
 }): any;
 //#endregion

package/dist/ai-search-dialog.mjs

@@ -143,33 +143,145 @@ function XIcon() {
 		children: [/* @__PURE__ */ jsx("path", { d: "M18 6 6 18" }), /* @__PURE__ */ jsx("path", { d: "m6 6 12 12" })]
 	});
 }
-function DefaultLoadingIndicator({ label }) {
-	return /* @__PURE__ */ jsxs("span", {
-		className: "fd-ai-loading",
-		children: [/* @__PURE__ */ jsxs("span", {
-			className: "fd-ai-loading-text",
-			children: [label, " is thinking"]
-		}), /* @__PURE__ */ jsxs("span", {
-			className: "fd-ai-loading-dots",
-			children: [
-				/* @__PURE__ */ jsx("span", { className: "fd-ai-loading-dot" }),
-				/* @__PURE__ */ jsx("span", { className: "fd-ai-loading-dot" }),
-				/* @__PURE__ */ jsx("span", { className: "fd-ai-loading-dot" })
-			]
-		})]
-	});
+function LoaderIndicator({ variant = "shimmer-dots" }) {
+	const text = "Thinking";
+	switch (variant) {
+		case "circular": return /* @__PURE__ */ jsxs("div", {
+			className: "fd-ai-loader",
+			children: [/* @__PURE__ */ jsx("div", { className: "fd-ai-loader-circular" }), /* @__PURE__ */ jsx("span", {
+				className: "sr-only",
+				children: "Loading"
+			})]
+		});
+		case "dots": return /* @__PURE__ */ jsx("div", {
+			className: "fd-ai-loader",
+			children: /* @__PURE__ */ jsxs("span", {
+				className: "fd-ai-loader-dots",
+				children: [
+					/* @__PURE__ */ jsx("span", { className: "fd-ai-loader-bounce-dot" }),
+					/* @__PURE__ */ jsx("span", { className: "fd-ai-loader-bounce-dot" }),
+					/* @__PURE__ */ jsx("span", { className: "fd-ai-loader-bounce-dot" })
+				]
+			})
+		});
+		case "typing": return /* @__PURE__ */ jsx("div", {
+			className: "fd-ai-loader",
+			children: /* @__PURE__ */ jsxs("span", {
+				className: "fd-ai-loader-typing-dots",
+				children: [
+					/* @__PURE__ */ jsx("span", { className: "fd-ai-loader-typing-dot" }),
+					/* @__PURE__ */ jsx("span", { className: "fd-ai-loader-typing-dot" }),
+					/* @__PURE__ */ jsx("span", { className: "fd-ai-loader-typing-dot" })
+				]
+			})
+		});
+		case "wave": return /* @__PURE__ */ jsx("div", {
+			className: "fd-ai-loader",
+			children: /* @__PURE__ */ jsxs("span", {
+				className: "fd-ai-loader-wave",
+				children: [
+					/* @__PURE__ */ jsx("span", { className: "fd-ai-loader-wave-bar" }),
+					/* @__PURE__ */ jsx("span", { className: "fd-ai-loader-wave-bar" }),
+					/* @__PURE__ */ jsx("span", { className: "fd-ai-loader-wave-bar" }),
+					/* @__PURE__ */ jsx("span", { className: "fd-ai-loader-wave-bar" }),
+					/* @__PURE__ */ jsx("span", { className: "fd-ai-loader-wave-bar" })
+				]
+			})
+		});
+		case "bars": return /* @__PURE__ */ jsx("div", {
+			className: "fd-ai-loader",
+			children: /* @__PURE__ */ jsxs("span", {
+				className: "fd-ai-loader-bars",
+				children: [
+					/* @__PURE__ */ jsx("span", { className: "fd-ai-loader-bar" }),
+					/* @__PURE__ */ jsx("span", { className: "fd-ai-loader-bar" }),
+					/* @__PURE__ */ jsx("span", { className: "fd-ai-loader-bar" })
+				]
+			})
+		});
+		case "pulse": return /* @__PURE__ */ jsx("div", {
+			className: "fd-ai-loader",
+			children: /* @__PURE__ */ jsx("div", { className: "fd-ai-loader-pulse" })
+		});
+		case "pulse-dot": return /* @__PURE__ */ jsx("div", {
+			className: "fd-ai-loader",
+			children: /* @__PURE__ */ jsx("div", { className: "fd-ai-loader-pulse-dot" })
+		});
+		case "terminal": return /* @__PURE__ */ jsx("div", {
+			className: "fd-ai-loader",
+			children: /* @__PURE__ */ jsxs("span", {
+				className: "fd-ai-loader-terminal",
+				children: [/* @__PURE__ */ jsx("span", {
+					className: "fd-ai-loader-terminal-prompt",
+					children: ">"
+				}), /* @__PURE__ */ jsx("span", { className: "fd-ai-loader-terminal-cursor" })]
+			})
+		});
+		case "text-blink": return /* @__PURE__ */ jsx("div", {
+			className: "fd-ai-loader",
+			children: /* @__PURE__ */ jsx("span", {
+				className: "fd-ai-loader-text-blink",
+				children: text
+			})
+		});
+		case "text-shimmer": return /* @__PURE__ */ jsx("div", {
+			className: "fd-ai-loader",
+			children: /* @__PURE__ */ jsx("span", {
+				className: "fd-ai-loader-shimmer-text",
+				children: text
+			})
+		});
+		case "loading-dots": return /* @__PURE__ */ jsxs("div", {
+			className: "fd-ai-loader",
+			children: [/* @__PURE__ */ jsx("span", {
+				className: "fd-ai-loader-text",
+				children: text
+			}), /* @__PURE__ */ jsxs("span", {
+				className: "fd-ai-loader-text-dots",
+				children: [
+					/* @__PURE__ */ jsx("span", {
+						className: "fd-ai-loader-text-dot",
+						children: "."
+					}),
+					/* @__PURE__ */ jsx("span", {
+						className: "fd-ai-loader-text-dot",
+						children: "."
+					}),
+					/* @__PURE__ */ jsx("span", {
+						className: "fd-ai-loader-text-dot",
+						children: "."
+					})
+				]
+			})]
+		});
+		default: return /* @__PURE__ */ jsxs("div", {
+			className: "fd-ai-loader",
+			children: [/* @__PURE__ */ jsx("span", {
+				className: "fd-ai-loader-shimmer-text",
+				children: text
+			}), /* @__PURE__ */ jsxs("span", {
+				className: "fd-ai-loader-typing-dots",
+				children: [
+					/* @__PURE__ */ jsx("span", { className: "fd-ai-loader-typing-dot" }),
+					/* @__PURE__ */ jsx("span", { className: "fd-ai-loader-typing-dot" }),
+					/* @__PURE__ */ jsx("span", { className: "fd-ai-loader-typing-dot" })
+				]
+			})]
+		});
+	}
 }
-function LoadingDots() {
+function InlineLoaderDots() {
 	return /* @__PURE__ */ jsxs("span", {
-		className: "fd-ai-loading-dots",
+		className: "fd-ai-loader-typing-dots",
+		style: { marginLeft: 0 },
 		children: [
-			/* @__PURE__ */ jsx("span", { className: "fd-ai-loading-dot" }),
-			/* @__PURE__ */ jsx("span", { className: "fd-ai-loading-dot" }),
-			/* @__PURE__ */ jsx("span", { className: "fd-ai-loading-dot" })
+			/* @__PURE__ */ jsx("span", { className: "fd-ai-loader-typing-dot" }),
+			/* @__PURE__ */ jsx("span", { className: "fd-ai-loader-typing-dot" }),
+			/* @__PURE__ */ jsx("span", { className: "fd-ai-loader-typing-dot" })
 		]
 	});
 }
-function AIChat({ api, messages, setMessages, aiInput, setAiInput, isStreaming, setIsStreaming, suggestedQuestions, aiLabel, loadingComponentHtml }) {
+function AIChat({ api, messages, setMessages, aiInput, setAiInput, isStreaming, setIsStreaming, suggestedQuestions, aiLabel, loaderVariant, loadingComponentHtml }) {
 	const label = aiLabel || "AI";
 	const aiInputRef = useRef(null);
 	const messagesEndRef = useRef(null);
@@ -311,7 +423,13 @@ function AIChat({ api, messages, setMessages, aiInput, setAiInput, isStreaming,
 					children: msg.content
 				}) : /* @__PURE__ */ jsx("div", {
 					className: "fd-ai-bubble-ai",
-					children: msg.content ? /* @__PURE__ */ jsx("div", { dangerouslySetInnerHTML: { __html: renderMarkdown(msg.content) } }) : loadingComponentHtml ? /* @__PURE__ */ jsx("div", { dangerouslySetInnerHTML: { __html: loadingComponentHtml } }) : /* @__PURE__ */ jsx(DefaultLoadingIndicator, { label })
+					children: msg.content ? /* @__PURE__ */ jsx("div", {
+						className: isStreaming && i === messages.length - 1 ? "fd-ai-streaming" : void 0,
+						dangerouslySetInnerHTML: { __html: renderMarkdown(msg.content) }
+					}) : loadingComponentHtml ? /* @__PURE__ */ jsx("div", { dangerouslySetInnerHTML: { __html: loadingComponentHtml } }) : /* @__PURE__ */ jsx(LoaderIndicator, {
+						variant: loaderVariant,
+						label
+					})
 				})]
 			}, i)), /* @__PURE__ */ jsx("div", { ref: messagesEndRef })]
 		}), /* @__PURE__ */ jsxs("div", {
@@ -353,7 +471,7 @@ function AIChat({ api, messages, setMessages, aiInput, setAiInput, isStreaming,
 		})]
 	});
 }
-function DocsSearchDialog({ open, onOpenChange, api = "/api/docs", suggestedQuestions, aiLabel, loadingComponentHtml }) {
+function DocsSearchDialog({ open, onOpenChange, api = "/api/docs", suggestedQuestions, aiLabel, loaderVariant, loadingComponentHtml }) {
 	const [tab, setTab] = useState("search");
 	const [searchQuery, setSearchQuery] = useState("");
 	const [searchResults, setSearchResults] = useState([]);
@@ -496,7 +614,7 @@ function DocsSearchDialog({ open, onOpenChange, api = "/api/docs", suggestedQues
 							onKeyDown: handleSearchKeyDown,
 							className: "fd-ai-input"
 						}),
-						isSearching && /* @__PURE__ */ jsx(LoadingDots, {})
+						isSearching && /* @__PURE__ */ jsx(InlineLoaderDots, {})
 					]
 				}), /* @__PURE__ */ jsx("div", {
 					className: "fd-ai-results",
@@ -528,6 +646,7 @@ function DocsSearchDialog({ open, onOpenChange, api = "/api/docs", suggestedQues
 				setIsStreaming,
 				suggestedQuestions,
 				aiLabel,
+				loaderVariant,
 				loadingComponentHtml
 			})
 		]
@@ -602,7 +721,7 @@ function getContainerStyles(style, position) {
 function getAnimation(style) {
 	return style === "modal" ? "fd-ai-float-center-in 200ms ease-out" : "fd-ai-float-in 200ms ease-out";
 }
-function FloatingAIChat({ api = "/api/docs", position = "bottom-right", floatingStyle = "panel", triggerComponentHtml, suggestedQuestions, aiLabel, loadingComponentHtml }) {
+function FloatingAIChat({ api = "/api/docs", position = "bottom-right", floatingStyle = "panel", triggerComponentHtml, suggestedQuestions, aiLabel, loaderVariant, loadingComponentHtml }) {
 	const [mounted, setMounted] = useState(false);
 	const [isOpen, setIsOpen] = useState(false);
 	const [messages, setMessages] = useState([]);
@@ -640,6 +759,7 @@ function FloatingAIChat({ api = "/api/docs", position = "bottom-right", floating
 		setIsStreaming,
 		suggestedQuestions,
 		aiLabel,
+		loaderVariant,
 		loadingComponentHtml,
 		triggerComponentHtml,
 		position
@@ -688,6 +808,7 @@ function FloatingAIChat({ api = "/api/docs", position = "bottom-right", floating
 				setIsStreaming,
 				suggestedQuestions,
 				aiLabel,
+				loaderVariant,
 				loadingComponentHtml
 			})]
 		}),
@@ -705,7 +826,7 @@ function FloatingAIChat({ api = "/api/docs", position = "bottom-right", floating
 		}))
 	] }), document.body);
 }
-function FullModalAIChat({ api, isOpen, setIsOpen, messages, setMessages, aiInput, setAiInput, isStreaming, setIsStreaming, suggestedQuestions, aiLabel, loadingComponentHtml, triggerComponentHtml, position }) {
+function FullModalAIChat({ api, isOpen, setIsOpen, messages, setMessages, aiInput, setAiInput, isStreaming, setIsStreaming, suggestedQuestions, aiLabel, loaderVariant, loadingComponentHtml, triggerComponentHtml, position }) {
 	const label = aiLabel || "AI";
 	const inputRef = useRef(null);
 	const listRef = useRef(null);
@@ -831,13 +952,12 @@ function FullModalAIChat({ api, isOpen, setIsOpen, messages, setMessages, aiInpu
 						children: msg.role === "user" ? "you" : label
 					}), /* @__PURE__ */ jsx("div", {
 						className: "fd-ai-fm-msg-content",
-						children: msg.content ? /* @__PURE__ */ jsx("div", { dangerouslySetInnerHTML: { __html: renderMarkdown(msg.content) } }) : loadingComponentHtml ? /* @__PURE__ */ jsx("div", { dangerouslySetInnerHTML: { __html: loadingComponentHtml } }) : /* @__PURE__ */ jsxs("div", {
-							className: "fd-ai-fm-thinking",
-							children: [
-								/* @__PURE__ */ jsx("span", { className: "fd-ai-fm-thinking-dot" }),
-								/* @__PURE__ */ jsx("span", { className: "fd-ai-fm-thinking-dot" }),
-								/* @__PURE__ */ jsx("span", { className: "fd-ai-fm-thinking-dot" })
-							]
+						children: msg.content ? /* @__PURE__ */ jsx("div", {
+							className: isStreaming && i === messages.length - 1 ? "fd-ai-streaming" : void 0,
+							dangerouslySetInnerHTML: { __html: renderMarkdown(msg.content) }
+						}) : loadingComponentHtml ? /* @__PURE__ */ jsx("div", { dangerouslySetInnerHTML: { __html: loadingComponentHtml } }) : /* @__PURE__ */ jsx(LoaderIndicator, {
+							variant: loaderVariant,
+							label
 						})
 					})]
 				}, i))
@@ -871,7 +991,7 @@ function FullModalAIChat({ api, isOpen, setIsOpen, messages, setMessages, aiInpu
 					}), isStreaming ? /* @__PURE__ */ jsx("button", {
 						className: "fd-ai-fm-send-btn",
 						onClick: () => setIsStreaming(false),
-						children: /* @__PURE__ */ jsx(LoadingDots, {})
+						children: /* @__PURE__ */ jsx(InlineLoaderDots, {})
 					}) : /* @__PURE__ */ jsx("button", {
 						className: "fd-ai-fm-send-btn",
 						"data-active": canSend,
@@ -932,7 +1052,7 @@ function TrashIcon() {
 		]
 	});
 }
-function AIModalDialog({ open, onOpenChange, api = "/api/docs", suggestedQuestions, aiLabel, loadingComponentHtml }) {
+function AIModalDialog({ open, onOpenChange, api = "/api/docs", suggestedQuestions, aiLabel, loaderVariant, loadingComponentHtml }) {
 	const [messages, setMessages] = useState([]);
 	const [aiInput, setAiInput] = useState("");
 	const [isStreaming, setIsStreaming] = useState(false);
@@ -999,6 +1119,7 @@ function AIModalDialog({ open, onOpenChange, api = "/api/docs", suggestedQuestio
 				setIsStreaming,
 				suggestedQuestions,
 				aiLabel,
+				loaderVariant,
 				loadingComponentHtml
 			}),
 			/* @__PURE__ */ jsx("div", {

package/dist/docs-ai-features.d.mts

@@ -8,6 +8,7 @@ interface DocsAIFeaturesProps {
   triggerComponentHtml?: string;
   suggestedQuestions?: string[];
   aiLabel?: string;
+  loaderVariant?: string;
   loadingComponentHtml?: string;
 }
 declare function DocsAIFeatures({
@@ -17,6 +18,7 @@ declare function DocsAIFeatures({
   triggerComponentHtml,
   suggestedQuestions,
   aiLabel,
+  loaderVariant,
   loadingComponentHtml
 }: DocsAIFeaturesProps): react_jsx_runtime0.JSX.Element;
 //#endregion

package/dist/docs-ai-features.mjs

@@ -19,15 +19,17 @@ import { Fragment, jsx, jsxs } from "react/jsx-runtime";
 * This component is rendered inside the docs layout so the user's root layout
 * never needs to be modified — AI features work purely from `docs.config.tsx`.
 */
-function DocsAIFeatures({ mode, position = "bottom-right", floatingStyle = "panel", triggerComponentHtml, suggestedQuestions, aiLabel, loadingComponentHtml }) {
+function DocsAIFeatures({ mode, position = "bottom-right", floatingStyle = "panel", triggerComponentHtml, suggestedQuestions, aiLabel, loaderVariant, loadingComponentHtml }) {
 	if (mode === "search") return /* @__PURE__ */ jsx(SearchModeAI, {
 		suggestedQuestions,
 		aiLabel,
+		loaderVariant,
 		loadingComponentHtml
 	});
 	if (mode === "sidebar-icon") return /* @__PURE__ */ jsx(SidebarIconModeAI, {
 		suggestedQuestions,
 		aiLabel,
+		loaderVariant,
 		loadingComponentHtml
 	});
 	return /* @__PURE__ */ jsx(FloatingAIChat, {
@@ -37,15 +39,11 @@ function DocsAIFeatures({ mode, position = "bottom-right", floatingStyle = "pane
 		triggerComponentHtml,
 		suggestedQuestions,
 		aiLabel,
+		loaderVariant,
 		loadingComponentHtml
 	});
 }
-/**
-* Search mode: intercepts Cmd+K / Ctrl+K globally and opens the
-* custom search dialog (with Search + Ask AI tabs) instead of
-* fumadocs' built-in search dialog.
-*/
-function SearchModeAI({ suggestedQuestions, aiLabel, loadingComponentHtml }) {
+function SearchModeAI({ suggestedQuestions, aiLabel, loaderVariant, loadingComponentHtml }) {
 	const [open, setOpen] = useState(false);
 	useEffect(() => {
 		function handler(e) {
@@ -80,15 +78,11 @@ function SearchModeAI({ suggestedQuestions, aiLabel, loadingComponentHtml }) {
 		api: "/api/docs",
 		suggestedQuestions,
 		aiLabel,
+		loaderVariant,
 		loadingComponentHtml
 	});
 }
-/**
-* Sidebar-icon mode: injects a sparkle icon button next to the search bar
-* in the sidebar header. The search button opens the Cmd+K search dialog,
-* and the AI sparkle button opens a pure AI modal (no search tabs).
-*/
-function SidebarIconModeAI({ suggestedQuestions, aiLabel, loadingComponentHtml }) {
+function SidebarIconModeAI({ suggestedQuestions, aiLabel, loaderVariant, loadingComponentHtml }) {
 	const [searchOpen, setSearchOpen] = useState(false);
 	const [aiOpen, setAiOpen] = useState(false);
 	useEffect(() => {
@@ -123,6 +117,7 @@ function SidebarIconModeAI({ suggestedQuestions, aiLabel, loadingComponentHtml }
 		api: "/api/docs",
 		suggestedQuestions,
 		aiLabel,
+		loaderVariant,
 		loadingComponentHtml
 	}), /* @__PURE__ */ jsx(AIModalDialog, {
 		open: aiOpen,
@@ -130,6 +125,7 @@ function SidebarIconModeAI({ suggestedQuestions, aiLabel, loadingComponentHtml }
 		api: "/api/docs",
 		suggestedQuestions,
 		aiLabel,
+		loaderVariant,
 		loadingComponentHtml
 	})] });
 }

package/dist/docs-api.d.mts

@@ -38,12 +38,14 @@ interface DocsAPIOptions {
  * Create a unified docs API route handler.
  *
  * Returns `{ GET, POST }` for use in a Next.js route handler:
- * - **GET** → full-text search (same as the old `createDocsSearchAPI`)
- * - **POST** → AI-powered chat with RAG (when AI is enabled in config)
+ * - **GET  ?query=…**        → full-text search
+ * - **GET  ?format=llms**     → llms.txt (concise page listing)
+ * - **GET  ?format=llms-full** → llms-full.txt (full page content)
+ * - **POST**                  → AI-powered chat with RAG
  *
  * @example
  * ```ts
- * // app/api/docs/route.ts
+ * // app/api/docs/route.ts (auto-generated by withDocs)
  * import { createDocsAPI } from "@farming-labs/theme/api";
  * export const { GET, POST } = createDocsAPI();
  * export const revalidate = false;
@@ -53,10 +55,9 @@ interface DocsAPIOptions {
  */
 declare function createDocsAPI(options?: DocsAPIOptions): {
   /**
-   * GET handler — full-text search.
-   * Query: `?query=search+term`
+   * GET handler — search, llms.txt, or llms-full.txt depending on query params.
    */
-  GET: (request: Request) => Promise<Response>;
+  GET(request: Request): Response | Promise<Response>;
   /**
    * POST handler — AI chat with RAG.
    * Body: `{ messages: [{ role: "user", content: "How do I …?" }] }`

package/dist/docs-api.mjs

@@ -163,16 +163,64 @@ async function handleAskAI(request, indexes, searchServer, aiConfig) {
 		Connection: "keep-alive"
 	} });
 }
+function readLlmsTxtConfig(root) {
+	for (const ext of FILE_EXTS) {
+		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 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],
+				siteTitle: siteTitleMatch?.[1] ?? navTitleMatch?.[1],
+				siteDescription: siteDescMatch?.[1]
+			};
+		} catch {}
+	}
+	return { enabled: false };
+}
+function generateLlmsTxt(indexes, options) {
+	const { siteTitle = "Documentation", siteDescription, baseUrl = "" } = options;
+	let llmsTxt = `# ${siteTitle}\n\n`;
+	if (siteDescription) llmsTxt += `> ${siteDescription}\n\n`;
+	llmsTxt += `## Pages\n\n`;
+	for (const page of indexes) {
+		llmsTxt += `- [${page.title}](${baseUrl}${page.url})`;
+		if (page.description) llmsTxt += `: ${page.description}`;
+		llmsTxt += `\n`;
+	}
+	let llmsFullTxt = `# ${siteTitle}\n\n`;
+	if (siteDescription) llmsFullTxt += `> ${siteDescription}\n\n`;
+	for (const page of indexes) {
+		llmsFullTxt += `## ${page.title}\n\n`;
+		llmsFullTxt += `URL: ${baseUrl}${page.url}\n\n`;
+		if (page.description) llmsFullTxt += `${page.description}\n\n`;
+		llmsFullTxt += `${page.content}\n\n---\n\n`;
+	}
+	return {
+		llmsTxt,
+		llmsFullTxt
+	};
+}
 /**
 * Create a unified docs API route handler.
 *
 * Returns `{ GET, POST }` for use in a Next.js route handler:
-* - **GET** → full-text search (same as the old `createDocsSearchAPI`)
-* - **POST** → AI-powered chat with RAG (when AI is enabled in config)
+* - **GET  ?query=…**        → full-text search
+* - **GET  ?format=llms**     → llms.txt (concise page listing)
+* - **GET  ?format=llms-full** → llms-full.txt (full page content)
+* - **POST**                  → AI-powered chat with RAG
 *
 * @example
 * ```ts
-* // app/api/docs/route.ts
+* // app/api/docs/route.ts (auto-generated by withDocs)
 * import { createDocsAPI } from "@farming-labs/theme/api";
 * export const { GET, POST } = createDocsAPI();
 * export const revalidate = false;
@@ -186,13 +234,34 @@ function createDocsAPI(options) {
 	const docsDir = path.join(root, "app", entry);
 	const language = options?.language ?? "english";
 	const aiConfig = options?.ai ?? readAIConfig(root);
+	const llmsConfig = readLlmsTxtConfig(root);
 	const indexes = scanDocsDir(docsDir, entry);
+	let _llmsCache = null;
+	function getLlmsContent() {
+		if (!_llmsCache) _llmsCache = generateLlmsTxt(indexes, {
+			siteTitle: llmsConfig.siteTitle ?? "Documentation",
+			siteDescription: llmsConfig.siteDescription,
+			baseUrl: llmsConfig.baseUrl ?? ""
+		});
+		return _llmsCache;
+	}
 	const searchAPI = createSearchAPI("simple", {
 		language,
 		indexes
 	});
 	return {
-		GET: searchAPI.GET,
+		GET(request) {
+			const format = new URL(request.url).searchParams.get("format");
+			if (format === "llms") return new Response(getLlmsContent().llmsTxt, { headers: {
+				"Content-Type": "text/plain; charset=utf-8",
+				"Cache-Control": "public, max-age=3600"
+			} });
+			if (format === "llms-full") return new Response(getLlmsContent().llmsFullTxt, { headers: {
+				"Content-Type": "text/plain; charset=utf-8",
+				"Cache-Control": "public, max-age=3600"
+			} });
+			return searchAPI.GET(request);
+		},
 		async POST(request) {
 			if (!aiConfig.enabled) return Response.json({ error: "AI is not enabled. Set `ai: { enabled: true }` in your docs.config to enable it." }, { status: 404 });
 			return handleAskAI(request, indexes, searchAPI, aiConfig);

package/dist/docs-layout.mjs

@@ -357,6 +357,7 @@ function createDocsLayout(config) {
 	const lastUpdatedRaw = config.lastUpdated;
 	const lastUpdatedEnabled = lastUpdatedRaw !== false && (typeof lastUpdatedRaw !== "object" || lastUpdatedRaw.enabled !== false);
 	const lastUpdatedPosition = typeof lastUpdatedRaw === "object" ? lastUpdatedRaw.position ?? "footer" : "footer";
+	const llmsTxtEnabled = resolveBool(config.llmsTxt);
 	const openDocsProviders = (typeof pageActions?.openDocs === "object" && pageActions.openDocs.providers ? pageActions.openDocs.providers : void 0)?.map((p) => ({
 		name: p.name,
 		urlTemplate: p.urlTemplate,
@@ -374,6 +375,7 @@ function createDocsLayout(config) {
 	const aiTriggerComponentHtml = aiConfig?.triggerComponent ? serializeIcon(aiConfig.triggerComponent) : void 0;
 	const aiSuggestedQuestions = aiConfig?.suggestedQuestions;
 	const aiLabel = aiConfig?.aiLabel;
+	const aiLoaderVariant = aiConfig?.loader;
 	const aiLoadingComponentHtml = typeof aiConfig?.loadingComponent === "function" ? serializeIcon(aiConfig.loadingComponent({ name: aiLabel || "AI" })) : void 0;
 	const lastModifiedMap = buildLastModifiedMap(config.entry);
 	const descriptionMap = buildDescriptionMap(config.entry);
@@ -400,6 +402,7 @@ function createDocsLayout(config) {
 					triggerComponentHtml: aiTriggerComponentHtml,
 					suggestedQuestions: aiSuggestedQuestions,
 					aiLabel,
+					loaderVariant: aiLoaderVariant,
 					loadingComponentHtml: aiLoadingComponentHtml
 				}),
 				/* @__PURE__ */ jsx(DocsPageClient, {
@@ -418,6 +421,7 @@ function createDocsLayout(config) {
 					lastModifiedMap,
 					lastUpdatedEnabled,
 					lastUpdatedPosition,
+					llmsTxtEnabled,
 					descriptionMap,
 					children
 				})

package/dist/docs-page-client.d.mts

@@ -33,6 +33,8 @@ interface DocsPageClientProps {
   lastUpdatedEnabled?: boolean;
   /** Where to show the "Last updated" date: "footer" (next to Edit on GitHub) or "below-title" */
   lastUpdatedPosition?: "footer" | "below-title";
+  /** Whether llms.txt is enabled — shows links in footer */
+  llmsTxtEnabled?: boolean;
   /** Map of pathname → frontmatter description */
   descriptionMap?: Record<string, string>;
   /** Frontmatter description to display below the page title (overrides descriptionMap) */
@@ -55,6 +57,7 @@ declare function DocsPageClient({
   lastModifiedMap,
   lastUpdatedEnabled,
   lastUpdatedPosition,
+  llmsTxtEnabled,
   descriptionMap,
   description,
   children

package/dist/docs-page-client.mjs

@@ -63,7 +63,7 @@ function buildGithubFileUrl(githubUrl, branch, pathname, directory) {
 	const segments = pathname.replace(/^\//, "").replace(/\/$/, "");
 	return `${githubUrl}/tree/${branch}/${directory ? `${directory}/` : ""}app/${segments}/page.mdx`;
 }
-function DocsPageClient({ tocEnabled, tocStyle = "default", breadcrumbEnabled = true, entry = "docs", copyMarkdown = false, openDocs = false, openDocsProviders, pageActionsPosition = "below-title", pageActionsAlignment = "left", githubUrl, githubBranch = "main", githubDirectory, lastModifiedMap, lastUpdatedEnabled = true, lastUpdatedPosition = "footer", descriptionMap, description, children }) {
+function DocsPageClient({ tocEnabled, tocStyle = "default", breadcrumbEnabled = true, entry = "docs", copyMarkdown = false, openDocs = false, openDocsProviders, pageActionsPosition = "below-title", pageActionsAlignment = "left", githubUrl, githubBranch = "main", githubDirectory, lastModifiedMap, lastUpdatedEnabled = true, lastUpdatedPosition = "footer", llmsTxtEnabled = false, descriptionMap, description, children }) {
 	const fdTocStyle = tocStyle === "directional" ? "clerk" : void 0;
 	const [toc, setToc] = useState([]);
 	const pathname = usePathname();
@@ -109,7 +109,7 @@ function DocsPageClient({ tocEnabled, tocStyle = "default", breadcrumbEnabled =
 	const lastModified = lastUpdatedEnabled ? lastModifiedMap?.[normalizedPath] : void 0;
 	const showLastUpdatedBelowTitle = !!lastModified && lastUpdatedPosition === "below-title";
 	const showLastUpdatedInFooter = !!lastModified && lastUpdatedPosition === "footer";
-	const showFooter = !!githubFileUrl || showLastUpdatedInFooter;
+	const showFooter = !!githubFileUrl || showLastUpdatedInFooter || llmsTxtEnabled;
 	const needsBelowTitleBlock = showLastUpdatedBelowTitle || showActions;
 	useEffect(() => {
 		if (!needsBelowTitleBlock) return;
@@ -188,10 +188,29 @@ function DocsPageClient({ tocEnabled, tocStyle = "default", breadcrumbEnabled =
 					children
 				}), showFooter && /* @__PURE__ */ jsxs("div", {
 					className: "not-prose fd-page-footer",
-					children: [githubFileUrl && /* @__PURE__ */ jsx(EditOnGitHub, { href: githubFileUrl }), showLastUpdatedInFooter && lastModified && /* @__PURE__ */ jsxs("span", {
-						className: "fd-last-updated-footer",
-						children: ["Last updated ", lastModified]
-					})]
+					children: [
+						githubFileUrl && /* @__PURE__ */ jsx(EditOnGitHub, { href: githubFileUrl }),
+						llmsTxtEnabled && /* @__PURE__ */ jsxs("span", {
+							className: "fd-llms-txt-links",
+							children: [/* @__PURE__ */ jsx("a", {
+								href: "/api/docs?format=llms",
+								target: "_blank",
+								rel: "noopener noreferrer",
+								className: "fd-llms-txt-link",
+								children: "llms.txt"
+							}), /* @__PURE__ */ jsx("a", {
+								href: "/api/docs?format=llms-full",
+								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]
+						})
+					]
 				})]
 			})
 		]

package/dist/search.d.mts

@@ -27,7 +27,7 @@ declare function createDocsSearchAPI(options?: {
   entry?: string;
   language?: string;
 }): {
-  GET: (request: Request) => Promise<Response>;
+  GET(request: Request): Response | Promise<Response>;
   POST(request: Request): Promise<Response>;
 };
 //#endregion

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@farming-labs/theme",
-  "version": "0.0.2-beta.22",
+  "version": "0.0.2-beta.24",
   "description": "Theme package for @farming-labs/docs — layout, provider, MDX components, and styles",
   "keywords": [
     "docs",
@@ -98,7 +98,7 @@
     "next": ">=14.0.0",
     "tsdown": "^0.20.3",
     "typescript": "^5.9.3",
-    "@farming-labs/docs": "0.0.2-beta.22"
+    "@farming-labs/docs": "0.0.2-beta.24"
   },
   "peerDependencies": {
     "@farming-labs/docs": ">=0.0.1",

package/styles/ai.css

@@ -7,19 +7,6 @@
 
 /* ─── Animations ─────────────────────────────────────────────────── */
 
-@keyframes fd-ai-dot {
-  0%,
-  80%,
-  100% {
-    transform: scale(0);
-    opacity: 0.5;
-  }
-  40% {
-    transform: scale(1);
-    opacity: 1;
-  }
-}
-
 @keyframes fd-ai-fade-in {
   from {
     opacity: 0;
@@ -343,6 +330,12 @@
   line-height: 1.6;
   max-width: 95%;
   word-break: break-word;
+  animation: fd-ai-msg-in 300ms ease-out;
+}
+
+@keyframes fd-ai-msg-in {
+  from { opacity: 0; transform: translateY(6px); }
+  to { opacity: 1; transform: translateY(0); }
 }
 
 /* ─── Chat input ─────────────────────────────────────────────────── */
@@ -397,38 +390,274 @@
   color: var(--color-fd-primary-foreground, #fff);
 }
 
-/* ─── Loading indicator ──────────────────────────────────────────── */
+/* ═══════════════════════════════════════════════════════════════════
+ * AI Loader variants — fd-ai-loader-*
+ * Default: "shimmer-dots" (shimmer text + typing dots in a row)
+ * ═══════════════════════════════════════════════════════════════════ */
 
-.fd-ai-loading {
+.fd-ai-loader {
   display: inline-flex;
+  align-items: center;
   gap: 6px;
+  animation: fd-ai-loader-in 300ms ease-out;
+}
+
+@keyframes fd-ai-loader-in {
+  from { opacity: 0; transform: translateY(4px); }
+  to { opacity: 1; transform: translateY(0); }
+}
+
+/* ── shimmer-dots (default): shimmer text + typing dots ──────────── */
+
+.fd-ai-loader-shimmer-text {
+  font-size: 13px;
+  font-weight: 500;
+  background: linear-gradient(
+    to right,
+    var(--color-fd-muted-foreground, #888) 40%,
+    var(--color-fd-foreground, #fff) 60%,
+    var(--color-fd-muted-foreground, #888) 80%
+  );
+  background-size: 200% auto;
+  background-clip: text;
+  -webkit-background-clip: text;
+  color: transparent;
+  animation: fd-ai-shimmer-text 3s linear infinite;
+}
+
+@keyframes fd-ai-shimmer-text {
+  0% { background-position: 150% center; }
+  100% { background-position: -150% center; }
+}
+
+.fd-ai-loader-typing-dots {
+  display: inline-flex;
   align-items: center;
+  gap: 2px;
 }
 
-.fd-ai-loading-text {
-  font-size: 12px;
-  color: var(--color-fd-muted-foreground, #888);
+.fd-ai-loader-typing-dot {
+  width: 4px;
+  height: 4px;
+  border-radius: 50%;
+  background: var(--color-fd-primary, #6366f1);
+  animation: fd-ai-typing 1s infinite;
 }
 
-.fd-ai-loading-dots {
+.fd-ai-loader-typing-dot:nth-child(2) { animation-delay: 250ms; }
+.fd-ai-loader-typing-dot:nth-child(3) { animation-delay: 500ms; }
+
+@keyframes fd-ai-typing {
+  0%, 100% { transform: translateY(0); opacity: 0.5; }
+  50% { transform: translateY(-2px); opacity: 1; }
+}
+
+/* ── circular: spinning ring ─────────────────────────────────────── */
+
+.fd-ai-loader-circular {
+  width: 16px;
+  height: 16px;
+  border: 2px solid var(--color-fd-primary, #6366f1);
+  border-top-color: transparent;
+  border-radius: 50%;
+  animation: fd-ai-spin 0.8s linear infinite;
+}
+
+@keyframes fd-ai-spin {
+  to { transform: rotate(360deg); }
+}
+
+/* ── dots: bouncing dots ─────────────────────────────────────────── */
+
+.fd-ai-loader-dots {
   display: inline-flex;
+  align-items: center;
   gap: 3px;
+}
+
+.fd-ai-loader-bounce-dot {
+  width: 6px;
+  height: 6px;
+  border-radius: 50%;
+  background: var(--color-fd-primary, #6366f1);
+  animation: fd-ai-bounce-dots 1.4s ease-in-out infinite;
+}
+
+.fd-ai-loader-bounce-dot:nth-child(2) { animation-delay: 160ms; }
+.fd-ai-loader-bounce-dot:nth-child(3) { animation-delay: 320ms; }
+
+@keyframes fd-ai-bounce-dots {
+  0%, 100% { transform: scale(0.8); opacity: 0.5; }
+  50% { transform: scale(1.2); opacity: 1; }
+}
+
+/* ── wave: wave bars ─────────────────────────────────────────────── */
+
+.fd-ai-loader-wave {
+  display: inline-flex;
   align-items: center;
+  gap: 2px;
+  height: 16px;
 }
 
-.fd-ai-loading-dot {
-  width: 5px;
-  height: 5px;
+.fd-ai-loader-wave-bar {
+  width: 2px;
+  border-radius: 2px;
+  background: var(--color-fd-primary, #6366f1);
+  animation: fd-ai-wave 1s ease-in-out infinite;
+}
+
+.fd-ai-loader-wave-bar:nth-child(1) { height: 6px; animation-delay: 0ms; }
+.fd-ai-loader-wave-bar:nth-child(2) { height: 10px; animation-delay: 100ms; }
+.fd-ai-loader-wave-bar:nth-child(3) { height: 14px; animation-delay: 200ms; }
+.fd-ai-loader-wave-bar:nth-child(4) { height: 10px; animation-delay: 300ms; }
+.fd-ai-loader-wave-bar:nth-child(5) { height: 6px; animation-delay: 400ms; }
+
+@keyframes fd-ai-wave {
+  0%, 100% { transform: scaleY(1); }
+  50% { transform: scaleY(0.6); }
+}
+
+/* ── pulse: pulsing ring ─────────────────────────────────────────── */
+
+.fd-ai-loader-pulse {
+  width: 16px;
+  height: 16px;
+  border: 2px solid var(--color-fd-primary, #6366f1);
   border-radius: 50%;
-  background: var(--color-fd-muted-foreground, #888);
-  animation: fd-ai-dot 1.4s infinite ease-in-out both;
+  animation: fd-ai-pulse 1.5s ease-in-out infinite;
+}
+
+@keyframes fd-ai-pulse {
+  0%, 100% { transform: scale(0.95); opacity: 0.8; }
+  50% { transform: scale(1.05); opacity: 0.4; }
+}
+
+/* ── pulse-dot: pulsing dot ──────────────────────────────────────── */
+
+.fd-ai-loader-pulse-dot {
+  width: 8px;
+  height: 8px;
+  border-radius: 50%;
+  background: var(--color-fd-primary, #6366f1);
+  animation: fd-ai-pulse-dot 1.2s ease-in-out infinite;
+}
+
+@keyframes fd-ai-pulse-dot {
+  0%, 100% { transform: scale(1); opacity: 0.8; }
+  50% { transform: scale(1.5); opacity: 1; }
+}
+
+/* ── terminal: blinking cursor ───────────────────────────────────── */
+
+.fd-ai-loader-terminal {
+  display: inline-flex;
+  align-items: center;
+  gap: 3px;
+}
+
+.fd-ai-loader-terminal-prompt {
+  font-family: var(--fd-font-mono, ui-monospace, monospace);
+  font-size: 13px;
+  color: var(--color-fd-primary, #6366f1);
+}
+
+.fd-ai-loader-terminal-cursor {
+  width: 7px;
+  height: 14px;
+  background: var(--color-fd-primary, #6366f1);
+  animation: fd-ai-blink 1s step-end infinite;
+}
+
+@keyframes fd-ai-blink {
+  0%, 100% { opacity: 1; }
+  50% { opacity: 0; }
+}
+
+/* ── text-shimmer: shimmer text only ─────────────────────────────── */
+/* (reuses .fd-ai-loader-shimmer-text above) */
+
+/* ── text-blink: blinking text ───────────────────────────────────── */
+
+.fd-ai-loader-text-blink {
+  font-size: 13px;
+  font-weight: 500;
+  animation: fd-ai-text-blink 2s ease-in-out infinite;
+}
+
+@keyframes fd-ai-text-blink {
+  0%, 100% { color: var(--color-fd-primary, #6366f1); }
+  50% { color: var(--color-fd-muted-foreground, #888); }
+}
+
+/* ── loading-dots: "Thinking..." with animated dots ──────────────── */
+
+.fd-ai-loader-text {
+  font-size: 13px;
+  font-weight: 500;
+  color: var(--color-fd-primary, #6366f1);
 }
 
-.fd-ai-loading-dot:nth-child(2) {
-  animation-delay: 0.16s;
+.fd-ai-loader-text-dots {
+  display: inline-flex;
 }
-.fd-ai-loading-dot:nth-child(3) {
-  animation-delay: 0.32s;
+
+.fd-ai-loader-text-dot {
+  font-size: 13px;
+  font-weight: 500;
+  color: var(--color-fd-primary, #6366f1);
+  animation: fd-ai-loading-dots 1.4s infinite;
+}
+
+.fd-ai-loader-text-dot:nth-child(1) { animation-delay: 200ms; }
+.fd-ai-loader-text-dot:nth-child(2) { animation-delay: 400ms; }
+.fd-ai-loader-text-dot:nth-child(3) { animation-delay: 600ms; }
+
+@keyframes fd-ai-loading-dots {
+  0%, 100% { opacity: 0; }
+  50% { opacity: 1; }
+}
+
+/* ── bars: thick wave bars ───────────────────────────────────────── */
+
+.fd-ai-loader-bars {
+  display: inline-flex;
+  align-items: stretch;
+  gap: 3px;
+  height: 16px;
+}
+
+.fd-ai-loader-bar {
+  width: 4px;
+  background: var(--color-fd-primary, #6366f1);
+  animation: fd-ai-wave-bars 1.2s ease-in-out infinite;
+}
+
+.fd-ai-loader-bar:nth-child(1) { animation-delay: 0s; }
+.fd-ai-loader-bar:nth-child(2) { animation-delay: 0.2s; }
+.fd-ai-loader-bar:nth-child(3) { animation-delay: 0.4s; }
+
+@keyframes fd-ai-wave-bars {
+  0%, 100% { transform: scaleY(1); opacity: 0.5; }
+  50% { transform: scaleY(0.6); opacity: 1; }
+}
+
+/* ─── Streaming cursor ───────────────────────────────────────────── */
+
+.fd-ai-streaming::after {
+  content: "";
+  display: inline-block;
+  width: 2px;
+  height: 1em;
+  background: var(--color-fd-primary, #6366f1);
+  margin-left: 2px;
+  vertical-align: text-bottom;
+  animation: fd-ai-cursor-blink 0.8s step-end infinite;
+}
+
+@keyframes fd-ai-cursor-blink {
+  0%, 100% { opacity: 1; }
+  50% { opacity: 0; }
 }
 
 /* ─── Floating trigger button ────────────────────────────────────── */
@@ -747,39 +976,7 @@
 
 /* ─── Thinking dots ──────────────────────────────────────────────── */
 
-.fd-ai-fm-thinking {
-  display: flex;
-  gap: 4px;
-  align-items: center;
-}
-
-.fd-ai-fm-thinking-dot {
-  width: 6px;
-  height: 6px;
-  border-radius: 9999px;
-  background: var(--color-fd-primary, #6366f1);
-  animation: fd-ai-fm-bounce 1s infinite ease-in-out;
-}
-
-.fd-ai-fm-thinking-dot:nth-child(2) {
-  animation-delay: 150ms;
-}
-.fd-ai-fm-thinking-dot:nth-child(3) {
-  animation-delay: 300ms;
-}
-
-@keyframes fd-ai-fm-bounce {
-  0%,
-  80%,
-  100% {
-    transform: scale(0.6);
-    opacity: 0.4;
-  }
-  40% {
-    transform: scale(1);
-    opacity: 1;
-  }
-}
+/* Full-modal now uses the shared .fd-ai-loader indicator */
 
 /* ─── Bottom input bar ───────────────────────────────────────────── */
 

package/styles/base.css

@@ -409,6 +409,29 @@ figure.shiki:has(figcaption) figcaption {
   margin-left: auto;
 }
 
+.fd-llms-txt-links {
+  display: inline-flex;
+  align-items: center;
+  gap: 0.5rem;
+}
+
+.fd-llms-txt-link {
+  color: var(--color-fd-muted-foreground, hsl(0 0% 45%));
+  font-size: 0.75rem;
+  font-family: var(--fd-font-mono, ui-monospace, SFMono-Regular, 'SF Mono', Menlo, Consolas, monospace);
+  text-decoration: none;
+  padding: 0.125rem 0.375rem;
+  border-radius: 0.25rem;
+  border: 1px solid var(--color-fd-border, hsl(0 0% 80% / 50%));
+  transition: color 150ms, border-color 150ms;
+}
+
+.fd-llms-txt-link:hover {
+  /* color: var(--color-fd-foreground, hsl(0 0% 10%));
+  border-color: var(--color-fd-foreground, hsl(0 0% 10%)); */
+  text-decoration: none;
+}
+
 /* ─── Code block copy button: show on hover ────────────────────────── */
 
 figure.shiki > button,

package/styles/darksharp.css

@@ -408,7 +408,7 @@ article a[class*="text-fd-muted-foreground"] {
   border-radius: 2px;
 }
 
-.fd-ai-fm-thinking-dot {
+.fd-ai-loader-typing-dot {
   border-radius: 2px;
 }
 

package/styles/pixel-border.css

@@ -425,6 +425,29 @@ figure.shiki > div:first-child {
   font-family: var(--fd-font-mono, var(--font-geist-mono, ui-monospace, monospace));
   text-transform: uppercase;
 }
+/* llms.txt links */
+.fd-llms-txt-links {
+  display: inline-flex;
+  align-items: center;
+  gap: 0.5rem;
+}
+
+.fd-llms-txt-link {
+  color: var(--color-fd-muted-foreground, hsl(0 0% 45%));
+  font-size: 0.65rem !important;
+  font-family: var(--fd-font-mono, ui-monospace, SFMono-Regular, 'SF Mono', Menlo, Consolas, monospace);
+  text-decoration: none;
+  padding: 0.015rem 0.4rem !important;
+  border-radius: 0px !important; 
+  border: 0.5px solid var(--color-fd-border, hsl(0 0% 80% / 50%));
+  transition: color 150ms, border-color 150ms;
+}
+
+.fd-llms-txt-link:hover {
+  color: var(--color-fd-foreground, hsl(0 0% 10%)) !important;
+  border: 0.5px solid var(--color-fd-muted-foreground, hsl(0 0% 10% / 10%)) !important;
+  text-decoration: none;
+}
 
 /* ─── Page Actions (pixel-border overrides) ───────────────────────── */
 
@@ -533,13 +556,13 @@ figure.shiki > div:first-child {
   letter-spacing: 0.06em;
 }
 
-.fd-ai-loading-text {
+.fd-ai-loader-shimmer-text {
   text-transform: uppercase;
   letter-spacing: 0.04em;
   font-size: 11px;
 }
 
-.fd-ai-loading-dot {
+.fd-ai-loader-typing-dot {
   border-radius: 0;
   width: 4px;
   height: 4px;
@@ -617,11 +640,7 @@ figure.shiki > div:first-child {
   font-size: 11px;
 }
 
-.fd-ai-fm-thinking-dot {
-  border-radius: 0;
-  width: 5px;
-  height: 5px;
-}
+/* Full-modal now uses .fd-ai-loader-typing-dot (see above) */
 
 /* ─── Code blocks (pixel-border) ─────────────────────────────────── */