boltdocs 3.0.2 → 3.2.1

package/dist/{mdx-DJBg5DuL.cjs → mdx-CD-tSjRG.cjs}

@@ -3,8 +3,8 @@
  * Copyright (c) 2026 Jesus Alcala
  * Licensed under the MIT License.
  */
-const require_icons_dev = require('./icons-dev-BryEFkJu.cjs');
-const require_image = require('./image-CR6UlaI5.cjs');
+const require_link = require('./link-D1Gjkb-2.cjs');
+const require_image = require('./image-C4TlpMHn.cjs');
 let react = require("react");
 let react_jsx_runtime = require("react/jsx-runtime");
 let react_aria_components = require("react-aria-components");
@@ -44,9 +44,9 @@ const Field = ({ children, name, type, description, required }) => /* @__PURE__
 //#endregion
 //#region src/client/components/mdx/typographics.tsx
 const Anchor = ({ href, children, className, ...props }) => {
-	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_icons_dev.Link, {
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_link.Link, {
 		href: href || "",
-		className: require_icons_dev.cn("text-primary-500 hover:text-primary-400 dark:text-primary-500 hover:underline font-medium transition-colors duration-200", className),
+		className: require_link.cn("text-primary-500 hover:text-primary-400 dark:text-primary-500 hover:underline font-medium transition-colors duration-200", className),
 		...props,
 		children
 	});
@@ -62,7 +62,7 @@ const HEADING_CLASSES = {
 const Heading = ({ level, className, ...props }) => {
 	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_image.Heading, {
 		level,
-		className: require_icons_dev.cn(HEADING_CLASSES[level] || "", className),
+		className: require_link.cn(HEADING_CLASSES[level] || "", className),
 		...props
 	});
 };
@@ -93,35 +93,39 @@ const Typographics = {
 		...props
 	}),
 	p: ({ className, ...props }) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
-		className: require_icons_dev.cn("text-paragraph leading-relaxed my-5", className),
+		className: require_link.cn("text-paragraph leading-relaxed my-5", className),
 		...props
 	}),
 	strong: ({ className, ...props }) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)("strong", {
-		className: require_icons_dev.cn("font-semibold text-body", className),
+		className: require_link.cn("font-semibold text-body", className),
 		...props
 	}),
 	mark: ({ className, ...props }) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)("mark", {
-		className: require_icons_dev.cn("bg-primary-500/10 text-primary-500 font-semibold px-1.5 py-0.5 rounded-md", className),
+		className: require_link.cn("bg-primary-500/10 text-primary-500 font-semibold px-1.5 py-0.5 rounded-md", className),
+		...props
+	}),
+	code: ({ className, ...props }) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)("code", {
+		className: require_link.cn("bg-code-bg text-code-text rounded-md px-1.5 py-0.5 text-[0.875em] font-mono font-medium", className),
 		...props
 	}),
 	blockquote: ({ className, ...props }) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)("blockquote", {
-		className: require_icons_dev.cn("border-l-4 border-primary-500 bg-soft/30 pl-4 py-2 my-6 italic text-muted rounded-r-lg", className),
+		className: require_link.cn("border-l-4 border-primary-500 bg-soft/30 pl-4 py-2 my-6 italic text-muted rounded-r-lg", className),
 		...props
 	}),
 	hr: ({ className, ...props }) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)("hr", {
-		className: require_icons_dev.cn("my-8 border-t border-subtle", className),
+		className: require_link.cn("my-8 border-t border-subtle", className),
 		...props
 	}),
 	ul: ({ className, ...props }) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)("ul", {
-		className: require_icons_dev.cn("list-disc pl-6 my-5 space-y-2 text-paragraph", className),
+		className: require_link.cn("list-disc pl-6 my-5 space-y-2 text-paragraph", className),
 		...props
 	}),
 	ol: ({ className, ...props }) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)("ol", {
-		className: require_icons_dev.cn("list-decimal pl-6 my-5 space-y-2 text-paragraph", className),
+		className: require_link.cn("list-decimal pl-6 my-5 space-y-2 text-paragraph", className),
 		...props
 	}),
 	li: ({ className, ...props }) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)("li", {
-		className: require_icons_dev.cn("pl-1", className),
+		className: require_link.cn("pl-1", className),
 		...props
 	})
 };
@@ -136,20 +140,20 @@ const Table = (props) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
 	})
 });
 const TableHead = (props) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)("thead", {
-	className: require_icons_dev.cn("border-b border-subtle bg-soft/50", props.className),
+	className: require_link.cn("border-b border-subtle bg-soft/50", props.className),
 	...props
 });
 const TableBody = (props) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)("tbody", { ...props });
 const TableRow = (props) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)("tr", {
-	className: require_icons_dev.cn("border-b border-subtle last:border-0 even:bg-soft/10 hover:bg-soft/20 transition-colors", props.className),
+	className: require_link.cn("border-b border-subtle last:border-0 even:bg-soft/10 hover:bg-soft/20 transition-colors", props.className),
 	...props
 });
 const TableHeader = (props) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)("th", {
-	className: require_icons_dev.cn("px-4 py-3 font-semibold text-body text-xs font-mono", props.className),
+	className: require_link.cn("px-4 py-3 font-semibold text-body text-xs font-mono", props.className),
 	...props
 });
 const TableCell = (props) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)("td", {
-	className: require_icons_dev.cn("px-4 py-3 text-paragraph leading-relaxed", props.className),
+	className: require_link.cn("px-4 py-3 text-paragraph leading-relaxed", props.className),
 	...props
 });
 const TableComponents = {
@@ -168,35 +172,35 @@ const variantStyles = {
 		container: "bg-slate-500/5 dark:bg-slate-500/10 border-slate-500/40 text-slate-800 dark:text-slate-200",
 		titleText: "text-slate-900 dark:text-slate-100",
 		iconColor: "text-slate-500",
-		icon: require_icons_dev.Info,
+		icon: require_link.Info,
 		defaultTitle: "Note"
 	},
 	info: {
 		container: "bg-indigo-500/5 dark:bg-indigo-500/10 border-indigo-500/40 text-indigo-800 dark:text-indigo-200",
 		titleText: "text-indigo-900 dark:text-indigo-100",
 		iconColor: "text-indigo-500",
-		icon: require_icons_dev.Info,
+		icon: require_link.Info,
 		defaultTitle: "Info"
 	},
 	tip: {
 		container: "bg-green-500/5 dark:bg-green-500/10 border-green-500/40 text-green-800 dark:text-green-200",
 		titleText: "text-green-900 dark:text-green-100",
 		iconColor: "text-green-500",
-		icon: require_icons_dev.Lightbulb,
+		icon: require_link.Lightbulb,
 		defaultTitle: "Tip"
 	},
 	warning: {
 		container: "bg-amber-500/5 dark:bg-amber-500/10 border-amber-500/40 text-amber-800 dark:text-amber-200",
 		titleText: "text-amber-900 dark:text-amber-100",
 		iconColor: "text-amber-500",
-		icon: require_icons_dev.AlertTriangle,
+		icon: require_link.AlertTriangle,
 		defaultTitle: "Warning"
 	},
 	danger: {
 		container: "bg-rose-500/5 dark:bg-rose-500/10 border-rose-500/40 text-rose-800 dark:text-rose-200",
 		titleText: "text-rose-900 dark:text-rose-100",
 		iconColor: "text-rose-500",
-		icon: require_icons_dev.AlertCircle,
+		icon: require_link.AlertCircle,
 		defaultTitle: "Danger"
 	}
 };
@@ -204,15 +208,15 @@ function Callout({ children, className = "", variant = "note", title, ...props }
 	const styles = variantStyles[variant] || variantStyles.note;
 	const Icon = styles.icon;
 	return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
-		className: require_icons_dev.cn("my-6 flex gap-4 p-4 rounded-xl border-2", styles.container, className),
+		className: require_link.cn("my-6 flex gap-4 p-4 rounded-xl border-2", styles.container, className),
 		...props,
 		children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
-			className: require_icons_dev.cn("shrink-0 pt-0.5", styles.iconColor),
-			children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(Icon, { className: "w-5 h-5 stroke-[2]" })
+			className: require_link.cn("shrink-0 pt-0.5", styles.iconColor),
+			children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(Icon, { className: "w-5 h-5 stroke-2" })
 		}), /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 			className: "flex-1 text-[0.875rem] leading-[1.6]",
 			children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
-				className: require_icons_dev.cn("font-bold text-sm mb-1", styles.titleText),
+				className: require_link.cn("font-bold text-sm mb-1", styles.titleText),
 				children: title || styles.defaultTitle
 			}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
 				className: "prose prose-neutral dark:prose-invert max-w-none [&>p]:m-0 [&>p+p]:mt-2",
@@ -248,33 +252,14 @@ const copyToClipboard = async (text) => {
 
 //#endregion
 //#region src/client/components/mdx/use-code-block.ts
-const langIconMap = {
-	ts: require_icons_dev.TypeScript,
-	tsx: require_icons_dev.React,
-	js: require_icons_dev.JavaScript,
-	jsx: require_icons_dev.React,
-	json: require_icons_dev.Json,
-	css: require_icons_dev.Css,
-	html: require_icons_dev.BracketsOrange,
-	md: require_icons_dev.Markdown,
-	mdx: require_icons_dev.Markdown,
-	bash: require_icons_dev.Shell,
-	sh: require_icons_dev.Shell,
-	yaml: require_icons_dev.Yaml,
-	yml: require_icons_dev.Yaml,
-	rs: require_icons_dev.Rust,
-	rust: require_icons_dev.Rust,
-	toml: require_icons_dev.BracketsRed,
-	csv: require_icons_dev.Csv
-};
 function useCodeBlock(props) {
 	const [copied, setCopied] = (0, react.useState)(false);
 	const [isExpanded, setIsExpanded] = (0, react.useState)(false);
 	const [isExpandable, setIsExpandable] = (0, react.useState)(false);
+	const [rated, setRated] = (0, react.useState)(null);
 	const preRef = (0, react.useRef)(null);
 	const timerRef = (0, react.useRef)(null);
-	const [rated, setRated] = (0, react.useState)(null);
-	const customConfig = require_icons_dev.useConfig().integrations?.feedback?.custom;
+	const customConfig = require_link.useConfig().integrations?.feedback?.custom;
 	const showCodeBlockFeedback = !!(customConfig?.enabled && !props.plain);
 	const lang = props.lang || props["data-lang"] || "";
 	const isHighlighted = props["data-highlighted"] === "true" || typeof props.className === "string" && props.className.includes("shiki");
@@ -326,7 +311,6 @@ function useCodeBlock(props) {
 		const lines = (preRef.current?.textContent ?? "").trim().split("\n").length;
 		setIsExpandable(lines > 6);
 	}, [props.children, props.highlightedHtml]);
-	const LangIcon = langIconMap[lang] || require_icons_dev.File;
 	return {
 		copied,
 		isExpanded,
@@ -341,8 +325,7 @@ function useCodeBlock(props) {
 		lang,
 		showCodeBlockFeedback,
 		rated,
-		handleRate,
-		LangIcon
+		handleRate
 	};
 }
 
@@ -353,9 +336,9 @@ const CopyButton = ({ copied, handleCopy }) => {
 		content: copied ? "Copied!" : "Copy code",
 		children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(react_aria_components.Button, {
 			onPress: handleCopy,
-			className: require_icons_dev.cn("grid place-items-center size-8 bg-transparent outline-none cursor-pointer transition-all duration-200 hover:scale-110 active:scale-95 [&>svg]:size-4 [&>svg]:stroke-2 z-10", copied ? "text-emerald-400" : "text-muted hover:text-body"),
+			className: require_link.cn("grid place-items-center size-8 bg-transparent outline-none cursor-pointer transition-all duration-200 hover:scale-110 active:scale-95 [&>svg]:size-4 [&>svg]:stroke-2 z-10", copied ? "text-emerald-400" : "text-muted hover:text-body"),
 			"aria-label": "Copy code",
-			children: copied ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_icons_dev.Check, { size: 20 }) : /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_icons_dev.Copy, { size: 20 })
+			children: copied ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_link.Check, { size: 20 }) : /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_link.Copy, { size: 20 })
 		})
 	});
 };
@@ -365,9 +348,9 @@ const CodeBlockFeedback = ({ rated, onRate }) => {
 		children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_image.Tooltip, {
 			content: rated === "up" ? "Helpful!" : "This code is helpful",
 			children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(react_aria_components.Button, {
-				onPress: () => onRate("up"),
-				disabled: rated !== null,
-				className: require_icons_dev.cn("grid place-items-center size-8 bg-transparent outline-none cursor-pointer transition-all duration-200 hover:scale-110 active:scale-95 [&>svg]:size-4 [&>svg]:stroke-2 z-10", rated === "up" ? "text-emerald-500 dark:text-emerald-400" : rated === "down" ? "opacity-30 cursor-not-allowed text-muted" : "text-muted hover:text-body"),
+				onPress: (() => onRate("up")),
+				isDisabled: rated !== null,
+				className: require_link.cn("grid place-items-center size-8 bg-transparent outline-none cursor-pointer transition-all duration-200 hover:scale-110 active:scale-95 [&>svg]:size-4 [&>svg]:stroke-2 z-10", rated === "up" ? "text-emerald-500 dark:text-emerald-400" : rated === "down" ? "opacity-30 cursor-not-allowed text-muted" : "text-muted hover:text-body"),
 				"aria-label": "Mark as helpful",
 				children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("svg", {
 					xmlns: "http://www.w3.org/2000/svg",
@@ -383,9 +366,9 @@ const CodeBlockFeedback = ({ rated, onRate }) => {
 		}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_image.Tooltip, {
 			content: rated === "down" ? "Unhelpful" : "This code is unhelpful",
 			children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(react_aria_components.Button, {
-				onPress: () => onRate("down"),
-				disabled: rated !== null,
-				className: require_icons_dev.cn("grid place-items-center size-8 bg-transparent outline-none cursor-pointer transition-all duration-200 hover:scale-110 active:scale-95 [&>svg]:size-4 [&>svg]:stroke-2 z-10", rated === "down" ? "text-rose-500 dark:text-rose-400" : rated === "up" ? "opacity-30 cursor-not-allowed text-muted" : "text-muted hover:text-body"),
+				onPress: (() => onRate("down")),
+				isDisabled: rated !== null,
+				className: require_link.cn("grid place-items-center size-8 bg-transparent outline-none cursor-pointer transition-all duration-200 hover:scale-110 active:scale-95 [&>svg]:size-4 [&>svg]:stroke-2 z-10", rated === "down" ? "text-rose-500 dark:text-rose-400" : rated === "up" ? "opacity-30 cursor-not-allowed text-muted" : "text-muted hover:text-body"),
 				"aria-label": "Mark as unhelpful",
 				children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("svg", {
 					xmlns: "http://www.w3.org/2000/svg",
@@ -404,17 +387,14 @@ const CodeBlockFeedback = ({ rated, onRate }) => {
 function CodeBlock(props) {
 	const { children, hideCopy = false, highlightedHtml, "data-highlighted-html": dataHighlightedHtml, title, "data-title": dataTitle, "data-lang": dataLang, plain = false, lineNumbers, showLineNumbers, wordWrap, "word-wrap": wordWrapHyphen, metastring, ...rest } = props;
 	const { className: shikiClassName, ...cleanRest } = rest;
-	const { copied, isExpanded, setIsExpanded, isExpandable, preRef, handleCopy, shouldTruncate, isHighlighted, effectiveHighlightedHtml, effectiveTitle, showCodeBlockFeedback, rated, handleRate, LangIcon } = useCodeBlock(props);
+	const { copied, isExpanded, setIsExpanded, isExpandable, preRef, handleCopy, shouldTruncate, isHighlighted, effectiveHighlightedHtml, effectiveTitle, showCodeBlockFeedback, rated, handleRate } = useCodeBlock(props);
 	return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(require_image.CodeBlock, {
 		plain,
 		className: props.className,
 		children: [(effectiveTitle || !hideCopy) && /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(require_image.CodeBlockHeader, {
-			className: require_icons_dev.cn({ "absolute top-2 left-0 w-full": !effectiveTitle }),
-			children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_image.CodeBlockGroup, { children: effectiveTitle && /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [LangIcon ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)(LangIcon, { size: 14 }) : /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_icons_dev.File, {
-				size: 14,
-				className: "opacity-60"
-			}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", { children: effectiveTitle })] }) }), /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
-				className: "flex items-center gap-1",
+			className: require_link.cn({ "absolute top-2 left-0 w-full": !effectiveTitle }),
+			children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_image.CodeBlockGroup, { children: effectiveTitle && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", { children: effectiveTitle }) }), /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+				className: "flex items-center gap-1 bg-(--color-code-bg) pl-2 z-10",
 				children: [showCodeBlockFeedback && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(CodeBlockFeedback, {
 					rated,
 					onRate: handleRate
@@ -431,14 +411,14 @@ function CodeBlock(props) {
 				dangerouslySetInnerHTML: { __html: effectiveHighlightedHtml }
 			}) : /* @__PURE__ */ (0, react_jsx_runtime.jsx)("pre", {
 				ref: preRef,
-				className: require_icons_dev.cn("m-0! rounded-none! border-none! bg-transparent!", "text-[0.875rem] leading-[1.6] overflow-x-auto", shikiClassName, {
+				className: require_link.cn("m-0! rounded-none! border-none! bg-transparent!", "text-[0.875rem] leading-[1.6] overflow-x-auto", shikiClassName, {
 					"p-0! [&>code]:grid! [&>code]:p-5! [&>code]:bg-transparent!": isHighlighted,
 					"p-5!": !isHighlighted
 				}),
 				...cleanRest,
 				children
 			}), isExpandable && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
-				className: require_icons_dev.cn({
+				className: require_link.cn({
 					"absolute bottom-0 inset-x-0 h-32 flex items-end justify-center pb-4 z-10": shouldTruncate,
 					"relative flex justify-center pb-4 pt-1 -mt-4": !shouldTruncate
 				}),
@@ -470,7 +450,7 @@ const Image = ({ src, alt, title, theme, className, ...props }) => {
 				theme,
 				loading: "lazy",
 				decoding: "async",
-				className: require_icons_dev.cn("w-full h-auto object-contain transition-transform duration-500 group-hover:scale-[1.01] my-0 rounded-md sm:rounded-xl block", className),
+				className: require_link.cn("w-full h-auto object-contain transition-transform duration-500 group-hover:scale-[1.01] my-0 rounded-md sm:rounded-xl block", className),
 				...props
 			})
 		}), caption && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("figcaption", {
@@ -502,7 +482,7 @@ function Card({ className, title, icon, href, children, ...props }) {
 		ref: cardRef,
 		href,
 		onMouseMove: handleMouseMove,
-		className: require_icons_dev.cn("group relative flex flex-col gap-3 rounded-2xl border p-6 overflow-hidden", "transition-[box-shadow,transform] duration-300", "hover:shadow-lg dark:hover:shadow-none hover:-translate-y-0.5", "bg-surface border-subtle text-paragraph", href && "cursor-pointer", className),
+		className: require_link.cn("group relative flex flex-col gap-3 rounded-2xl border p-6 overflow-hidden", "transition-[box-shadow,transform] duration-300", "hover:shadow-lg dark:hover:shadow-none hover:-translate-y-0.5", "bg-surface border-subtle text-paragraph", href && "cursor-pointer", className),
 		...props,
 		children: [
 			/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
@@ -522,7 +502,7 @@ function Card({ className, title, icon, href, children, ...props }) {
 			/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 				className: "relative z-10 flex items-center gap-3",
 				children: [icon && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
-					className: require_icons_dev.cn("shrink-0 transition-transform duration-500 group-hover:rotate-[15deg] group-hover:scale-110 flex items-center justify-center text-muted group-hover:text-primary-500", "[&>svg]:w-6 [&>svg]:h-6 [&>svg]:stroke-[1.5]"),
+					className: require_link.cn("shrink-0 transition-transform duration-500 group-hover:rotate-15 group-hover:scale-110 flex items-center justify-center text-muted group-hover:text-primary-500", "[&>svg]:w-6 [&>svg]:h-6 [&>svg]:stroke-[1.5]"),
 					children: icon
 				}), title && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("h3", {
 					className: "font-semibold text-base m-0 leading-none text-body",
@@ -541,7 +521,7 @@ function Card({ className, title, icon, href, children, ...props }) {
 //#region src/client/components/mdx/cards.tsx
 function Cards({ children, className, cols = 2, ...props }) {
 	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
-		className: require_icons_dev.cn("grid gap-4 my-6", {
+		className: require_link.cn("grid gap-4 my-6", {
 			"grid-cols-1": cols === 1,
 			"grid-cols-1 sm:grid-cols-2": cols === 2,
 			"grid-cols-1 sm:grid-cols-2 md:grid-cols-3": cols === 3,
@@ -576,6 +556,184 @@ function LastUpdated({ date }) {
 	});
 }
 
+//#endregion
+//#region src/client/components/mdx/timeline.tsx
+const VARIANT_PALETTE = {
+	primary: {
+		ring: "border-primary-500/70",
+		fill: "bg-primary-500",
+		badgeBg: "bg-primary-500/10",
+		badgeText: "text-primary-600 dark:text-primary-400",
+		badgeBorder: "border-primary-500/30"
+	},
+	success: {
+		ring: "border-success-500/70",
+		fill: "bg-success-500",
+		badgeBg: "bg-success-500/10",
+		badgeText: "text-success-500",
+		badgeBorder: "border-success-500/30"
+	},
+	info: {
+		ring: "border-info-500/70",
+		fill: "bg-info-500",
+		badgeBg: "bg-info-500/10",
+		badgeText: "text-info-500",
+		badgeBorder: "border-info-500/30"
+	},
+	warning: {
+		ring: "border-warning-500/70",
+		fill: "bg-warning-500",
+		badgeBg: "bg-warning-500/10",
+		badgeText: "text-warning-500",
+		badgeBorder: "border-warning-500/30"
+	},
+	danger: {
+		ring: "border-danger-500/70",
+		fill: "bg-danger-500",
+		badgeBg: "bg-danger-500/10",
+		badgeText: "text-danger-500",
+		badgeBorder: "border-danger-500/30"
+	},
+	major: {
+		ring: "",
+		fill: "",
+		badgeBg: "",
+		badgeText: "",
+		badgeBorder: ""
+	},
+	minor: {
+		ring: "",
+		fill: "",
+		badgeBg: "",
+		badgeText: "",
+		badgeBorder: ""
+	},
+	patch: {
+		ring: "",
+		fill: "",
+		badgeBg: "",
+		badgeText: "",
+		badgeBorder: ""
+	},
+	new: {
+		ring: "",
+		fill: "",
+		badgeBg: "",
+		badgeText: "",
+		badgeBorder: ""
+	},
+	deprecated: {
+		ring: "",
+		fill: "",
+		badgeBg: "",
+		badgeText: "",
+		badgeBorder: ""
+	},
+	breaking: {
+		ring: "",
+		fill: "",
+		badgeBg: "",
+		badgeText: "",
+		badgeBorder: ""
+	}
+};
+Object.assign(VARIANT_PALETTE, {
+	major: VARIANT_PALETTE.primary,
+	minor: VARIANT_PALETTE.success,
+	patch: VARIANT_PALETTE.info,
+	new: VARIANT_PALETTE.primary,
+	deprecated: VARIANT_PALETTE.warning,
+	breaking: VARIANT_PALETTE.danger
+});
+function normalizeBadge(badge) {
+	if (!badge) return null;
+	if (typeof badge === "string") return {
+		text: badge,
+		variant: "primary"
+	};
+	return {
+		text: badge.text,
+		variant: badge.variant ?? "primary"
+	};
+}
+function formatDate(date, locale) {
+	if (date === void 0 || date === null || date === "") return null;
+	const d = date instanceof Date ? date : new Date(date);
+	if (Number.isNaN(d.getTime())) return null;
+	return d.toLocaleDateString(locale ?? "en-US", {
+		year: "numeric",
+		month: "short",
+		day: "numeric"
+	});
+}
+const VARIANT_DEFAULT_ICON = {
+	success: require_link.Check,
+	info: require_link.Info,
+	warning: require_link.AlertTriangle,
+	danger: require_link.AlertCircle
+};
+function TimelineRoot({ children, className, compact = false, ...props }) {
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("ol", {
+		role: "list",
+		className: require_link.cn("relative my-8 ms-3", compact ? "space-y-3" : "space-y-7", className),
+		...props,
+		children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+			"aria-hidden": "true",
+			className: "pointer-events-none absolute top-3 bottom-3 start-[5.5px] w-px bg-subtle"
+		}), children]
+	});
+}
+function TimelineItem({ date, title, badge, icon, variant = "primary", locale, className, children, ...props }) {
+	const palette = VARIANT_PALETTE[variant] ?? VARIANT_PALETTE.primary;
+	const formatted = formatDate(date, locale);
+	const badgeCfg = normalizeBadge(badge);
+	const FallbackIcon = VARIANT_DEFAULT_ICON[variant];
+	const dot = icon ?? (FallbackIcon ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)(FallbackIcon, {
+		size: 12,
+		className: "text-white",
+		"aria-hidden": "true"
+	}) : /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+		"aria-hidden": "true",
+		className: require_link.cn("w-2 h-2 rounded-full", palette.fill)
+	}));
+	const ariaLabel = [formatted, typeof title === "string" ? title : null].filter(Boolean).join(" - ") || void 0;
+	const a11yProps = ariaLabel ? {
+		role: "img",
+		"aria-label": ariaLabel
+	} : { "aria-hidden": "true" };
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("li", {
+		className: require_link.cn("relative ps-8", className),
+		...props,
+		children: [
+			/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+				...a11yProps,
+				className: require_link.cn("absolute start-0 top-1 flex items-center justify-center w-3 h-3 rounded-full", "bg-surface border-2 shadow-sm", palette.ring),
+				children: dot
+			}),
+			/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+				className: "flex items-center gap-2 flex-wrap mb-1",
+				children: [formatted && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("time", {
+					dateTime: date instanceof Date ? date.toISOString() : new Date(date).toISOString(),
+					className: "text-[11px] uppercase tracking-wider font-mono tabular-nums text-muted select-none",
+					children: formatted
+				}), badgeCfg && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+					className: require_link.cn("inline-flex items-center px-2 py-0.5 rounded-full text-[10px] font-bold uppercase tracking-wide border", palette.badgeBg, palette.badgeText, palette.badgeBorder),
+					children: badgeCfg.text
+				})]
+			}),
+			/* @__PURE__ */ (0, react_jsx_runtime.jsx)("h3", {
+				className: "text-base font-semibold text-body m-0 leading-snug",
+				children: title
+			}),
+			children && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+				className: "mt-2 text-[0.9rem] leading-[1.6] text-paragraph prose prose-neutral dark:prose-invert max-w-none [&>p]:m-0 [&>p+p]:mt-2 [&_a]:text-primary-500 [&_a]:no-underline hover:[&_a]:underline",
+				children
+			})
+		]
+	});
+}
+const Timeline = Object.assign(TimelineRoot, { Item: TimelineItem });
+
 //#endregion
 //#region src/client/components/mdx/index.ts
 const mdx_components_default = {
@@ -587,10 +745,17 @@ const mdx_components_default = {
 	Field,
 	Callout,
 	Card,
-	Cards
+	Cards,
+	Timeline
 };
 
 //#endregion
+Object.defineProperty(exports, 'Timeline', {
+  enumerable: true,
+  get: function () {
+    return Timeline;
+  }
+});
 Object.defineProperty(exports, 'copyToClipboard', {
   enumerable: true,
   get: function () {

package/dist/{meta-loader-C9MKjAs0.cjs → meta-loader-Dq1zcFnh.cjs}

@@ -3,4 +3,4 @@
  * Copyright (c) 2026 Jesus Alcala
  * Licensed under the MIT License.
  */
-const e=require(`./chunk-Ds5LZdWN.cjs`);let t=require(`node:path`);t=e.n(t);let n=require(`@bdocs/dui`),r=require(`fdir`),i=require(`node:fs/promises`);i=e.n(i);async function a(e){let a={};try{let o=(await new r.fdir().withFullPaths().filter(e=>e.endsWith(`meta.json`)).crawl(e).withPromise()).filter(e=>{let n=t.default.basename(e);return n===`meta.json`||n===`_meta.json`}),s=await Promise.allSettled(o.map(async n=>{let r=await i.default.readFile(n,`utf-8`),a=t.default.relative(e,t.default.dirname(n)).replace(/\\/g,`/`);return{key:a===``?`.`:a,content:JSON.parse(r)}}));for(let e of s)e.status===`fulfilled`?a[e.value.key]=e.value.content:(0,n.warn)(`Failed to read meta.json:`,e.reason)}catch(e){(0,n.error)(`Error loading directory metadata:`,e)}return a}exports.loadDirectoryMeta=a;
+const e=require(`./chunk-D1Md3oWO.cjs`);let t=require(`node:path`);t=e.r(t);let n=require(`@bdocs/dui`),r=require(`fdir`),i=require(`node:fs/promises`);i=e.r(i);async function a(e){let a={};try{let o=(await new r.fdir().withFullPaths().filter(e=>e.endsWith(`meta.json`)).crawl(e).withPromise()).filter(e=>{let n=t.default.basename(e);return n===`meta.json`||n===`_meta.json`}),s=await Promise.allSettled(o.map(async n=>{let r=await i.default.readFile(n,`utf-8`),a=t.default.relative(e,t.default.dirname(n)).replace(/\\/g,`/`);return{key:a===``?`.`:a,content:JSON.parse(r)}}));for(let e of s)e.status===`fulfilled`?a[e.value.key]=e.value.content:(0,n.warn)(`Failed to read meta.json:`,e.reason)}catch(e){(0,n.error)(`Error loading directory metadata:`,e)}return a}exports.loadDirectoryMeta=a;

package/dist/node/cache.cjs

@@ -0,0 +1,6 @@
+/**
+ * Boltdocs - https://boltdocs.vercel.app
+ * Copyright (c) 2026 Jesus Alcala
+ * Licensed under the MIT License.
+ */
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`../chunk-D1Md3oWO.cjs`),t=require(`../utils-D6Xtj0FZ.cjs`);let n=require(`node:path`);n=e.r(n);let r=require(`node:fs/promises`);r=e.r(r);let i=require(`node:crypto`);i=e.r(i);let a=require(`node:zlib`);a=e.r(a);let o=require(`node:util`),s=require(`lru-cache`);const c=r.default.writeFile,l=r.default.readFile,u=r.default.mkdir,d=r.default.rename,f=(0,o.promisify)(a.default.gzip),p=(0,o.promisify)(a.default.gunzip),m=new class{activeTasks=new Set;add(e){let t=Promise.resolve().then(e).catch(()=>{}).finally(()=>{this.activeTasks.delete(t)});this.activeTasks.add(t)}async flush(){await Promise.all(Array.from(this.activeTasks))}get pending(){return this.activeTasks.size}};var h=class{entries=new Map;cachePath=null;compress;loaded=!1;constructor(e={}){let r=t.o();if(this.compress=e.compress===void 0?r.compress:e.compress,e.name){let t=e.root||process.cwd(),i=this.compress?`json.gz`:`json`;this.cachePath=n.default.resolve(t,r.dir,`${e.name}.${i}`)}}async load(){if(!this.loaded&&!t.o().noCache&&this.cachePath)try{let e=await l(this.cachePath);this.cachePath.endsWith(`.gz`)&&(e=await p(new Uint8Array(e)));let t=JSON.parse(e.toString(`utf-8`));this.entries=new Map(Object.entries(t)),this.loaded=!0}catch(e){if(e instanceof Error&&e.code===`ENOENT`)return}}save(){if(t.o().noCache||!this.cachePath)return;let e=Object.fromEntries(this.entries),r=JSON.stringify(e),a=this.cachePath,o=this.compress;m.add(async()=>{try{await u(n.default.dirname(a),{recursive:!0});let e=Buffer.from(r);o&&(e=await f(e));let t=`${a}.${i.default.randomBytes(4).toString(`hex`)}.tmp`;await c(t,e),await d(t,a)}catch{}})}get(e){let n=this.entries.get(e);return!n||t.s(e)!==n.mtime?null:n.data}getStale(e){let t=this.entries.get(e);return t?t.data:null}set(e,n){this.entries.set(e,{data:n,mtime:t.s(e)})}isValid(e){let n=this.entries.get(e);return n?t.s(e)===n.mtime:!1}invalidate(e){this.entries.delete(e)}invalidateAll(){this.entries.clear(),this.loaded=!1}pruneStale(e){for(let t of this.entries.keys())e.has(t)||this.entries.delete(t)}get size(){return this.entries.size}async flush(){await m.flush()}},g=class{index=new Map;memoryCache;baseDir;shardsDir;indexPath;saveTimeout=null;constructor(e,r=process.cwd()){let i=t.o();this.baseDir=n.default.resolve(r,i.dir,`transform-${e}`),this.shardsDir=n.default.resolve(this.baseDir,`shards`),this.indexPath=n.default.resolve(this.baseDir,`index.json`),this.memoryCache=new s.LRUCache({max:i.lruLimit,ttl:i.lruTTL,updateAgeOnGet:!0})}async load(){if(!t.o().noCache)try{let e=await l(this.indexPath,`utf-8`);this.index=new Map(Object.entries(JSON.parse(e)))}catch(e){if(e instanceof Error&&e.code===`ENOENT`)return}}save(){if(t.o().noCache)return;let e=JSON.stringify(Object.fromEntries(this.index)),r=this.indexPath;m.add(async()=>{try{await u(n.default.dirname(r),{recursive:!0}),await c(r,e)}catch{}})}async getMany(e){let t=new Map,r=[];for(let n of e){let e=this.memoryCache.get(n);e?t.set(n,e):this.index.has(n)&&r.push(n)}if(r.length>0){let e=await Promise.all(r.map(async e=>{let t=this.index.get(e),r=n.default.resolve(this.shardsDir,`${t}.gz`);try{let t=await l(r),n=(await p(new Uint8Array(t))).toString(`utf-8`);return this.memoryCache.set(e,n),{key:e,val:n}}catch{return null}}));for(let n of e)n&&t.set(n.key,n.val)}return t}async getAsync(e){let t=this.memoryCache.get(e);if(t)return t;let r=this.index.get(e);if(!r)return null;let i=n.default.resolve(this.shardsDir,`${r}.gz`);try{let t=(await p(await l(i))).toString(`utf-8`);return this.memoryCache.set(e,t),t}catch(e){return e instanceof Error&&e.code,null}}set(e,t){let a=i.default.createHash(`md5`).update(t).digest(`hex`);this.index.set(e,a),this.memoryCache.set(e,t);let o=n.default.resolve(this.shardsDir,`${a}.gz`);m.add(async()=>{try{try{await r.default.access(o);return}catch{}await u(this.shardsDir,{recursive:!0});let e=await f(new Uint8Array(Buffer.from(t))),n=`${o}.${i.default.randomBytes(4).toString(`hex`)}.tmp`;await c(n,new Uint8Array(e)),await d(n,o)}catch{}}),this.saveTimeout&&clearTimeout(this.saveTimeout),this.saveTimeout=setTimeout(()=>{this.save()},500),typeof this.saveTimeout.unref==`function`&&this.saveTimeout.unref()}get size(){return this.index.size}async flush(){await m.flush()}};async function _(){await m.flush()}exports.FileCache=h,exports.TransformCache=g,exports.flushCache=_,exports.globalBackgroundQueue=m;

package/dist/node/cache.d.cts

@@ -0,0 +1,84 @@
+
+//#region src/node/cache.d.ts
+/**
+ * Simple background task queue to prevent blocking the main thread during IO.
+ */
+declare class BackgroundQueue {
+  private activeTasks;
+  add(task: () => Promise<void>): void;
+  flush(): Promise<void>;
+  get pending(): number;
+}
+declare const globalBackgroundQueue: BackgroundQueue;
+/**
+ * Generic file-based cache with per-file granularity and asynchronous persistence.
+ */
+declare class FileCache<T> {
+  private entries;
+  private readonly cachePath;
+  private readonly compress;
+  private loaded;
+  constructor(options?: {
+    name?: string;
+    root?: string;
+    compress?: boolean;
+  });
+  /**
+   * Loads the cache.
+   */
+  load(): Promise<void>;
+  /**
+   * Saves the cache in the background.
+   */
+  save(): void;
+  get(filePath: string): T | null;
+  getStale(filePath: string): T | null;
+  set(filePath: string, data: T): void;
+  isValid(filePath: string): boolean;
+  invalidate(filePath: string): void;
+  invalidateAll(): void;
+  pruneStale(currentFiles: Set<string>): void;
+  get size(): number;
+  flush(): Promise<void>;
+}
+/**
+ * Sharded Cache: Optimized for large-scale data (like MDX transformations).
+ * Uses a memory index and individual files for each entry to avoid massive JSON parsing.
+ */
+declare class TransformCache {
+  private index;
+  private memoryCache;
+  private readonly baseDir;
+  private readonly shardsDir;
+  private readonly indexPath;
+  private saveTimeout;
+  constructor(name: string, root?: string);
+  /**
+   * Loads the index into memory.
+   */
+  load(): Promise<void>;
+  /**
+   * Persists the index in background.
+   */
+  save(): void;
+  /**
+   * Batch Read: Retrieves multiple transformation results concurrently.
+   */
+  getMany(keys: string[]): Promise<Map<string, string>>;
+  /**
+   * Retrieves a cached transformation asynchronously. Fast lookup via index, lazy loading from disk.
+   */
+  getAsync(key: string): Promise<string | null>;
+  /**
+   * Stores a transformation result.
+   */
+  set(key: string, result: string): void;
+  get size(): number;
+  flush(): Promise<void>;
+}
+/**
+ * Flushes all pending background cache operations.
+ */
+declare function flushCache(): Promise<void>;
+//#endregion
+export { FileCache, TransformCache, flushCache, globalBackgroundQueue };