boltdocs 3.3.6 → 3.4.0

package/dist/client/index.js

@@ -3,13 +3,13 @@
  * Copyright (c) 2026 Jesus Alcala
  * Licensed under the MIT License.
  */
-import { B as Sun, C as ExternalLink, E as FaceRegular, F as Monitor, G as useConfig, H as X, I as Moon, J as useBoltdocsContext, P as Menu, R as Pencil, T as FaceGood, V as TextAlignStart, W as ConfigContext, _ as ChevronDown, a as useViewTransition, b as CircleHelp, c as RoutesProvider, d as normalizePath, f as resolvePublicAssetUrl, g as Check, h as ArrowLeft, i as startViewTransition, j as Languages, k as Home, o as cn, q as BoltdocsProvider, s as useLocalizedTo, t as Link, v as ChevronLeft, w as FaceBad, x as Copy, y as ChevronRight } from "../link-q1qHNGK_.js";
-import { A as useRouteData, B as normalizeBasename, C as Outlet, D as useMatches, E as useLocation, F as PrefetchContext, I as RouteDataContext, L as defaultNavigate, M as LocationProvider, N as MatchesContext, O as useNavigate, P as NavigateContext, R as addBasename, S as resolveRouteBranch, T as useLoaderData, V as stripBasename, _ as stripSiteProtocol, a as getConfiguredVersions, b as matchRouteBranch, c as hasUriScheme, d as isConfiguredVersion, f as normalizeUrlBase, g as splitUrlReference, h as resolveUrlReference, i as getConfiguredLocales, j as LocationContext, k as usePrefetch, l as hasUrlBase, m as parseUrlReference, n as buildUrl, o as getVersionPrefixSegments, p as normalizeUrlPath, r as classifyUrlPath, s as getVersionSegments, t as addUrlBase, u as isConfiguredLocale, v as stripUrlBase, w as OutletContext, x as matchRouteBranchWithParams, y as RouteRenderer, z as hasBasename } from "../router-CZBxMRAH.js";
-import { _ as useTheme, g as ThemeProvider } from "../image-BAiDReNd.js";
-import { a as useCopyButton, i as useExpandable, n as Timeline, o as copyToClipboard, r as useCodeBlockFeedback, t as mdx_components_default } from "../mdx-CJGWzBGy.js";
-import { A as useUI, C as resolveIcon, D as ButtonGroup, O as Breadcrumbs$2, S as IconRenderer, 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 useSidebar } from "../docs-layout-D3Fmb0Wd.js";
-import { a as useRoutes, i as InternalErrorBoundary, r as useSearch, t as SearchDialog } from "../search-dialog-DzObE-Ar.js";
-import { a as Github, c as Button$1, i as Navbar$1, o as ErrorBoundary$1, r as useSearchHighlight } from "../search-dialog-mYnqU4v7.js";
+import { B as X, C as FaceGood, D as Home, H as BoltdocsProvider, I as Pencil, M as Menu$1, N as Monitor, P as Moon, R as Sun, S as FaceBad, U as useBoltdocsContext, _ as ChevronRight, a as useLocalizedTo, g as ChevronLeft, h as ChevronDown, i as cn, k as Languages, l as normalizePath, m as Check, o as RoutesProvider, p as ArrowLeft, t as Link, u as resolvePublicAssetUrl, v as CircleHelp, w as FaceRegular, x as ExternalLink, y as Copy, z as TextAlignStart } from "../link-CSe_oD8Y.js";
+import { A as useRouteData, B as ConfigContext, C as Outlet, D as useMatches, E as useLocation, F as PrefetchContext, G as normalizeBasename, I as RouteDataContext, K as stripBasename, L as defaultNavigate, M as LocationProvider, N as MatchesContext, O as useNavigate, P as NavigateContext, R as startViewTransition, S as resolveRouteBranch, T as useLoaderData, U as addBasename, V as useConfig, W as hasBasename, _ as stripSiteProtocol, a as getConfiguredVersions, b as matchRouteBranch, c as hasUriScheme, d as isConfiguredVersion, f as normalizeUrlBase, g as splitUrlReference, h as resolveUrlReference, i as getConfiguredLocales, j as LocationContext, k as usePrefetch, l as hasUrlBase, m as parseUrlReference, n as buildUrl, o as getVersionPrefixSegments, p as normalizeUrlPath, r as classifyUrlPath, s as getVersionSegments, t as addUrlBase, u as isConfiguredLocale, v as stripUrlBase, w as OutletContext, x as matchRouteBranchWithParams, y as RouteRenderer, z as useViewTransition } from "../router-B5e8k4qK.js";
+import { _ as useTheme, g as ThemeProvider } from "../image-CaY2w0ua.js";
+import { a as useExpandable, i as useCodeBlockFeedback, n as Timeline, o as useCopyButton, r as formatDeterministicDate, s as copyToClipboard, t as mdx_components_default } from "../mdx-BijiEbkp.js";
+import { A as useUI, C as resolveIcon, D as ButtonGroup, O as Breadcrumbs$2, S as IconRenderer, T as Menu$2, 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 useSidebar } from "../docs-layout-CmntYM6p.js";
+import { a as useRoutes, i as InternalErrorBoundary, r as useSearch, t as SearchDialog } from "../search-dialog-DeplpVEB.js";
+import { a as Github, c as Button$1, i as Navbar$1, o as ErrorBoundary$1, r as useSearchHighlight } from "../search-dialog-BXil4_7P.js";
 import { ViteReactSSG } from "@bdocs/ssg";
 import { Suspense, createContext, isValidElement, lazy, use, useCallback, useEffect, useMemo, useRef, useState } from "react";
 import { Fragment as Fragment$1, jsx, jsxs } from "react/jsx-runtime";
