boltdocs 3.1.0 → 3.2.2

package/dist/client/index.d.cts

@@ -1,6 +1,6 @@
 
-import { A as BoltdocsRoutePathWithFallback, C as SiteConfig, D as BoltdocsLocale, E as BoltdocsIntegrationsConfig, M as BoltdocsTypes, N as BoltdocsVersion, O as BoltdocsMdxComponents, S as SidebarProps, T as BoltdocsConfig, _ as CollectionPostLoaderData, b as NavbarLink, g as CollectionListLoaderData, h as BoltdocsTab, j as BoltdocsSocialLink, k as BoltdocsRoutePath, v as ComponentRoute, w as TabsProps, x as OnThisPageProps, y as LayoutProps } from "../sidebar-DH2iPKXM.cjs";
-import { a as ErrorBoundary, c as OnThisPage, i as CopyMarkdown, l as Sidebar, n as NotFound, o as PageNav, r as SearchDialog, s as Breadcrumbs, t as Banner, u as Navbar } from "../banner-DdSgCs4G.cjs";
+import { A as BoltdocsRoutePathWithFallback, C as SiteConfig, D as BoltdocsLocale, E as BoltdocsIntegrationsConfig, M as BoltdocsTypes, N as BoltdocsVersion, O as BoltdocsMdxComponents, S as SidebarProps, T as BoltdocsConfig, _ as CollectionPostLoaderData, b as NavbarLink, g as CollectionListLoaderData, h as BoltdocsTab, j as BoltdocsSocialLink, k as BoltdocsRoutePath, v as ComponentRoute, w as TabsProps, x as OnThisPageProps, y as LayoutProps } from "../sidebar-CrEdJuHX.cjs";
+import { a as ErrorBoundary, c as OnThisPage, i as CopyMarkdown, l as Sidebar, n as NotFound, o as PageNav, r as SearchDialog, s as Breadcrumbs, t as Banner, u as Navbar } from "../banner-CVD0GugR.cjs";
 import * as _$react from "react";
 import React$1, { ComponentType, JSXElementConstructor, ReactNode } from "react";
 import { RouteRecord, ViteReactSSG } from "@bdocs/ssg";
