boltdocs 2.7.11 → 2.8.0

package/dist/client/index.js

@@ -3,51 +3,321 @@
  * Copyright (c) 2026 Jesus Alcala
  * Licensed under the MIT License.
  */
-import { $ as useBoltdocsContext, B as Menu, C as ArrowLeft, F as Home, H as Moon, J as X, K as Sun, L as Languages, O as CircleHelp, Q as BoltdocsProvider, T as ChevronDown, V as Monitor, W as Pencil, X as useRoutes, Y as icons_exports, Z as normalizePath$1, _ as Link, b as useLocalizedTo, et as RoutesProvider, j as ExternalLink, k as Copy, nt as useConfig, q as TextAlignStart, s as Github, tt as ConfigContext, w as Check, y as cn } from "../icons-dev-Df8OQ481.js";
-import { D as ErrorBoundary$1, E as Tabs$1, M as Button$1, N as Breadcrumbs$2, T as useUI, _ as OnThisPage$1, h as PageNav$1, i as Sidebar$1, j as ButtonGroup, k as Menu$1, m as useSidebar, n as useSearchHighlight, r as useLocation, t as DocsLayout$2, w as UIProvider } from "../docs-layout-DwFndmj5.js";
-import { c as ThemeProvider, l as useTheme } from "../image-jxPb-2iV.js";
-import { n as Navbar$1 } from "../search-dialog-BNF10tDl.js";
-import { n as useSearch, t as SearchDialog } from "../search-dialog-D-DDN7zJ.js";
-import { a as reactToText, i as copyToClipboard, n as Cards, r as Card, t as mdx_components_default } from "../mdx-UTTLFWJq.js";
+import { $ as ConfigContext, B as Languages, C as RoutesProvider, D as Check, E as ArrowLeft, G as Moon, M as Copy, O as ChevronDown, P as ExternalLink, Q as icons_exports, R as Home, S as normalizePath, U as Menu, W as Monitor, X as TextAlignStart, Y as Sun, Z as X, _ as Link$1, b as useLocalizedTo, et as useConfig, j as CircleHelp, nt as useBoltdocsContext, q as Pencil, s as Github, tt as BoltdocsProvider, x as useRoutes, y as cn } from "../icons-dev-Oju24Wjp.js";
+import { c as ThemeProvider, l as useTheme } from "../image-Do8V9PCW.js";
+import { n as copyToClipboard, t as mdx_components_default } from "../mdx-D3A2_l7P.js";
+import { A as useUI, D as ButtonGroup, O as Breadcrumbs$2, T as Menu$1, _ as OnThisPage$1, h as PageNav$1, i as Sidebar$1, k as UIProvider, m as useSidebar, n as useSearchHighlight, r as useLocation, t as DocsLayout$1, w as Tabs$1 } from "../docs-layout-Dn6S5g59.js";
+import { a as Button$1, n as Navbar$1, r as ErrorBoundary$1 } from "../search-dialog-D8gLkhUV.js";
+import { n as useSearch, r as InternalErrorBoundary, t as SearchDialog } from "../search-dialog-C09riYmx.js";
 import { ViteReactSSG } from "@bdocs/ssg";
-import { Outlet, useLoaderData, useLocation as useLocation$1, useNavigate } from "react-router-dom";
-import { Suspense, createContext, lazy, use, useCallback, useEffect, useLayoutEffect, useMemo, useRef, useState } from "react";
+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 { Button } from "react-aria-components";
-import virtualIcons from "virtual:boltdocs-icons";
 import * as ReactHelmetAsync from "react-helmet-async";
+import { Button } from "react-aria-components";
 import virtualCustomComponents from "virtual:boltdocs-mdx-components";
+import virtualIcons from "virtual:boltdocs-icons";
 import UserLayout from "virtual:boltdocs-layout";
 
 //#region src/client/app/mdx-components-context.tsx
 const MDX_COMPONENTS_CONTEXT_SYMBOL = Symbol.for("__BDOCS_MDX_COMPONENTS_CONTEXT__");
