boltdocs 3.2.1 → 3.3.0

package/dist/link-CgdI6O2o.js

@@ -0,0 +1,872 @@
+/**
+ * Boltdocs - https://boltdocs.vercel.app
+ * Copyright (c) 2026 Jesus Alcala
+ * Licensed under the MIT License.
+ */
+import { E as useLocation, O as useNavigate, c as hasUriScheme, h as resolveUrlReference, k as usePrefetch, l as hasUrlBase, m as parseUrlReference } from "./router-CZBxMRAH.js";
+import { createContext, use, useCallback, useEffect, useMemo, useState } from "react";
+import { Fragment as Fragment$1, jsx, jsxs } from "react/jsx-runtime";
+import { clsx } from "clsx";
+import { twMerge } from "tailwind-merge";
+
+//#region \0rolldown/runtime.js
+var __defProp = Object.defineProperty;
+var __exportAll = (all, no_symbols) => {
+	let target = {};
+	for (var name in all) {
+		__defProp(target, name, {
+			get: all[name],
+			enumerable: true
+		});
+	}
+	if (!no_symbols) {
+		__defProp(target, Symbol.toStringTag, { value: "Module" });
+	}
+	return target;
+};
+
+//#endregion
+//#region src/client/store/boltdocs-context.tsx
+const PREFERENCES_KEY = "boltdocs-user-preferences";
+const BOLTDOCS_CONTEXT_SYMBOL = Symbol.for("__BDOCS_BOLTDOCS_CONTEXT__");
+const BOLTDOCS_INSTANCE_SYMBOL = Symbol.for("__BDOCS_BOLTDOCS_INSTANCE__");
+function getSavedPrefs() {
+	if (typeof window === "undefined") return {};
+	try {
+		const raw = window.localStorage.getItem(PREFERENCES_KEY);
+		return raw ? JSON.parse(raw) : {};
+	} catch {
+		return {};
+	}
+}
+const globalRegistry$1 = globalThis;
+const existingContext = globalRegistry$1[BOLTDOCS_CONTEXT_SYMBOL];
+const BoltdocsContext = existingContext || createContext(void 0);
+if (!existingContext) Reflect.set(globalRegistry$1, BOLTDOCS_CONTEXT_SYMBOL, BoltdocsContext);
+function BoltdocsProvider({ children, initialLocale = "", initialVersion = "" }) {
+	const [locale, setLocaleState] = useState(() => {
+		if (initialLocale) return initialLocale;
+		return getSavedPrefs().locale || "";
+	});
+	const [version, setVersionState] = useState(() => {
+		if (initialVersion) return initialVersion;
+		return getSavedPrefs().version || "";
+	});
+	const [hasHydrated, setHasHydrated] = useState(() => {
+		return typeof window !== "undefined";
+	});
+	useEffect(() => {
+		setHasHydrated(true);
+	}, []);
+	const updateLocale = useCallback((l) => {
+		const newL = l || "";
+		setLocaleState((current) => {
+			if (current === newL) return current;
+			return newL;
+		});
+		if (typeof globalThis !== "undefined") Reflect.set(globalThis, BOLTDOCS_INSTANCE_SYMBOL, {
+			...globalThis[BOLTDOCS_INSTANCE_SYMBOL],
+			currentLocale: newL
+		});
+		if (typeof window !== "undefined") try {
+			const prefs = getSavedPrefs();
+			if (prefs.locale !== newL) window.localStorage.setItem(PREFERENCES_KEY, JSON.stringify({
+				...prefs,
+				locale: newL
+			}));
+		} catch {}
+	}, []);
+	const updateVersion = useCallback((v) => {
+		const newV = v || "";
+		setVersionState((current) => {
+			if (current === newV) return current;
+			return newV;
+		});
+		if (typeof globalThis !== "undefined") Reflect.set(globalThis, BOLTDOCS_INSTANCE_SYMBOL, {
+			...globalThis[BOLTDOCS_INSTANCE_SYMBOL],
+			currentVersion: newV
+		});
+		if (typeof window !== "undefined") try {
+			const prefs = getSavedPrefs();
+			if (prefs.version !== newV) window.localStorage.setItem(PREFERENCES_KEY, JSON.stringify({
+				...prefs,
+				version: newV
+			}));
+		} catch {}
+	}, []);
+	const value = useMemo(() => ({
+		currentLocale: locale,
+		currentVersion: version,
+		setLocale: updateLocale,
+		setVersion: updateVersion,
+		hasHydrated,
+		setHasHydrated
+	}), [
+		locale,
+		version,
+		hasHydrated,
+		updateLocale,
+		updateVersion
+	]);
+	if (typeof globalThis !== "undefined") Reflect.set(globalThis, BOLTDOCS_INSTANCE_SYMBOL, value);
+	return /* @__PURE__ */ jsx(BoltdocsContext.Provider, {
+		value,
+		children
+	});
+}
+function useBoltdocsContext() {
+	const context = use(BoltdocsContext);
+	const globalInstance = typeof globalThis !== "undefined" ? globalThis[BOLTDOCS_INSTANCE_SYMBOL] : void 0;
+	if (!context && globalInstance) return globalInstance;
+	if (!context) throw new Error("useBoltdocsContext must be used within a BoltdocsProvider");
+	return context;
+}
+
+//#endregion
+//#region src/client/app/config-context.tsx
+/**
+* Context for the global documentation configuration.
+* Using a global singleton pattern to survive dual-package or duplicated-code hazards.
+*/
+const CONFIG_CONTEXT_SYMBOL = Symbol.for("__BDOCS_CONFIG_CONTEXT__");
+const CONFIG_INSTANCE_SYMBOL = Symbol.for("__BDOCS_CONFIG_INSTANCE__");
+const globalRegistry = globalThis;
+const existingConfigContext = globalRegistry[CONFIG_CONTEXT_SYMBOL];
+const ConfigContext = existingConfigContext || createContext(null);
+if (!existingConfigContext) globalRegistry[CONFIG_CONTEXT_SYMBOL] = ConfigContext;
+/**
+* Hook to access the Boltdocs configuration when one is available.
+*
+* Low-level primitives such as icons can also be rendered standalone (for
+* example in a component preview or a unit test), so they must not be forced
+* to mount the full application provider just to render an inline SVG.
+*/
+function useOptionalConfig() {
+	const context = use(ConfigContext);
+	if (context) return context;
+	const globalConfig = globalRegistry[CONFIG_INSTANCE_SYMBOL];
+	if (globalConfig) return globalConfig;
+	return null;
+}
+/**
+* Hook to access the Boltdocs configuration.
+*/
+function useConfig() {
+	const config = useOptionalConfig();
+	if (!config) throw new Error("useConfig must be used within a ConfigProvider");
+	return config;
+}
+
+//#endregion
+//#region src/client/components/ui-base/icons.tsx
+var icons_exports = /* @__PURE__ */ __exportAll({
+	AlertCircle: () => AlertCircle,
+	AlertTriangle: () => AlertTriangle,
+	ArrowLeft: () => ArrowLeft,
+	BookOpen: () => BookOpen,
+	Check: () => Check,
+	ChevronDown: () => ChevronDown,
+	ChevronLeft: () => ChevronLeft,
+	ChevronRight: () => ChevronRight,
+	CircleHelp: () => CircleHelp,
+	Code2: () => Code2,
+	Copy: () => Copy,
+	CornerDownLeft: () => CornerDownLeft,
+	ExternalLink: () => ExternalLink,
+	FaceBad: () => FaceBad,
+	FaceGood: () => FaceGood,
+	FaceRegular: () => FaceRegular,
+	File: () => File,
+	FileCode2: () => FileCode2,
+	FileText: () => FileText,
+	FlaskConical: () => FlaskConical,
+	Gauge: () => Gauge,
+	Hash: () => Hash,
+	Home: () => Home,
+	Info: () => Info,
+	Languages: () => Languages,
+	LifeBuoy: () => LifeBuoy,
+	Lightbulb: () => Lightbulb,
+	Link: () => Link$1,
+	Menu: () => Menu,
+	Monitor: () => Monitor,
+	Moon: () => Moon,
+	MoreVertical: () => MoreVertical,
+	Paintbrush: () => Paintbrush,
+	Pencil: () => Pencil,
+	Rocket: () => Rocket,
+	Search: () => Search,
+	Sun: () => Sun,
+	TextAlignStart: () => TextAlignStart,
+	X: () => X
+});
+function createIcon(displayName, paths, viewBox = "0 0 24 24") {
+	const Component = ({ size = 24, className, ...props }) => {
+		return /* @__PURE__ */ jsxs("svg", {
+			xmlns: "http://www.w3.org/2000/svg",
+			width: size,
+			height: size,
+			viewBox,
+			fill: "none",
+			stroke: "currentColor",
+			strokeWidth: "2",
+			strokeLinecap: "round",
+			strokeLinejoin: "round",
+			className,
+			...props,
+			children: [/* @__PURE__ */ jsx("title", { children: displayName }), paths]
+		});
+	};
+	Component.displayName = displayName;
+	return Component;
+}
+const Info = createIcon("Info", /* @__PURE__ */ jsxs(Fragment$1, { children: [
+	/* @__PURE__ */ jsx("circle", {
+		cx: "12",
+		cy: "12",
+		r: "10"
+	}),
+	/* @__PURE__ */ jsx("path", { d: "M12 16v-4" }),
+	/* @__PURE__ */ jsx("path", { d: "M12 8h.01" })
+] }));
+const Lightbulb = createIcon("Lightbulb", /* @__PURE__ */ jsxs(Fragment$1, { children: [
+	/* @__PURE__ */ jsx("path", { d: "M15 14c.2-1 .7-1.7 1.5-2.5 1-.9 1.5-2.2 1.5-3.5A5 5 0 0 0 8 8c0 1 .3 2.2 1.5 3.5.7.7 1.3 1.5 1.5 2.5" }),
+	/* @__PURE__ */ jsx("path", { d: "M9 18h6" }),
+	/* @__PURE__ */ jsx("path", { d: "M10 22h4" })
+] }));
+const BookOpen = createIcon("BookOpen", /* @__PURE__ */ jsxs(Fragment$1, { children: [
+	/* @__PURE__ */ jsx("path", { d: "M2 4v16a2 2 0 0 0 2 2h16" }),
+	/* @__PURE__ */ jsx("path", { d: "M22 18V4a2 2 0 0 0-2-2H6a4 4 0 0 0-4 4" }),
+	/* @__PURE__ */ jsx("path", { d: "M6 2v16" }),
+	/* @__PURE__ */ jsx("path", { d: "M6 18h16" })
+] }));
+const Rocket = createIcon("Rocket", /* @__PURE__ */ jsxs(Fragment$1, { children: [
+	/* @__PURE__ */ jsx("path", { d: "M4.5 16.5c-1.5 1.5-2 4-2 4s2.5-.5 4-2c.7-.7.7-1.8 0-2.5s-1.3-.2-2 0Z" }),
+	/* @__PURE__ */ jsx("path", { d: "m12 15-3-3a22 22 0 0 1 3-5c2-2.5 5-4 9-4 0 4-1.5 7-4 9a22 22 0 0 1-5 3Z" }),
+	/* @__PURE__ */ jsx("path", { d: "M9 12H4l-2 2 5 1" }),
+	/* @__PURE__ */ jsx("path", { d: "M12 15v5l2-2 1-5" }),
+	/* @__PURE__ */ jsx("circle", {
+		cx: "16",
+		cy: "8",
+		r: "1"
+	})
+] }));
+const Code2 = createIcon("Code2", /* @__PURE__ */ jsxs(Fragment$1, { children: [
+	/* @__PURE__ */ jsx("path", { d: "m18 16 4-4-4-4" }),
+	/* @__PURE__ */ jsx("path", { d: "m6 8-4 4 4 4" }),
+	/* @__PURE__ */ jsx("path", { d: "m14.5 4-5 16" })
+] }));
+const FlaskConical = createIcon("FlaskConical", /* @__PURE__ */ jsxs(Fragment$1, { children: [
+	/* @__PURE__ */ jsx("path", { d: "M9 3h6" }),
+	/* @__PURE__ */ jsx("path", { d: "M10 3v7.5L4.5 19a2 2 0 0 0 1.7 3h11.6a2 2 0 0 0 1.7-3L14 10.5V3" }),
+	/* @__PURE__ */ jsx("path", { d: "M7 16h10" })
+] }));
+const FileCode2 = createIcon("FileCode2", /* @__PURE__ */ jsxs(Fragment$1, { children: [
+	/* @__PURE__ */ jsx("path", { d: "M14 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V8Z" }),
+	/* @__PURE__ */ jsx("path", { d: "M14 2v6h6" }),
+	/* @__PURE__ */ jsx("path", { d: "m10 13-2 2 2 2" }),
+	/* @__PURE__ */ jsx("path", { d: "m14 13 2 2-2 2" })
+] }));
+const Paintbrush = createIcon("Paintbrush", /* @__PURE__ */ jsxs(Fragment$1, { children: [/* @__PURE__ */ jsx("path", { d: "m14 6 4 4" }), /* @__PURE__ */ jsx("path", { d: "M3 21c3 0 5-1 6-4l8-8a2.8 2.8 0 1 0-4-4l-8 8c-3 1-4 4-2 8Z" })] }));
+const Gauge = createIcon("Gauge", /* @__PURE__ */ jsxs(Fragment$1, { children: [
+	/* @__PURE__ */ jsx("path", { d: "m12 14 4-4" }),
+	/* @__PURE__ */ jsx("path", { d: "M3.3 17a9 9 0 1 1 17.4 0" }),
+	/* @__PURE__ */ jsx("path", { d: "M5 19h14" })
+] }));
+const LifeBuoy = createIcon("LifeBuoy", /* @__PURE__ */ jsxs(Fragment$1, { children: [
+	/* @__PURE__ */ jsx("circle", {
+		cx: "12",
+		cy: "12",
+		r: "10"
+	}),
+	/* @__PURE__ */ jsx("circle", {
+		cx: "12",
+		cy: "12",
+		r: "4"
+	}),
+	/* @__PURE__ */ jsx("path", { d: "m4.9 4.9 4.3 4.3M14.8 14.8l4.3 4.3M19.1 4.9l-4.3 4.3M9.2 14.8l-4.3 4.3" })
+] }));
+const AlertTriangle = createIcon("AlertTriangle", /* @__PURE__ */ jsxs(Fragment$1, { children: [
+	/* @__PURE__ */ jsx("path", { d: "m21.73 18-8-14a2 2 0 0 0-3.48 0l-8 14A2 2 0 0 0 4 21h16a2 2 0 0 0 1.73-3Z" }),
+	/* @__PURE__ */ jsx("line", {
+		x1: "12",
+		y1: "9",
+		x2: "12",
+		y2: "13"
+	}),
+	/* @__PURE__ */ jsx("line", {
+		x1: "12",
+		y1: "17",
+		x2: "12.01",
+		y2: "17"
+	})
+] }));
+const AlertCircle = createIcon("AlertCircle", /* @__PURE__ */ jsxs(Fragment$1, { children: [
+	/* @__PURE__ */ jsx("circle", {
+		cx: "12",
+		cy: "12",
+		r: "10"
+	}),
+	/* @__PURE__ */ jsx("line", {
+		x1: "12",
+		y1: "8",
+		x2: "12",
+		y2: "12"
+	}),
+	/* @__PURE__ */ jsx("line", {
+		x1: "12",
+		y1: "16",
+		x2: "12.01",
+		y2: "16"
+	})
+] }));
+const Copy = createIcon("Copy", /* @__PURE__ */ jsxs(Fragment$1, { children: [/* @__PURE__ */ jsx("rect", {
+	width: "14",
+	height: "14",
+	x: "8",
+	y: "8",
+	rx: "2",
+	ry: "2"
+}), /* @__PURE__ */ jsx("path", { d: "M4 16c-1.1 0-2-.9-2-2V4c0-1.1.9-2 2-2h10c1.1 0 2 .9 2 2" })] }));
+const Check = createIcon("Check", /* @__PURE__ */ jsx("path", { d: "M20 6 9 17l-5-5" }));
+const File = createIcon("File", /* @__PURE__ */ jsxs(Fragment$1, { children: [/* @__PURE__ */ jsx("path", { d: "M15 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V7Z" }), /* @__PURE__ */ jsx("path", { d: "M14 2v4a2 2 0 0 0 2 2h4" })] }));
+const ArrowLeft = createIcon("ArrowLeft", /* @__PURE__ */ jsxs(Fragment$1, { children: [/* @__PURE__ */ jsx("path", { d: "m12 19-7-7 7-7" }), /* @__PURE__ */ jsx("path", { d: "M19 12H5" })] }));
+const Pencil = createIcon("Pencil", /* @__PURE__ */ jsxs(Fragment$1, { children: [/* @__PURE__ */ jsx("path", { d: "M12 20h9" }), /* @__PURE__ */ jsx("path", { d: "M16.5 3.5a2.12 2.12 0 0 1 3 3L7 19l-4 1 1-4Z" })] }));
+const CircleHelp = createIcon("CircleHelp", /* @__PURE__ */ jsxs(Fragment$1, { children: [
+	/* @__PURE__ */ jsx("circle", {
+		cx: "12",
+		cy: "12",
+		r: "10"
+	}),
+	/* @__PURE__ */ jsx("path", { d: "M9.09 9a3 3 0 0 1 5.83 1c0 2-3 3-3 3" }),
+	/* @__PURE__ */ jsx("path", { d: "M12 17h.01" })
+] }));
+const TextAlignStart = createIcon("TextAlignStart", /* @__PURE__ */ jsxs(Fragment$1, { children: [
+	/* @__PURE__ */ jsx("line", {
+		x1: "21",
+		x2: "3",
+		y1: "6",
+		y2: "6"
+	}),
+	/* @__PURE__ */ jsx("line", {
+		x1: "15",
+		x2: "3",
+		y1: "12",
+		y2: "12"
+	}),
+	/* @__PURE__ */ jsx("line", {
+		x1: "17",
+		x2: "3",
+		y1: "18",
+		y2: "18"
+	})
+] }));
+const ExternalLink = createIcon("ExternalLink", /* @__PURE__ */ jsxs(Fragment$1, { children: [
+	/* @__PURE__ */ jsx("path", { d: "M18 13v6a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2V8a2 2 0 0 1 2-2h6" }),
+	/* @__PURE__ */ jsx("polyline", { points: "15 3 21 3 21 9" }),
+	/* @__PURE__ */ jsx("line", {
+		x1: "10",
+		y1: "14",
+		x2: "21",
+		y2: "3"
+	})
+] }));
+const ChevronDown = createIcon("ChevronDown", /* @__PURE__ */ jsx("path", { d: "m6 9 6 6 6-6" }));
+const Home = createIcon("Home", /* @__PURE__ */ jsxs(Fragment$1, { children: [/* @__PURE__ */ jsx("path", { d: "m3 9 9-7 9 7v11a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2z" }), /* @__PURE__ */ jsx("polyline", { points: "9 22 9 12 15 12 15 22" })] }));
+const Search = createIcon("Search", /* @__PURE__ */ jsxs(Fragment$1, { children: [/* @__PURE__ */ jsx("circle", {
+	cx: "11",
+	cy: "11",
+	r: "8"
+}), /* @__PURE__ */ jsx("path", { d: "m21 21-4.3-4.3" })] }));
+const Sun = createIcon("Sun", /* @__PURE__ */ jsxs(Fragment$1, { children: [
+	/* @__PURE__ */ jsx("circle", {
+		cx: "12",
+		cy: "12",
+		r: "4"
+	}),
+	/* @__PURE__ */ jsx("path", { d: "M12 2v2" }),
+	/* @__PURE__ */ jsx("path", { d: "M12 20v2" }),
+	/* @__PURE__ */ jsx("path", { d: "m4.93 4.93 1.41 1.41" }),
+	/* @__PURE__ */ jsx("path", { d: "m17.66 17.66 1.41 1.41" }),
+	/* @__PURE__ */ jsx("path", { d: "M2 12h2" }),
+	/* @__PURE__ */ jsx("path", { d: "M20 12h2" }),
+	/* @__PURE__ */ jsx("path", { d: "m6.34 17.66-1.41 1.41" }),
+	/* @__PURE__ */ jsx("path", { d: "m19.07 4.93-1.41 1.41" })
+] }));
+const Moon = createIcon("Moon", /* @__PURE__ */ jsx("path", { d: "M12 3a6 6 0 0 0 9 9 9 9 0 1 1-9-9Z" }));
+const Monitor = createIcon("Monitor", /* @__PURE__ */ jsxs(Fragment$1, { children: [
+	/* @__PURE__ */ jsx("rect", {
+		width: "20",
+		height: "14",
+		x: "2",
+		y: "3",
+		rx: "2"
+	}),
+	/* @__PURE__ */ jsx("line", {
+		x1: "8",
+		x2: "16",
+		y1: "21",
+		y2: "21"
+	}),
+	/* @__PURE__ */ jsx("line", {
+		x1: "12",
+		x2: "12",
+		y1: "17",
+		y2: "21"
+	})
+] }));
+const Languages = createIcon("Languages", /* @__PURE__ */ jsxs(Fragment$1, { children: [
+	/* @__PURE__ */ jsx("path", { d: "m5 8 6 6" }),
+	/* @__PURE__ */ jsx("path", { d: "m4 14 6-6 2-3" }),
+	/* @__PURE__ */ jsx("path", { d: "M2 5h12" }),
+	/* @__PURE__ */ jsx("path", { d: "M7 2h1" }),
+	/* @__PURE__ */ jsx("path", { d: "m22 22-5-10-5 10" }),
+	/* @__PURE__ */ jsx("path", { d: "M14 18h6" })
+] }));
+const Menu = createIcon("Menu", /* @__PURE__ */ jsxs(Fragment$1, { children: [
+	/* @__PURE__ */ jsx("line", {
+		x1: "4",
+		x2: "20",
+		y1: "12",
+		y2: "12"
+	}),
+	/* @__PURE__ */ jsx("line", {
+		x1: "4",
+		x2: "20",
+		y1: "6",
+		y2: "6"
+	}),
+	/* @__PURE__ */ jsx("line", {
+		x1: "4",
+		x2: "20",
+		y1: "18",
+		y2: "18"
+	})
+] }));
+const X = createIcon("X", /* @__PURE__ */ jsxs(Fragment$1, { children: [/* @__PURE__ */ jsx("path", { d: "M18 6 6 18" }), /* @__PURE__ */ jsx("path", { d: "m6 6 12 12" })] }));
+const Link$1 = createIcon("Link", /* @__PURE__ */ jsxs(Fragment$1, { children: [/* @__PURE__ */ jsx("path", { d: "M10 13a5 5 0 0 0 7.54.54l3-3a5 5 0 0 0-7.07-7.07l-1.72 1.71" }), /* @__PURE__ */ jsx("path", { d: "M14 11a5 5 0 0 0-7.54-.54l-3 3a5 5 0 0 0 7.07 7.07l1.71-1.71" })] }));
+const ChevronRight = createIcon("ChevronRight", /* @__PURE__ */ jsx("path", { d: "m9 18 6-6-6-6" }));
+const MoreVertical = createIcon("MoreVertical", /* @__PURE__ */ jsxs(Fragment$1, { children: [
+	/* @__PURE__ */ jsx("circle", {
+		cx: "12",
+		cy: "12",
+		r: "1"
+	}),
+	/* @__PURE__ */ jsx("circle", {
+		cx: "12",
+		cy: "5",
+		r: "1"
+	}),
+	/* @__PURE__ */ jsx("circle", {
+		cx: "12",
+		cy: "19",
+		r: "1"
+	})
+] }));
+const ChevronLeft = createIcon("ChevronLeft", /* @__PURE__ */ jsx("path", { d: "m15 18-6-6 6-6" }));
+const Hash = createIcon("Hash", /* @__PURE__ */ jsxs(Fragment$1, { children: [
+	/* @__PURE__ */ jsx("line", {
+		x1: "4",
+		x2: "20",
+		y1: "9",
+		y2: "9"
+	}),
+	/* @__PURE__ */ jsx("line", {
+		x1: "4",
+		x2: "20",
+		y1: "15",
+		y2: "15"
+	}),
+	/* @__PURE__ */ jsx("line", {
+		x1: "10",
+		x2: "8",
+		y1: "3",
+		y2: "21"
+	}),
+	/* @__PURE__ */ jsx("line", {
+		x1: "16",
+		x2: "14",
+		y1: "3",
+		y2: "21"
+	})
+] }));
+const FileText = createIcon("FileText", /* @__PURE__ */ jsxs(Fragment$1, { children: [
+	/* @__PURE__ */ jsx("path", { d: "M15 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V7Z" }),
+	/* @__PURE__ */ jsx("path", { d: "M14 2v4a2 2 0 0 0 2 2h4" }),
+	/* @__PURE__ */ jsx("path", { d: "M10 9H8" }),
+	/* @__PURE__ */ jsx("path", { d: "M16 13H8" }),
+	/* @__PURE__ */ jsx("path", { d: "M16 17H8" })
+] }));
+const CornerDownLeft = createIcon("CornerDownLeft", /* @__PURE__ */ jsxs(Fragment$1, { children: [/* @__PURE__ */ jsx("polyline", { points: "9 10 4 15 9 20" }), /* @__PURE__ */ jsx("path", { d: "M20 4v7a4 4 0 0 1-4 4H4" })] }));
+const FaceGood = createIcon("FaceGood", /* @__PURE__ */ jsxs(Fragment$1, { children: [
+	/* @__PURE__ */ jsx("circle", {
+		cx: "12",
+		cy: "12",
+		r: "10"
+	}),
+	/* @__PURE__ */ jsx("path", { d: "M8 14s1.5 2 4 2 4-2 4-2" }),
+	/* @__PURE__ */ jsx("line", {
+		x1: "9",
+		y1: "9",
+		x2: "9.01",
+		y2: "9"
+	}),
+	/* @__PURE__ */ jsx("line", {
+		x1: "15",
+		y1: "9",
+		x2: "15.01",
+		y2: "9"
+	})
+] }));
+const FaceRegular = createIcon("FaceRegular", /* @__PURE__ */ jsxs(Fragment$1, { children: [
+	/* @__PURE__ */ jsx("circle", {
+		cx: "12",
+		cy: "12",
+		r: "10"
+	}),
+	/* @__PURE__ */ jsx("line", {
+		x1: "8",
+		y1: "15",
+		x2: "16",
+		y2: "15"
+	}),
+	/* @__PURE__ */ jsx("line", {
+		x1: "9",
+		y1: "9",
+		x2: "9.01",
+		y2: "9"
+	}),
+	/* @__PURE__ */ jsx("line", {
+		x1: "15",
+		y1: "9",
+		x2: "15.01",
+		y2: "9"
+	})
+] }));
+const FaceBad = createIcon("FaceBad", /* @__PURE__ */ jsxs(Fragment$1, { children: [
+	/* @__PURE__ */ jsx("circle", {
+		cx: "12",
+		cy: "12",
+		r: "10"
+	}),
+	/* @__PURE__ */ jsx("path", { d: "M16 16s-1.5-2-4-2-4 2-4 2" }),
+	/* @__PURE__ */ jsx("line", {
+		x1: "9",
+		y1: "9",
+		x2: "9.01",
+		y2: "9"
+	}),
+	/* @__PURE__ */ jsx("line", {
+		x1: "15",
+		y1: "9",
+		x2: "15.01",
+		y2: "9"
+	})
+] }));
+
+//#endregion
+//#region src/client/utils/path.ts
+/**
+* Normalizes a URL path by stripping any trailing slash unless it's the root path.
+*
+* @param p - The path to normalize.
+* @returns The normalized path.
+*/
+function normalizePath(p) {
+	return p.endsWith("/") && p.length > 1 ? p.slice(0, -1) : p;
+}
+/**
+* Resolves a public asset URL under the configured Vite/base path.
+* Root-relative URLs are otherwise interpreted against the origin root, which
+* breaks sites deployed under a documentation base such as `/docs`.
+*/
+function resolvePublicAssetUrl(value, base) {
+	if (!value || !value.startsWith("/") || value.startsWith("//") || /^\/(?:https?:|data:)/i.test(value)) return value;
+	const normalizedBase = (base || "/").replace(/\/+$/, "");
+	if (!normalizedBase || normalizedBase === "/") return value;
+	if (value === normalizedBase || value.startsWith(`${normalizedBase}/`)) return value;
+	return `${normalizedBase}${value}`;
+}
+
+//#endregion
+//#region src/client/app/routes-context.tsx
+const RoutesContext = createContext({
+	routes: [],
+	index: {
+		byPath: /* @__PURE__ */ new Map(),
+		hintsByPath: /* @__PURE__ */ new Map(),
+		collectionNames: []
+	}
+});
+/**
+* Hook to access the processed routes list from the closest provider.
+*/
+function useRoutesContext() {
+	return use(RoutesContext);
+}
+/**
+* Provider component for the documentation routes.
+*/
+function RoutesProvider({ routes: initialRoutes, children }) {
+	const [routes, setRoutes] = useState(initialRoutes);
+	const index = useMemo(() => {
+		const byPath = /* @__PURE__ */ new Map();
+		const hintsByPath = /* @__PURE__ */ new Map();
+		const collectionNames = /* @__PURE__ */ new Set();
+		for (const route of routes) {
+			if (!route.path) continue;
+			const path = normalizePath(route.path);
+			byPath.set(path, route);
+			hintsByPath.set(path, {
+				path: route.path,
+				kind: route.collection ? "collection" : void 0,
+				collection: route.collection
+			});
+			if (route.collection) collectionNames.add(route.collection);
+		}
+		return {
+			byPath,
+			hintsByPath,
+			collectionNames: [...collectionNames]
+		};
+	}, [routes]);
+	useEffect(() => {
+		if (!import.meta.hot) return;
+		const handler = (payload) => {
+			setRoutes((prev) => {
+				const deleted = new Set(payload.routes.deleted);
+				const next = prev.filter((r) => !deleted.has(r.path));
+				for (const updated of payload.routes.updated) {
+					const idx = next.findIndex((r) => r.path === updated.path);
+					if (idx >= 0) next[idx] = updated;
+					else next.push(updated);
+				}
+				return [...next];
+			});
+		};
+		const hot = import.meta.hot;
+		hot.on("boltdocs:frontmatter-update", handler);
+		return () => hot.off?.("boltdocs:frontmatter-update", handler);
+	}, []);
+	return /* @__PURE__ */ jsx(RoutesContext.Provider, {
+		value: {
+			routes,
+			index
+		},
+		children
+	});
+}
+
+//#endregion
+//#region src/client/hooks/use-localized-to.ts
+function useLocalizedTo(to) {
+	const config = useConfig();
+	const routeContext = useRoutesContext();
+	const routeIndex = routeContext.index || {
+		byPath: new Map(routeContext.routes.map((route) => [route.path, route])),
+		hintsByPath: /* @__PURE__ */ new Map(),
+		collectionNames: []
+	};
+	const { currentLocale: activeLocale, currentVersion: activeVersion } = useBoltdocsContext();
+	const configuredVersion = (config.versions?.versions || []).some((version) => version.path === activeVersion) ? activeVersion : void 0;
+	const configuredLocale = (config.i18n ? Array.isArray(config.i18n.locales) ? config.i18n.locales : Object.keys(config.i18n.locales) : []).includes(activeLocale) ? activeLocale : void 0;
+	if (!config || typeof to !== "string") return to;
+	if (to.startsWith("http://") || to.startsWith("https://") || to.startsWith("//") || to.startsWith("#") || to.startsWith("?") || hasUriScheme(to.replace(/^site:/, ""))) return to.startsWith("site:") ? to.slice(5) || "/" : to;
+	const siteProtocol = to.startsWith("site:");
+	const siteValue = siteProtocol ? to.slice(5) || "/" : to;
+	const configCollections = config.collections;
+	const configuredCollectionNames = Array.isArray(configCollections) ? configCollections : Object.keys(configCollections?.labels || {});
+	const collectionNames = [...new Set([...routeIndex.collectionNames, ...configuredCollectionNames])];
+	const targetPath = siteValue.split(/[?#]/, 1)[0];
+	const normalizedTarget = targetPath.endsWith("/") && targetPath.length > 1 ? targetPath.slice(0, -1) : targetPath;
+	const knownRoute = routeIndex.hintsByPath.get(normalizedTarget);
+	const knownRouteMeta = routeIndex.byPath.get(normalizedTarget);
+	const knownRouteKind = knownRoute ? knownRoute.kind || (hasUrlBase(normalizedTarget, config.base) ? "doc" : "external") : void 0;
+	const routeHints = knownRoute ? [{
+		...knownRoute,
+		kind: knownRouteKind
+	}] : [];
+	const kind = knownRouteKind || (siteProtocol ? "external" : "doc");
+	const contractConfig = {
+		base: config.base,
+		i18n: config.i18n ? {
+			defaultLocale: config.i18n.defaultLocale,
+			locales: config.i18n.locales
+		} : void 0,
+		versions: config.versions ? {
+			defaultVersion: config.versions.defaultVersion,
+			prefix: config.versions.prefix,
+			versions: config.versions.versions
+		} : void 0,
+		collections: collectionNames
+	};
+	const parsedTarget = parseUrlReference(siteValue, contractConfig, {
+		kind,
+		routes: routeHints
+	});
+	const resolved = resolveUrlReference(siteValue, contractConfig, {
+		kind,
+		routes: routeHints,
+		locale: configuredLocale,
+		version: kind === "collection" || kind === "external" ? knownRouteMeta?.version : parsedTarget.version || configuredVersion
+	});
+	if (siteValue.endsWith("/") && siteValue.length > 1 && !resolved.split(/[?#]/, 1)[0].endsWith("/")) {
+		const suffixIndex = resolved.search(/[?#]/);
+		return `${suffixIndex < 0 ? resolved : resolved.slice(0, suffixIndex)}/${suffixIndex < 0 ? "" : resolved.slice(suffixIndex)}`;
+	}
+	return resolved;
+}
+
+//#endregion
+//#region src/client/utils/cn.ts
+function cn(...inputs) {
+	return twMerge(clsx(inputs));
+}
+
+//#endregion
+//#region src/client/view-transitions.ts
+function resolveOptions(options) {
+	if (options?.enabled === false) return void 0;
+	return {
+		enabled: true,
+		...options?.types?.length ? { types: options.types } : {}
+	};
+}
+function isNativeViewTransitionSupported() {
+	return typeof document !== "undefined" && typeof document.startViewTransition === "function";
+}
+/**
+* Starts a native document transition when the browser supports it. On older
+* browsers, the update still runs normally and the function returns null.
+*/
+function startViewTransition(update, options) {
+	const resolved = resolveOptions(options);
+	if (typeof document === "undefined" || resolved?.enabled !== true) {
+		update();
+		return null;
+	}
+	const start = document.startViewTransition;
+	if (!start) {
+		update();
+		return null;
+	}
+	const types = options?.types;
+	return start.call(document, {
+		update,
+		...types?.length ? { types } : {}
+	});
+}
+/**
+* Returns a transition-aware runner that follows the project's experimental
+* configuration. It is safe to use in custom layouts and external pages.
+*
+* The returned value is callable for backwards compatibility:
+* `transition(() => setState(...))`. It also exposes `run` and `start` aliases
+* for discoverability in editor autocomplete.
+*/
+function useViewTransition() {
+	const configured = useOptionalConfig()?.experimental?.viewTransitions;
+	const enabled = configured === true || typeof configured === "object" && configured.enabled === true;
+	const supported = isNativeViewTransitionSupported();
+	const run = useCallback((update, options) => {
+		if (!enabled && options?.enabled !== true) {
+			update();
+			return null;
+		}
+		const configuredTypes = typeof configured === "object" ? configured.types : void 0;
+		return startViewTransition(update, {
+			...options,
+			types: options?.types || configuredTypes
+		});
+	}, [configured, enabled]);
+	return useMemo(() => Object.assign(run, {
+		run,
+		start: run,
+		enabled,
+		supported
+	}), [
+		enabled,
+		run,
+		supported
+	]);
+}
+
+//#endregion
+//#region src/client/components/primitives/link.tsx
+/**
+* A primitive Link component that wraps a standard anchor tag
+* and adds framework-specific logic for path localization and preloading.
+*/
+function Link(props) {
+	const { href, to, ref, prefetch = "hover", onMouseEnter, onFocus, onClick, target: linkTarget, download, transition = false, transitionTypes, ...rest } = props;
+	const target = href ?? to ?? "";
+	const navigate = useNavigate();
+	const prefetchRoute = usePrefetch();
+	const runTransition = useViewTransition();
+	const localizedHref = useLocalizedTo(target);
+	const handleClick = (e) => {
+		onClick?.(e);
+		if (e.defaultPrevented || e.button !== 0 || e.metaKey || e.ctrlKey || e.shiftKey || e.altKey || download !== void 0 || linkTarget && linkTarget !== "_self") return;
+		if (!(localizedHref && (localizedHref.startsWith("http://") || localizedHref.startsWith("https://") || localizedHref.startsWith("//") || hasUriScheme(localizedHref)))) {
+			e.preventDefault();
+			const navigateTo = () => navigate(localizedHref, transition ? { viewTransition: false } : void 0);
+			if (transition) runTransition(navigateTo, {
+				enabled: true,
+				types: transitionTypes
+			});
+			else navigateTo();
+		}
+	};
+	const handlePrefetch = () => {
+		if (prefetch === "hover" && localizedHref) prefetchRoute(localizedHref);
+	};
+	const handleMouseEnter = (e) => {
+		onMouseEnter?.(e);
+		handlePrefetch();
+	};
+	const handleFocus = (e) => {
+		onFocus?.(e);
+		handlePrefetch();
+	};
+	return /* @__PURE__ */ jsx("a", {
+		...rest,
+		ref,
+		href: localizedHref,
+		target: linkTarget,
+		download,
+		onClick: handleClick,
+		onMouseEnter: handleMouseEnter,
+		onFocus: handleFocus
+	});
+}
+/**
+* A convenience link that opts into the experimental View Transition API.
+* It keeps normal anchor behavior when the feature is disabled or unsupported.
+*/
+function TransitionLink(props) {
+	return /* @__PURE__ */ jsx(Link, {
+		...props,
+		transition: true
+	});
+}
+/**
+* A primitive NavLink component that provides active state detection.
+*/
+function NavLink(props) {
+	const { href, to, end = false, className, children, ...rest } = props;
+	const location = useLocation();
+	const localizedHref = useLocalizedTo(href ?? to ?? "");
+	const isActive = end ? location.pathname === localizedHref : location.pathname.startsWith(localizedHref);
+	const resolvedClassName = typeof className === "function" ? className({ isActive }) : cn(className, isActive && "active");
+	const resolvedChildren = typeof children === "function" ? children({ isActive }) : children;
+	return /* @__PURE__ */ jsx(Link, {
+		...rest,
+		href,
+		to,
+		className: resolvedClassName,
+		children: resolvedChildren
+	});
+}
+
+//#endregion
+export { Languages as A, TextAlignStart as B, FaceBad as C, Hash as D, FileText as E, Moon as F, useOptionalConfig as G, icons_exports as H, MoreVertical as I, BoltdocsProvider as K, Pencil as L, Link$1 as M, Menu as N, Home as O, Monitor as P, Search as R, ExternalLink as S, FaceRegular as T, ConfigContext as U, X as V, useConfig as W, ChevronLeft as _, useViewTransition as a, Copy as b, RoutesProvider as c, resolvePublicAssetUrl as d, AlertCircle as f, ChevronDown as g, Check as h, startViewTransition as i, Lightbulb as j, Info as k, useRoutesContext as l, ArrowLeft as m, NavLink as n, cn as o, AlertTriangle as p, useBoltdocsContext as q, TransitionLink as r, useLocalizedTo as s, Link as t, normalizePath as u, ChevronRight as v, FaceGood as w, CornerDownLeft as x, CircleHelp as y, Sun as z };