boltdocs 3.2.2 → 3.3.0

package/dist/{link-D1Gjkb-2.cjs → link-vZjmD-es.cjs}

@@ -3,48 +3,8 @@
  * Copyright (c) 2026 Jesus Alcala
  * Licensed under the MIT License.
  */
-//#region \0rolldown/runtime.js
-var __create = Object.create;
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-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;
-};
-var __copyProps = (to, from, except, desc) => {
-	if (from && typeof from === "object" || typeof from === "function") {
-		for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
-			key = keys[i];
-			if (!__hasOwnProp.call(to, key) && key !== except) {
-				__defProp(to, key, {
-					get: ((k) => from[k]).bind(null, key),
-					enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
-				});
-			}
-		}
-	}
-	return to;
-};
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
-	value: mod,
-	enumerable: true
-}) : target, mod));
-
-//#endregion
+const require_router = require('./router-C3kygdRK.cjs');
 let react = require("react");
-let react_router_dom = require("react-router-dom");
 let react_jsx_runtime = require("react/jsx-runtime");
 let clsx = require("clsx");
 let tailwind_merge = require("tailwind-merge");
@@ -53,17 +13,20 @@ let tailwind_merge = require("tailwind-merge");
 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] = (0, react.createContext)(void 0));
+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 || (0, react.createContext)(void 0);
+if (!existingContext) Reflect.set(globalRegistry$1, BOLTDOCS_CONTEXT_SYMBOL, BoltdocsContext);
 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] = (0, react.useState)(() => {
 		if (initialLocale) return initialLocale;
 		return getSavedPrefs().locale || "";
@@ -78,43 +41,57 @@ function BoltdocsProvider({ children, initialLocale = "", initialVersion = "" })
 	(0, react.useEffect)(() => {
 		setHasHydrated(true);
 	}, []);
-	const value = (0, react.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
-		};
-	}, [
+	const updateLocale = (0, react.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 = (0, react.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 = (0, react.useMemo)(() => ({
+		currentLocale: locale,
+		currentVersion: version,
+		setLocale: updateLocale,
+		setVersion: updateVersion,
+		hasHydrated,
+		setHasHydrated
+	}), [
 		locale,
 		version,
-		hasHydrated
+		hasHydrated,
+		updateLocale,
+		updateVersion
 	]);
-	if (typeof globalThis !== "undefined") globalThis[BOLTDOCS_INSTANCE_SYMBOL] = value;
+	if (typeof globalThis !== "undefined") Reflect.set(globalThis, BOLTDOCS_INSTANCE_SYMBOL, value);
 	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(BoltdocsContext.Provider, {
 		value,
 		children
@@ -122,7 +99,8 @@ function BoltdocsProvider({ children, initialLocale = "", initialVersion = "" })
 }
 function useBoltdocsContext() {
 	const context = (0, react.use)(BoltdocsContext);
-	if (!context && typeof globalThis !== "undefined" && globalThis[BOLTDOCS_INSTANCE_SYMBOL]) return globalThis[BOLTDOCS_INSTANCE_SYMBOL];
+	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;
 }
@@ -135,28 +113,46 @@ function useBoltdocsContext() {
 */
 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] = (0, react.createContext)(null));
+const globalRegistry = globalThis;
+const existingConfigContext = globalRegistry[CONFIG_CONTEXT_SYMBOL];
+const ConfigContext = existingConfigContext || (0, react.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 = (0, react.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 context = (0, react.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;
+	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({
+var icons_exports = /* @__PURE__ */ require_router.__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,
@@ -164,18 +160,24 @@ var icons_exports = /* @__PURE__ */ __exportAll({
 	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,
@@ -215,6 +217,58 @@ const Lightbulb = createIcon("Lightbulb", /* @__PURE__ */ (0, react_jsx_runtime.
 	/* @__PURE__ */ (0, react_jsx_runtime.jsx)("path", { d: "M9 18h6" }),
 	/* @__PURE__ */ (0, react_jsx_runtime.jsx)("path", { d: "M10 22h4" })
 ] }));
+const BookOpen = createIcon("BookOpen", /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [
+	/* @__PURE__ */ (0, react_jsx_runtime.jsx)("path", { d: "M2 4v16a2 2 0 0 0 2 2h16" }),
+	/* @__PURE__ */ (0, react_jsx_runtime.jsx)("path", { d: "M22 18V4a2 2 0 0 0-2-2H6a4 4 0 0 0-4 4" }),
+	/* @__PURE__ */ (0, react_jsx_runtime.jsx)("path", { d: "M6 2v16" }),
+	/* @__PURE__ */ (0, react_jsx_runtime.jsx)("path", { d: "M6 18h16" })
+] }));
+const Rocket = createIcon("Rocket", /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [
+	/* @__PURE__ */ (0, react_jsx_runtime.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__ */ (0, react_jsx_runtime.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__ */ (0, react_jsx_runtime.jsx)("path", { d: "M9 12H4l-2 2 5 1" }),
+	/* @__PURE__ */ (0, react_jsx_runtime.jsx)("path", { d: "M12 15v5l2-2 1-5" }),
+	/* @__PURE__ */ (0, react_jsx_runtime.jsx)("circle", {
+		cx: "16",
+		cy: "8",
+		r: "1"
+	})
+] }));
+const Code2 = createIcon("Code2", /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [
+	/* @__PURE__ */ (0, react_jsx_runtime.jsx)("path", { d: "m18 16 4-4-4-4" }),
+	/* @__PURE__ */ (0, react_jsx_runtime.jsx)("path", { d: "m6 8-4 4 4 4" }),
+	/* @__PURE__ */ (0, react_jsx_runtime.jsx)("path", { d: "m14.5 4-5 16" })
+] }));
+const FlaskConical = createIcon("FlaskConical", /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [
+	/* @__PURE__ */ (0, react_jsx_runtime.jsx)("path", { d: "M9 3h6" }),
+	/* @__PURE__ */ (0, react_jsx_runtime.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__ */ (0, react_jsx_runtime.jsx)("path", { d: "M7 16h10" })
+] }));
+const FileCode2 = createIcon("FileCode2", /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [
+	/* @__PURE__ */ (0, react_jsx_runtime.jsx)("path", { d: "M14 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V8Z" }),
+	/* @__PURE__ */ (0, react_jsx_runtime.jsx)("path", { d: "M14 2v6h6" }),
+	/* @__PURE__ */ (0, react_jsx_runtime.jsx)("path", { d: "m10 13-2 2 2 2" }),
+	/* @__PURE__ */ (0, react_jsx_runtime.jsx)("path", { d: "m14 13 2 2-2 2" })
+] }));
+const Paintbrush = createIcon("Paintbrush", /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("path", { d: "m14 6 4 4" }), /* @__PURE__ */ (0, react_jsx_runtime.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__ */ (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [
+	/* @__PURE__ */ (0, react_jsx_runtime.jsx)("path", { d: "m12 14 4-4" }),
+	/* @__PURE__ */ (0, react_jsx_runtime.jsx)("path", { d: "M3.3 17a9 9 0 1 1 17.4 0" }),
+	/* @__PURE__ */ (0, react_jsx_runtime.jsx)("path", { d: "M5 19h14" })
+] }));
+const LifeBuoy = createIcon("LifeBuoy", /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [
+	/* @__PURE__ */ (0, react_jsx_runtime.jsx)("circle", {
+		cx: "12",
+		cy: "12",
+		r: "10"
+	}),
+	/* @__PURE__ */ (0, react_jsx_runtime.jsx)("circle", {
+		cx: "12",
+		cy: "12",
+		r: "4"
+	}),
+	/* @__PURE__ */ (0, react_jsx_runtime.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__ */ (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [
 	/* @__PURE__ */ (0, react_jsx_runtime.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__ */ (0, react_jsx_runtime.jsx)("line", {
@@ -493,25 +547,6 @@ const FaceBad = createIcon("FaceBad", /* @__PURE__ */ (0, react_jsx_runtime.jsxs
 	})
 ] }));
 
-//#endregion
-//#region src/client/app/routes-context.tsx
-const RoutesContext = (0, react.createContext)({ routes: [] });
-/**
-* Hook to access the processed routes list from the closest provider.
-*/
-function useRoutesContext() {
-	return (0, react.use)(RoutesContext);
-}
-/**
-* Provider component for the documentation routes.
-*/
-function RoutesProvider({ routes, children }) {
-	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(RoutesContext.Provider, {
-		value: { routes },
-		children
-	});
-}
-
 //#endregion
 //#region src/client/utils/path.ts
 /**
@@ -523,117 +558,146 @@ function RoutesProvider({ routes, children }) {
 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/hooks/use-routes.ts
+//#region src/client/app/routes-context.tsx
+const RoutesContext = (0, react.createContext)({
+	routes: [],
+	index: {
+		byPath: /* @__PURE__ */ new Map(),
+		hintsByPath: /* @__PURE__ */ new Map(),
+		collectionNames: []
+	}
+});
 /**
-* 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.
+* Hook to access the processed routes list from the closest provider.
 */
-function useRoutes() {
-	const { routes: allRoutes } = useRoutesContext();
-	const config = useConfig();
-	const location = (0, react_router_dom.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 = (0, react.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);
+function useRoutesContext() {
+	return (0, react.use)(RoutesContext);
+}
+/**
+* Provider component for the documentation routes.
+*/
+function RoutesProvider({ routes: initialRoutes, children }) {
+	const [routes, setRoutes] = (0, react.useState)(initialRoutes);
+	const index = (0, react.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 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 = (0, react.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
-	};
+		return {
+			byPath,
+			hintsByPath,
+			collectionNames: [...collectionNames]
+		};
+	}, [routes]);
+	(0, react.useEffect)(() => {
+		if (!{}.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 = {}.hot;
+		hot.on("boltdocs:frontmatter-update", handler);
+		return () => hot.off?.("boltdocs:frontmatter-update", handler);
+	}, []);
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(RoutesContext.Provider, {
+		value: {
+			routes,
+			index
+		},
+		children
+	});
 }
 
 //#endregion
 //#region src/client/hooks/use-localized-to.ts
 function useLocalizedTo(to) {
 	const config = useConfig();
-	const { currentLocale: activeLocale, currentVersion: activeVersion, allRoutes } = useRoutes();
+	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("//") || 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 || "/");
+	if (to.startsWith("http://") || to.startsWith("https://") || to.startsWith("//") || to.startsWith("#") || to.startsWith("?") || require_router.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 || (require_router.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 = require_router.parseUrlReference(siteValue, contractConfig, {
+		kind,
+		routes: routeHints
 	});
-	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++;
+	const resolved = require_router.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)}`;
 	}
-	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 || "");
+	return resolved;
 }
 
 //#endregion
@@ -642,6 +706,74 @@ function cn(...inputs) {
 	return (0, tailwind_merge.twMerge)((0, clsx.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 = (0, react.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 (0, react.useMemo)(() => Object.assign(run, {
+		run,
+		start: run,
+		enabled,
+		supported
+	}), [
+		enabled,
+		run,
+		supported
+	]);
+}
+
 //#endregion
 //#region src/client/components/primitives/link.tsx
 /**
@@ -649,44 +781,71 @@ function cn(...inputs) {
 * and adds framework-specific logic for path localization and preloading.
 */
 function Link(props) {
-	const { href, onMouseEnter, onFocus, onClick, ...rest } = props;
-	const navigate = (0, react_router_dom.useNavigate)();
-	const localizedHref = useLocalizedTo(href ?? "");
+	const { href, to, ref, prefetch = "hover", onMouseEnter, onFocus, onClick, target: linkTarget, download, transition = false, transitionTypes, ...rest } = props;
+	const target = href ?? to ?? "";
+	const navigate = require_router.useNavigate();
+	const prefetchRoute = require_router.usePrefetch();
+	const runTransition = useViewTransition();
+	const localizedHref = useLocalizedTo(target);
 	const handleClick = (e) => {
 		onClick?.(e);
-		if (e.defaultPrevented) return;
-		if (!(localizedHref && (localizedHref.startsWith("http://") || localizedHref.startsWith("https://") || localizedHref.startsWith("//")))) {
+		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("//") || require_router.hasUriScheme(localizedHref)))) {
 			e.preventDefault();
-			navigate(localizedHref);
+			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__ */ (0, react_jsx_runtime.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__ */ (0, react_jsx_runtime.jsx)(Link, {
+		...props,
+		transition: true
+	});
+}
+/**
 * A primitive NavLink component that provides active state detection.
 */
 function NavLink(props) {
-	const { href, end = false, className, children, ...rest } = props;
-	const location = (0, react_router_dom.useLocation)();
-	const localizedHref = useLocalizedTo(href ?? "");
+	const { href, to, end = false, className, children, ...rest } = props;
+	const location = require_router.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__ */ (0, react_jsx_runtime.jsx)(Link, {
 		...rest,
 		href,
+		to,
 		className: resolvedClassName,
 		children: resolvedChildren
 	});
@@ -897,16 +1056,16 @@ Object.defineProperty(exports, 'TextAlignStart', {
     return TextAlignStart;
   }
 });
-Object.defineProperty(exports, 'X', {
+Object.defineProperty(exports, 'TransitionLink', {
   enumerable: true,
   get: function () {
-    return X;
+    return TransitionLink;
   }
 });
-Object.defineProperty(exports, '__toESM', {
+Object.defineProperty(exports, 'X', {
   enumerable: true,
   get: function () {
-    return __toESM;
+    return X;
   }
 });
 Object.defineProperty(exports, 'cn', {
@@ -927,6 +1086,18 @@ Object.defineProperty(exports, 'normalizePath', {
     return normalizePath;
   }
 });
+Object.defineProperty(exports, 'resolvePublicAssetUrl', {
+  enumerable: true,
+  get: function () {
+    return resolvePublicAssetUrl;
+  }
+});
+Object.defineProperty(exports, 'startViewTransition', {
+  enumerable: true,
+  get: function () {
+    return startViewTransition;
+  }
+});
 Object.defineProperty(exports, 'useBoltdocsContext', {
   enumerable: true,
   get: function () {
@@ -945,9 +1116,21 @@ Object.defineProperty(exports, 'useLocalizedTo', {
     return useLocalizedTo;
   }
 });
-Object.defineProperty(exports, 'useRoutes', {
+Object.defineProperty(exports, 'useOptionalConfig', {
+  enumerable: true,
+  get: function () {
+    return useOptionalConfig;
+  }
+});
+Object.defineProperty(exports, 'useRoutesContext', {
+  enumerable: true,
+  get: function () {
+    return useRoutesContext;
+  }
+});
+Object.defineProperty(exports, 'useViewTransition', {
   enumerable: true,
   get: function () {
-    return useRoutes;
+    return useViewTransition;
   }
 });