boltdocs 3.0.2 → 3.2.1

package/dist/client/index.js

@@ -3,18 +3,18 @@
  * Copyright (c) 2026 Jesus Alcala
  * Licensed under the MIT License.
  */
-import { $ as TextAlignStart, C as RoutesProvider, D as Check, E as ArrowLeft, F as FaceBad, I as FaceGood, J as Moon, K as Menu, L as FaceRegular, M as Copy, O as ChevronDown, P as ExternalLink, Q as Sun, S as normalizePath, U as Languages, V as Home, X as Pencil, _ as Link$1, at as useBoltdocsContext, b as useLocalizedTo, et as X, it as BoltdocsProvider, j as CircleHelp, nt as ConfigContext, q as Monitor, rt as useConfig, s as Github, tt as icons_exports, x as useRoutes, y as cn } from "../icons-dev-kJyGWNeg.js";
-import { c as ThemeProvider, l as useTheme } from "../image-C9md50h2.js";
-import { n as useCodeBlock, r as copyToClipboard, t as mdx_components_default } from "../mdx-DhyMkc35.js";
-import { A as useUI, C as useSidebar, D as ButtonGroup, O as Breadcrumbs$2, S as useLocation, T as Menu$1, f as PageNav$1, k as UIProvider, m as OnThisPage$1, n as Sidebar$1, t as DocsLayout$1, w as Tabs$1, x as useSearchHighlight } from "../docs-layout-6FQ8__ok.js";
-import { a as Button$1, n as Navbar$1, r as ErrorBoundary$1 } from "../search-dialog-DaeSPvEo.js";
-import { n as useSearch, r as InternalErrorBoundary, t as SearchDialog } from "../search-dialog-DDopgbKM.js";
+import { A as Monitor, B as useConfig, E as Languages, F as Sun, H as useBoltdocsContext, I as TextAlignStart, L as X, N as Pencil, R as icons_exports, V as BoltdocsProvider, a as useRoutes, b as FaceGood, d as Check, f as ChevronDown, g as Copy, h as CircleHelp, i as useLocalizedTo, j as Moon, k as Menu, o as normalizePath, r as cn, s as RoutesProvider, t as Link$1, u as ArrowLeft, v as ExternalLink, w as Home, x as FaceRegular, y as FaceBad, z as ConfigContext } from "../link-2PzgTnaP.js";
+import { c as ThemeProvider, l as useTheme } from "../image-Bz87fCla.js";
+import { i as copyToClipboard, n as Timeline, r as useCodeBlock, t as mdx_components_default } from "../mdx-BuO6a1f7.js";
+import { A as useUI, C as useSidebar, D as ButtonGroup, O as Breadcrumbs$2, S as useLocation, T as Menu$1, f as PageNav$1, k as UIProvider, m as OnThisPage$1, n as Sidebar$1, t as DocsLayout$1, w as Tabs$1, x as useSearchHighlight } from "../docs-layout-BdtZ9z6s.js";
+import { i as ErrorBoundary$1, n as Navbar$1, o as Button$1, r as Github } from "../search-dialog-DFnlx8LO.js";
+import { n as useSearch, r as InternalErrorBoundary, t as SearchDialog } from "../search-dialog-BmxHiKwt.js";
 import { ViteReactSSG } from "@bdocs/ssg";
 import { Suspense, createContext, isValidElement, lazy, use, useCallback, useEffect, useLayoutEffect, useMemo, useRef, useState } from "react";
 import { Link, Outlet, useLoaderData, useLocation as useLocation$1, useMatches, useNavigate } from "react-router-dom";
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
-import * as ReactHelmetAsync from "react-helmet-async";
 import { Button } from "react-aria-components";
+import * as ReactHelmetAsync from "react-helmet-async";
 import virtualCustomComponents from "virtual:boltdocs-mdx-components";
 import virtualIcons from "virtual:boltdocs-icons";
 import DOMPurify from "isomorphic-dompurify";
@@ -49,20 +49,6 @@ function MdxComponentsProvider({ components, children }) {
 	});
 }
 
