boltdocs 3.0.2 → 3.2.1

package/dist/client/index.cjs

@@ -4,26 +4,26 @@
  * Licensed under the MIT License.
  */
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_icons_dev = require('../icons-dev-BryEFkJu.cjs');
-const require_image = require('../image-CR6UlaI5.cjs');
-const require_mdx = require('../mdx-DJBg5DuL.cjs');
-const require_docs_layout = require('../docs-layout-3TpAt6MB.cjs');
-const require_search_dialog = require('../search-dialog-D4rplZMv.cjs');
-const require_search_dialog$1 = require('../search-dialog-Cx7aGW3U.cjs');
+const require_link = require('../link-D1Gjkb-2.cjs');
+const require_image = require('../image-C4TlpMHn.cjs');
+const require_mdx = require('../mdx-CD-tSjRG.cjs');
+const require_docs_layout = require('../docs-layout-CFWI15Id.cjs');
+const require_search_dialog = require('../search-dialog-B1NERUNx.cjs');
+const require_search_dialog$1 = require('../search-dialog-BRFno7HD.cjs');
 let react = require("react");
 let react_router_dom = require("react-router-dom");
 let react_jsx_runtime = require("react/jsx-runtime");
-let react_helmet_async = require("react-helmet-async");
-react_helmet_async = require_icons_dev.__toESM(react_helmet_async);
 let react_aria_components = require("react-aria-components");
+let react_helmet_async = require("react-helmet-async");
+react_helmet_async = require_link.__toESM(react_helmet_async);
 let virtual_boltdocs_mdx_components = require("virtual:boltdocs-mdx-components");
-virtual_boltdocs_mdx_components = require_icons_dev.__toESM(virtual_boltdocs_mdx_components);
+virtual_boltdocs_mdx_components = require_link.__toESM(virtual_boltdocs_mdx_components);
 let virtual_boltdocs_icons = require("virtual:boltdocs-icons");
-virtual_boltdocs_icons = require_icons_dev.__toESM(virtual_boltdocs_icons);
+virtual_boltdocs_icons = require_link.__toESM(virtual_boltdocs_icons);
 let isomorphic_dompurify = require("isomorphic-dompurify");
-isomorphic_dompurify = require_icons_dev.__toESM(isomorphic_dompurify);
+isomorphic_dompurify = require_link.__toESM(isomorphic_dompurify);
 let virtual_boltdocs_layout = require("virtual:boltdocs-layout");
-virtual_boltdocs_layout = require_icons_dev.__toESM(virtual_boltdocs_layout);
+virtual_boltdocs_layout = require_link.__toESM(virtual_boltdocs_layout);
 let _bdocs_ssg = require("@bdocs/ssg");
 
 //#region src/client/app/mdx-components-context.tsx
@@ -55,20 +55,6 @@ function MdxComponentsProvider({ components, children }) {
 	});
 }
 
-//#endregion
-//#region src/client/app/helmet-compat.tsx
-const mod = react_helmet_async;
-/**
-* The `<Helmet>` component, resolved across CJS/ESM module shapes.
-* Falls back to a transparent fragment wrapper if the module cannot be resolved.
-*/
-const Helmet = mod.Helmet || mod.default?.Helmet || (({ children }) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)(react_jsx_runtime.Fragment, { children }));
-/**
-* The `<HelmetProvider>` component, resolved across CJS/ESM module shapes.
-* Falls back to a transparent fragment wrapper if the module cannot be resolved.
-*/
-const HelmetProvider = mod.HelmetProvider || mod.default?.HelmetProvider || (({ children }) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)(react_jsx_runtime.Fragment, { children }));
-
 //#endregion
 //#region src/client/app/scroll-handler.tsx
 /**
@@ -79,7 +65,7 @@ const HelmetProvider = mod.HelmetProvider || mod.default?.HelmetProvider || (({
 function ScrollHandler() {
 	const { pathname, hash } = (0, react_router_dom.useLocation)();
 	const handleScroll = (behavior = "auto") => {
-		const container = document.querySelector(".boltdocs-content") || window;
+		const container = document.querySelector(".boltdocs-content") || document.querySelector(".boltdocs-external-content") || document.querySelector(".boltdocs-shell-content") || window;
 		const getScrollTop = () => {
 			if (container === window) return window.scrollY;
 			return container.scrollTop;
@@ -112,11 +98,6 @@ function ScrollHandler() {
 	}, [pathname, hash]);
 	(0, react.useEffect)(() => {
 		handleScroll("auto");
-		const rafId = requestAnimationFrame(() => {
-			handleScroll("auto");
-			window.dispatchEvent(new Event("resize"));
-		});
-		return () => cancelAnimationFrame(rafId);
 	}, [pathname, hash]);
 	return null;
 }
@@ -143,10 +124,10 @@ function NotFound() {
 						children: "The page you're looking for doesn't exist or has been moved."
 					})]
 				}),
-				/* @__PURE__ */ (0, react_jsx_runtime.jsxs)(require_icons_dev.Link, {
+				/* @__PURE__ */ (0, react_jsx_runtime.jsxs)(require_link.Link, {
 					href: "/",
 					className: "inline-flex items-center gap-2 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 outline-none select-none",
-					children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_icons_dev.ArrowLeft, { size: 14 }), " Go to Home"]
+					children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_link.ArrowLeft, { size: 14 }), " Go to Home"]
 				})
 			]
 		})
@@ -161,6 +142,28 @@ const mdxComponentsDefault = {
 	"404": NotFound
 };
 
+//#endregion
+//#region src/client/app/helmet-compat.tsx
+const mod = react_helmet_async;
+/**
+* The `<Helmet>` component, resolved across CJS/ESM module shapes.
+* Falls back to a transparent fragment wrapper if the module cannot be resolved.
+*/
+const Helmet = mod.Helmet || mod.default?.Helmet || (({ children }) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)(react_jsx_runtime.Fragment, { children }));
+/**
+* The `<HelmetProvider>` component, resolved across CJS/ESM module shapes.
+* Falls back to a transparent fragment wrapper if the module cannot be resolved.
+*/
+const HelmetProvider = mod.HelmetProvider || mod.default?.HelmetProvider || (({ children }) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)(react_jsx_runtime.Fragment, { children }));
+if (typeof globalThis !== "undefined" && globalThis.__BOLTDOCS_SSG_RENDERING__) {
+	const hp = HelmetProvider;
+	if (hp && typeof hp === "function" && hp.canUseDOM) hp.canUseDOM = false;
+}
+if (typeof globalThis !== "undefined") {
+	globalThis.__BOLTDOCS_HELMET_PROVIDER__ = HelmetProvider;
+	globalThis.__BOLTDOCS_HELMET__ = Helmet;
+}
+
 //#endregion
 //#region src/client/utils/i18n.ts
 /**
@@ -182,8 +185,8 @@ function getTranslated(value, locale) {
 //#region src/client/app/head.tsx
 function Head({ siteTitle, siteDescription, routes }) {
 	const location = (0, react_router_dom.useLocation)();
-	const config = require_icons_dev.useConfig();
-	const { currentLocale, currentRoute } = require_icons_dev.useRoutes();
+	const config = require_link.useConfig();
+	const { currentLocale, currentRoute } = require_link.useRoutes();
 	const route = (0, react.useMemo)(() => {
 		if (currentRoute) return currentRoute;
 		const normalizedPath = location.pathname.endsWith("/") && location.pathname.length > 1 ? location.pathname.slice(0, -1) : location.pathname;
@@ -278,12 +281,14 @@ function Head({ siteTitle, siteDescription, routes }) {
 			content: config.seo.verification.facebook
 		}),
 		Object.entries(globalMetatags).map(([key, value]) => {
-			return key.startsWith("og:") || key.startsWith("music:") || key.startsWith("video:") || key.startsWith("article:") || key.startsWith("book:") || key.startsWith("profile:") ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("meta", {
+			const isProperty = key.startsWith("og:") || key.startsWith("music:") || key.startsWith("video:") || key.startsWith("article:") || key.startsWith("book:") || key.startsWith("profile:");
+			const strVal = String(value ?? "");
+			return isProperty ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("meta", {
 				property: key,
-				content: value
+				content: strVal
 			}, key) : /* @__PURE__ */ (0, react_jsx_runtime.jsx)("meta", {
 				name: key,
-				content: value
+				content: strVal
 			}, key);
 		}),
 		Object.entries(seo).map(([key, value]) => {
@@ -293,15 +298,17 @@ function Head({ siteTitle, siteDescription, routes }) {
 			}, "noindex");
 			if (key === "robots") return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("meta", {
 				name: "robots",
-				content: value
+				content: String(value)
 			}, "robots");
 			if (key === "canonical" || key === "og:url" || key === "og:image" || key === "twitter:image") return null;
-			return key.startsWith("og:") || key.startsWith("music:") || key.startsWith("video:") || key.startsWith("article:") || key.startsWith("book:") || key.startsWith("profile:") ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("meta", {
+			const isProperty = key.startsWith("og:") || key.startsWith("music:") || key.startsWith("video:") || key.startsWith("article:") || key.startsWith("book:") || key.startsWith("profile:");
+			const strVal = String(value ?? "");
+			return isProperty ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("meta", {
 				property: key,
-				content: value
+				content: strVal
 			}, key) : /* @__PURE__ */ (0, react_jsx_runtime.jsx)("meta", {
 				name: key,
-				content: value
+				content: strVal
 			}, key);
 		})
 	] });
