boltdocs 3.0.2 → 3.1.0

package/dist/client/index.js

@@ -3,18 +3,18 @@
  * Copyright (c) 2026 Jesus Alcala
  * Licensed under the MIT License.
  */
-import { $ as TextAlignStart, C as RoutesProvider, D as Check, E as ArrowLeft, F as FaceBad, I as FaceGood, J as Moon, K as Menu, L as FaceRegular, M as Copy, O as ChevronDown, P as ExternalLink, Q as Sun, S as normalizePath, U as Languages, V as Home, X as Pencil, _ as Link$1, at as useBoltdocsContext, b as useLocalizedTo, et as X, it as BoltdocsProvider, j as CircleHelp, nt as ConfigContext, q as Monitor, rt as useConfig, s as Github, tt as icons_exports, x as useRoutes, y as cn } from "../icons-dev-kJyGWNeg.js";
-import { c as ThemeProvider, l as useTheme } from "../image-C9md50h2.js";
-import { n as useCodeBlock, r as copyToClipboard, t as mdx_components_default } from "../mdx-DhyMkc35.js";
-import { A as useUI, C as useSidebar, D as ButtonGroup, O as Breadcrumbs$2, S as useLocation, T as Menu$1, f as PageNav$1, k as UIProvider, m as OnThisPage$1, n as Sidebar$1, t as DocsLayout$1, w as Tabs$1, x as useSearchHighlight } from "../docs-layout-6FQ8__ok.js";
-import { a as Button$1, n as Navbar$1, r as ErrorBoundary$1 } from "../search-dialog-DaeSPvEo.js";
-import { n as useSearch, r as InternalErrorBoundary, t as SearchDialog } from "../search-dialog-DDopgbKM.js";
+import { $ as TextAlignStart, C as RoutesProvider, D as Check, E as ArrowLeft, F as FaceBad, I as FaceGood, J as Moon, K as Menu, L as FaceRegular, M as Copy, O as ChevronDown, P as ExternalLink, Q as Sun, S as normalizePath, U as Languages, V as Home, X as Pencil, _ as Link$1, at as useBoltdocsContext, b as useLocalizedTo, et as X, it as BoltdocsProvider, j as CircleHelp, nt as ConfigContext, q as Monitor, rt as useConfig, s as Github, tt as icons_exports, x as useRoutes, y as cn } from "../icons-dev-CHZOwhQA.js";
+import { c as ThemeProvider, l as useTheme } from "../image-5WsgWYTh.js";
+import { n as useCodeBlock, r as copyToClipboard, t as mdx_components_default } from "../mdx-Bv-pS6-O.js";
+import { A as useUI, C as useSidebar, D as ButtonGroup, O as Breadcrumbs$2, S as useLocation, T as Menu$1, f as PageNav$1, k as UIProvider, m as OnThisPage$1, n as Sidebar$1, t as DocsLayout$1, w as Tabs$1, x as useSearchHighlight } from "../docs-layout-DyLDBwS6.js";
+import { a as Button$1, n as Navbar$1, r as ErrorBoundary$1 } from "../search-dialog-PJrFRU5G.js";
+import { n as useSearch, r as InternalErrorBoundary, t as SearchDialog } from "../search-dialog-DC7oXU-5.js";
 import { ViteReactSSG } from "@bdocs/ssg";
 import { Suspense, createContext, isValidElement, lazy, use, useCallback, useEffect, useLayoutEffect, useMemo, useRef, useState } from "react";
 import { Link, Outlet, useLoaderData, useLocation as useLocation$1, useMatches, useNavigate } from "react-router-dom";
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
-import * as ReactHelmetAsync from "react-helmet-async";
 import { Button } from "react-aria-components";
+import * as ReactHelmetAsync from "react-helmet-async";
 import virtualCustomComponents from "virtual:boltdocs-mdx-components";
 import virtualIcons from "virtual:boltdocs-icons";
 import DOMPurify from "isomorphic-dompurify";
@@ -49,20 +49,6 @@ function MdxComponentsProvider({ components, children }) {
 	});
 }
 
-//#endregion
-//#region src/client/app/helmet-compat.tsx
-const mod = ReactHelmetAsync;
-/**
-* The `<Helmet>` component, resolved across CJS/ESM module shapes.
-* Falls back to a transparent fragment wrapper if the module cannot be resolved.
-*/
-const Helmet = mod.Helmet || mod.default?.Helmet || (({ children }) => /* @__PURE__ */ jsx(Fragment, { children }));
-/**
-* The `<HelmetProvider>` component, resolved across CJS/ESM module shapes.
-* Falls back to a transparent fragment wrapper if the module cannot be resolved.
-*/
-const HelmetProvider = mod.HelmetProvider || mod.default?.HelmetProvider || (({ children }) => /* @__PURE__ */ jsx(Fragment, { children }));
-
 //#endregion
 //#region src/client/app/scroll-handler.tsx
 /**
@@ -155,6 +141,28 @@ const mdxComponentsDefault = {
 	"404": NotFound
 };
 
+//#endregion
+//#region src/client/app/helmet-compat.tsx
+const mod = ReactHelmetAsync;
+/**
+* The `<Helmet>` component, resolved across CJS/ESM module shapes.
+* Falls back to a transparent fragment wrapper if the module cannot be resolved.
+*/
+const Helmet = mod.Helmet || mod.default?.Helmet || (({ children }) => /* @__PURE__ */ jsx(Fragment, { children }));
+/**
+* The `<HelmetProvider>` component, resolved across CJS/ESM module shapes.
+* Falls back to a transparent fragment wrapper if the module cannot be resolved.
+*/
+const HelmetProvider = mod.HelmetProvider || mod.default?.HelmetProvider || (({ children }) => /* @__PURE__ */ jsx(Fragment, { children }));
+if (typeof globalThis !== "undefined" && globalThis.__BOLTDOCS_SSG_RENDERING__) {
+	const hp = HelmetProvider;
+	if (hp && typeof hp === "function" && hp.canUseDOM) hp.canUseDOM = false;
+}
+if (typeof globalThis !== "undefined") {
+	globalThis.__BOLTDOCS_HELMET_PROVIDER__ = HelmetProvider;
+	globalThis.__BOLTDOCS_HELMET__ = Helmet;
+}
+
 //#endregion
 //#region src/client/utils/i18n.ts
 /**
@@ -307,6 +315,16 @@ const CollectionsContext = createContext({});
 function useCollectionsData() {
 	return use(CollectionsContext);
 }
+const CurrentPostContext = createContext(null);
+function CurrentPostProvider({ value, children }) {
+	return /* @__PURE__ */ jsx(CurrentPostContext.Provider, {
+		value,
+		children
+	});
+}
+function useCurrentPostData() {
+	return use(CurrentPostContext);
+}
 
 //#endregion
 //#region src/client/ssg/boltdocs-shell.tsx