-//#endregion
-//#region src/client/app/helmet-compat.tsx
-const mod = ReactHelmetAsync;
-/**
-* 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__ */ jsx(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__ */ jsx(Fragment, { children }));
-
 //#endregion
 //#region src/client/app/scroll-handler.tsx
 /**
@@ -73,7 +59,7 @@ const HelmetProvider = mod.HelmetProvider || mod.default?.HelmetProvider || (({
 function ScrollHandler() {
 	const { pathname, hash } = useLocation$1();
 	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;
@@ -106,11 +92,6 @@ function ScrollHandler() {
 	}, [pathname, hash]);
 	useEffect(() => {
 		handleScroll("auto");
-		const rafId = requestAnimationFrame(() => {
-			handleScroll("auto");
-			window.dispatchEvent(new Event("resize"));
-		});
-		return () => cancelAnimationFrame(rafId);
 	}, [pathname, hash]);
 	return null;
 }
@@ -155,6 +136,28 @@ const mdxComponentsDefault = {
 	"404": NotFound
 };
 
+//#endregion
+//#region src/client/app/helmet-compat.tsx
+const mod = ReactHelmetAsync;
+/**
+* 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__ */ jsx(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__ */ jsx(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
 /**
@@ -272,12 +275,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__ */ 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__ */ jsx("meta", {
 				property: key,
-				content: value
+				content: strVal
 			}, key) : /* @__PURE__ */ jsx("meta", {
 				name: key,
-				content: value
+				content: strVal
 			}, key);
 		}),
 		Object.entries(seo).map(([key, value]) => {
@@ -287,15 +292,17 @@ function Head({ siteTitle, siteDescription, routes }) {
 			}, "noindex");
 			if (key === "robots") return /* @__PURE__ */ 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__ */ 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__ */ jsx("meta", {
 				property: key,
-				content: value
+				content: strVal
 			}, key) : /* @__PURE__ */ jsx("meta", {
 				name: key,
-				content: value
+				content: strVal
 			}, key);
 		})
 	] });
@@ -307,6 +314,16 @@ const CollectionsContext = createContext({});
 function useCollectionsData() {
 	return use(CollectionsContext);
 }
+const CurrentPostContext = createContext(null);
+function CurrentPostProvider({ value, children }) {
+	return /* @__PURE__ */ jsx(CurrentPostContext.Provider, {
+		value,
+		children
+	});
+}
+function useCurrentPostData() {
+	return use(CurrentPostContext);
+}
 
 //#endregion
 //#region src/client/ssg/boltdocs-shell.tsx
@@ -376,7 +393,7 @@ function BoltdocsShell({ config, routes, components = {}, collectionsData }) {
 		config,
 		routeMap
 	]);
-	return /* @__PURE__ */ jsx(HelmetProvider, { children: /* @__PURE__ */ jsx(RoutesProvider, {
+	return /* @__PURE__ */ jsx(RoutesProvider, {
 		routes,
 		children: /* @__PURE__ */ jsx(ThemeProvider, { children: /* @__PURE__ */ jsx(UIProvider, { children: /* @__PURE__ */ jsx(MdxComponentsProvider, {
 			components: allComponents,
@@ -398,13 +415,16 @@ function BoltdocsShell({ config, routes, components = {}, collectionsData }) {
 								siteDescription: config.theme?.description,
 								routes
 							}),
-							/* @__PURE__ */ jsx(InternalErrorBoundary, { children: /* @__PURE__ */ jsx(Outlet, {}) })
+							/* @__PURE__ */ jsx(InternalErrorBoundary, { children: /* @__PURE__ */ jsx("div", {
+								className: "boltdocs-shell-content h-screen overflow-hidden",
+								children: /* @__PURE__ */ jsx(Outlet, {})
+							}) })
 						]
 					})]
 				})
 			})
 		}) }) })
-	}) });
+	});
 }
 
 //#endregion
@@ -449,17 +469,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 = useLoaderData();
 	if (!MDXComponent) return null;
