boltdocs 3.1.0 → 3.2.2

package/dist/{mdx-Bv-pS6-O.js → mdx-BuO6a1f7.js}

@@ -3,10 +3,10 @@
  * Copyright (c) 2026 Jesus Alcala
  * Licensed under the MIT License.
  */
-import { D as Check, H as Info, M as Copy, R as File, T as AlertTriangle, W as Lightbulb, _ as Link, a as Csv, c as JavaScript, d as React$1, f as Rust, g as Yaml, i as Css, l as Json, m as TypeScript, n as BracketsOrange, p as Shell, r as BracketsRed, rt as useConfig, u as Markdown, w as AlertCircle, y as cn } from "./icons-dev-CHZOwhQA.js";
-import { a as CodeBlockGroup, i as CodeBlockContent, l as useTheme, n as Tooltip, o as CodeBlockHeader, r as CodeBlock$1, s as Heading$1, t as Image$1 } from "./image-5WsgWYTh.js";
+import { B as useConfig, D as Lightbulb, T as Info, c as AlertCircle, d as Check, g as Copy, l as AlertTriangle, r as cn, t as Link } from "./link-2PzgTnaP.js";
+import { a as CodeBlockGroup, i as CodeBlockContent, l as useTheme, n as Tooltip, o as CodeBlockHeader, r as CodeBlock$1, s as Heading$1, t as Image$1 } from "./image-Bz87fCla.js";
 import { useCallback, useEffect, useRef, useState } from "react";
-import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+import { jsx, jsxs } from "react/jsx-runtime";
 import { Button } from "react-aria-components";
 
 //#region src/client/components/mdx/field.tsx
