boltdocs 3.1.0 → 3.2.2

package/dist/link-2PzgTnaP.js

@@ -0,0 +1,673 @@
+/**
+ * Boltdocs - https://boltdocs.vercel.app
+ * Copyright (c) 2026 Jesus Alcala
+ * Licensed under the MIT License.
+ */
+import { createContext, use, useEffect, useMemo, useState } from "react";
+import { useLocation, useNavigate } from "react-router-dom";
+import { Fragment, 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__");
+const BoltdocsContext = globalThis[BOLTDOCS_CONTEXT_SYMBOL] || (globalThis[BOLTDOCS_CONTEXT_SYMBOL] = createContext(void 0));
+function BoltdocsProvider({ children, initialLocale = "", initialVersion = "" }) {
+	const getSavedPrefs = () => {
+		if (typeof window === "undefined") return {};
+		try {
+			const raw = window.localStorage.getItem(PREFERENCES_KEY);
+			return raw ? JSON.parse(raw) : {};
+		} catch {
+			return {};
+		}
+	};
+	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 value = useMemo(() => {
+		const updateLocale = (l) => {
+			const newL = l || "";
+			setLocaleState(newL);
+			if (typeof window !== "undefined") try {
+				const prefs = getSavedPrefs();
+				window.localStorage.setItem(PREFERENCES_KEY, JSON.stringify({
+					...prefs,
+					locale: newL
+				}));
+			} catch (e) {}
+		};
+		const updateVersion = (v) => {
+			const newV = v || "";
+			setVersionState(newV);
+			if (typeof window !== "undefined") try {
+				const prefs = getSavedPrefs();
+				window.localStorage.setItem(PREFERENCES_KEY, JSON.stringify({
+					...prefs,
+					version: newV
+				}));
+			} catch (e) {}
+		};
+		return {
+			currentLocale: locale,
+			currentVersion: version,
+			setLocale: updateLocale,
+			setVersion: updateVersion,
+			hasHydrated,
+			setHasHydrated
+		};
+	}, [
+		locale,
+		version,
+		hasHydrated
+	]);
+	if (typeof globalThis !== "undefined") globalThis[BOLTDOCS_INSTANCE_SYMBOL] = value;
+	return /* @__PURE__ */ jsx(BoltdocsContext.Provider, {
+		value,
+		children
+	});
+}
+function useBoltdocsContext() {
+	const context = use(BoltdocsContext);
+	if (!context && typeof globalThis !== "undefined" && globalThis[BOLTDOCS_INSTANCE_SYMBOL]) return globalThis[BOLTDOCS_INSTANCE_SYMBOL];
+	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 ConfigContext = globalThis[CONFIG_CONTEXT_SYMBOL] || (globalThis[CONFIG_CONTEXT_SYMBOL] = createContext(null));
+/**
+* Hook to access the Boltdocs configuration.
+*/
+function useConfig() {
+	const context = use(ConfigContext);
+	if (!context && typeof globalThis !== "undefined" && globalThis[CONFIG_INSTANCE_SYMBOL]) return globalThis[CONFIG_INSTANCE_SYMBOL];
+	if (!context) throw new Error("useConfig must be used within a ConfigProvider");
+	return context;
+}
+
+//#endregion
+//#region src/client/components/ui-base/icons.tsx
+var icons_exports = /* @__PURE__ */ __exportAll({
+	AlertCircle: () => AlertCircle,
+	AlertTriangle: () => AlertTriangle,
+	ArrowLeft: () => ArrowLeft,
+	Check: () => Check,
+	ChevronDown: () => ChevronDown,
+	ChevronLeft: () => ChevronLeft,
+	ChevronRight: () => ChevronRight,
+	CircleHelp: () => CircleHelp,
+	Copy: () => Copy,
+	CornerDownLeft: () => CornerDownLeft,
+	ExternalLink: () => ExternalLink,
+	FaceBad: () => FaceBad,
+	FaceGood: () => FaceGood,
+	FaceRegular: () => FaceRegular,
+	File: () => File,
+	FileText: () => FileText,
+	Hash: () => Hash,
+	Home: () => Home,
+	Info: () => Info,
+	Languages: () => Languages,
+	Lightbulb: () => Lightbulb,
+	Link: () => Link$2,
+	Menu: () => Menu,
+	Monitor: () => Monitor,
+	Moon: () => Moon,
+	MoreVertical: () => MoreVertical,
+	Pencil: () => Pencil,
+	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, { 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, { 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 AlertTriangle = createIcon("AlertTriangle", /* @__PURE__ */ jsxs(Fragment, { 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, { 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, { 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, { 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, { children: [/* @__PURE__ */ jsx("path", { d: "m12 19-7-7 7-7" }), /* @__PURE__ */ jsx("path", { d: "M19 12H5" })] }));
+const Pencil = createIcon("Pencil", /* @__PURE__ */ jsxs(Fragment, { 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, { 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, { 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, { 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, { 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, { 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, { 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, { 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, { 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, { 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, { children: [/* @__PURE__ */ jsx("path", { d: "M18 6 6 18" }), /* @__PURE__ */ jsx("path", { d: "m6 6 12 12" })] }));
+const Link$2 = createIcon("Link", /* @__PURE__ */ jsxs(Fragment, { 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, { 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, { 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, { 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, { 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, { 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, { 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, { 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/app/routes-context.tsx
+const RoutesContext = createContext({ routes: [] });
+/**
+* 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, children }) {
+	return /* @__PURE__ */ jsx(RoutesContext.Provider, {
+		value: { routes },
+		children
+	});
+}
+
+//#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;
+}
+
+//#endregion
+//#region src/client/hooks/use-routes.ts
+/**
+* Hook to access the framework's routing state.
+* Returns both the complete set of routes and a filtered list based on the current
+* version and locale.
+*/
+function useRoutes() {
+	const { routes: allRoutes } = useRoutesContext();
+	const config = useConfig();
+	const location = useLocation();
+	const { currentLocale: currentLocaleStore, currentVersion: currentVersionStore } = useBoltdocsContext();
+	const currentPath = normalizePath(location.pathname);
+	const currentRoute = allRoutes?.find?.((r) => normalizePath(r.path) === currentPath);
+	const currentLocale = config.i18n ? currentLocaleStore || config.i18n.defaultLocale : void 0;
+	const currentVersion = config.versions ? currentVersionStore || config.versions.defaultVersion : void 0;
+	const routes = useMemo(() => {
+		if (!allRoutes) return [];
+		const alternateCounts = /* @__PURE__ */ new Map();
+		const defaultLocale = config.i18n?.defaultLocale || "";
+		const defaultVersion = config.versions?.defaultVersion || "";
+		for (const r of allRoutes) {
+			const locale = r.locale || defaultLocale;
+			const version = r.version || defaultVersion;
+			const key = `${r.filePath}::${locale}::${version}`;
+			alternateCounts.set(key, (alternateCounts.get(key) || 0) + 1);
+		}
+		return allRoutes.filter((r) => {
+			const localeMatch = config.i18n ? (r.locale || config.i18n.defaultLocale) === currentLocale : true;
+			const versionMatch = config.versions ? (r.version || config.versions.defaultVersion) === currentVersion : true;
+			if (!(localeMatch && versionMatch)) return false;
+			const pathParts = location.pathname.split("/").filter(Boolean);
+			const isCurrentLocalePrefixed = !!(config.i18n && pathParts.includes(currentLocaleStore || config.i18n.defaultLocale));
+			const isCurrentVersionPrefixed = !!(config.versions && pathParts.includes(currentVersionStore || config.versions.defaultVersion));
+			const isRouteLocalePrefixed = !!r.locale;
+			const isRouteVersionPrefixed = !!r.version;
+			const locale = r.locale || defaultLocale;
+			const version = r.version || defaultVersion;
+			const key = `${r.filePath}::${locale}::${version}`;
+			if ((alternateCounts.get(key) || 0) > 1) {
+				const localeMismatch = config.i18n && isCurrentLocalePrefixed !== isRouteLocalePrefixed;
+				const versionMismatch = config.versions && isCurrentVersionPrefixed !== isRouteVersionPrefixed;
+				if (localeMismatch || versionMismatch) return false;
+			}
+			return true;
+		});
+	}, [
+		allRoutes,
+		config,
+		currentLocale,
+		currentVersion,
+		location.pathname,
+		currentLocaleStore,
+		currentVersionStore
+	]);
+	const collections = useMemo(() => {
+		return new Set((allRoutes || []).map((r) => r.collection).filter(Boolean));
+	}, [allRoutes]);
+	const currentSegment = location.pathname.split("/").filter(Boolean)[0]?.toLowerCase();
+	return {
+		routes,
+		allRoutes,
+		currentRoute,
+		isCollectionPage: !!currentRoute?.collection || (currentSegment ? collections.has(currentSegment) : false),
+		currentLocale,
+		currentVersion
+	};
+}
+
+//#endregion
+//#region src/client/hooks/use-localized-to.ts
+function useLocalizedTo(to) {
+	const config = useConfig();
+	const { currentLocale: activeLocale, currentVersion: activeVersion, allRoutes } = useRoutes();
+	if (!config || typeof to !== "string") return to;
+	if (to.startsWith("http") || to.startsWith("//") || to.startsWith("#")) return to;
+	if (to.startsWith("site:")) {
+		to = to.replace("site:", "");
+		if (to === "" || to === "/") return config.i18n && activeLocale && activeLocale !== config.i18n.defaultLocale ? `/${activeLocale}` : "/";
+		return to;
+	}
+	const [pathOnly, hashAndQuery] = to.split(/([?#].*)/s);
+	const normalizedTo = pathOnly.endsWith("/") && pathOnly.length > 1 ? pathOnly.slice(0, -1) : pathOnly;
+	const isKnownRoute = allRoutes?.some((r) => {
+		return (r.path.endsWith("/") && r.path.length > 1 ? r.path.slice(0, -1) : r.path) === (normalizedTo || "/");
+	});
+	const i18n = config.i18n;
+	const versions = config.versions;
+	const base = (config.base || "/docs").replace(/\/$/, "");
+	const baseSegment = base.startsWith("/") ? base.substring(1) : base;
+	const rawParts = pathOnly.split("/").filter(Boolean);
+	const isDocsPath = baseSegment && rawParts.length > 0 && rawParts[0] === baseSegment || !isKnownRoute && rawParts.length > 0;
+	const parts = [...rawParts];
+	let pIdx = 0;
+	if (baseSegment && parts[pIdx] === baseSegment) pIdx++;
+	if (versions && parts.length > pIdx) {
+		if (versions.versions.find((v) => v.path === parts[pIdx])) pIdx++;
+	}
+	if (i18n && parts.length > pIdx && (Array.isArray(i18n.locales) ? i18n.locales.includes(parts[pIdx]) : parts[pIdx] in i18n.locales)) pIdx++;
+	const routeContent = parts.slice(pIdx);
+	const resultParts = [];
+	if (isDocsPath) {
+		if (baseSegment) resultParts.push(baseSegment);
+		if (versions && activeVersion) resultParts.push(activeVersion);
+		if (i18n && activeLocale && activeLocale !== i18n.defaultLocale) resultParts.push(activeLocale);
+	} else if (i18n && activeLocale && activeLocale !== i18n.defaultLocale) resultParts.push(activeLocale);
+	resultParts.push(...routeContent);
+	let finalPath = `/${resultParts.join("/")}`;
+	if (pathOnly.endsWith("/") && pathOnly.length > 1 && !finalPath.endsWith("/")) finalPath += "/";
+	return (finalPath || "/") + (hashAndQuery || "");
+}
+
+//#endregion
+//#region src/client/utils/cn.ts
+function cn(...inputs) {
+	return twMerge(clsx(inputs));
+}
+
+//#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$1(props) {
+	const { href, onMouseEnter, onFocus, onClick, ...rest } = props;
+	const navigate = useNavigate();
+	const localizedHref = useLocalizedTo(href ?? "");
+	const handleClick = (e) => {
+		onClick?.(e);
+		if (e.defaultPrevented) return;
+		if (!(localizedHref && (localizedHref.startsWith("http://") || localizedHref.startsWith("https://") || localizedHref.startsWith("//")))) {
+			e.preventDefault();
+			navigate(localizedHref);
+		}
+	};
+	const handleMouseEnter = (e) => {
+		onMouseEnter?.(e);
+	};
+	const handleFocus = (e) => {
+		onFocus?.(e);
+	};
+	return /* @__PURE__ */ jsx("a", {
+		...rest,
+		href: localizedHref,
+		onClick: handleClick,
+		onMouseEnter: handleMouseEnter,
+		onFocus: handleFocus
+	});
+}
+/**
+* A primitive NavLink component that provides active state detection.
+*/
+function NavLink(props) {
+	const { href, end = false, className, children, ...rest } = props;
+	const location = useLocation();
+	const localizedHref = useLocalizedTo(href ?? "");
+	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$1, {
+		...rest,
+		href,
+		className: resolvedClassName,
+		children: resolvedChildren
+	});
+}
+
+//#endregion
+export { Monitor as A, useConfig as B, Hash as C, Lightbulb as D, Languages as E, Sun as F, useBoltdocsContext as H, TextAlignStart as I, X as L, MoreVertical as M, Pencil as N, Link$2 as O, Search as P, icons_exports as R, FileText as S, Info as T, BoltdocsProvider as V, CornerDownLeft as _, useRoutes as a, FaceGood as b, AlertCircle as c, Check as d, ChevronDown as f, Copy as g, CircleHelp as h, useLocalizedTo as i, Moon as j, Menu as k, AlertTriangle as l, ChevronRight as m, NavLink as n, normalizePath as o, ChevronLeft as p, cn as r, RoutesProvider as s, Link$1 as t, ArrowLeft as u, ExternalLink as v, Home as w, FaceRegular as x, FaceBad as y, ConfigContext as z };