-	if (!!data?.collection && CollectionPost) return /* @__PURE__ */ jsx(CollectionPost, {
-		MDXComponent,
-		mdxComponents: propComponents
-	});
+	const collectionData = data;
+	if (!!collectionData?.collection) {
+		const postElement = CollectionPost ? /* @__PURE__ */ jsx(CollectionPost, {
+			MDXComponent,
+			mdxComponents: propComponents
+		}) : /* @__PURE__ */ 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__ */ jsx(CurrentPostProvider, {
+			value: {
+				route: collectionData.route,
+				headings: collectionData.headings,
+				collection: collectionData.collection
+			},
+			children: postElement
+		});
+	}
 	const docData = data;
 	return /* @__PURE__ */ jsx(DocPage, {
 		route: {
@@ -517,7 +563,7 @@ function Breadcrumbs() {
 			return /* @__PURE__ */ jsxs(Breadcrumbs$2.Item, {
 				className: "gap-2",
 				children: [/* @__PURE__ */ jsx(Breadcrumbs$2.Separator, { className: "text-muted/40" }), /* @__PURE__ */ jsx(Breadcrumbs$2.Link, {
-					href: crumb.href,
+					href: crumb.href ?? "",
 					className: cn("transition-colors", isActive ? "text-body font-semibold cursor-default pointer-events-none" : "text-muted hover:text-body"),
 					children: crumb.label
 				})]
@@ -692,7 +738,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++;
 					}
@@ -1022,7 +1068,7 @@ function VersionSelector({ className }) {
 function useI18n() {
 	const navigate = useNavigate();
 	const config = useConfig();
-	const { allRoutes, currentRoute, currentLocale, currentVersion } = useRoutes();
+	const { allRoutes, currentRoute, currentLocale, isCollectionPage } = useRoutes();
 	const i18n = config.i18n;
 	const { setLocale } = useBoltdocsContext();
 	const handleLocaleChange = (locale) => {
@@ -1032,7 +1078,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;
@@ -1044,25 +1090,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);
 	};
@@ -1146,10 +1196,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) => {
@@ -1433,7 +1515,7 @@ function I18nSelector({ className }) {
 
 //#endregion
 //#region src/client/components/ui-base/navbar.tsx
-const SearchDialog$1 = lazy(() => import("../search-dialog-BNdRV60O.js").then((m) => ({ default: m.SearchDialog })));
+const SearchDialog$1 = lazy(() => import("../search-dialog-D6TvjcuV.js").then((m) => ({ default: m.SearchDialog })));
 function Navbar() {
 	const { links, title, logo, logoProps, github, social, config } = useNavbar();
 	const { routes, currentRoute, isCollectionPage, currentVersion, currentLocale } = useRoutes();
@@ -1464,6 +1546,10 @@ function Navbar() {
 						href: "site:/",
 						children: title
 					}),
+					currentRoute?.draft && /* @__PURE__ */ 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__ */ jsx("div", {
 						className: "hidden sm:block",
 						children: config.versions && currentVersion && /* @__PURE__ */ jsx(VersionSelector, {})
@@ -1600,13 +1686,19 @@ function NavbarMobileLinkItem({ link, onClose }) {
 //#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__ */ jsx("nav", {
+		className: "w-toc shrink-0 hidden xl:block",
+		"aria-hidden": "true"
+	});
 	return /* @__PURE__ */ jsxs(OnThisPage$1.Root, { children: [
 		/* @__PURE__ */ jsxs(OnThisPage$1.Header, {
 			className: "flex flex-row gap-x-2",
 			children: [/* @__PURE__ */ jsx(TextAlignStart, { size: 16 }), "On this page"]
 		}),
-		/* @__PURE__ */ jsx(OnThisPage$1.Tree, { headings }),
+		/* @__PURE__ */ jsx(OnThisPage$1.Tree, {
+			className: "max-h-[300px]",
+			headings
+		}),
 		(editLink || communityHelp) && /* @__PURE__ */ jsxs("div", {
 			className: "mt-8 pt-8 border-t border-subtle space-y-4",
 			children: [/* @__PURE__ */ jsx("p", {
@@ -1923,7 +2015,7 @@ const EagerMdxElement = ({ moduleLoader, moduleKey, route, components, collectio
 	if (!MDXComponent) return /* @__PURE__ */ jsx(Loading, {});
 	return /* @__PURE__ */ jsx(MdxPage, {
 		MDXComponent,
-		mdxComponents: components,
+		mdxComponents: components ?? {},
 		collectionPostComponent
 	});
 };
@@ -1932,14 +2024,36 @@ const NotFoundWrapper = () => {
 	return /* @__PURE__ */ 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 = createContext(void 0);
+function DocRouteProvider({ value, children }) {
+	return /* @__PURE__ */ jsx(DocRouteContext.Provider, {
+		value,
+		children
+	});
+}
+
 //#endregion
 //#region src/client/app/docs-layout.tsx
 function DocsLayout({ collectionsData }) {
 	const { currentRoute } = useRoutes();
-	const content = /* @__PURE__ */ jsx(InternalErrorBoundary, { children: /* @__PURE__ */ jsx(UserLayout, {
-		route: currentRoute,
-		children: /* @__PURE__ */ jsx(Outlet, {})
-	}) });
+	const content = /* @__PURE__ */ jsx(DocRouteProvider, {
+		value: currentRoute,
+		children: /* @__PURE__ */ jsx(InternalErrorBoundary, { children: /* @__PURE__ */ jsx(UserLayout, {
+			route: currentRoute,
+			children: /* @__PURE__ */ jsx(Outlet, {})
+		}) })
+	});
 	if (collectionsData) return /* @__PURE__ */ jsx(CollectionsContext.Provider, {
 		value: collectionsData,
 		children: content
@@ -2032,15 +2146,15 @@ function buildDocRoutes(options) {
 					moduleKey,
 					moduleLoader: mod,
 					route,
-					components
+					components: components ?? {}
 				}, moduleKey || path);
 			} };
 		};
 		else routeRecord.element = /* @__PURE__ */ jsx(EagerMdxElement, {
 			moduleKey,
-			moduleLoader,
+			moduleLoader: moduleLoader ?? {},
 			route,
-			components
+			components: components ?? {}
 		}, moduleKey || path);
 		return routeRecord;
 	});
@@ -2139,6 +2253,15 @@ function buildDocRoutes(options) {
 	};
 }
 
+//#endregion
+//#region src/client/ssg/external-page-wrapper.tsx
+function ExternalPageWrapper({ children }) {
+	return /* @__PURE__ */ jsx("div", {
+		className: "boltdocs-external-content h-screen overflow-y-auto",
+		children
+	});
+}
+
 //#endregion
 //#region src/client/ssg/create-routes.external.tsx
 function buildExternalRoutes(options) {
@@ -2157,11 +2280,12 @@ function buildExternalRoutes(options) {
 			locale: config.i18n?.defaultLocale,
 			title: rawPath === "/" ? "Home" : rawPath.replace(/^\//, "").split("/").pop() || "Page",
 			filePath: "",
+			componentPath: "",
 			headings: []
 		});
 		children.push({
 			path,
-			element: /* @__PURE__ */ jsx(EffectiveExternalLayout, { children: /* @__PURE__ */ jsx(ExtComponent, {}) }),
+			element: /* @__PURE__ */ jsx(ExternalPageWrapper, { children: /* @__PURE__ */ jsx(EffectiveExternalLayout, { children: /* @__PURE__ */ jsx(ExtComponent, {}) }) }),
 			loader: async () => ({
 				path,
 				locale: config.i18n?.defaultLocale
@@ -2175,11 +2299,12 @@ function buildExternalRoutes(options) {
 				locale,
 				title: rawPath,
 				filePath: "",
+				componentPath: "",
 				headings: []
 			});
 			children.push({
 				path: localePath,
-				element: /* @__PURE__ */ jsx(EffectiveExternalLayout, { children: /* @__PURE__ */ jsx(ExtComponent, {}) }),
+				element: /* @__PURE__ */ jsx(ExternalPageWrapper, { children: /* @__PURE__ */ jsx(EffectiveExternalLayout, { children: /* @__PURE__ */ jsx(ExtComponent, {}) }) }),
 				loader: async () => ({
 					path: localePath,
 					locale
@@ -2194,21 +2319,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 } = useRoutes();
+	const config = useConfig();
+	const posts = data[collection] || [];
+	const defaultLocale = config.i18n?.defaultLocale;
+	const defaultVersion = config.versions?.defaultVersion;
+	return 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 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 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 useMemo(() => posts.slice(0, count), [posts, count]);
+}
+
 //#endregion
 //#region src/client/ssg/create-routes.collection.tsx
 function DefaultCollectionList() {
-	const data = useLoaderData();
-	if (!data || !data.posts) return null;
+	const location = useLocation$1();
+	const config = 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__ */ jsxs("div", {
 		className: "py-8 max-w-2xl mx-auto px-4",
 		children: [
 			/* @__PURE__ */ jsx("h1", {
 				className: "text-3xl font-bold mb-6 capitalize",
-				children: data.collection
+				children: collection
 			}),
 			/* @__PURE__ */ jsx("div", {
 				className: "space-y-6",
-				children: data.posts.map((post) => /* @__PURE__ */ jsxs("article", {
+				children: posts.map((post) => /* @__PURE__ */ jsxs("article", {
 					className: "border-b border-subtle pb-4",
 					children: [
 						/* @__PURE__ */ jsx("h2", {
@@ -2230,22 +2441,22 @@ function DefaultCollectionList() {
 					]
 				}, post.path))
 			}),
-			data.totalPages > 1 && /* @__PURE__ */ jsxs("div", {
+			totalPages > 1 && /* @__PURE__ */ jsxs("div", {
 				className: "mt-8 flex gap-4 text-sm",
 				children: [
-					data.currentPage > 1 && /* @__PURE__ */ jsx(Link, {
-						to: data.currentPage === 2 ? `/${data.collection}` : `/${data.collection}/page/${data.currentPage - 1}`,
+					currentPage > 1 && /* @__PURE__ */ jsx(Link, {
+						to: currentPage === 2 ? basePath : `${basePath}/page/${currentPage - 1}`,
 						className: "text-primary-600 hover:underline",
 						children: "Previous"
 					}),
 					/* @__PURE__ */ jsxs("span", { children: [
 						"Page ",
-						data.currentPage,
+						currentPage,
 						" of ",
-						data.totalPages
+						totalPages
 					] }),
-					data.currentPage < data.totalPages && /* @__PURE__ */ jsx(Link, {
-						to: `/${data.collection}/page/${data.currentPage + 1}`,
+					currentPage < totalPages && /* @__PURE__ */ jsx(Link, {
+						to: `${basePath}/page/${currentPage + 1}`,
 						className: "text-primary-600 hover:underline",
 						children: "Next"
 					})
@@ -2336,6 +2547,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;
@@ -2393,7 +2607,7 @@ function createRoutes(options) {
 		...collectionRoutes.children,
 		{
 			path: "*",
-			element: /* @__PURE__ */ jsx(EffectiveExternalLayout, { children: /* @__PURE__ */ jsx(NotFoundWrapper, {}) })
+			element: /* @__PURE__ */ jsx(ExternalPageWrapper, { children: /* @__PURE__ */ jsx(EffectiveExternalLayout, { children: /* @__PURE__ */ jsx(NotFoundWrapper, {}) }) })
 		}
 	];
 	return [{
@@ -2413,21 +2627,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 } = useRoutes();
 	const config = useConfig();
-	const AskAiDialog = useMergedComponents().AskAiDialog;
-	const [isAskAiOpen, setIsAskAiOpen] = useState(false);
-	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);
-		};
-	}, []);
 	return /* @__PURE__ */ jsxs(DocsLayout$1, {
 		className: "selection:bg-primary-500/10 selection:text-primary-500",
 		children: [/* @__PURE__ */ jsx(Navbar, {}), /* @__PURE__ */ jsxs(DocsLayout$1.Body, {
@@ -2437,97 +2647,46 @@ function DocsLayoutComponent({ children }) {
 					routes: filteredRoutes || [],
 					config
 				}),
-				/* @__PURE__ */ jsx(DocsLayout$1.Content, {
-					className: "animate-in fade-in duration-500 scroll-smooth",
-					children: /* @__PURE__ */ jsxs(DocsLayout$1.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__ */ jsxs(DocsLayout$1.Header, { children: [
-								/* @__PURE__ */ jsxs("div", {
-									className: "mb-4 border-b border-subtle pb-4 flex flex-wrap items-center justify-between gap-3",
-									children: [/* @__PURE__ */ jsx(Breadcrumbs, {}), /* @__PURE__ */ jsx(CopyMarkdown, {
-										mdxRaw: currentRoute?._rawContent,
-										route: currentRoute
-									})]
-								}),
-								currentRoute?.title && /* @__PURE__ */ jsx("h1", {
-									className: "text-4xl font-bold tracking-tight text-default mb-3",
-									children: currentRoute.title
-								}),
-								currentRoute?.description && /* @__PURE__ */ jsx("p", {
-									className: "text-lg text-muted-foreground mb-6 leading-relaxed",
-									children: currentRoute.description
-								})
-							] }),
-							/* @__PURE__ */ jsx(ErrorBoundary, { children: /* @__PURE__ */ jsx("div", {
-								className: "prose prose-neutral dark:prose-invert max-w-none",
-								children
-							}) }),
-							!isCollectionPage && /* @__PURE__ */ jsx(Feedback, {}),
-							!isCollectionPage && /* @__PURE__ */ jsx(Giscus, {}),
-							/* @__PURE__ */ jsx(DocsLayout$1.Footer, { children: !isCollectionPage && /* @__PURE__ */ jsx(PageNav, {}) })
-						]
+				/* @__PURE__ */ jsx(DocsLayout$1.Content, { children: /* @__PURE__ */ jsxs(DocsLayout$1.ContentMdx, { children: [
+					!isCollectionPage && /* @__PURE__ */ jsxs(DocsLayout$1.Header, { children: [
+						/* @__PURE__ */ jsxs("div", {
+							className: "mb-4 border-b border-subtle pb-4 flex flex-wrap items-center justify-between gap-3",
+							children: [/* @__PURE__ */ jsx(Breadcrumbs, {}), /* @__PURE__ */ jsx(CopyMarkdown, {
+								mdxRaw: currentRoute?._rawContent,
+								route: currentRoute
+							})]
+						}),
+						currentRoute?.title && /* @__PURE__ */ jsx("h1", {
+							className: "text-4xl font-bold tracking-tight text-default mb-3",
+							children: currentRoute.title
+						}),
+						currentRoute?.description && /* @__PURE__ */ jsx("p", {
+							className: "text-lg text-muted-foreground mb-6 leading-relaxed",
+							children: currentRoute.description
+						})
+					] }),
+					/* @__PURE__ */ jsx(ErrorBoundary, { children: /* @__PURE__ */ jsx("div", {
+						className: "prose prose-neutral dark:prose-invert max-w-none",
+						children
+					}) }),
+					!isCollectionPage && /* @__PURE__ */ jsx(Feedback, {}),
+					!isCollectionPage && /* @__PURE__ */ jsx(Giscus, {}),
+					/* @__PURE__ */ jsx(DocsLayout$1.Footer, { children: !isCollectionPage && /* @__PURE__ */ jsx(PageNav, {}) })
+				] }) }),
+				/* @__PURE__ */ jsx("div", {
+					className: "overflow-y-auto sticky",
+					children: /* @__PURE__ */ jsx(OnThisPage, {
+						headings: currentRoute?.headings,
+						filePath: currentRoute?.filePath,
+						communityHelp: config.theme?.communityHelp,
+						editLink: config.theme?.editLink
 					})
-				}),
-				AskAiDialog && /* @__PURE__ */ jsx(AskAiDialog, {}),
-				!isCollectionPage && !isAskAiOpen && /* @__PURE__ */ 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 } = useRoutes();
-	const config = useConfig();
-	const posts = data[collection] || [];
-	const defaultLocale = config.i18n?.defaultLocale;
-	const defaultVersion = config.versions?.defaultVersion;
-	return 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 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 useMemo(() => posts.slice(0, count), [posts, count]);
-}
-
 //#endregion
 //#region src/client/utils/react-to-text.ts
 const reactToText = (node, resolvers) => {
@@ -2543,4 +2702,4 @@ const reactToText = (node, resolvers) => {
 };
 
 //#endregion
-export { Banner, BoltdocsShell, Breadcrumbs, CollectionsContext, CopyMarkdown, DocsLayoutComponent as DocsLayout, ErrorBoundary, MdxPage, Navbar, NotFound, OnThisPage, PageNav, SearchDialog, Sidebar, ViteReactSSG, cn, copyToClipboard, createRoutes, getStarsRepo, getTranslated, reactToText, useAnalytics, useBreadcrumbs, useCodeBlock, useConfig, useFeedback, useHeadings, useI18n, useLocalizedTo, useLocation, useMdxComponents, useMergedComponents, useNavbar, usePageNav, usePost, usePosts, useRecentPosts, useRoutes, useSearch, useSearchHighlight, useSidebar, useTabs, useTheme, useTrackEvent, useTrackPageView, useUI, useVersion };
+export { Banner, BoltdocsShell, Breadcrumbs, CollectionsContext, CopyMarkdown, CurrentPostProvider, DocsLayoutComponent as DocsLayout, ErrorBoundary, MdxPage, Navbar, NotFound, OnThisPage, PageNav, SearchDialog, Sidebar, Timeline, ViteReactSSG, cn, copyToClipboard, createRoutes, getStarsRepo, getTranslated, reactToText, useAnalytics, useBreadcrumbs, useCodeBlock, useConfig, useFeedback, useHeadings, useI18n, useLocalizedTo, useLocation, useMdxComponents, useMergedComponents, useNavbar, usePageNav, usePost, usePosts, useRecentPosts, useRoutes, useSearch, useSearchHighlight, useSidebar, useTabs, useTheme, useTrackEvent, useTrackPageView, useUI, useVersion };