@@ -212,7 +212,7 @@ function Callout({ children, className = "", variant = "note", title, ...props }
 		...props,
 		children: [/* @__PURE__ */ jsx("div", {
 			className: cn("shrink-0 pt-0.5", styles.iconColor),
-			children: /* @__PURE__ */ jsx(Icon, { className: "w-5 h-5 stroke-[2]" })
+			children: /* @__PURE__ */ jsx(Icon, { className: "w-5 h-5 stroke-2" })
 		}), /* @__PURE__ */ jsxs("div", {
 			className: "flex-1 text-[0.875rem] leading-[1.6]",
 			children: [/* @__PURE__ */ jsx("div", {
@@ -252,32 +252,13 @@ const copyToClipboard = async (text) => {
 
 //#endregion
 //#region src/client/components/mdx/use-code-block.ts
-const langIconMap = {
-	ts: TypeScript,
-	tsx: React$1,
-	js: JavaScript,
-	jsx: React$1,
-	json: Json,
-	css: Css,
-	html: BracketsOrange,
-	md: Markdown,
-	mdx: Markdown,
-	bash: Shell,
-	sh: Shell,
-	yaml: Yaml,
-	yml: Yaml,
-	rs: Rust,
-	rust: Rust,
-	toml: BracketsRed,
-	csv: Csv
-};
 function useCodeBlock(props) {
 	const [copied, setCopied] = useState(false);
 	const [isExpanded, setIsExpanded] = useState(false);
 	const [isExpandable, setIsExpandable] = useState(false);
+	const [rated, setRated] = useState(null);
 	const preRef = useRef(null);
 	const timerRef = useRef(null);
-	const [rated, setRated] = useState(null);
 	const customConfig = useConfig().integrations?.feedback?.custom;
 	const showCodeBlockFeedback = !!(customConfig?.enabled && !props.plain);
 	const lang = props.lang || props["data-lang"] || "";
@@ -330,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] || File;
 	return {
 		copied,
 		isExpanded,
@@ -345,8 +325,7 @@ function useCodeBlock(props) {
 		lang,
 		showCodeBlockFeedback,
 		rated,
-		handleRate,
-		LangIcon
+		handleRate
 	};
 }
 
@@ -369,8 +348,8 @@ const CodeBlockFeedback = ({ rated, onRate }) => {
 		children: [/* @__PURE__ */ jsx(Tooltip, {
 			content: rated === "up" ? "Helpful!" : "This code is helpful",
 			children: /* @__PURE__ */ jsx(Button, {
-				onPress: () => onRate("up"),
-				disabled: rated !== null,
+				onPress: (() => onRate("up")),
+				isDisabled: rated !== null,
 				className: 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__ */ jsx("svg", {
@@ -387,8 +366,8 @@ const CodeBlockFeedback = ({ rated, onRate }) => {
 		}), /* @__PURE__ */ jsx(Tooltip, {
 			content: rated === "down" ? "Unhelpful" : "This code is unhelpful",
 			children: /* @__PURE__ */ jsx(Button, {
-				onPress: () => onRate("down"),
-				disabled: rated !== null,
+				onPress: (() => onRate("down")),
+				isDisabled: rated !== null,
 				className: 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__ */ jsx("svg", {
@@ -408,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__ */ jsxs(CodeBlock$1, {
 		plain,
 		className: props.className,
 		children: [(effectiveTitle || !hideCopy) && /* @__PURE__ */ jsxs(CodeBlockHeader, {
 			className: cn({ "absolute top-2 left-0 w-full": !effectiveTitle }),
-			children: [/* @__PURE__ */ jsx(CodeBlockGroup, { children: effectiveTitle && /* @__PURE__ */ jsxs(Fragment, { children: [LangIcon ? /* @__PURE__ */ jsx(LangIcon, { size: 14 }) : /* @__PURE__ */ jsx(File, {
-				size: 14,
-				className: "opacity-60"
-			}), /* @__PURE__ */ jsx("span", { children: effectiveTitle })] }) }), /* @__PURE__ */ jsxs("div", {
-				className: "flex items-center gap-1",
+			children: [/* @__PURE__ */ jsx(CodeBlockGroup, { children: effectiveTitle && /* @__PURE__ */ jsx("span", { children: effectiveTitle }) }), /* @__PURE__ */ jsxs("div", {
+				className: "flex items-center gap-1 bg-(--color-code-bg) pl-2 z-10",
 				children: [showCodeBlockFeedback && /* @__PURE__ */ jsx(CodeBlockFeedback, {
 					rated,
 					onRate: handleRate
@@ -526,7 +502,7 @@ function Card({ className, title, icon, href, children, ...props }) {
 			/* @__PURE__ */ jsxs("div", {
 				className: "relative z-10 flex items-center gap-3",
 				children: [icon && /* @__PURE__ */ jsx("div", {
-					className: 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: 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__ */ jsx("h3", {
 					className: "font-semibold text-base m-0 leading-none text-body",
@@ -580,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: Check,
+	info: Info,
+	warning: AlertTriangle,
+	danger: AlertCircle
+};
+function TimelineRoot({ children, className, compact = false, ...props }) {
+	return /* @__PURE__ */ jsxs("ol", {
+		role: "list",
+		className: cn("relative my-8 ms-3", compact ? "space-y-3" : "space-y-7", className),
+		...props,
+		children: [/* @__PURE__ */ 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__ */ jsx(FallbackIcon, {
+		size: 12,
+		className: "text-white",
+		"aria-hidden": "true"
+	}) : /* @__PURE__ */ jsx("span", {
+		"aria-hidden": "true",
+		className: 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__ */ jsxs("li", {
+		className: cn("relative ps-8", className),
+		...props,
+		children: [
+			/* @__PURE__ */ jsx("span", {
+				...a11yProps,
+				className: 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__ */ jsxs("div", {
+				className: "flex items-center gap-2 flex-wrap mb-1",
+				children: [formatted && /* @__PURE__ */ 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__ */ jsx("span", {
+					className: 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__ */ jsx("h3", {
+				className: "text-base font-semibold text-body m-0 leading-snug",
+				children: title
+			}),
+			children && /* @__PURE__ */ 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 = {
@@ -591,8 +745,9 @@ const mdx_components_default = {
 	Field,
 	Callout,
 	Card,
-	Cards
+	Cards,
+	Timeline
 };
 
 //#endregion
-export { useCodeBlock as n, copyToClipboard as r, mdx_components_default as t };
+export { copyToClipboard as i, Timeline as n, useCodeBlock as r, mdx_components_default as t };