boltdocs 2.7.11 → 2.8.0

package/dist/client/index.cjs

@@ -4,55 +4,325 @@
  * Licensed under the MIT License.
  */
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_icons_dev = require('../icons-dev-3cZMyt8r.cjs');
-const require_docs_layout = require('../docs-layout-BXHV0xw_.cjs');
-const require_image = require('../image-DtrI2cw3.cjs');
-const require_search_dialog = require('../search-dialog-C7xuvyNk.cjs');
-const require_search_dialog$1 = require('../search-dialog-BwkDuI9R.cjs');
-const require_mdx = require('../mdx-BdWkJTeB.cjs');
-let react_router_dom = require("react-router-dom");
+const require_icons_dev = require('../icons-dev-DvJ-hh9x.cjs');
+const require_image = require('../image-Ch4-GxdO.cjs');
+const require_mdx = require('../mdx-PLhhPJRS.cjs');
+const require_docs_layout = require('../docs-layout-CwCq42Zt.cjs');
+const require_search_dialog = require('../search-dialog-BXVoecTx.cjs');
+const require_search_dialog$1 = require('../search-dialog-BYhOov4S.cjs');
 let react = require("react");
+let react_router_dom = require("react-router-dom");
 let react_jsx_runtime = require("react/jsx-runtime");
-let react_aria_components = require("react-aria-components");
-let virtual_boltdocs_icons = require("virtual:boltdocs-icons");
-virtual_boltdocs_icons = require_icons_dev.__toESM(virtual_boltdocs_icons);
 let react_helmet_async = require("react-helmet-async");
 react_helmet_async = require_icons_dev.__toESM(react_helmet_async);
+let react_aria_components = require("react-aria-components");
 let virtual_boltdocs_mdx_components = require("virtual:boltdocs-mdx-components");
 virtual_boltdocs_mdx_components = require_icons_dev.__toESM(virtual_boltdocs_mdx_components);
+let virtual_boltdocs_icons = require("virtual:boltdocs-icons");
+virtual_boltdocs_icons = require_icons_dev.__toESM(virtual_boltdocs_icons);
 let virtual_boltdocs_layout = require("virtual:boltdocs-layout");
 virtual_boltdocs_layout = require_icons_dev.__toESM(virtual_boltdocs_layout);
 let _bdocs_ssg = require("@bdocs/ssg");
 
 //#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] = (0, react.createContext)({}));