@@ -119,9 +119,9 @@ declare function useTheme(): ThemeContextType;
 //#endregion
 //#region src/client/app/mdx-components-context.d.ts
 type MdxComponentsType = {
-  [key: string]: React.ComponentType<HTMLElement>;
+  [key: string]: ComponentType<any>;
 } & {
-  Frontmatter?: Record<string, React.ComponentType<{
+  Frontmatter?: Record<string, ComponentType<{
     value: unknown;
   }>>;
 };
@@ -359,8 +359,16 @@ declare function useFeedback(options?: UseFeedbackOptions): {
 //#endregion
 //#region src/client/components/docs-layout-default.d.ts
 interface DocsLayoutThemeProps {
-  children?: React.ReactNode;
+  children?: ReactNode;
 }
+/**
+ * Default docs layout — composes the visual primitives and delegates
+ * sub-area routing to them. Slot rendering (plugin injections at
+ * `navbar:end`, `sidebar:bottom`, `docs-content:top`, etc.) is handled
+ * internally by each primitive so the layout itself does no slot "magic".
+ *
+ * A custom layout can reuse any primitive and the slot wiring just works.
+ */
 declare function DocsLayoutComponent({
   children
 }: DocsLayoutThemeProps): _$react_jsx_runtime0.JSX.Element;
@@ -395,6 +403,67 @@ declare function usePost(collection: string, slug: string): CollectionPost$1 | u
  */
 declare function useRecentPosts(collection?: string, count?: number): CollectionPost$1[];
 //#endregion
+//#region src/client/components/mdx/timeline.d.ts
+/**
+ * Variants for both dots and badges.
+ *
+ * - Semantic: `primary`, `success`, `info`, `warning`, `danger` map directly
+ *   to the dot accent color and the badge pill background.
+ * - Lifecycle (alias for semantic but convenient for changelogs):
+ *   `major` → primary, `minor` → success, `patch` → info,
+ *   `new` → primary, `deprecated` → warning, `breaking` → danger.
+ */
+type TimelineVariant = 'primary' | 'success' | 'info' | 'warning' | 'danger' | 'major' | 'minor' | 'patch' | 'new' | 'deprecated' | 'breaking';
+interface TimelineBadgeConfig {
+  text: ReactNode;
+  variant?: TimelineVariant;
+}
+interface TimelineProps extends Omit<React.HTMLAttributes<HTMLOListElement>, 'children'> {
+  children?: ReactNode;
+  /** Reduce vertical padding between items. */
+  compact?: boolean;
+}
+interface TimelineItemProps extends Omit<React.HTMLAttributes<HTMLLIElement>, 'title' | 'children'> {
+  /** Date the entry happened. Accepts ISO string, epoch ms, or `Date` instance. */
+  date?: string | number | Date;
+  /** Headline shown beside the date. */
+  title: ReactNode;
+  /** Inline badge to the right of the title (e.g. "Major", "Breaking"). */
+  badge?: string | TimelineBadgeConfig;
+  /** Icon to render inside the dot. Falls back to a coloured filled circle. */
+  icon?: ReactNode;
+  /** Dot / badge accent colour. Defaults to `primary`. */
+  variant?: TimelineVariant;
+  /**
+   * BCP-47 locale tag used by `toLocaleDateString` for the rendered
+   * date. Defaults to `'en-US'` so server and client produce identical
+   * markup on hydration. Pass `'es'`, `'fr'`, etc. to localize.
+   */
+  locale?: string;
+  /** Body content for the entry. Accepts Markdown/markup from MDX. */
+  children?: ReactNode;
+}
+declare function TimelineRoot({
+  children,
+  className,
+  compact,
+  ...props
+}: TimelineProps): _$react_jsx_runtime0.JSX.Element;
+declare function TimelineItem({
+  date,
+  title,
+  badge,
+  icon,
+  variant,
+  locale,
+  className,
+  children,
+  ...props
+}: TimelineItemProps): _$react_jsx_runtime0.JSX.Element;
+declare const Timeline: typeof TimelineRoot & {
+  Item: typeof TimelineItem;
+};
+//#endregion
 //#region src/client/utils/cn.d.ts
 declare function cn(...inputs: ClassValue[]): string;
 //#endregion
@@ -469,9 +538,6 @@ declare function useCodeBlock(props: CodeBlockProps): {
   showCodeBlockFeedback: boolean;
   rated: "up" | "down" | null;
   handleRate: (type: "up" | "down") => Promise<void>;
-  LangIcon: _$react.ComponentType<{
-    size?: number;
-  }>;
 };
 //#endregion
-export { Banner, BoltdocsConfig, type BoltdocsLocale, BoltdocsRoutePath, BoltdocsRoutePathWithFallback, BoltdocsShell, BoltdocsTab, type BoltdocsTypes, type BoltdocsVersion, Breadcrumbs, type CollectionListLoaderData, type CollectionPost$1 as CollectionPost, type CollectionPostLoaderData, CollectionsContext, type CollectionsData, ComponentRoute, CopyMarkdown, CurrentPostProvider, DocsLayoutComponent as DocsLayout, ErrorBoundary, LayoutProps, MdxPage, Navbar, NavbarLink, NotFound, OnThisPage, OnThisPageProps, PageNav, SearchDialog, Sidebar, SidebarProps, SiteConfig, TabsProps, 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, BoltdocsConfig, type BoltdocsLocale, BoltdocsRoutePath, BoltdocsRoutePathWithFallback, BoltdocsShell, BoltdocsTab, type BoltdocsTypes, type BoltdocsVersion, Breadcrumbs, type CollectionListLoaderData, type CollectionPost$1 as CollectionPost, type CollectionPostLoaderData, CollectionsContext, type CollectionsData, type ComponentRoute, CopyMarkdown, CurrentPostProvider, DocsLayoutComponent as DocsLayout, ErrorBoundary, LayoutProps, MdxPage, Navbar, NavbarLink, NotFound, OnThisPage, OnThisPageProps, PageNav, SearchDialog, Sidebar, SidebarProps, SiteConfig, TabsProps, Timeline, type TimelineBadgeConfig, type TimelineItemProps, type TimelineProps, type TimelineVariant, 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/index.d.ts

@@ -1,6 +1,6 @@
 
-import { A as BoltdocsRoutePathWithFallback, C as SiteConfig, D as BoltdocsLocale, E as BoltdocsIntegrationsConfig, M as BoltdocsTypes, N as BoltdocsVersion, O as BoltdocsMdxComponents, S as SidebarProps, T as BoltdocsConfig, _ as CollectionPostLoaderData, b as NavbarLink, g as CollectionListLoaderData, h as BoltdocsTab, j as BoltdocsSocialLink, k as BoltdocsRoutePath, v as ComponentRoute, w as TabsProps, x as OnThisPageProps, y as LayoutProps } from "../sidebar-DknLUI1R.js";
-import { a as ErrorBoundary, c as OnThisPage, i as CopyMarkdown, l as Sidebar, n as NotFound, o as PageNav, r as SearchDialog, s as Breadcrumbs, t as Banner, u as Navbar } from "../banner-DjujkctF.js";
+import { A as BoltdocsRoutePathWithFallback, C as SiteConfig, D as BoltdocsLocale, E as BoltdocsIntegrationsConfig, M as BoltdocsTypes, N as BoltdocsVersion, O as BoltdocsMdxComponents, S as SidebarProps, T as BoltdocsConfig, _ as CollectionPostLoaderData, b as NavbarLink, g as CollectionListLoaderData, h as BoltdocsTab, j as BoltdocsSocialLink, k as BoltdocsRoutePath, v as ComponentRoute, w as TabsProps, x as OnThisPageProps, y as LayoutProps } from "../sidebar-COTaMHR-.js";
+import { a as ErrorBoundary, c as OnThisPage, i as CopyMarkdown, l as Sidebar, n as NotFound, o as PageNav, r as SearchDialog, s as Breadcrumbs, t as Banner, u as Navbar } from "../banner-BMop1KLF.js";
 import { RouteRecord, ViteReactSSG } from "@bdocs/ssg";
 import * as _$react from "react";
 import React$1, { ComponentType, JSXElementConstructor, ReactNode } from "react";
@@ -119,9 +119,9 @@ declare function useTheme(): ThemeContextType;
 //#endregion
 //#region src/client/app/mdx-components-context.d.ts
 type MdxComponentsType = {
-  [key: string]: React.ComponentType<HTMLElement>;
+  [key: string]: ComponentType<any>;
 } & {
-  Frontmatter?: Record<string, React.ComponentType<{
+  Frontmatter?: Record<string, ComponentType<{
     value: unknown;
   }>>;
 };
@@ -359,8 +359,16 @@ declare function useFeedback(options?: UseFeedbackOptions): {
 //#endregion
 //#region src/client/components/docs-layout-default.d.ts
 interface DocsLayoutThemeProps {
-  children?: React.ReactNode;
+  children?: ReactNode;
 }
+/**
+ * Default docs layout — composes the visual primitives and delegates
+ * sub-area routing to them. Slot rendering (plugin injections at
+ * `navbar:end`, `sidebar:bottom`, `docs-content:top`, etc.) is handled
+ * internally by each primitive so the layout itself does no slot "magic".
+ *
+ * A custom layout can reuse any primitive and the slot wiring just works.
+ */
 declare function DocsLayoutComponent({
   children
 }: DocsLayoutThemeProps): _$react_jsx_runtime0.JSX.Element;
@@ -395,6 +403,67 @@ declare function usePost(collection: string, slug: string): CollectionPost$1 | u
  */
 declare function useRecentPosts(collection?: string, count?: number): CollectionPost$1[];
 //#endregion
+//#region src/client/components/mdx/timeline.d.ts
+/**
+ * Variants for both dots and badges.
+ *
+ * - Semantic: `primary`, `success`, `info`, `warning`, `danger` map directly
+ *   to the dot accent color and the badge pill background.
+ * - Lifecycle (alias for semantic but convenient for changelogs):
+ *   `major` → primary, `minor` → success, `patch` → info,
+ *   `new` → primary, `deprecated` → warning, `breaking` → danger.
+ */
+type TimelineVariant = 'primary' | 'success' | 'info' | 'warning' | 'danger' | 'major' | 'minor' | 'patch' | 'new' | 'deprecated' | 'breaking';
+interface TimelineBadgeConfig {
+  text: ReactNode;
+  variant?: TimelineVariant;
+}
+interface TimelineProps extends Omit<React.HTMLAttributes<HTMLOListElement>, 'children'> {
+  children?: ReactNode;
+  /** Reduce vertical padding between items. */
+  compact?: boolean;
+}
+interface TimelineItemProps extends Omit<React.HTMLAttributes<HTMLLIElement>, 'title' | 'children'> {
+  /** Date the entry happened. Accepts ISO string, epoch ms, or `Date` instance. */
+  date?: string | number | Date;
+  /** Headline shown beside the date. */
+  title: ReactNode;
+  /** Inline badge to the right of the title (e.g. "Major", "Breaking"). */
+  badge?: string | TimelineBadgeConfig;
+  /** Icon to render inside the dot. Falls back to a coloured filled circle. */
+  icon?: ReactNode;
+  /** Dot / badge accent colour. Defaults to `primary`. */
+  variant?: TimelineVariant;
+  /**
+   * BCP-47 locale tag used by `toLocaleDateString` for the rendered
+   * date. Defaults to `'en-US'` so server and client produce identical
+   * markup on hydration. Pass `'es'`, `'fr'`, etc. to localize.
+   */
+  locale?: string;
+  /** Body content for the entry. Accepts Markdown/markup from MDX. */
+  children?: ReactNode;
+}
+declare function TimelineRoot({
+  children,
+  className,
+  compact,
+  ...props
+}: TimelineProps): _$react_jsx_runtime0.JSX.Element;
+declare function TimelineItem({
+  date,
+  title,
+  badge,
+  icon,
+  variant,
+  locale,
+  className,
+  children,
+  ...props
+}: TimelineItemProps): _$react_jsx_runtime0.JSX.Element;
+declare const Timeline: typeof TimelineRoot & {
+  Item: typeof TimelineItem;
+};
+//#endregion
 //#region src/client/utils/cn.d.ts
 declare function cn(...inputs: ClassValue[]): string;
 //#endregion
@@ -469,9 +538,6 @@ declare function useCodeBlock(props: CodeBlockProps): {
   showCodeBlockFeedback: boolean;
   rated: "up" | "down" | null;
   handleRate: (type: "up" | "down") => Promise<void>;
-  LangIcon: _$react.ComponentType<{
-    size?: number;
-  }>;
 };
 //#endregion
-export { Banner, BoltdocsConfig, type BoltdocsLocale, BoltdocsRoutePath, BoltdocsRoutePathWithFallback, BoltdocsShell, BoltdocsTab, type BoltdocsTypes, type BoltdocsVersion, Breadcrumbs, type CollectionListLoaderData, type CollectionPost$1 as CollectionPost, type CollectionPostLoaderData, CollectionsContext, type CollectionsData, ComponentRoute, CopyMarkdown, CurrentPostProvider, DocsLayoutComponent as DocsLayout, ErrorBoundary, LayoutProps, MdxPage, Navbar, NavbarLink, NotFound, OnThisPage, OnThisPageProps, PageNav, SearchDialog, Sidebar, SidebarProps, SiteConfig, TabsProps, 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, BoltdocsConfig, type BoltdocsLocale, BoltdocsRoutePath, BoltdocsRoutePathWithFallback, BoltdocsShell, BoltdocsTab, type BoltdocsTypes, type BoltdocsVersion, Breadcrumbs, type CollectionListLoaderData, type CollectionPost$1 as CollectionPost, type CollectionPostLoaderData, CollectionsContext, type CollectionsData, type ComponentRoute, CopyMarkdown, CurrentPostProvider, DocsLayoutComponent as DocsLayout, ErrorBoundary, LayoutProps, MdxPage, Navbar, NavbarLink, NotFound, OnThisPage, OnThisPageProps, PageNav, SearchDialog, Sidebar, SidebarProps, SiteConfig, TabsProps, Timeline, type TimelineBadgeConfig, type TimelineItemProps, type TimelineProps, type TimelineVariant, 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/index.js

@@ -3,12 +3,12 @@
  * 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-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 { A as Monitor, B as useConfig, E as Languages, F as Sun, H as useBoltdocsContext, I as TextAlignStart, L as X, N as Pencil, R as icons_exports, V as BoltdocsProvider, a as useRoutes, b as FaceGood, d as Check, f as ChevronDown, g as Copy, h as CircleHelp, i as useLocalizedTo, j as Moon, k as Menu, o as normalizePath, r as cn, s as RoutesProvider, t as Link$1, u as ArrowLeft, v as ExternalLink, w as Home, x as FaceRegular, y as FaceBad, z as ConfigContext } from "../link-2PzgTnaP.js";
+import { c as ThemeProvider, l as useTheme } from "../image-Bz87fCla.js";
+import { i as copyToClipboard, n as Timeline, r as useCodeBlock, t as mdx_components_default } from "../mdx-BuO6a1f7.js";
+import { A as useUI, C as useSidebar, D as ButtonGroup, O as Breadcrumbs$2, S as useLocation, T as Menu$1, f as PageNav$1, k as UIProvider, m as OnThisPage$1, n as Sidebar$1, t as DocsLayout$1, w as Tabs$1, x as useSearchHighlight } from "../docs-layout-BdtZ9z6s.js";
+import { i as ErrorBoundary$1, n as Navbar$1, o as Button$1, r as Github } from "../search-dialog-DFnlx8LO.js";
+import { n as useSearch, r as InternalErrorBoundary, t as SearchDialog } from "../search-dialog-BmxHiKwt.js";
 import { ViteReactSSG } from "@bdocs/ssg";
 import { Suspense, createContext, isValidElement, lazy, use, useCallback, useEffect, useLayoutEffect, useMemo, useRef, useState } from "react";
 import { Link, Outlet, useLoaderData, useLocation as useLocation$1, useMatches, useNavigate } from "react-router-dom";
@@ -59,7 +59,7 @@ function MdxComponentsProvider({ components, children }) {
 function ScrollHandler() {
 	const { pathname, hash } = useLocation$1();
 	const handleScroll = (behavior = "auto") => {
-		const container = document.querySelector(".boltdocs-content") || window;
+		const container = document.querySelector(".boltdocs-content") || document.querySelector(".boltdocs-external-content") || document.querySelector(".boltdocs-shell-content") || window;
 		const getScrollTop = () => {
 			if (container === window) return window.scrollY;
 			return container.scrollTop;
@@ -92,11 +92,6 @@ function ScrollHandler() {
 	}, [pathname, hash]);
 	useEffect(() => {
 		handleScroll("auto");
-		const rafId = requestAnimationFrame(() => {
-			handleScroll("auto");
-			window.dispatchEvent(new Event("resize"));
-		});
-		return () => cancelAnimationFrame(rafId);
 	}, [pathname, hash]);
 	return null;
 }
@@ -280,12 +275,14 @@ function Head({ siteTitle, siteDescription, routes }) {
 			content: config.seo.verification.facebook
 		}),
 		Object.entries(globalMetatags).map(([key, value]) => {
-			return key.startsWith("og:") || key.startsWith("music:") || key.startsWith("video:") || key.startsWith("article:") || key.startsWith("book:") || key.startsWith("profile:") ? /* @__PURE__ */ jsx("meta", {
+			const isProperty = key.startsWith("og:") || key.startsWith("music:") || key.startsWith("video:") || key.startsWith("article:") || key.startsWith("book:") || key.startsWith("profile:");
+			const strVal = String(value ?? "");
+			return isProperty ? /* @__PURE__ */ jsx("meta", {
 				property: key,
-				content: value
+				content: strVal
 			}, key) : /* @__PURE__ */ jsx("meta", {
 				name: key,
-				content: value
+				content: strVal
 			}, key);
 		}),
 		Object.entries(seo).map(([key, value]) => {
@@ -295,15 +292,17 @@ function Head({ siteTitle, siteDescription, routes }) {
 			}, "noindex");
 			if (key === "robots") return /* @__PURE__ */ jsx("meta", {
 				name: "robots",
-				content: value
+				content: String(value)
 			}, "robots");
 			if (key === "canonical" || key === "og:url" || key === "og:image" || key === "twitter:image") return null;
-			return key.startsWith("og:") || key.startsWith("music:") || key.startsWith("video:") || key.startsWith("article:") || key.startsWith("book:") || key.startsWith("profile:") ? /* @__PURE__ */ jsx("meta", {
+			const isProperty = key.startsWith("og:") || key.startsWith("music:") || key.startsWith("video:") || key.startsWith("article:") || key.startsWith("book:") || key.startsWith("profile:");
+			const strVal = String(value ?? "");
+			return isProperty ? /* @__PURE__ */ jsx("meta", {
 				property: key,
-				content: value
+				content: strVal
 			}, key) : /* @__PURE__ */ jsx("meta", {
 				name: key,
-				content: value
+				content: strVal
 			}, key);
 		})
 	] });
@@ -416,7 +415,10 @@ function BoltdocsShell({ config, routes, components = {}, collectionsData }) {
 								siteDescription: config.theme?.description,
 								routes
 							}),
-							/* @__PURE__ */ jsx(InternalErrorBoundary, { children: /* @__PURE__ */ jsx(Outlet, {}) })
+							/* @__PURE__ */ jsx(InternalErrorBoundary, { children: /* @__PURE__ */ jsx("div", {
+								className: "boltdocs-shell-content h-screen overflow-hidden",
+								children: /* @__PURE__ */ jsx(Outlet, {})
+							}) })
 						]
 					})]
 				})
