@farming-labs/theme 0.1.60 → 0.1.63

package/dist/docs-api.mjs

@@ -3,7 +3,7 @@ import { getNextAppDir } from "./get-app-dir.mjs";
 import fs from "node:fs";
 import path from "node:path";
 import matter from "gray-matter";
-import { normalizeDocsRelated, performDocsSearch, renderDocsRelatedMarkdownLines, resolveChangelogConfig, resolveDocsI18n, resolveDocsLocale, resolveSearchRequestConfig } from "@farming-labs/docs";
+import { emitDocsAnalyticsEvent, normalizeDocsRelated, performDocsSearch, renderDocsRelatedMarkdownLines, resolveChangelogConfig, resolveDocsI18n, resolveDocsLocale, resolveSearchRequestConfig } from "@farming-labs/docs";
 import { createDocsMcpHttpHandler, createFilesystemDocsMcpSource, resolveDocsMcpConfig } from "@farming-labs/docs/server";
 
 //#region src/docs-api.ts
@@ -805,15 +805,30 @@ function acceptsMarkdown(request) {
 	});
 }
 function resolveMarkdownRequest(entry, url, request) {
-	if (url.searchParams.get("format")?.trim() === "markdown") return { requestedPath: url.searchParams.get("path")?.trim() ?? "" };
+	if (url.searchParams.get("format")?.trim() === "markdown") return {
+		requestedPath: url.searchParams.get("path")?.trim() ?? "",
+		delivery: "api_format"
+	};
 	const pathname = normalizeUrlPath(url.pathname);
 	const normalizedEntry = `/${normalizePathSegment(entry)}`;
-	if (pathname === `${normalizedEntry}.md`) return { requestedPath: "" };
+	if (pathname === `${normalizedEntry}.md`) return {
+		requestedPath: "",
+		delivery: "md_route"
+	};
 	const slugPrefix = `${normalizedEntry}/`;
-	if (pathname.startsWith(slugPrefix) && pathname.endsWith(".md")) return { requestedPath: pathname.slice(slugPrefix.length, -3) };
+	if (pathname.startsWith(slugPrefix) && pathname.endsWith(".md")) return {
+		requestedPath: pathname.slice(slugPrefix.length, -3),
+		delivery: "md_route"
+	};
 	if (acceptsMarkdown(request)) {
-		if (pathname === normalizedEntry) return { requestedPath: "" };
-		if (pathname.startsWith(slugPrefix)) return { requestedPath: pathname.slice(slugPrefix.length) };
+		if (pathname === normalizedEntry) return {
+			requestedPath: "",
+			delivery: "accept_header"
+		};
+		if (pathname.startsWith(slugPrefix)) return {
+			requestedPath: pathname.slice(slugPrefix.length),
+			delivery: "accept_header"
+		};
 	}
 	return null;
 }
@@ -900,20 +915,60 @@ function resolveModelAndProvider(aiConfig, requestedModelId) {
 		apiKey
 	};
 }