@@ -651,12 +651,12 @@ 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), wraps
-*   the content with `CurrentPostProvider` so that `usePost()` (called without
-*   a slug) can read the current post's data from context.
+* - If the route belongs to a collection, 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 }) {
+function MdxPage({ MDXComponent, mdxComponents: propComponents, collectionPostComponent: CollectionPost, collection, route: routeProp }) {
 	const data = useLoaderData();
 	const mdxComponents = {
 		...useMdxComponents(),
@@ -664,30 +664,37 @@ function MdxPage({ MDXComponent, mdxComponents: propComponents, collectionPostCo
 	};
 	if (!MDXComponent) return null;
 	const collectionData = data || {};
-	if (!!collectionData?.collection && !!collectionData?.route) {
+	const isCollection = collection ? true : !!collectionData?.collection && !!collectionData?.route;
+	/**
+	* The loader's own copy of the route, falling back to the route table so the
+	* first client render has the same metadata the server used.
+	*/
+	const postRoute = collectionData.route ?? routeProp;
+	const postHeadings = collectionData.headings ?? routeProp?.headings ?? [];
+	if (isCollection) {
 		const postElement = CollectionPost ? /* @__PURE__ */ jsx(CollectionPost, {
 			MDXComponent,
 			mdxComponents
 		}) : /* @__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
+				path: postRoute?.path || "",
+				filePath: postRoute?.filePath || "",
+				title: postRoute?.title,
+				description: postRoute?.description,
+				headings: postHeadings,
+				locale: postRoute?.locale,
+				version: postRoute?.version,
+				lastUpdated: postRoute?.lastUpdated,
+				frontmatter: postRoute?.frontmatter
 			},
 			content: MDXComponent,
 			mdxComponents
 		});
 		return /* @__PURE__ */ jsx(CurrentPostProvider, {
 			value: {
-				route: collectionData.route,
-				headings: collectionData.headings,
-				collection: collectionData.collection
+				route: postRoute,
+				headings: postHeadings,
+				collection: collection ?? collectionData.collection
 			},
 			children: postElement
 		});
@@ -840,14 +847,14 @@ function CopyMarkdown({ content, mdxRaw, route, className }) {
 					className: 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__ */ jsx(Check, { size: 16 }) : /* @__PURE__ */ jsx(Copy, { size: 16 }), copied ? "Copied!" : "Copy Markdown"]
 				}),
-				/* @__PURE__ */ jsxs(Menu$1.Trigger, {
+				/* @__PURE__ */ jsxs(Menu$2.Trigger, {
 					placement: "bottom end",
 					children: [/* @__PURE__ */ jsx(Button$1, {
 						className: 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__ */ jsx(ChevronDown, { size: 14 })
-					}), /* @__PURE__ */ jsxs(Menu$1.Root, {
+					}), /* @__PURE__ */ jsxs(Menu$2.Root, {
 						className: "w-52 bg-main border border-subtle rounded-xl p-1.5 shadow-md outline-none flex flex-col gap-0.5 animate-fade-in z-100",
-						children: [/* @__PURE__ */ jsxs(Menu$1.Item, {
+						children: [/* @__PURE__ */ jsxs(Menu$2.Item, {
 							onAction: handleCopy,
 							className: "flex items-center px-3 py-2 rounded-lg text-xs font-medium text-body dark:hover:bg-primary-300/50 hover:bg-primary-200/50 transition-colors duration-100 cursor-pointer select-none outline-none group",
 							children: [/* @__PURE__ */ jsx(Copy, {
@@ -857,7 +864,7 @@ function CopyMarkdown({ content, mdxRaw, route, className }) {
 								className: "ml-2",
 								children: "Copy Markdown"
 							})]
-						}), /* @__PURE__ */ jsxs(Menu$1.Item, {
+						}), /* @__PURE__ */ jsxs(Menu$2.Item, {
 							onAction: handleOpenRaw,
 							className: "flex items-center gap-2 px-3 py-2 rounded-lg text-xs font-medium text-body dark:hover:bg-primary-300/50 hover:bg-primary-200/50 transition-colors duration-100 cursor-pointer select-none outline-none group",
 							children: [/* @__PURE__ */ jsx(ExternalLink, {
@@ -999,7 +1006,13 @@ function useNavbar() {
 	return {
 		links,
 		title,
-		logo: !logo ? null : typeof logo === "string" ? logo : resolvedTheme === "dark" ? logo.dark : logo.light,
+		logo: !logo ? null : typeof logo === "string" ? {
+			light: logo,
+			dark: null
+		} : {
+			light: logo.light,
+			dark: logo.dark
+		},
 		logoProps: {
 			alt: (logo && typeof logo === "object" ? logo.alt : void 0) || title,
 			width: logo && typeof logo === "object" ? logo.width : void 0,
@@ -1022,7 +1035,7 @@ function ThemeToggle({ className }) {
 	}, []);
 	if (!mounted) return /* @__PURE__ */ jsx("div", { className: cn("h-9 w-9", className) });
 	const Icon = theme === "system" ? Monitor : theme === "dark" ? Moon : Sun;
-	return /* @__PURE__ */ jsxs(Menu$1.Trigger, {
+	return /* @__PURE__ */ jsxs(Menu$2.Trigger, {
 		placement: "bottom right",
 		children: [/* @__PURE__ */ jsx(Button, {
 			className: cn("flex h-9 w-9 items-center justify-center rounded-xl text-muted transition-colors hover:bg-surface hover:text-body outline-none border-none bg-transparent cursor-pointer", className),
@@ -1031,7 +1044,7 @@ function ThemeToggle({ className }) {
 				size: 20,
 				className: "animate-in fade-in zoom-in duration-300"
 			})
-		}), /* @__PURE__ */ jsxs(Menu$1.Root, {
+		}), /* @__PURE__ */ jsxs(Menu$2.Root, {
 			selectionMode: "single",
 			selectedKeys: [theme],
 			onSelectionChange: (keys) => {
@@ -1040,7 +1053,7 @@ function ThemeToggle({ className }) {
 			},
 			className: "w-36 bg-main border border-subtle rounded-xl p-1.5 shadow-md outline-none flex flex-col gap-0.5 animate-fade-in z-100",
 			children: [
-				/* @__PURE__ */ jsxs(Menu$1.Item, {
+				/* @__PURE__ */ jsxs(Menu$2.Item, {
 					id: "light",
 					className: "group flex items-center gap-2 px-3 py-2 rounded-lg text-xs font-medium text-body dark:hover:bg-primary-300/50 hover:bg-primary-200/50 transition-colors duration-100 cursor-pointer select-none outline-none group data-selected:text-primary-500 data-selected:bg-primary-500/5",
 					children: [/* @__PURE__ */ jsx(Sun, {
@@ -1051,7 +1064,7 @@ function ThemeToggle({ className }) {
 						children: "Light"
 					})]
 				}),
-				/* @__PURE__ */ jsxs(Menu$1.Item, {
+				/* @__PURE__ */ jsxs(Menu$2.Item, {
 					id: "dark",
 					className: "flex items-center gap-2 px-3 py-2 rounded-lg text-xs font-medium text-body dark:hover:bg-primary-300/50 hover:bg-primary-200/50 transition-colors duration-100 cursor-pointer select-none outline-none group data-selected:text-primary-500 data-selected:bg-primary-500/5",
 					children: [/* @__PURE__ */ jsx(Moon, {
@@ -1062,7 +1075,7 @@ function ThemeToggle({ className }) {
 						children: "Dark"
 					})]
 				}),
-				/* @__PURE__ */ jsxs(Menu$1.Item, {
+				/* @__PURE__ */ jsxs(Menu$2.Item, {
 					id: "system",
 					className: "flex items-center gap-2 px-3 py-2 rounded-lg text-xs font-medium text-body dark:hover:bg-primary-300/50 hover:bg-primary-200/50 transition-colors duration-100 cursor-pointer select-none outline-none group data-selected:text-primary-500 data-selected:bg-primary-500/5",
 					children: [/* @__PURE__ */ jsx(Monitor, {
@@ -1248,17 +1261,17 @@ function useVersion() {
 function VersionSelector({ className }) {
 	const { currentVersionLabel, availableVersions, handleVersionChange } = useVersion();
 	if (availableVersions.length === 0) return null;
-	return /* @__PURE__ */ jsxs(Menu$1.Trigger, { children: [/* @__PURE__ */ jsxs(Button$1, {
+	return /* @__PURE__ */ jsxs(Menu$2.Trigger, { children: [/* @__PURE__ */ jsxs(Button$1, {
 		className: 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__ */ jsx("span", {
 			className: "font-semibold text-[0.8125rem]",
 			children: currentVersionLabel
 		}), /* @__PURE__ */ jsx(ChevronDown, { className: "w-3.5 h-3.5 text-muted/60" })]
-	}), /* @__PURE__ */ jsx(Menu$1.Root, {
+	}), /* @__PURE__ */ jsx(Menu$2.Root, {
 		className: "w-40 bg-main border border-subtle rounded-xl p-1.5 shadow-md outline-none flex flex-col gap-0.5 animate-fade-in z-100",
-		children: /* @__PURE__ */ jsx(Menu$1.Section, {
+		children: /* @__PURE__ */ jsx(Menu$2.Section, {
 			items: availableVersions,
-			children: (version) => /* @__PURE__ */ jsx(Menu$1.Item, {
+			children: (version) => /* @__PURE__ */ jsx(Menu$2.Item, {
 				onPress: () => handleVersionChange(version.value),
 				className: "flex items-center gap-2 px-3 py-2 rounded-lg text-xs font-medium text-body hover:bg-primary-50/50 cursor-pointer select-none outline-none group data-selected:text-primary-500 data-selected:bg-primary-500/5",
 				children: version.label
@@ -1706,7 +1719,7 @@ function useFeedback(options = {}) {
 function I18nSelector({ className }) {
 	const { currentLocale, availableLocales, handleLocaleChange } = useI18n();
 	if (availableLocales.length === 0) return null;
-	return /* @__PURE__ */ jsxs(Menu$1.Trigger, { children: [/* @__PURE__ */ jsxs(Button$1, {
+	return /* @__PURE__ */ jsxs(Menu$2.Trigger, { children: [/* @__PURE__ */ jsxs(Button$1, {
 		className: 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__ */ jsxs("div", {
 			className: "flex items-center gap-1.5",
@@ -1715,11 +1728,11 @@ function I18nSelector({ className }) {
 				children: currentLocale || "en"
 			})]
 		}), /* @__PURE__ */ jsx(ChevronDown, { className: "w-3.5 h-3.5 text-muted/60" })]
-	}), /* @__PURE__ */ jsx(Menu$1.Root, {
+	}), /* @__PURE__ */ jsx(Menu$2.Root, {
 		className: "w-40 bg-main border border-subtle rounded-xl p-1.5 shadow-md outline-none flex flex-col gap-0.5 animate-fade-in z-100",
-		children: /* @__PURE__ */ jsx(Menu$1.Section, {
+		children: /* @__PURE__ */ jsx(Menu$2.Section, {
 			items: availableLocales,
-			children: (locale) => /* @__PURE__ */ jsx(Menu$1.Item, {
+			children: (locale) => /* @__PURE__ */ jsx(Menu$2.Item, {
 				onPress: () => handleLocaleChange(locale.value),
 				className: "flex items-center gap-2 px-3 py-2 rounded-lg text-xs font-medium text-body dark:hover:bg-primary-300/50 hover:bg-primary-200/50 transition-colors duration-100 cursor-pointer select-none outline-none group data-selected:text-primary-500 data-selected:bg-primary-500/5",
 				children: /* @__PURE__ */ jsx("span", { children: locale.label })
@@ -1730,7 +1743,7 @@ function I18nSelector({ className }) {
 
 //#endregion
 //#region src/client/components/ui-base/navbar.tsx
-const SearchDialog$1 = lazy(() => import("../search-dialog-DQwod5Xc.js").then((m) => ({ default: m.SearchDialog })));
+const SearchDialog$1 = lazy(() => import("../search-dialog-D3Obh3eA.js").then((m) => ({ default: m.SearchDialog })));
 function Navbar({ className }) {
 	const { links, title, logo, logoProps, github, social, config } = useNavbar();
 	const { routes, allRoutes, currentRoute, isCollectionPage, currentVersion, currentLocale } = useRoutes();
@@ -1748,10 +1761,12 @@ function Navbar({ className }) {
 						onPress: toggleSidebar,
 						className: "mr-2 lg:hidden p-1.5 h-8 w-8 flex items-center justify-center bg-transparent border-none outline-none select-none cursor-pointer rounded-xl hover:bg-primary-50/50 transition-colors",
 						"aria-label": isSidebarOpen ? "Close sidebar" : "Open sidebar",
-						children: isSidebarOpen ? /* @__PURE__ */ jsx(X, { className: "w-5 h-5 text-body" }) : /* @__PURE__ */ jsx(Menu, { className: "w-5 h-5 text-body" })
+						children: isSidebarOpen ? /* @__PURE__ */ jsx(X, { className: "w-5 h-5 text-body" }) : /* @__PURE__ */ jsx(Menu$1, { className: "w-5 h-5 text-body" })
 					}),
 					logo && /* @__PURE__ */ jsx(Navbar$1.Logo, {
-						src: logo,
+						src: logo.light,
+						srcLight: logo.light,
+						srcDark: logo.dark,
 						alt: logoProps?.alt || title,
 						width: logoProps?.width ?? 24,
 						height: logoProps?.height ?? 24,
@@ -2002,8 +2017,30 @@ const mergeSlots = (defaults, overrides) => {
 function SidebarMain({ routes, config, className }) {
 	const { logo, title, logoProps } = useNavbar();
 	const { closeSidebar } = useUI();
-	const SidebarLogo = logo ? /* @__PURE__ */ jsx("img", {
-		src: resolvePublicAssetUrl(logo, config.base),
+	/**
+	* Both logo variants are rendered and CSS selects the visible one.
+	*
+	* Resolving the source from the theme would make the server and the browser
+	* emit different `src` values, which is a hydration mismatch. The `dark`
+	* class on `<html>` is set before first paint, so there is no flash.
+	*/
+	const SidebarLogo = logo ? logo.dark && logo.dark !== logo.light ? /* @__PURE__ */ jsxs(Fragment$1, { children: [/* @__PURE__ */ jsx("img", {
+		src: resolvePublicAssetUrl(logo.light, config.base),
+		alt: logoProps?.alt || title,
+		width: 24,
+		height: 24,
+		"data-logo-theme": "light",
+		className: "rounded-xl dark:hidden"
+	}), /* @__PURE__ */ jsx("img", {
+		src: resolvePublicAssetUrl(logo.dark, config.base),
+		alt: logoProps?.alt || title,
+		width: 24,
+		height: 24,
+		"data-logo-theme": "dark",
+		"aria-hidden": "true",
+		className: "hidden rounded-xl dark:block"
+	})] }) : /* @__PURE__ */ jsx("img", {
+		src: resolvePublicAssetUrl(logo.light, config.base),
 		alt: logoProps?.alt || title,
 		width: 24,
 		height: 24,
@@ -2320,7 +2357,9 @@ const EagerMdxElement = ({ moduleLoader, moduleKey, route, components, collectio
 	return /* @__PURE__ */ jsx(MdxPage, {
 		MDXComponent,
 		mdxComponents: components ?? {},
-		collectionPostComponent
+		collectionPostComponent,
+		collection: route.collection,
+		route
 	});
 };
 const NotFoundWrapper = () => {
@@ -2367,7 +2406,7 @@ function DocsLayout({ collectionsData }) {
 
 //#endregion
 //#region src/client/ssg/create-routes.utils.ts
-function withBase(path, config) {
+function withBase$1(path, config) {
 	const base = config.base || "/";
 	if (path.startsWith(base)) return path;
 	return `${base === "/" ? "" : base.replace(/\/$/, "")}${path.startsWith("/") ? path : `/${path}`}` || "/";
@@ -2463,7 +2502,7 @@ function buildDocRoutes(options) {
 	const docRoutes = docMetadata.map((route) => {
 		const moduleKey = resolveModuleKey(route.filePath, moduleMap);
 		const moduleLoader = moduleKey ? mdxModules[moduleKey] : null;
-		const fullPath = withBase(route.path === "" ? "/" : route.path, config);
+		const fullPath = withBase$1(route.path === "" ? "/" : route.path, config);
 		const path = fullPath === baseDocsPath ? "." : fullPath.startsWith(baseDocsPath + "/") ? fullPath.slice(baseDocsPath.length + 1) : fullPath;
 		const routeRecord = {
 			path,
@@ -2590,7 +2629,7 @@ function buildDocRoutes(options) {
 					fallback: true,
 					seo: {
 						...matchedMetaObj.seo,
-						canonical: config.siteUrl ? `${config.siteUrl.replace(/\/$/, "")}${withBase(bPath, config)}` : withBase(bPath, config)
+						canonical: config.siteUrl ? `${config.siteUrl.replace(/\/$/, "")}${withBase$1(bPath, config)}` : withBase$1(bPath, config)
 					}
 				} : {
 					path: bPath,
@@ -2665,16 +2704,33 @@ function ExternalPageWrapper({ children }) {
 
 //#endregion
 //#region src/client/ssg/create-routes.external.tsx
-function getLocales(config) {
+function getLocales$1(config) {
 	if (!config.i18n) return [];
 	return Array.isArray(config.i18n.locales) ? config.i18n.locales : Object.keys(config.i18n.locales);
 }
+/**
+* Lists the locale-prefixed variants of a path.
+*
+* The default locale is skipped on purpose. It is already the unprefixed path,
+* so prefixing it would mint a second URL for the same page: a site with
+* `defaultLocale: 'en'` would serve both `/about` and `/en/about`. That is not
+* a harmless duplicate. The docs site is served under a base, and the SSG path
+* collector prepends the base to the prefixed variant, so it emitted
+* `/docs/en/about` — a URL the client router never learns about, because the
+* base is not part of the route. Visitors landing there got a 404 on a page
+* the build had itself written.
+*
+* A developer configuring a second locale should not have to know this, so the
+* redundant variant is never generated in the first place.
+*/
 function getLocalizedPaths(pathname, config) {
 	const paths = [{
 		path: pathname,
 		locale: config.i18n?.defaultLocale
 	}];
-	for (const locale of getLocales(config)) {
+	const defaultLocale = config.i18n?.defaultLocale;
+	for (const locale of getLocales$1(config)) {
+		if (locale === defaultLocale) continue;
 		const localizedPath = pathname === "/" ? `/${locale}` : `/${locale}${pathname}`;
 		if (!paths.some((entry) => entry.path === localizedPath)) paths.push({
 			path: localizedPath,
@@ -2798,7 +2854,7 @@ function buildExternalFileRoutes(options) {
 		metadata
 	};
 	const EffectiveExternalLayout = externalLayout || (({ children }) => /* @__PURE__ */ jsx(Fragment$1, { children }));
-	const locales = getLocales(config);
+	const locales = getLocales$1(config);
 	const isLocalizedPath = (pathname) => locales.some((locale) => pathname === `/${locale}` || pathname.startsWith(`/${locale}/`));
 	const localeOfPath = (pathname) => {
 		const first = pathname.split("/").filter(Boolean)[0];
@@ -2993,7 +3049,7 @@ function DefaultCollectionList() {
 						}),
 						post.date && /* @__PURE__ */ jsx("time", {
 							className: "text-xs text-muted block mb-2",
-							children: new Date(post.date).toLocaleDateString()
+							children: formatDeterministicDate(post.date, { month: "short" })
 						}),
 						post.excerpt && /* @__PURE__ */ jsx("p", {
 							className: "text-sm text-body",
@@ -3235,6 +3291,106 @@ function buildCollectionRoutes(options) {
 	};
 }
 
+//#endregion
+//#region src/client/ssg/create-routes.redirect.tsx
+function normalize(value) {
+	const [withoutHash] = value.split("#");
+	const queryIndex = withoutHash.indexOf("?");
+	const rawPath = queryIndex === -1 ? withoutHash : withoutHash.slice(0, queryIndex);
+	const query = queryIndex === -1 ? "" : withoutHash.slice(queryIndex);
+	const collapsed = `/${rawPath}`.replace(/\/{2,}/g, "/");
+	return `${collapsed === "/" ? "/" : collapsed.replace(/\/+$/, "")}${query}`;
+}
+function isExternalTarget(to) {
+	return /^[a-z][a-z0-9+.-]*:/i.test(to) || to.startsWith("//");
+}
+function getLocales(config) {
+	const locales = config.i18n?.locales;
+	if (!locales) return [];
+	return Array.isArray(locales) ? locales : Object.keys(locales);
+}
+function withBase(pathname, base) {
+	if (base === "/" || !base) return pathname;
+	const normalizedBase = `/${base.replace(/^\/+|\/+$/g, "")}`;
+	if (pathname === "/") return normalizedBase;
+	return `${normalizedBase}${pathname}`;
+}
+/**
+* Collapses redirect chains and rejects cycles in the browser as well, so a
+* misconfigured site fails visibly instead of trapping the visitor.
+*/
+function buildRedirectMap(config) {
+	const map = /* @__PURE__ */ new Map();
+	const entries = config.redirects ?? [];
+	for (const entry of entries) {
+		const from = normalize(entry.from);
+		const sources = entry.locale ? getLocales(config).map((locale) => from === `/${locale}` || from.startsWith(`/${locale}/`) ? from : from === "/" ? `/${locale}` : `/${locale}${from}`) : [from];
+		for (const source of sources) {
+			const to = isExternalTarget(entry.to) ? entry.to : withBase(normalize(entry.to), config.base ?? "/");
+			map.set(source, to);
+		}
+	}
+	for (const [source, direct] of map) {
+		let current = direct;
+		const seen = new Set([source]);
+		for (let depth = 0; depth < 10; depth++) {
+			const nextPath = current.split("?")[0];
+			const next = map.get(nextPath);
+			if (!next || seen.has(nextPath)) break;
+			seen.add(nextPath);
+			current = next;
+		}
+		map.set(source, current);
+	}
+	return map;
+}
+/**
+* Performs the redirect during render effects. A short delay lets the static
+* host serve the prerendered redirect document first on a cold load, while a
+* client-side navigation never flashes the destination page.
+*/
+function RedirectBoundary({ to }) {
+	const navigate = useNavigate();
+	useEffect(() => {
+		if (isExternalTarget(to)) {
+			window.location.replace(to);
+			return;
+		}
+		navigate(to, { replace: true });
+	}, [navigate, to]);
+	return /* @__PURE__ */ jsx("main", {
+		className: "boltdocs-page w-full pt-4 pb-20 px-4 sm:px-8",
+		children: /* @__PURE__ */ jsx("div", {
+			className: "mx-auto w-full max-w-3xl sm:max-w-4xl",
+			children: /* @__PURE__ */ jsxs("p", {
+				className: "text-paragraph",
+				children: [
+					"Redirecting to ",
+					/* @__PURE__ */ jsx("a", {
+						href: to,
+						children: to
+					}),
+					"…"
+				]
+			})
+		})
+	});
+}
+/**
+* Builds client-side redirect routes from `config.redirects`.
+*
+* Redirect sources are appended after the real routes so an existing page always
+* wins, and before the catch-all so a redirect is never shadowed by the 404.
+*/
+function buildRedirectRoutes({ config }) {
+	const map = buildRedirectMap(config);
+	if (map.size === 0) return [];
+	return [...map.entries()].sort(([a], [b]) => a.localeCompare(b)).map(([from, to]) => ({
+		path: from,
+		element: /* @__PURE__ */ jsx(RedirectBoundary, { to })
+	}));
+}
+
 //#endregion
 //#region src/client/ssg/create-routes.tsx
 function createRoutes(options) {
@@ -3260,6 +3416,7 @@ function createRoutes(options) {
 	};
 	filteredExternalFileRoutes.children = externalFileRoutes.children.filter((route) => !route.path || acceptedExternalFilePaths.has(route.path));
 	const collectionRoutes = buildCollectionRoutes(options);
+	const redirectRoutes = buildRedirectRoutes({ config });
 	const children = [
 		{
 			path: baseDocsPath,
@@ -3269,6 +3426,7 @@ function createRoutes(options) {
 		...externalRoutes.children,
 		...filteredExternalFileRoutes.children,
 		...collectionRoutes.children,
+		...redirectRoutes,
 		{
 			path: "*",
 			element: /* @__PURE__ */ jsx(ExternalPageWrapper, { children: /* @__PURE__ */ jsx(EffectiveExternalLayout, { children: /* @__PURE__ */ jsx(NotFoundWrapper, {}) }) })
@@ -3303,6 +3461,18 @@ function createRoutes(options) {
 	};
 }
 
+//#endregion
+//#region src/client/collections/utils.ts
+/**
+* Formats a date to a human-readable string.
+*
+* Locale and time zone are pinned so the server and the browser produce
+* identical text during hydration. See `formatDeterministicDate`.
+*/
+function formatDate(date, options = {}) {
+	return formatDeterministicDate(date, options);
+}
+
 //#endregion
 //#region src/client/components/docs-layout-default.tsx
 /**
@@ -3428,4 +3598,4 @@ function useCodeBlock(props) {
 }
 
 //#endregion
-export { Banner, BoltdocsShell, Breadcrumbs, CollectionsContext, CopyMarkdown, CurrentPostProvider, DocsLayoutComponent as DocsLayout, ErrorBoundary, LocationContext, LocationProvider, MatchesContext, MdxPage, Navbar, NavigateContext, NotFound, OnThisPage, Outlet, OutletContext, PageNav, PrefetchContext, RouteDataContext, RouteRenderer, SearchDialog, Sidebar, StructuredData, Timeline, ViteReactSSG, addBasename, addUrlBase, buildUrl, classifyUrlPath, cn, copyToClipboard, createArticleStructuredData, createBreadcrumbStructuredData, createRoutes, createStructuredData, createWebSiteStructuredData, defaultNavigate, defineStructuredData, getConfiguredLocales, getConfiguredVersions, getStarsRepo, getTranslated, getVersionPrefixSegments, getVersionSegments, hasBasename, hasUriScheme, hasUrlBase, isConfiguredLocale, isConfiguredVersion, matchRouteBranch, matchRouteBranchWithParams, normalizeBasename, normalizeUrlBase, normalizeUrlPath, parseUrlReference, reactToText, resolvePublicAssetUrl, resolveRouteBranch, resolveUrlReference, splitUrlReference, startViewTransition, stripBasename, stripSiteProtocol, stripUrlBase, useAnalytics, useBreadcrumbs, useCodeBlock, useCodeBlockFeedback, useConfig, useCopyButton, useExpandable, useFeedback, useHeadings, useI18n, useLoaderData, useLocalizedTo, useLocation, useMatches, useMdxComponents, useMergedComponents, useNavbar, useNavigate, usePageNav, usePost, usePosts, usePrefetch, useRecentPosts, useRouteData, useRoutes, useSearch, useSearchHighlight, useSidebar, useTabs, useTheme, useTrackEvent, useTrackPageView, useUI, useVersion, useViewTransition };
+export { Banner, BoltdocsShell, Breadcrumbs, CollectionsContext, CopyMarkdown, CurrentPostProvider, DocsLayoutComponent as DocsLayout, ErrorBoundary, LocationContext, LocationProvider, MatchesContext, MdxPage, Navbar, NavigateContext, NotFound, OnThisPage, Outlet, OutletContext, PageNav, PrefetchContext, RouteDataContext, RouteRenderer, SearchDialog, Sidebar, StructuredData, Timeline, ViteReactSSG, addBasename, addUrlBase, buildUrl, classifyUrlPath, cn, copyToClipboard, createArticleStructuredData, createBreadcrumbStructuredData, createRoutes, createStructuredData, createWebSiteStructuredData, defaultNavigate, defineStructuredData, formatDate, formatDeterministicDate, getConfiguredLocales, getConfiguredVersions, getStarsRepo, getTranslated, getVersionPrefixSegments, getVersionSegments, hasBasename, hasUriScheme, hasUrlBase, isConfiguredLocale, isConfiguredVersion, matchRouteBranch, matchRouteBranchWithParams, normalizeBasename, normalizeUrlBase, normalizeUrlPath, parseUrlReference, reactToText, resolvePublicAssetUrl, resolveRouteBranch, resolveUrlReference, splitUrlReference, startViewTransition, stripBasename, stripSiteProtocol, stripUrlBase, useAnalytics, useBreadcrumbs, useCodeBlock, useCodeBlockFeedback, useConfig, useCopyButton, useExpandable, useFeedback, useHeadings, useI18n, useLoaderData, useLocalizedTo, useLocation, useMatches, useMdxComponents, useMergedComponents, useNavbar, useNavigate, usePageNav, usePost, usePosts, usePrefetch, useRecentPosts, useRouteData, useRoutes, useSearch, useSearchHighlight, useSidebar, useTabs, useTheme, useTrackEvent, useTrackPageView, useUI, useVersion, useViewTransition };

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-Qi0DmaY8.cjs');
+const require_mdx = require('../mdx-BCOrMd-P.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-CJGWzBGy.js";
+import { t as mdx_components_default } from "../mdx-BijiEbkp.js";
 
 //#region src/client/mdx.ts
 const { Card, Cards, Callout, Field, Image } = mdx_components_default;

package/dist/client/primitives.cjs

@@ -4,11 +4,11 @@
  * Licensed under the MIT License.
  */
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_router = require('../router-C3kygdRK.cjs');
-const require_link = require('../link-hLWOsx0x.cjs');
-const require_image = require('../image-Bkx85rsq.cjs');
-const require_docs_layout = require('../docs-layout-SgphExoE.cjs');
-const require_search_dialog = require('../search-dialog-CguKVtUu.cjs');
+const require_router = require('../router-DKC0Lu0n.cjs');
+const require_link = require('../link-Xb69Oy2F.cjs');
+const require_image = require('../image-Bke2ojW1.cjs');
+const require_docs_layout = require('../docs-layout-DIgxJ5c7.cjs');
+const require_search_dialog = require('../search-dialog-BOQRHKTb.cjs');
 let react_jsx_runtime = require("react/jsx-runtime");
 
 //#region src/client/components/primitives/skeleton.tsx