boltdocs 2.7.10 → 2.8.0

package/dist/docs-layout-Dn6S5g59.js

@@ -0,0 +1,1167 @@
+/**
+ * Boltdocs - https://boltdocs.vercel.app
+ * Copyright (c) 2026 Jesus Alcala
+ * Licensed under the MIT License.
+ */
+import { A as ChevronRight, D as Check, Q as icons_exports, S as normalizePath, _ as Link$1, b as useLocalizedTo, et as useConfig, k as ChevronLeft, y as cn } from "./icons-dev-Oju24Wjp.js";
+import { Children, createContext, use, useContext, useEffect, useImperativeHandle, useLayoutEffect, useMemo, useRef, useState } from "react";
+import { useLocation } from "react-router-dom";
+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/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/breadcrumbs.tsx
+function Breadcrumbs$1({ children, className, ...props }) {
+	return /* @__PURE__ */ jsx(Breadcrumbs, {
+		className: cn("flex flex-wrap items-center", className),
+		...props,
+		children
+	});
+}
+function BreadcrumbsItem({ children, className, ...props }) {
+	return /* @__PURE__ */ jsx(Breadcrumb, {
+		className: cn("flex items-center", className),
+		...props,
+		children
+	});
+}
+function BreadcrumbsLink({ children, href, className, ...props }) {
+	return /* @__PURE__ */ jsx(Link$1, {
+		href,
+		className: cn("cursor-pointer", className),
+		...props,
+		children
+	});
+}
+function 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-group.tsx
+function 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.
+*/
+function 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/tabs.tsx
+function Tabs({ children, className = "", ...props }) {
+	return /* @__PURE__ */ jsx("div", {
+		className: cn("w-full", className),
+		...props,
+		children
+	});
+}
+function TabsList({ children, className = "" }) {
+	return /* @__PURE__ */ jsx("div", {
+		role: "tablist",
+		className: cn("relative flex flex-row items-center overflow-x-auto", className),
+		children
+	});
+}
+function 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
+	});
+}
+function TabsContent({ children, className = "" }) {
+	return /* @__PURE__ */ jsx("div", {
+		className: cn("outline-none", className),
+		children
+	});
+}
+function 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/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;
+	timers = [];
+	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") {
+			this.timers.push(setTimeout(() => this.watchItems(), 100));
+			this.timers.push(setTimeout(() => this.watchItems(), 500));
+			this.timers.push(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() {
+		for (const timer of this.timers) clearTimeout(timer);
+		this.timers = [];
+		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
+	});
+}
+function 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
+	});
+}
+function OnThisPageHeader({ children, className, ...props }) {
+	return /* @__PURE__ */ jsx("div", {
+		className: cn("mb-4 text-xs font-bold text-body", className),
+		...props,
+		children
+	});
+}
+function 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";
+function OnThisPageList({ children, className }) {
+	return /* @__PURE__ */ jsx("ul", {
+		className: cn("relative space-y-0.5 text-sm border-l border-subtle", className),
+		children
+	});
+}
+function OnThisPageItem({ level, children, className }) {
+	return /* @__PURE__ */ jsx("li", {
+		className: cn(level === 3 && "pl-3", className),
+		children
+	});
+}
+function 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
+	});
+}
+function 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
+function PageNav({ children, className }) {
+	return /* @__PURE__ */ jsx("nav", {
+		className: cn("grid sm:grid-cols-2 gap-4", className),
+		children
+	});
+}
+function PageNavLink({ children, to, direction, className }) {
+	const isNext = direction === "next";
+	return /* @__PURE__ */ jsxs(Link$1, {
+		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" })
+		]
+	});
+}
+function PageNavTitle({ children, className }) {
+	return /* @__PURE__ */ jsx("span", {
+		className: cn(className),
+		children
+	});
+}
+function PageNavDescription({ children, className }) {
+	return /* @__PURE__ */ jsx("span", {
+		className: cn("truncate", className),
+		children
+	});
+}
+function 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 noCollection = routes.filter((r) => !r.collection);
+		const filteredRoutes = activeTabId ? noCollection.filter((r) => !r.tab || r.tab.toLowerCase() === activeTabId) : noCollection;
+		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
+*/
+function 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
+*/
+function 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
+		})]
+	});
+}
+function SidebarLink({ label, href, active, icon: Icon, badge, className }) {
+	return /* @__PURE__ */ jsxs(Link$1, {
+		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
+*/
+function 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 { useUI as A, useItems as C, ButtonGroup as D, Popover$1 as E, Breadcrumbs$1 as O, useActiveAnchors as S, Menu 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, UIProvider 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, Tabs as w, useActiveAnchor as x, OnThisPageTree as y };