-async function handleAskAI(request, indexes, aiConfig) {
+async function handleAskAI(request, indexes, aiConfig, analytics, analyticsContext = {}) {
+	const url = new URL(request.url);
+	const requestStartedAt = Date.now();
 	let body;
 	try {
 		body = await request.json();
 	} catch {
+		await emitDocsAnalyticsEvent(analytics, {
+			type: "api_ai_error",
+			source: "server",
+			url: request.url,
+			path: url.pathname,
+			locale: analyticsContext.locale,
+			properties: {
+				reason: "invalid_json",
+				durationMs: Math.max(0, Date.now() - requestStartedAt)
+			}
+		});
 		return Response.json({ error: "Invalid JSON body. Expected { messages: [...] }" }, { status: 400 });
 	}
 	const messages = body.messages;
-	if (!Array.isArray(messages) || messages.length === 0) return Response.json({ error: "messages array is required and must not be empty." }, { status: 400 });
+	if (!Array.isArray(messages) || messages.length === 0) {
+		await emitDocsAnalyticsEvent(analytics, {
+			type: "api_ai_error",
+			source: "server",
+			url: request.url,
+			path: url.pathname,
+			locale: analyticsContext.locale,
+			properties: {
+				reason: "missing_messages",
+				durationMs: Math.max(0, Date.now() - requestStartedAt)
+			}
+		});
+		return Response.json({ error: "messages array is required and must not be empty." }, { status: 400 });
+	}
 	const lastUserMessage = [...messages].reverse().find((m) => m.role === "user");
-	if (!lastUserMessage) return Response.json({ error: "At least one user message is required." }, { status: 400 });
+	if (!lastUserMessage) {
+		await emitDocsAnalyticsEvent(analytics, {
+			type: "api_ai_error",
+			source: "server",
+			url: request.url,
+			path: url.pathname,
+			locale: analyticsContext.locale,
+			properties: {
+				reason: "missing_user_message",
+				messageCount: messages.length,
+				durationMs: Math.max(0, Date.now() - requestStartedAt)
+			}
+		});
+		return Response.json({ error: "At least one user message is required." }, { status: 400 });
+	}
 	const maxResults = aiConfig.maxResults ?? 5;
 	const query = lastUserMessage.content;
-	const context = indexes.map((doc) => {
+	const scored = indexes.map((doc) => {
 		const q = query.toLowerCase();
 		const titleMatch = doc.title.toLowerCase().includes(q) ? 10 : 0;
 		const contentMatch = q.split(/\s+/).reduce((score, word) => {
@@ -923,14 +978,47 @@ async function handleAskAI(request, indexes, aiConfig) {
 			...doc,
 			score: titleMatch + contentMatch
 		};
-	}).filter((d) => d.score > 0).sort((a, b) => b.score - a.score).slice(0, maxResults).map((doc) => `## ${doc.title}\nURL: ${doc.url}\n${doc.description ? `Description: ${doc.description}\n` : ""}\n${doc.content}`).join("\n\n---\n\n");
+	}).filter((d) => d.score > 0).sort((a, b) => b.score - a.score).slice(0, maxResults);
+	const context = scored.map((doc) => `## ${doc.title}\nURL: ${doc.url}\n${doc.description ? `Description: ${doc.description}\n` : ""}\n${doc.content}`).join("\n\n---\n\n");
 	const systemPrompt = aiConfig.systemPrompt ?? DEFAULT_SYSTEM_PROMPT;
 	const llmMessages = [{
 		role: "system",
 		content: context ? `${systemPrompt}\n\n---\n\nDocumentation context:\n\n${context}` : systemPrompt
 	}, ...messages.filter((m) => m.role !== "system")];
 	const resolved = resolveModelAndProvider(aiConfig, typeof body.model === "string" && body.model.trim().length > 0 ? body.model.trim() : void 0);
-	if (!resolved.apiKey) return Response.json({ error: `AI is enabled but no API key was found. Either set apiKey in your docs.config ai section, configure a provider, or add OPENAI_API_KEY to your .env.local file.` }, { status: 500 });
+	if (!resolved.apiKey) {
+		await emitDocsAnalyticsEvent(analytics, {
+			type: "api_ai_error",
+			source: "server",
+			url: request.url,
+			path: url.pathname,
+			locale: analyticsContext.locale,
+			input: { question: query },
+			properties: {
+				reason: "missing_api_key",
+				messageCount: messages.length,
+				questionLength: query.length,
+				retrievedCount: scored.length,
+				model: resolved.model,
+				durationMs: Math.max(0, Date.now() - requestStartedAt)
+			}
+		});
+		return Response.json({ error: `AI is enabled but no API key was found. Either set apiKey in your docs.config ai section, configure a provider, or add OPENAI_API_KEY to your .env.local file.` }, { status: 500 });
+	}
+	await emitDocsAnalyticsEvent(analytics, {
+		type: "api_ai_request",
+		source: "server",
+		url: request.url,
+		path: url.pathname,
+		locale: analyticsContext.locale,
+		input: { question: query },
+		properties: {
+			messageCount: messages.length,
+			questionLength: query.length,
+			retrievedCount: scored.length,
+			model: resolved.model
+		}
+	});
 	const llmResponse = await fetch(`${resolved.baseUrl}/chat/completions`, {
 		method: "POST",
 		headers: {
@@ -945,8 +1033,40 @@ async function handleAskAI(request, indexes, aiConfig) {
 	});
 	if (!llmResponse.ok) {
 		const errText = await llmResponse.text().catch(() => "Unknown error");
+		await emitDocsAnalyticsEvent(analytics, {
+			type: "api_ai_error",
+			source: "server",
+			url: request.url,
+			path: url.pathname,
+			locale: analyticsContext.locale,
+			input: { question: query },
+			properties: {
+				reason: "llm_error",
+				status: llmResponse.status,
+				messageCount: messages.length,
+				questionLength: query.length,
+				retrievedCount: scored.length,
+				model: resolved.model,
+				durationMs: Math.max(0, Date.now() - requestStartedAt)
+			}
+		});
 		return Response.json({ error: `LLM API error (${llmResponse.status}): ${errText}` }, { status: 502 });
 	}
+	await emitDocsAnalyticsEvent(analytics, {
+		type: "api_ai_response",
+		source: "server",
+		url: request.url,
+		path: url.pathname,
+		locale: analyticsContext.locale,
+		input: { question: query },
+		properties: {
+			messageCount: messages.length,
+			questionLength: query.length,
+			retrievedCount: scored.length,
+			model: resolved.model,
+			durationMs: Math.max(0, Date.now() - requestStartedAt)
+		}
+	});
 	return new Response(llmResponse.body, { headers: {
 		"Content-Type": "text/event-stream",
 		"Cache-Control": "no-cache",
@@ -1026,6 +1146,7 @@ function generateLlmsTxt(indexes, options) {
 function createDocsAPI(options) {
 	const root = options?.rootDir ?? process.cwd();
 	const entry = options?.entry ?? readEntry(root);
+	const analytics = options?.analytics;
 	const appDir = getNextAppDir(root);
 	const contentDir = options?.contentDir ?? path.join(appDir, entry);
 	const changelogConfig = resolveChangelogConfig(options?.changelog);
@@ -1154,51 +1275,131 @@ function createDocsAPI(options) {
 		async GET(request) {
 			const ctx = resolveContextFromRequest(request);
 			const url = new URL(request.url);
-			if (resolveAgentSpecRequest(url)) return Response.json(buildAgentSpec({
-				origin: url.origin,
-				entry,
-				i18n,
-				search: searchConfig,
-				mcp: mcpConfig,
-				feedback: agentFeedbackConfig,
-				llms: llmsConfig
-			}), { headers: {
-				"Cache-Control": "public, max-age=0, s-maxage=3600",
-				"X-Robots-Tag": "noindex"
-			} });
+			if (resolveAgentSpecRequest(url)) {
+				await emitDocsAnalyticsEvent(analytics, {
+					type: "agent_spec_request",
+					source: "server",
+					url: request.url,
+					path: url.pathname,
+					locale: ctx.locale,
+					properties: { method: "GET" }
+				});
+				return Response.json(buildAgentSpec({
+					origin: url.origin,
+					entry,
+					i18n,
+					search: searchConfig,
+					mcp: mcpConfig,
+					feedback: agentFeedbackConfig,
+					llms: llmsConfig
+				}), { headers: {
+					"Cache-Control": "public, max-age=0, s-maxage=3600",
+					"X-Robots-Tag": "noindex"
+				} });
+			}
 			const agentFeedbackRequest = resolveAgentFeedbackRequest(url, agentFeedbackConfig);
 			if (agentFeedbackRequest) {
 				if (agentFeedbackRequest.kind === "submit") return Response.json({ error: "Method Not Allowed" }, {
 					status: 405,
 					headers: { Allow: "POST" }
 				});
+				await emitDocsAnalyticsEvent(analytics, {
+					type: "agent_feedback_schema",
+					source: "server",
+					url: request.url,
+					path: url.pathname,
+					locale: ctx.locale,
+					properties: { method: "GET" }
+				});
 				return new Response(JSON.stringify(agentFeedbackConfig.schema, null, 2), { headers: {
 					"Content-Type": "application/schema+json; charset=utf-8",
 					"Cache-Control": "public, max-age=0, s-maxage=3600",
 					"X-Robots-Tag": "noindex"
 				} });
 			}
-			if (resolveSkillRequest(url)) return new Response(readRootSkillDocument(root) ?? renderSkillDocument({
-				origin: url.origin,
-				entry,
-				i18n,
-				search: searchConfig,
-				mcp: mcpConfig,
-				feedback: agentFeedbackConfig,
-				llms: llmsConfig
-			}), { headers: {
-				"Content-Type": "text/markdown; charset=utf-8",
-				"Cache-Control": "public, max-age=0, s-maxage=3600",
-				"X-Robots-Tag": "noindex"
-			} });
+			if (resolveSkillRequest(url)) {
+				await emitDocsAnalyticsEvent(analytics, {
+					type: "skill_request",
+					source: "server",
+					url: request.url,
+					path: url.pathname,
+					locale: ctx.locale,
+					properties: { method: "GET" }
+				});
+				return new Response(readRootSkillDocument(root) ?? renderSkillDocument({
+					origin: url.origin,
+					entry,
+					i18n,
+					search: searchConfig,
+					mcp: mcpConfig,
+					feedback: agentFeedbackConfig,
+					llms: llmsConfig
+				}), { headers: {
+					"Content-Type": "text/markdown; charset=utf-8",
+					"Cache-Control": "public, max-age=0, s-maxage=3600",
+					"X-Robots-Tag": "noindex"
+				} });
+			}
 			const markdownRequest = resolveMarkdownRequest(entry, url, request);
 			if (markdownRequest) {
 				const document = await getMarkdownDocument(ctx, markdownRequest.requestedPath);
-				if (!document) return new Response("Not Found", {
-					status: 404,
-					headers: {
-						"Content-Type": "text/plain; charset=utf-8",
-						"X-Robots-Tag": "noindex"
+				if (!document) {
+					await emitDocsAnalyticsEvent(analytics, {
+						type: "agent_read",
+						source: "server",
+						url: request.url,
+						path: url.pathname,
+						locale: ctx.locale,
+						properties: {
+							requestedPath: markdownRequest.requestedPath,
+							delivery: markdownRequest.delivery,
+							found: false
+						}
+					});
+					await emitDocsAnalyticsEvent(analytics, {
+						type: "markdown_request",
+						source: "server",
+						url: request.url,
+						path: url.pathname,
+						locale: ctx.locale,
+						properties: {
+							requestedPath: markdownRequest.requestedPath,
+							delivery: markdownRequest.delivery,
+							found: false
+						}
+					});
+					return new Response("Not Found", {
+						status: 404,
+						headers: {
+							"Content-Type": "text/plain; charset=utf-8",
+							"X-Robots-Tag": "noindex"
+						}
+					});
+				}
+				await emitDocsAnalyticsEvent(analytics, {
+					type: "agent_read",
+					source: "server",
+					url: request.url,
+					path: url.pathname,
+					locale: ctx.locale,
+					properties: {
+						requestedPath: markdownRequest.requestedPath,
+						delivery: markdownRequest.delivery,
+						found: true,
+						contentLength: document.length
+					}
+				});
+				await emitDocsAnalyticsEvent(analytics, {
+					type: "markdown_request",
+					source: "server",
+					url: request.url,
+					path: url.pathname,
+					locale: ctx.locale,
+					properties: {
+						requestedPath: markdownRequest.requestedPath,
+						delivery: markdownRequest.delivery,
+						found: true,
+						contentLength: document.length
 					}
 				});
 				return new Response(document, { headers: {
@@ -1208,16 +1409,37 @@ function createDocsAPI(options) {
 				} });
 			}
 			const llmsFormat = resolveLlmsTxtFormat(url);
-			if (llmsFormat === "llms") return new Response(getLlmsContent(ctx).llmsTxt, { headers: {
-				"Content-Type": "text/plain; charset=utf-8",
-				"Cache-Control": "public, max-age=3600"
-			} });
-			if (llmsFormat === "llms-full") return new Response(getLlmsContent(ctx).llmsFullTxt, { headers: {
-				"Content-Type": "text/plain; charset=utf-8",
-				"Cache-Control": "public, max-age=3600"
-			} });
+			if (llmsFormat === "llms") {
+				await emitDocsAnalyticsEvent(analytics, {
+					type: "llms_request",
+					source: "server",
+					url: request.url,
+					path: url.pathname,
+					locale: ctx.locale,
+					properties: { format: "llms" }
+				});
+				return new Response(getLlmsContent(ctx).llmsTxt, { headers: {
+					"Content-Type": "text/plain; charset=utf-8",
+					"Cache-Control": "public, max-age=3600"
+				} });
+			}
+			if (llmsFormat === "llms-full") {
+				await emitDocsAnalyticsEvent(analytics, {
+					type: "llms_request",
+					source: "server",
+					url: request.url,
+					path: url.pathname,
+					locale: ctx.locale,
+					properties: { format: "llms-full" }
+				});
+				return new Response(getLlmsContent(ctx).llmsFullTxt, { headers: {
+					"Content-Type": "text/plain; charset=utf-8",
+					"Cache-Control": "public, max-age=3600"
+				} });
+			}
 			const query = url.searchParams.get("query")?.trim();
 			if (!query) return new Response(JSON.stringify([]), { headers: { "Content-Type": "application/json" } });
+			const searchStartedAt = Date.now();
 			const results = await performDocsSearch({
 				pages: getIndexes(ctx),
 				query,
@@ -1226,31 +1448,101 @@ function createDocsAPI(options) {
 				pathname: url.searchParams.get("pathname") ?? void 0,
 				siteTitle: llmsConfig.siteTitle ?? "Documentation"
 			});
+			await emitDocsAnalyticsEvent(analytics, {
+				type: "api_search",
+				source: "server",
+				url: request.url,
+				path: url.pathname,
+				locale: ctx.locale,
+				input: { query },
+				properties: {
+					queryLength: query.length,
+					resultCount: results.length,
+					pathname: url.searchParams.get("pathname") ?? void 0,
+					durationMs: Math.max(0, Date.now() - searchStartedAt)
+				}
+			});
 			return new Response(JSON.stringify(results), { headers: { "Content-Type": "application/json" } });
 		},
 		async POST(request) {
-			const agentFeedbackRequest = resolveAgentFeedbackRequest(new URL(request.url), agentFeedbackConfig);
+			const url = new URL(request.url);
+			const agentFeedbackRequest = resolveAgentFeedbackRequest(url, agentFeedbackConfig);
 			if (agentFeedbackRequest) {
 				if (agentFeedbackRequest.kind === "schema") return Response.json({ error: "Method Not Allowed" }, {
 					status: 405,
 					headers: { Allow: "GET" }
 				});
 				const parsed = await parseAgentFeedbackData(request);
-				if (!parsed.ok) return parsed.response;
+				if (!parsed.ok) {
+					await emitDocsAnalyticsEvent(analytics, {
+						type: "agent_feedback_error",
+						source: "server",
+						url: request.url,
+						path: url.pathname,
+						properties: { reason: "invalid_body" }
+					});
+					return parsed.response;
+				}
 				const payloadError = validateAgentFeedbackPayload(parsed.data.payload, agentFeedbackConfig.payloadSchema);
-				if (payloadError) return Response.json({ error: payloadError }, { status: 400 });
-				if (!agentFeedbackConfig.onFeedback) return Response.json({
-					ok: true,
-					handled: false
-				}, { status: 202 });
+				if (payloadError) {
+					await emitDocsAnalyticsEvent(analytics, {
+						type: "agent_feedback_error",
+						source: "server",
+						url: request.url,
+						path: url.pathname,
+						properties: {
+							reason: "invalid_payload",
+							error: payloadError
+						}
+					});
+					return Response.json({ error: payloadError }, { status: 400 });
+				}
+				if (!agentFeedbackConfig.onFeedback) {
+					await emitDocsAnalyticsEvent(analytics, {
+						type: "agent_feedback_submit",
+						source: "server",
+						url: request.url,
+						path: url.pathname,
+						properties: {
+							handled: false,
+							payloadKeys: Object.keys(parsed.data.payload),
+							hasContext: Boolean(parsed.data.context)
+						}
+					});
+					return Response.json({
+						ok: true,
+						handled: false
+					}, { status: 202 });
+				}
 				await agentFeedbackConfig.onFeedback(parsed.data);
+				await emitDocsAnalyticsEvent(analytics, {
+					type: "agent_feedback_submit",
+					source: "server",
+					url: request.url,
+					path: url.pathname,
+					properties: {
+						handled: true,
+						payloadKeys: Object.keys(parsed.data.payload),
+						hasContext: Boolean(parsed.data.context)
+					}
+				});
 				return Response.json({
 					ok: true,
 					handled: true
 				}, { status: 201 });
 			}
-			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, getIndexes(resolveContextFromRequest(request)), aiConfig);
+			if (!aiConfig.enabled) {
+				await emitDocsAnalyticsEvent(analytics, {
+					type: "api_ai_error",
+					source: "server",
+					url: request.url,
+					path: url.pathname,
+					properties: { reason: "disabled" }
+				});
+				return Response.json({ error: "AI is not enabled. Set `ai: { enabled: true }` in your docs.config to enable it." }, { status: 404 });
+			}
+			const ctx = resolveContextFromRequest(request);
+			return handleAskAI(request, getIndexes(ctx), aiConfig, analytics, { locale: ctx.locale });
 		}
 	};
 }
@@ -1279,6 +1571,7 @@ function createDocsMCPAPI(options = {}) {
 		}),
 		mcp: options.mcp ?? readMcpConfig(rootDir),
 		search: options.search,
+		analytics: options.analytics,
 		defaultName: navTitle
 	});
 	return {

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

@@ -1,14 +1,16 @@
-import { CodeBlockCopyData, DocsFeedbackData } from "@farming-labs/docs";
+import { CodeBlockCopyData, DocsAnalyticsConfig, DocsFeedbackData } from "@farming-labs/docs";
 
 //#region src/docs-client-hooks.d.ts
 type CopyHandler = (data: CodeBlockCopyData) => void;
 type FeedbackHandler = (data: DocsFeedbackData) => void | Promise<void>;
 declare function DocsClientHooks({
   onCopyClick,
-  onFeedback
+  onFeedback,
+  analytics
 }: {
   onCopyClick?: CopyHandler;
   onFeedback?: FeedbackHandler;
+  analytics?: boolean | DocsAnalyticsConfig;
 }): null;
 //#endregion
 export { DocsClientHooks };

package/dist/docs-client-hooks.mjs

@@ -1,6 +1,8 @@
 "use client";
 
+import { emitClientAnalyticsEvent } from "./client-analytics.mjs";
 import { useEffect } from "react";
+import { emitDocsAnalyticsEvent } from "@farming-labs/docs";
 
 //#region src/docs-client-hooks.tsx
 function useWindowHook(key, handler) {
@@ -16,9 +18,58 @@ function useWindowHook(key, handler) {
 		};
 	}, [handler, key]);
 }
-function DocsClientHooks({ onCopyClick, onFeedback }) {
+function useAnalyticsHook(analytics) {
+	useEffect(() => {
+		if (typeof window === "undefined") return;
+		if (!analytics) return;
+		const target = window;
+		const handler = (event) => {
+			emitDocsAnalyticsEvent(analytics, event);
+		};
+		const previous = target.__fdAnalytics__;
+		target.__fdAnalytics__ = handler;
+		const queued = target.__fdAnalyticsQueue__ ?? [];
+		delete target.__fdAnalyticsQueue__;
+		for (const event of queued) handler(event);
+		return () => {
+			if (target.__fdAnalytics__ === handler) if (typeof previous === "function") target.__fdAnalytics__ = previous;
+			else delete target.__fdAnalytics__;
+		};
+	}, [analytics]);
+}
+function useCodeCopyAnalytics(analytics) {
+	useEffect(() => {
+		if (typeof window === "undefined") return;
+		if (!analytics) return;
+		const handleClick = (event) => {
+			const target = event.target;
+			if (!target.closest?.("button")) return;
+			const figure = target.closest("figure");
+			if (!figure) return;
+			const code = figure.querySelector("pre code");
+			if (!code) return;
+			const content = code.textContent ?? "";
+			const language = code.getAttribute("data-language") ?? figure.getAttribute("data-language") ?? void 0;
+			const title = figure.querySelector("[data-title]")?.textContent?.trim() ?? figure.querySelector(".fd-codeblock-title-text")?.textContent?.trim() ?? void 0;
+			emitClientAnalyticsEvent({
+				type: "code_block_copy",
+				input: { content },
+				properties: {
+					title,
+					language,
+					contentLength: content.length
+				}
+			});
+		};
+		document.addEventListener("click", handleClick, true);
+		return () => document.removeEventListener("click", handleClick, true);
+	}, [analytics]);
+}
+function DocsClientHooks({ onCopyClick, onFeedback, analytics }) {
 	useWindowHook("__fdOnCopyClick__", onCopyClick);
 	useWindowHook("__fdOnFeedback__", onFeedback);
+	useAnalyticsHook(analytics);
+	useCodeCopyAnalytics(analytics);
 	return null;
 }
 

package/dist/docs-command-search.d.mts

@@ -9,10 +9,12 @@ import * as React$1 from "react";
  */
 declare function DocsCommandSearch({
   api,
-  locale
+  locale,
+  analytics
 }: {
   api?: string;
   locale?: string;
+  analytics?: boolean;
 }): React$1.ReactPortal | null;
 //#endregion
 export { DocsCommandSearch };