boltdocs 2.8.4 → 2.9.0

package/dist/client/index.js

@@ -3,12 +3,12 @@
  * Copyright (c) 2026 Jesus Alcala
  * Licensed under the MIT License.
  */
-import { $ as ConfigContext, B as Languages, C as RoutesProvider, D as Check, E as ArrowLeft, G as Moon, M as Copy, O as ChevronDown, P as ExternalLink, Q as icons_exports, R as Home, S as normalizePath, U as Menu, W as Monitor, X as TextAlignStart, Y as Sun, Z as X, _ as Link$1, b as useLocalizedTo, et as useConfig, j as CircleHelp, nt as useBoltdocsContext, q as Pencil, s as Github, tt as BoltdocsProvider, x as useRoutes, y as cn } from "../icons-dev-CFcv5Nb8.js";
-import { c as ThemeProvider, l as useTheme } from "../image-DufDOid8.js";
-import { n as copyToClipboard, t as mdx_components_default } from "../mdx-Bto8CvGl.js";
-import { A as useUI, D as ButtonGroup, O as Breadcrumbs$2, T as Menu$1, _ as OnThisPage$1, h as PageNav$1, i as Sidebar$1, k as UIProvider, m as useSidebar, n as useSearchHighlight, r as useLocation, t as DocsLayout$1, w as Tabs$1 } from "../docs-layout-BBv6wILp.js";
-import { a as Button$1, n as Navbar$1, r as ErrorBoundary$1 } from "../search-dialog-e86WPpck.js";
-import { n as useSearch, r as InternalErrorBoundary, t as SearchDialog } from "../search-dialog-jHZ21G4i.js";
+import { $ as TextAlignStart, C as RoutesProvider, D as Check, E as ArrowLeft, F as FaceBad, I as FaceGood, J as Moon, K as Menu, L as FaceRegular, M as Copy, O as ChevronDown, P as ExternalLink, Q as Sun, S as normalizePath, U as Languages, V as Home, X as Pencil, _ as Link$1, at as useBoltdocsContext, b as useLocalizedTo, et as X, it as BoltdocsProvider, j as CircleHelp, nt as ConfigContext, q as Monitor, rt as useConfig, s as Github, tt as icons_exports, x as useRoutes, y as cn } from "../icons-dev-kJyGWNeg.js";
+import { c as ThemeProvider, l as useTheme } from "../image-CjYu9Eml.js";
+import { n as useCodeBlock, r as copyToClipboard, t as mdx_components_default } from "../mdx-Cy_c2zio.js";
+import { A as useUI, C as useSidebar, D as ButtonGroup, O as Breadcrumbs$2, S as useLocation, T as Menu$1, f as PageNav$1, k as UIProvider, m as OnThisPage$1, n as Sidebar$1, t as DocsLayout$1, w as Tabs$1, x as useSearchHighlight } from "../docs-layout-6FQ8__ok.js";
+import { a as Button$1, n as Navbar$1, r as ErrorBoundary$1 } from "../search-dialog-DaR66wl0.js";
+import { n as useSearch, r as InternalErrorBoundary, t as SearchDialog } from "../search-dialog-CaOO1Q4i.js";
 import { ViteReactSSG } from "@bdocs/ssg";
 import { Suspense, createContext, isValidElement, lazy, use, useCallback, useEffect, useLayoutEffect, useMemo, useRef, useState } from "react";
 import { Link, Outlet, useLoaderData, useLocation as useLocation$1, useMatches, useNavigate } from "react-router-dom";
@@ -154,6 +154,13 @@ const mdxComponentsDefault = {
 	"404": NotFound
 };
 
+//#endregion
+//#region src/client/collections/collections-context.tsx
+const CollectionsContext = createContext({});
+function useCollectionsData() {
+	return use(CollectionsContext);
+}
+
 //#endregion
 //#region src/client/ssg/boltdocs-shell.tsx
 /**
@@ -189,7 +196,7 @@ function StoreSync({ config, routeMap }) {
 	]);
 	return null;
 }
-function BoltdocsShell({ config, routes, components = {} }) {
+function BoltdocsShell({ config, routes, components = {}, collectionsData }) {
 	const allComponents = useMemo(() => ({
 		...mdxComponentsDefault,
 		...virtualCustomComponents,
@@ -226,20 +233,23 @@ function BoltdocsShell({ config, routes, components = {} }) {
 		routes,
 		children: /* @__PURE__ */ jsx(ThemeProvider, { children: /* @__PURE__ */ jsx(UIProvider, { children: /* @__PURE__ */ jsx(MdxComponentsProvider, {
 			components: allComponents,
-			children: /* @__PURE__ */ jsxs(ConfigContext.Provider, {
+			children: /* @__PURE__ */ jsx(ConfigContext.Provider, {
 				value: config,
-				children: [/* @__PURE__ */ jsx(ScrollHandler, {}), /* @__PURE__ */ jsxs(BoltdocsProvider, {
-					initialLocale: initialData.initLocale,
-					initialVersion: initialData.initVersion,
-					children: [
-						/* @__PURE__ */ jsx(StoreSync, {
-							config,
-							routeMap
-						}),
-						/* @__PURE__ */ jsx(I18nUpdater, { config }),
-						/* @__PURE__ */ jsx(InternalErrorBoundary, { children: /* @__PURE__ */ jsx(Outlet, {}) })
-					]
-				})]
+				children: /* @__PURE__ */ jsxs(CollectionsContext.Provider, {
+					value: collectionsData || {},
+					children: [/* @__PURE__ */ jsx(ScrollHandler, {}), /* @__PURE__ */ jsxs(BoltdocsProvider, {
+						initialLocale: initialData.initLocale,
+						initialVersion: initialData.initVersion,
+						children: [
+							/* @__PURE__ */ jsx(StoreSync, {
+								config,
+								routeMap
+							}),
+							/* @__PURE__ */ jsx(I18nUpdater, { config }),
+							/* @__PURE__ */ jsx(InternalErrorBoundary, { children: /* @__PURE__ */ jsx(Outlet, {}) })
+						]
+					})]
+				})
 			})
 		}) }) })
 	}) });
