boltdocs 2.8.4 → 2.9.0

package/dist/client/index.cjs

@@ -4,12 +4,12 @@
  * Licensed under the MIT License.
  */
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_icons_dev = require('../icons-dev-C8sFxeBk.cjs');
-const require_image = require('../image-DCMxxidi.cjs');
-const require_mdx = require('../mdx-BH9kHiF9.cjs');
-const require_docs_layout = require('../docs-layout-CVCf3xkZ.cjs');
-const require_search_dialog = require('../search-dialog-Cvux-qSk.cjs');
-const require_search_dialog$1 = require('../search-dialog-CmHYOt18.cjs');
+const require_icons_dev = require('../icons-dev-BryEFkJu.cjs');
+const require_image = require('../image-B9YA_oQ_.cjs');
+const require_mdx = require('../mdx-WXjAMS8Y.cjs');
+const require_docs_layout = require('../docs-layout-3TpAt6MB.cjs');
+const require_search_dialog = require('../search-dialog-BhXg05Ri.cjs');
+const require_search_dialog$1 = require('../search-dialog-BsAiQgnx.cjs');
 let react = require("react");
 let react_router_dom = require("react-router-dom");
 let react_jsx_runtime = require("react/jsx-runtime");
@@ -159,6 +159,13 @@ const mdxComponentsDefault = {
 	"404": NotFound
 };
 
+//#endregion
+//#region src/client/collections/collections-context.tsx
+const CollectionsContext = (0, react.createContext)({});
+function useCollectionsData() {
+	return (0, react.use)(CollectionsContext);
+}
+
 //#endregion
 //#region src/client/ssg/boltdocs-shell.tsx
 /**
@@ -194,7 +201,7 @@ function StoreSync({ config, routeMap }) {
 	]);
 	return null;
 }
-function BoltdocsShell({ config, routes, components = {} }) {
+function BoltdocsShell({ config, routes, components = {}, collectionsData }) {
 	const allComponents = (0, react.useMemo)(() => ({
 		...mdxComponentsDefault,
 		...virtual_boltdocs_mdx_components.default,
@@ -231,20 +238,23 @@ function BoltdocsShell({ config, routes, components = {} }) {
 		routes,
 		children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_image.ThemeProvider, { children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_docs_layout.UIProvider, { children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(MdxComponentsProvider, {
 			components: allComponents,
-			children: /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(require_icons_dev.ConfigContext.Provider, {
+			children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_icons_dev.ConfigContext.Provider, {
 				value: config,
-				children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(ScrollHandler, {}), /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(require_icons_dev.BoltdocsProvider, {
-					initialLocale: initialData.initLocale,
-					initialVersion: initialData.initVersion,
-					children: [
-						/* @__PURE__ */ (0, react_jsx_runtime.jsx)(StoreSync, {
-							config,
-							routeMap
-						}),
-						/* @__PURE__ */ (0, react_jsx_runtime.jsx)(I18nUpdater, { config }),
-						/* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_search_dialog$1.InternalErrorBoundary, { children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(react_router_dom.Outlet, {}) })
-					]
-				})]
+				children: /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(CollectionsContext.Provider, {
+					value: collectionsData || {},
+					children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(ScrollHandler, {}), /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(require_icons_dev.BoltdocsProvider, {
+						initialLocale: initialData.initLocale,
+						initialVersion: initialData.initVersion,
+						children: [
+							/* @__PURE__ */ (0, react_jsx_runtime.jsx)(StoreSync, {
+								config,
+								routeMap
+							}),
+							/* @__PURE__ */ (0, react_jsx_runtime.jsx)(I18nUpdater, { config }),
+							/* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_search_dialog$1.InternalErrorBoundary, { children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(react_router_dom.Outlet, {}) })
+						]
+					})]
+				})
 			})
 		}) }) })
 	}) });
@@ -850,6 +860,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__ */ (0, react_jsx_runtime.jsxs)(require_docs_layout.Menu.Trigger, { children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)(require_search_dialog.Button, {
+		className: require_icons_dev.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__ */ (0, react_jsx_runtime.jsx)("span", {
+			className: "font-semibold text-[0.8125rem]",
+			children: currentVersionLabel
+		}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_icons_dev.ChevronDown, { className: "w-3.5 h-3.5 text-muted/60" })]
+	}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_docs_layout.Menu.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__ */ (0, react_jsx_runtime.jsx)(require_docs_layout.Menu.Section, {
+			items: availableVersions,
+			children: (version) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_docs_layout.Menu.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
 /**
@@ -929,28 +963,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__ */ (0, react_jsx_runtime.jsxs)(require_docs_layout.Menu.Trigger, { children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)(require_search_dialog.Button, {
-		className: require_icons_dev.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__ */ (0, react_jsx_runtime.jsx)("span", {
-			className: "font-semibold text-[0.8125rem]",
-			children: currentVersionLabel
-		}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_icons_dev.ChevronDown, { className: "w-3.5 h-3.5 text-muted/60" })]
-	}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_docs_layout.Menu.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__ */ (0, react_jsx_runtime.jsx)(require_docs_layout.Menu.Section, {
-			items: availableVersions,
-			children: (version) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_docs_layout.Menu.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 } = require_icons_dev.useRoutes();
+	const location = (0, react_router_dom.useLocation)();
+	const { groups, ungrouped } = require_docs_layout.useSidebar(routes);
+	return (0, react.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 = require_icons_dev.normalizePath(location.pathname);
+		const currentIndex = orderedRoutes.findIndex((r) => require_icons_dev.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 = (0, react.useMemo)(() => createAnalyticsInstance(config), [config]);
+	const previousPath = (0, react.useRef)("");
+	const location = require_docs_layout.useLocation();
+	(0, react.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
+	]);
+	(0, react.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
+	]);
+	(0, react.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 = (0, react.useMemo)(() => createAnalyticsInstance(), []);
+	return (0, react.useCallback)((path, title) => {
+		analytics.trackPageView(path, title);
+	}, [analytics]);
+}
+function useTrackEvent() {
+	const analytics = (0, react.useMemo)(() => createAnalyticsInstance(), []);
+	return (0, react.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 = (0, react_router_dom.useMatches)();
+	return (0, react.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 = require_icons_dev.useConfig();
+	const { currentRoute } = require_icons_dev.useRoutes();
+	const [rating, setRating] = (0, react.useState)(null);
+	const [comment, setComment] = (0, react.useState)("");
+	const [loading, setLoading] = (0, react.useState)(false);
+	const [submitted, setSubmitted] = (0, react.useState)(false);
+	const [error, setError] = (0, react.useState)(null);
+	(0, react.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;
@@ -971,14 +1296,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__ */ (0, react_jsx_runtime.jsx)("span", { children: locale.label })
-			}, `${locale.value ?? ""}`)
+			}, locale.value)
 		})
 	})] });
 }
 
 //#endregion
 //#region src/client/components/ui-base/navbar.tsx
