@farming-labs/theme 0.0.2-beta.23 → 0.0.2-beta.26

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-layout.mjs

@@ -229,7 +229,7 @@ function resolveSidebar(sidebar) {
 	if (sidebar === false) return { enabled: false };
 	return {
 		enabled: sidebar.enabled !== false,
-		component: sidebar.component,
+		componentFn: typeof sidebar.component === "function" ? sidebar.component : void 0,
 		footer: sidebar.footer,
 		banner: sidebar.banner,
 		collapsible: sidebar.collapsible,
@@ -343,7 +343,8 @@ function createDocsLayout(config) {
 	const forcedTheme = themeSwitch.enabled === false && toggleConfig?.default && toggleConfig.default !== "system" ? toggleConfig.default : void 0;
 	const resolvedSidebar = resolveSidebar(config.sidebar);
 	const sidebarFlat = resolvedSidebar.flat;
-	const { flat: _sidebarFlat, ...sidebarProps } = resolvedSidebar;
+	const sidebarComponentFn = resolvedSidebar.componentFn;
+	const { flat: _sidebarFlat, componentFn: _componentFn, ...sidebarProps } = resolvedSidebar;
 	const breadcrumbConfig = config.breadcrumb;
 	const breadcrumbEnabled = breadcrumbConfig === void 0 || breadcrumbConfig === true || typeof breadcrumbConfig === "object" && breadcrumbConfig.enabled !== false;
 	const colors = config.theme?._userColorOverrides;
@@ -375,18 +376,26 @@ 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);
 	return function DocsLayoutWrapper({ children }) {
+		const tree = buildTree(config, !!sidebarFlat);
+		const finalSidebarProps = { ...sidebarProps };
+		if (sidebarComponentFn) finalSidebarProps.component = sidebarComponentFn({
+			tree,
+			collapsible: sidebarProps.collapsible !== false,
+			flat: !!sidebarFlat
+		});
 		return /* @__PURE__ */ jsxs(DocsLayout, {
-			tree: buildTree(config, !!sidebarFlat),
+			tree,
 			nav: {
 				title: navTitle,
 				url: navUrl
 			},
 			themeSwitch,
-			sidebar: sidebarProps,
+			sidebar: finalSidebarProps,
 			...aiMode === "sidebar-icon" && aiEnabled ? { searchToggle: { components: { lg: /* @__PURE__ */ jsx(SidebarSearchWithAI, {}) } } } : {},
 			children: [
 				/* @__PURE__ */ jsx(ColorStyle, { colors }),
@@ -401,6 +410,7 @@ function createDocsLayout(config) {
 					triggerComponentHtml: aiTriggerComponentHtml,
 					suggestedQuestions: aiSuggestedQuestions,
 					aiLabel,
+					loaderVariant: aiLoaderVariant,
 					loadingComponentHtml: aiLoadingComponentHtml
 				}),
 				/* @__PURE__ */ jsx(DocsPageClient, {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@farming-labs/theme",
-  "version": "0.0.2-beta.23",
+  "version": "0.0.2-beta.26",
   "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.23"
+    "@farming-labs/docs": "0.0.2-beta.26"
   },
   "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

@@ -390,8 +390,9 @@ figure.shiki:has(figcaption) figcaption {
 
 .fd-page-footer {
   display: flex;
+  flex-wrap: wrap;
   align-items: center;
-  gap: 1rem;
+  gap: 0.75rem 1rem;
   margin-top: auto;
   padding-top: 1.5rem;
   border-top: 1px solid var(--color-fd-border, hsl(0 0% 80% / 50%));
@@ -409,6 +410,13 @@ figure.shiki:has(figcaption) figcaption {
   margin-left: auto;
 }
 
+@media (max-width: 640px) {
+  .fd-last-updated-footer {
+    margin-left: 0;
+    width: 100%;
+  }
+}
+
 .fd-llms-txt-links {
   display: inline-flex;
   align-items: center;
@@ -427,8 +435,8 @@ figure.shiki:has(figcaption) figcaption {
 }
 
 .fd-llms-txt-link:hover {
-  /* color: var(--color-fd-foreground, hsl(0 0% 10%));
-  border-color: var(--color-fd-foreground, hsl(0 0% 10%)); */
+  color: var(--color-fd-foreground, hsl(0 0% 10%));
+  border-color: var(--color-fd-foreground, hsl(0 0% 10%));
   text-decoration: none;
 }
 

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

@@ -460,11 +460,17 @@ figure.shiki > div:first-child {
 .fd-page-action-menu {
   border-radius: 0 !important;
   box-shadow: 0 4px 24px hsl(0 0% 0% / 0.5);
+  padding: 0px !important;
+  box-shadow: 2px 2px 0 0 var(--color-fd-border, #262626);
 }
 
 .fd-page-action-menu-item {
   border-radius: 0 !important;
-  font-size: 0.8rem;
+  font-size: 0.68rem;
+  border-top: 1px solid var(--color-fd-border, #262626);
+  text-transform: uppercase;
+  color: var(--color-fd-muted-foreground, hsl(0 0% 45%));
+  font-family: var(--fd-font-mono, var(--font-geist-mono, ui-monospace, monospace)) !important;
 }
 
 /* ─── AI Chat (pixel-border — zero radius, pixel-art, monospace) ── */
@@ -556,13 +562,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;
@@ -640,11 +646,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) ─────────────────────────────────── */