@@ -845,6 +855,30 @@ function useVersion() {
 	};
 }
 
+//#endregion
+//#region src/client/components/ui-base/version-selector.tsx
+function VersionSelector({ className }) {
+	const { currentVersionLabel, availableVersions, handleVersionChange } = useVersion();
+	if (availableVersions.length === 0) return null;
+	return /* @__PURE__ */ jsxs(Menu$1.Trigger, { children: [/* @__PURE__ */ jsxs(Button$1, {
+		className: cn("flex h-9 items-center justify-between gap-2 border border-subtle bg-surface px-4 py-1.5 rounded-xl text-xs font-semibold text-body hover:bg-primary-50/20 hover:border-primary-500/50 transition-all duration-300 outline-none select-none cursor-pointer", className),
+		children: [/* @__PURE__ */ jsx("span", {
+			className: "font-semibold text-[0.8125rem]",
+			children: currentVersionLabel
+		}), /* @__PURE__ */ jsx(ChevronDown, { className: "w-3.5 h-3.5 text-muted/60" })]
+	}), /* @__PURE__ */ jsx(Menu$1.Root, {
+		className: "w-40 bg-main border border-subtle rounded-xl p-1.5 shadow-md outline-none flex flex-col gap-0.5 animate-fade-in z-100",
+		children: /* @__PURE__ */ jsx(Menu$1.Section, {
+			items: availableVersions,
+			children: (version) => /* @__PURE__ */ jsx(Menu$1.Item, {
+				onPress: () => handleVersionChange(version.value),
+				className: "flex items-center gap-2 px-3 py-2 rounded-lg text-xs font-medium text-body hover:bg-primary-50/50 cursor-pointer select-none outline-none group data-selected:text-primary-500 data-selected:bg-primary-500/5",
+				children: version.label
+			}, version.value)
+		})
+	})] });
+}
+
 //#endregion
 //#region src/client/hooks/use-i18n.ts
 /**
@@ -924,28 +958,319 @@ function useI18n() {
 }
 
 //#endregion
-//#region src/client/components/ui-base/version-i18n.tsx
-function VersionSelector({ className }) {
-	const { currentVersionLabel, availableVersions, handleVersionChange } = useVersion();
-	if (availableVersions.length === 0) return null;
-	return /* @__PURE__ */ jsxs(Menu$1.Trigger, { children: [/* @__PURE__ */ jsxs(Button$1, {
-		className: cn("flex h-9 items-center justify-between gap-2 border border-subtle bg-surface px-4 py-1.5 rounded-xl text-xs font-semibold text-body hover:bg-primary-50/20 hover:border-primary-500/50 transition-all duration-300 outline-none select-none cursor-pointer", className),
-		children: [/* @__PURE__ */ jsx("span", {
-			className: "font-semibold text-[0.8125rem]",
-			children: currentVersionLabel
-		}), /* @__PURE__ */ jsx(ChevronDown, { className: "w-3.5 h-3.5 text-muted/60" })]
-	}), /* @__PURE__ */ jsx(Menu$1.Root, {
-		className: "w-40 bg-main border border-subtle rounded-xl p-1.5 shadow-md outline-none flex flex-col gap-0.5 animate-fade-in z-100",
-		children: /* @__PURE__ */ jsx(Menu$1.Section, {
-			items: availableVersions,
-			children: (version) => /* @__PURE__ */ jsx(Menu$1.Item, {
-				onPress: () => handleVersionChange(version.value),
-				className: "flex items-center gap-2 px-3 py-2 rounded-lg text-xs font-medium text-body hover:bg-primary-50/50 cursor-pointer select-none outline-none group data-selected:text-primary-500 data-selected:bg-primary-500/5",
-				children: version.label
-			}, `${version.value ?? ""}`)
-		})
-	})] });
+//#region src/client/hooks/use-page-nav.ts
+function usePageNav() {
+	const { routes, currentRoute } = useRoutes();
+	const location = useLocation$1();
+	const { groups, ungrouped } = useSidebar(routes);
+	return useMemo(() => {
+		if (!currentRoute) return {
+			prevPage: null,
+			nextPage: null,
+			currentRoute: null
+		};
+		const mergedItems = [...ungrouped.map((route) => ({
+			type: "link",
+			position: route.sidebarPosition ?? 999,
+			title: route.title,
+			route
+		})), ...groups.map((group) => ({
+			type: "group",
+			position: group.sidebarPosition ?? 999,
+			title: group.title,
+			group
+		}))].sort((a, b) => {
+			if (a.position !== b.position) return a.position - b.position;
+			if (a.type !== b.type) return a.type === "link" ? -1 : 1;
+			return a.title.localeCompare(b.title);
+		});
+		const orderedRoutes = [];
+		const flattenNode = (node) => {
+			if (node.path && node.path !== "#" && !node.sidebarHidden) orderedRoutes.push(node);
+			const children = node.routes || node.subRoutes;
+			if (children && children.length > 0) for (const child of children) flattenNode(child);
+		};
+		for (const item of mergedItems) if (item.type === "link") flattenNode(item.route);
+		else if (item.group.routes) for (const route of item.group.routes) flattenNode(route);
+		const currentNormalizedPath = normalizePath(location.pathname);
+		const currentIndex = orderedRoutes.findIndex((r) => normalizePath(r.path) === currentNormalizedPath);
+		return {
+			prevPage: currentIndex > 0 ? orderedRoutes[currentIndex - 1] : null,
+			nextPage: currentIndex !== -1 && currentIndex < orderedRoutes.length - 1 ? orderedRoutes[currentIndex + 1] : null,
+			currentRoute
+		};
+	}, [
+		groups,
+		ungrouped,
+		currentRoute,
+		location.pathname
+	]);
+}
+
+//#endregion
+//#region src/client/hooks/use-analytics.ts
+function createAnalyticsInstance(config) {
+	if (typeof window === "undefined") return createDisabledAnalytics();
+	if (typeof window.gtag === "function") return createGtagAnalytics(config);
+	if (window.dataLayer) return createDataLayerAnalytics(config);
+	return createDisabledAnalytics();
+}
+function createGtagAnalytics(config) {
+	return {
+		trackPageView: (path, title) => {
+			window.gtag?.("event", "page_view", {
+				page_path: path,
+				page_title: title || document.title,
+				send_to: config?.ga4?.measurementId
+			});
+		},
+		trackEvent: ({ action, category, label, value, params }) => {
+			window.gtag?.("event", action, {
+				event_category: category,
+				event_label: label,
+				value,
+				send_to: config?.ga4?.measurementId,
+				...params
+			});
+		},
+		trackSearch: (query, resultsCount) => {
+			window.gtag?.("event", "search", {
+				search_term: query,
+				results_count: resultsCount,
+				send_to: config?.ga4?.measurementId
+			});
+		},
+		trackDownload: (file, type) => {
+			window.gtag?.("event", "file_download", {
+				file_name: file,
+				file_type: type || file.split(".").pop(),
+				send_to: config?.ga4?.measurementId
+			});
+		},
+		trackExternalLink: (url) => {
+			window.gtag?.("event", "external_link", {
+				link_url: url,
+				send_to: config?.ga4?.measurementId
+			});
+		},
+		isEnabled: true
+	};
+}
+function createDataLayerAnalytics(config) {
+	return {
+		trackPageView: (path, title) => {
+			window.dataLayer?.push({
+				event: "page_view",
+				page_path: path,
+				page_title: title || document.title,
+				send_to: config?.gtm?.tagId
+			});
+		},
+		trackEvent: ({ action, category, label, value, params }) => {
+			window.dataLayer?.push({
+				event: action,
+				event_category: category,
+				event_label: label,
+				value,
+				send_to: config?.gtm?.tagId,
+				...params
+			});
+		},
+		trackSearch: (query, resultsCount) => {
+			window.dataLayer?.push({
+				event: "search",
+				search_term: query,
+				results_count: resultsCount,
+				send_to: config?.gtm?.tagId
+			});
+		},
+		trackDownload: (file, type) => {
+			window.dataLayer?.push({
+				event: "file_download",
+				file_name: file,
+				file_type: type || file.split(".").pop(),
+				send_to: config?.gtm?.tagId
+			});
+		},
+		trackExternalLink: (url) => {
+			window.dataLayer?.push({
+				event: "external_link",
+				link_url: url,
+				send_to: config?.gtm?.tagId
+			});
+		},
+		isEnabled: true
+	};
+}
+function createDisabledAnalytics() {
+	return {
+		trackPageView: () => {},
+		trackEvent: () => {},
+		trackSearch: () => {},
+		trackDownload: () => {},
+		trackExternalLink: () => {},
+		isEnabled: false
+	};
+}
+const CONFIG_INSTANCE_SYMBOL = Symbol.for("__BDOCS_CONFIG_INSTANCE__");
+function useAnalytics(options = {}) {
+	const { config: optionsConfig, autoTrackPageViews = true, autoTrackDownloads = true, autoTrackExternalLinks = true, excludePatterns = [] } = options;
+	const globalConfig = typeof globalThis !== "undefined" ? globalThis[CONFIG_INSTANCE_SYMBOL] : void 0;
+	const config = optionsConfig ?? globalConfig?.integrations;
+	const analytics = useMemo(() => createAnalyticsInstance(config), [config]);
+	const previousPath = useRef("");
+	const location = useLocation();
+	useEffect(() => {
+		if (!autoTrackPageViews || !analytics.isEnabled) return;
+		const path = location.pathname + location.search;
+		if (path !== previousPath.current) {
+			previousPath.current = path;
+			analytics.trackPageView(path, document.title);
+		}
+	}, [
+		location.pathname,
+		autoTrackPageViews,
+		analytics
+	]);
+	useEffect(() => {
+		if (!autoTrackDownloads || !analytics.isEnabled) return;
+		const handleClick = (event) => {
+			const target = event.target?.closest("a");
+			if (!target) return;
+			const href = target.getAttribute("href");
+			if (!href) return;
+			if (excludePatterns.some((pattern) => pattern.test(href))) return;
+			if (target.hasAttribute("download") || /\.(pdf|doc|docx|xls|xlsx|ppt|pptx|zip|rar|7z|tar|gz|mp3|mp4|avi|mov|png|jpg|jpeg|gif|svg|webp)$/i.test(href)) {
+				const fileName = href.split("/").pop() || href;
+				analytics.trackDownload(fileName, fileName.split(".").pop());
+			}
+		};
+		document.addEventListener("click", handleClick);
+		return () => document.removeEventListener("click", handleClick);
+	}, [
+		autoTrackDownloads,
+		autoTrackExternalLinks,
+		analytics,
+		excludePatterns
+	]);
+	useEffect(() => {
+		if (!autoTrackExternalLinks || !analytics.isEnabled) return;
+		const handleClick = (event) => {
+			const target = event.target?.closest("a");
+			if (!target) return;
+			const href = target.getAttribute("href");
+			if (!href) return;
+			if (excludePatterns.some((pattern) => pattern.test(href))) return;
+			if ((href.startsWith("http://") || href.startsWith("https://") || href.startsWith("//")) && !href.includes(window.location.hostname)) analytics.trackExternalLink(href);
+		};
+		document.addEventListener("click", handleClick);
+		return () => document.removeEventListener("click", handleClick);
+	}, [
+		autoTrackExternalLinks,
+		analytics,
+		excludePatterns
+	]);
+	return analytics;
+}
+function useTrackPageView() {
+	const analytics = useMemo(() => createAnalyticsInstance(), []);
+	return useCallback((path, title) => {
+		analytics.trackPageView(path, title);
+	}, [analytics]);
+}
+function useTrackEvent() {
+	const analytics = useMemo(() => createAnalyticsInstance(), []);
+	return useCallback((event) => {
+		analytics.trackEvent(event);
+	}, [analytics]);
+}
+
+//#endregion
+//#region src/client/hooks/use-headings.ts
+/**
+* Returns the headings of the current page, extracted from the route loader data.
+* Useful for building custom Tables of Contents or jumping to sections.
+*
+* @returns An array of heading objects with level, text, and id.
+*/
+function useHeadings() {
+	const matches = useMatches();
+	return useMemo(() => {
+		return (matches[matches.length - 1]?.data)?.headings || [];
+	}, [matches]);
+}
+
+//#endregion
+//#region src/client/hooks/use-feedback.ts
+/**
+* Hook for managing the feedback rating form state and submission.
+* Resets automatically when navigating to a new page.
+*/
+function useFeedback(options = {}) {
+	const config = useConfig();
+	const { currentRoute } = useRoutes();
+	const [rating, setRating] = useState(null);
+	const [comment, setComment] = useState("");
+	const [loading, setLoading] = useState(false);
+	const [submitted, setSubmitted] = useState(false);
+	const [error, setError] = useState(null);
+	useEffect(() => {
+		setRating(null);
+		setComment("");
+		setSubmitted(false);
+		setError(null);
+	}, [currentRoute?.path]);
+	const submit = async (commentOverride, blockId) => {
+		if (!rating) return;
+		setLoading(true);
+		setError(null);
+		const payload = {
+			rating,
+			comment: (commentOverride !== void 0 ? commentOverride : comment) || void 0,
+			path: currentRoute?.path || window.location.pathname,
+			title: currentRoute?.title || document.title,
+			blockId
+		};
+		try {
+			if (options.onSubmit) await options.onSubmit(payload);
+			else {
+				const endpoint = options.endpoint || config.integrations?.feedback?.custom?.endpoint || "/api/feedback";
+				const res = await fetch(endpoint, {
+					method: "POST",
+					headers: { "Content-Type": "application/json" },
+					body: JSON.stringify(payload)
+				});
+				if (!res.ok) {
+					const text = await res.text();
+					let errorText = text;
+					try {
+						const data = JSON.parse(text);
+						errorText = data.error || data.message || text;
+					} catch {}
+					throw new Error(errorText || `Failed to submit feedback: ${res.statusText}`);
+				}
+			}
+			setSubmitted(true);
+		} catch (e) {
+			setError(e.message || "An error occurred while submitting feedback.");
+		} finally {
+			setLoading(false);
+		}
+	};
+	return {
+		rating,
+		setRating,
+		comment,
+		setComment,
+		loading,
+		submitted,
+		error,
+		submit
+	};
 }