@@ -376,7 +394,7 @@ function BoltdocsShell({ config, routes, components = {}, collectionsData }) {
 		config,
 		routeMap
 	]);
-	return /* @__PURE__ */ jsx(HelmetProvider, { children: /* @__PURE__ */ jsx(RoutesProvider, {
+	return /* @__PURE__ */ jsx(RoutesProvider, {
 		routes,
 		children: /* @__PURE__ */ jsx(ThemeProvider, { children: /* @__PURE__ */ jsx(UIProvider, { children: /* @__PURE__ */ jsx(MdxComponentsProvider, {
 			components: allComponents,
@@ -404,7 +422,7 @@ function BoltdocsShell({ config, routes, components = {}, collectionsData }) {
 				})
 			})
 		}) }) })
-	}) });
+	});
 }
 
 //#endregion
@@ -449,17 +467,43 @@ function DocPage({ route, content: Content, mdxComponents: propComponents }) {
 /**
 * Renders an MDX page by consuming pre-loaded route data.
 *
-* - If the route belongs to a collection (`data.collection` is set), renders
-*   the custom post component if provided, else falls back to the standard DocPage.
+* - If the route belongs to a collection (`data.collection` is set), wraps
+*   the content with `CurrentPostProvider` so that `usePost()` (called without
+*   a slug) can read the current post's data from context.
 * - Otherwise, renders the standard `DocPage` layout.
 */
 function MdxPage({ MDXComponent, mdxComponents: propComponents, collectionPostComponent: CollectionPost }) {
 	const data = useLoaderData();
 	if (!MDXComponent) return null;
-	if (!!data?.collection && CollectionPost) return /* @__PURE__ */ jsx(CollectionPost, {
-		MDXComponent,
-		mdxComponents: propComponents
-	});
+	const collectionData = data;
+	if (!!collectionData?.collection) {
+		const postElement = CollectionPost ? /* @__PURE__ */ jsx(CollectionPost, {
+			MDXComponent,
+			mdxComponents: propComponents
+		}) : /* @__PURE__ */ jsx(DocPage, {
+			route: {
+				path: collectionData.route.path,
+				filePath: collectionData.route.filePath,
+				title: collectionData.route.title,
+				description: collectionData.route.description,
+				headings: collectionData.headings,
+				locale: collectionData.route.locale,
+				version: collectionData.route.version,
+				lastUpdated: collectionData.route.lastUpdated,
+				frontmatter: collectionData.route.frontmatter
+			},
+			content: MDXComponent,
+			mdxComponents: propComponents
+		});
+		return /* @__PURE__ */ jsx(CurrentPostProvider, {
+			value: {
+				route: collectionData.route,
+				headings: collectionData.headings,
+				collection: collectionData.collection
+			},
+			children: postElement
+		});
+	}
 	const docData = data;
 	return /* @__PURE__ */ jsx(DocPage, {
 		route: {
@@ -1022,7 +1066,7 @@ function VersionSelector({ className }) {
 function useI18n() {
 	const navigate = useNavigate();
 	const config = useConfig();
-	const { allRoutes, currentRoute, currentLocale, currentVersion } = useRoutes();
+	const { allRoutes, currentRoute, currentLocale, isCollectionPage } = useRoutes();
 	const i18n = config.i18n;
 	const { setLocale } = useBoltdocsContext();
 	const handleLocaleChange = (locale) => {
@@ -1032,7 +1076,7 @@ function useI18n() {
 		const safeBase = base === "/" ? "" : base.replace(/\/$/, "");
 		const isDocRoute = !!currentRoute?.filePath;
 		let targetPath = "";
-		if (currentRoute) if (isDocRoute) {
+		if (currentRoute) if (isDocRoute && !currentRoute.collection && !isCollectionPage) {
 			const baseFile = getBaseFilePath(currentRoute.filePath, currentRoute.version, currentRoute.locale);
 			const targetRoute = allRoutes.find((r) => getBaseFilePath(r.filePath, r.version, r.locale) === baseFile && (r.locale || i18n.defaultLocale) === locale && r.version === currentRoute.version);
 			if (targetRoute) targetPath = targetRoute.path;
@@ -1044,25 +1088,29 @@ function useI18n() {
 		} else {
 			let rawExternal = currentRoute.path;
 			const parts = rawExternal.split("/").filter(Boolean);
-			if (parts.length > 0 && (Array.isArray(i18n.locales) ? i18n.locales.includes(parts[0]) : !!i18n.locales[parts[0]])) {
-				parts.shift();
+			const localePosition = currentRoute.collection ? 1 : 0;
+			if (parts.length > localePosition && (Array.isArray(i18n.locales) ? i18n.locales.includes(parts[localePosition]) : !!i18n.locales[parts[localePosition]])) {
+				parts.splice(localePosition, 1);
 				rawExternal = "/" + parts.join("/");
 			}
+			const cleanParts = rawExternal.split("/").filter(Boolean);
 			if (locale === i18n.defaultLocale) targetPath = rawExternal === "" ? "/" : rawExternal;
 			else {
-				const cleanExt = rawExternal.startsWith("/") ? rawExternal : `/${rawExternal}`;
-				targetPath = `/${locale}${cleanExt === "/" ? "" : cleanExt}`;
+				cleanParts.splice(localePosition, 0, locale);
+				targetPath = "/" + cleanParts.join("/") || "/";
 			}
 		}
 		else {
-			const targetRoute = allRoutes.find((r) => (r.locale || i18n.defaultLocale) === locale && (r.version || config.versions?.defaultVersion) === (currentVersion || config.versions?.defaultVersion));
-			if (targetRoute) targetPath = targetRoute.path;
+			const currentPath = location.pathname;
+			if (isCollectionPage) targetPath = currentPath;
 			else {
-				const vPath = currentVersion && currentVersion !== config.versions?.defaultVersion ? `/${currentVersion}` : "";
-				targetPath = locale === i18n.defaultLocale ? `${safeBase}${vPath}` : `${safeBase}${vPath}/${locale}`;
+				const parts = currentPath.split("/").filter(Boolean);
+				if (parts.length > 0 && (Array.isArray(i18n.locales) ? i18n.locales.includes(parts[0]) : !!i18n.locales[parts[0]])) parts.shift();
+				if (locale !== i18n.defaultLocale) parts.unshift(locale);
+				targetPath = "/" + parts.join("/");
 			}
 		}
-		if (!targetPath || targetPath === "") targetPath = "/";
+		if (!targetPath || targetPath === "") targetPath = "/s";
 		targetPath = targetPath.replace(/\/+/g, "/");
 		navigate(targetPath);
 	};
@@ -1146,10 +1194,42 @@ function usePageNav() {
 //#region src/client/hooks/use-analytics.ts
 function createAnalyticsInstance(config) {
 	if (typeof window === "undefined") return createDisabledAnalytics();
+	if (window.posthog) return createPostHogAnalytics(config);
 	if (typeof window.gtag === "function") return createGtagAnalytics(config);
 	if (window.dataLayer) return createDataLayerAnalytics(config);
 	return createDisabledAnalytics();
 }
+function createPostHogAnalytics(_config) {
+	return {
+		trackPageView: (path) => {
+			window.posthog?.capture("$pageview", { $current_url: path });
+		},
+		trackEvent: ({ action, category, label, value, params }) => {
+			window.posthog?.capture(action, {
+				event_category: category,
+				event_label: label,
+				value,
+				...params
+			});
+		},
+		trackSearch: (query, resultsCount) => {
+			window.posthog?.capture("search", {
+				query,
+				results_count: resultsCount
+			});
+		},
+		trackDownload: (file, type) => {
+			window.posthog?.capture("file_download", {
+				file_name: file,
+				file_type: type || file.split(".").pop()
+			});
+		},
+		trackExternalLink: (url) => {
+			window.posthog?.capture("external_link", { link_url: url });
+		},
+		isEnabled: true
+	};
+}
 function createGtagAnalytics(config) {
 	return {
 		trackPageView: (path, title) => {
@@ -1433,7 +1513,7 @@ function I18nSelector({ className }) {
 
 //#endregion
 //#region src/client/components/ui-base/navbar.tsx
-const SearchDialog$1 = lazy(() => import("../search-dialog-BNdRV60O.js").then((m) => ({ default: m.SearchDialog })));
+const SearchDialog$1 = lazy(() => import("../search-dialog-gp9lrJXm.js").then((m) => ({ default: m.SearchDialog })));
 function Navbar() {
 	const { links, title, logo, logoProps, github, social, config } = useNavbar();
 	const { routes, currentRoute, isCollectionPage, currentVersion, currentLocale } = useRoutes();
@@ -1464,6 +1544,10 @@ function Navbar() {
 						href: "site:/",
 						children: title
 					}),
+					currentRoute?.draft && /* @__PURE__ */ jsx("span", {
+						className: "hidden sm:inline-flex items-center px-2 py-0.5 rounded-full text-xs font-medium bg-yellow-100 text-yellow-800 dark:bg-yellow-900/30 dark:text-yellow-400 border border-yellow-200 dark:border-yellow-800",
+						children: "Draft"
+					}),
 					/* @__PURE__ */ jsx("div", {
 						className: "hidden sm:block",
 						children: config.versions && currentVersion && /* @__PURE__ */ jsx(VersionSelector, {})
@@ -2194,21 +2278,107 @@ function buildExternalRoutes(options) {
 	};
 }
 
+//#endregion
+//#region src/client/collections/hooks.ts
+const DEFAULT_COLLECTION = "blog";
+/**
+* Returns the posts of a collection, filtered by the current locale and version.
+* Defaults to "blog" if no collection is specified.
+* @param collection - The name of the collection. Defaults to "blog".
+* @param options - Options to customize the query.
+* @param options.includeDrafts - If true, includes draft posts in the results.
+* @returns The filtered posts of the collection.
+*/
+function usePosts(collection = DEFAULT_COLLECTION, options) {
+	const data = useCollectionsData();
+	const { currentLocale, currentVersion } = useRoutes();
+	const config = useConfig();
+	const posts = data[collection] || [];
+	const defaultLocale = config.i18n?.defaultLocale;
+	const defaultVersion = config.versions?.defaultVersion;
+	return useMemo(() => {
+		return posts.filter((post) => {
+			const postLocale = post.locale || defaultLocale;
+			const postVersion = post.version || defaultVersion;
+			const localeMatch = !currentLocale || postLocale === currentLocale;
+			const versionMatch = !currentVersion || postVersion === currentVersion;
+			const draftMatch = options?.includeDrafts || !post.draft;
+			return localeMatch && versionMatch && draftMatch;
+		});
+	}, [
+		posts,
+		currentLocale,
+		currentVersion,
+		defaultLocale,
+		defaultVersion,
+		options?.includeDrafts
+	]);
+}
+function usePost(collection, slug) {
+	const ctx = useCurrentPostData();
+	const posts = usePosts(collection);
+	if (ctx && !slug) {
+		const { route } = ctx;
+		return useMemo(() => ({
+			path: route.path,
+			title: route.title,
+			date: route.date,
+			excerpt: route.excerpt,
+			tags: route.tags,
+			author: route.author,
+			coverImage: route.coverImage,
+			filePath: route.filePath,
+			locale: route.locale,
+			version: route.version,
+			frontmatter: route.frontmatter,
+			lastUpdated: route.lastUpdated,
+			headings: route.headings
+		}), [route]);
+	}
+	if (!collection || !slug) return void 0;
+	return useMemo(() => posts.find((p) => p.path === `/${collection}/${slug}` || p.path.endsWith(`/${slug}`) || p.path === slug), [
+		posts,
+		collection,
+		slug
+	]);
+}
+/**
+* Returns the recent posts of a collection. Defaults to "blog".
+* @param collection - The name of the collection. Defaults to "blog".
+* @param count - The number of recent posts to return.
+* @returns The recent posts of the collection.
+*/
+function useRecentPosts(collection = DEFAULT_COLLECTION, count = 5) {
+	const posts = usePosts(collection);
+	return useMemo(() => posts.slice(0, count), [posts, count]);
+}
+
 //#endregion
 //#region src/client/ssg/create-routes.collection.tsx
 function DefaultCollectionList() {
-	const data = useLoaderData();
-	if (!data || !data.posts) return null;
+	const location = useLocation$1();
+	const config = useConfig();
+	const postsPerPage = config.collections?.postsPerPage ?? 10;
+	const segments = location.pathname.split("/").filter(Boolean);
+	const isLocalePrefixed = config.i18n && segments[0] in (config.i18n.locales || {});
+	const collection = isLocalePrefixed ? segments[1] : segments[0];
+	const currentPage = (isLocalePrefixed ? segments[3] : segments[2]) === "page" ? Number(isLocalePrefixed ? segments[4] : segments[3]) || 1 : 1;
+	const allPosts = usePosts(collection);
+	const totalPages = Math.ceil(allPosts.length / postsPerPage);
+	const start = (currentPage - 1) * postsPerPage;
+	const posts = allPosts.slice(start, start + postsPerPage);
+	if (!posts.length) return null;
+	const basePath = isLocalePrefixed ? `/${segments[0]}/${segments[1]}` : `/${segments[0]}`;
 	return /* @__PURE__ */ jsxs("div", {
 		className: "py-8 max-w-2xl mx-auto px-4",
 		children: [
 			/* @__PURE__ */ jsx("h1", {
 				className: "text-3xl font-bold mb-6 capitalize",
-				children: data.collection
+				children: collection
 			}),
 			/* @__PURE__ */ jsx("div", {
 				className: "space-y-6",
-				children: data.posts.map((post) => /* @__PURE__ */ jsxs("article", {
+				children: posts.map((post) => /* @__PURE__ */ jsxs("article", {
 					className: "border-b border-subtle pb-4",
 					children: [
 						/* @__PURE__ */ jsx("h2", {
@@ -2230,22 +2400,22 @@ function DefaultCollectionList() {
 					]
 				}, post.path))
 			}),
-			data.totalPages > 1 && /* @__PURE__ */ jsxs("div", {
+			totalPages > 1 && /* @__PURE__ */ jsxs("div", {
 				className: "mt-8 flex gap-4 text-sm",
 				children: [
-					data.currentPage > 1 && /* @__PURE__ */ jsx(Link, {
-						to: data.currentPage === 2 ? `/${data.collection}` : `/${data.collection}/page/${data.currentPage - 1}`,
+					currentPage > 1 && /* @__PURE__ */ jsx(Link, {
+						to: currentPage === 2 ? basePath : `${basePath}/page/${currentPage - 1}`,
 						className: "text-primary-600 hover:underline",
 						children: "Previous"
 					}),
 					/* @__PURE__ */ jsxs("span", { children: [
 						"Page ",
-						data.currentPage,
+						currentPage,
 						" of ",
-						data.totalPages
+						totalPages
 					] }),
-					data.currentPage < data.totalPages && /* @__PURE__ */ jsx(Link, {
-						to: `/${data.collection}/page/${data.currentPage + 1}`,
+					currentPage < totalPages && /* @__PURE__ */ jsx(Link, {
+						to: `${basePath}/page/${currentPage + 1}`,
 						className: "text-primary-600 hover:underline",
 						children: "Next"
 					})
@@ -2336,6 +2506,9 @@ function buildCollectionRoutes(options) {
 			author: r.author,
 			coverImage: r.coverImage,
 			filePath: r.filePath,
+			locale: r.locale,
+			version: r.version,
+			lastUpdated: r.lastUpdated,
 			frontmatter: r.frontmatter
 		}));
 		const ListElement = collectionLists?.[colName] || DefaultCollectionList;
@@ -2416,18 +2589,6 @@ function createRoutes(options) {
 function DocsLayoutComponent({ children }) {
 	const { routes: filteredRoutes, currentRoute, isCollectionPage } = useRoutes();
 	const config = useConfig();
-	const AskAiDialog = useMergedComponents().AskAiDialog;
-	const [isAskAiOpen, setIsAskAiOpen] = useState(false);
-	useEffect(() => {
-		const handleOpen = () => setIsAskAiOpen(true);
-		const handleClose = () => setIsAskAiOpen(false);
-		window.addEventListener("boltdocs:ask-ai:open", handleOpen);
-		window.addEventListener("boltdocs:ask-ai:close", handleClose);
-		return () => {
-			window.removeEventListener("boltdocs:ask-ai:open", handleOpen);
-			window.removeEventListener("boltdocs:ask-ai:close", handleClose);
-		};
-	}, []);
 	return /* @__PURE__ */ jsxs(DocsLayout$1, {
 		className: "selection:bg-primary-500/10 selection:text-primary-500",
 		children: [/* @__PURE__ */ jsx(Navbar, {}), /* @__PURE__ */ jsxs(DocsLayout$1.Body, {
@@ -2469,8 +2630,7 @@ function DocsLayoutComponent({ children }) {
 						]
 					})
 				}),
-				AskAiDialog && /* @__PURE__ */ jsx(AskAiDialog, {}),
-				!isCollectionPage && !isAskAiOpen && /* @__PURE__ */ jsx(OnThisPage, {
+				/* @__PURE__ */ jsx(OnThisPage, {
 					headings: currentRoute?.headings,
 					filePath: currentRoute?.filePath,
 					communityHelp: config.theme?.communityHelp,
@@ -2481,53 +2641,6 @@ function DocsLayoutComponent({ children }) {
 	});
 }
 
-//#endregion
-//#region src/client/collections/hooks.ts
-/**
-* Returns the posts of a collection.
-* @param collection - The name of the collection.
-* @returns The posts of the collection.
-*/
-function usePosts(collection) {
-	const data = useCollectionsData();
-	const { currentLocale, currentVersion } = useRoutes();
-	const config = useConfig();
-	const posts = data[collection] || [];
-	const defaultLocale = config.i18n?.defaultLocale;
-	const defaultVersion = config.versions?.defaultVersion;
-	return useMemo(() => {
-		return posts.filter((post) => {
-			const postLocale = post.locale || defaultLocale;
-			const postVersion = post.version || defaultVersion;
-			return (!currentLocale || postLocale === currentLocale) && (!currentVersion || postVersion === currentVersion);
-		});
-	}, [
-		posts,
-		currentLocale,
-		currentVersion,
-		defaultLocale,
-		defaultVersion
-	]);
-}
-function usePost(collection, slug) {
-	const posts = usePosts(collection);
-	return useMemo(() => posts.find((p) => p.path === `/${collection}/${slug}` || p.path.endsWith(`/${slug}`) || p.path === slug), [
-		posts,
-		collection,
-		slug
-	]);
-}
-/**
-* Returns the recent posts of a collection.
-* @param collection - The name of the collection.
-* @param count - The number of recent posts to return.
-* @returns The recent posts of the collection.
-*/
-function useRecentPosts(collection, count = 5) {
-	const posts = usePosts(collection);
-	return useMemo(() => posts.slice(0, count), [posts, count]);
-}
-
 //#endregion
 //#region src/client/utils/react-to-text.ts
 const reactToText = (node, resolvers) => {
@@ -2543,4 +2656,4 @@ const reactToText = (node, resolvers) => {
 };
 
 //#endregion
-export { Banner, BoltdocsShell, Breadcrumbs, CollectionsContext, CopyMarkdown, DocsLayoutComponent as DocsLayout, ErrorBoundary, MdxPage, Navbar, NotFound, OnThisPage, PageNav, SearchDialog, Sidebar, ViteReactSSG, cn, copyToClipboard, createRoutes, getStarsRepo, getTranslated, reactToText, useAnalytics, useBreadcrumbs, useCodeBlock, useConfig, useFeedback, useHeadings, useI18n, useLocalizedTo, useLocation, useMdxComponents, useMergedComponents, useNavbar, usePageNav, usePost, usePosts, useRecentPosts, useRoutes, useSearch, useSearchHighlight, useSidebar, useTabs, useTheme, useTrackEvent, useTrackPageView, useUI, useVersion };
+export { Banner, BoltdocsShell, Breadcrumbs, CollectionsContext, CopyMarkdown, CurrentPostProvider, DocsLayoutComponent as DocsLayout, ErrorBoundary, MdxPage, Navbar, NotFound, OnThisPage, PageNav, SearchDialog, Sidebar, ViteReactSSG, cn, copyToClipboard, createRoutes, getStarsRepo, getTranslated, reactToText, useAnalytics, useBreadcrumbs, useCodeBlock, useConfig, useFeedback, useHeadings, useI18n, useLocalizedTo, useLocation, useMdxComponents, useMergedComponents, useNavbar, usePageNav, usePost, usePosts, useRecentPosts, useRoutes, useSearch, useSearchHighlight, useSidebar, useTabs, useTheme, useTrackEvent, useTrackPageView, useUI, useVersion };

package/dist/client/mdx.cjs

@@ -4,7 +4,7 @@
  * Licensed under the MIT License.
  */
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_mdx = require('../mdx-DJBg5DuL.cjs');
+const require_mdx = require('../mdx-CDUcJmye.cjs');
 
 //#region src/client/mdx.ts
 const { Card, Cards, Callout, Field, Image } = require_mdx.mdx_components_default;

package/dist/client/mdx.js

@@ -3,7 +3,7 @@
  * Copyright (c) 2026 Jesus Alcala
  * Licensed under the MIT License.
  */
-import { t as mdx_components_default } from "../mdx-DhyMkc35.js";
+import { t as mdx_components_default } from "../mdx-Bv-pS6-O.js";
 
 //#region src/client/mdx.ts
 const { Card, Cards, Callout, Field, Image } = mdx_components_default;

package/dist/client/primitives.cjs

@@ -4,10 +4,10 @@
  * Licensed under the MIT License.
  */
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_icons_dev = require('../icons-dev-BryEFkJu.cjs');
-const require_image = require('../image-CR6UlaI5.cjs');
-const require_docs_layout = require('../docs-layout-3TpAt6MB.cjs');
-const require_search_dialog = require('../search-dialog-D4rplZMv.cjs');
+const require_icons_dev = require('../icons-dev-YtDoLUsb.cjs');
+const require_image = require('../image-Hb105Gu6.cjs');
+const require_docs_layout = require('../docs-layout-D1buSdua.cjs');
+const require_search_dialog = require('../search-dialog-BpNULmrl.cjs');
 let react_jsx_runtime = require("react/jsx-runtime");
 
 //#region src/client/components/primitives/skeleton.tsx

package/dist/client/primitives.d.cts

@@ -1,5 +1,5 @@
 
-import { A as BoltdocsRoutePathWithFallback, a as SidebarItem, c as SidebarItemsProps, d as SidebarMobile, f as SidebarRoot, i as SidebarHeader, l as SidebarLink, m as ComponentBase, n as SidebarContent, o as SidebarItemProps, p as SidebarSubGroup, r as SidebarGroup, s as SidebarItems, t as Sidebar, u as SidebarLinkProps } from "../sidebar-7gIifpBX.cjs";
+import { A as BoltdocsRoutePathWithFallback, a as SidebarItem, c as SidebarItemsProps, d as SidebarMobile, f as SidebarRoot, i as SidebarHeader, l as SidebarLink, m as ComponentBase, n as SidebarContent, o as SidebarItemProps, p as SidebarSubGroup, r as SidebarGroup, s as SidebarItems, t as Sidebar, u as SidebarLinkProps } from "../sidebar-DH2iPKXM.cjs";
 import * as React$2 from "react";
 import { Component, ComponentProps, ComponentType, ErrorInfo, ImgHTMLAttributes, ReactNode, RefObject } from "react";
 import * as _$react_jsx_runtime0 from "react/jsx-runtime";

package/dist/client/primitives.d.ts

@@ -1,5 +1,5 @@
 
-import { A as BoltdocsRoutePathWithFallback, a as SidebarItem, c as SidebarItemsProps, d as SidebarMobile, f as SidebarRoot, i as SidebarHeader, l as SidebarLink, m as ComponentBase, n as SidebarContent, o as SidebarItemProps, p as SidebarSubGroup, r as SidebarGroup, s as SidebarItems, t as Sidebar, u as SidebarLinkProps } from "../sidebar-BAKgJ-Er.js";
+import { A as BoltdocsRoutePathWithFallback, a as SidebarItem, c as SidebarItemsProps, d as SidebarMobile, f as SidebarRoot, i as SidebarHeader, l as SidebarLink, m as ComponentBase, n as SidebarContent, o as SidebarItemProps, p as SidebarSubGroup, r as SidebarGroup, s as SidebarItems, t as Sidebar, u as SidebarLinkProps } from "../sidebar-DknLUI1R.js";
 import * as React$2 from "react";
 import { Component, ComponentProps, ComponentType, ErrorInfo, ImgHTMLAttributes, ReactNode, RefObject } from "react";
 import * as _$react_jsx_runtime0 from "react/jsx-runtime";

package/dist/client/primitives.js

@@ -3,10 +3,10 @@
  * Copyright (c) 2026 Jesus Alcala
  * Licensed under the MIT License.
  */
-import { _ as Link, v as NavLink, y as cn } from "../icons-dev-kJyGWNeg.js";
-import { a as CodeBlockGroup, i as CodeBlockContent, n as Tooltip, o as CodeBlockHeader, r as CodeBlock, s as Heading, t as Image } from "../image-C9md50h2.js";
-import { D as ButtonGroup, E as Popover, O as Breadcrumbs, T as Menu, _ as ScrollProvider, a as SidebarHeader, b as useItems, c as SidebarLink, d as SidebarSubGroup, f as PageNav, g as OnThisPageTree, h as OnThisPageItems, i as SidebarGroup, l as SidebarMobile, m as OnThisPage, n as Sidebar, o as SidebarItem, p as AnchorProvider, r as SidebarContent, s as SidebarItems, t as DocsLayout, u as SidebarRoot, v as useActiveAnchor, w as Tabs, y as useActiveAnchors } from "../docs-layout-6FQ8__ok.js";
-import { a as Button, i as ErrorBoundaryFallback, n as Navbar, r as ErrorBoundary, t as SearchDialog } from "../search-dialog-DaeSPvEo.js";
+import { _ as Link, v as NavLink, y as cn } from "../icons-dev-CHZOwhQA.js";
+import { a as CodeBlockGroup, i as CodeBlockContent, n as Tooltip, o as CodeBlockHeader, r as CodeBlock, s as Heading, t as Image } from "../image-5WsgWYTh.js";
+import { D as ButtonGroup, E as Popover, O as Breadcrumbs, T as Menu, _ as ScrollProvider, a as SidebarHeader, b as useItems, c as SidebarLink, d as SidebarSubGroup, f as PageNav, g as OnThisPageTree, h as OnThisPageItems, i as SidebarGroup, l as SidebarMobile, m as OnThisPage, n as Sidebar, o as SidebarItem, p as AnchorProvider, r as SidebarContent, s as SidebarItems, t as DocsLayout, u as SidebarRoot, v as useActiveAnchor, w as Tabs, y as useActiveAnchors } from "../docs-layout-DyLDBwS6.js";
+import { a as Button, i as ErrorBoundaryFallback, n as Navbar, r as ErrorBoundary, t as SearchDialog } from "../search-dialog-PJrFRU5G.js";
 import { jsx } from "react/jsx-runtime";
 
 //#region src/client/components/primitives/skeleton.tsx

package/dist/client/theme/neutral.css

@@ -72,7 +72,7 @@
   --color-subtle: var(--color-neutral-200);
   --color-strong: var(--color-neutral-300);
   --color-code-bg: var(--color-neutral-100);
-  --color-code-text: #eb5828;
+  --color-code-text: color-mix(in srgb, var(--color-body) 80%, transparent);
 
   /* Semantic Colors - Dark Override (handled via standard CSS overrides below the @theme block) */
 
@@ -138,6 +138,4 @@
   --color-strong: #3c3c39;
   /* Strong dark border */
   --color-code-bg: var(--color-neutral-900);
-  --color-code-text: #eb5828;
-  /* Outstanding terracotta orange inline code */
 }

package/dist/{config-JGkMJoJQ.cjs → config-BxsogK5A.cjs}

@@ -3,4 +3,4 @@
  * Copyright (c) 2026 Jesus Alcala
  * Licensed under the MIT License.
  */
-const e=require(`./config-B5uVv5q4.cjs`);exports.CONFIG_FILES=e.t,exports.defineConfig=e.a,exports.resolveConfig=e.n,exports.resolveConfigAndGenerateTypes=e.r;
+const e=require(`./config-DrRQYDCI.cjs`);exports.CONFIG_FILES=e.t,exports.defineConfig=e.a,exports.resolveConfig=e.n,exports.resolveConfigAndGenerateTypes=e.r;

package/dist/config-DAgpZyh6.mjs

@@ -0,0 +1,7 @@
+/**
+ * Boltdocs - https://boltdocs.vercel.app
+ * Copyright (c) 2026 Jesus Alcala
+ * Licensed under the MIT License.
+ */
+import{t as e}from"./rolldown-runtime-fkIsjY3S.mjs";import{r as t}from"./errors-C0Hx15Ag.mjs";import{t as n}from"./types-generator-DVOnRVKU.mjs";import r from"node:path";import i from"node:fs";import{z as a}from"zod";import{warn as o}from"@bdocs/dui";function s(e){return e}const c=a.object({icon:a.string().max(50),link:a.string().url()});a.object({text:a.string().max(2e3).optional()});const l=a.object({processor:a.enum([`unified`,`satteri`]).optional()}),u=a.object({name:a.string(),enforce:a.enum([`pre`,`post`]).optional(),version:a.string().optional(),boltdocsVersion:a.string().optional(),remarkPlugins:a.array(a.unknown()).optional(),rehypePlugins:a.array(a.unknown()).optional(),vitePlugins:a.array(a.unknown()).optional(),components:a.record(a.string(),a.string()).optional(),hooks:a.record(a.string(),a.unknown()).optional()}),d=a.object({title:a.union([a.string(),a.record(a.string(),a.string())]).optional(),description:a.union([a.string(),a.record(a.string(),a.string())]).optional(),logo:a.union([a.string(),a.object({dark:a.string(),light:a.string(),alt:a.string().optional(),width:a.number().optional(),height:a.number().optional()})]).optional(),navbar:a.array(a.object({label:a.union([a.string(),a.record(a.string(),a.string())]),href:a.string(),items:a.array(a.object({label:a.union([a.string(),a.record(a.string(),a.string())]),href:a.string()})).optional()})).optional(),sidebar:a.record(a.string(),a.array(a.object({text:a.string(),link:a.string()}))).optional(),sidebarGroups:a.record(a.string(),a.object({title:a.union([a.string(),a.record(a.string(),a.string())]).optional(),icon:a.string().optional()})).optional(),socialLinks:a.array(c).optional(),editLink:a.string().refine(e=>!e||e.includes(`:path`),{message:`editLink must contain ':path' placeholder if specified`}).optional(),communityHelp:a.string().url().optional(),version:a.string().max(50).optional(),githubRepo:a.string().max(100).optional(),favicon:a.string().optional(),tabs:a.array(a.object({id:a.string(),text:a.union([a.string(),a.record(a.string(),a.string())]),icon:a.string().optional()})).optional(),codeTheme:a.union([a.string(),a.object({light:a.string(),dark:a.string()})]).optional()}),f=a.union([a.string(),a.object({rules:a.array(a.object({userAgent:a.string(),allow:a.union([a.string(),a.array(a.string())]).optional(),disallow:a.union([a.string(),a.array(a.string())]).optional()})).optional(),sitemaps:a.array(a.string().url()).optional()})]),p=a.object({defaultLocale:a.string(),locales:a.union([a.record(a.string(),a.string()),a.array(a.string())]).transform(e=>Array.isArray(e)?Object.fromEntries(e.map(e=>[e,e])):e),localeConfigs:a.record(a.string(),a.object({label:a.string().optional(),direction:a.enum([`ltr`,`rtl`]).optional(),htmlLang:a.string().optional(),calendar:a.string().optional()})).optional()}),m=a.object({defaultVersion:a.string(),prefix:a.string().optional(),versions:a.array(a.object({label:a.string(),path:a.string()}))}),h=a.object({headers:a.record(a.string(),a.string()).optional(),enableCSP:a.boolean().optional(),customHeaders:a.record(a.string(),a.string()).optional()}),g=a.object({google:a.string().optional(),bing:a.string().optional(),yandex:a.string().optional(),pinterest:a.string().optional(),facebook:a.string().optional()}),_=a.object({metatags:a.record(a.string(),a.string()).optional(),indexing:a.enum([`all`,`public`]).optional(),thumbnails:a.object({background:a.string().optional()}).optional(),verification:g.optional()}),v=a.object({measurementId:a.string().min(1,`Measurement ID is required for GA4`),debug:a.boolean().optional(),anonymizeIp:a.boolean().optional(),sendPageView:a.boolean().optional(),cookieFlags:a.string().optional(),autoTrack:a.object({pageViews:a.boolean().optional(),downloads:a.boolean().optional(),externalLinks:a.boolean().optional(),search:a.boolean().optional()}).optional()}),y=a.object({tagId:a.string().min(1,`Tag ID is required for GTM`),dataLayerName:a.string().optional(),preview:a.string().optional()}),b=a.object({appId:a.string().min(1,`Algolia App ID is required`),apiKey:a.string().min(1,`Algolia API Key is required`),indexName:a.string().min(1,`Algolia Index Name is required`)}),x=a.object({repo:a.string().min(1,`Giscus repository is required`),repoId:a.string().min(1,`Giscus repository ID is required`),category:a.string().optional(),categoryId:a.string().optional(),mapping:a.enum([`pathname`,`url`,`title`,`og:title`,`specific`,`number`]).optional(),strict:a.union([a.enum([`0`,`1`]),a.boolean()]).optional(),reactionsEnabled:a.union([a.enum([`0`,`1`]),a.boolean()]).optional(),emitMetadata:a.union([a.enum([`0`,`1`]),a.boolean()]).optional(),inputPosition:a.enum([`top`,`bottom`]).optional(),theme:a.string().optional(),darkTheme:a.string().optional(),lang:a.string().optional(),loading:a.enum([`lazy`,`eager`]).optional()}),S=a.object({enabled:a.boolean(),owner:a.string().min(1,`GitHub owner is required`),repo:a.string().min(1,`GitHub repository name is required`),categorySlug:a.string().optional(),endpoint:a.string().optional()}),C=a.object({analytics:a.boolean().optional(),speedInsights:a.boolean().optional()}),w=a.object({apiKey:a.string().min(1,`API key is required for PostHog`),host:a.string().url().optional(),capturePageview:a.boolean().optional(),capturePageleave:a.boolean().optional(),sessionRecording:a.boolean().optional(),autocapture:a.boolean().optional()}),T=a.object({ga4:v.optional(),gtm:y.optional(),vercel:C.optional(),posthog:w.optional()}),E=a.object({algolia:b.optional()}),D=a.object({giscus:x.optional(),custom:S.optional()}),O=a.object({analytics:T.optional(),search:E.optional(),feedback:D.optional()}),k=a.object({visible:a.boolean().optional(),environments:a.array(a.string()).optional()}),A=a.object({siteUrl:a.string().url().optional(),docsDir:a.string().optional(),base:a.string().optional(),theme:d.optional(),i18n:p.optional(),versions:m.optional(),mdx:l.optional(),plugins:a.array(u).optional(),robots:f.optional(),security:h.optional(),seo:_.optional(),integrations:O.optional(),drafts:k.optional(),featureFlags:a.record(a.string(),a.union([a.boolean(),a.string()])).optional(),vite:a.record(a.string(),a.unknown()).optional()});var j=e({CONFIG_FILES:()=>M,defineConfig:()=>s,resolveConfig:()=>N,resolveConfigAndGenerateTypes:()=>P});const M=[`boltdocs.config.js`,`boltdocs.config.mjs`,`boltdocs.config.ts`];async function N(e,n=process.cwd()){let a=n,s={docsDir:r.resolve(e),theme:{title:`Boltdocs`,description:`A Vite documentation framework`,navbar:[{label:`Home`,href:`/`},{label:`Documentation`,href:`/docs`}],codeTheme:{light:`github-light`,dark:`github-dark`}}},c={};for(let e of M){let t=r.resolve(a,e);if(i.existsSync(t))try{let{loadConfigFromFile:e}=await import(`vite`),n=await e({command:`serve`,mode:`development`},t,a);if(n){c=n.config;break}}catch(t){t instanceof Error&&o(`Failed to load config from ${e}: ${t}`)}}let l={title:c.title,description:c.description,logo:c.logo,favicon:c.favicon,navbar:c.navbar,sidebar:c.sidebar,sidebarGroups:c.theme?.sidebarGroups,socialLinks:c.socialLinks,githubRepo:c.githubRepo,tabs:c.tabs,codeTheme:c.codeTheme,communityHelp:c.communityHelp,version:c.version,editLink:c.editLink,...c.theme||{}},u=Object.fromEntries(Object.entries(l).filter(([e,t])=>t!==void 0));u.navbar&&=u.navbar.map(e=>({label:e.label||``,href:e.href||``,items:e.items}));let d={docsDir:r.resolve(e),theme:{...s.theme,...u},i18n:c.i18n?{...c.i18n,locales:Array.isArray(c.i18n.locales)?Object.fromEntries(c.i18n.locales.map(e=>[e,e])):c.i18n.locales}:void 0,versions:c.versions,siteUrl:c.siteUrl,base:c.base,seo:c.seo,plugins:c.plugins||[],robots:c.robots,security:c.security,integrations:c.integrations,vite:c.vite},f=A.safeParse(d);if(!f.success)throw new t(`Invalid Boltdocs configuration:\n${f.error.issues.map(e=>`  - ${e.path.join(`.`)}: ${e.message}`).join(`
+`)}`);return f.data}async function P(e,t=process.cwd()){let r=await N(e,t);return n(r,e,t),r}export{s as a,u as i,j as n,N as r,M as t};