@@ -313,6 +320,16 @@ const CollectionsContext = (0, react.createContext)({});
 function useCollectionsData() {
 	return (0, react.use)(CollectionsContext);
 }
+const CurrentPostContext = (0, react.createContext)(null);
+function CurrentPostProvider({ value, children }) {
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(CurrentPostContext.Provider, {
+		value,
+		children
+	});
+}
+function useCurrentPostData() {
+	return (0, react.use)(CurrentPostContext);
+}
 
 //#endregion
 //#region src/client/ssg/boltdocs-shell.tsx
@@ -320,7 +337,7 @@ function useCollectionsData() {
 * Updates the HTML lang and dir attributes based on the current locale configuration.
 */
 function I18nUpdater({ config }) {
-	const { currentLocale } = require_icons_dev.useBoltdocsContext();
+	const { currentLocale } = require_link.useBoltdocsContext();
 	(0, react.useEffect)(() => {
 		if (!config.i18n || typeof document === "undefined") return;
 		const locale = currentLocale || config.i18n.defaultLocale;
@@ -332,9 +349,9 @@ function I18nUpdater({ config }) {
 }
 function StoreSync({ config, routeMap }) {
 	const location = (0, react_router_dom.useLocation)();
-	const { setLocale, setVersion } = require_icons_dev.useBoltdocsContext();
+	const { setLocale, setVersion } = require_link.useBoltdocsContext();
 	(0, react.useEffect)(() => {
-		const currentPath = require_icons_dev.normalizePath(location.pathname);
+		const currentPath = require_link.normalizePath(location.pathname);
 		const matchedRoute = routeMap.get(currentPath);
 		if (matchedRoute) {
 			if (config.i18n) setLocale(matchedRoute.locale || config.i18n.defaultLocale);
@@ -356,11 +373,11 @@ function BoltdocsShell({ config, routes, components = {}, collectionsData }) {
 		...components
 	}), [components]);
 	const { pathname } = (0, react_router_dom.useLocation)();
-	const currentPath = (0, react.useMemo)(() => require_icons_dev.normalizePath(pathname || "/"), [pathname]);
+	const currentPath = (0, react.useMemo)(() => require_link.normalizePath(pathname || "/"), [pathname]);
 	const routeMap = (0, react.useMemo)(() => {
 		const map = /* @__PURE__ */ new Map();
 		for (const r of routes) {
-			const key = require_icons_dev.normalizePath(r.path === "" ? "/" : r.path);
+			const key = require_link.normalizePath(r.path === "" ? "/" : r.path);
 			map.set(key, r);
 		}
 		return map;
@@ -382,15 +399,15 @@ function BoltdocsShell({ config, routes, components = {}, collectionsData }) {
 		config,
 		routeMap
 	]);
-	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(HelmetProvider, { children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_icons_dev.RoutesProvider, {
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_link.RoutesProvider, {
 		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.jsx)(require_icons_dev.ConfigContext.Provider, {
+			children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_link.ConfigContext.Provider, {
 				value: config,
 				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, {
+					children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(ScrollHandler, {}), /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(require_link.BoltdocsProvider, {
 						initialLocale: initialData.initLocale,
 						initialVersion: initialData.initVersion,
 						children: [
@@ -404,13 +421,16 @@ function BoltdocsShell({ config, routes, components = {}, collectionsData }) {
 								siteDescription: config.theme?.description,
 								routes
 							}),
-							/* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_search_dialog$1.InternalErrorBoundary, { children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(react_router_dom.Outlet, {}) })
+							/* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_search_dialog$1.InternalErrorBoundary, { children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+								className: "boltdocs-shell-content h-screen overflow-hidden",
+								children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(react_router_dom.Outlet, {})
+							}) })
 						]
 					})]
 				})
 			})
 		}) }) })
-	}) });
+	});
 }
 
 //#endregion
@@ -455,17 +475,43 @@ function DocPage({ route, content: Content, mdxComponents: propComponents }) {
 /**
 * Renders an MDX page by consuming pre-loaded route data.
 *
-* - If the route belongs to a collection (`data.collection` is set), renders
-*   the custom post component if provided, else falls back to the standard DocPage.
+* - If the route belongs to a collection (`data.collection` is set), wraps
+*   the content with `CurrentPostProvider` so that `usePost()` (called without
+*   a slug) can read the current post's data from context.
 * - Otherwise, renders the standard `DocPage` layout.
 */
 function MdxPage({ MDXComponent, mdxComponents: propComponents, collectionPostComponent: CollectionPost }) {
 	const data = (0, react_router_dom.useLoaderData)();
 	if (!MDXComponent) return null;
-	if (!!data?.collection && CollectionPost) return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(CollectionPost, {
-		MDXComponent,
-		mdxComponents: propComponents
-	});
+	const collectionData = data;
+	if (!!collectionData?.collection) {
+		const postElement = CollectionPost ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)(CollectionPost, {
+			MDXComponent,
+			mdxComponents: propComponents
+		}) : /* @__PURE__ */ (0, react_jsx_runtime.jsx)(DocPage, {
+			route: {
+				path: collectionData.route.path,
+				filePath: collectionData.route.filePath,
+				title: collectionData.route.title,
+				description: collectionData.route.description,
+				headings: collectionData.headings,
+				locale: collectionData.route.locale,
+				version: collectionData.route.version,
+				lastUpdated: collectionData.route.lastUpdated,
+				frontmatter: collectionData.route.frontmatter
+			},
+			content: MDXComponent,
+			mdxComponents: propComponents
+		});
+		return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(CurrentPostProvider, {
+			value: {
+				route: collectionData.route,
+				headings: collectionData.headings,
+				collection: collectionData.collection
+			},
+			children: postElement
+		});
+	}
 	const docData = data;
 	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(DocPage, {
 		route: {
@@ -492,7 +538,7 @@ function MdxPage({ MDXComponent, mdxComponents: propComponents, collectionPostCo
 * Hook to generate breadcrumbs based on the current active route.
 */
 function useBreadcrumbs() {
-	const { currentRoute: activeRoute } = require_icons_dev.useRoutes();
+	const { currentRoute: activeRoute } = require_link.useRoutes();
 	const crumbs = [];
 	if (activeRoute) {
 		if (activeRoute.groupTitle) crumbs.push({ label: activeRoute.groupTitle });
@@ -517,14 +563,14 @@ function Breadcrumbs() {
 		children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_docs_layout.Breadcrumbs.Item, { children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_docs_layout.Breadcrumbs.Link, {
 			href: "/",
 			className: "text-muted hover:text-body transition-colors flex items-center",
-			children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_icons_dev.Home, { size: 14 })
+			children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_link.Home, { size: 14 })
 		}) }), crumbs.map((crumb, i) => {
 			const isActive = crumb.href === activeRoute?.path;
 			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(require_docs_layout.Breadcrumbs.Item, {
 				className: "gap-2",
 				children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_docs_layout.Breadcrumbs.Separator, { className: "text-muted/40" }), /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_docs_layout.Breadcrumbs.Link, {
-					href: crumb.href,
-					className: require_icons_dev.cn("transition-colors", isActive ? "text-body font-semibold cursor-default pointer-events-none" : "text-muted hover:text-body"),
+					href: crumb.href ?? "",
+					className: require_link.cn("transition-colors", isActive ? "text-body font-semibold cursor-default pointer-events-none" : "text-muted hover:text-body"),
 					children: crumb.label
 				})]
 			}, `crumb-${crumb.href}-${crumb.label}-${i}`);
@@ -573,26 +619,26 @@ function CopyMarkdown({ content, mdxRaw }) {
 			children: [
 				/* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_search_dialog.Button, {
 					onPress: handleCopy,
-					className: require_icons_dev.cn("md:hidden flex items-center justify-center w-8 h-8 bg-transparent outline-none select-none cursor-pointer border-none", "text-muted transition-all duration-300 hover:bg-primary-500/5 hover:text-body", copied && "text-emerald-500 hover:bg-emerald-500/5"),
+					className: require_link.cn("md:hidden flex items-center justify-center w-8 h-8 bg-transparent outline-none select-none cursor-pointer border-none", "text-muted transition-all duration-300 hover:bg-primary-500/5 hover:text-body", copied && "text-emerald-500 hover:bg-emerald-500/5"),
 					"aria-label": copied ? "Copied!" : "Copy Markdown",
-					children: copied ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_icons_dev.Check, { size: 14 }) : /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_icons_dev.Copy, { size: 14 })
+					children: copied ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_link.Check, { size: 14 }) : /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_link.Copy, { size: 14 })
 				}),
 				/* @__PURE__ */ (0, react_jsx_runtime.jsxs)(require_search_dialog.Button, {
 					onPress: handleCopy,
-					className: require_icons_dev.cn("hidden md:flex items-center gap-2 px-5 py-2 bg-transparent text-[0.8125rem] font-semibold h-9 shrink-0 outline-none select-none cursor-pointer border-none", "text-body transition-all duration-300 hover:bg-primary-500/5", copied && "text-emerald-500 hover:bg-emerald-500/5"),
-					children: [copied ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_icons_dev.Check, { size: 16 }) : /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_icons_dev.Copy, { size: 16 }), copied ? "Copied!" : "Copy Markdown"]
+					className: require_link.cn("hidden md:flex items-center gap-2 px-5 py-2 bg-transparent text-[0.8125rem] font-semibold h-9 shrink-0 outline-none select-none cursor-pointer border-none", "text-body transition-all duration-300 hover:bg-primary-500/5", copied && "text-emerald-500 hover:bg-emerald-500/5"),
+					children: [copied ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_link.Check, { size: 16 }) : /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_link.Copy, { size: 16 }), copied ? "Copied!" : "Copy Markdown"]
 				}),
 				/* @__PURE__ */ (0, react_jsx_runtime.jsxs)(require_docs_layout.Menu.Trigger, {
 					placement: "bottom end",
 					children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_search_dialog.Button, {
-						className: require_icons_dev.cn("flex items-center justify-center px-2.5 md:px-3.5 h-8 md:h-9 border-none border-l border-subtle/50 text-muted rounded-none bg-transparent shrink-0 outline-none select-none cursor-pointer", "transition-all duration-300 hover:bg-primary-500/5 hover:text-primary-500"),
-						children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_icons_dev.ChevronDown, { size: 14 })
+						className: require_link.cn("flex items-center justify-center px-2.5 md:px-3.5 h-8 md:h-9 border-none border-l border-subtle/50 text-muted rounded-none bg-transparent shrink-0 outline-none select-none cursor-pointer", "transition-all duration-300 hover:bg-primary-500/5 hover:text-primary-500"),
+						children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_link.ChevronDown, { size: 14 })
 					}), /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(require_docs_layout.Menu.Root, {
 						className: "w-52 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.jsxs)(require_docs_layout.Menu.Item, {
 							onAction: handleCopy,
 							className: "flex items-center 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",
-							children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_icons_dev.Copy, {
+							children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_link.Copy, {
 								size: 16,
 								className: "size-4 text-muted dark:group-hover:text-primary-500 group-hover:text-primary-400"
 							}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
@@ -602,7 +648,7 @@ function CopyMarkdown({ content, mdxRaw }) {
 						}), /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(require_docs_layout.Menu.Item, {
 							onAction: handleOpenRaw,
 							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",
-							children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_icons_dev.ExternalLink, {
+							children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_link.ExternalLink, {
 								size: 16,
 								className: "size-4 text-muted dark:group-hover:text-primary-500 group-hover:text-primary-400"
 							}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
@@ -669,7 +715,7 @@ function GithubStars({ repo }) {
 		target: "_blank",
 		rel: "noopener noreferrer",
 		className: "inline-flex items-center gap-2 rounded-xl border border-subtle bg-surface px-3 py-1.5 text-xs font-semibold text-muted dark:hover:bg-primary-300/50 hover:bg-primary-200/50 transition-colors duration-100 hover:border-primary-500/50 hover:text-body select-none outline-none",
-		children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_icons_dev.Github, { className: "h-4 w-4 text-body" }), stars !== null && /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", {
+		children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_search_dialog.Github, { className: "h-4 w-4 text-body" }), stars !== null && /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", {
 			className: "tabular-nums font-medium",
 			children: [stars, " stars"]
 		})]
@@ -679,10 +725,10 @@ function GithubStars({ repo }) {
 //#endregion
 //#region src/client/hooks/use-navbar.ts
 function useNavbar() {
-	const config = require_icons_dev.useConfig();
+	const config = require_link.useConfig();
 	const { theme, resolvedTheme } = require_image.useTheme();
 	const location = (0, react_router_dom.useLocation)();
-	const { currentLocale } = require_icons_dev.useRoutes();
+	const { currentLocale } = require_link.useRoutes();
 	const themeConfig = config.theme || {};
 	const title = getTranslated(themeConfig.title, currentLocale) || "Boltdocs";
 	const rawLinks = themeConfig.navbar || [];
@@ -698,7 +744,7 @@ function useNavbar() {
 				const cleanPathParts = (p) => {
 					const parts = p.split("/").filter(Boolean);
 					let i = 0;
-					if (config.i18n?.locales && parts[i] && config.i18n.locales[parts[i]]) i++;
+					if (config.i18n?.locales && parts[i] && !Array.isArray(config.i18n.locales) && config.i18n.locales[parts[i]]) i++;
 					if (config.versions?.versions && parts[i]) {
 						if (config.versions.versions.some((v) => v.path === parts[i])) i++;
 					}
@@ -763,7 +809,7 @@ function ThemeToggle() {
 		setMounted(true);
 	}, []);
 	if (!mounted) return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", { className: "h-9 w-9" });
-	const Icon = theme === "system" ? require_icons_dev.Monitor : theme === "dark" ? require_icons_dev.Moon : require_icons_dev.Sun;
+	const Icon = theme === "system" ? require_link.Monitor : theme === "dark" ? require_link.Moon : require_link.Sun;
 	return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(require_docs_layout.Menu.Trigger, {
 		placement: "bottom right",
 		children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(react_aria_components.Button, {
@@ -785,7 +831,7 @@ function ThemeToggle() {
 				/* @__PURE__ */ (0, react_jsx_runtime.jsxs)(require_docs_layout.Menu.Item, {
 					id: "light",
 					className: "group 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)(require_icons_dev.Sun, {
+					children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_link.Sun, {
 						className: "group-hover:text-primary-500 dark:group-hover:text-primary-200",
 						size: 16
 					}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
@@ -796,7 +842,7 @@ function ThemeToggle() {
 				/* @__PURE__ */ (0, react_jsx_runtime.jsxs)(require_docs_layout.Menu.Item, {
 					id: "dark",
 					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)(require_icons_dev.Moon, {
+					children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_link.Moon, {
 						className: "group-hover:text-primary-500 dark:group-hover:text-primary-200",
 						size: 16
 					}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
@@ -807,7 +853,7 @@ function ThemeToggle() {
 				/* @__PURE__ */ (0, react_jsx_runtime.jsxs)(require_docs_layout.Menu.Item, {
 					id: "system",
 					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)(require_icons_dev.Monitor, {
+					children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_link.Monitor, {
 						className: "group-hover:text-primary-500 dark:group-hover:text-primary-200",
 						size: 16
 					}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
@@ -825,23 +871,23 @@ function ThemeSwitcher({ className }) {
 	(0, react.useEffect)(() => {
 		setMounted(true);
 	}, []);
-	if (!mounted) return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", { className: require_icons_dev.cn("h-10 w-full bg-surface rounded-xl animate-pulse", className) });
+	if (!mounted) return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", { className: require_link.cn("h-10 w-full bg-surface rounded-xl animate-pulse", className) });
 	const isDark = theme === "dark";
 	return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
-		className: require_icons_dev.cn("flex p-1 bg-surface border border-subtle rounded-xl relative w-full h-11", className),
+		className: require_link.cn("flex p-1 bg-surface border border-subtle rounded-xl relative w-full h-11", className),
 		children: [
-			/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", { className: require_icons_dev.cn("absolute inset-y-1 w-[calc(50%-4px)] bg-main border border-subtle rounded-lg transition-all duration-300 ease-out shadow-xs", isDark ? "translate-x-full" : "translate-x-0") }),
+			/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", { className: require_link.cn("absolute inset-y-1 w-[calc(50%-4px)] bg-main border border-subtle rounded-lg transition-all duration-300 ease-out shadow-xs", isDark ? "translate-x-full" : "translate-x-0") }),
 			/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
 				onClick: () => setTheme("light"),
-				className: require_icons_dev.cn("flex-1 flex items-center justify-center rounded-lg z-10 transition-colors outline-none cursor-pointer border-none bg-transparent", !isDark ? "text-body font-semibold" : "text-muted hover:text-body"),
+				className: require_link.cn("flex-1 flex items-center justify-center rounded-lg z-10 transition-colors outline-none cursor-pointer border-none bg-transparent", !isDark ? "text-body font-semibold" : "text-muted hover:text-body"),
 				"aria-label": "Light mode",
-				children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_icons_dev.Sun, { size: 18 })
+				children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_link.Sun, { size: 18 })
 			}),
 			/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
 				onClick: () => setTheme("dark"),
-				className: require_icons_dev.cn("flex-1 flex items-center justify-center rounded-lg z-10 transition-colors outline-none cursor-pointer border-none bg-transparent", isDark ? "text-body font-semibold" : "text-muted hover:text-body"),
+				className: require_link.cn("flex-1 flex items-center justify-center rounded-lg z-10 transition-colors outline-none cursor-pointer border-none bg-transparent", isDark ? "text-body font-semibold" : "text-muted hover:text-body"),
 				"aria-label": "Dark mode",
-				children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_icons_dev.Moon, { size: 18 })
+				children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_link.Moon, { size: 18 })
 			})
 		]
 	});
@@ -857,8 +903,8 @@ function useTabs(tabs = [], routes = []) {
 		transform: "translateX(0) scaleX(0)",
 		width: 0
 	});
-	const currentPath = require_icons_dev.normalizePath(location.pathname);
-	const activeTabId = routes.find((r) => require_icons_dev.normalizePath(r.path) === currentPath)?.tab?.toLowerCase();
+	const currentPath = require_link.normalizePath(location.pathname);
+	const activeTabId = routes.find((r) => require_link.normalizePath(r.path) === currentPath)?.tab?.toLowerCase();
 	const activeIndex = tabs.findIndex((tab) => tab.id.toLowerCase() === activeTabId);
 	const finalActiveIndex = activeIndex === -1 ? 0 : activeIndex;
 	(0, react.useEffect)(() => {
@@ -885,7 +931,7 @@ function useTabs(tabs = [], routes = []) {
 //#endregion
 //#region src/client/components/ui-base/tabs.tsx
 function Tabs({ tabs, routes }) {
-	const { currentLocale } = require_icons_dev.useRoutes();
+	const { currentLocale } = require_link.useRoutes();
 	const { indicatorStyle, tabRefs, activeIndex } = useTabs(tabs, routes);
 	(0, react.useEffect)(() => {
 		const activeTab = tabRefs.current[activeIndex];
@@ -902,7 +948,7 @@ function Tabs({ tabs, routes }) {
 			dangerouslySetInnerHTML: { __html: isomorphic_dompurify.default.sanitize(iconName, { USE_PROFILES: { svg: true } }) }
 		});
 		const icons = {
-			...require_icons_dev.icons_exports,
+			...require_link.icons_exports,
 			...virtual_boltdocs_icons.default
 		};
 		const TabIcon = icons[iconName] || icons[iconName + "Icon"];
@@ -920,7 +966,7 @@ function Tabs({ tabs, routes }) {
 			children: [tabs.map((tab, index) => {
 				const isActive = index === activeIndex;
 				const firstRoute = routes.find((r) => r.tab && r.tab.toLowerCase() === tab.id.toLowerCase());
-				return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(require_icons_dev.Link, {
+				return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(require_link.Link, {
 					href: firstRoute ? firstRoute.path : "#",
 					ref: (el) => {
 						tabRefs.current[index] = el;
@@ -959,10 +1005,10 @@ function getBaseFilePath(filePath, version, locale) {
 */
 function useVersion() {
 	const navigate = (0, react_router_dom.useNavigate)();
-	const config = require_icons_dev.useConfig();
-	const { allRoutes, currentRoute, currentVersion, currentLocale } = require_icons_dev.useRoutes();
+	const config = require_link.useConfig();
+	const { allRoutes, currentRoute, currentVersion, currentLocale } = require_link.useRoutes();
 	const versions = config.versions;
-	const { setVersion } = require_icons_dev.useBoltdocsContext();
+	const { setVersion } = require_link.useBoltdocsContext();
 	const handleVersionChange = (version) => {
 		if (!versions || version === currentVersion) return;
 		setVersion(version);
@@ -1002,11 +1048,11 @@ 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),
+		className: require_link.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_link.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, {
@@ -1027,10 +1073,10 @@ function VersionSelector({ className }) {
 */
 function useI18n() {
 	const navigate = (0, react_router_dom.useNavigate)();
-	const config = require_icons_dev.useConfig();
-	const { allRoutes, currentRoute, currentLocale, currentVersion } = require_icons_dev.useRoutes();
+	const config = require_link.useConfig();
+	const { allRoutes, currentRoute, currentLocale, isCollectionPage } = require_link.useRoutes();
 	const i18n = config.i18n;
-	const { setLocale } = require_icons_dev.useBoltdocsContext();
+	const { setLocale } = require_link.useBoltdocsContext();
 	const handleLocaleChange = (locale) => {
 		if (!i18n || locale === currentLocale) return;
 		setLocale(locale);
@@ -1038,7 +1084,7 @@ function useI18n() {
 		const safeBase = base === "/" ? "" : base.replace(/\/$/, "");
 		const isDocRoute = !!currentRoute?.filePath;
 		let targetPath = "";
-		if (currentRoute) if (isDocRoute) {
+		if (currentRoute) if (isDocRoute && !currentRoute.collection && !isCollectionPage) {
 			const baseFile = getBaseFilePath(currentRoute.filePath, currentRoute.version, currentRoute.locale);
 			const targetRoute = allRoutes.find((r) => getBaseFilePath(r.filePath, r.version, r.locale) === baseFile && (r.locale || i18n.defaultLocale) === locale && r.version === currentRoute.version);
 			if (targetRoute) targetPath = targetRoute.path;
@@ -1050,25 +1096,29 @@ function useI18n() {
 		} else {
 			let rawExternal = currentRoute.path;
 			const parts = rawExternal.split("/").filter(Boolean);
-			if (parts.length > 0 && (Array.isArray(i18n.locales) ? i18n.locales.includes(parts[0]) : !!i18n.locales[parts[0]])) {
-				parts.shift();
+			const localePosition = currentRoute.collection ? 1 : 0;
+			if (parts.length > localePosition && (Array.isArray(i18n.locales) ? i18n.locales.includes(parts[localePosition]) : !!i18n.locales[parts[localePosition]])) {
+				parts.splice(localePosition, 1);
 				rawExternal = "/" + parts.join("/");
 			}
+			const cleanParts = rawExternal.split("/").filter(Boolean);
 			if (locale === i18n.defaultLocale) targetPath = rawExternal === "" ? "/" : rawExternal;
 			else {
-				const cleanExt = rawExternal.startsWith("/") ? rawExternal : `/${rawExternal}`;
-				targetPath = `/${locale}${cleanExt === "/" ? "" : cleanExt}`;
+				cleanParts.splice(localePosition, 0, locale);
+				targetPath = "/" + cleanParts.join("/") || "/";
 			}
 		}
 		else {
-			const targetRoute = allRoutes.find((r) => (r.locale || i18n.defaultLocale) === locale && (r.version || config.versions?.defaultVersion) === (currentVersion || config.versions?.defaultVersion));
-			if (targetRoute) targetPath = targetRoute.path;
+			const currentPath = location.pathname;
+			if (isCollectionPage) targetPath = currentPath;
 			else {
-				const vPath = currentVersion && currentVersion !== config.versions?.defaultVersion ? `/${currentVersion}` : "";
-				targetPath = locale === i18n.defaultLocale ? `${safeBase}${vPath}` : `${safeBase}${vPath}/${locale}`;
+				const parts = currentPath.split("/").filter(Boolean);
+				if (parts.length > 0 && (Array.isArray(i18n.locales) ? i18n.locales.includes(parts[0]) : !!i18n.locales[parts[0]])) parts.shift();
+				if (locale !== i18n.defaultLocale) parts.unshift(locale);
+				targetPath = "/" + parts.join("/");
 			}
 		}
-		if (!targetPath || targetPath === "") targetPath = "/";
+		if (!targetPath || targetPath === "") targetPath = "/s";
 		targetPath = targetPath.replace(/\/+/g, "/");
 		navigate(targetPath);
 	};
@@ -1101,7 +1151,7 @@ function useI18n() {
 //#endregion
 //#region src/client/hooks/use-page-nav.ts
 function usePageNav() {
-	const { routes, currentRoute } = require_icons_dev.useRoutes();
+	const { routes, currentRoute } = require_link.useRoutes();
 	const location = (0, react_router_dom.useLocation)();
 	const { groups, ungrouped } = require_docs_layout.useSidebar(routes);
 	return (0, react.useMemo)(() => {
@@ -1133,8 +1183,8 @@ function usePageNav() {
 		};
 		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);
+		const currentNormalizedPath = require_link.normalizePath(location.pathname);
+		const currentIndex = orderedRoutes.findIndex((r) => require_link.normalizePath(r.path) === currentNormalizedPath);
 		return {
 			prevPage: currentIndex > 0 ? orderedRoutes[currentIndex - 1] : null,
 			nextPage: currentIndex !== -1 && currentIndex < orderedRoutes.length - 1 ? orderedRoutes[currentIndex + 1] : null,
@@ -1152,10 +1202,42 @@ function usePageNav() {
 //#region src/client/hooks/use-analytics.ts
 function createAnalyticsInstance(config) {
 	if (typeof window === "undefined") return createDisabledAnalytics();
+	if (window.posthog) return createPostHogAnalytics(config);
 	if (typeof window.gtag === "function") return createGtagAnalytics(config);
 	if (window.dataLayer) return createDataLayerAnalytics(config);
 	return createDisabledAnalytics();
 }
+function createPostHogAnalytics(_config) {
+	return {
+		trackPageView: (path) => {
+			window.posthog?.capture("$pageview", { $current_url: path });
+		},
+		trackEvent: ({ action, category, label, value, params }) => {
+			window.posthog?.capture(action, {
+				event_category: category,
+				event_label: label,
+				value,
+				...params
+			});
+		},
+		trackSearch: (query, resultsCount) => {
+			window.posthog?.capture("search", {
+				query,
+				results_count: resultsCount
+			});
+		},
+		trackDownload: (file, type) => {
+			window.posthog?.capture("file_download", {
+				file_name: file,
+				file_type: type || file.split(".").pop()
+			});
+		},
+		trackExternalLink: (url) => {
+			window.posthog?.capture("external_link", { link_url: url });
+		},
+		isEnabled: true
+	};
+}
 function createGtagAnalytics(config) {
 	return {
 		trackPageView: (path, title) => {
@@ -1348,8 +1430,8 @@ function useHeadings() {
 * Resets automatically when navigating to a new page.
 */
 function useFeedback(options = {}) {
-	const config = require_icons_dev.useConfig();
-	const { currentRoute } = require_icons_dev.useRoutes();
+	const config = require_link.useConfig();
+	const { currentRoute } = require_link.useRoutes();
 	const [rating, setRating] = (0, react.useState)(null);
 	const [comment, setComment] = (0, react.useState)("");
 	const [loading, setLoading] = (0, react.useState)(false);
@@ -1416,14 +1498,14 @@ 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),
+		className: require_link.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", {
+			children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_link.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_link.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, {
@@ -1439,17 +1521,17 @@ function I18nSelector({ className }) {
 
 //#endregion
 //#region src/client/components/ui-base/navbar.tsx
-const SearchDialog$1 = (0, react.lazy)(() => Promise.resolve().then(() => require("../search-dialog-CW1f6dn6.cjs")).then((m) => ({ default: m.SearchDialog })));
+const SearchDialog$1 = (0, react.lazy)(() => Promise.resolve().then(() => require("../search-dialog-DHqwjJuG.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 { routes, currentRoute, isCollectionPage, currentVersion, currentLocale } = require_link.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"),
+		className: require_link.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: [
@@ -1457,7 +1539,7 @@ function Navbar() {
 						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" })
+						children: isSidebarOpen ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_link.X, { className: "w-5 h-5 text-body" }) : /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_link.Menu, { className: "w-5 h-5 text-body" })
 					}),
 					logo && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_search_dialog.Navbar.Logo, {
 						src: logo,
@@ -1470,6 +1552,10 @@ function Navbar() {
 						href: "site:/",
 						children: title
 					}),
+					currentRoute?.draft && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+						className: "hidden sm:inline-flex items-center px-2 py-0.5 rounded-full text-xs font-medium bg-yellow-100 text-yellow-800 dark:bg-yellow-900/30 dark:text-yellow-400 border border-yellow-200 dark:border-yellow-800",
+						children: "Draft"
+					}),
 					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
 						className: "hidden sm:block",
 						children: config.versions && currentVersion && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(VersionSelector, {})
@@ -1557,16 +1643,16 @@ function Navbar() {
 	});
 }
 function NavbarLinkItem({ link }) {
-	const localizedHref = require_icons_dev.useLocalizedTo(link.href || "");
+	const localizedHref = require_link.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"),
+			className: require_link.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 || ""),
+			href: require_link.useLocalizedTo(item.href || ""),
 			label: item.label
 		}, item.href))
 	});
@@ -1574,17 +1660,17 @@ function NavbarLinkItem({ 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")
+		className: require_link.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 localizedHref = require_link.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"),
+			className: require_link.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",
@@ -1599,20 +1685,26 @@ function NavbarMobileLinkItem({ link, onClose }) {
 		href: localizedHref,
 		active,
 		onPress: onClose,
-		className: require_icons_dev.cn("transition-all", active ? "text-body" : "text-muted/80 hover:text-body")
+		className: require_link.cn("transition-all", active ? "text-body" : "text-muted/80 hover:text-body")
 	});
 }
 
 //#endregion
 //#region src/client/components/ui-base/on-this-page.tsx
 function OnThisPage({ headings = [], editLink, communityHelp, filePath }) {
-	if (headings.length === 0) return null;
+	if (headings.length === 0) return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("nav", {
+		className: "w-toc shrink-0 hidden xl:block",
+		"aria-hidden": "true"
+	});
 	return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(require_docs_layout.OnThisPage.Root, { children: [
 		/* @__PURE__ */ (0, react_jsx_runtime.jsxs)(require_docs_layout.OnThisPage.Header, {
 			className: "flex flex-row gap-x-2",
-			children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_icons_dev.TextAlignStart, { size: 16 }), "On this page"]
+			children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_link.TextAlignStart, { size: 16 }), "On this page"]
+		}),
+		/* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_docs_layout.OnThisPage.Tree, {
+			className: "max-h-[300px]",
+			headings
 		}),
-		/* @__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", {
@@ -1625,13 +1717,13 @@ function OnThisPage({ headings = [], editLink, communityHelp, 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"]
+					children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_link.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"]
+					children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_link.CircleHelp, { size: 16 }), "Community help"]
 				}) })]
 			})]
 		})
@@ -1700,7 +1792,7 @@ function SidebarMain({ routes, config }) {
 			onPress: closeSidebar,
 			className: "h-9 w-9 flex items-center justify-center bg-transparent border-none outline-none select-none cursor-pointer rounded-xl hover:bg-primary-50/50 text-muted hover:text-body transition-colors",
 			"aria-label": "Close sidebar",
-			children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_icons_dev.X, { size: 20 })
+			children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_link.X, { size: 20 })
 		})]
 	})] }), /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(require_docs_layout.Sidebar.Content, { children: [hasUtilities && /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 		className: "flex flex-col gap-4 mb-10",
@@ -1739,7 +1831,7 @@ function Banner({ children, className = "", dismissible = false, id = "boltdocs-
 	};
 	if (!isVisible) return null;
 	return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
-		className: require_icons_dev.cn("relative flex items-center justify-center px-4 py-2.5 text-xs font-semibold tracking-wide bg-primary-500/10 dark:bg-primary-500/15 text-primary-700 dark:text-primary-300 border-b border-primary-500/20 select-none animate-in fade-in duration-300", className),
+		className: require_link.cn("relative flex items-center justify-center px-4 py-2.5 text-xs font-semibold tracking-wide bg-primary-500/10 dark:bg-primary-500/15 text-primary-700 dark:text-primary-300 border-b border-primary-500/20 select-none animate-in fade-in duration-300", className),
 		...props,
 		children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
 			className: "flex-1 text-center flex items-center justify-center gap-2",
@@ -1748,7 +1840,7 @@ function Banner({ children, className = "", dismissible = false, id = "boltdocs-
 			onClick: handleDismiss,
 			className: "absolute right-3 top-1/2 -translate-y-1/2 p-1.5 opacity-70 hover:opacity-100 transition-all duration-300 rounded-xl hover:bg-primary-500/10 cursor-pointer border-none bg-transparent flex items-center justify-center outline-none",
 			"aria-label": "Dismiss banner",
-			children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_icons_dev.X, { className: "w-3.5 h-3.5" })
+			children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_link.X, { className: "w-3.5 h-3.5" })
 		})]
 	});
 }
@@ -1756,16 +1848,16 @@ 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;
+	if (!(require_link.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),
+		className: require_link.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 })
+					children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_link.Check, { size: 24 })
 				}),
 				/* @__PURE__ */ (0, react_jsx_runtime.jsx)("h3", {
 					className: "text-lg font-semibold text-default",
@@ -1789,23 +1881,23 @@ function Feedback({ className }) {
 						/* @__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"),
+							className: require_link.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" })]
+							children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_link.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"),
+							className: require_link.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" })]
+							children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_link.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"),
+							className: require_link.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" })]
+							children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_link.FaceBad, {}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", { children: "No" })]
 						})
 					]
 				})]
@@ -1840,7 +1932,7 @@ function Feedback({ className }) {
 //#endregion
 //#region src/client/components/ui-base/giscus.tsx
 function Giscus({ className }) {
-	const config = require_icons_dev.useConfig();
+	const config = require_link.useConfig();
 	const { resolvedTheme } = require_image.useTheme();
 	const ref = (0, react.useRef)(null);
 	const initializedRef = (0, react.useRef)(false);
@@ -1896,7 +1988,7 @@ function Giscus({ className }) {
 	if (!giscusConfig) return null;
 	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
 		ref,
-		className: require_icons_dev.cn("w-full max-w-2xl mt-12 mb-6", className)
+		className: require_link.cn("w-full max-w-2xl mt-12 mb-6", className)
 	});
 }
 
@@ -1929,7 +2021,7 @@ const EagerMdxElement = ({ moduleLoader, moduleKey, route, components, collectio
 	if (!MDXComponent) return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(Loading, {});
 	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(MdxPage, {
 		MDXComponent,
-		mdxComponents: components,
+		mdxComponents: components ?? {},
 		collectionPostComponent
 	});
 };
@@ -1938,14 +2030,36 @@ const NotFoundWrapper = () => {
 	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(components.NotFound || components["404"] || NotFound, {});
 };
 
+//#endregion
+//#region src/client/app/doc-route-context.tsx
+/**
+* Context that exposes the currently active route to every primitive in the
+* tree. Slot renderers and other primitives consume it via `useDocRoute()`
+* instead of calling `useRoutes()` directly so a single computation is shared
+* across the whole layout.
+*
+* `undefined` means "no active route" (e.g. on a not-found page or before the
+* routes context has hydrated).
+*/
+const DocRouteContext = (0, react.createContext)(void 0);
+function DocRouteProvider({ value, children }) {
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(DocRouteContext.Provider, {
+		value,
+		children
+	});
+}
+
 //#endregion
 //#region src/client/app/docs-layout.tsx
 function DocsLayout({ collectionsData }) {
-	const { currentRoute } = require_icons_dev.useRoutes();
-	const content = /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_search_dialog$1.InternalErrorBoundary, { children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(virtual_boltdocs_layout.default, {
-		route: currentRoute,
-		children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(react_router_dom.Outlet, {})
-	}) });
+	const { currentRoute } = require_link.useRoutes();
+	const content = /* @__PURE__ */ (0, react_jsx_runtime.jsx)(DocRouteProvider, {
+		value: currentRoute,
+		children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_search_dialog$1.InternalErrorBoundary, { children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(virtual_boltdocs_layout.default, {
+			route: currentRoute,
+			children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(react_router_dom.Outlet, {})
+		}) })
+	});
 	if (collectionsData) return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(CollectionsContext.Provider, {
 		value: collectionsData,
 		children: content
@@ -2038,15 +2152,15 @@ function buildDocRoutes(options) {
 					moduleKey,
 					moduleLoader: mod,
 					route,
-					components
+					components: components ?? {}
 				}, moduleKey || path);
 			} };
 		};
 		else routeRecord.element = /* @__PURE__ */ (0, react_jsx_runtime.jsx)(EagerMdxElement, {
 			moduleKey,
-			moduleLoader,
+			moduleLoader: moduleLoader ?? {},
 			route,
-			components
+			components: components ?? {}
 		}, moduleKey || path);
 		return routeRecord;
 	});
@@ -2145,6 +2259,15 @@ function buildDocRoutes(options) {
 	};
 }
 
+//#endregion
+//#region src/client/ssg/external-page-wrapper.tsx
+function ExternalPageWrapper({ children }) {
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+		className: "boltdocs-external-content h-screen overflow-y-auto",
+		children
+	});
+}
+
 //#endregion
 //#region src/client/ssg/create-routes.external.tsx
 function buildExternalRoutes(options) {
@@ -2163,11 +2286,12 @@ function buildExternalRoutes(options) {
 			locale: config.i18n?.defaultLocale,
 			title: rawPath === "/" ? "Home" : rawPath.replace(/^\//, "").split("/").pop() || "Page",
 			filePath: "",
+			componentPath: "",
 			headings: []
 		});
 		children.push({
 			path,
-			element: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(EffectiveExternalLayout, { children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ExtComponent, {}) }),
+			element: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ExternalPageWrapper, { children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(EffectiveExternalLayout, { children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ExtComponent, {}) }) }),
 			loader: async () => ({
 				path,
 				locale: config.i18n?.defaultLocale
@@ -2181,11 +2305,12 @@ function buildExternalRoutes(options) {
 				locale,
 				title: rawPath,
 				filePath: "",
+				componentPath: "",
 				headings: []
 			});
 			children.push({
 				path: localePath,
-				element: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(EffectiveExternalLayout, { children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ExtComponent, {}) }),
+				element: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ExternalPageWrapper, { children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(EffectiveExternalLayout, { children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ExtComponent, {}) }) }),
 				loader: async () => ({
 					path: localePath,
 					locale
@@ -2200,21 +2325,107 @@ function buildExternalRoutes(options) {
 	};
 }
 
+//#endregion
+//#region src/client/collections/hooks.ts
+const DEFAULT_COLLECTION = "blog";
+/**
+* Returns the posts of a collection, filtered by the current locale and version.
+* Defaults to "blog" if no collection is specified.
+* @param collection - The name of the collection. Defaults to "blog".
+* @param options - Options to customize the query.
+* @param options.includeDrafts - If true, includes draft posts in the results.
+* @returns The filtered posts of the collection.
+*/
+function usePosts(collection = DEFAULT_COLLECTION, options) {
+	const data = useCollectionsData();
+	const { currentLocale, currentVersion } = require_link.useRoutes();
+	const config = require_link.useConfig();
+	const posts = data[collection] || [];
+	const defaultLocale = config.i18n?.defaultLocale;
+	const defaultVersion = config.versions?.defaultVersion;
+	return (0, react.useMemo)(() => {
+		return posts.filter((post) => {
+			const postLocale = post.locale || defaultLocale;
+			const postVersion = post.version || defaultVersion;
+			const localeMatch = !currentLocale || postLocale === currentLocale;
+			const versionMatch = !currentVersion || postVersion === currentVersion;
+			const draftMatch = options?.includeDrafts || !post.draft;
+			return localeMatch && versionMatch && draftMatch;
+		});
+	}, [
+		posts,
+		currentLocale,
+		currentVersion,
+		defaultLocale,
+		defaultVersion,
+		options?.includeDrafts
+	]);
+}
+function usePost(collection, slug) {
+	const ctx = useCurrentPostData();
+	const posts = usePosts(collection);
+	if (ctx && !slug) {
+		const { route } = ctx;
+		return (0, react.useMemo)(() => ({
+			path: route.path,
+			title: route.title,
+			date: route.date,
+			excerpt: route.excerpt,
+			tags: route.tags,
+			author: route.author,
+			coverImage: route.coverImage,
+			filePath: route.filePath,
+			locale: route.locale,
+			version: route.version,
+			frontmatter: route.frontmatter,
+			lastUpdated: route.lastUpdated,
+			headings: route.headings
+		}), [route]);
+	}
+	if (!collection || !slug) return void 0;
+	return (0, react.useMemo)(() => posts.find((p) => p.path === `/${collection}/${slug}` || p.path.endsWith(`/${slug}`) || p.path === slug), [
+		posts,
+		collection,
+		slug
+	]);
+}
+/**
+* Returns the recent posts of a collection. Defaults to "blog".
+* @param collection - The name of the collection. Defaults to "blog".
+* @param count - The number of recent posts to return.
+* @returns The recent posts of the collection.
+*/
+function useRecentPosts(collection = DEFAULT_COLLECTION, count = 5) {
+	const posts = usePosts(collection);
+	return (0, react.useMemo)(() => posts.slice(0, count), [posts, count]);
+}
+
 //#endregion
 //#region src/client/ssg/create-routes.collection.tsx
 function DefaultCollectionList() {
-	const data = (0, react_router_dom.useLoaderData)();
-	if (!data || !data.posts) return null;
+	const location = (0, react_router_dom.useLocation)();
+	const config = require_link.useConfig();
+	const postsPerPage = config.collections?.postsPerPage ?? 10;
+	const segments = location.pathname.split("/").filter(Boolean);
+	const isLocalePrefixed = config.i18n && segments[0] in (config.i18n.locales || {});
+	const collection = isLocalePrefixed ? segments[1] : segments[0];
+	const currentPage = (isLocalePrefixed ? segments[3] : segments[2]) === "page" ? Number(isLocalePrefixed ? segments[4] : segments[3]) || 1 : 1;
+	const allPosts = usePosts(collection);
+	const totalPages = Math.ceil(allPosts.length / postsPerPage);
+	const start = (currentPage - 1) * postsPerPage;
+	const posts = allPosts.slice(start, start + postsPerPage);
+	if (!posts.length) return null;
+	const basePath = isLocalePrefixed ? `/${segments[0]}/${segments[1]}` : `/${segments[0]}`;
 	return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 		className: "py-8 max-w-2xl mx-auto px-4",
 		children: [
 			/* @__PURE__ */ (0, react_jsx_runtime.jsx)("h1", {
 				className: "text-3xl font-bold mb-6 capitalize",
-				children: data.collection
+				children: collection
 			}),
 			/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
 				className: "space-y-6",
-				children: data.posts.map((post) => /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("article", {
+				children: posts.map((post) => /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("article", {
 					className: "border-b border-subtle pb-4",
 					children: [
 						/* @__PURE__ */ (0, react_jsx_runtime.jsx)("h2", {
@@ -2236,22 +2447,22 @@ function DefaultCollectionList() {
 					]
 				}, post.path))
 			}),
-			data.totalPages > 1 && /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+			totalPages > 1 && /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 				className: "mt-8 flex gap-4 text-sm",
 				children: [
-					data.currentPage > 1 && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(react_router_dom.Link, {
-						to: data.currentPage === 2 ? `/${data.collection}` : `/${data.collection}/page/${data.currentPage - 1}`,
+					currentPage > 1 && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(react_router_dom.Link, {
+						to: currentPage === 2 ? basePath : `${basePath}/page/${currentPage - 1}`,
 						className: "text-primary-600 hover:underline",
 						children: "Previous"
 					}),
 					/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", { children: [
 						"Page ",
-						data.currentPage,
+						currentPage,
 						" of ",
-						data.totalPages
+						totalPages
 					] }),
-					data.currentPage < data.totalPages && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(react_router_dom.Link, {
-						to: `/${data.collection}/page/${data.currentPage + 1}`,
+					currentPage < totalPages && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(react_router_dom.Link, {
+						to: `${basePath}/page/${currentPage + 1}`,
 						className: "text-primary-600 hover:underline",
 						children: "Next"
 					})
@@ -2342,6 +2553,9 @@ function buildCollectionRoutes(options) {
 			author: r.author,
 			coverImage: r.coverImage,
 			filePath: r.filePath,
+			locale: r.locale,
+			version: r.version,
+			lastUpdated: r.lastUpdated,
 			frontmatter: r.frontmatter
 		}));
 		const ListElement = collectionLists?.[colName] || DefaultCollectionList;
@@ -2399,7 +2613,7 @@ function createRoutes(options) {
 		...collectionRoutes.children,
 		{
 			path: "*",
-			element: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(EffectiveExternalLayout, { children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(NotFoundWrapper, {}) })
+			element: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ExternalPageWrapper, { children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(EffectiveExternalLayout, { children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(NotFoundWrapper, {}) }) })
 		}
 	];
 	return [{
@@ -2419,21 +2633,17 @@ function createRoutes(options) {
 
 //#endregion
 //#region src/client/components/docs-layout-default.tsx
+/**
+* Default docs layout — composes the visual primitives and delegates
+* sub-area routing to them. Slot rendering (plugin injections at
+* `navbar:end`, `sidebar:bottom`, `docs-content:top`, etc.) is handled
+* internally by each primitive so the layout itself does no slot "magic".
+*
+* A custom layout can reuse any primitive and the slot wiring just works.
+*/
 function DocsLayoutComponent({ children }) {
-	const { routes: filteredRoutes, currentRoute, isCollectionPage } = require_icons_dev.useRoutes();
-	const config = require_icons_dev.useConfig();
-	const AskAiDialog = useMergedComponents().AskAiDialog;
-	const [isAskAiOpen, setIsAskAiOpen] = (0, react.useState)(false);
-	(0, react.useEffect)(() => {
-		const handleOpen = () => setIsAskAiOpen(true);
-		const handleClose = () => setIsAskAiOpen(false);
-		window.addEventListener("boltdocs:ask-ai:open", handleOpen);
-		window.addEventListener("boltdocs:ask-ai:close", handleClose);
-		return () => {
-			window.removeEventListener("boltdocs:ask-ai:open", handleOpen);
-			window.removeEventListener("boltdocs:ask-ai:close", handleClose);
-		};
-	}, []);
+	const { routes: filteredRoutes, currentRoute, isCollectionPage } = require_link.useRoutes();
+	const config = require_link.useConfig();
 	return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(require_docs_layout.DocsLayout, {
 		className: "selection:bg-primary-500/10 selection:text-primary-500",
 		children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(Navbar, {}), /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(require_docs_layout.DocsLayout.Body, {
@@ -2443,97 +2653,46 @@ function DocsLayoutComponent({ children }) {
 					routes: filteredRoutes || [],
 					config
 				}),
-				/* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_docs_layout.DocsLayout.Content, {
-					className: "animate-in fade-in duration-500 scroll-smooth",
-					children: /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(require_docs_layout.DocsLayout.ContentMdx, {
-						className: "max-w-3xl sm:max-w-4xl lg:max-w-5xl px-4 sm:px-6 pt-8 pb-24",
-						children: [
-							!isCollectionPage && /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(require_docs_layout.DocsLayout.Header, { children: [
-								/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
-									className: "mb-4 border-b border-subtle pb-4 flex flex-wrap items-center justify-between gap-3",
-									children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(Breadcrumbs, {}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)(CopyMarkdown, {
-										mdxRaw: currentRoute?._rawContent,
-										route: currentRoute
-									})]
-								}),
-								currentRoute?.title && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("h1", {
-									className: "text-4xl font-bold tracking-tight text-default mb-3",
-									children: currentRoute.title
-								}),
-								currentRoute?.description && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
-									className: "text-lg text-muted-foreground mb-6 leading-relaxed",
-									children: currentRoute.description
-								})
-							] }),
-							/* @__PURE__ */ (0, react_jsx_runtime.jsx)(ErrorBoundary, { children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
-								className: "prose prose-neutral dark:prose-invert max-w-none",
-								children
-							}) }),
-							!isCollectionPage && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(Feedback, {}),
-							!isCollectionPage && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(Giscus, {}),
-							/* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_docs_layout.DocsLayout.Footer, { children: !isCollectionPage && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(PageNav, {}) })
-						]
+				/* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_docs_layout.DocsLayout.Content, { children: /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(require_docs_layout.DocsLayout.ContentMdx, { children: [
+					!isCollectionPage && /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(require_docs_layout.DocsLayout.Header, { children: [
+						/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+							className: "mb-4 border-b border-subtle pb-4 flex flex-wrap items-center justify-between gap-3",
+							children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(Breadcrumbs, {}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)(CopyMarkdown, {
+								mdxRaw: currentRoute?._rawContent,
+								route: currentRoute
+							})]
+						}),
+						currentRoute?.title && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("h1", {
+							className: "text-4xl font-bold tracking-tight text-default mb-3",
+							children: currentRoute.title
+						}),
+						currentRoute?.description && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+							className: "text-lg text-muted-foreground mb-6 leading-relaxed",
+							children: currentRoute.description
+						})
+					] }),
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)(ErrorBoundary, { children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+						className: "prose prose-neutral dark:prose-invert max-w-none",
+						children
+					}) }),
+					!isCollectionPage && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(Feedback, {}),
+					!isCollectionPage && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(Giscus, {}),
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_docs_layout.DocsLayout.Footer, { children: !isCollectionPage && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(PageNav, {}) })
+				] }) }),
+				/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+					className: "overflow-y-auto sticky",
+					children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(OnThisPage, {
+						headings: currentRoute?.headings,
+						filePath: currentRoute?.filePath,
+						communityHelp: config.theme?.communityHelp,
+						editLink: config.theme?.editLink
 					})
-				}),
-				AskAiDialog && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(AskAiDialog, {}),
-				!isCollectionPage && !isAskAiOpen && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(OnThisPage, {
-					headings: currentRoute?.headings,
-					filePath: currentRoute?.filePath,
-					communityHelp: config.theme?.communityHelp,
-					editLink: config.theme?.editLink
 				})
 			]
 		})]
 	});
 }
 
-//#endregion
-//#region src/client/collections/hooks.ts
-/**
-* Returns the posts of a collection.
-* @param collection - The name of the collection.
-* @returns The posts of the collection.
-*/
-function usePosts(collection) {
-	const data = useCollectionsData();
-	const { currentLocale, currentVersion } = require_icons_dev.useRoutes();
-	const config = require_icons_dev.useConfig();
-	const posts = data[collection] || [];
-	const defaultLocale = config.i18n?.defaultLocale;
-	const defaultVersion = config.versions?.defaultVersion;
-	return (0, react.useMemo)(() => {
-		return posts.filter((post) => {
-			const postLocale = post.locale || defaultLocale;
-			const postVersion = post.version || defaultVersion;
-			return (!currentLocale || postLocale === currentLocale) && (!currentVersion || postVersion === currentVersion);
-		});
-	}, [
-		posts,
-		currentLocale,
-		currentVersion,
-		defaultLocale,
-		defaultVersion
-	]);
-}
-function usePost(collection, slug) {
-	const posts = usePosts(collection);
-	return (0, react.useMemo)(() => posts.find((p) => p.path === `/${collection}/${slug}` || p.path.endsWith(`/${slug}`) || p.path === slug), [
-		posts,
-		collection,
-		slug
-	]);
-}
-/**
-* Returns the recent posts of a collection.
-* @param collection - The name of the collection.
-* @param count - The number of recent posts to return.
-* @returns The recent posts of the collection.
-*/
-function useRecentPosts(collection, count = 5) {
-	const posts = usePosts(collection);
-	return (0, react.useMemo)(() => posts.slice(0, count), [posts, count]);
-}
-
 //#endregion
 //#region src/client/utils/react-to-text.ts
 const reactToText = (node, resolvers) => {
@@ -2554,6 +2713,7 @@ exports.BoltdocsShell = BoltdocsShell;
 exports.Breadcrumbs = Breadcrumbs;
 exports.CollectionsContext = CollectionsContext;
 exports.CopyMarkdown = CopyMarkdown;
+exports.CurrentPostProvider = CurrentPostProvider;
 exports.DocsLayout = DocsLayoutComponent;
 exports.ErrorBoundary = ErrorBoundary;
 exports.MdxPage = MdxPage;
@@ -2563,13 +2723,14 @@ exports.OnThisPage = OnThisPage;
 exports.PageNav = PageNav;
 exports.SearchDialog = require_search_dialog$1.SearchDialog;
 exports.Sidebar = Sidebar;
+exports.Timeline = require_mdx.Timeline;
 Object.defineProperty(exports, 'ViteReactSSG', {
   enumerable: true,
   get: function () {
     return _bdocs_ssg.ViteReactSSG;
   }
 });
-exports.cn = require_icons_dev.cn;
+exports.cn = require_link.cn;
 exports.copyToClipboard = require_mdx.copyToClipboard;
 exports.createRoutes = createRoutes;
 exports.getStarsRepo = getStarsRepo;
@@ -2578,11 +2739,11 @@ exports.reactToText = reactToText;
 exports.useAnalytics = useAnalytics;
 exports.useBreadcrumbs = useBreadcrumbs;
 exports.useCodeBlock = require_mdx.useCodeBlock;
-exports.useConfig = require_icons_dev.useConfig;
+exports.useConfig = require_link.useConfig;
 exports.useFeedback = useFeedback;
 exports.useHeadings = useHeadings;
 exports.useI18n = useI18n;
-exports.useLocalizedTo = require_icons_dev.useLocalizedTo;
+exports.useLocalizedTo = require_link.useLocalizedTo;
 exports.useLocation = require_docs_layout.useLocation;
 exports.useMdxComponents = useMdxComponents;
 exports.useMergedComponents = useMergedComponents;
@@ -2591,7 +2752,7 @@ exports.usePageNav = usePageNav;
 exports.usePost = usePost;
 exports.usePosts = usePosts;
 exports.useRecentPosts = useRecentPosts;
-exports.useRoutes = require_icons_dev.useRoutes;
+exports.useRoutes = require_link.useRoutes;
 exports.useSearch = require_search_dialog$1.useSearch;
 exports.useSearchHighlight = require_docs_layout.useSearchHighlight;
 exports.useSidebar = require_docs_layout.useSidebar;