+
+//#endregion
+//#region src/client/components/ui-base/i18n-selector.tsx
 function I18nSelector({ className }) {
 	const { currentLocale, availableLocales, handleLocaleChange } = useI18n();
 	if (availableLocales.length === 0) return null;
@@ -966,14 +1291,14 @@ function I18nSelector({ className }) {
 				onPress: () => handleLocaleChange(locale.value),
 				className: "flex items-center gap-2 px-3 py-2 rounded-lg text-xs font-medium text-body dark:hover:bg-primary-300/50 hover:bg-primary-200/50 transition-colors duration-100 cursor-pointer select-none outline-none group data-selected:text-primary-500 data-selected:bg-primary-500/5",
 				children: /* @__PURE__ */ jsx("span", { children: locale.label })
-			}, `${locale.value ?? ""}`)
+			}, locale.value)
 		})
 	})] });
 }
 
 //#endregion
 //#region src/client/components/ui-base/navbar.tsx
-const SearchDialog$1 = lazy(() => import("../search-dialog-DBNaG5At.js").then((m) => ({ default: m.SearchDialog })));
+const SearchDialog$1 = lazy(() => import("../search-dialog-DRNJsxOv.js").then((m) => ({ default: m.SearchDialog })));
 function Navbar() {
 	const { links, title, logo, logoProps, github, social, config } = useNavbar();
 	const { routes, currentRoute, isCollectionPage, currentVersion, currentLocale } = useRoutes();
@@ -1090,7 +1415,7 @@ function Navbar() {
 function NavbarLinkItem({ link }) {
 	const localizedHref = useLocalizedTo(link.href || "");
 	const { pathname } = useLocation$1();
-	const active = pathname === localizedHref || pathname.startsWith(localizedHref + "/");
+	const active = pathname === localizedHref || pathname.startsWith(`${localizedHref}/`);
 	if (link.items && link.items.length > 0) return /* @__PURE__ */ jsx(Navbar$1.Dropdown, {
 		label: /* @__PURE__ */ jsx("span", {
 			className: cn("transition-colors outline-none font-medium focus-visible:ring-2 focus-visible:ring-primary-500/30 rounded-sm px-2 py-1", active ? "text-primary-500" : "text-muted hover:text-body"),
@@ -1169,36 +1494,6 @@ function OnThisPage({ headings = [], editLink, communityHelp, filePath }) {
 	] });
 }
 
-//#endregion
-//#region src/client/hooks/use-page-nav.ts
-/**
-* Hook to manage the previous and next button functionality for documentation pages.
-* Intelligent: respects current locale, version, and tab to keep navigation logical.
-*/
-function usePageNav() {
-	const { routes, currentRoute } = useRoutes();
-	const location = useLocation$1();
-	return useMemo(() => {
-		if (!currentRoute) return {
-			prevPage: null,
-			nextPage: null,
-			currentRoute: null
-		};
-		const activeTabId = currentRoute.tab?.toLowerCase();
-		const contextRoutes = activeTabId ? routes.filter((r) => r.tab?.toLowerCase() === activeTabId) : routes.filter((r) => !r.tab);
-		const currentIndex = contextRoutes.findIndex((r) => r.path === location.pathname);
-		return {
-			prevPage: currentIndex > 0 ? contextRoutes[currentIndex - 1] : null,
-			nextPage: currentIndex !== -1 && currentIndex < contextRoutes.length - 1 ? contextRoutes[currentIndex + 1] : null,
-			currentRoute
-		};
-	}, [
-		routes,
-		currentRoute,
-		location.pathname
-	]);
-}
-
 //#endregion
 //#region src/client/components/ui-base/page-nav.tsx
 /**
@@ -1288,13 +1583,15 @@ const Sidebar = Object.assign(SidebarMain, {
 function Banner({ children, className = "", dismissible = false, id = "boltdocs-banner", ...props }) {
 	const [isVisible, setIsVisible] = useState(true);
 	useEffect(() => {
-		if (dismissible && id) {
-			if (localStorage.getItem(`boltdocs-banner-dismissed-${id}`) === "true") setIsVisible(false);
-		}
+		if (dismissible && id && typeof window !== "undefined") try {
+			if (window.localStorage.getItem(`boltdocs-banner-dismissed-${id}`) === "true") setIsVisible(false);
+		} catch {}
 	}, [dismissible, id]);
 	const handleDismiss = () => {
 		setIsVisible(false);
-		if (dismissible && id) localStorage.setItem(`boltdocs-banner-dismissed-${id}`, "true");
+		if (dismissible && id && typeof window !== "undefined") try {
+			window.localStorage.setItem(`boltdocs-banner-dismissed-${id}`, "true");
+		} catch {}
 	};
 	if (!isVisible) return null;
 	return /* @__PURE__ */ jsxs("div", {
@@ -1312,6 +1609,90 @@ function Banner({ children, className = "", dismissible = false, id = "boltdocs-
 	});
 }
 
+//#endregion
+//#region src/client/components/ui-base/feedback.tsx
+function Feedback({ className }) {
+	if (!(useConfig().integrations?.feedback?.custom)?.enabled) return null;
+	const { rating, setRating, comment, setComment, loading, submitted, error, submit } = useFeedback();
+	return /* @__PURE__ */ jsx("div", {
+		className: cn("w-full max-w-2xl mt-12 mb-6 p-6 rounded-2xl border border-subtle bg-surface/50 backdrop-blur-xs select-none", className),
+		children: submitted ? /* @__PURE__ */ jsxs("div", {
+			className: "flex flex-col items-center justify-center py-4 text-center animate-in fade-in zoom-in duration-300",
+			children: [
+				/* @__PURE__ */ jsx("div", {
+					className: "flex h-12 w-12 items-center justify-center rounded-full bg-emerald-500/10 text-emerald-500 mb-3 border border-emerald-500/20",
+					children: /* @__PURE__ */ jsx(Check, { size: 24 })
+				}),
+				/* @__PURE__ */ jsx("h3", {
+					className: "text-lg font-semibold text-default",
+					children: "Thank you for your feedback!"
+				}),
+				/* @__PURE__ */ jsx("p", {
+					className: "text-sm text-muted mt-1",
+					children: "Your comments help us improve the documentation."
+				})
+			]
+		}) : /* @__PURE__ */ jsxs("div", {
+			className: "flex flex-col gap-4",
+			children: [/* @__PURE__ */ jsxs("div", {
+				className: "flex flex-col sm:flex-row sm:items-center sm:justify-between gap-3",
+				children: [/* @__PURE__ */ jsx("h4", {
+					className: "text-base font-semibold text-default",
+					children: "Was this page helpful?"
+				}), /* @__PURE__ */ jsxs("div", {
+					className: "flex items-center gap-2",
+					children: [
+						/* @__PURE__ */ jsxs("button", {
+							type: "button",
+							onClick: () => setRating("good"),
+							className: cn("flex items-center gap-1.5 px-3 py-1.5 rounded-lg border text-sm font-medium transition-all duration-200 outline-none cursor-pointer", rating === "good" ? "border-primary-500 bg-primary-500/10 text-primary-500 dark:text-primary-400" : "border-subtle hover:border-body hover:bg-surface text-muted hover:text-body"),
+							"aria-label": "Helpful",
+							children: [/* @__PURE__ */ jsx(FaceGood, {}), /* @__PURE__ */ jsx("span", { children: "Yes" })]
+						}),
+						/* @__PURE__ */ jsxs("button", {
+							type: "button",
+							onClick: () => setRating("neutral"),
+							className: cn("flex items-center gap-1.5 px-3 py-1.5 rounded-lg border text-sm font-medium transition-all duration-200 outline-none cursor-pointer", rating === "neutral" ? "border-primary-500 bg-primary-500/10 text-primary-500 dark:text-primary-400" : "border-subtle hover:border-body hover:bg-surface text-muted hover:text-body"),
+							"aria-label": "Neutral",
+							children: [/* @__PURE__ */ jsx(FaceRegular, {}), /* @__PURE__ */ jsx("span", { children: "Regular" })]
+						}),
+						/* @__PURE__ */ jsxs("button", {
+							type: "button",
+							onClick: () => setRating("bad"),
+							className: cn("flex items-center gap-1.5 px-3 py-1.5 rounded-lg border text-sm font-medium transition-all duration-200 outline-none cursor-pointer", rating === "bad" ? "border-primary-500 bg-primary-500/10 text-primary-500 dark:text-primary-400" : "border-subtle hover:border-body hover:bg-surface text-muted hover:text-body"),
+							"aria-label": "Not helpful",
+							children: [/* @__PURE__ */ jsx(FaceBad, {}), /* @__PURE__ */ jsx("span", { children: "No" })]
+						})
+					]
+				})]
+			}), rating && /* @__PURE__ */ jsxs("div", {
+				className: "flex flex-col gap-3 mt-1 animate-in slide-in-from-top-3 duration-300",
+				children: [/* @__PURE__ */ jsx("textarea", {
+					value: comment,
+					onChange: (e) => setComment(e.target.value),
+					placeholder: "¿Tienes alguna sugerencia para mejorar esta página? (Opcional)",
+					className: "w-full h-24 p-3 text-sm rounded-xl border border-subtle bg-main text-body placeholder:text-muted focus:outline-none focus:ring-1 focus:ring-primary-500 focus:border-primary-500 resize-none transition-shadow"
+				}), /* @__PURE__ */ jsxs("div", {
+					className: "flex items-center justify-between gap-3",
+					children: [error && /* @__PURE__ */ jsx("p", {
+						className: "text-xs text-rose-500 font-medium flex-1",
+						children: error
+					}), /* @__PURE__ */ jsx("div", {
+						className: "flex items-center gap-2 ml-auto",
+						children: /* @__PURE__ */ jsx("button", {
+							type: "button",
+							onClick: () => submit(),
+							disabled: loading,
+							className: "px-4 py-2 rounded-xl text-xs font-semibold bg-primary-500 hover:bg-primary-600 active:bg-primary-700 text-white transition-colors outline-none cursor-pointer disabled:opacity-50 disabled:cursor-not-allowed",
+							children: loading ? "Submitting..." : "Submit"
+						})
+					})]
+				})]
+			})]
+		})
+	});
+}
+
 //#endregion
 //#region src/client/ssg/mdx-elements.tsx
 const Loading = () => /* @__PURE__ */ jsx("div", {
@@ -1448,13 +1829,6 @@ function Head({ siteTitle, siteDescription, routes }) {
 	] });
 }
 
-//#endregion
-//#region src/client/collections/collections-context.tsx
-const CollectionsContext = createContext({});
-function useCollectionsData() {
-	return use(CollectionsContext);
-}
-
 //#endregion
 //#region src/client/app/docs-layout.tsx
 function DocsLayout({ collectionsData }) {
@@ -1932,205 +2306,13 @@ function createRoutes(options) {
 				...externalRoutes.metadata,
 				...collectionRoutes.metadata
 			],
-			components
+			components,
+			collectionsData: options.collectionsData
 		}),
 		children
 	}];
 }
 