@@ -561,7 +563,7 @@ function Breadcrumbs() {
 			return /* @__PURE__ */ jsxs(Breadcrumbs$2.Item, {
 				className: "gap-2",
 				children: [/* @__PURE__ */ jsx(Breadcrumbs$2.Separator, { className: "text-muted/40" }), /* @__PURE__ */ jsx(Breadcrumbs$2.Link, {
-					href: crumb.href,
+					href: crumb.href ?? "",
 					className: cn("transition-colors", isActive ? "text-body font-semibold cursor-default pointer-events-none" : "text-muted hover:text-body"),
 					children: crumb.label
 				})]
@@ -736,7 +738,7 @@ function useNavbar() {
 				const cleanPathParts = (p) => {
 					const parts = p.split("/").filter(Boolean);
 					let i = 0;
-					if (config.i18n?.locales && parts[i] && config.i18n.locales[parts[i]]) i++;
+					if (config.i18n?.locales && parts[i] && !Array.isArray(config.i18n.locales) && config.i18n.locales[parts[i]]) i++;
 					if (config.versions?.versions && parts[i]) {
 						if (config.versions.versions.some((v) => v.path === parts[i])) i++;
 					}
@@ -1513,7 +1515,7 @@ function I18nSelector({ className }) {
 
 //#endregion
 //#region src/client/components/ui-base/navbar.tsx
-const SearchDialog$1 = lazy(() => import("../search-dialog-gp9lrJXm.js").then((m) => ({ default: m.SearchDialog })));
+const SearchDialog$1 = lazy(() => import("../search-dialog-D6TvjcuV.js").then((m) => ({ default: m.SearchDialog })));
 function Navbar() {
 	const { links, title, logo, logoProps, github, social, config } = useNavbar();
 	const { routes, currentRoute, isCollectionPage, currentVersion, currentLocale } = useRoutes();
@@ -1684,13 +1686,19 @@ function NavbarMobileLinkItem({ link, onClose }) {
 //#endregion
 //#region src/client/components/ui-base/on-this-page.tsx
 function OnThisPage({ headings = [], editLink, communityHelp, filePath }) {
-	if (headings.length === 0) return null;
+	if (headings.length === 0) return /* @__PURE__ */ jsx("nav", {
+		className: "w-toc shrink-0 hidden xl:block",
+		"aria-hidden": "true"
+	});
 	return /* @__PURE__ */ jsxs(OnThisPage$1.Root, { children: [
 		/* @__PURE__ */ jsxs(OnThisPage$1.Header, {
 			className: "flex flex-row gap-x-2",
 			children: [/* @__PURE__ */ jsx(TextAlignStart, { size: 16 }), "On this page"]
 		}),
-		/* @__PURE__ */ jsx(OnThisPage$1.Tree, { headings }),
+		/* @__PURE__ */ jsx(OnThisPage$1.Tree, {
+			className: "max-h-[300px]",
+			headings
+		}),
 		(editLink || communityHelp) && /* @__PURE__ */ jsxs("div", {
 			className: "mt-8 pt-8 border-t border-subtle space-y-4",
 			children: [/* @__PURE__ */ jsx("p", {
@@ -2007,7 +2015,7 @@ const EagerMdxElement = ({ moduleLoader, moduleKey, route, components, collectio
 	if (!MDXComponent) return /* @__PURE__ */ jsx(Loading, {});
 	return /* @__PURE__ */ jsx(MdxPage, {
 		MDXComponent,
-		mdxComponents: components,
+		mdxComponents: components ?? {},
 		collectionPostComponent
 	});
 };
@@ -2016,14 +2024,36 @@ const NotFoundWrapper = () => {
 	return /* @__PURE__ */ jsx(components.NotFound || components["404"] || NotFound, {});
 };
 
+//#endregion
+//#region src/client/app/doc-route-context.tsx
+/**
+* Context that exposes the currently active route to every primitive in the
+* tree. Slot renderers and other primitives consume it via `useDocRoute()`
+* instead of calling `useRoutes()` directly so a single computation is shared
+* across the whole layout.
+*
+* `undefined` means "no active route" (e.g. on a not-found page or before the
+* routes context has hydrated).
+*/
+const DocRouteContext = createContext(void 0);
+function DocRouteProvider({ value, children }) {
+	return /* @__PURE__ */ jsx(DocRouteContext.Provider, {
+		value,
+		children
+	});
+}
+
 //#endregion
 //#region src/client/app/docs-layout.tsx
 function DocsLayout({ collectionsData }) {
 	const { currentRoute } = useRoutes();
-	const content = /* @__PURE__ */ jsx(InternalErrorBoundary, { children: /* @__PURE__ */ jsx(UserLayout, {
-		route: currentRoute,
-		children: /* @__PURE__ */ jsx(Outlet, {})
-	}) });
+	const content = /* @__PURE__ */ jsx(DocRouteProvider, {
+		value: currentRoute,
+		children: /* @__PURE__ */ jsx(InternalErrorBoundary, { children: /* @__PURE__ */ jsx(UserLayout, {
+			route: currentRoute,
+			children: /* @__PURE__ */ jsx(Outlet, {})
+		}) })
+	});
 	if (collectionsData) return /* @__PURE__ */ jsx(CollectionsContext.Provider, {
 		value: collectionsData,
 		children: content
@@ -2116,15 +2146,15 @@ function buildDocRoutes(options) {
 					moduleKey,
 					moduleLoader: mod,
 					route,
-					components
+					components: components ?? {}
 				}, moduleKey || path);
 			} };
 		};
 		else routeRecord.element = /* @__PURE__ */ jsx(EagerMdxElement, {
 			moduleKey,
-			moduleLoader,
+			moduleLoader: moduleLoader ?? {},
 			route,
-			components
+			components: components ?? {}
 		}, moduleKey || path);
 		return routeRecord;
 	});
@@ -2223,6 +2253,15 @@ function buildDocRoutes(options) {
 	};
 }
 
+//#endregion
+//#region src/client/ssg/external-page-wrapper.tsx
+function ExternalPageWrapper({ children }) {
+	return /* @__PURE__ */ jsx("div", {
+		className: "boltdocs-external-content h-screen overflow-y-auto",
+		children
+	});
+}
+
 //#endregion
 //#region src/client/ssg/create-routes.external.tsx
 function buildExternalRoutes(options) {
@@ -2241,11 +2280,12 @@ function buildExternalRoutes(options) {
 			locale: config.i18n?.defaultLocale,
 			title: rawPath === "/" ? "Home" : rawPath.replace(/^\//, "").split("/").pop() || "Page",
 			filePath: "",
+			componentPath: "",
 			headings: []
 		});
 		children.push({
 			path,
-			element: /* @__PURE__ */ jsx(EffectiveExternalLayout, { children: /* @__PURE__ */ jsx(ExtComponent, {}) }),
+			element: /* @__PURE__ */ jsx(ExternalPageWrapper, { children: /* @__PURE__ */ jsx(EffectiveExternalLayout, { children: /* @__PURE__ */ jsx(ExtComponent, {}) }) }),
 			loader: async () => ({
 				path,
 				locale: config.i18n?.defaultLocale
@@ -2259,11 +2299,12 @@ function buildExternalRoutes(options) {
 				locale,
 				title: rawPath,
 				filePath: "",
+				componentPath: "",
 				headings: []
 			});
 			children.push({
 				path: localePath,
-				element: /* @__PURE__ */ jsx(EffectiveExternalLayout, { children: /* @__PURE__ */ jsx(ExtComponent, {}) }),
+				element: /* @__PURE__ */ jsx(ExternalPageWrapper, { children: /* @__PURE__ */ jsx(EffectiveExternalLayout, { children: /* @__PURE__ */ jsx(ExtComponent, {}) }) }),
 				loader: async () => ({
 					path: localePath,
 					locale
@@ -2566,7 +2607,7 @@ function createRoutes(options) {
 		...collectionRoutes.children,
 		{
 			path: "*",
-			element: /* @__PURE__ */ jsx(EffectiveExternalLayout, { children: /* @__PURE__ */ jsx(NotFoundWrapper, {}) })
+			element: /* @__PURE__ */ jsx(ExternalPageWrapper, { children: /* @__PURE__ */ jsx(EffectiveExternalLayout, { children: /* @__PURE__ */ jsx(NotFoundWrapper, {}) }) })
 		}
 	];
 	return [{
@@ -2586,6 +2627,14 @@ function createRoutes(options) {
 
 //#endregion
 //#region src/client/components/docs-layout-default.tsx
+/**
+* Default docs layout — composes the visual primitives and delegates
+* sub-area routing to them. Slot rendering (plugin injections at
+* `navbar:end`, `sidebar:bottom`, `docs-content:top`, etc.) is handled
+* internally by each primitive so the layout itself does no slot "magic".
+*
+* A custom layout can reuse any primitive and the slot wiring just works.
+*/
 function DocsLayoutComponent({ children }) {
 	const { routes: filteredRoutes, currentRoute, isCollectionPage } = useRoutes();
 	const config = useConfig();
@@ -2598,43 +2647,40 @@ function DocsLayoutComponent({ children }) {
 					routes: filteredRoutes || [],
 					config
 				}),
-				/* @__PURE__ */ jsx(DocsLayout$1.Content, {
-					className: "animate-in fade-in duration-500 scroll-smooth",
-					children: /* @__PURE__ */ jsxs(DocsLayout$1.ContentMdx, {
-						className: "max-w-3xl sm:max-w-4xl lg:max-w-5xl px-4 sm:px-6 pt-8 pb-24",
-						children: [
-							!isCollectionPage && /* @__PURE__ */ jsxs(DocsLayout$1.Header, { children: [
-								/* @__PURE__ */ jsxs("div", {
-									className: "mb-4 border-b border-subtle pb-4 flex flex-wrap items-center justify-between gap-3",
-									children: [/* @__PURE__ */ jsx(Breadcrumbs, {}), /* @__PURE__ */ jsx(CopyMarkdown, {
-										mdxRaw: currentRoute?._rawContent,
-										route: currentRoute
-									})]
-								}),
-								currentRoute?.title && /* @__PURE__ */ jsx("h1", {
-									className: "text-4xl font-bold tracking-tight text-default mb-3",
-									children: currentRoute.title
-								}),
-								currentRoute?.description && /* @__PURE__ */ jsx("p", {
-									className: "text-lg text-muted-foreground mb-6 leading-relaxed",
-									children: currentRoute.description
-								})
-							] }),
-							/* @__PURE__ */ jsx(ErrorBoundary, { children: /* @__PURE__ */ jsx("div", {
-								className: "prose prose-neutral dark:prose-invert max-w-none",
-								children
-							}) }),
-							!isCollectionPage && /* @__PURE__ */ jsx(Feedback, {}),
-							!isCollectionPage && /* @__PURE__ */ jsx(Giscus, {}),
-							/* @__PURE__ */ jsx(DocsLayout$1.Footer, { children: !isCollectionPage && /* @__PURE__ */ jsx(PageNav, {}) })
-						]
+				/* @__PURE__ */ jsx(DocsLayout$1.Content, { children: /* @__PURE__ */ jsxs(DocsLayout$1.ContentMdx, { children: [
+					!isCollectionPage && /* @__PURE__ */ jsxs(DocsLayout$1.Header, { children: [
+						/* @__PURE__ */ jsxs("div", {
+							className: "mb-4 border-b border-subtle pb-4 flex flex-wrap items-center justify-between gap-3",
+							children: [/* @__PURE__ */ jsx(Breadcrumbs, {}), /* @__PURE__ */ jsx(CopyMarkdown, {
+								mdxRaw: currentRoute?._rawContent,
+								route: currentRoute
+							})]
+						}),
+						currentRoute?.title && /* @__PURE__ */ jsx("h1", {
+							className: "text-4xl font-bold tracking-tight text-default mb-3",
+							children: currentRoute.title
+						}),
+						currentRoute?.description && /* @__PURE__ */ jsx("p", {
+							className: "text-lg text-muted-foreground mb-6 leading-relaxed",
+							children: currentRoute.description
+						})
+					] }),
+					/* @__PURE__ */ jsx(ErrorBoundary, { children: /* @__PURE__ */ jsx("div", {
+						className: "prose prose-neutral dark:prose-invert max-w-none",
+						children
+					}) }),
+					!isCollectionPage && /* @__PURE__ */ jsx(Feedback, {}),
+					!isCollectionPage && /* @__PURE__ */ jsx(Giscus, {}),
+					/* @__PURE__ */ jsx(DocsLayout$1.Footer, { children: !isCollectionPage && /* @__PURE__ */ jsx(PageNav, {}) })
+				] }) }),
+				/* @__PURE__ */ jsx("div", {
+					className: "overflow-y-auto sticky",
+					children: /* @__PURE__ */ jsx(OnThisPage, {
+						headings: currentRoute?.headings,
+						filePath: currentRoute?.filePath,
+						communityHelp: config.theme?.communityHelp,
+						editLink: config.theme?.editLink
 					})
-				}),
-				/* @__PURE__ */ jsx(OnThisPage, {
-					headings: currentRoute?.headings,
-					filePath: currentRoute?.filePath,
-					communityHelp: config.theme?.communityHelp,
-					editLink: config.theme?.editLink
 				})
 			]
 		})]
@@ -2656,4 +2702,4 @@ const reactToText = (node, resolvers) => {
 };
 
 //#endregion
-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 };
+export { Banner, BoltdocsShell, Breadcrumbs, CollectionsContext, CopyMarkdown, CurrentPostProvider, DocsLayoutComponent as DocsLayout, ErrorBoundary, MdxPage, Navbar, NotFound, OnThisPage, PageNav, SearchDialog, Sidebar, Timeline, ViteReactSSG, cn, copyToClipboard, createRoutes, getStarsRepo, getTranslated, reactToText, useAnalytics, useBreadcrumbs, useCodeBlock, useConfig, useFeedback, useHeadings, useI18n, useLocalizedTo, useLocation, useMdxComponents, useMergedComponents, useNavbar, usePageNav, usePost, usePosts, useRecentPosts, useRoutes, useSearch, useSearchHighlight, useSidebar, useTabs, useTheme, useTrackEvent, useTrackPageView, useUI, useVersion };

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-CDUcJmye.cjs');
+const require_mdx = require('../mdx-CD-tSjRG.cjs');
 
 //#region src/client/mdx.ts
 const { Card, Cards, Callout, Field, Image } = require_mdx.mdx_components_default;

package/dist/client/mdx.d.cts

@@ -2,7 +2,7 @@
 import * as _$react_jsx_runtime0 from "react/jsx-runtime";
 
 //#region src/client/components/mdx/card.d.ts
-interface CardProps extends React.HTMLAttributes<HTMLDivElement> {
+interface CardProps extends Omit<React.HTMLAttributes<HTMLDivElement>, 'title'> {
   title?: React.ReactNode;
   icon?: React.ReactNode;
   href?: string;

package/dist/client/mdx.d.ts

@@ -2,7 +2,7 @@
 import * as _$react_jsx_runtime0 from "react/jsx-runtime";
 
 //#region src/client/components/mdx/card.d.ts
-interface CardProps extends React.HTMLAttributes<HTMLDivElement> {
+interface CardProps extends Omit<React.HTMLAttributes<HTMLDivElement>, 'title'> {
   title?: React.ReactNode;
   icon?: React.ReactNode;
   href?: string;

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-Bv-pS6-O.js";
+import { t as mdx_components_default } from "../mdx-BuO6a1f7.js";
 
 //#region src/client/mdx.ts
 const { Card, Cards, Callout, Field, Image } = mdx_components_default;