boltdocs 2.8.3 → 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-DvJ-hh9x.cjs');
-const require_image = require('../image-Ch4-GxdO.cjs');
-const require_mdx = require('../mdx-BGM7LjW5.cjs');
-const require_docs_layout = require('../docs-layout-CwCq42Zt.cjs');
-const require_search_dialog = require('../search-dialog-BXVoecTx.cjs');
-const require_search_dialog$1 = require('../search-dialog-BYhOov4S.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,209 +963,500 @@ 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 ?? ""}`)
-		})
-	})] });
-}
-function I18nSelector({ className }) {
-	const { currentLocale, availableLocales, handleLocaleChange } = useI18n();
-	if (availableLocales.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.jsxs)("div", {
-			className: "flex items-center gap-1.5",
-			children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_icons_dev.Languages, { className: "w-3.5 h-3.5 text-primary-500" }), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
-				className: "font-bold text-[0.75rem] uppercase opacity-90",
-				children: currentLocale || "en"
-			})]
-		}), /* @__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: availableLocales,
-			children: (locale) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_docs_layout.Menu.Item, {
-				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 ?? ""}`)
-		})
-	})] });
+//#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/components/ui-base/navbar.tsx
-const SearchDialog$1 = (0, react.lazy)(() => Promise.resolve().then(() => require("../search-dialog-CUeAfy-8.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();
-	const { isSidebarOpen, toggleSidebar } = require_docs_layout.useUI();
-	const [isMobileMenuOpen, setIsMobileMenuOpen] = (0, react.useState)(false);
-	const themeConfig = config.theme || {};
-	const isDocs = !!currentRoute?.filePath && !isCollectionPage;
-	const hasTabs = themeConfig?.tabs && themeConfig.tabs.length > 0;
-	return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(require_search_dialog.Navbar.Root, {
-		className: require_icons_dev.cn("border-b border-subtle bg-main/80 backdrop-blur-md", hasTabs && "border-b-0"),
-		children: [
-			/* @__PURE__ */ (0, react_jsx_runtime.jsxs)(require_search_dialog.Navbar.Content, { children: [
-				/* @__PURE__ */ (0, react_jsx_runtime.jsxs)(require_search_dialog.Navbar.Left, { children: [
-					isDocs && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_search_dialog.Button, {
-						onPress: toggleSidebar,
-						className: "mr-2 lg:hidden p-1.5 h-8 w-8 flex items-center justify-center bg-transparent border-none outline-none select-none cursor-pointer rounded-xl hover:bg-primary-50/50 transition-colors",
-						"aria-label": isSidebarOpen ? "Close sidebar" : "Open sidebar",
-						children: isSidebarOpen ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_icons_dev.X, { className: "w-5 h-5 text-body" }) : /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_icons_dev.Menu, { className: "w-5 h-5 text-body" })
-					}),
-					logo && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_search_dialog.Navbar.Logo, {
-						src: logo,
-						alt: logoProps?.alt || title,
-						width: logoProps?.width ?? 24,
-						height: logoProps?.height ?? 24,
-						href: "site:/"
-					}),
-					/* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_search_dialog.Navbar.Title, {
-						href: "site:/",
-						children: title
-					}),
-					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
-						className: "hidden sm:block",
-						children: config.versions && currentVersion && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(VersionSelector, {})
-					})
-				] }),
-				/* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_search_dialog.Navbar.Center, { children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(react.Suspense, {
-					fallback: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", { className: "h-9 w-32 animate-pulse rounded-md bg-surface" }),
-					children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(SearchDialog$1, { routes: routes || [] })
-				}) }),
-				/* @__PURE__ */ (0, react_jsx_runtime.jsxs)(require_search_dialog.Navbar.Right, { children: [
-					/* @__PURE__ */ (0, react_jsx_runtime.jsx)(react.Suspense, {
-						fallback: null,
-						children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
-							className: "lg:hidden",
-							children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(SearchDialog$1, { routes: routes || [] })
-						})
-					}),
-					/* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_search_dialog.Navbar.Links, { children: links.map((link) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)(NavbarLinkItem, { link }, link.href)) }),
-					/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
-						className: "hidden sm:flex items-center gap-2",
-						children: [config.i18n && currentLocale && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(I18nSelector, {}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_search_dialog.Navbar.Split, { className: "bg-subtle" })]
-					}),
-					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
-						className: "hidden md:block",
-						children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ThemeToggle, {})
-					}),
-					github && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
-						className: "hidden md:block",
-						children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(GithubStars, { repo: themeConfig?.githubRepo ?? "" })
-					}),
-					social.length > 0 && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
-						className: "hidden md:block",
-						children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_search_dialog.Navbar.Split, { className: "bg-subtle" })
-					}),
-					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
-						className: "hidden md:flex items-center gap-1",
-						children: social.map(({ icon, link }) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_search_dialog.Navbar.Socials, {
-							icon,
-							link,
-							className: "p-1.5 text-muted hover:text-body hover:bg-surface rounded-md transition-all focus-visible:ring-2 focus-visible:ring-primary-500/30"
-						}, link))
-					}),
-					/* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_search_dialog.Navbar.More, {
-						onPress: () => setIsMobileMenuOpen(true),
-						className: "text-muted hover:text-body active:scale-90 transition-all focus-visible:ring-2 focus-visible:ring-primary-500/30"
-					})
-				] })
-			] }),
-			/* @__PURE__ */ (0, react_jsx_runtime.jsxs)(require_search_dialog.Navbar.MobileMenu, {
-				isOpen: isMobileMenuOpen,
-				onClose: () => setIsMobileMenuOpen(false),
-				className: "bg-main/98 backdrop-blur-2xl",
-				children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
-					className: "flex flex-col gap-1",
-					children: links.map((link) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)(NavbarMobileLinkItem, {
-						link,
-						onClose: () => setIsMobileMenuOpen(false)
-					}, link.href))
-				}), social.length > 0 && /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
-					className: "mt-6",
-					children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
-						className: "px-4 mb-4 text-xs font-bold uppercase tracking-widest text-muted/50",
-						children: "Connect"
-					}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
-						className: "flex flex-wrap gap-2 px-2",
-						children: social.map(({ icon, link }) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_search_dialog.Navbar.Socials, {
-							icon,
-							link,
-							className: "p-3 bg-surface border border-subtle rounded-xl flex-1 justify-center"
-						}, link))
-					})]
-				})]
-			}),
-			isDocs && hasTabs && themeConfig?.tabs && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
-				className: "w-full border-b border-subtle bg-main",
-				children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(Tabs, {
-					tabs: themeConfig.tabs,
-					routes: routes || []
-				})
-			})
-		]
-	});
-}
-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 + "/");
-	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"),
-			children: link.label
-		}),
-		children: link.items?.map((item) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_search_dialog.Navbar.DropdownItem, {
-			href: require_icons_dev.useLocalizedTo(item.href || ""),
-			label: item.label
-		}, item.href))
-	});
-	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_search_dialog.Navbar.Link, {
-		...link,
-		href: localizedHref,
-		active,
-		className: require_icons_dev.cn("transition-colors outline-none font-medium focus-visible:ring-2 focus-visible:ring-primary-500/30 rounded-sm", active ? "text-primary-500" : "text-muted hover:text-body")
-	});
+//#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 NavbarMobileLinkItem({ link, onClose }) {
-	const localizedHref = require_icons_dev.useLocalizedTo(link.href || "");
-	const { pathname } = (0, react_router_dom.useLocation)();
-	const active = pathname === localizedHref;
-	if (link.items && link.items.length > 0) return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
-		className: "flex flex-col gap-1",
-		children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
-			className: require_icons_dev.cn("px-3 py-2 text-sm transition-all", active ? "text-body" : "text-muted/80 hover:text-body"),
-			children: link.label
-		}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
-			className: "flex flex-col gap-1 pl-4",
-			children: link.items?.map((item) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)(NavbarMobileLinkItem, {
-				link: item,
-				onClose
-			}, item.href))
-		})]
-	});
-	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_search_dialog.Navbar.MobileLink, {
-		...link,
+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;
+	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.jsxs)("div", {
+			className: "flex items-center gap-1.5",
+			children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_icons_dev.Languages, { className: "w-3.5 h-3.5 text-primary-500" }), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+				className: "font-bold text-[0.75rem] uppercase opacity-90",
+				children: currentLocale || "en"
+			})]
+		}), /* @__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: availableLocales,
+			children: (locale) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_docs_layout.Menu.Item, {
+				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)
+		})
+	})] });
+}
+
+//#endregion
+//#region src/client/components/ui-base/navbar.tsx
+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();
+	const { isSidebarOpen, toggleSidebar } = require_docs_layout.useUI();
+	const [isMobileMenuOpen, setIsMobileMenuOpen] = (0, react.useState)(false);
+	const themeConfig = config.theme || {};
+	const isDocs = !!currentRoute?.filePath && !isCollectionPage;
+	const hasTabs = themeConfig?.tabs && themeConfig.tabs.length > 0;
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(require_search_dialog.Navbar.Root, {
+		className: require_icons_dev.cn("border-b border-subtle bg-main/80 backdrop-blur-md", hasTabs && "border-b-0"),
+		children: [
+			/* @__PURE__ */ (0, react_jsx_runtime.jsxs)(require_search_dialog.Navbar.Content, { children: [
+				/* @__PURE__ */ (0, react_jsx_runtime.jsxs)(require_search_dialog.Navbar.Left, { children: [
+					isDocs && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_search_dialog.Button, {
+						onPress: toggleSidebar,
+						className: "mr-2 lg:hidden p-1.5 h-8 w-8 flex items-center justify-center bg-transparent border-none outline-none select-none cursor-pointer rounded-xl hover:bg-primary-50/50 transition-colors",
+						"aria-label": isSidebarOpen ? "Close sidebar" : "Open sidebar",
+						children: isSidebarOpen ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_icons_dev.X, { className: "w-5 h-5 text-body" }) : /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_icons_dev.Menu, { className: "w-5 h-5 text-body" })
+					}),
+					logo && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_search_dialog.Navbar.Logo, {
+						src: logo,
+						alt: logoProps?.alt || title,
+						width: logoProps?.width ?? 24,
+						height: logoProps?.height ?? 24,
+						href: "site:/"
+					}),
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_search_dialog.Navbar.Title, {
+						href: "site:/",
+						children: title
+					}),
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+						className: "hidden sm:block",
+						children: config.versions && currentVersion && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(VersionSelector, {})
+					})
+				] }),
+				/* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_search_dialog.Navbar.Center, { children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(react.Suspense, {
+					fallback: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", { className: "h-9 w-32 animate-pulse rounded-md bg-surface" }),
+					children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(SearchDialog$1, { routes: routes || [] })
+				}) }),
+				/* @__PURE__ */ (0, react_jsx_runtime.jsxs)(require_search_dialog.Navbar.Right, { children: [
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)(react.Suspense, {
+						fallback: null,
+						children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+							className: "lg:hidden",
+							children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(SearchDialog$1, { routes: routes || [] })
+						})
+					}),
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_search_dialog.Navbar.Links, { children: links.map((link) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)(NavbarLinkItem, { link }, link.href)) }),
+					/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+						className: "hidden sm:flex items-center gap-2",
+						children: [config.i18n && currentLocale && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(I18nSelector, {}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_search_dialog.Navbar.Split, { className: "bg-subtle" })]
+					}),
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+						className: "hidden md:block",
+						children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ThemeToggle, {})
+					}),
+					github && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+						className: "hidden md:block",
+						children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(GithubStars, { repo: themeConfig?.githubRepo ?? "" })
+					}),
+					social.length > 0 && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+						className: "hidden md:block",
+						children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_search_dialog.Navbar.Split, { className: "bg-subtle" })
+					}),
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+						className: "hidden md:flex items-center gap-1",
+						children: social.map(({ icon, link }) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_search_dialog.Navbar.Socials, {
+							icon,
+							link,
+							className: "p-1.5 text-muted hover:text-body hover:bg-surface rounded-md transition-all focus-visible:ring-2 focus-visible:ring-primary-500/30"
+						}, link))
+					}),
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_search_dialog.Navbar.More, {
+						onPress: () => setIsMobileMenuOpen(true),
+						className: "text-muted hover:text-body active:scale-90 transition-all focus-visible:ring-2 focus-visible:ring-primary-500/30"
+					})
+				] })
+			] }),
+			/* @__PURE__ */ (0, react_jsx_runtime.jsxs)(require_search_dialog.Navbar.MobileMenu, {
+				isOpen: isMobileMenuOpen,
+				onClose: () => setIsMobileMenuOpen(false),
+				className: "bg-main/98 backdrop-blur-2xl",
+				children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+					className: "flex flex-col gap-1",
+					children: links.map((link) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)(NavbarMobileLinkItem, {
+						link,
+						onClose: () => setIsMobileMenuOpen(false)
+					}, link.href))
+				}), social.length > 0 && /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+					className: "mt-6",
+					children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+						className: "px-4 mb-4 text-xs font-bold uppercase tracking-widest text-muted/50",
+						children: "Connect"
+					}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+						className: "flex flex-wrap gap-2 px-2",
+						children: social.map(({ icon, link }) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_search_dialog.Navbar.Socials, {
+							icon,
+							link,
+							className: "p-3 bg-surface border border-subtle rounded-xl flex-1 justify-center"
+						}, link))
+					})]
+				})]
+			}),
+			isDocs && hasTabs && themeConfig?.tabs && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+				className: "w-full border-b border-subtle bg-main",
+				children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(Tabs, {
+					tabs: themeConfig.tabs,
+					routes: routes || []
+				})
+			})
+		]
+	});
+}
+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}/`);
+	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"),
+			children: link.label
+		}),
+		children: link.items?.map((item) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_search_dialog.Navbar.DropdownItem, {
+			href: require_icons_dev.useLocalizedTo(item.href || ""),
+			label: item.label
+		}, item.href))
+	});
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_search_dialog.Navbar.Link, {
+		...link,
+		href: localizedHref,
+		active,
+		className: require_icons_dev.cn("transition-colors outline-none font-medium focus-visible:ring-2 focus-visible:ring-primary-500/30 rounded-sm", active ? "text-primary-500" : "text-muted hover:text-body")
+	});
+}
+function NavbarMobileLinkItem({ link, onClose }) {
+	const localizedHref = require_icons_dev.useLocalizedTo(link.href || "");
+	const { pathname } = (0, react_router_dom.useLocation)();
+	const active = pathname === localizedHref;
+	if (link.items && link.items.length > 0) return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+		className: "flex flex-col gap-1",
+		children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+			className: require_icons_dev.cn("px-3 py-2 text-sm transition-all", active ? "text-body" : "text-muted/80 hover:text-body"),
+			children: link.label
+		}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+			className: "flex flex-col gap-1 pl-4",
+			children: link.items?.map((item) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)(NavbarMobileLinkItem, {
+				link: item,
+				onClose
+			}, item.href))
+		})]
+	});
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_search_dialog.Navbar.MobileLink, {
+		...link,
 		href: localizedHref,
 		active,
 		onPress: onClose,
@@ -1150,58 +1475,28 @@ function OnThisPage({ headings = [], editLink, communityHelp, filePath }) {
 		}),
 		/* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_docs_layout.OnThisPage.Tree, { headings }),
 		(editLink || communityHelp) && /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
-			className: "mt-8 pt-8 border-t border-subtle space-y-4",
-			children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
-				className: "text-xs font-bold text-body",
-				children: "Need help?"
-			}), /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("ul", {
-				className: "space-y-3",
-				children: [editLink && filePath && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("li", { children: /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("a", {
-					href: editLink.replace(":path", filePath),
-					target: "_blank",
-					rel: "noopener noreferrer",
-					className: "flex items-center gap-2 text-sm text-muted hover:text-body transition-colors",
-					children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_icons_dev.Pencil, { size: 16 }), "Edit this page"]
-				}) }), communityHelp && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("li", { children: /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("a", {
-					href: communityHelp,
-					target: "_blank",
-					rel: "noopener noreferrer",
-					className: "flex items-center gap-2 text-sm text-muted hover:text-body transition-colors",
-					children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_icons_dev.CircleHelp, { size: 16 }), "Community help"]
-				}) })]
-			})]
-		})
-	] });
-}
-
-//#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
-	]);
+			className: "mt-8 pt-8 border-t border-subtle space-y-4",
+			children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+				className: "text-xs font-bold text-body",
+				children: "Need help?"
+			}), /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("ul", {
+				className: "space-y-3",
+				children: [editLink && filePath && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("li", { children: /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("a", {
+					href: editLink.replace(":path", filePath),
+					target: "_blank",
+					rel: "noopener noreferrer",
+					className: "flex items-center gap-2 text-sm text-muted hover:text-body transition-colors",
+					children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_icons_dev.Pencil, { size: 16 }), "Edit this page"]
+				}) }), communityHelp && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("li", { children: /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("a", {
+					href: communityHelp,
+					target: "_blank",
+					rel: "noopener noreferrer",
+					className: "flex items-center gap-2 text-sm text-muted hover:text-body transition-colors",
+					children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_icons_dev.CircleHelp, { size: 16 }), "Community help"]
+				}) })]
+			})]
+		})
+	] });
 }
 
 //#endregion
@@ -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 }) {
@@ -1582,21 +1956,37 @@ function buildDocRoutes(options) {
 	const targetBasePaths = [];
 	targetBasePaths.push({
 		path: baseDocsPath,
-		filter: () => true
+		filter: () => true,
+		locale: config.i18n?.defaultLocale,
+		version: config.versions?.defaultVersion
 	});
-	const subPaths = [];
-	if (allVersions.length > 0) allVersions.forEach((v) => subPaths.push(`/${v}`));
-	if (locales.length > 0) locales.forEach((l) => subPaths.push(`/${l}`));
-	if (allVersions.length > 0 && locales.length > 0) allVersions.forEach((v) => {
-		locales.forEach((l) => {
-			subPaths.push(`/${v}/${l}`);
+	if (allVersions.length > 0) allVersions.forEach((v) => {
+		const fullP = baseDocsPath === "/" ? `/${v}` : `${baseDocsPath}/${v}`;
+		targetBasePaths.push({
+			path: fullP,
+			filter: (rp) => !!rp && rp.startsWith(fullP.replace(/\/$/, "") + "/"),
+			locale: config.i18n?.defaultLocale,
+			version: v
 		});
 	});
-	subPaths.forEach((sp) => {
-		const fullP = baseDocsPath === "/" ? sp : `${baseDocsPath}${sp}`;
+	if (locales.length > 0) locales.forEach((l) => {
+		const fullP = baseDocsPath === "/" ? `/${l}` : `${baseDocsPath}/${l}`;
 		targetBasePaths.push({
 			path: fullP,
-			filter: (rp) => !!rp && rp.startsWith(fullP.replace(/\/$/, "") + "/")
+			filter: (rp) => !!rp && rp.startsWith(fullP.replace(/\/$/, "") + "/"),
+			locale: l,
+			version: config.versions?.defaultVersion
+		});
+	});
+	if (allVersions.length > 0 && locales.length > 0) allVersions.forEach((v) => {
+		locales.forEach((l) => {
+			const fullP = baseDocsPath === "/" ? `/${v}/${l}` : `${baseDocsPath}/${v}/${l}`;
+			targetBasePaths.push({
+				path: fullP,
+				filter: (rp) => !!rp && rp.startsWith(fullP.replace(/\/$/, "") + "/"),
+				locale: l,
+				version: v
+			});
 		});
 	});
 	const docPathRegistry = new Set(docRoutes.map((r) => (r.path || "").replace(/\/$/, "")));
@@ -1608,7 +1998,7 @@ function buildDocRoutes(options) {
 			externalPaths.add(`/${locale}${p === "/" ? "" : p}`.replace(/\/$/, ""));
 		});
 	});
-	targetBasePaths.forEach(({ path: bPath, filter }) => {
+	targetBasePaths.forEach(({ path: bPath, filter, locale: bLocale, version: bVersion }) => {
 		if (bPath === "/") return;
 		const normalizedPath = bPath.replace(/\/$/, "");
 		if (!(docPathRegistry.has(normalizedPath) || externalPaths.has(normalizedPath))) {
@@ -1622,6 +2012,7 @@ function buildDocRoutes(options) {
 				docRoutes.push({
 					...isBasePathFallback ? { index: true } : { path: redirectPath },
 					element: matchedRouteObj.element,
+					lazy: matchedRouteObj.lazy,
 					loader: matchedRouteObj.loader,
 					getStaticPaths: () => []
 				});
@@ -1635,8 +2026,11 @@ function buildDocRoutes(options) {
 					docMetadata.push({
 						...matchedMetaObj,
 						path: bPath,
-						filePath: "",
+						filePath: matchedMetaObj.filePath,
+						locale: bLocale,
+						version: bVersion,
 						slugParts: [],
+						fallback: true,
 						seo: {
 							...matchedMetaObj.seo,
 							canonical: canonicalUrl
@@ -1917,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 }) {
@@ -2156,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, {}) })
 						]
 					})
@@ -2249,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;