-const SearchDialog$1 = (0, react.lazy)(() => Promise.resolve().then(() => require("../search-dialog-Cr7SC8Xt.cjs")).then((m) => ({ default: m.SearchDialog })));
+const SearchDialog$1 = (0, react.lazy)(() => Promise.resolve().then(() => require("../search-dialog-CzwvKoLW.cjs")).then((m) => ({ default: m.SearchDialog })));
 function Navbar() {
 	const { links, title, logo, logoProps, github, social, config } = useNavbar();
 	const { routes, currentRoute, isCollectionPage, currentVersion, currentLocale } = require_icons_dev.useRoutes();
@@ -1095,7 +1420,7 @@ function Navbar() {
 function NavbarLinkItem({ link }) {
 	const localizedHref = require_icons_dev.useLocalizedTo(link.href || "");
 	const { pathname } = (0, react_router_dom.useLocation)();
-	const active = pathname === localizedHref || pathname.startsWith(localizedHref + "/");
+	const active = pathname === localizedHref || pathname.startsWith(`${localizedHref}/`);
 	if (link.items && link.items.length > 0) return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_search_dialog.Navbar.Dropdown, {
 		label: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
 			className: require_icons_dev.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"),
@@ -1174,36 +1499,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 } = require_icons_dev.useRoutes();
-	const location = (0, react_router_dom.useLocation)();
-	return (0, react.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
 /**
@@ -1293,13 +1588,15 @@ const Sidebar = Object.assign(SidebarMain, {
 function Banner({ children, className = "", dismissible = false, id = "boltdocs-banner", ...props }) {
 	const [isVisible, setIsVisible] = (0, react.useState)(true);
 	(0, react.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__ */ (0, react_jsx_runtime.jsxs)("div", {
@@ -1317,6 +1614,90 @@ function Banner({ children, className = "", dismissible = false, id = "boltdocs-
 	});
 }
 
+//#endregion
+//#region src/client/components/ui-base/feedback.tsx
+function Feedback({ className }) {
+	if (!(require_icons_dev.useConfig().integrations?.feedback?.custom)?.enabled) return null;
+	const { rating, setRating, comment, setComment, loading, submitted, error, submit } = useFeedback();
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+		className: require_icons_dev.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__ */ (0, react_jsx_runtime.jsxs)("div", {
+			className: "flex flex-col items-center justify-center py-4 text-center animate-in fade-in zoom-in duration-300",
+			children: [
+				/* @__PURE__ */ (0, react_jsx_runtime.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__ */ (0, react_jsx_runtime.jsx)(require_icons_dev.Check, { size: 24 })
+				}),
+				/* @__PURE__ */ (0, react_jsx_runtime.jsx)("h3", {
+					className: "text-lg font-semibold text-default",
+					children: "Thank you for your feedback!"
+				}),
+				/* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+					className: "text-sm text-muted mt-1",
+					children: "Your comments help us improve the documentation."
+				})
+			]
+		}) : /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+			className: "flex flex-col gap-4",
+			children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+				className: "flex flex-col sm:flex-row sm:items-center sm:justify-between gap-3",
+				children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("h4", {
+					className: "text-base font-semibold text-default",
+					children: "Was this page helpful?"
+				}), /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+					className: "flex items-center gap-2",
+					children: [
+						/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("button", {
+							type: "button",
+							onClick: () => setRating("good"),
+							className: require_icons_dev.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__ */ (0, react_jsx_runtime.jsx)(require_icons_dev.FaceGood, {}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", { children: "Yes" })]
+						}),
+						/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("button", {
+							type: "button",
+							onClick: () => setRating("neutral"),
+							className: require_icons_dev.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__ */ (0, react_jsx_runtime.jsx)(require_icons_dev.FaceRegular, {}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", { children: "Regular" })]
+						}),
+						/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("button", {
+							type: "button",
+							onClick: () => setRating("bad"),
+							className: require_icons_dev.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__ */ (0, react_jsx_runtime.jsx)(require_icons_dev.FaceBad, {}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", { children: "No" })]
+						})
+					]
+				})]
+			}), rating && /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+				className: "flex flex-col gap-3 mt-1 animate-in slide-in-from-top-3 duration-300",
+				children: [/* @__PURE__ */ (0, react_jsx_runtime.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__ */ (0, react_jsx_runtime.jsxs)("div", {
+					className: "flex items-center justify-between gap-3",
+					children: [error && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+						className: "text-xs text-rose-500 font-medium flex-1",
+						children: error
+					}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+						className: "flex items-center gap-2 ml-auto",
+						children: /* @__PURE__ */ (0, react_jsx_runtime.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__ */ (0, react_jsx_runtime.jsx)("div", {
@@ -1453,13 +1834,6 @@ function Head({ siteTitle, siteDescription, routes }) {
 	] });
 }
 
-//#endregion
-//#region src/client/collections/collections-context.tsx
-const CollectionsContext = (0, react.createContext)({});
-function useCollectionsData() {
-	return (0, react.use)(CollectionsContext);
-}
-
 //#endregion
 //#region src/client/app/docs-layout.tsx
 function DocsLayout({ collectionsData }) {
@@ -1937,205 +2311,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 = (0, react.useMemo)(() => createAnalyticsInstance(config), [config]);
-	const previousPath = (0, react.useRef)("");
-	const location = require_docs_layout.useLocation();
-	(0, react.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
-	]);
-	(0, react.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
-	]);
-	(0, react.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 = (0, react.useMemo)(() => createAnalyticsInstance(), []);
-	return (0, react.useCallback)((path, title) => {
-		analytics.trackPageView(path, title);
-	}, [analytics]);
-}
-function useTrackEvent() {
-	const analytics = (0, react.useMemo)(() => createAnalyticsInstance(), []);
-	return (0, react.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 = (0, react_router_dom.useMatches)();
-	return (0, react.useMemo)(() => {
-		return (matches[matches.length - 1]?.data)?.headings || [];
-	}, [matches]);
-}
-
 //#endregion
 //#region src/client/components/docs-layout-default.tsx
 function DocsLayoutComponent({ children }) {
@@ -2176,6 +2358,7 @@ function DocsLayoutComponent({ children }) {
 								className: "prose prose-neutral dark:prose-invert max-w-none",
 								children
 							}) }),
+							!isCollectionPage && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(Feedback, {}),
 							/* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_docs_layout.DocsLayout.Footer, { children: !isCollectionPage && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(PageNav, {}) })
 						]
 					})
@@ -2269,7 +2452,9 @@ exports.getTranslated = getTranslated;
 exports.reactToText = reactToText;
 exports.useAnalytics = useAnalytics;
 exports.useBreadcrumbs = useBreadcrumbs;
+exports.useCodeBlock = require_mdx.useCodeBlock;
 exports.useConfig = require_icons_dev.useConfig;
+exports.useFeedback = useFeedback;
 exports.useHeadings = useHeadings;
 exports.useI18n = useI18n;
 exports.useLocalizedTo = require_icons_dev.useLocalizedTo;