-//#endregion
-//#region src/client/hooks/use-analytics.ts
-function createAnalyticsInstance(config) {
-	if (typeof window === "undefined") return createDisabledAnalytics();
-	if (typeof window.gtag === "function") return createGtagAnalytics(config);
-	if (window.dataLayer) return createDataLayerAnalytics(config);
-	return createDisabledAnalytics();
-}
-function createGtagAnalytics(config) {
-	return {
-		trackPageView: (path, title) => {
-			window.gtag?.("event", "page_view", {
-				page_path: path,
-				page_title: title || document.title,
-				send_to: config?.ga4?.measurementId
-			});
-		},
-		trackEvent: ({ action, category, label, value, params }) => {
-			window.gtag?.("event", action, {
-				event_category: category,
-				event_label: label,
-				value,
-				send_to: config?.ga4?.measurementId,
-				...params
-			});
-		},
-		trackSearch: (query, resultsCount) => {
-			window.gtag?.("event", "search", {
-				search_term: query,
-				results_count: resultsCount,
-				send_to: config?.ga4?.measurementId
-			});
-		},
-		trackDownload: (file, type) => {
-			window.gtag?.("event", "file_download", {
-				file_name: file,
-				file_type: type || file.split(".").pop(),
-				send_to: config?.ga4?.measurementId
-			});
-		},
-		trackExternalLink: (url) => {
-			window.gtag?.("event", "external_link", {
-				link_url: url,
-				send_to: config?.ga4?.measurementId
-			});
-		},
-		isEnabled: true
-	};
-}
-function createDataLayerAnalytics(config) {
-	return {
-		trackPageView: (path, title) => {
-			window.dataLayer?.push({
-				event: "page_view",
-				page_path: path,
-				page_title: title || document.title,
-				send_to: config?.gtm?.tagId
-			});
-		},
-		trackEvent: ({ action, category, label, value, params }) => {
-			window.dataLayer?.push({
-				event: action,
-				event_category: category,
-				event_label: label,
-				value,
-				send_to: config?.gtm?.tagId,
-				...params
-			});
-		},
-		trackSearch: (query, resultsCount) => {
-			window.dataLayer?.push({
-				event: "search",
-				search_term: query,
-				results_count: resultsCount,
-				send_to: config?.gtm?.tagId
-			});
-		},
-		trackDownload: (file, type) => {
-			window.dataLayer?.push({
-				event: "file_download",
-				file_name: file,
-				file_type: type || file.split(".").pop(),
-				send_to: config?.gtm?.tagId
-			});
-		},
-		trackExternalLink: (url) => {
-			window.dataLayer?.push({
-				event: "external_link",
-				link_url: url,
-				send_to: config?.gtm?.tagId
-			});
-		},
-		isEnabled: true
-	};
-}
-function createDisabledAnalytics() {
-	return {
-		trackPageView: () => {},
-		trackEvent: () => {},
-		trackSearch: () => {},
-		trackDownload: () => {},
-		trackExternalLink: () => {},
-		isEnabled: false
-	};
-}
-const CONFIG_INSTANCE_SYMBOL = Symbol.for("__BDOCS_CONFIG_INSTANCE__");
-function useAnalytics(options = {}) {
-	const { config: optionsConfig, autoTrackPageViews = true, autoTrackDownloads = true, autoTrackExternalLinks = true, excludePatterns = [] } = options;
-	const globalConfig = typeof globalThis !== "undefined" ? globalThis[CONFIG_INSTANCE_SYMBOL] : void 0;
-	const config = optionsConfig ?? globalConfig?.integrations;
-	const analytics = useMemo(() => createAnalyticsInstance(config), [config]);
-	const previousPath = useRef("");
-	const location = useLocation();
-	useEffect(() => {
-		if (!autoTrackPageViews || !analytics.isEnabled) return;
-		const path = location.pathname + location.search;
-		if (path !== previousPath.current) {
-			previousPath.current = path;
-			analytics.trackPageView(path, document.title);
-		}
-	}, [
-		location.pathname,
-		autoTrackPageViews,
-		analytics
-	]);
-	useEffect(() => {
-		if (!autoTrackDownloads || !analytics.isEnabled) return;
-		const handleClick = (event) => {
-			const target = event.target?.closest("a");
-			if (!target) return;
-			const href = target.getAttribute("href");
-			if (!href) return;
-			if (excludePatterns.some((pattern) => pattern.test(href))) return;
-			if (target.hasAttribute("download") || /\.(pdf|doc|docx|xls|xlsx|ppt|pptx|zip|rar|7z|tar|gz|mp3|mp4|avi|mov|png|jpg|jpeg|gif|svg|webp)$/i.test(href)) {
-				const fileName = href.split("/").pop() || href;
-				analytics.trackDownload(fileName, fileName.split(".").pop());
-			}
-		};
-		document.addEventListener("click", handleClick);
-		return () => document.removeEventListener("click", handleClick);
-	}, [
-		autoTrackDownloads,
-		autoTrackExternalLinks,
-		analytics,
-		excludePatterns
-	]);
-	useEffect(() => {
-		if (!autoTrackExternalLinks || !analytics.isEnabled) return;
-		const handleClick = (event) => {
-			const target = event.target?.closest("a");
-			if (!target) return;
-			const href = target.getAttribute("href");
-			if (!href) return;
-			if (excludePatterns.some((pattern) => pattern.test(href))) return;
-			if ((href.startsWith("http://") || href.startsWith("https://") || href.startsWith("//")) && !href.includes(window.location.hostname)) analytics.trackExternalLink(href);
-		};
-		document.addEventListener("click", handleClick);
-		return () => document.removeEventListener("click", handleClick);
-	}, [
-		autoTrackExternalLinks,
-		analytics,
-		excludePatterns
-	]);
-	return analytics;
-}
-function useTrackPageView() {
-	const analytics = useMemo(() => createAnalyticsInstance(), []);
-	return useCallback((path, title) => {
-		analytics.trackPageView(path, title);
-	}, [analytics]);
-}
-function useTrackEvent() {
-	const analytics = useMemo(() => createAnalyticsInstance(), []);
-	return useCallback((event) => {
-		analytics.trackEvent(event);
-	}, [analytics]);
-}
-
-//#endregion
-//#region src/client/hooks/use-headings.ts
-/**
-* Returns the headings of the current page, extracted from the route loader data.
-* Useful for building custom Tables of Contents or jumping to sections.
-*
-* @returns An array of heading objects with level, text, and id.
-*/
-function useHeadings() {
-	const matches = useMatches();
-	return useMemo(() => {
-		return (matches[matches.length - 1]?.data)?.headings || [];
-	}, [matches]);
-}
-
 //#endregion
 //#region src/client/components/docs-layout-default.tsx
 function DocsLayoutComponent({ children }) {
@@ -2171,6 +2353,7 @@ function DocsLayoutComponent({ children }) {
 								className: "prose prose-neutral dark:prose-invert max-w-none",
 								children
 							}) }),