-const MDX_COMPONENTS_INSTANCE_SYMBOL = Symbol.for("__BDOCS_MDX_COMPONENTS_INSTANCE__");
-const MdxComponentsContext = globalThis[MDX_COMPONENTS_CONTEXT_SYMBOL] || (globalThis[MDX_COMPONENTS_CONTEXT_SYMBOL] = createContext({}));
+const registry = globalThis;
+if (!registry[MDX_COMPONENTS_CONTEXT_SYMBOL]) registry[MDX_COMPONENTS_CONTEXT_SYMBOL] = createContext({});
+const MdxComponentsContext = registry[MDX_COMPONENTS_CONTEXT_SYMBOL];
 function useMdxComponents() {
-	const context = use(MdxComponentsContext);
-	if ((!context || Object.keys(context).length === 0) && globalThis[MDX_COMPONENTS_INSTANCE_SYMBOL]) return globalThis[MDX_COMPONENTS_INSTANCE_SYMBOL];
-	return context;
+	return use(MdxComponentsContext);
 }
 function MdxComponentsProvider({ components, children }) {
 	const processedComponents = useMemo(() => {
 		const processed = {};
 		const frontmatter = {};
+		let hasFrontmatter = false;
 		Object.entries(components).forEach(([key, value]) => {
 			if (key.startsWith("Frontmatter_")) {
 				const cleanKey = key.slice(12);
 				frontmatter[cleanKey] = value;
+				hasFrontmatter = true;
 			} else processed[key] = value;
 		});
-		processed.Frontmatter = frontmatter;
+		if (hasFrontmatter) processed.Frontmatter = frontmatter;
 		return processed;
 	}, [components]);
-	if (typeof globalThis !== "undefined") globalThis[MDX_COMPONENTS_INSTANCE_SYMBOL] = processedComponents;
 	return /* @__PURE__ */ jsx(MdxComponentsContext.Provider, {
 		value: processedComponents,
 		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
+/**
+* Handles scroll restoration and hash scrolling on navigation.
+* It ensures the page scrolls to top on pathname changes,
+* or specifically to an anchor element if a hash is present.
+*/
+function ScrollHandler() {
+	const { pathname, hash } = useLocation$1();
+	const handleScroll = (behavior = "auto") => {
+		const container = document.querySelector(".boltdocs-content") || window;
+		const getScrollTop = () => {
+			if (container === window) return window.scrollY;
+			return container.scrollTop;
+		};
+		const scrollTo = (top, scrollBehavior) => {
+			if (container === window) window.scrollTo({
+				top,
+				behavior: scrollBehavior
+			});
+			else container.scrollTo({
+				top,
+				behavior: scrollBehavior
+			});
+		};
+		if (hash) {
+			const id = hash.replace("#", "");
+			const element = document.getElementById(id);
+			if (element) {
+				const offset = 80;
+				const containerTop = container === window ? 0 : container.getBoundingClientRect().top;
+				scrollTo(element.getBoundingClientRect().top - containerTop - offset + getScrollTop(), behavior);
+				return true;
+			}
+		}
+		scrollTo(0, behavior);
+		return false;
+	};
+	useLayoutEffect(() => {
+		handleScroll("auto");
+	}, [pathname, hash]);
+	useEffect(() => {
+		handleScroll("auto");
+		const rafId = requestAnimationFrame(() => {
+			handleScroll("auto");
+			window.dispatchEvent(new Event("resize"));
+		});
+		return () => cancelAnimationFrame(rafId);
+	}, [pathname, hash]);
+	return null;
+}
+
+//#endregion
+//#region src/client/components/ui-base/not-found.tsx
+function NotFound() {
+	return /* @__PURE__ */ jsx("div", {
+		className: "flex items-center justify-center min-h-[65vh] text-center px-4",
+		children: /* @__PURE__ */ jsxs("div", {
+			className: "space-y-6 max-w-md mx-auto p-8 border border-subtle bg-surface rounded-2xl shadow-xs",
+			children: [
+				/* @__PURE__ */ jsx("span", {
+					className: "block text-7xl font-extrabold tracking-tight text-primary-500",
+					children: "404"
+				}),
+				/* @__PURE__ */ jsxs("div", {
+					className: "space-y-2",
+					children: [/* @__PURE__ */ jsx("h1", {
+						className: "text-xl font-bold text-body",
+						children: "Page Not Found"
+					}), /* @__PURE__ */ jsx("p", {
+						className: "text-sm text-muted leading-relaxed",
+						children: "The page you're looking for doesn't exist or has been moved."
+					})]
+				}),
+				/* @__PURE__ */ jsxs(Link$1, {
+					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__ */ jsx(ArrowLeft, { size: 14 }), " Go to Home"]
+				})
+			]
+		})
+	});
+}
+
+//#endregion
+//#region src/client/app/mdx-component.tsx
+const mdxComponentsDefault = {
+	...mdx_components_default,
+	NotFound,
+	"404": NotFound
+};
+
+//#endregion
+//#region src/client/ssg/boltdocs-shell.tsx
+/**
+* Updates the HTML lang and dir attributes based on the current locale configuration.
+*/
+function I18nUpdater({ config }) {
+	const { currentLocale } = useBoltdocsContext();
+	useEffect(() => {
+		if (!config.i18n || typeof document === "undefined") return;
+		const locale = currentLocale || config.i18n.defaultLocale;
+		const localeConfig = config.i18n.localeConfigs?.[locale];
+		document.documentElement.lang = localeConfig?.htmlLang || locale || "en";
+		document.documentElement.dir = localeConfig?.direction || "ltr";
+	}, [currentLocale, config.i18n]);
+	return null;
+}
+function StoreSync({ config, routeMap }) {
+	const location = useLocation$1();
+	const { setLocale, setVersion } = useBoltdocsContext();
+	useEffect(() => {
+		const currentPath = normalizePath(location.pathname);
+		const matchedRoute = routeMap.get(currentPath);
+		if (matchedRoute) {
+			if (config.i18n) setLocale(matchedRoute.locale || config.i18n.defaultLocale);
+			if (config.versions) setVersion(matchedRoute.version || config.versions.defaultVersion);
+		}
+	}, [
+		location.pathname,
+		config,
+		routeMap,
+		setLocale,
+		setVersion
+	]);
+	return null;
+}
+function BoltdocsShell({ config, routes, components = {} }) {
+	const allComponents = useMemo(() => ({
+		...mdxComponentsDefault,
+		...virtualCustomComponents,
+		...components
+	}), [components]);
+	const { pathname } = useLocation$1();
+	const currentPath = useMemo(() => normalizePath(pathname || "/"), [pathname]);
+	const routeMap = useMemo(() => {
+		const map = /* @__PURE__ */ new Map();
+		for (const r of routes) {
+			const key = normalizePath(r.path === "" ? "/" : r.path);
+			map.set(key, r);
+		}
+		return map;
+	}, [routes]);
+	const initialData = useMemo(() => {
+		const matched = routeMap.get(currentPath);
+		let initLocale;
+		let initVersion;
+		if (matched) {
+			if (config.i18n) initLocale = matched.locale || config.i18n.defaultLocale;
+			if (config.versions) initVersion = matched.version || config.versions.defaultVersion;
+		}
+		return {
+			initLocale,
+			initVersion
+		};
+	}, [
+		currentPath,
+		config,
+		routeMap
+	]);
+	return /* @__PURE__ */ jsx(HelmetProvider, { children: /* @__PURE__ */ jsx(RoutesProvider, {
+		routes,
+		children: /* @__PURE__ */ jsx(ThemeProvider, { children: /* @__PURE__ */ jsx(UIProvider, { children: /* @__PURE__ */ jsx(MdxComponentsProvider, {
+			components: allComponents,
+			children: /* @__PURE__ */ jsxs(ConfigContext.Provider, {
+				value: config,
+				children: [/* @__PURE__ */ jsx(ScrollHandler, {}), /* @__PURE__ */ jsxs(BoltdocsProvider, {
+					initialLocale: initialData.initLocale,
+					initialVersion: initialData.initVersion,
+					children: [
+						/* @__PURE__ */ jsx(StoreSync, {
+							config,
+							routeMap
+						}),
+						/* @__PURE__ */ jsx(I18nUpdater, { config }),
+						/* @__PURE__ */ jsx(InternalErrorBoundary, { children: /* @__PURE__ */ jsx(Outlet, {}) })
+					]
+				})]
+			})
+		}) }) })
+	}) });
+}
+
+//#endregion
+//#region src/client/hooks/use-merged-components.ts
+function useMergedComponents(propComponents) {
+	const contextComponents = useMdxComponents();
+	return useMemo(() => {
+		if (!propComponents) return contextComponents;
+		const merged = { ...contextComponents };
+		const mergedFrontmatter = { ...contextComponents.Frontmatter || {} };
+		let hasPropFrontmatter = false;
+		Object.entries(propComponents).forEach(([key, value]) => {
+			if (key.startsWith("Frontmatter_")) {
+				const cleanKey = key.slice(12);
+				mergedFrontmatter[cleanKey] = value;
+				hasPropFrontmatter = true;
+			} else if (key === "Frontmatter" && value && typeof value === "object") {
+				Object.assign(mergedFrontmatter, value);
+				hasPropFrontmatter = true;
+			} else merged[key] = value;
+		});
+		if (hasPropFrontmatter || contextComponents.Frontmatter) merged.Frontmatter = mergedFrontmatter;
+		return merged;
+	}, [contextComponents, propComponents]);
+}
+
+//#endregion
+//#region src/client/app/doc-page.tsx
+/**
+* DocPage renders the MDX content and page-specific metadata.
+* It is rendered inside the Outlet of DocsLayout.
+*/
+function DocPage({ route, content: Content, mdxComponents: propComponents }) {
+	const allComponents = useMergedComponents(propComponents);
+	const { LastUpdated } = allComponents;
+	if (!Content) return null;
+	return /* @__PURE__ */ jsxs(Fragment, { children: [/* @__PURE__ */ jsx(Content, { components: allComponents }), route?.lastUpdated && /* @__PURE__ */ jsx(LastUpdated, { date: route.lastUpdated })] });
+}
+
+//#endregion
+//#region src/client/ssg/mdx-page.tsx
+/**
+* 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.
+* - 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 docData = data;
+	return /* @__PURE__ */ jsx(DocPage, {
+		route: {
+			path: docData.path,
+			filePath: docData.filePath,
+			title: docData.frontmatter?.title,
+			description: docData.frontmatter?.description,
+			headings: docData.headings,
+			locale: docData.locale,
+			version: docData.version,
+			group: docData.group,
+			groupTitle: docData.groupTitle,
+			lastUpdated: docData.lastUpdated,
+			frontmatter: docData.frontmatter
+		},
+		content: MDXComponent,
+		mdxComponents: propComponents
+	});
+}
+
 //#endregion
 //#region src/client/hooks/use-breadcrumbs.ts
 /**
@@ -98,10 +368,20 @@ function Breadcrumbs() {
 //#region src/client/components/ui-base/copy-markdown.tsx
 const useCopyMarkdown = (content) => {
 	const [copied, setCopied] = useState(false);
+	const timerRef = useRef(null);
+	useEffect(() => {
+		return () => {
+			if (timerRef.current) clearTimeout(timerRef.current);
+		};
+	}, []);
 	const handleCopy = () => {
 		navigator.clipboard.writeText(content);
 		setCopied(true);
-		setTimeout(() => setCopied(false), 2e3);
+		if (timerRef.current) clearTimeout(timerRef.current);
+		timerRef.current = setTimeout(() => {
+			setCopied(false);
+			timerRef.current = null;
+		}, 2e3);
 	};
 	const handleOpenRaw = () => {
 		const blob = new Blob([content], { type: "text/plain;charset=utf-8" });
@@ -426,8 +706,8 @@ function useTabs(tabs = [], routes = []) {
 		transform: "translateX(0) scaleX(0)",
 		width: 0
 	});
-	const currentPath = normalizePath$1(location.pathname);
-	const activeTabId = routes.find((r) => normalizePath$1(r.path) === currentPath)?.tab?.toLowerCase();
+	const currentPath = normalizePath(location.pathname);
+	const activeTabId = routes.find((r) => normalizePath(r.path) === currentPath)?.tab?.toLowerCase();
 	const activeIndex = tabs.findIndex((tab) => tab.id.toLowerCase() === activeTabId);
 	const finalActiveIndex = activeIndex === -1 ? 0 : activeIndex;
 	useEffect(() => {
@@ -485,11 +765,11 @@ function Tabs({ tabs, routes }) {
 	return /* @__PURE__ */ jsx("div", {
 		className: "mx-auto max-w-(--breakpoint-3xl) px-4 md:px-6 select-none",
 		children: /* @__PURE__ */ jsxs(Tabs$1.List, {
-			className: "border-none py-0 scrollbar-hide relative flex flex-row items-center",
+			className: "border-none py-0 scrollbar-hide relative flex flex-row items-center overflow-x-auto",
 			children: [tabs.map((tab, index) => {
 				const isActive = index === activeIndex;
 				const firstRoute = routes.find((r) => r.tab && r.tab.toLowerCase() === tab.id.toLowerCase());
-				return /* @__PURE__ */ jsxs(Link, {
+				return /* @__PURE__ */ jsxs(Link$1, {
 					href: firstRoute ? firstRoute.path : "#",
 					ref: (el) => {
 						tabRefs.current[index] = el;
@@ -554,7 +834,7 @@ function useVersion() {
 		currentVersion,
 		currentVersionLabel: (versions?.versions?.find?.((v) => v.path === currentVersion))?.label || currentVersion,
 		availableVersions: useMemo(() => {
-			return versions ? versions.versions.map((v) => ({
+			return versions?.versions ? versions.versions.map((v) => ({
 				key: v.path,
 				label: v.label,
 				value: v.path,
@@ -693,15 +973,14 @@ function I18nSelector({ className }) {
 
 //#endregion
 //#region src/client/components/ui-base/navbar.tsx
-const SearchDialog$1 = lazy(() => import("../search-dialog-BHuIiUC6.js").then((m) => ({ default: m.SearchDialog })));
+const SearchDialog$1 = lazy(() => import("../search-dialog-DHc_8FFX.js").then((m) => ({ default: m.SearchDialog })));
 function Navbar() {
 	const { links, title, logo, logoProps, github, social, config } = useNavbar();
-	const { routes, allRoutes, currentRoute, currentVersion, currentLocale } = useRoutes();
-	const { pathname } = useLocation$1();
+	const { routes, currentRoute, isCollectionPage, currentVersion, currentLocale } = useRoutes();
 	const { isSidebarOpen, toggleSidebar } = useUI();
 	const [isMobileMenuOpen, setIsMobileMenuOpen] = useState(false);
 	const themeConfig = config.theme || {};
-	const isDocs = !!currentRoute?.filePath;
+	const isDocs = !!currentRoute?.filePath && !isCollectionPage;
 	const hasTabs = themeConfig?.tabs && themeConfig.tabs.length > 0;
 	return /* @__PURE__ */ jsxs(Navbar$1.Root, {
 		className: cn("border-b border-subtle bg-main/80 backdrop-blur-md", hasTabs && "border-b-0"),
@@ -802,7 +1081,7 @@ function Navbar() {
 				className: "w-full border-b border-subtle bg-main",
 				children: /* @__PURE__ */ jsx(Tabs, {
 					tabs: themeConfig.tabs,
-					routes: allRoutes || routes || []
+					routes: routes || []
 				})
 			})
 		]
@@ -855,38 +1134,6 @@ function NavbarMobileLinkItem({ link, onClose }) {
 	});
 }
 
-//#endregion
-//#region src/client/components/ui-base/not-found.tsx
-function NotFound() {
-	return /* @__PURE__ */ jsx("div", {
-		className: "flex items-center justify-center min-h-[65vh] text-center px-4",
-		children: /* @__PURE__ */ jsxs("div", {
-			className: "space-y-6 max-w-md mx-auto p-8 border border-subtle bg-surface rounded-2xl shadow-xs",
-			children: [
-				/* @__PURE__ */ jsx("span", {
-					className: "block text-7xl font-extrabold tracking-tight text-primary-500",
-					children: "404"
-				}),
-				/* @__PURE__ */ jsxs("div", {
-					className: "space-y-2",
-					children: [/* @__PURE__ */ jsx("h1", {
-						className: "text-xl font-bold text-body",
-						children: "Page Not Found"
-					}), /* @__PURE__ */ jsx("p", {
-						className: "text-sm text-muted leading-relaxed",
-						children: "The page you're looking for doesn't exist or has been moved."
-					})]
-				}),
-				/* @__PURE__ */ jsxs(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__ */ jsx(ArrowLeft, { size: 14 }), " Go to Home"]
-				})
-			]
-		})
-	});
-}
-
 //#endregion
 //#region src/client/components/ui-base/on-this-page.tsx
 function OnThisPage({ headings = [], editLink, communityHelp, filePath }) {
@@ -1037,249 +1284,71 @@ const Sidebar = Object.assign(SidebarMain, {
 });
 
 //#endregion
-//#region src/client/components/ui-base/last-updated.tsx
-/**
-* A subtle display for when the page was last updated.
-* Small, opaque, and positioned at the bottom of the content with a thin top border divider.
-*/
-function LastUpdated({ date }) {
-	if (!date) return null;
-	const d = new Date(date);
-	if (isNaN(d.getTime())) return null;
-	const formattedDate = d.toLocaleDateString(void 0, {
-		year: "numeric",
-		month: "long",
-		day: "numeric"
-	});
+//#region src/client/components/ui-base/banner.tsx
+function Banner({ children, className = "", dismissible = false, id = "boltdocs-banner", ...props }) {
+	const [isVisible, setIsVisible] = useState(true);
+	useEffect(() => {
+		if (dismissible && id) {
+			if (localStorage.getItem(`boltdocs-banner-dismissed-${id}`) === "true") setIsVisible(false);
+		}
+	}, [dismissible, id]);
+	const handleDismiss = () => {
+		setIsVisible(false);
+		if (dismissible && id) localStorage.setItem(`boltdocs-banner-dismissed-${id}`, "true");
+	};
+	if (!isVisible) return null;
 	return /* @__PURE__ */ jsxs("div", {
-		className: "mt-16 pt-6 border-t border-subtle flex items-center justify-between text-xs text-muted select-none",
-		children: [/* @__PURE__ */ jsx("span", {}), /* @__PURE__ */ jsxs("span", {
-			className: "italic",
-			children: ["Last updated on ", formattedDate]
+		className: 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__ */ jsx("div", {
+			className: "flex-1 text-center flex items-center justify-center gap-2",
+			children
+		}), dismissible && /* @__PURE__ */ jsx("button", {
+			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__ */ jsx(X, { className: "w-3.5 h-3.5" })
 		})]
 	});
 }
 
 //#endregion
-//#region src/client/app/doc-page.tsx
-/**
-* DocPage renders the MDX content and page-specific metadata.
-* It is rendered inside the Outlet of DocsLayout.
-*/
-function DocPage({ route, content: Content, mdxComponents: propComponents }) {
-	const contextComponents = useMdxComponents();
-	const allComponents = useMemo(() => ({
-		LastUpdated,
-		...contextComponents,
-		...propComponents
-	}), [contextComponents, propComponents]);
-	const LastUpdated$1 = allComponents.LastUpdated || LastUpdated;
-	if (!Content) return null;
-	return /* @__PURE__ */ jsxs(Fragment, { children: [/* @__PURE__ */ jsx(Content, { components: allComponents }), route?.lastUpdated && /* @__PURE__ */ jsx(LastUpdated$1, { date: route.lastUpdated })] });
-}
-
-//#endregion
-//#region src/client/ssg/mdx-page.tsx
-/**
-* Renders an MDX page by consuming pre-loaded module data.
-* Uses DocPage to ensure consistent layout and metadata application.
-*/
-function MdxPage({ MDXComponent: propMDX, mdxComponents: propComponents }) {
-	const data = useLoaderData();
-	const MDXComponent = propMDX || data?.MDXComponent;
-	const components = propComponents || data?.mdxComponents;
-	if (!MDXComponent) return null;
-	return /* @__PURE__ */ jsx(DocPage, {
-		route: {
-			path: data.path,
-			filePath: data.filePath,
-			title: data.frontmatter.title,
-			description: data.frontmatter.description,
-			headings: data.headings,
-			locale: data.locale,
-			version: data.version,
-			group: data.group,
-			groupTitle: data.groupTitle,
-			lastUpdated: data.lastUpdated,
-			frontmatter: data.frontmatter
-		},
-		content: MDXComponent,
-		mdxComponents: components
-	});
-}
-
-//#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
-/**
-* Handles scroll restoration and hash scrolling on navigation.
-* It ensures the page scrolls to top on pathname changes,
-* or specifically to an anchor element if a hash is present.
-*/
-function ScrollHandler() {
-	const { pathname, hash } = useLocation$1();
-	const handleScroll = (behavior = "auto") => {
-		const container = document.querySelector(".boltdocs-content") || window;
-		const getScrollTop = () => {
-			if (container === window) return window.scrollY;
-			return container.scrollTop;
-		};
-		const scrollTo = (top, scrollBehavior) => {
-			if (container === window) window.scrollTo({
-				top,
-				behavior: scrollBehavior
-			});
-			else container.scrollTo({
-				top,
-				behavior: scrollBehavior
-			});
-		};
-		if (hash) {
-			const id = hash.replace("#", "");
-			const element = document.getElementById(id);
-			if (element) {
-				const offset = 80;
-				const containerTop = container === window ? 0 : container.getBoundingClientRect().top;
-				scrollTo(element.getBoundingClientRect().top - containerTop - offset + getScrollTop(), behavior);
-				return true;
-			}
-		}
-		scrollTo(0, behavior);
-		return false;
-	};
-	useLayoutEffect(() => {
-		handleScroll("auto");
-	}, [pathname, hash]);
-	useEffect(() => {
-		handleScroll("auto");
-		const rafId = requestAnimationFrame(() => {
-			handleScroll("auto");
-			window.dispatchEvent(new Event("resize"));
-		});
-		return () => cancelAnimationFrame(rafId);
-	}, [pathname, hash]);
-	return null;
-}
-
-//#endregion
-//#region src/client/app/mdx-component.tsx
-const mdxComponentsDefault = {
-	...mdx_components_default,
-	NotFound,
-	"404": NotFound
-};
-
-//#endregion
-//#region src/client/ssg/boltdocs-shell.tsx
-/** Normalize a path: strip trailing slash unless it is exactly '/'. */
-function normalizePath(p) {
-	return p.endsWith("/") && p.length > 1 ? p.slice(0, -1) : p;
+//#region src/client/ssg/mdx-elements.tsx
+const Loading = () => /* @__PURE__ */ jsx("div", {
+	className: "text-muted text-sm py-4",
+	children: "Loading..."
+});
+function resolveModuleLoader(loader) {
+	return typeof loader === "function" ? loader() : Promise.resolve(loader);
 }
-/**
-* Updates the HTML lang and dir attributes based on the current locale configuration.
-*/
-function I18nUpdater({ config }) {
-	const { currentLocale } = useBoltdocsContext();
+const EagerMdxElement = ({ moduleLoader, moduleKey, route, components, collectionPostComponent }) => {
+	const [mod, setMod] = useState(moduleLoader);
 	useEffect(() => {
-		if (!config.i18n || typeof document === "undefined") return;
-		const locale = currentLocale || config.i18n.defaultLocale;
-		const localeConfig = config.i18n.localeConfigs?.[locale];
-		document.documentElement.lang = localeConfig?.htmlLang || locale || "en";
-		document.documentElement.dir = localeConfig?.direction || "ltr";
-	}, [currentLocale, config.i18n]);
-	return null;
-}
-/**
-* Synchronizes the Zustand store with the current URL pathname.
-* Receives a pre-built Map for O(1) route lookups instead of O(n) .find().
-*/
-function StoreSync({ config, routeMap }) {
-	const location = useLocation$1();
-	const { setLocale, setVersion } = useBoltdocsContext();
+		setMod(moduleLoader);
+	}, [moduleLoader]);
 	useEffect(() => {
-		const currentPath = normalizePath(location.pathname);
-		const matchedRoute = routeMap.get(currentPath);
-		if (matchedRoute) {
-			if (config.i18n) setLocale(matchedRoute.locale || config.i18n.defaultLocale);
-			if (config.versions) setVersion(matchedRoute.version || config.versions.defaultVersion);
-		}
-	}, [
-		location.pathname,
-		config,
-		routeMap,
-		setLocale,
-		setVersion
-	]);
-	return null;
-}
-function BoltdocsShell({ config, routes, components = {} }) {
-	const allComponents = useMemo(() => ({
-		...mdxComponentsDefault,
-		...virtualCustomComponents,
-		...components
-	}), [components]);
-	const { pathname } = useLocation$1();
-	const currentPath = useMemo(() => normalizePath(pathname || "/"), [pathname]);
-	const routeMap = useMemo(() => {
-		const map = /* @__PURE__ */ new Map();
-		for (const r of routes) {
-			const key = normalizePath(r.path === "" ? "/" : r.path);
-			map.set(key, r);
-		}
-		return map;
-	}, [routes]);
-	const initialData = useMemo(() => {
-		const matched = routeMap.get(currentPath);
-		let initLocale = void 0;
-		let initVersion = void 0;
-		if (matched) {
-			if (config.i18n) initLocale = matched.locale || config.i18n.defaultLocale;
-			if (config.versions) initVersion = matched.version || config.versions.defaultVersion;
-		}
-		return {
-			initLocale,
-			initVersion
+		if (!import.meta.hot || !moduleKey) return;
+		const handler = (data) => {
+			if (data.relPath.replace(/\\/g, "/").replace(/^\//, "") !== route.filePath.replace(/\\/g, "/").replace(/^\//, "")) return;
+			import(moduleKey + "?t=" + Date.now()).then((m) => {
+				setMod(m);
+			});
 		};
-	}, [
-		currentPath,
-		config,
-		routeMap
-	]);
-	return /* @__PURE__ */ jsx(HelmetProvider, { children: /* @__PURE__ */ jsx(RoutesProvider, {
-		routes,
-		children: /* @__PURE__ */ jsx(ThemeProvider, { children: /* @__PURE__ */ jsx(UIProvider, { children: /* @__PURE__ */ jsx(MdxComponentsProvider, {
-			components: allComponents,
-			children: /* @__PURE__ */ jsxs(ConfigContext.Provider, {
-				value: config,
-				children: [/* @__PURE__ */ jsx(ScrollHandler, {}), /* @__PURE__ */ jsxs(BoltdocsProvider, {
-					initialLocale: initialData.initLocale,
-					initialVersion: initialData.initVersion,
-					children: [
-						/* @__PURE__ */ jsx(StoreSync, {
-							config,
-							routeMap
-						}),
-						/* @__PURE__ */ jsx(I18nUpdater, { config }),
-						/* @__PURE__ */ jsx(Outlet, {})
-					]
-				})]
-			})
-		}) }) })
-	}) });
-}
+		import.meta.hot.on("boltdocs:mdx-update", handler);
+		return () => import.meta.hot?.off("boltdocs:mdx-update", handler);
+	}, [moduleKey, route.filePath]);
+	const MDXComponent = mod?.default ?? mod ?? null;
+	if (!MDXComponent) return /* @__PURE__ */ jsx(Loading, {});
+	return /* @__PURE__ */ jsx(MdxPage, {
+		MDXComponent,
+		mdxComponents: components,
+		collectionPostComponent
+	});
+};
+const NotFoundWrapper = () => {
+	const components = useMdxComponents();
+	return /* @__PURE__ */ jsx(components.NotFound || components["404"] || NotFound, {});
+};
 
 //#endregion
 //#region src/client/app/head.tsx
@@ -1294,6 +1363,8 @@ function Head({ siteTitle, siteDescription, routes }) {
 	const translatedSiteTitle = getTranslated(siteTitle, currentLocale);
 	const finalTitle = pageTitle ? `${pageTitle} | ${translatedSiteTitle}` : translatedSiteTitle;
 	const seo = currentRoute?.seo || {};
+	const canonicalUrl = seo.canonical || (config?.siteUrl && currentRoute?.path ? `${config.siteUrl.replace(/\/$/, "")}${currentRoute.path}` : void 0);
+	const ogUrl = seo["og:url"] || canonicalUrl || (typeof window !== "undefined" ? window.location.href : void 0);
 	const globalMetatags = config?.seo?.metatags || {};
 	const defaultOgImage = config?.seo?.thumbnails?.background;
 	const ogImage = seo["og:image"] || defaultOgImage;
@@ -1315,13 +1386,13 @@ function Head({ siteTitle, siteDescription, routes }) {
 			property: "og:type",
 			content: "article"
 		}),
-		typeof window !== "undefined" && /* @__PURE__ */ jsx("meta", {
-			property: "og:url",
-			content: window.location.href
-		}),
-		typeof window !== "undefined" && /* @__PURE__ */ jsx("link", {
+		canonicalUrl && /* @__PURE__ */ jsx("link", {
 			rel: "canonical",
-			href: window.location.origin + location.pathname
+			href: canonicalUrl
+		}),
+		ogUrl && /* @__PURE__ */ jsx("meta", {
+			property: "og:url",
+			content: ogUrl
 		}),
 		/* @__PURE__ */ jsx("meta", {
 			name: "twitter:card",
@@ -1365,10 +1436,7 @@ function Head({ siteTitle, siteDescription, routes }) {
 				name: "robots",
 				content: value
 			}, "robots");
-			if (key === "canonical") return /* @__PURE__ */ jsx("link", {
-				rel: "canonical",
-				href: value
-			}, "canonical");
+			if (key === "canonical" || key === "og:url") return null;
 			return key.startsWith("og:") || key.startsWith("music:") || key.startsWith("video:") || key.startsWith("article:") || key.startsWith("book:") || key.startsWith("profile:") ? /* @__PURE__ */ jsx("meta", {
 				property: key,
 				content: value
@@ -1380,71 +1448,68 @@ function Head({ siteTitle, siteDescription, routes }) {
 	] });
 }
 
+//#endregion
+//#region src/client/collections/collections-context.tsx
+const CollectionsContext = createContext({});
+function useCollectionsData() {
+	return use(CollectionsContext);
+}
+
 //#endregion
 //#region src/client/app/docs-layout.tsx
-/**
-* Wraps the docs Outlet with the user's (or default) layout component.
-* The Layout receives the routed page as `children`.
-* We use useRoutes to pass the current route context to the persistent layout.
-*/
-function DocsLayout$1() {
+function DocsLayout({ collectionsData }) {
 	const config = useConfig();
 	const { currentRoute, allRoutes } = useRoutes();
-	return /* @__PURE__ */ jsxs(Fragment, { children: [/* @__PURE__ */ jsx(Head, {
+	const content = /* @__PURE__ */ jsxs(Fragment, { children: [/* @__PURE__ */ jsx(Head, {
 		siteTitle: config.theme?.title,
 		siteDescription: config.theme?.description,
 		routes: allRoutes || []
-	}), /* @__PURE__ */ jsx(UserLayout, {
+	}), /* @__PURE__ */ jsx(InternalErrorBoundary, { children: /* @__PURE__ */ jsx(UserLayout, {
 		route: currentRoute,
 		children: /* @__PURE__ */ jsx(Outlet, {})
-	})] });
+	}) })] });
+	if (collectionsData) return /* @__PURE__ */ jsx(CollectionsContext.Provider, {
+		value: collectionsData,
+		children: content
+	});
+	return content;
 }
 
 //#endregion
-//#region src/client/ssg/create-routes.tsx
-const Loading = () => /* @__PURE__ */ jsx("div", {
-	className: "text-muted text-sm py-4",
-	children: "Loading..."
-});
-/**
-* Stable component to render MDX pages.
-* By being outside createRoutes, it prevents React from unmounting the page on HMR.
-*/
-const MdxRouteElement = ({ moduleLoader, moduleKey, route, components }) => {
-	const MDXComponent = moduleLoader?.default ?? moduleLoader ?? null;
-	useEffect(() => {
-		if (!import.meta.hot || !moduleKey) return;
-		const handler = (data) => {
-			if (data.relPath.replace(/\\/g, "/").replace(/^\//, "") !== route.filePath.replace(/\\/g, "/").replace(/^\//, "")) return;
-			import(moduleKey + "?t=" + Date.now()).then((m) => {});
-		};
-		import.meta.hot.on("boltdocs:mdx-update", handler);
-		return () => import.meta.hot?.off("boltdocs:mdx-update", handler);
-	}, [moduleKey, route.filePath]);
-	if (!MDXComponent) return /* @__PURE__ */ jsx(Loading, {});
-	return /* @__PURE__ */ jsx(MdxPage, {
-		MDXComponent,
-		mdxComponents: components
-	});
-};
-const NotFoundWrapper = () => {
-	const components = useMdxComponents();
-	return /* @__PURE__ */ jsx(components.NotFound || components["404"] || NotFound, {});
-};
-function createRoutes(options) {
-	const { routesData, config, mdxModules, externalPages, externalLayout, components } = options;
-	const EffectiveExternalLayout = externalLayout || (({ children }) => /* @__PURE__ */ jsx(Fragment, { children }));
-	const withBase = (path) => {
-		const base = config.base || "/";
-		if (path.startsWith(base)) return path;
-		return `${base === "/" ? "" : base.replace(/\/$/, "")}${path.startsWith("/") ? path : `/${path}`}` || "/";
-	};
+//#region src/client/ssg/create-routes.utils.ts
+function withBase(path, config) {
+	const base = config.base || "/";
+	if (path.startsWith(base)) return path;
+	return `${base === "/" ? "" : base.replace(/\/$/, "")}${path.startsWith("/") ? path : `/${path}`}` || "/";
+}
+function buildModuleMap(mdxModules) {
+	const moduleMap = /* @__PURE__ */ new Map();
+	const mdxModuleKeys = Object.keys(mdxModules);
+	if (mdxModuleKeys.length > 0) {
+		const docsDirName = mdxModuleKeys[0].replace(/\\/g, "/").split("/").filter(Boolean)[0] || "docs";
+		const primaryPrefix = `/${docsDirName}/`;
+		const altPrefix = `./${docsDirName}/`;
+		for (const rawKey of mdxModuleKeys) {
+			const k = rawKey.replace(/\\/g, "/");
+			let relativePath = "";
+			if (k.indexOf(primaryPrefix) !== -1) relativePath = k.substring(k.indexOf(primaryPrefix) + primaryPrefix.length);
+			else if (k.startsWith(altPrefix)) relativePath = k.substring(altPrefix.length);
+			if (relativePath) moduleMap.set(relativePath, rawKey);
+			else moduleMap.set(k, rawKey);
+		}
+	}
+	return moduleMap;
+}
+
+//#endregion
+//#region src/client/ssg/create-routes.doc.tsx
+function buildDocRoutes(options) {
+	const { routesData, config, mdxModules, components, externalPages } = options;
+	const baseDocsPath = (config.base || "/docs").replace(/\/$/, "") || "/";
 	const defaultVersionMetadata = [];
 	const defaultVersion = config.versions?.defaultVersion;
 	const docsBase = (config.base || "/docs").replace(/\/$/, "");
-	let baseDocsPath = (config.base || "/docs").replace(/\/$/, "");
-	if (!baseDocsPath) baseDocsPath = "/";
-	if (defaultVersion) routesData.forEach((route) => {
+	if (defaultVersion) routesData.filter((r) => !r.collection).forEach((route) => {
 		if (route.version) return;
 		const p = route.path || "";
 		const subPath = p.startsWith(docsBase) ? p.substring(docsBase.length).replace(/^\//, "") : p.replace(/^\//, "");
@@ -1457,36 +1522,18 @@ function createRoutes(options) {
 			});
 		}
 	});
-	const docMetadata = [...routesData, ...defaultVersionMetadata];
-	const moduleMap = /* @__PURE__ */ new Map();
+	const docMetadata = [...routesData.filter((r) => !r.collection), ...defaultVersionMetadata];
+	const moduleMap = buildModuleMap(mdxModules);
 	const mdxModuleKeys = Object.keys(mdxModules);
-	if (mdxModuleKeys.length > 0) {
-		const docsDirName = mdxModuleKeys[0].replace(/\\/g, "/").split("/").filter(Boolean)[0] || "docs";
-		const primaryPrefix = `/${docsDirName}/`;
-		const altPrefix = `./${docsDirName}/`;
-		for (const rawKey of mdxModuleKeys) {
-			const k = rawKey.replace(/\\/g, "/");
-			let relativePath = "";
-			if (k.indexOf(primaryPrefix) !== -1) relativePath = k.substring(k.indexOf(primaryPrefix) + primaryPrefix.length);
-			else if (k.startsWith(altPrefix)) relativePath = k.substring(altPrefix.length);
-			if (relativePath) moduleMap.set(relativePath, rawKey);
-			else moduleMap.set(k, rawKey);
-		}
-	}
+	const isLazy = mdxModuleKeys.length > 0 && typeof mdxModules[mdxModuleKeys[0]] === "function";
 	const docRoutes = docMetadata.map((route) => {
 		const normalizedFilePath = route.filePath.replace(/\\/g, "/");
 		const moduleKey = moduleMap.get(normalizedFilePath);
 		const moduleLoader = moduleKey ? mdxModules[moduleKey] : null;
-		const fullPath = withBase(route.path === "" ? "/" : route.path);
+		const fullPath = withBase(route.path === "" ? "/" : route.path, config);
 		const path = fullPath === baseDocsPath ? "." : fullPath.startsWith(baseDocsPath + "/") ? fullPath.slice(baseDocsPath.length + 1) : fullPath;
-		return {
+		const routeRecord = {
 			path,
-			element: /* @__PURE__ */ jsx(MdxRouteElement, {
-				moduleKey,
-				moduleLoader,
-				route,
-				components
-			}, moduleKey || path),
 			loader: async () => ({
 				path,
 				frontmatter: {
@@ -1494,6 +1541,7 @@ function createRoutes(options) {
 					description: route.description || "",
 					...route.frontmatter || {}
 				},
+				seo: route.seo,
 				headings: route.headings || [],
 				filePath: route.filePath,
 				locale: route.locale,
@@ -1505,6 +1553,24 @@ function createRoutes(options) {
 			}),
 			getStaticPaths: () => [path]
 		};
+		if (isLazy && moduleLoader) routeRecord.lazy = async () => {
+			const mod = await resolveModuleLoader(moduleLoader);
+			return { Component: function LoadedMdxRoute() {
+				return /* @__PURE__ */ jsx(EagerMdxElement, {
+					moduleKey,
+					moduleLoader: mod,
+					route,
+					components
+				}, moduleKey || path);
+			} };
+		};
+		else routeRecord.element = /* @__PURE__ */ jsx(EagerMdxElement, {
+			moduleKey,
+			moduleLoader,
+			route,
+			components
+		}, moduleKey || path);
+		return routeRecord;
 	});
 	const locales = config.i18n?.locales ? Array.isArray(config.i18n.locales) ? config.i18n.locales : Object.keys(config.i18n.locales) : [];
 	const allVersions = config.versions?.versions?.map((v) => v.path) || [];
@@ -1555,11 +1621,11 @@ function createRoutes(options) {
 					getStaticPaths: () => []
 				});
 				const matchedMetaObj = docMetadata.find((m) => {
-					const fullPath = withBase(m.path === "" ? "/" : m.path);
+					const fullPath = withBase(m.path === "" ? "/" : m.path, config);
 					return (fullPath === baseDocsPath ? "." : fullPath.startsWith(baseDocsPath + "/") ? fullPath.slice(baseDocsPath.length + 1) : fullPath) === matchedRouteObj.path;
 				});
 				if (matchedMetaObj) {
-					const canonicalPath = withBase(matchedMetaObj.path);
+					const canonicalPath = withBase(matchedMetaObj.path, config);
 					const canonicalUrl = config.siteUrl ? `${config.siteUrl.replace(/\/$/, "")}${canonicalPath}` : canonicalPath;
 					docMetadata.push({
 						...matchedMetaObj,
@@ -1575,62 +1641,277 @@ function createRoutes(options) {
 			}
 		}
 	});
-	const children = [{
-		path: baseDocsPath,
-		element: /* @__PURE__ */ jsx(DocsLayout$1, {}),
-		children: docRoutes
-	}];
-	const externalMetadata = [];
-	if (externalPages) Object.entries(externalPages).forEach(([rawPath, ExtComponent]) => {
+	return {
+		routes: docRoutes,
+		metadata: docMetadata
+	};
+}
+
+//#endregion
+//#region src/client/ssg/create-routes.external.tsx
+function buildExternalRoutes(options) {
+	const { externalPages, externalLayout, config } = options;
+	const children = [];
+	const metadata = [];
+	if (!externalPages) return {
+		children,
+		metadata
+	};
+	const EffectiveExternalLayout = externalLayout || (({ children }) => /* @__PURE__ */ jsx(Fragment, { children }));
+	Object.entries(externalPages).forEach(([rawPath, ExtComponent]) => {
 		const path = rawPath.startsWith("/") ? rawPath : `/${rawPath}`;
-		if (!children.find((r) => r.path === path)) {
-			externalMetadata.push({
+		metadata.push({
+			path,
+			locale: config.i18n?.defaultLocale,
+			title: rawPath === "/" ? "Home" : rawPath.replace(/^\//, "").split("/").pop() || "Page",
+			filePath: "",
+			headings: []
+		});
+		children.push({
+			path,
+			element: /* @__PURE__ */ jsx(EffectiveExternalLayout, { children: /* @__PURE__ */ jsx(ExtComponent, {}) }),
+			loader: async () => ({
 				path,
-				locale: config.i18n?.defaultLocale,
-				title: rawPath === "/" ? "Home" : rawPath.replace(/^\//, "").split("/").pop() || "Page",
+				locale: config.i18n?.defaultLocale
+			}),
+			getStaticPaths: () => [path]
+		});
+		if (config.i18n) Object.keys(config.i18n.locales).forEach((locale) => {
+			const localePath = `/${locale}${rawPath === "/" ? "" : rawPath}`;
+			metadata.push({
+				path: localePath,
+				locale,
+				title: rawPath,
 				filePath: "",
 				headings: []
 			});
 			children.push({
-				path,
+				path: localePath,
 				element: /* @__PURE__ */ jsx(EffectiveExternalLayout, { children: /* @__PURE__ */ jsx(ExtComponent, {}) }),
 				loader: async () => ({
-					path,
-					locale: config.i18n?.defaultLocale
+					path: localePath,
+					locale
 				}),
-				getStaticPaths: () => [path]
-			});
-			if (config.i18n) Object.keys(config.i18n.locales).forEach((locale) => {
-				const localePath = `/${locale}${rawPath === "/" ? "" : rawPath}`;
-				if (!children.find((r) => r.path === localePath)) {
-					externalMetadata.push({
-						path: localePath,
-						locale,
-						title: rawPath,
-						filePath: "",
-						headings: []
-					});
-					children.push({
-						path: localePath,
-						element: /* @__PURE__ */ jsx(EffectiveExternalLayout, { children: /* @__PURE__ */ jsx(ExtComponent, {}) }),
-						loader: async () => ({
-							path: localePath,
-							locale
-						}),
-						getStaticPaths: () => [localePath]
-					});
-				}
+				getStaticPaths: () => [localePath]
 			});
-		}
+		});
 	});
-	children.push({
-		path: "*",
-		element: /* @__PURE__ */ jsx(EffectiveExternalLayout, { children: /* @__PURE__ */ jsx(NotFoundWrapper, {}) })
+	return {
+		children,
+		metadata
+	};
+}
+
+//#endregion
+//#region src/client/ssg/create-routes.collection.tsx
+function DefaultCollectionList() {
+	const data = useLoaderData();
+	if (!data || !data.posts) return null;
+	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
+			}),
+			/* @__PURE__ */ jsx("div", {
+				className: "space-y-6",
+				children: data.posts.map((post) => /* @__PURE__ */ jsxs("article", {
+					className: "border-b border-subtle pb-4",
+					children: [
+						/* @__PURE__ */ jsx("h2", {
+							className: "text-xl font-semibold mb-2",
+							children: /* @__PURE__ */ jsx(Link, {
+								to: post.path,
+								className: "text-primary-600 hover:underline",
+								children: post.title
+							})
+						}),
+						post.date && /* @__PURE__ */ jsx("time", {
+							className: "text-xs text-muted block mb-2",
+							children: new Date(post.date).toLocaleDateString()
+						}),
+						post.excerpt && /* @__PURE__ */ jsx("p", {
+							className: "text-sm text-body",
+							children: post.excerpt
+						})
+					]
+				}, post.path))
+			}),
+			data.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}`,
+						className: "text-primary-600 hover:underline",
+						children: "Previous"
+					}),
+					/* @__PURE__ */ jsxs("span", { children: [
+						"Page ",
+						data.currentPage,
+						" of ",
+						data.totalPages
+					] }),
+					data.currentPage < data.totalPages && /* @__PURE__ */ jsx(Link, {
+						to: `/${data.collection}/page/${data.currentPage + 1}`,
+						className: "text-primary-600 hover:underline",
+						children: "Next"
+					})
+				]
+			})
+		]
 	});
+}
+function buildCollectionRoutes(options) {
+	const { routesData, collectionsData, collectionLayouts, collectionLists, collectionPosts, config, mdxModules, components } = options;
+	const postsPerPage = options.postsPerPage ?? config.collections?.postsPerPage ?? 10;
+	const children = [];
+	const metadata = [];
+	const collectionsMap = /* @__PURE__ */ new Map();
+	for (const r of routesData) if (r.collection) {
+		if (!collectionsMap.has(r.collection)) collectionsMap.set(r.collection, []);
+		collectionsMap.get(r.collection).push(r);
+	}
+	const moduleMap = buildModuleMap(mdxModules);
+	const mdxModuleKeys = Object.keys(mdxModules);
+	const isLazy = mdxModuleKeys.length > 0 && typeof mdxModules[mdxModuleKeys[0]] === "function";
+	for (const [colName, colRoutes] of collectionsMap) {
+		const colBase = `/${colName}`;
+		colRoutes.sort((a, b) => {
+			const da = a.date ? new Date(a.date).getTime() : 0;
+			return (b.date ? new Date(b.date).getTime() : 0) - da;
+		});
+		const colChildren = [];
+		for (const route of colRoutes) {
+			const normalizedFilePath = route.filePath.replace(/\\/g, "/");
+			const moduleKey = moduleMap.get(normalizedFilePath);
+			const moduleLoader = moduleKey ? mdxModules[moduleKey] : null;
+			const subPath = route.path.startsWith(colBase + "/") ? route.path.slice(colBase.length + 1) : route.path.replace(colBase, "") || "";
+			const routeWithCollection = {
+				...route,
+				collection: colName
+			};
+			const postComponent = collectionPosts?.[colName];
+			const routeRecord = {
+				path: subPath,
+				loader: async () => ({
+					route: routeWithCollection,
+					headings: route.headings || [],
+					collection: colName,
+					path: subPath,
+					frontmatter: {
+						title: route.title,
+						description: route.description || "",
+						...route.frontmatter || {}
+					},
+					filePath: route.filePath,
+					locale: route.locale,
+					version: route.version,
+					date: route.date,
+					lastUpdated: route.lastUpdated
+				}),
+				getStaticPaths: () => [subPath || "."]
+			};
+			if (isLazy && moduleLoader) routeRecord.lazy = async () => {
+				const mod = await resolveModuleLoader(moduleLoader);
+				return { Component: function LoadedCollectionMdxRoute() {
+					return /* @__PURE__ */ jsx(EagerMdxElement, {
+						moduleKey,
+						moduleLoader: mod,
+						route,
+						components,
+						collectionPostComponent: postComponent
+					}, moduleKey || subPath);
+				} };
+			};
+			else routeRecord.element = /* @__PURE__ */ jsx(EagerMdxElement, {
+				moduleKey,
+				moduleLoader,
+				route,
+				components,
+				collectionPostComponent: postComponent
+			}, moduleKey || subPath);
+			colChildren.push(routeRecord);
+			metadata.push(route);
+		}
+		const totalPages = Math.ceil(colRoutes.length / postsPerPage);
+		const paginatedPosts = colRoutes.map((r) => ({
+			path: r.path,
+			title: r.title,
+			date: r.date,
+			excerpt: r.excerpt,
+			tags: r.tags,
+			author: r.author,
+			coverImage: r.coverImage,
+			filePath: r.filePath,
+			frontmatter: r.frontmatter
+		}));
+		const ListElement = collectionLists?.[colName] || DefaultCollectionList;
+		colChildren.unshift({
+			index: true,
+			element: /* @__PURE__ */ jsx(ListElement, {}),
+			loader: async () => ({
+				posts: paginatedPosts.slice(0, postsPerPage),
+				totalPages,
+				currentPage: 1,
+				collection: colName
+			}),
+			getStaticPaths: () => []
+		});
+		for (let p = 2; p <= totalPages; p++) colChildren.push({
+			path: `page/${p}`,
+			element: /* @__PURE__ */ jsx(ListElement, {}),
+			loader: async () => ({
+				posts: paginatedPosts.slice((p - 1) * postsPerPage, p * postsPerPage),
+				totalPages,
+				currentPage: p,
+				collection: colName
+			}),
+			getStaticPaths: () => [`page/${p}`]
+		});
+		const blogLayoutRoute = {
+			path: colBase,
+			element: /* @__PURE__ */ jsx(collectionLayouts?.[colName] || DocsLayout, { collectionsData: collectionsData || {} }),
+			children: colChildren
+		};
+		children.push(blogLayoutRoute);
+	}
+	return {
+		children,
+		metadata
+	};
+}
+
+//#endregion
+//#region src/client/ssg/create-routes.tsx
+function createRoutes(options) {
+	const { config, components, externalLayout } = options;
+	const EffectiveExternalLayout = externalLayout || (({ children }) => /* @__PURE__ */ jsx(Fragment, { children }));
+	const baseDocsPath = (config.base || "/docs").replace(/\/$/, "") || "/";
+	const { routes: docRoutes, metadata: docMetadata } = buildDocRoutes(options);
+	const externalRoutes = buildExternalRoutes(options);
+	const collectionRoutes = buildCollectionRoutes(options);
+	const children = [
+		{
+			path: baseDocsPath,
+			element: /* @__PURE__ */ jsx(DocsLayout, {}),
+			children: docRoutes
+		},
+		...externalRoutes.children,
+		...collectionRoutes.children,
+		{
+			path: "*",
+			element: /* @__PURE__ */ jsx(EffectiveExternalLayout, { children: /* @__PURE__ */ jsx(NotFoundWrapper, {}) })
+		}
+	];
 	return [{
 		element: /* @__PURE__ */ jsx(BoltdocsShell, {
 			config,
-			routes: [...docMetadata, ...externalMetadata],
+			routes: [
+				...docMetadata,
+				...externalRoutes.metadata,
+				...collectionRoutes.metadata
+			],
 			components
 		}),
 		children
@@ -1816,29 +2097,40 @@ function useTrackEvent() {
 }
 
 //#endregion
-//#region src/client/components/docs-layout-default.tsx
+//#region src/client/hooks/use-headings.ts
 /**
-* Pre-assembled high-fidelity documentation layout component.
-* Fully styled and optimized to adapt seamlessly to our custom Parchment/Slate theme.
+* Returns the headings of the current page, extracted from the route loader data.
+* Useful for building custom Tables of Contents or jumping to sections.
+*
+* @returns An array of heading objects with level, text, and id.
 */
+function useHeadings() {
+	const matches = useMatches();
+	return useMemo(() => {
+		return (matches[matches.length - 1]?.data)?.headings || [];
+	}, [matches]);
+}
+
+//#endregion
+//#region src/client/components/docs-layout-default.tsx
 function DocsLayoutComponent({ children }) {
-	const { routes: filteredRoutes, currentRoute } = useRoutes();
+	const { routes: filteredRoutes, currentRoute, isCollectionPage } = useRoutes();
 	const config = useConfig();
-	return /* @__PURE__ */ jsxs(DocsLayout$2, {
+	return /* @__PURE__ */ jsxs(DocsLayout$1, {
 		className: "selection:bg-primary-500/10 selection:text-primary-500",
-		children: [/* @__PURE__ */ jsx(Navbar, {}), /* @__PURE__ */ jsxs(DocsLayout$2.Body, {
+		children: [/* @__PURE__ */ jsx(Navbar, {}), /* @__PURE__ */ jsxs(DocsLayout$1.Body, {
 			className: "bg-main",
 			children: [
-				/* @__PURE__ */ jsx(Sidebar, {
+				!isCollectionPage && /* @__PURE__ */ jsx(Sidebar, {
 					routes: filteredRoutes || [],
 					config
 				}),
-				/* @__PURE__ */ jsx(DocsLayout$2.Content, {
+				/* @__PURE__ */ jsx(DocsLayout$1.Content, {
 					className: "animate-in fade-in duration-500 scroll-smooth",
-					children: /* @__PURE__ */ jsxs(DocsLayout$2.ContentMdx, {
-						className: "max-w-3xl sm:max-w-4xl lg:max-w-4xl px-2 pt-8 pb-24",
+					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: [
-							/* @__PURE__ */ jsxs(DocsLayout$2.Header, { 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, {
@@ -1859,7 +2151,7 @@ function DocsLayoutComponent({ children }) {
 								className: "prose prose-neutral dark:prose-invert max-w-none",
 								children
 							}) }),
-							/* @__PURE__ */ jsx(DocsLayout$2.Footer, { children: /* @__PURE__ */ jsx(PageNav, {}) })
+							/* @__PURE__ */ jsx(DocsLayout$1.Footer, { children: !isCollectionPage && /* @__PURE__ */ jsx(PageNav, {}) })
 						]
 					})
 				}),
@@ -1873,13 +2165,55 @@ function DocsLayoutComponent({ children }) {
 		})]
 	});
 }
-const DocsLayout = Object.assign(DocsLayoutComponent, {
-	Body: DocsLayout$2.Body,
-	Content: DocsLayout$2.Content,
-	ContentMdx: DocsLayout$2.ContentMdx,
-	Header: DocsLayout$2.Header,
-	Footer: DocsLayout$2.Footer
-});
 
 //#endregion
-export { BoltdocsShell, Breadcrumbs, Card, Cards, CopyMarkdown, DocsLayout, ErrorBoundary, MdxPage, Navbar, NotFound, OnThisPage, PageNav, SearchDialog, Sidebar, ViteReactSSG, cn, copyToClipboard, createRoutes, getStarsRepo, getTranslated, reactToText, useAnalytics, useBreadcrumbs, useConfig, useI18n, useLocalizedTo, useLocation, useMdxComponents, useNavbar, usePageNav, useRoutes, useSearch, useSearchHighlight, useSidebar, useTabs, useTheme, useTrackEvent, useTrackPageView, useUI, useVersion };
+//#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) {
+	return useCollectionsData()[collection] || [];
+}
+/**
+* Returns a post by its slug.
+* @param collection - The name of the collection.
+* @param slug - The slug of the post.
+* @returns The post with the given slug.
+*/
+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) => {
+	if (node == null || typeof node === "boolean") return "";
+	if (typeof node === "string" || typeof node === "number") return String(node);
+	if (Array.isArray(node)) return node.map((n) => reactToText(n, resolvers)).join("");
+	if (isValidElement(node)) {
+		const resolver = resolvers?.get(node.type);
+		if (resolver) return resolver(node.props);
+		return reactToText(node.props.children, resolvers);
+	}
+	return "";
+};
+
+//#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, useConfig, useHeadings, useI18n, useLocalizedTo, useLocation, useMdxComponents, useMergedComponents, useNavbar, usePageNav, usePost, usePosts, useRecentPosts, useRoutes, useSearch, useSearchHighlight, useSidebar, useTabs, useTheme, useTrackEvent, useTrackPageView, useUI, useVersion };