boltdocs 2.7.10 → 2.7.11

package/dist/docs-layout-DwFndmj5.js

@@ -0,0 +1,1231 @@
+/**
+ * Boltdocs - https://boltdocs.vercel.app
+ * Copyright (c) 2026 Jesus Alcala
+ * Licensed under the MIT License.
+ */
+import { D as ChevronRight, E as ChevronLeft, Y as icons_exports, Z as normalizePath, _ as Link, b as useLocalizedTo, nt as useConfig, w as Check, y as cn } from "./icons-dev-Df8OQ481.js";
+import { useLocation } from "react-router-dom";
+import { Children, Component, createContext, use, useContext, useEffect, useImperativeHandle, useLayoutEffect, useMemo, useRef, useState } from "react";
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+import * as RAC from "react-aria-components";
+import { Breadcrumb, Breadcrumbs, Popover } from "react-aria-components";
+import virtualIcons from "virtual:boltdocs-icons";
+import scrollIntoView from "scroll-into-view-if-needed";
+
+//#region src/client/components/primitives/breadcrumbs.tsx
+const Breadcrumbs$1 = ({ children, className, ...props }) => {
+	return /* @__PURE__ */ jsx(Breadcrumbs, {
+		className: cn("flex flex-wrap items-center", className),
+		...props,
+		children
+	});
+};
+const BreadcrumbsItem = ({ children, className, ...props }) => {
+	return /* @__PURE__ */ jsx(Breadcrumb, {
+		className: cn("flex items-center", className),
+		...props,
+		children
+	});
+};
+const BreadcrumbsLink = ({ children, href, className, ...props }) => {
+	return /* @__PURE__ */ jsx(Link, {
+		href,
+		className: cn("cursor-pointer", className),
+		...props,
+		children
+	});
+};
+const BreadcrumbsSeparator = ({ className }) => {
+	return /* @__PURE__ */ jsx(ChevronRight, {
+		size: 14,
+		className: cn("shrink-0", className)
+	});
+};
+Breadcrumbs$1.Root = Breadcrumbs$1;
+Breadcrumbs$1.Item = BreadcrumbsItem;
+Breadcrumbs$1.Link = BreadcrumbsLink;
+Breadcrumbs$1.Separator = BreadcrumbsSeparator;
+
+//#endregion
+//#region src/client/components/primitives/button.tsx
+const Button$1 = ({ ...props }) => {
+	return /* @__PURE__ */ jsx(RAC.Button, { ...props });
+};
+
+//#endregion
+//#region src/client/components/primitives/button-group.tsx
+const ButtonGroup = ({ children, className, vertical = false }) => {
+	return /* @__PURE__ */ jsx("div", {
+		className: cn("inline-flex", vertical ? "flex-col" : "flex-row", !vertical && [
+			"[&>*:not(:first-child)]:-ml-px",
+			"[&>*:first-child]:rounded-r-none",
+			"[&>*:last-child]:rounded-l-none",
+			"[&>*:not(:first-child):not(:last-child)]:rounded-none",
+			className?.includes("rounded-full") && ["[&>*:first-child]:rounded-l-full", "[&>*:last-child]:rounded-r-full"],
+			className?.includes("rounded-xl") && ["[&>*:first-child]:rounded-l-xl", "[&>*:last-child]:rounded-r-xl"],
+			className?.includes("rounded-lg") && ["[&>*:first-child]:rounded-l-lg", "[&>*:last-child]:rounded-r-lg"]
+		], vertical && [
+			"[&>*:not(:first-child)]:-mt-px",
+			"[&>*:first-child]:rounded-b-none",
+			"[&>*:last-child]:rounded-t-none",
+			"[&>*:not(:first-child):not(:last-child)]:rounded-none",
+			className?.includes("rounded-full") && ["[&>*:first-child]:rounded-t-full", "[&>*:last-child]:rounded-b-full"]
+		], className),
+		children
+	});
+};
+
+//#endregion
+//#region src/client/components/primitives/popover.tsx
+/**
+* A reusable Popover primitive with premium glassmorphism styling and smooth animations.
+*/
+const Popover$1 = ({ children, className, ...props }) => {
+	return /* @__PURE__ */ jsx(Popover, {
+		offset: 8,
+		className: cn("z-50 overflow-auto outline-none transition-none", className),
+		...props,
+		children
+	});
+};
+
+//#endregion
+//#region src/client/components/primitives/menu.tsx
+function MenuTrigger({ placement, className, ...props }) {
+	const [trigger, menu] = Children.toArray(props.children).slice(0, 2);
+	return /* @__PURE__ */ jsxs(RAC.MenuTrigger, {
+		...props,
+		children: [trigger, /* @__PURE__ */ jsx(Popover$1, {
+			placement,
+			className,
+			children: menu
+		})]
+	});
+}
+function SubmenuTrigger({ className, ...props }) {
+	const [trigger, menu] = Children.toArray(props.children).slice(0, 2);
+	return /* @__PURE__ */ jsxs(RAC.SubmenuTrigger, {
+		...props,
+		children: [trigger, /* @__PURE__ */ jsx(Popover$1, {
+			offset: -4,
+			crossOffset: -4,
+			className,
+			children: menu
+		})]
+	});
+}
+/**
+* The Menu container.
+*/
+function Menu(props) {
+	return /* @__PURE__ */ jsx(RAC.Menu, {
+		...props,
+		className: RAC.composeRenderProps(props.className, (className) => cn("outline-none overflow-auto", className))
+	});
+}
+/**
+* MenuItem with support for selection states and submenus.
+*/
+function MenuItem(props) {
+	const textValue = props.textValue || (typeof props.children === "string" ? props.children : void 0);
+	return /* @__PURE__ */ jsx(RAC.MenuItem, {
+		...props,
+		textValue,
+		className: RAC.composeRenderProps(props.className, (className) => cn("group relative flex flex-row items-center cursor-default outline-none", className)),
+		children: RAC.composeRenderProps(props.children, (children, { selectionMode, isSelected, hasSubmenu }) => /* @__PURE__ */ jsxs(Fragment, { children: [
+			selectionMode === "multiple" && /* @__PURE__ */ jsx("span", {
+				className: "flex items-center shrink-0 justify-center",
+				children: isSelected && /* @__PURE__ */ jsx(Check, { className: "size-3.5" })
+			}),
+			/* @__PURE__ */ jsx("div", {
+				className: "flex flex-row w-full items-center",
+				children
+			}),
+			hasSubmenu && /* @__PURE__ */ jsx(ChevronRight, { className: "size-4 ml-auto" })
+		] }))
+	});
+}
+function MenuSection({ title, ...props }) {
+	return /* @__PURE__ */ jsxs(RAC.MenuSection, {
+		...props,
+		className: cn("flex flex-col", props.className),
+		children: [title && /* @__PURE__ */ jsx(RAC.Header, {
+			className: "select-none",
+			children: title
+		}), /* @__PURE__ */ jsx(RAC.Collection, {
+			items: props.items,
+			children: props.children
+		})]
+	});
+}
+/**
+* MenuSeparator for visual division.
+*/
+function MenuSeparator(props) {
+	return /* @__PURE__ */ jsx(RAC.Separator, {
+		...props,
+		className: cn("border-t", props.className)
+	});
+}
+Menu.Root = Menu;
+Menu.Item = MenuItem;
+Menu.Trigger = MenuTrigger;
+Menu.SubTrigger = SubmenuTrigger;
+Menu.Section = MenuSection;
+Menu.Separator = MenuSeparator;
+
+//#endregion
+//#region src/client/components/primitives/error-boundary.tsx
+var ErrorBoundary = class extends Component {
+	state = {
+		hasError: false,
+		error: null
+	};
+	static getDerivedStateFromError(error) {
+		return {
+			hasError: true,
+			error
+		};
+	}
+	componentDidCatch(error, errorInfo) {
+		if (this.props.onError) this.props.onError(error, errorInfo);
+		else console.error("ErrorBoundary caught an unhandled error:", error, errorInfo);
+	}
+	resetErrorBoundary = () => {
+		if (this.props.onReset) this.props.onReset();
+		this.setState({
+			hasError: false,
+			error: null
+		});
+	};
+	render() {
+		const { hasError, error } = this.state;
+		const { children, fallback, FallbackComponent } = this.props;
+		if (hasError && error) {
+			if (FallbackComponent) return /* @__PURE__ */ jsx(FallbackComponent, {
+				error,
+				resetErrorBoundary: this.resetErrorBoundary
+			});
+			if (fallback) return fallback;
+			return /* @__PURE__ */ jsx(ErrorBoundaryFallback, {
+				error,
+				resetErrorBoundary: this.resetErrorBoundary
+			});
+		}
+		return children;
+	}
+};
+function ErrorBoundaryFallback({ error, resetErrorBoundary }) {
+	return /* @__PURE__ */ jsxs("div", {
+		className: "flex flex-col items-center justify-center min-h-[40vh] text-center gap-4 px-6 py-8 border border-subtle bg-surface rounded-2xl max-w-lg mx-auto shadow-xs",
+		children: [
+			/* @__PURE__ */ jsx("div", {
+				className: "text-lg font-bold text-rose-600 dark:text-rose-400",
+				children: "Something went wrong"
+			}),
+			/* @__PURE__ */ jsx("p", {
+				className: "text-sm text-muted max-w-sm leading-relaxed",
+				children: error?.message || "An unexpected error occurred while rendering this page."
+			}),
+			/* @__PURE__ */ jsx(Button$1, {
+				className: "rounded-xl border border-subtle bg-main px-6 py-2.5 text-xs font-semibold text-body hover:bg-primary-50/50 hover:border-primary-500/50 transition-all duration-300 cursor-pointer outline-none select-none",
+				onPress: resetErrorBoundary,
+				children: "Try again"
+			})
+		]
+	});
+}
+
+//#endregion
+//#region src/client/components/primitives/tabs.tsx
+const Tabs = ({ children, className = "", ...props }) => {
+	return /* @__PURE__ */ jsx("div", {
+		className: cn("w-full", className),
+		...props,
+		children
+	});
+};
+const TabsList = ({ children, className = "" }) => {
+	return /* @__PURE__ */ jsx("div", {
+		role: "tablist",
+		className: cn("relative flex flex-row items-center", className),
+		children
+	});
+};
+const TabsItem = ({ children, id, selected, className = "", ...props }) => {
+	return /* @__PURE__ */ jsx("button", {
+		role: "tab",
+		"aria-selected": selected,
+		"data-selected": selected,
+		className: cn("outline-none cursor-pointer bg-transparent border-none", className),
+		...props,
+		children
+	});
+};
+const TabsContent = ({ children, className = "" }) => {
+	return /* @__PURE__ */ jsx("div", {
+		className: cn("outline-none", className),
+		children
+	});
+};
+const TabsIndicator = ({ className = "", style }) => {
+	return /* @__PURE__ */ jsx("div", {
+		className: cn("absolute bottom-0", className),
+		style
+	});
+};
+Tabs.Root = Tabs;
+Tabs.List = TabsList;
+Tabs.Item = TabsItem;
+Tabs.Content = TabsContent;
+Tabs.Indicator = TabsIndicator;
+
+//#endregion
+//#region src/client/app/ui-context.tsx
+const UIContext = createContext(void 0);
+function UIProvider({ children }) {
+	const [isSidebarOpen, setIsSidebarOpen] = useState(false);
+	const location = useLocation();
+	const toggleSidebar = () => setIsSidebarOpen((prev) => !prev);
+	const closeSidebar = () => setIsSidebarOpen(false);
+	useEffect(() => {
+		setIsSidebarOpen(false);
+	}, [location.pathname]);
+	return /* @__PURE__ */ jsx(UIContext.Provider, {
+		value: {
+			isSidebarOpen,
+			toggleSidebar,
+			closeSidebar
+		},
+		children
+	});
+}
+function useUI() {
+	const context = useContext(UIContext);
+	if (context === void 0) return {
+		isSidebarOpen: false,
+		toggleSidebar: () => {},
+		closeSidebar: () => {}
+	};
+	return context;
+}
+
+//#endregion
+//#region src/client/components/primitives/helpers/observer.ts
+function getItemId(url) {
+	if (url.startsWith("#")) return url.slice(1);
+	return null;
+}
+var Observer = class {
+	items = [];
+	single = false;
+	observer = null;
+	onChange;
+	callback(_entries) {
+		for (const item of this.items) {
+			const element = document.getElementById(item.id);
+			if (!element) {
+				item.active = false;
+				item.fallback = false;
+				continue;
+			}
+			const rect = element.getBoundingClientRect();
+			const viewportHeight = typeof window !== "undefined" ? window.innerHeight : 1e3;
+			const isInViewport = rect.bottom > 0 && rect.top < viewportHeight;
+			item.active = isInViewport;
+			item.fallback = !isInViewport && rect.top > 0 && rect.top < viewportHeight * 2;
+		}
+		if (this.single) {
+			let highlightIdx = -1;
+			const visibleItems = this.items.map((item, idx) => ({
+				item,
+				idx
+			})).filter(({ item }) => item.active);
+			if (visibleItems.length > 0) highlightIdx = visibleItems[0].idx;
+			else {
+				const fallbackItems = this.items.map((item, idx) => ({
+					item,
+					idx
+				})).filter(({ item }) => item.fallback);
+				if (fallbackItems.length > 0) highlightIdx = fallbackItems[0].idx;
+				else if (this.items.length > 0) highlightIdx = 0;
+			}
+			this.items = this.items.map((item, idx) => ({
+				...item,
+				active: idx === highlightIdx,
+				t: idx === highlightIdx ? Date.now() : item.t
+			}));
+		} else this.items = this.items.map((item, idx) => ({
+			...item,
+			active: item.active,
+			t: item.active ? Date.now() : item.t
+		}));
+		this.onChange?.();
+	}
+	setItems(newItems) {
+		const observer = this.observer;
+		if (observer) for (const item of this.items) {
+			const element = document.getElementById(item.id);
+			if (!element) continue;
+			observer.unobserve(element);
+		}
+		this.items = [];
+		for (const item of newItems) {
+			const id = getItemId(item.url);
+			if (!id) continue;
+			this.items.push({
+				id,
+				active: false,
+				fallback: false,
+				t: 0,
+				original: item
+			});
+		}
+		this.watchItems();
+		if (typeof window !== "undefined") {
+			setTimeout(() => this.watchItems(), 100);
+			setTimeout(() => this.watchItems(), 500);
+			setTimeout(() => this.watchItems(), 1e3);
+		}
+		this.onChange?.();
+	}
+	watch(options) {
+		if (this.observer) return;
+		this.observer = new IntersectionObserver(this.callback.bind(this), options);
+		this.watchItems();
+	}
+	watchItems() {
+		if (!this.observer) return;
+		for (const item of this.items) {
+			const element = document.getElementById(item.id);
+			if (!element) continue;
+			this.observer.observe(element);
+		}
+	}
+	unwatch() {
+		this.observer?.disconnect();
+		this.observer = null;
+	}
+};
+
+//#endregion
+//#region src/client/components/primitives/on-this-page.tsx
+const ItemsContext = createContext(null);
+const ScrollContext = createContext(null);
+function useItems() {
+	const ctx = use(ItemsContext);
+	if (!ctx) throw new Error(`Component must be used under the <AnchorProvider /> component.`);
+	return ctx;
+}
+function useActiveAnchor() {
+	const items = useItems();
+	return useMemo(() => {
+		let out;
+		for (const item of items) {
+			if (!item.active) continue;
+			if (!out || item.t > out.t) out = item;
+		}
+		return out?.id;
+	}, [items]);
+}
+function useActiveAnchors() {
+	const items = useItems();
+	return useMemo(() => {
+		const out = [];
+		for (const item of items) if (item.active) out.push(item.id);
+		return out;
+	}, [items]);
+}
+/** Optional: add auto-scroll to TOC items. */
+function ScrollProvider({ containerRef, children }) {
+	return /* @__PURE__ */ jsx(ScrollContext.Provider, {
+		value: containerRef,
+		children
+	});
+}
+function AnchorProvider({ toc, single = false, observerOptions, children }) {
+	const observer = useMemo(() => new Observer(), []);
+	const [items, setItems] = useState(observer.items);
+	observer.single = single;
+	useEffect(() => {
+		observer.setItems(toc);
+	}, [observer, toc]);
+	useEffect(() => {
+		const defaultOptions = {
+			rootMargin: "-80px 0% -60% 0%",
+			threshold: 0
+		};
+		const options = observerOptions ? {
+			...defaultOptions,
+			...observerOptions
+		} : defaultOptions;
+		observer.watch(options);
+		observer.onChange = () => setItems([...observer.items]);
+		return () => {
+			observer.unwatch();
+		};
+	}, [observer]);
+	return /* @__PURE__ */ jsx(ItemsContext.Provider, {
+		value: items,
+		children
+	});
+}
+const OnThisPage = ({ children, className }) => {
+	return /* @__PURE__ */ jsx("nav", {
+		className: cn("sticky top-navbar hidden xl:flex flex-col shrink-0", "w-toc", "py-4 pl-6 pr-4", className),
+		children
+	});
+};
+const OnThisPageHeader = ({ children, className, ...props }) => {
+	return /* @__PURE__ */ jsx("div", {
+		className: cn("mb-4 text-xs font-bold text-body", className),
+		...props,
+		children
+	});
+};
+const OnThisPageContent = ({ children, className, ref, ...props }) => {
+	const internalRef = useRef(null);
+	useImperativeHandle(ref, () => internalRef.current);
+	return /* @__PURE__ */ jsx("div", {
+		ref: internalRef,
+		className: cn("relative overflow-y-auto boltdocs-otp-content pb-12", "max-h-[70%]", className),
+		style: {
+			maskImage: "linear-gradient(to bottom, black 90%, transparent 100%)",
+			WebkitMaskImage: "linear-gradient(to bottom, black 90%, transparent 100%)"
+		},
+		...props,
+		children
+	});
+};
+OnThisPageContent.displayName = "OnThisPageContent";
+const OnThisPageList = ({ children, className }) => {
+	return /* @__PURE__ */ jsx("ul", {
+		className: cn("relative space-y-0.5 text-sm border-l border-subtle", className),
+		children
+	});
+};
+const OnThisPageItem = ({ level, children, className }) => {
+	return /* @__PURE__ */ jsx("li", {
+		className: cn(level === 3 && "pl-3", className),
+		children
+	});
+};
+const OnThisPageLink = ({ children, href, active, onClick, className }) => {
+	const items = use(ItemsContext);
+	const containerRef = use(ScrollContext);
+	const id = href ? getItemId(href) : null;
+	const anchorRef = useRef(null);
+	const computedActive = active !== void 0 ? active : id && items ? !!items.find((i) => i.id === id)?.active : false;
+	useEffect(() => {
+		if (computedActive && anchorRef.current && containerRef?.current) scrollIntoView(anchorRef.current, {
+			behavior: "smooth",
+			block: "center",
+			inline: "center",
+			scrollMode: "if-needed",
+			boundary: containerRef.current
+		});
+	}, [computedActive, containerRef]);
+	const handleClick = (e) => {
+		if (onClick) onClick(e);
+		else if (href && href.startsWith("#")) {
+			e.preventDefault();
+			const elementId = href.slice(1);
+			const el = document.getElementById(elementId);
+			if (el) {
+				el.scrollIntoView({ behavior: "smooth" });
+				window.history.pushState(null, "", href);
+			}
+		}
+	};
+	return /* @__PURE__ */ jsx("a", {
+		ref: anchorRef,
+		href,
+		onClick: handleClick,
+		"data-active": computedActive,
+		className: cn("block py-0.5 pl-4 text-[13px] outline-none transition-colors", computedActive ? "text-primary-500" : "text-muted hover:text-body", className),
+		children
+	});
+};
+const OnThisPageIndicator = ({ style, className }) => {
+	const containerRef = useRef(null);
+	const [internalStyle, setInternalStyle] = useState({
+		opacity: 0,
+		...style
+	});
+	useEffect(() => {
+		const parent = containerRef.current?.parentElement;
+		if (!parent) return;
+		const activeLinks = parent.querySelectorAll("a[data-active=\"true\"]");
+		if (activeLinks.length > 0) {
+			const firstActiveLink = activeLinks[0];
+			const lastActiveLink = activeLinks[activeLinks.length - 1];
+			const firstRect = firstActiveLink.getBoundingClientRect();
+			const lastRect = lastActiveLink.getBoundingClientRect();
+			const parentRect = parent.getBoundingClientRect();
+			const offsetTop = firstRect.top - parentRect.top;
+			const height = lastRect.bottom - firstRect.top;
+			setInternalStyle({
+				transform: `translateY(${offsetTop}px)`,
+				height: `${height}px`,
+				opacity: 1,
+				...style
+			});
+		} else setInternalStyle({
+			opacity: 0,
+			...style
+		});
+	}, [useItems(), style]);
+	return /* @__PURE__ */ jsx("div", {
+		ref: containerRef,
+		className: cn("absolute -left-px w-0.5 rounded-full bg-primary-500", className),
+		style: {
+			transition: "transform 180ms cubic-bezier(0.2, 0.8, 0.2, 1), height 180ms cubic-bezier(0.2, 0.8, 0.2, 1), opacity 150ms",
+			...internalStyle
+		}
+	});
+};
+/**
+* High-level automated list of toc items
+*/
+function OnThisPageItems({ headings = [], className }) {
+	const activeIds = useActiveAnchors();
+	if (headings.length === 0) return null;
+	return /* @__PURE__ */ jsxs(OnThisPageList, {
+		className,
+		children: [/* @__PURE__ */ jsx(OnThisPageIndicator, {}), headings.map((h) => /* @__PURE__ */ jsx(OnThisPageItem, {
+			level: h.level,
+			children: /* @__PURE__ */ jsx(OnThisPageLink, {
+				href: `#${h.id}`,
+				active: activeIds.includes(h.id),
+				children: h.text
+			})
+		}, h.id))]
+	});
+}
+/**
+* High-level automated Table of Contents tree
+*/
+function OnThisPageTree({ headings = [], className }) {
+	const toc = useMemo(() => headings.map((h) => ({
+		title: h.text,
+		url: `#${h.id}`,
+		depth: h.level
+	})), [headings]);
+	const scrollContainerRef = useRef(null);
+	if (headings.length === 0) return null;
+	return /* @__PURE__ */ jsx(AnchorProvider, {
+		toc,
+		single: false,
+		children: /* @__PURE__ */ jsx(ScrollProvider, {
+			containerRef: scrollContainerRef,
+			children: /* @__PURE__ */ jsx(OnThisPageContent, {
+				ref: scrollContainerRef,
+				children: /* @__PURE__ */ jsx(OnThisPageItems, {
+					headings,
+					className
+				})
+			})
+		})
+	});
+}
+OnThisPage.Root = OnThisPage;
+OnThisPage.Header = OnThisPageHeader;
+OnThisPage.Content = OnThisPageContent;
+OnThisPage.List = OnThisPageList;
+OnThisPage.Item = OnThisPageItem;
+OnThisPage.Link = OnThisPageLink;
+OnThisPage.Indicator = OnThisPageIndicator;
+OnThisPage.Items = OnThisPageItems;
+OnThisPage.Tree = OnThisPageTree;
+
+//#endregion
+//#region src/client/components/primitives/page-nav.tsx
+const PageNav = ({ children, className }) => {
+	return /* @__PURE__ */ jsx("nav", {
+		className: cn("grid sm:grid-cols-2 gap-4", className),
+		children
+	});
+};
+const PageNavLink = ({ children, to, direction, className }) => {
+	const isNext = direction === "next";
+	return /* @__PURE__ */ jsxs(Link, {
+		href: to,
+		className: cn("flex items-center outline-none no-underline", isNext ? "justify-end" : "justify-start", className),
+		children: [
+			!isNext && /* @__PURE__ */ jsx(ChevronLeft, { className: "shrink-0" }),
+			/* @__PURE__ */ jsx("div", {
+				className: "flex flex-col flex-1",
+				children
+			}),
+			isNext && /* @__PURE__ */ jsx(ChevronRight, { className: "shrink-0" })
+		]
+	});
+};
+const PageNavTitle = ({ children, className }) => {
+	return /* @__PURE__ */ jsx("span", {
+		className: cn(className),
+		children
+	});
+};
+const PageNavDescription = ({ children, className }) => {
+	return /* @__PURE__ */ jsx("span", {
+		className: cn("truncate", className),
+		children
+	});
+};
+const PageNavIcon = ({ children }) => {
+	return /* @__PURE__ */ jsx(Fragment, { children });
+};
+PageNav.Root = PageNav;
+PageNav.Link = PageNavLink;
+PageNav.Title = PageNavTitle;
+PageNav.Description = PageNavDescription;
+PageNav.Icon = PageNavIcon;
+
+//#endregion
+//#region src/client/hooks/use-sidebar.ts
+function useSidebar(routes) {
+	const config = useConfig();
+	const currentPath = normalizePath(useLocation().pathname);
+	return useMemo(() => {
+		const activeRoute = routes.find((r) => normalizePath(r.path) === currentPath);
+		const activeTabId = activeRoute?.tab?.toLowerCase();
+		const filteredRoutes = activeTabId ? routes.filter((r) => !r.tab || r.tab.toLowerCase() === activeTabId) : routes;
+		const directoryMeta = {};
+		if (config.directoryMeta) for (const [key, value] of Object.entries(config.directoryMeta)) {
+			const cleanKey = key.split("/").filter((part) => !part.startsWith("(") || !part.endsWith(")")).map((part) => part.replace(/^\d+-/, "")).join("/");
+			directoryMeta[cleanKey === "" ? "." : cleanKey] = value;
+		}
+		const capitalize = (str) => str.charAt(0).toUpperCase() + str.slice(1).replace(/-/g, " ");
+		const rootNodesMap = /* @__PURE__ */ new Map();
+		const ungrouped = [];
+		const getOrCreateNode = (parts, rootStore) => {
+			let currentMap = rootStore;
+			let parentPath = "";
+			let lastNode = null;
+			for (let i = 0; i < parts.length; i++) {
+				const segment = parts[i];
+				const currentRelPath = parentPath ? `${parentPath}/${segment}` : segment;
+				if (!currentMap.has(segment)) {
+					const meta = directoryMeta[currentRelPath] || {};
+					const newNode = {
+						path: "#",
+						title: meta.title || capitalize(segment),
+						componentPath: "",
+						filePath: "",
+						icon: meta.icon,
+						groupPosition: typeof meta.order === "number" ? meta.order : 999,
+						subRoutes: []
+					};
+					currentMap.set(segment, newNode);
+				}
+				lastNode = currentMap.get(segment);
+				if (!lastNode._subMap) lastNode._subMap = /* @__PURE__ */ new Map();
+				currentMap = lastNode._subMap;
+				parentPath = currentRelPath;
+			}
+			return lastNode;
+		};
+		const sortedRoutes = [...filteredRoutes].sort((a, b) => {
+			return (a.sidebarPosition ?? a.order ?? 999) - (b.sidebarPosition ?? b.order ?? 999);
+		});
+		for (const route of sortedRoutes) {
+			if (route.sidebarHidden) continue;
+			const parts = route.slugParts || [];
+			const fileName = route.filePath.split("/").pop() || "";
+			const isIndex = /^index\.mdx?$/.test(fileName);
+			if (parts.length === 0) {
+				if (route.filePath) ungrouped.push(route);
+				continue;
+			}
+			if (isIndex) {
+				const containerNode = getOrCreateNode(parts, rootNodesMap);
+				if (containerNode) {
+					containerNode.path = route.path;
+					containerNode.title = route.title || containerNode.title;
+					containerNode.icon = route.icon || containerNode.icon;
+					containerNode.badge = route.badge;
+					containerNode.sidebarPosition = route.sidebarPosition;
+					containerNode.frontmatter = route.frontmatter;
+				}
+			} else {
+				const parentNode = getOrCreateNode(parts, rootNodesMap);
+				if (parentNode) parentNode.subRoutes.push(route);
+			}
+		}
+		const finalizeTree = (nodes, currentPathPrefix = "") => {
+			nodes.forEach((node) => {
+				if (node._subMap) {
+					const childDirs = Array.from(node._subMap.values());
+					node.subRoutes = [...node.subRoutes || [], ...childDirs];
+					delete node._subMap;
+				}
+				if (node.subRoutes && node.subRoutes.length > 0) node.subRoutes = finalizeTree(node.subRoutes);
+			});
+			return nodes.sort((a, b) => {
+				const posA = a.sidebarPosition ?? a.groupPosition ?? 999;
+				const posB = b.sidebarPosition ?? b.groupPosition ?? 999;
+				if (posA !== posB) return posA - posB;
+				return a.title.localeCompare(b.title);
+			});
+		};
+		const finalizedTopNodes = finalizeTree(Array.from(rootNodesMap.values()));
+		finalizedTopNodes.map((node) => {
+			return {
+				slug: node.title.toLowerCase().replace(/\s+/g, "-"),
+				title: node.title,
+				icon: node.icon,
+				routes: [node]
+			};
+		});
+		return {
+			groups: finalizedTopNodes.map((node) => {
+				if (node.subRoutes && node.subRoutes.length > 0) return {
+					slug: node.title.toLowerCase().replace(/\s+/g, "-"),
+					title: node.title,
+					icon: node.icon,
+					routes: node.subRoutes
+				};
+				ungrouped.push(node);
+				return null;
+			}).filter(Boolean),
+			ungrouped: finalizeTree(ungrouped),
+			activeRoute,
+			activePath: currentPath,
+			config
+		};
+	}, [
+		routes,
+		config,
+		currentPath
+	]);
+}
+
+//#endregion
+//#region src/client/components/primitives/sidebar.tsx
+let sidebarScrollPos = 0;
+function getIcon(iconName) {
+	if (!iconName) return void 0;
+	const icons = {
+		...icons_exports,
+		...virtualIcons
+	};
+	return icons[iconName] || icons[iconName + "Icon"] || void 0;
+}
+/**
+* Internal Badge component for links
+*/
+const Badge = ({ badge }) => {
+	const colors = {
+		new: "bg-primary-500/10 text-primary-500 border border-primary-500/20",
+		updated: "bg-emerald-500/10 text-emerald-500 border border-emerald-500/20",
+		deprecated: "bg-danger-500/10 text-danger-500 border border-danger-500/20"
+	};
+	const text = typeof badge === "string" ? badge : badge?.text;
+	if (!text) return null;
+	return /* @__PURE__ */ jsx("span", {
+		className: cn("ml-auto flex h-5 items-center rounded-md text-[10px] font-bold px-1.5 py-0.5 uppercase tracking-wider", colors[text] || colors.new),
+		children: text
+	});
+};
+/**
+* Desktop Sidebar Container
+*/
+function SidebarRoot({ children, className }) {
+	return /* @__PURE__ */ jsx("aside", {
+		className: cn("hidden lg:flex flex-col w-sidebar sticky top-navbar h-[calc(100vh-var(--spacing-navbar))] border-r border-subtle bg-main", className),
+		children
+	});
+}
+/**
+* Mobile Sidebar Modal
+*/
+function SidebarMobile({ children, className }) {
+	const { isSidebarOpen, closeSidebar } = useUI();
+	return /* @__PURE__ */ jsx(RAC.ModalOverlay, {
+		isOpen: isSidebarOpen,
+		onOpenChange: (open) => !open && closeSidebar(),
+		isDismissable: true,
+		className: cn("fixed inset-0 z-50 bg-black/20 backdrop-blur-sm lg:hidden", "entering:animate-in entering:fade-in exiting:animate-out exiting:fade-out duration-300"),
+		children: /* @__PURE__ */ jsx(RAC.Modal, {
+			className: cn("fixed top-0 left-0 bottom-0 w-80 bg-main border-r border-subtle shadow-2xl outline-none", "entering:animate-in entering:slide-in-from-left exiting:animate-out exiting:slide-out-to-left duration-300", className),
+			children: /* @__PURE__ */ jsx(RAC.Dialog, {
+				className: "h-full focus:outline-none outline-none flex flex-col",
+				children
+			})
+		})
+	});
+}
+/**
+* Shared Header for Sidebar
+*/
+function SidebarHeader({ children, className }) {
+	return /* @__PURE__ */ jsx("div", {
+		className: cn("flex items-center justify-between p-4 border-b border-subtle", className),
+		children
+	});
+}
+/**
+* Scrollable Content Wrapper
+*/
+function SidebarContent({ children, className }) {
+	const scrollRef = useRef(null);
+	useLayoutEffect(() => {
+		if (scrollRef.current) scrollRef.current.scrollTop = sidebarScrollPos;
+	}, []);
+	useEffect(() => {
+		const el = scrollRef.current;
+		if (!el) return;
+		const handleScroll = () => {
+			sidebarScrollPos = el.scrollTop;
+		};
+		el.addEventListener("scroll", handleScroll, { passive: true });
+		return () => el.removeEventListener("scroll", handleScroll);
+	}, []);
+	return /* @__PURE__ */ jsx("div", {
+		ref: scrollRef,
+		className: cn("flex-1 overflow-y-auto p-4 pb-16 custom-scrollbar", className),
+		children: /* @__PURE__ */ jsx("nav", {
+			className: "flex flex-col gap-6",
+			children
+		})
+	});
+}
+/**
+* Navigation Group
+*/
+const SidebarGroup = ({ title, icon: Icon, children, className }) => {
+	return /* @__PURE__ */ jsxs("div", {
+		className,
+		children: [title && /* @__PURE__ */ jsxs("h4", {
+			className: "px-2 mb-2 flex items-center gap-2 text-[11px] font-bold uppercase tracking-widest text-muted/50",
+			children: [Icon && /* @__PURE__ */ jsx(Icon, { size: 12 }), title]
+		}), /* @__PURE__ */ jsx("div", {
+			className: "flex flex-col gap-0.5",
+			children
+		})]
+	});
+};
+const SidebarLink = ({ label, href, active, icon: Icon, badge, className }) => {
+	return /* @__PURE__ */ jsxs(Link, {
+		href,
+		className: cn("group flex items-center gap-2.5 rounded-lg px-2.5 py-1.5 text-sm transition-all outline-none", active ? "bg-primary-500/10 text-primary-500 font-medium shadow-sm" : "text-muted hover:bg-surface hover:text-body", className),
+		children: [
+			Icon && /* @__PURE__ */ jsx(Icon, {
+				size: 16,
+				className: cn(active ? "text-primary-500" : "text-muted group-hover:text-body")
+			}),
+			/* @__PURE__ */ jsx("span", {
+				className: "truncate",
+				children: label
+			}),
+			badge && /* @__PURE__ */ jsx(Badge, { badge })
+		]
+	});
+};
+/**
+* Nested SubGroup
+*/
+const SidebarSubGroup = ({ label, href, active, icon: Icon, badge, isOpen, onToggle, children, className }) => {
+	return /* @__PURE__ */ jsxs("div", {
+		className: "flex flex-col gap-0.5",
+		children: [/* @__PURE__ */ jsxs("div", {
+			className: "group relative flex items-center",
+			children: [/* @__PURE__ */ jsx(SidebarLink, {
+				label,
+				href,
+				active,
+				icon: Icon,
+				badge,
+				className: cn("flex-1 pr-8", className)
+			}), /* @__PURE__ */ jsx("button", {
+				onClick: (e) => {
+					e.preventDefault();
+					e.stopPropagation();
+					onToggle();
+				},
+				className: "absolute right-1 p-1.5 text-muted hover:text-body transition-colors outline-none cursor-pointer",
+				children: /* @__PURE__ */ jsx(ChevronRight, {
+					size: 14,
+					className: cn("transition-transform duration-200", isOpen && "rotate-90")
+				})
+			})]
+		}), isOpen && /* @__PURE__ */ jsx("div", {
+			className: "ml-4 pl-3 border-l border-subtle/50 mt-0.5 flex flex-col gap-0.5",
+			children
+		})]
+	});
+};
+function SidebarItem({ route, activePath, activeRoute, className }) {
+	const localizedHref = useLocalizedTo(route.path);
+	const isCurrent = activePath === (localizedHref.endsWith("/") ? localizedHref.slice(0, -1) : localizedHref) || !!activeRoute?.filePath && !!route.filePath && activeRoute.filePath === route.filePath;
+	const hasChildren = !!route.routes?.length || !!route.subRoutes?.length;
+	const children = route.routes || route.subRoutes;
+	const [isOpen, setIsOpen] = useState(() => activePath.startsWith(localizedHref) || !!activeRoute?.filePath && !!route.filePath && activeRoute.filePath === route.filePath);
+	const [prevActivePath, setPrevActivePath] = useState(activePath);
+	if (activePath !== prevActivePath) {
+		setPrevActivePath(activePath);
+		if (activePath.startsWith(localizedHref) || !!activeRoute?.filePath && !!route.filePath && activeRoute.filePath === route.filePath) setIsOpen(true);
+	}
+	if (hasChildren) return /* @__PURE__ */ jsx(SidebarSubGroup, {
+		label: route.title,
+		href: route.path,
+		active: isCurrent,
+		icon: getIcon(route.icon),
+		badge: route.badge,
+		isOpen,
+		onToggle: () => setIsOpen(!isOpen),
+		className,
+		children: children?.map((subRoute) => /* @__PURE__ */ jsx(SidebarItem, {
+			route: subRoute,
+			activePath,
+			activeRoute
+		}, subRoute.path))
+	});
+	return /* @__PURE__ */ jsx(SidebarLink, {
+		label: route.title,
+		href: route.path,
+		active: isCurrent,
+		icon: getIcon(route.icon),
+		badge: route.badge,
+		className
+	});
+}
+function SidebarItems({ routes, className }) {
+	const { groups, ungrouped, activePath, activeRoute } = useSidebar(routes);
+	return /* @__PURE__ */ jsxs("div", {
+		className: cn("flex flex-col gap-6", className),
+		children: [ungrouped.length > 0 && /* @__PURE__ */ jsx(SidebarGroup, { children: ungrouped.map((route) => /* @__PURE__ */ jsx(SidebarItem, {
+			route,
+			activePath,
+			activeRoute
+		}, route.path)) }), groups.map((group) => /* @__PURE__ */ jsx(SidebarGroup, {
+			title: group.title,
+			icon: getIcon(group.icon),
+			children: group.routes.map((route) => /* @__PURE__ */ jsx(SidebarItem, {
+				route,
+				activePath,
+				activeRoute
+			}, route.path))
+		}, group.title))]
+	});
+}
+/**
+* Main Sidebar Export
+*/
+const Sidebar = Object.assign(SidebarRoot, {
+	Root: SidebarRoot,
+	Mobile: SidebarMobile,
+	Header: SidebarHeader,
+	Content: SidebarContent,
+	Group: SidebarGroup,
+	Link: SidebarLink,
+	SubGroup: SidebarSubGroup,
+	Item: SidebarItem,
+	Items: SidebarItems
+});
+
+//#endregion
+//#region src/client/hooks/use-location.ts
+const useLocation$1 = () => {
+	return useLocation();
+};
+
+//#endregion
+//#region src/client/hooks/use-search-highlight.ts
+/**
+* Hook to highlight search terms based on the 'hl' query parameter.
+*/
+function useSearchHighlight(containerSelector = ".boltdocs-page") {
+	const { search } = useLocation$1();
+	const query = new URLSearchParams(search).get("hl");
+	useEffect(() => {
+		if (!query) {
+			clearHighlights(containerSelector);
+			return;
+		}
+		const container = document.querySelector(containerSelector);
+		if (!container) return;
+		let rafId;
+		const observer = new MutationObserver((mutations) => {
+			if (mutations.some((m) => {
+				const addedNodes = Array.from(m.addedNodes);
+				const removedNodes = Array.from(m.removedNodes);
+				return addedNodes.some((n) => !(n instanceof HTMLElement && n.hasAttribute("data-search-highlight"))) || removedNodes.some((n) => !(n instanceof HTMLElement && n.hasAttribute("data-search-highlight")));
+			})) run();
+		});
+		function run() {
+			cancelAnimationFrame(rafId);
+			rafId = requestAnimationFrame(() => {
+				observer.disconnect();
+				clearHighlights(containerSelector);
+				const terms = query.split(/\s+/).map((t) => t.trim()).filter((t) => t.length >= 2);
+				if (terms.length > 0) highlightTerms(container, terms);
+				observer.observe(container, {
+					childList: true,
+					subtree: true
+				});
+			});
+		}
+		run();
+		return () => {
+			cancelAnimationFrame(rafId);
+			observer.disconnect();
+			clearHighlights(containerSelector);
+		};
+	}, [
+		query,
+		search,
+		containerSelector
+	]);
+}
+function clearHighlights(selector) {
+	document.querySelectorAll(`${selector} mark[data-search-highlight]`).forEach((mark) => {
+		try {
+			const parent = mark.parentNode;
+			if (parent && parent.contains(mark)) {
+				const text = mark.textContent || "";
+				parent.replaceChild(document.createTextNode(text), mark);
+			}
+		} catch (e) {}
+	});
+}
+function highlightTerms(container, terms) {
+	const walker = document.createTreeWalker(container, NodeFilter.SHOW_TEXT, { acceptNode: (node) => {
+		const parent = node.parentElement;
+		if (parent && (parent.tagName === "SCRIPT" || parent.tagName === "STYLE" || parent.tagName === "MARK" || parent.closest("pre") || parent.closest("code"))) return NodeFilter.FILTER_REJECT;
+		return NodeFilter.FILTER_ACCEPT;
+	} });
+	const nodes = [];
+	let node;
+	while (node = walker.nextNode()) nodes.push(node);
+	const accentMap = {
+		a: "[aáàäâã]",
+		e: "[eéèëê]",
+		i: "[iíìïî]",
+		o: "[oóòöôõ]",
+		u: "[uúùüû]",
+		n: "[nñ]",
+		c: "[cç]"
+	};
+	const prepareRegex = (term) => {
+		let pattern = term.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+		pattern = pattern.split("").map((char) => {
+			return accentMap[char.toLowerCase()] || char;
+		}).join("");
+		return pattern;
+	};
+	const combinedPattern = terms.map(prepareRegex).join("|");
+	const regex = new RegExp(`(${combinedPattern})`, "gi");
+	const matchRegexes = terms.map((term) => {
+		const p = prepareRegex(term);
+		return new RegExp(`^${p}$`, "i");
+	});
+	nodes.forEach((textNode) => {
+		const text = textNode.textContent;
+		if (text && regex.test(text)) {
+			const fragment = document.createDocumentFragment();
+			text.split(regex).forEach((part) => {
+				if (matchRegexes.some((rx) => rx.test(part))) {
+					const mark = document.createElement("mark");
+					mark.textContent = part;
+					mark.setAttribute("data-search-highlight", "true");
+					fragment.appendChild(mark);
+				} else if (part) fragment.appendChild(document.createTextNode(part));
+			});
+			if (textNode.parentNode) textNode.parentNode.replaceChild(fragment, textNode);
+		}
+	});
+}
+
+//#endregion
+//#region src/client/components/ui-base/search-highlight.tsx
+/**
+* Component that enables search term highlighting on the page.
+* It doesn't render anything visible.
+*/
+function SearchHighlight() {
+	useSearchHighlight(".boltdocs-page");
+	return null;
+}
+
+//#endregion
+//#region src/client/components/primitives/docs-layout.tsx
+/**
+* Root layout shell. Renders a full-height flex column.
+*
+* Usage:
+* ```tsx
+* <DocsLayout>
+*   <Navbar />
+*   <DocsLayout.Body>...</DocsLayout.Body>
+* </DocsLayout>
+* ```
+*/
+function DocsLayoutRoot({ children, className, style }) {
+	return /* @__PURE__ */ jsx("div", {
+		className: cn("h-screen flex flex-col overflow-hidden bg-main text-body", className),
+		style,
+		children
+	});
+}
+/**
+* Horizontal flex container for sidebar + content + toc.
+*/
+function Body({ children, className, style }) {
+	return /* @__PURE__ */ jsx("div", {
+		className: cn("mx-auto flex flex-1 w-full max-w-(--breakpoint-3xl) bg-main overflow-hidden", className),
+		style,
+		children
+	});
+}
+/**
+* Main scrollable content area.
+*/
+function Content({ children, className, style }) {
+	return /* @__PURE__ */ jsx("main", {
+		className: cn("boltdocs-content flex-1 min-w-0 overflow-y-auto", "contain-layout", className),
+		style,
+		children
+	});
+}
+/**
+* MDX Content wrapper with standard page padding and max-width logic.
+*/
+function ContentMdx({ children, className, style }) {
+	return /* @__PURE__ */ jsxs("div", {
+		className: cn("boltdocs-page mx-auto pt-4 pb-20 px-4 sm:px-8", className),
+		style,
+		children: [/* @__PURE__ */ jsx(SearchHighlight, {}), children]
+	});
+}
+/**
+* Content header area (breadcrumbs, title, description, etc).
+*/
+function Header({ children, className, style }) {
+	return /* @__PURE__ */ jsx("header", {
+		className: cn("mb-10", className),
+		style,
+		children
+	});
+}
+/**
+* Footer area inside the content section (page nav).
+*/
+function Footer({ children, className, style }) {
+	return /* @__PURE__ */ jsx("div", {
+		className: cn("mt-20", className),
+		style,
+		children
+	});
+}
+const DocsLayout = Object.assign(DocsLayoutRoot, {
+	Body,
+	Content,
+	ContentMdx,
+	Header,
+	Footer
+});
+
+//#endregion
+export { Popover$1 as A, useItems as C, ErrorBoundary as D, Tabs as E, Button$1 as M, Breadcrumbs$1 as N, ErrorBoundaryFallback as O, useActiveAnchors as S, useUI as T, OnThisPage as _, SidebarContent as a, ScrollProvider as b, SidebarItem as c, SidebarMobile as d, SidebarRoot as f, AnchorProvider as g, PageNav as h, Sidebar as i, ButtonGroup as j, Menu as k, SidebarItems as l, useSidebar as m, useSearchHighlight as n, SidebarGroup as o, SidebarSubGroup as p, useLocation$1 as r, SidebarHeader as s, DocsLayout as t, SidebarLink as u, OnThisPageItems as v, UIProvider as w, useActiveAnchor as x, OnThisPageTree as y };