+							!isCollectionPage && /* @__PURE__ */ jsx(Feedback, {}),
 							/* @__PURE__ */ jsx(DocsLayout$1.Footer, { children: !isCollectionPage && /* @__PURE__ */ jsx(PageNav, {}) })
 						]
 					})
@@ -2236,4 +2419,4 @@ const reactToText = (node, resolvers) => {
 };
 
 //#endregion
-export { Banner, BoltdocsShell, Breadcrumbs, CollectionsContext, CopyMarkdown, DocsLayoutComponent as DocsLayout, ErrorBoundary, MdxPage, Navbar, NotFound, OnThisPage, PageNav, SearchDialog, Sidebar, ViteReactSSG, cn, copyToClipboard, createRoutes, getStarsRepo, getTranslated, reactToText, useAnalytics, useBreadcrumbs, useConfig, useHeadings, useI18n, useLocalizedTo, useLocation, useMdxComponents, useMergedComponents, useNavbar, usePageNav, usePost, usePosts, useRecentPosts, useRoutes, useSearch, useSearchHighlight, useSidebar, useTabs, useTheme, useTrackEvent, useTrackPageView, useUI, useVersion };
+export { Banner, BoltdocsShell, Breadcrumbs, CollectionsContext, CopyMarkdown, DocsLayoutComponent as DocsLayout, ErrorBoundary, MdxPage, Navbar, NotFound, OnThisPage, PageNav, SearchDialog, Sidebar, ViteReactSSG, cn, copyToClipboard, createRoutes, getStarsRepo, getTranslated, reactToText, useAnalytics, useBreadcrumbs, useCodeBlock, useConfig, useFeedback, useHeadings, useI18n, useLocalizedTo, useLocation, useMdxComponents, useMergedComponents, useNavbar, usePageNav, usePost, usePosts, useRecentPosts, useRoutes, useSearch, useSearchHighlight, useSidebar, useTabs, useTheme, useTrackEvent, useTrackPageView, useUI, useVersion };