@farming-labs/theme 0.1.60 → 0.1.63

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

@@ -16,7 +16,8 @@ declare function DocsSearchDialog({
   loaderVariant,
   loadingComponentHtml,
   models,
-  defaultModelId
+  defaultModelId,
+  analytics
 }: {
   open: boolean;
   onOpenChange: (open: boolean) => void;
@@ -27,6 +28,7 @@ declare function DocsSearchDialog({
   loadingComponentHtml?: string;
   models?: AIModelOption[];
   defaultModelId?: string;
+  analytics?: boolean;
 }): react.ReactPortal | null;
 type FloatingPosition = "bottom-right" | "bottom-left" | "bottom-center";
 type FloatingStyle = "panel" | "modal" | "popover" | "full-modal";
@@ -40,7 +42,8 @@ declare function FloatingAIChat({
   loaderVariant,
   loadingComponentHtml,
   models,
-  defaultModelId
+  defaultModelId,
+  analytics
 }: {
   api?: string;
   position?: FloatingPosition;
@@ -52,6 +55,7 @@ declare function FloatingAIChat({
   loadingComponentHtml?: string;
   models?: AIModelOption[];
   defaultModelId?: string;
+  analytics?: boolean;
 }): react_jsx_runtime0.JSX.Element | null;
 declare function AIModalDialog({
   open,
@@ -62,7 +66,8 @@ declare function AIModalDialog({
   loaderVariant,
   loadingComponentHtml,
   models,
-  defaultModelId
+  defaultModelId,
+  analytics
 }: {
   open: boolean;
   onOpenChange: (open: boolean) => void;
@@ -73,6 +78,7 @@ declare function AIModalDialog({
   loadingComponentHtml?: string;
   models?: AIModelOption[];
   defaultModelId?: string;
+  analytics?: boolean;
 }): react.ReactPortal | null;
 //#endregion
 export { AIModalDialog, DocsSearchDialog, FloatingAIChat };

package/dist/ai-search-dialog.mjs

@@ -1,5 +1,6 @@
 "use client";
 
+import { emitClientAnalyticsEvent } from "./client-analytics.mjs";
 import { useCallback, useEffect, useRef, useState } from "react";
 import { createPortal } from "react-dom";
 import { Fragment as Fragment$1, jsx, jsxs } from "react/jsx-runtime";
@@ -345,7 +346,7 @@ function ModelSelector({ models, selectedId, onChange, disabled }) {
 		})]
 	});
 }
-function AIChat({ api, messages, setMessages, aiInput, setAiInput, isStreaming, setIsStreaming, suggestedQuestions, aiLabel, loaderVariant, loadingComponentHtml, models, defaultModelId }) {
+function AIChat({ api, messages, setMessages, aiInput, setAiInput, isStreaming, setIsStreaming, suggestedQuestions, aiLabel, loaderVariant, loadingComponentHtml, models, defaultModelId, analytics, surface = "chat" }) {
 	const label = aiLabel || "AI";
 	const aiInputRef = useRef(null);
 	const messagesEndRef = useRef(null);
@@ -373,6 +374,16 @@ function AIChat({ api, messages, setMessages, aiInput, setAiInput, isStreaming,
 			role: "assistant",
 			content: ""
 		}]);
+		const startedAt = Date.now();
+		if (analytics) emitClientAnalyticsEvent({
+			type: "ai_question",
+			properties: {
+				surface,
+				questionLength: question.length,
+				messageCount: newMessages.length,
+				model: effectiveModelId
+			}
+		});
 		try {
 			const res = await fetch(api, {
 				method: "POST",
@@ -395,6 +406,15 @@ function AIChat({ api, messages, setMessages, aiInput, setAiInput, isStreaming,
 					content: errMsg
 				}]);
 				setIsStreaming(false);
+				if (analytics) emitClientAnalyticsEvent({
+					type: "ai_error",
+					properties: {
+						surface,
+						status: res.status,
+						questionLength: question.length,
+						durationMs: Math.max(0, Date.now() - startedAt)
+					}
+				});
 				return;
 			}
 			const reader = res.body.getReader();
@@ -426,11 +446,29 @@ function AIChat({ api, messages, setMessages, aiInput, setAiInput, isStreaming,
 				role: "assistant",
 				content: assistantContent
 			}]);
+			if (analytics) emitClientAnalyticsEvent({
+				type: "ai_response",
+				properties: {
+					surface,
+					questionLength: question.length,
+					responseLength: assistantContent.length,
+					durationMs: Math.max(0, Date.now() - startedAt),
+					model: effectiveModelId
+				}
+			});
 		} catch {
 			setMessages([...newMessages, {
 				role: "assistant",
 				content: "Failed to connect. Please try again."
 			}]);
+			if (analytics) emitClientAnalyticsEvent({
+				type: "ai_error",
+				properties: {
+					surface,
+					questionLength: question.length,
+					durationMs: Math.max(0, Date.now() - startedAt)
+				}
+			});
 		}
 		setIsStreaming(false);
 	}, [
@@ -440,7 +478,9 @@ function AIChat({ api, messages, setMessages, aiInput, setAiInput, isStreaming,
 		setMessages,
 		setAiInput,
 		setIsStreaming,
-		effectiveModelId
+		effectiveModelId,
+		analytics,
+		surface
 	]);
 	const handleAskAI = useCallback(async () => {
 		await submitQuestion(aiInput);
@@ -527,6 +567,10 @@ function AIChat({ api, messages, setMessages, aiInput, setAiInput, isStreaming,
 						onClick: () => {
 							setMessages([]);
 							setAiInput("");
+							if (analytics) emitClientAnalyticsEvent({
+								type: "ai_clear",
+								properties: { surface }
+							});
 						},
 						className: "fd-ai-clear-btn",
 						children: "Clear chat"
@@ -556,7 +600,7 @@ function AIChat({ api, messages, setMessages, aiInput, setAiInput, isStreaming,
 		})]
 	});
 }
-function DocsSearchDialog({ open, onOpenChange, api = "/api/docs", suggestedQuestions, aiLabel, loaderVariant, loadingComponentHtml, models, defaultModelId }) {
+function DocsSearchDialog({ open, onOpenChange, api = "/api/docs", suggestedQuestions, aiLabel, loaderVariant, loadingComponentHtml, models, defaultModelId, analytics = false }) {
 	const [tab, setTab] = useState("search");
 	const [searchQuery, setSearchQuery] = useState("");
 	const [searchResults, setSearchResults] = useState([]);
@@ -572,6 +616,13 @@ function DocsSearchDialog({ open, onOpenChange, api = "/api/docs", suggestedQues
 	})() || (Array.isArray(models) && models.length > 0 ? models[0].id : void 0);
 	useEffect(() => {
 		if (open) {
+			if (analytics) emitClientAnalyticsEvent({
+				type: "search_open",
+				properties: {
+					mode: "ai-dialog",
+					tab
+				}
+			});
 			setSearchQuery("");
 			setSearchResults([]);
 			setActiveIndex(0);
@@ -579,7 +630,11 @@ function DocsSearchDialog({ open, onOpenChange, api = "/api/docs", suggestedQues
 				if (tab === "search") searchInputRef.current?.focus();
 			}, 50);
 		}
-	}, [open, tab]);
+	}, [
+		analytics,
+		open,
+		tab
+	]);
 	useEffect(() => {
 		if (!open) return;
 		const handler = (e) => {
@@ -603,19 +658,40 @@ function DocsSearchDialog({ open, onOpenChange, api = "/api/docs", suggestedQues
 		}
 		setIsSearching(true);
 		const timer = setTimeout(async () => {
+			const startedAt = Date.now();
 			try {
 				const requestUrl = new URL(api, window.location.origin);
 				requestUrl.searchParams.set("query", searchQuery);
 				const res = await fetch(requestUrl.toString());
 				if (res.ok) {
-					setSearchResults(await res.json());
+					const data = await res.json();
+					setSearchResults(data);
 					setActiveIndex(0);
+					if (analytics) emitClientAnalyticsEvent({
+						type: "search_query",
+						properties: {
+							mode: "ai-dialog",
+							queryLength: searchQuery.length,
+							resultCount: Array.isArray(data) ? data.length : 0,
+							durationMs: Math.max(0, Date.now() - startedAt)
+						}
+					});
 				}
-			} catch {}
+			} catch {
+				if (analytics) emitClientAnalyticsEvent({
+					type: "search_error",
+					properties: {
+						mode: "ai-dialog",
+						queryLength: searchQuery.length,
+						durationMs: Math.max(0, Date.now() - startedAt)
+					}
+				});
+			}
 			setIsSearching(false);
 		}, 150);
 		return () => clearTimeout(timer);
 	}, [
+		analytics,
 		searchQuery,
 		api,
 		tab
@@ -630,6 +706,17 @@ function DocsSearchDialog({ open, onOpenChange, api = "/api/docs", suggestedQues
 		} else if (e.key === "Enter" && searchResults[activeIndex]) {
 			e.preventDefault();
 			onOpenChange(false);
+			if (analytics) emitClientAnalyticsEvent({
+				type: "search_result_click",
+				path: searchResults[activeIndex].url,
+				properties: {
+					mode: "ai-dialog",
+					resultId: searchResults[activeIndex].id,
+					resultUrl: searchResults[activeIndex].url,
+					resultType: searchResults[activeIndex].type,
+					queryLength: searchQuery.length
+				}
+			});
 			window.location.href = searchResults[activeIndex].url;
 		}
 	};
@@ -662,7 +749,16 @@ function DocsSearchDialog({ open, onOpenChange, api = "/api/docs", suggestedQues
 						children: [/* @__PURE__ */ jsx(SearchIcon, {}), " Search"]
 					}),
 					/* @__PURE__ */ jsxs("button", {
-						onClick: () => setTab("ai"),
+						onClick: () => {
+							setTab("ai");
+							if (analytics) emitClientAnalyticsEvent({
+								type: "ai_open",
+								properties: {
+									mode: "ai-dialog",
+									trigger: "tab"
+								}
+							});
+						},
 						className: "fd-ai-tab",
 						"data-active": tab === "ai",
 						children: [
@@ -712,6 +808,17 @@ function DocsSearchDialog({ open, onOpenChange, api = "/api/docs", suggestedQues
 					children: searchResults.length > 0 ? searchResults.map((result, i) => /* @__PURE__ */ jsxs("button", {
 						onClick: () => {
 							onOpenChange(false);
+							if (analytics) emitClientAnalyticsEvent({
+								type: "search_result_click",
+								path: result.url,
+								properties: {
+									mode: "ai-dialog",
+									resultId: result.id,
+									resultUrl: result.url,
+									resultType: result.type,
+									queryLength: searchQuery.length
+								}
+							});
 							window.location.href = result.url;
 						},
 						onMouseEnter: () => setActiveIndex(i),
@@ -740,7 +847,9 @@ function DocsSearchDialog({ open, onOpenChange, api = "/api/docs", suggestedQues
 				loaderVariant,
 				loadingComponentHtml,
 				models,
-				defaultModelId: effectiveModelId
+				defaultModelId: effectiveModelId,
+				analytics,
+				surface: "ai-dialog"
 			})
 		]
 	})] }), document.body);
@@ -814,7 +923,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, loaderVariant, loadingComponentHtml, models, defaultModelId }) {
+function FloatingAIChat({ api = "/api/docs", position = "bottom-right", floatingStyle = "panel", triggerComponentHtml, suggestedQuestions, aiLabel, loaderVariant, loadingComponentHtml, models, defaultModelId, analytics = false }) {
 	const [mounted, setMounted] = useState(false);
 	const [isOpen, setIsOpen] = useState(false);
 	const [messages, setMessages] = useState([]);
@@ -823,15 +932,27 @@ function FloatingAIChat({ api = "/api/docs", position = "bottom-right", floating
 	useEffect(() => {
 		setMounted(true);
 	}, []);
+	const closeFloatingAI = useCallback((trigger) => {
+		setIsOpen((wasOpen) => {
+			if (wasOpen && analytics) emitClientAnalyticsEvent({
+				type: "ai_close",
+				properties: {
+					mode: floatingStyle === "full-modal" ? "full-modal" : "floating",
+					trigger
+				}
+			});
+			return false;
+		});
+	}, [analytics, floatingStyle]);
 	useEffect(() => {
 		if (isOpen) {
 			const handler = (e) => {
-				if (e.key === "Escape") setIsOpen(false);
+				if (e.key === "Escape") closeFloatingAI("escape");
 			};
 			document.addEventListener("keydown", handler);
 			return () => document.removeEventListener("keydown", handler);
 		}
-	}, [isOpen]);
+	}, [closeFloatingAI, isOpen]);
 	useEffect(() => {
 		if (isOpen && (floatingStyle === "modal" || floatingStyle === "full-modal")) document.body.style.overflow = "hidden";
 		else document.body.style.overflow = "";
@@ -844,6 +965,7 @@ function FloatingAIChat({ api = "/api/docs", position = "bottom-right", floating
 		api,
 		isOpen,
 		setIsOpen,
+		closeAI: closeFloatingAI,
 		messages,
 		setMessages,
 		aiInput,
@@ -857,7 +979,8 @@ function FloatingAIChat({ api = "/api/docs", position = "bottom-right", floating
 		triggerComponentHtml,
 		position,
 		models,
-		defaultModelId
+		defaultModelId,
+		analytics
 	});
 	const btnPosition = BTN_POSITIONS[position] || BTN_POSITIONS["bottom-right"];
 	const isModal = floatingStyle === "modal";
@@ -865,7 +988,7 @@ function FloatingAIChat({ api = "/api/docs", position = "bottom-right", floating
 	const aiName = aiLabel || "AI";
 	return createPortal(/* @__PURE__ */ jsxs(Fragment$1, { children: [
 		isOpen && isModal && /* @__PURE__ */ jsx("div", {
-			onClick: () => setIsOpen(false),
+			onClick: () => closeFloatingAI("overlay"),
 			className: "fd-ai-overlay"
 		}),
 		isOpen && /* @__PURE__ */ jsxs("div", {
@@ -888,7 +1011,7 @@ function FloatingAIChat({ api = "/api/docs", position = "bottom-right", floating
 						children: "ESC"
 					}),
 					/* @__PURE__ */ jsx("button", {
-						onClick: () => setIsOpen(false),
+						onClick: () => closeFloatingAI("button"),
 						className: "fd-ai-close-btn",
 						children: /* @__PURE__ */ jsx(XIcon, {})
 					})
@@ -904,16 +1027,36 @@ function FloatingAIChat({ api = "/api/docs", position = "bottom-right", floating
 				suggestedQuestions,
 				aiLabel,
 				loaderVariant,
-				loadingComponentHtml
+				loadingComponentHtml,
+				analytics,
+				surface: "floating"
 			})]
 		}),
 		!isOpen && (triggerComponentHtml ? /* @__PURE__ */ jsx("div", {
-			onClick: () => setIsOpen(true),
+			onClick: () => {
+				setIsOpen(true);
+				if (analytics) emitClientAnalyticsEvent({
+					type: "ai_open",
+					properties: {
+						mode: "floating",
+						trigger: "custom-trigger"
+					}
+				});
+			},
 			className: "fd-ai-floating-trigger",
 			style: btnPosition,
 			dangerouslySetInnerHTML: { __html: triggerComponentHtml }
 		}) : /* @__PURE__ */ jsxs("button", {
-			onClick: () => setIsOpen(true),
+			onClick: () => {
+				setIsOpen(true);
+				if (analytics) emitClientAnalyticsEvent({
+					type: "ai_open",
+					properties: {
+						mode: "floating",
+						trigger: "button"
+					}
+				});
+			},
 			"aria-label": `Ask ${aiName}`,
 			className: "fd-ai-floating-btn",
 			style: btnPosition,
@@ -921,7 +1064,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, loaderVariant, loadingComponentHtml, triggerComponentHtml, position, models, defaultModelId }) {
+function FullModalAIChat({ api, isOpen, setIsOpen, closeAI, messages, setMessages, aiInput, setAiInput, isStreaming, setIsStreaming, suggestedQuestions, aiLabel, loaderVariant, loadingComponentHtml, triggerComponentHtml, position, models, defaultModelId, analytics }) {
 	const label = aiLabel || "AI";
 	const inputRef = useRef(null);
 	const listRef = useRef(null);
@@ -953,6 +1096,16 @@ function FullModalAIChat({ api, isOpen, setIsOpen, messages, setMessages, aiInpu
 			role: "assistant",
 			content: ""
 		}]);
+		const startedAt = Date.now();
+		if (analytics) emitClientAnalyticsEvent({
+			type: "ai_question",
+			properties: {
+				surface: "full-modal",
+				questionLength: question.length,
+				messageCount: newMessages.length,
+				model: effectiveModelId
+			}
+		});
 		try {
 			const res = await fetch(api, {
 				method: "POST",
@@ -975,6 +1128,15 @@ function FullModalAIChat({ api, isOpen, setIsOpen, messages, setMessages, aiInpu
 					content: errMsg
 				}]);
 				setIsStreaming(false);
+				if (analytics) emitClientAnalyticsEvent({
+					type: "ai_error",
+					properties: {
+						surface: "full-modal",
+						status: res.status,
+						questionLength: question.length,
+						durationMs: Math.max(0, Date.now() - startedAt)
+					}
+				});
 				return;
 			}
 			const reader = res.body.getReader();
@@ -1006,11 +1168,29 @@ function FullModalAIChat({ api, isOpen, setIsOpen, messages, setMessages, aiInpu
 				role: "assistant",
 				content: assistantContent
 			}]);
+			if (analytics) emitClientAnalyticsEvent({
+				type: "ai_response",
+				properties: {
+					surface: "full-modal",
+					questionLength: question.length,
+					responseLength: assistantContent.length,
+					durationMs: Math.max(0, Date.now() - startedAt),
+					model: effectiveModelId
+				}
+			});
 		} catch {
 			setMessages([...newMessages, {
 				role: "assistant",
 				content: "Failed to connect. Please try again."
 			}]);
+			if (analytics) emitClientAnalyticsEvent({
+				type: "ai_error",
+				properties: {
+					surface: "full-modal",
+					questionLength: question.length,
+					durationMs: Math.max(0, Date.now() - startedAt)
+				}
+			});
 		}
 		setIsStreaming(false);
 	}, [
@@ -1020,7 +1200,8 @@ function FullModalAIChat({ api, isOpen, setIsOpen, messages, setMessages, aiInpu
 		setMessages,
 		setAiInput,
 		setIsStreaming,
-		effectiveModelId
+		effectiveModelId,
+		analytics
 	]);
 	const canSend = !!(aiInput.trim() && !isStreaming);
 	const showSuggestions = messages.length === 0 && !isStreaming;
@@ -1033,12 +1214,12 @@ function FullModalAIChat({ api, isOpen, setIsOpen, messages, setMessages, aiInpu
 	return createPortal(/* @__PURE__ */ jsxs(Fragment$1, { children: [isOpen && /* @__PURE__ */ jsxs("div", {
 		className: "fd-ai-fm-overlay",
 		onClick: (e) => {
-			if (e.target === e.currentTarget) setIsOpen(false);
+			if (e.target === e.currentTarget) closeAI("overlay");
 		},
 		children: [/* @__PURE__ */ jsx("div", {
 			className: "fd-ai-fm-topbar",
 			children: /* @__PURE__ */ jsx("button", {
-				onClick: () => setIsOpen(false),
+				onClick: () => closeAI("button"),
 				className: "fd-ai-fm-close-btn",
 				children: /* @__PURE__ */ jsx(XIcon, {})
 			})
@@ -1071,10 +1252,28 @@ function FullModalAIChat({ api, isOpen, setIsOpen, messages, setMessages, aiInpu
 		className: `fd-ai-fm-input-bar ${isOpen ? "fd-ai-fm-input-bar--open" : "fd-ai-fm-input-bar--closed"}`,
 		style: isOpen ? void 0 : btnPosition,
 		children: !isOpen ? triggerComponentHtml ? /* @__PURE__ */ jsx("div", {
-			onClick: () => setIsOpen(true),
+			onClick: () => {
+				setIsOpen(true);
+				if (analytics) emitClientAnalyticsEvent({
+					type: "ai_open",
+					properties: {
+						mode: "full-modal",
+						trigger: "custom-trigger"
+					}
+				});
+			},
 			dangerouslySetInnerHTML: { __html: triggerComponentHtml }
 		}) : /* @__PURE__ */ jsxs("button", {
-			onClick: () => setIsOpen(true),
+			onClick: () => {
+				setIsOpen(true);
+				if (analytics) emitClientAnalyticsEvent({
+					type: "ai_open",
+					properties: {
+						mode: "full-modal",
+						trigger: "button"
+					}
+				});
+			},
 			className: "fd-ai-fm-trigger-btn",
 			"aria-label": `Ask ${label}`,
 			children: [/* @__PURE__ */ jsx(SparklesIcon, { size: 16 }), /* @__PURE__ */ jsxs("span", { children: ["Ask ", label] })]
@@ -1135,6 +1334,10 @@ function FullModalAIChat({ api, isOpen, setIsOpen, messages, setMessages, aiInpu
 							if (!isStreaming) {
 								setMessages([]);
 								setAiInput("");
+								if (analytics) emitClientAnalyticsEvent({
+									type: "ai_clear",
+									properties: { surface: "full-modal" }
+								});
 							}
 						},
 						"aria-disabled": isStreaming,
@@ -1165,18 +1368,28 @@ function TrashIcon() {
 		]
 	});
 }
-function AIModalDialog({ open, onOpenChange, api = "/api/docs", suggestedQuestions, aiLabel, loaderVariant, loadingComponentHtml, models, defaultModelId }) {
+function AIModalDialog({ open, onOpenChange, api = "/api/docs", suggestedQuestions, aiLabel, loaderVariant, loadingComponentHtml, models, defaultModelId, analytics = false }) {
 	const [messages, setMessages] = useState([]);
 	const [aiInput, setAiInput] = useState("");
 	const [isStreaming, setIsStreaming] = useState(false);
+	const closeModalAI = useCallback((trigger) => {
+		if (analytics) emitClientAnalyticsEvent({
+			type: "ai_close",
+			properties: {
+				mode: "modal",
+				trigger
+			}
+		});
+		onOpenChange(false);
+	}, [analytics, onOpenChange]);
 	useEffect(() => {
 		if (!open) return;
 		const handler = (e) => {
-			if (e.key === "Escape") onOpenChange(false);
+			if (e.key === "Escape") closeModalAI("escape");
 		};
 		document.addEventListener("keydown", handler);
 		return () => document.removeEventListener("keydown", handler);
-	}, [open, onOpenChange]);
+	}, [closeModalAI, open]);
 	useEffect(() => {
 		if (open) document.body.style.overflow = "hidden";
 		else document.body.style.overflow = "";
@@ -1187,7 +1400,7 @@ function AIModalDialog({ open, onOpenChange, api = "/api/docs", suggestedQuestio
 	if (!open) return null;
 	const aiName = aiLabel || "AI";
 	return createPortal(/* @__PURE__ */ jsxs(Fragment$1, { children: [/* @__PURE__ */ jsx("div", {
-		onClick: () => onOpenChange(false),
+		onClick: () => closeModalAI("overlay"),
 		className: "fd-ai-overlay"
 	}), /* @__PURE__ */ jsxs("div", {
 		role: "dialog",
@@ -1216,7 +1429,7 @@ function AIModalDialog({ open, onOpenChange, api = "/api/docs", suggestedQuestio
 						children: "ESC"
 					}),
 					/* @__PURE__ */ jsx("button", {
-						onClick: () => onOpenChange(false),
+						onClick: () => closeModalAI("button"),
 						className: "fd-ai-close-btn",
 						children: /* @__PURE__ */ jsx(XIcon, {})
 					})
@@ -1235,7 +1448,9 @@ function AIModalDialog({ open, onOpenChange, api = "/api/docs", suggestedQuestio
 				loaderVariant,
 				loadingComponentHtml,
 				models,
-				defaultModelId
+				defaultModelId,
+				analytics,
+				surface: "modal"
 			}),
 			/* @__PURE__ */ jsx("div", {
 				className: "fd-ai-modal-footer",
@@ -1245,6 +1460,10 @@ function AIModalDialog({ open, onOpenChange, api = "/api/docs", suggestedQuestio
 						if (!isStreaming) {
 							setMessages([]);
 							setAiInput("");
+							if (analytics) emitClientAnalyticsEvent({
+								type: "ai_clear",
+								properties: { surface: "modal" }
+							});
 						}
 					},
 					"aria-disabled": isStreaming,

package/dist/client-analytics.mjs

@@ -0,0 +1,23 @@
+"use client";
+
+//#region src/client-analytics.ts
+function emitClientAnalyticsEvent(event) {
+	if (typeof window === "undefined") return;
+	const normalized = {
+		...event,
+		source: "client",
+		path: window.location.pathname,
+		url: window.location.href,
+		referrer: document.referrer || void 0,
+		timestamp: (/* @__PURE__ */ new Date()).toISOString()
+	};
+	const target = window;
+	try {
+		if (target.__fdAnalytics__) Promise.resolve(target.__fdAnalytics__(normalized)).catch(() => {});
+		else target.__fdAnalyticsQueue__ = [...target.__fdAnalyticsQueue__ ?? [], normalized].slice(-50);
+		window.dispatchEvent(new CustomEvent("fd:analytics", { detail: normalized }));
+	} catch {}
+}
+
+//#endregion
+export { emitClientAnalyticsEvent };

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

@@ -17,6 +17,7 @@ interface DocsAIFeaturesProps {
     label: string;
   }[];
   defaultModelId?: string;
+  analytics?: boolean;
 }
 declare function DocsAIFeatures({
   mode,
@@ -30,7 +31,8 @@ declare function DocsAIFeatures({
   loaderVariant,
   loadingComponentHtml,
   models,
-  defaultModelId
+  defaultModelId,
+  analytics
 }: DocsAIFeaturesProps): react_jsx_runtime0.JSX.Element;
 //#endregion
 export { DocsAIFeatures };