+const registry = globalThis;
+if (!registry[MDX_COMPONENTS_CONTEXT_SYMBOL]) registry[MDX_COMPONENTS_CONTEXT_SYMBOL] = (0, react.createContext)({});
+const MdxComponentsContext = registry[MDX_COMPONENTS_CONTEXT_SYMBOL];
 function useMdxComponents() {
-	const context = (0, react.use)(MdxComponentsContext);
-	if ((!context || Object.keys(context).length === 0) && globalThis[MDX_COMPONENTS_INSTANCE_SYMBOL]) return globalThis[MDX_COMPONENTS_INSTANCE_SYMBOL];
-	return context;
+	return (0, react.use)(MdxComponentsContext);
 }
 function MdxComponentsProvider({ components, children }) {
 	const processedComponents = (0, react.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__ */ (0, react_jsx_runtime.jsx)(MdxComponentsContext.Provider, {
 		value: processedComponents,
 		children
 	});
 }
 
+//#endregion
+//#region src/client/app/helmet-compat.tsx
+const mod = react_helmet_async;
+/**
+* The `<Helmet>` component, resolved across CJS/ESM module shapes.
+* Falls back to a transparent fragment wrapper if the module cannot be resolved.
+*/
+const Helmet = mod.Helmet || mod.default?.Helmet || (({ children }) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)(react_jsx_runtime.Fragment, { children }));
+/**
+* The `<HelmetProvider>` component, resolved across CJS/ESM module shapes.
+* Falls back to a transparent fragment wrapper if the module cannot be resolved.
+*/
+const HelmetProvider = mod.HelmetProvider || mod.default?.HelmetProvider || (({ children }) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)(react_jsx_runtime.Fragment, { children }));
+
+//#endregion
+//#region src/client/app/scroll-handler.tsx
+/**
+* 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 } = (0, react_router_dom.useLocation)();
+	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;
+	};
+	(0, react.useLayoutEffect)(() => {
+		handleScroll("auto");
+	}, [pathname, hash]);
+	(0, react.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__ */ (0, react_jsx_runtime.jsx)("div", {
+		className: "flex items-center justify-center min-h-[65vh] text-center px-4",
+		children: /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+			className: "space-y-6 max-w-md mx-auto p-8 border border-subtle bg-surface rounded-2xl shadow-xs",
+			children: [
+				/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+					className: "block text-7xl font-extrabold tracking-tight text-primary-500",
+					children: "404"
+				}),
+				/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+					className: "space-y-2",
+					children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("h1", {
+						className: "text-xl font-bold text-body",
+						children: "Page Not Found"
+					}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+						className: "text-sm text-muted leading-relaxed",
+						children: "The page you're looking for doesn't exist or has been moved."
+					})]
+				}),
+				/* @__PURE__ */ (0, react_jsx_runtime.jsxs)(require_icons_dev.Link, {
+					href: "/",
+					className: "inline-flex items-center gap-2 rounded-xl border border-subtle bg-main px-6 py-2.5 text-xs font-semibold text-body hover:bg-primary-50/50 hover:border-primary-500/50 transition-all duration-300 outline-none select-none",
+					children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_icons_dev.ArrowLeft, { size: 14 }), " Go to Home"]
+				})
+			]
+		})
+	});
+}
+
+//#endregion
+//#region src/client/app/mdx-component.tsx
+const mdxComponentsDefault = {
+	...require_mdx.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 } = require_icons_dev.useBoltdocsContext();
+	(0, react.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 = (0, react_router_dom.useLocation)();
+	const { setLocale, setVersion } = require_icons_dev.useBoltdocsContext();
+	(0, react.useEffect)(() => {
+		const currentPath = require_icons_dev.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 = (0, react.useMemo)(() => ({
+		...mdxComponentsDefault,
+		...virtual_boltdocs_mdx_components.default,
+		...components
+	}), [components]);
+	const { pathname } = (0, react_router_dom.useLocation)();
+	const currentPath = (0, react.useMemo)(() => require_icons_dev.normalizePath(pathname || "/"), [pathname]);
+	const routeMap = (0, react.useMemo)(() => {
+		const map = /* @__PURE__ */ new Map();
+		for (const r of routes) {
+			const key = require_icons_dev.normalizePath(r.path === "" ? "/" : r.path);
+			map.set(key, r);
+		}
+		return map;
+	}, [routes]);
+	const initialData = (0, react.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__ */ (0, react_jsx_runtime.jsx)(HelmetProvider, { children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_icons_dev.RoutesProvider, {
+		routes,
+		children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_image.ThemeProvider, { children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_docs_layout.UIProvider, { children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(MdxComponentsProvider, {
+			components: allComponents,
+			children: /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(require_icons_dev.ConfigContext.Provider, {
+				value: config,
+				children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(ScrollHandler, {}), /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(require_icons_dev.BoltdocsProvider, {
+					initialLocale: initialData.initLocale,
+					initialVersion: initialData.initVersion,
+					children: [
+						/* @__PURE__ */ (0, react_jsx_runtime.jsx)(StoreSync, {
+							config,
+							routeMap
+						}),
+						/* @__PURE__ */ (0, react_jsx_runtime.jsx)(I18nUpdater, { config }),
+						/* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_search_dialog$1.InternalErrorBoundary, { children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(react_router_dom.Outlet, {}) })
+					]
+				})]
+			})
+		}) }) })
+	}) });
+}
+
+//#endregion
+//#region src/client/hooks/use-merged-components.ts
+function useMergedComponents(propComponents) {
+	const contextComponents = useMdxComponents();
+	return (0, react.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__ */ (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(Content, { components: allComponents }), route?.lastUpdated && /* @__PURE__ */ (0, react_jsx_runtime.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 = (0, react_router_dom.useLoaderData)();
+	if (!MDXComponent) return null;
+	if (!!data?.collection && CollectionPost) return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(CollectionPost, {
+		MDXComponent,
+		mdxComponents: propComponents
+	});
+	const docData = data;
+	return /* @__PURE__ */ (0, react_jsx_runtime.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
 /**
@@ -103,10 +373,20 @@ function Breadcrumbs() {
 //#region src/client/components/ui-base/copy-markdown.tsx
 const useCopyMarkdown = (content) => {
 	const [copied, setCopied] = (0, react.useState)(false);
+	const timerRef = (0, react.useRef)(null);
+	(0, react.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" });
@@ -128,20 +408,20 @@ function CopyMarkdown({ content, mdxRaw }) {
 		children: /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(require_docs_layout.ButtonGroup, {
 			className: "rounded-xl border border-subtle bg-surface transition-all duration-300 hover:border-primary-500/50 group overflow-hidden",
 			children: [
-				/* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_docs_layout.Button, {
+				/* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_search_dialog.Button, {
 					onPress: handleCopy,
 					className: require_icons_dev.cn("md:hidden flex items-center justify-center w-8 h-8 bg-transparent outline-none select-none cursor-pointer border-none", "text-muted transition-all duration-300 hover:bg-primary-500/5 hover:text-body", copied && "text-emerald-500 hover:bg-emerald-500/5"),
 					"aria-label": copied ? "Copied!" : "Copy Markdown",
 					children: copied ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_icons_dev.Check, { size: 14 }) : /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_icons_dev.Copy, { size: 14 })
 				}),
-				/* @__PURE__ */ (0, react_jsx_runtime.jsxs)(require_docs_layout.Button, {
+				/* @__PURE__ */ (0, react_jsx_runtime.jsxs)(require_search_dialog.Button, {
 					onPress: handleCopy,
 					className: require_icons_dev.cn("hidden md:flex items-center gap-2 px-5 py-2 bg-transparent text-[0.8125rem] font-semibold h-9 shrink-0 outline-none select-none cursor-pointer border-none", "text-body transition-all duration-300 hover:bg-primary-500/5", copied && "text-emerald-500 hover:bg-emerald-500/5"),
 					children: [copied ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_icons_dev.Check, { size: 16 }) : /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_icons_dev.Copy, { size: 16 }), copied ? "Copied!" : "Copy Markdown"]
 				}),
 				/* @__PURE__ */ (0, react_jsx_runtime.jsxs)(require_docs_layout.Menu.Trigger, {
 					placement: "bottom end",
-					children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_docs_layout.Button, {
+					children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_search_dialog.Button, {
 						className: require_icons_dev.cn("flex items-center justify-center px-2.5 md:px-3.5 h-8 md:h-9 border-none border-l border-subtle/50 text-muted rounded-none bg-transparent shrink-0 outline-none select-none cursor-pointer", "transition-all duration-300 hover:bg-primary-500/5 hover:text-primary-500"),
 						children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_icons_dev.ChevronDown, { size: 14 })
 					}), /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(require_docs_layout.Menu.Root, {
@@ -177,7 +457,7 @@ function CopyMarkdown({ content, mdxRaw }) {
 //#endregion
 //#region src/client/components/ui-base/error-boundary.tsx
 function ErrorBoundary({ children, fallback }) {
-	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_docs_layout.ErrorBoundary, {
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_search_dialog.ErrorBoundary, {
 		fallback,
 		children
 	});
@@ -490,7 +770,7 @@ function Tabs({ tabs, routes }) {
 	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
 		className: "mx-auto max-w-(--breakpoint-3xl) px-4 md:px-6 select-none",
 		children: /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(require_docs_layout.Tabs.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());
@@ -559,7 +839,7 @@ function useVersion() {
 		currentVersion,
 		currentVersionLabel: (versions?.versions?.find?.((v) => v.path === currentVersion))?.label || currentVersion,
 		availableVersions: (0, react.useMemo)(() => {
-			return versions ? versions.versions.map((v) => ({
+			return versions?.versions ? versions.versions.map((v) => ({
 				key: v.path,
 				label: v.label,
 				value: v.path,
@@ -653,7 +933,7 @@ function useI18n() {
 function VersionSelector({ className }) {
 	const { currentVersionLabel, availableVersions, handleVersionChange } = useVersion();
 	if (availableVersions.length === 0) return null;
-	return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(require_docs_layout.Menu.Trigger, { children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)(require_docs_layout.Button, {
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(require_docs_layout.Menu.Trigger, { children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)(require_search_dialog.Button, {
 		className: require_icons_dev.cn("flex h-9 items-center justify-between gap-2 border border-subtle bg-surface px-4 py-1.5 rounded-xl text-xs font-semibold text-body hover:bg-primary-50/20 hover:border-primary-500/50 transition-all duration-300 outline-none select-none cursor-pointer", className),
 		children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
 			className: "font-semibold text-[0.8125rem]",
@@ -674,7 +954,7 @@ function VersionSelector({ className }) {
 function I18nSelector({ className }) {
 	const { currentLocale, availableLocales, handleLocaleChange } = useI18n();
 	if (availableLocales.length === 0) return null;
-	return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(require_docs_layout.Menu.Trigger, { children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)(require_docs_layout.Button, {
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(require_docs_layout.Menu.Trigger, { children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)(require_search_dialog.Button, {
 		className: require_icons_dev.cn("flex h-9 items-center justify-between gap-2 border border-subtle bg-surface px-4 py-1.5 rounded-xl text-xs font-semibold text-body hover:bg-primary-50/20 hover:border-primary-500/50 transition-all duration-300 outline-none select-none cursor-pointer", className),
 		children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 			className: "flex items-center gap-1.5",
@@ -698,22 +978,21 @@ function I18nSelector({ className }) {
 
 //#endregion
 //#region src/client/components/ui-base/navbar.tsx
-const SearchDialog$1 = (0, react.lazy)(() => Promise.resolve().then(() => require("../search-dialog-CIQg6k8c.cjs")).then((m) => ({ default: m.SearchDialog })));
+const SearchDialog$1 = (0, react.lazy)(() => Promise.resolve().then(() => require("../search-dialog-CUeAfy-8.cjs")).then((m) => ({ default: m.SearchDialog })));
 function Navbar() {
 	const { links, title, logo, logoProps, github, social, config } = useNavbar();
-	const { routes, allRoutes, currentRoute, currentVersion, currentLocale } = require_icons_dev.useRoutes();
-	const { pathname } = (0, react_router_dom.useLocation)();
+	const { routes, currentRoute, isCollectionPage, currentVersion, currentLocale } = require_icons_dev.useRoutes();
 	const { isSidebarOpen, toggleSidebar } = require_docs_layout.useUI();
 	const [isMobileMenuOpen, setIsMobileMenuOpen] = (0, react.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__ */ (0, react_jsx_runtime.jsxs)(require_search_dialog.Navbar.Root, {
 		className: require_icons_dev.cn("border-b border-subtle bg-main/80 backdrop-blur-md", hasTabs && "border-b-0"),
 		children: [
 			/* @__PURE__ */ (0, react_jsx_runtime.jsxs)(require_search_dialog.Navbar.Content, { children: [
 				/* @__PURE__ */ (0, react_jsx_runtime.jsxs)(require_search_dialog.Navbar.Left, { children: [
-					isDocs && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_docs_layout.Button, {
+					isDocs && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_search_dialog.Button, {
 						onPress: toggleSidebar,
 						className: "mr-2 lg:hidden p-1.5 h-8 w-8 flex items-center justify-center bg-transparent border-none outline-none select-none cursor-pointer rounded-xl hover:bg-primary-50/50 transition-colors",
 						"aria-label": isSidebarOpen ? "Close sidebar" : "Open sidebar",
@@ -807,7 +1086,7 @@ function Navbar() {
 				className: "w-full border-b border-subtle bg-main",
 				children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(Tabs, {
 					tabs: themeConfig.tabs,
-					routes: allRoutes || routes || []
+					routes: routes || []
 				})
 			})
 		]
@@ -860,38 +1139,6 @@ function NavbarMobileLinkItem({ link, onClose }) {
 	});
 }
 
-//#endregion
-//#region src/client/components/ui-base/not-found.tsx
-function NotFound() {
-	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
-		className: "flex items-center justify-center min-h-[65vh] text-center px-4",
-		children: /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
-			className: "space-y-6 max-w-md mx-auto p-8 border border-subtle bg-surface rounded-2xl shadow-xs",
-			children: [
-				/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
-					className: "block text-7xl font-extrabold tracking-tight text-primary-500",
-					children: "404"
-				}),
-				/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
-					className: "space-y-2",
-					children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("h1", {
-						className: "text-xl font-bold text-body",
-						children: "Page Not Found"
-					}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
-						className: "text-sm text-muted leading-relaxed",
-						children: "The page you're looking for doesn't exist or has been moved."
-					})]
-				}),
-				/* @__PURE__ */ (0, react_jsx_runtime.jsxs)(require_icons_dev.Link, {
-					href: "/",
-					className: "inline-flex items-center gap-2 rounded-xl border border-subtle bg-main px-6 py-2.5 text-xs font-semibold text-body hover:bg-primary-50/50 hover:border-primary-500/50 transition-all duration-300 outline-none select-none",
-					children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_icons_dev.ArrowLeft, { size: 14 }), " Go to Home"]
-				})
-			]
-		})
-	});
-}
-
 //#endregion
 //#region src/client/components/ui-base/on-this-page.tsx
 function OnThisPage({ headings = [], editLink, communityHelp, filePath }) {
@@ -1015,7 +1262,7 @@ function SidebarMain({ routes, config }) {
 		})]
 	}), /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 		className: "flex items-center gap-2",
-		children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(ThemeSwitcher, { className: "w-24 h-9 rounded-xl" }), /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_docs_layout.Button, {
+		children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(ThemeSwitcher, { className: "w-24 h-9 rounded-xl" }), /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_search_dialog.Button, {
 			onPress: closeSidebar,
 			className: "h-9 w-9 flex items-center justify-center bg-transparent border-none outline-none select-none cursor-pointer rounded-xl hover:bg-primary-50/50 text-muted hover:text-body transition-colors",
 			"aria-label": "Close sidebar",
@@ -1042,249 +1289,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] = (0, react.useState)(true);
+	(0, react.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__ */ (0, react_jsx_runtime.jsxs)("div", {
-		className: "mt-16 pt-6 border-t border-subtle flex items-center justify-between text-xs text-muted select-none",
-		children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {}), /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", {
-			className: "italic",
-			children: ["Last updated on ", formattedDate]
+		className: require_icons_dev.cn("relative flex items-center justify-center px-4 py-2.5 text-xs font-semibold tracking-wide bg-primary-500/10 dark:bg-primary-500/15 text-primary-700 dark:text-primary-300 border-b border-primary-500/20 select-none animate-in fade-in duration-300", className),
+		...props,
+		children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+			className: "flex-1 text-center flex items-center justify-center gap-2",
+			children
+		}), dismissible && /* @__PURE__ */ (0, react_jsx_runtime.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__ */ (0, react_jsx_runtime.jsx)(require_icons_dev.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 = (0, react.useMemo)(() => ({
-		LastUpdated,
-		...contextComponents,
-		...propComponents
-	}), [contextComponents, propComponents]);
-	const LastUpdated$1 = allComponents.LastUpdated || LastUpdated;
-	if (!Content) return null;
-	return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(Content, { components: allComponents }), route?.lastUpdated && /* @__PURE__ */ (0, react_jsx_runtime.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 = (0, react_router_dom.useLoaderData)();
-	const MDXComponent = propMDX || data?.MDXComponent;
-	const components = propComponents || data?.mdxComponents;
-	if (!MDXComponent) return null;
-	return /* @__PURE__ */ (0, react_jsx_runtime.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 = react_helmet_async;
-/**
-* The `<Helmet>` component, resolved across CJS/ESM module shapes.
-* Falls back to a transparent fragment wrapper if the module cannot be resolved.
-*/
-const Helmet = mod.Helmet || mod.default?.Helmet || (({ children }) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)(react_jsx_runtime.Fragment, { children }));
-/**
-* The `<HelmetProvider>` component, resolved across CJS/ESM module shapes.
-* Falls back to a transparent fragment wrapper if the module cannot be resolved.
-*/
-const HelmetProvider = mod.HelmetProvider || mod.default?.HelmetProvider || (({ children }) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)(react_jsx_runtime.Fragment, { children }));
-
-//#endregion
-//#region src/client/app/scroll-handler.tsx
-/**
-* 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 } = (0, react_router_dom.useLocation)();
-	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;
-	};
-	(0, react.useLayoutEffect)(() => {
-		handleScroll("auto");
-	}, [pathname, hash]);
-	(0, react.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 = {
-	...require_mdx.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__ */ (0, react_jsx_runtime.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 } = require_icons_dev.useBoltdocsContext();
+const EagerMdxElement = ({ moduleLoader, moduleKey, route, components, collectionPostComponent }) => {
+	const [mod, setMod] = (0, react.useState)(moduleLoader);
 	(0, react.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 = (0, react_router_dom.useLocation)();
-	const { setLocale, setVersion } = require_icons_dev.useBoltdocsContext();
+		setMod(moduleLoader);
+	}, [moduleLoader]);
 	(0, react.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 = (0, react.useMemo)(() => ({
-		...mdxComponentsDefault,
-		...virtual_boltdocs_mdx_components.default,
-		...components
-	}), [components]);
-	const { pathname } = (0, react_router_dom.useLocation)();
-	const currentPath = (0, react.useMemo)(() => normalizePath(pathname || "/"), [pathname]);
-	const routeMap = (0, react.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 = (0, react.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 (!{}.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__ */ (0, react_jsx_runtime.jsx)(HelmetProvider, { children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_icons_dev.RoutesProvider, {
-		routes,
-		children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_image.ThemeProvider, { children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_docs_layout.UIProvider, { children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(MdxComponentsProvider, {
-			components: allComponents,
-			children: /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(require_icons_dev.ConfigContext.Provider, {
-				value: config,
-				children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(ScrollHandler, {}), /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(require_icons_dev.BoltdocsProvider, {
-					initialLocale: initialData.initLocale,
-					initialVersion: initialData.initVersion,
-					children: [
-						/* @__PURE__ */ (0, react_jsx_runtime.jsx)(StoreSync, {
-							config,
-							routeMap
-						}),
-						/* @__PURE__ */ (0, react_jsx_runtime.jsx)(I18nUpdater, { config }),
-						/* @__PURE__ */ (0, react_jsx_runtime.jsx)(react_router_dom.Outlet, {})
-					]
-				})]
-			})
-		}) }) })
-	}) });
-}
+		({}).hot.on("boltdocs:mdx-update", handler);
+		return () => ({}).hot?.off("boltdocs:mdx-update", handler);
+	}, [moduleKey, route.filePath]);
+	const MDXComponent = mod?.default ?? mod ?? null;
+	if (!MDXComponent) return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(Loading, {});
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(MdxPage, {
+		MDXComponent,
+		mdxComponents: components,
+		collectionPostComponent
+	});
+};
+const NotFoundWrapper = () => {
+	const components = useMdxComponents();
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(components.NotFound || components["404"] || NotFound, {});
+};
 
 //#endregion
 //#region src/client/app/head.tsx
@@ -1299,6 +1368,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;
@@ -1320,13 +1391,13 @@ function Head({ siteTitle, siteDescription, routes }) {
 			property: "og:type",
 			content: "article"
 		}),
-		typeof window !== "undefined" && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("meta", {
-			property: "og:url",
-			content: window.location.href
-		}),
-		typeof window !== "undefined" && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("link", {
+		canonicalUrl && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("link", {
 			rel: "canonical",
-			href: window.location.origin + location.pathname
+			href: canonicalUrl
+		}),
+		ogUrl && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("meta", {
+			property: "og:url",
+			content: ogUrl
 		}),
 		/* @__PURE__ */ (0, react_jsx_runtime.jsx)("meta", {
 			name: "twitter:card",
@@ -1370,10 +1441,7 @@ function Head({ siteTitle, siteDescription, routes }) {
 				name: "robots",
 				content: value
 			}, "robots");
-			if (key === "canonical") return /* @__PURE__ */ (0, react_jsx_runtime.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__ */ (0, react_jsx_runtime.jsx)("meta", {
 				property: key,
 				content: value
@@ -1385,71 +1453,68 @@ function Head({ siteTitle, siteDescription, routes }) {
 	] });
 }
 
+//#endregion
+//#region src/client/collections/collections-context.tsx
+const CollectionsContext = (0, react.createContext)({});
+function useCollectionsData() {
+	return (0, react.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 = require_icons_dev.useConfig();
 	const { currentRoute, allRoutes } = require_icons_dev.useRoutes();
-	return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(Head, {
+	const content = /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(Head, {
 		siteTitle: config.theme?.title,
 		siteDescription: config.theme?.description,
 		routes: allRoutes || []
-	}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)(virtual_boltdocs_layout.default, {
+	}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_search_dialog$1.InternalErrorBoundary, { children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(virtual_boltdocs_layout.default, {
 		route: currentRoute,
 		children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(react_router_dom.Outlet, {})
-	})] });
+	}) })] });
+	if (collectionsData) return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(CollectionsContext.Provider, {
+		value: collectionsData,
+		children: content
+	});
+	return content;
 }
 
 //#endregion
-//#region src/client/ssg/create-routes.tsx
-const Loading = () => /* @__PURE__ */ (0, react_jsx_runtime.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;
-	(0, react.useEffect)(() => {
-		if (!{}.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) => {});
-		};
-		({}).hot.on("boltdocs:mdx-update", handler);
-		return () => ({}).hot?.off("boltdocs:mdx-update", handler);
-	}, [moduleKey, route.filePath]);
-	if (!MDXComponent) return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(Loading, {});
-	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(MdxPage, {
-		MDXComponent,
-		mdxComponents: components
-	});
-};
-const NotFoundWrapper = () => {
-	const components = useMdxComponents();
-	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(components.NotFound || components["404"] || NotFound, {});
-};
-function createRoutes(options) {
-	const { routesData, config, mdxModules, externalPages, externalLayout, components } = options;
-	const EffectiveExternalLayout = externalLayout || (({ children }) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)(react_jsx_runtime.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(/^\//, "");
@@ -1462,36 +1527,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__ */ (0, react_jsx_runtime.jsx)(MdxRouteElement, {
-				moduleKey,
-				moduleLoader,
-				route,
-				components
-			}, moduleKey || path),
 			loader: async () => ({
 				path,
 				frontmatter: {
@@ -1499,6 +1546,7 @@ function createRoutes(options) {
 					description: route.description || "",
 					...route.frontmatter || {}
 				},
+				seo: route.seo,
 				headings: route.headings || [],
 				filePath: route.filePath,
 				locale: route.locale,
@@ -1510,6 +1558,24 @@ function createRoutes(options) {
 			}),
 			getStaticPaths: () => [path]
 		};
+		if (isLazy && moduleLoader) routeRecord.lazy = async () => {
+			const mod = await resolveModuleLoader(moduleLoader);
+			return { Component: function LoadedMdxRoute() {
+				return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(EagerMdxElement, {
+					moduleKey,
+					moduleLoader: mod,
+					route,
+					components
+				}, moduleKey || path);
+			} };
+		};
+		else routeRecord.element = /* @__PURE__ */ (0, react_jsx_runtime.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) || [];
@@ -1560,11 +1626,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,
@@ -1580,62 +1646,277 @@ function createRoutes(options) {
 			}
 		}
 	});
-	const children = [{
-		path: baseDocsPath,
-		element: /* @__PURE__ */ (0, react_jsx_runtime.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__ */ (0, react_jsx_runtime.jsx)(react_jsx_runtime.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__ */ (0, react_jsx_runtime.jsx)(EffectiveExternalLayout, { children: /* @__PURE__ */ (0, react_jsx_runtime.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__ */ (0, react_jsx_runtime.jsx)(EffectiveExternalLayout, { children: /* @__PURE__ */ (0, react_jsx_runtime.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__ */ (0, react_jsx_runtime.jsx)(EffectiveExternalLayout, { children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ExtComponent, {}) }),
-						loader: async () => ({
-							path: localePath,
-							locale
-						}),
-						getStaticPaths: () => [localePath]
-					});
-				}
+				getStaticPaths: () => [localePath]
 			});
-		}
+		});
 	});
-	children.push({
-		path: "*",
-		element: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(EffectiveExternalLayout, { children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(NotFoundWrapper, {}) })
+	return {
+		children,
+		metadata
+	};
+}
+
+//#endregion
+//#region src/client/ssg/create-routes.collection.tsx
+function DefaultCollectionList() {
+	const data = (0, react_router_dom.useLoaderData)();
+	if (!data || !data.posts) return null;
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+		className: "py-8 max-w-2xl mx-auto px-4",
+		children: [
+			/* @__PURE__ */ (0, react_jsx_runtime.jsx)("h1", {
+				className: "text-3xl font-bold mb-6 capitalize",
+				children: data.collection
+			}),
+			/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+				className: "space-y-6",
+				children: data.posts.map((post) => /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("article", {
+					className: "border-b border-subtle pb-4",
+					children: [
+						/* @__PURE__ */ (0, react_jsx_runtime.jsx)("h2", {
+							className: "text-xl font-semibold mb-2",
+							children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(react_router_dom.Link, {
+								to: post.path,
+								className: "text-primary-600 hover:underline",
+								children: post.title
+							})
+						}),
+						post.date && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("time", {
+							className: "text-xs text-muted block mb-2",
+							children: new Date(post.date).toLocaleDateString()
+						}),
+						post.excerpt && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+							className: "text-sm text-body",
+							children: post.excerpt
+						})
+					]
+				}, post.path))
+			}),
+			data.totalPages > 1 && /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+				className: "mt-8 flex gap-4 text-sm",
+				children: [
+					data.currentPage > 1 && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(react_router_dom.Link, {
+						to: data.currentPage === 2 ? `/${data.collection}` : `/${data.collection}/page/${data.currentPage - 1}`,
+						className: "text-primary-600 hover:underline",
+						children: "Previous"
+					}),
+					/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", { children: [
+						"Page ",
+						data.currentPage,
+						" of ",
+						data.totalPages
+					] }),
+					data.currentPage < data.totalPages && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(react_router_dom.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__ */ (0, react_jsx_runtime.jsx)(EagerMdxElement, {
+						moduleKey,
+						moduleLoader: mod,
+						route,
+						components,
+						collectionPostComponent: postComponent
+					}, moduleKey || subPath);
+				} };
+			};
+			else routeRecord.element = /* @__PURE__ */ (0, react_jsx_runtime.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__ */ (0, react_jsx_runtime.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__ */ (0, react_jsx_runtime.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__ */ (0, react_jsx_runtime.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__ */ (0, react_jsx_runtime.jsx)(react_jsx_runtime.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__ */ (0, react_jsx_runtime.jsx)(DocsLayout, {}),
+			children: docRoutes
+		},
+		...externalRoutes.children,
+		...collectionRoutes.children,
+		{
+			path: "*",
+			element: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(EffectiveExternalLayout, { children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(NotFoundWrapper, {}) })
+		}
+	];
 	return [{
 		element: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(BoltdocsShell, {
 			config,
-			routes: [...docMetadata, ...externalMetadata],
+			routes: [
+				...docMetadata,
+				...externalRoutes.metadata,
+				...collectionRoutes.metadata
+			],
 			components
 		}),
 		children
@@ -1821,29 +2102,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 = (0, react_router_dom.useMatches)();
+	return (0, react.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 } = require_icons_dev.useRoutes();
+	const { routes: filteredRoutes, currentRoute, isCollectionPage } = require_icons_dev.useRoutes();
 	const config = require_icons_dev.useConfig();
 	return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(require_docs_layout.DocsLayout, {
 		className: "selection:bg-primary-500/10 selection:text-primary-500",
 		children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(Navbar, {}), /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(require_docs_layout.DocsLayout.Body, {
 			className: "bg-main",
 			children: [
-				/* @__PURE__ */ (0, react_jsx_runtime.jsx)(Sidebar, {
+				!isCollectionPage && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(Sidebar, {
 					routes: filteredRoutes || [],
 					config
 				}),
 				/* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_docs_layout.DocsLayout.Content, {
 					className: "animate-in fade-in duration-500 scroll-smooth",
 					children: /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(require_docs_layout.DocsLayout.ContentMdx, {
-						className: "max-w-3xl sm:max-w-4xl lg:max-w-4xl px-2 pt-8 pb-24",
+						className: "max-w-3xl sm:max-w-4xl lg:max-w-5xl px-4 sm:px-6 pt-8 pb-24",
 						children: [
-							/* @__PURE__ */ (0, react_jsx_runtime.jsxs)(require_docs_layout.DocsLayout.Header, { children: [
+							!isCollectionPage && /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(require_docs_layout.DocsLayout.Header, { children: [
 								/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 									className: "mb-4 border-b border-subtle pb-4 flex flex-wrap items-center justify-between gap-3",
 									children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(Breadcrumbs, {}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)(CopyMarkdown, {
@@ -1864,7 +2156,7 @@ function DocsLayoutComponent({ children }) {
 								className: "prose prose-neutral dark:prose-invert max-w-none",
 								children
 							}) }),
-							/* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_docs_layout.DocsLayout.Footer, { children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(PageNav, {}) })
+							/* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_docs_layout.DocsLayout.Footer, { children: !isCollectionPage && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(PageNav, {}) })
 						]
 					})
 				}),
@@ -1878,21 +2170,63 @@ function DocsLayoutComponent({ children }) {
 		})]
 	});
 }
-const DocsLayout = Object.assign(DocsLayoutComponent, {
-	Body: require_docs_layout.DocsLayout.Body,
-	Content: require_docs_layout.DocsLayout.Content,
-	ContentMdx: require_docs_layout.DocsLayout.ContentMdx,
-	Header: require_docs_layout.DocsLayout.Header,
-	Footer: require_docs_layout.DocsLayout.Footer
-});
 
 //#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) {
+	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 (0, react.useMemo)(() => posts.find((p) => p.path === `/${collection}/${slug}` || p.path.endsWith(`/${slug}`) || p.path === slug), [
+		posts,
+		collection,
+		slug
+	]);
+}
+/**
+* Returns the recent posts of a collection.
+* @param collection - The name of the collection.
+* @param count - The number of recent posts to return.
+* @returns The recent posts of the collection.
+*/
+function useRecentPosts(collection, count = 5) {
+	const posts = usePosts(collection);
+	return (0, react.useMemo)(() => posts.slice(0, count), [posts, count]);
+}
+
+//#endregion
+//#region src/client/utils/react-to-text.ts
+const reactToText = (node, resolvers) => {
+	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 ((0, react.isValidElement)(node)) {
+		const resolver = resolvers?.get(node.type);
+		if (resolver) return resolver(node.props);
+		return reactToText(node.props.children, resolvers);
+	}
+	return "";
+};
+
+//#endregion
+exports.Banner = Banner;
 exports.BoltdocsShell = BoltdocsShell;
 exports.Breadcrumbs = Breadcrumbs;
-exports.Card = require_mdx.Card;
-exports.Cards = require_mdx.Cards;
+exports.CollectionsContext = CollectionsContext;
 exports.CopyMarkdown = CopyMarkdown;
-exports.DocsLayout = DocsLayout;
+exports.DocsLayout = DocsLayoutComponent;
 exports.ErrorBoundary = ErrorBoundary;
 exports.MdxPage = MdxPage;
 exports.Navbar = Navbar;
@@ -1912,16 +2246,21 @@ exports.copyToClipboard = require_mdx.copyToClipboard;
 exports.createRoutes = createRoutes;
 exports.getStarsRepo = getStarsRepo;
 exports.getTranslated = getTranslated;
-exports.reactToText = require_mdx.reactToText;
+exports.reactToText = reactToText;
 exports.useAnalytics = useAnalytics;
 exports.useBreadcrumbs = useBreadcrumbs;
 exports.useConfig = require_icons_dev.useConfig;
+exports.useHeadings = useHeadings;
 exports.useI18n = useI18n;
 exports.useLocalizedTo = require_icons_dev.useLocalizedTo;
 exports.useLocation = require_docs_layout.useLocation;
 exports.useMdxComponents = useMdxComponents;
+exports.useMergedComponents = useMergedComponents;
 exports.useNavbar = useNavbar;
 exports.usePageNav = usePageNav;
+exports.usePost = usePost;
+exports.usePosts = usePosts;
+exports.useRecentPosts = useRecentPosts;
 exports.useRoutes = require_icons_dev.useRoutes;
 exports.useSearch = require_search_dialog$1.useSearch;
 exports.useSearchHighlight = require_docs_layout.useSearchHighlight;