boltdocs 3.3.6 → 3.4.0

package/dist/{resolve-C5rT6B21.mjs → resolve-5puUe7eS.mjs}

@@ -3,4 +3,4 @@
  * Copyright (c) 2026 Jesus Alcala
  * Licensed under the MIT License.
  */
-import{n as e,t}from"./csp-D0BOH8ae.mjs";function n(n,r){let i=r?{...e}:{};return n.security?.enableCSP&&(i[`Content-Security-Policy`]=t(n)),Object.assign(i,n.security?.headers),Object.assign(i,n.security?.customHeaders),i}export{n as resolveSecurityHeaders};
+import{n as e,t}from"./csp-f8DOcI_7.mjs";function n(n,r){let i=r?{...e}:{};return n.security?.enableCSP&&(i[`Content-Security-Policy`]=t(n)),Object.assign(i,n.security?.headers),Object.assign(i,n.security?.customHeaders),i}export{n as resolveSecurityHeaders};

package/dist/{resolve-BelytNYR.cjs → resolve-CF4ZLfqx.cjs}

@@ -3,4 +3,4 @@
  * Copyright (c) 2026 Jesus Alcala
  * Licensed under the MIT License.
  */
-const e=require(`./csp-BiGAG8aF.cjs`);function t(t,n){let r=n?{...e.n}:{};return t.security?.enableCSP&&(r[`Content-Security-Policy`]=e.t(t)),Object.assign(r,t.security?.headers),Object.assign(r,t.security?.customHeaders),r}exports.resolveSecurityHeaders=t;
+const e=require(`./csp-B-gc2Iha.cjs`);function t(t,n){let r=n?{...e.n}:{};return t.security?.enableCSP&&(r[`Content-Security-Policy`]=e.t(t)),Object.assign(r,t.security?.headers),Object.assign(r,t.security?.customHeaders),r}exports.resolveSecurityHeaders=t;

package/dist/route-paths-B6ocUfNY.cjs

@@ -0,0 +1,6 @@
+/**
+ * Boltdocs - https://boltdocs.vercel.app
+ * Copyright (c) 2026 Jesus Alcala
+ * Licensed under the MIT License.
+ */
+var e=require(`./chunk-D1Md3oWO.cjs`).t({buildTypeRoutePaths:()=>r,normalizeBasePath:()=>t,withBasePath:()=>n});function t(e){let t=(e??``).replace(/^\/+|\/+$/g,``);return t===``?`/`:`/${t}`}function n(e,t){if(t===`/`)return e;let n=e.startsWith(`/`)?e:`/${e}`;return n===t||n.startsWith(`${t}/`)?n:n===`/`?t:`${t}${n}`}function r(e,r,i=[]){let a=t(r),o=[],s=e=>{e&&!o.includes(e)&&o.push(e)};for(let t of e)s(n(t.path,a));s(a);for(let e of i)s(e);return o}Object.defineProperty(exports,`n`,{enumerable:!0,get:function(){return t}}),Object.defineProperty(exports,`r`,{enumerable:!0,get:function(){return e}}),Object.defineProperty(exports,`t`,{enumerable:!0,get:function(){return r}});

package/dist/route-paths-DyDji4bX.mjs

@@ -0,0 +1,6 @@
+/**
+ * Boltdocs - https://boltdocs.vercel.app
+ * Copyright (c) 2026 Jesus Alcala
+ * Licensed under the MIT License.
+ */
+import{t as e}from"./chunk-BFSpntXv.mjs";var t=e({buildTypeRoutePaths:()=>i,normalizeBasePath:()=>n,withBasePath:()=>r});function n(e){let t=(e??``).replace(/^\/+|\/+$/g,``);return t===``?`/`:`/${t}`}function r(e,t){if(t===`/`)return e;let n=e.startsWith(`/`)?e:`/${e}`;return n===t||n.startsWith(`${t}/`)?n:n===`/`?t:`${t}${n}`}function i(e,t,i=[]){let a=n(t),o=[],s=e=>{e&&!o.includes(e)&&o.push(e)};for(let t of e)s(r(t.path,a));s(a);for(let e of i)s(e);return o}export{n,t as r,i as t};

package/dist/{router-CZBxMRAH.js → router-B5e8k4qK.js}

@@ -32,6 +32,143 @@ function addBasename(path, basename) {
 	return `${normalized}/${path}`;
 }
 
+//#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/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";
+}
+/**
+* Honors the `prefers-reduced-motion` media query.
+*
+* View transitions animate the whole document, so ignoring this setting turns
+* an accessibility preference into a motion-sensitivity regression. The check
+* is live: a visitor can change the OS setting without reloading the page.
+*/
+function prefersReducedMotion() {
+	if (typeof window === "undefined" || !window.matchMedia) return false;
+	try {
+		return window.matchMedia("(prefers-reduced-motion: reduce)").matches;
+	} catch {
+		return false;
+	}
+}
+/**
+* Combines the configured transition types with a navigation direction.
+*
+* The direction is always appended as a type so themes can animate forward and
+* backward navigation differently without writing router code.
+*/
+function resolveTransitionTypes(configured, direction = "none") {
+	const types = [...configured ?? []];
+	if (direction !== "none" && !types.includes(direction)) types.push(direction);
+	return types.length > 0 ? types : void 0;
+}
+/**
+* Starts a native document transition when the browser supports it and the
+* visitor has not asked for reduced motion. Otherwise 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;
+	}
+	if (prefersReducedMotion()) {
+		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 reducedMotion = prefersReducedMotion();
+	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: resolveTransitionTypes(options?.types ?? configuredTypes, "none")
+		});
+	}, [configured, enabled]);
+	return useMemo(() => Object.assign(run, {
+		run,
+		start: run,
+		enabled,
+		supported,
+		reducedMotion
+	}), [
+		enabled,
+		reducedMotion,
+		run,
+		supported
+	]);
+}
+
 //#endregion
 //#region src/client/router/context.tsx
 function getActiveLocale() {
@@ -75,12 +212,12 @@ function dispatchNavigationStart(location) {
 	if (typeof window === "undefined") return;
 	window.dispatchEvent(new CustomEvent("boltdocs:navigation-start", { detail: location }));
 }
-function scheduleLocationUpdate(setLocation, nextLocation, viewTransitions) {
+function scheduleLocationUpdate(setLocation, nextLocation, viewTransitions, direction = "none") {
 	setTimeout(() => {
 		const enabled = typeof viewTransitions === "boolean" ? viewTransitions : viewTransitions?.enabled === true;
 		const startViewTransition = document.startViewTransition;
-		if (enabled && startViewTransition) {
-			const types = typeof viewTransitions === "object" ? viewTransitions.types : void 0;
+		if (enabled && startViewTransition && !prefersReducedMotion()) {
+			const types = resolveTransitionTypes(typeof viewTransitions === "object" ? viewTransitions.types : void 0, direction);
 			startViewTransition.call(document, {
 				update: () => setLocation(nextLocation),
 				...types?.length ? { types } : {}
@@ -107,16 +244,44 @@ const LocationProvider = ({ pathname: propPathname, children, loaderData = null,
 			hash: ""
 		} : defaultLocation;
 	});
+	const historyIndex = useRef(0);
+	useEffect(() => {
+		if (typeof window === "undefined") return;
+		const stored = window.history.state;
+		if (typeof stored?.__boltdocsIndex === "number") historyIndex.current = stored.__boltdocsIndex;
+	}, []);
+	const pushHistoryState = useCallback((state, url, replace) => {
+		if (typeof window === "undefined") return "none";
+		const nextIndex = replace ? historyIndex.current : historyIndex.current + 1;
+		const payload = {
+			...typeof state === "object" && state !== null ? state : {},
+			__boltdocsIndex: nextIndex
+		};
+		if (replace) window.history.replaceState(payload, "", url);
+		else window.history.pushState(payload, "", url);
+		historyIndex.current = nextIndex;
+		return replace ? "none" : "forward";
+	}, []);
+	const readPopDirection = useCallback(() => {
+		if (typeof window === "undefined") return "none";
+		const stored = window.history.state;
+		const nextIndex = typeof stored?.__boltdocsIndex === "number" ? stored.__boltdocsIndex : historyIndex.current;
+		const previous = historyIndex.current;
+		historyIndex.current = nextIndex;
+		if (nextIndex > previous) return "forward";
+		if (nextIndex < previous) return "back";
+		return "none";
+	}, []);
 	useEffect(() => {
 		if (typeof window === "undefined") return;
 		const handlePopState = () => {
 			const nextLocation = getLocationFromWindow();
-			scheduleLocationUpdate(setLocation, nextLocation, viewTransitions);
+			scheduleLocationUpdate(setLocation, nextLocation, viewTransitions, readPopDirection());
 			dispatchNavigationStart(nextLocation);
 		};
 		window.addEventListener("popstate", handlePopState);
 		return () => window.removeEventListener("popstate", handlePopState);
-	}, [viewTransitions]);
+	}, [readPopDirection, viewTransitions]);
 	const prefetched = useRef(/* @__PURE__ */ new Set());
 	const fallbackPrefetch = useCallback(async (to) => {
 		if (typeof window === "undefined" || !to || prefetched.current.has(to)) return;
@@ -145,7 +310,7 @@ const LocationProvider = ({ pathname: propPathname, children, loaderData = null,
 			}
 			if (options?.replace) window.history.replaceState(options.state ?? null, "", newUrl.href);
 			else window.history.pushState(options?.state ?? null, "", newUrl.href);
-			scheduleLocationUpdate(setLocation, nextLocation, options?.viewTransition === false ? false : viewTransitions);
+			scheduleLocationUpdate(setLocation, nextLocation, options?.viewTransition === false ? false : viewTransitions, "none");
 			dispatchNavigationStart(nextLocation);
 			return;
 		}
@@ -165,18 +330,18 @@ const LocationProvider = ({ pathname: propPathname, children, loaderData = null,
 			else window.history.pushState(options.state, "", finalPath);
 			return;
 		}
-		if (options?.replace) window.history.replaceState(options?.state ?? null, "", finalPath);
-		else window.history.pushState(options?.state ?? null, "", finalPath);
+		const direction = pushHistoryState(options?.state ?? null, finalPath, options?.replace === true);
 		const nextLocation = {
 			pathname: finalUrl.pathname,
 			search: finalUrl.search,
 			hash: finalUrl.hash
 		};
-		scheduleLocationUpdate(setLocation, nextLocation, options?.viewTransition === false ? false : viewTransitions);
+		scheduleLocationUpdate(setLocation, nextLocation, options?.viewTransition === false ? false : viewTransitions, direction);
 		dispatchNavigationStart(nextLocation);
 	}, [
 		basename,
 		defaultLocale,
+		pushHistoryState,
 		viewTransitions
 	]);
 	useEffect(() => {
@@ -984,4 +1149,4 @@ function resolveUrlReference(to, config, options = {}) {
 }
 
 //#endregion
-export { useRouteData as A, normalizeBasename as B, Outlet as C, useMatches as D, useLocation as E, PrefetchContext as F, RouteDataContext as I, defaultNavigate as L, LocationProvider as M, MatchesContext as N, useNavigate as O, NavigateContext as P, addBasename as R, resolveRouteBranch as S, useLoaderData as T, stripBasename as V, stripSiteProtocol as _, getConfiguredVersions as a, matchRouteBranch as b, hasUriScheme as c, isConfiguredVersion as d, normalizeUrlBase as f, splitUrlReference as g, resolveUrlReference as h, getConfiguredLocales as i, LocationContext as j, usePrefetch as k, hasUrlBase as l, parseUrlReference as m, buildUrl as n, getVersionPrefixSegments as o, normalizeUrlPath as p, classifyUrlPath as r, getVersionSegments as s, addUrlBase as t, isConfiguredLocale as u, stripUrlBase as v, OutletContext as w, matchRouteBranchWithParams as x, RouteRenderer as y, hasBasename as z };
+export { useRouteData as A, ConfigContext as B, Outlet as C, useMatches as D, useLocation as E, PrefetchContext as F, normalizeBasename as G, useOptionalConfig as H, RouteDataContext as I, stripBasename as K, defaultNavigate as L, LocationProvider as M, MatchesContext as N, useNavigate as O, NavigateContext as P, startViewTransition as R, resolveRouteBranch as S, useLoaderData as T, addBasename as U, useConfig as V, hasBasename as W, stripSiteProtocol as _, getConfiguredVersions as a, matchRouteBranch as b, hasUriScheme as c, isConfiguredVersion as d, normalizeUrlBase as f, splitUrlReference as g, resolveUrlReference as h, getConfiguredLocales as i, LocationContext as j, usePrefetch as k, hasUrlBase as l, parseUrlReference as m, buildUrl as n, getVersionPrefixSegments as o, normalizeUrlPath as p, classifyUrlPath as r, getVersionSegments as s, addUrlBase as t, isConfiguredLocale as u, stripUrlBase as v, OutletContext as w, matchRouteBranchWithParams as x, RouteRenderer as y, useViewTransition as z };

package/dist/{router-C3kygdRK.cjs → router-DKC0Lu0n.cjs}

@@ -73,6 +73,143 @@ function addBasename(path, basename) {
 	return `${normalized}/${path}`;
 }
 
+//#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 || (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 config = useOptionalConfig();
+	if (!config) throw new Error("useConfig must be used within a ConfigProvider");
+	return config;
+}
+
+//#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";
+}
+/**
+* Honors the `prefers-reduced-motion` media query.
+*
+* View transitions animate the whole document, so ignoring this setting turns
+* an accessibility preference into a motion-sensitivity regression. The check
+* is live: a visitor can change the OS setting without reloading the page.
+*/
+function prefersReducedMotion() {
+	if (typeof window === "undefined" || !window.matchMedia) return false;
+	try {
+		return window.matchMedia("(prefers-reduced-motion: reduce)").matches;
+	} catch {
+		return false;
+	}
+}
+/**
+* Combines the configured transition types with a navigation direction.
+*
+* The direction is always appended as a type so themes can animate forward and
+* backward navigation differently without writing router code.
+*/
+function resolveTransitionTypes(configured, direction = "none") {
+	const types = [...configured ?? []];
+	if (direction !== "none" && !types.includes(direction)) types.push(direction);
+	return types.length > 0 ? types : void 0;
+}
+/**
+* Starts a native document transition when the browser supports it and the
+* visitor has not asked for reduced motion. Otherwise 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;
+	}
+	if (prefersReducedMotion()) {
+		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 reducedMotion = prefersReducedMotion();
+	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: resolveTransitionTypes(options?.types ?? configuredTypes, "none")
+		});
+	}, [configured, enabled]);
+	return (0, react.useMemo)(() => Object.assign(run, {
+		run,
+		start: run,
+		enabled,
+		supported,
+		reducedMotion
+	}), [
+		enabled,
+		reducedMotion,
+		run,
+		supported
+	]);
+}
+
 //#endregion
 //#region src/client/router/context.tsx
 function getActiveLocale() {
@@ -116,12 +253,12 @@ function dispatchNavigationStart(location) {
 	if (typeof window === "undefined") return;
 	window.dispatchEvent(new CustomEvent("boltdocs:navigation-start", { detail: location }));
 }
-function scheduleLocationUpdate(setLocation, nextLocation, viewTransitions) {
+function scheduleLocationUpdate(setLocation, nextLocation, viewTransitions, direction = "none") {
 	setTimeout(() => {
 		const enabled = typeof viewTransitions === "boolean" ? viewTransitions : viewTransitions?.enabled === true;
 		const startViewTransition = document.startViewTransition;
-		if (enabled && startViewTransition) {
-			const types = typeof viewTransitions === "object" ? viewTransitions.types : void 0;
+		if (enabled && startViewTransition && !prefersReducedMotion()) {
+			const types = resolveTransitionTypes(typeof viewTransitions === "object" ? viewTransitions.types : void 0, direction);
 			startViewTransition.call(document, {
 				update: () => setLocation(nextLocation),
 				...types?.length ? { types } : {}
@@ -148,16 +285,44 @@ const LocationProvider = ({ pathname: propPathname, children, loaderData = null,
 			hash: ""
 		} : defaultLocation;
 	});
+	const historyIndex = (0, react.useRef)(0);
+	(0, react.useEffect)(() => {
+		if (typeof window === "undefined") return;
+		const stored = window.history.state;
+		if (typeof stored?.__boltdocsIndex === "number") historyIndex.current = stored.__boltdocsIndex;
+	}, []);
+	const pushHistoryState = (0, react.useCallback)((state, url, replace) => {
+		if (typeof window === "undefined") return "none";
+		const nextIndex = replace ? historyIndex.current : historyIndex.current + 1;
+		const payload = {
+			...typeof state === "object" && state !== null ? state : {},
+			__boltdocsIndex: nextIndex
+		};
+		if (replace) window.history.replaceState(payload, "", url);
+		else window.history.pushState(payload, "", url);
+		historyIndex.current = nextIndex;
+		return replace ? "none" : "forward";
+	}, []);
+	const readPopDirection = (0, react.useCallback)(() => {
+		if (typeof window === "undefined") return "none";
+		const stored = window.history.state;
+		const nextIndex = typeof stored?.__boltdocsIndex === "number" ? stored.__boltdocsIndex : historyIndex.current;
+		const previous = historyIndex.current;
+		historyIndex.current = nextIndex;
+		if (nextIndex > previous) return "forward";
+		if (nextIndex < previous) return "back";
+		return "none";
+	}, []);
 	(0, react.useEffect)(() => {
 		if (typeof window === "undefined") return;
 		const handlePopState = () => {
 			const nextLocation = getLocationFromWindow();
-			scheduleLocationUpdate(setLocation, nextLocation, viewTransitions);
+			scheduleLocationUpdate(setLocation, nextLocation, viewTransitions, readPopDirection());
 			dispatchNavigationStart(nextLocation);
 		};
 		window.addEventListener("popstate", handlePopState);
 		return () => window.removeEventListener("popstate", handlePopState);
-	}, [viewTransitions]);
+	}, [readPopDirection, viewTransitions]);
 	const prefetched = (0, react.useRef)(/* @__PURE__ */ new Set());
 	const fallbackPrefetch = (0, react.useCallback)(async (to) => {
 		if (typeof window === "undefined" || !to || prefetched.current.has(to)) return;
@@ -186,7 +351,7 @@ const LocationProvider = ({ pathname: propPathname, children, loaderData = null,
 			}
 			if (options?.replace) window.history.replaceState(options.state ?? null, "", newUrl.href);
 			else window.history.pushState(options?.state ?? null, "", newUrl.href);
-			scheduleLocationUpdate(setLocation, nextLocation, options?.viewTransition === false ? false : viewTransitions);
+			scheduleLocationUpdate(setLocation, nextLocation, options?.viewTransition === false ? false : viewTransitions, "none");
 			dispatchNavigationStart(nextLocation);
 			return;
 		}
@@ -206,18 +371,18 @@ const LocationProvider = ({ pathname: propPathname, children, loaderData = null,
 			else window.history.pushState(options.state, "", finalPath);
 			return;
 		}
-		if (options?.replace) window.history.replaceState(options?.state ?? null, "", finalPath);
-		else window.history.pushState(options?.state ?? null, "", finalPath);
+		const direction = pushHistoryState(options?.state ?? null, finalPath, options?.replace === true);
 		const nextLocation = {
 			pathname: finalUrl.pathname,
 			search: finalUrl.search,
 			hash: finalUrl.hash
 		};
-		scheduleLocationUpdate(setLocation, nextLocation, options?.viewTransition === false ? false : viewTransitions);
+		scheduleLocationUpdate(setLocation, nextLocation, options?.viewTransition === false ? false : viewTransitions, direction);
 		dispatchNavigationStart(nextLocation);
 	}, [
 		basename,
 		defaultLocale,
+		pushHistoryState,
 		viewTransitions
 	]);
 	(0, react.useEffect)(() => {
@@ -1025,6 +1190,12 @@ function resolveUrlReference(to, config, options = {}) {
 }
 
 //#endregion
+Object.defineProperty(exports, 'ConfigContext', {
+  enumerable: true,
+  get: function () {
+    return ConfigContext;
+  }
+});
 Object.defineProperty(exports, 'LocationContext', {
   enumerable: true,
   get: function () {
@@ -1229,6 +1400,12 @@ Object.defineProperty(exports, 'splitUrlReference', {
     return splitUrlReference;
   }
 });
+Object.defineProperty(exports, 'startViewTransition', {
+  enumerable: true,
+  get: function () {
+    return startViewTransition;
+  }
+});
 Object.defineProperty(exports, 'stripBasename', {
   enumerable: true,
   get: function () {
@@ -1247,6 +1424,12 @@ Object.defineProperty(exports, 'stripUrlBase', {
     return stripUrlBase;
   }
 });
+Object.defineProperty(exports, 'useConfig', {
+  enumerable: true,
+  get: function () {
+    return useConfig;
+  }
+});
 Object.defineProperty(exports, 'useLoaderData', {
   enumerable: true,
   get: function () {
@@ -1271,6 +1454,12 @@ Object.defineProperty(exports, 'useNavigate', {
     return useNavigate;
   }
 });
+Object.defineProperty(exports, 'useOptionalConfig', {
+  enumerable: true,
+  get: function () {
+    return useOptionalConfig;
+  }
+});
 Object.defineProperty(exports, 'usePrefetch', {
   enumerable: true,
   get: function () {
@@ -1282,4 +1471,10 @@ Object.defineProperty(exports, 'useRouteData', {
   get: function () {
     return useRouteData;
   }
+});
+Object.defineProperty(exports, 'useViewTransition', {
+  enumerable: true,
+  get: function () {
+    return useViewTransition;
+  }
 });

package/dist/{routes-Dq_2EUIB.cjs → routes-D55M8UrH.cjs}

@@ -3,4 +3,4 @@
  * Copyright (c) 2026 Jesus Alcala
  * Licensed under the MIT License.
  */
-const e=require(`./pages-external-DPiPFxxP.cjs`),t=require(`./routes-CzhKOw67.cjs`);exports.generateRoutes=t.t,exports.getExternalRoutePaths=e.n,exports.invalidateDirectoryMetaFile=t.n,exports.invalidateFile=t.r,exports.invalidateRouteCache=t.i;
+const e=require(`./pages-external-B_r6gvqP.cjs`),t=require(`./routes-DdE6Lfcl.cjs`);exports.generateRoutes=t.t,exports.getExternalRoutePaths=e.n,exports.invalidateDirectoryMetaFile=t.n,exports.invalidateFile=t.r,exports.invalidateRouteCache=t.i;

package/dist/{routes-CzhKOw67.cjs → routes-DdE6Lfcl.cjs}

@@ -3,4 +3,4 @@
  * Copyright (c) 2026 Jesus Alcala
  * Licensed under the MIT License.
  */
-const e=require(`./chunk-D1Md3oWO.cjs`),t=require(`./utils-ej6_SjIZ.cjs`),n=require(`./node/cache.cjs`),r=require(`./cache-CJE9nWLE.cjs`);let i=require(`node:path`);i=e.r(i);let a=require(`node:fs`);a=e.r(a);let o=require(`node:crypto`);o=e.r(o);let s=require(`@bdocs/dui`),c=require(`node:fs/promises`);c=e.r(c);let l=require(`fdir`);function u(e){return i.default.resolve(e)}function d(e,t){return o.default.createHash(`sha1`).update(`${u(e)}:${t}`).digest(`hex`).slice(0,16)}function f(e,a,o){let s=d(e,o),c=t.o();return{fingerprint:o,docCache:new n.FileCache({name:`routes-${s}`,root:a}),parserCache:new r.t(a,s),cachedFileList:null,localizedPathCache:new Map,cachedNativeDocs:null,frontmatterHashes:new Map,directoryMeta:null,cachedDirectoryMetaFiles:null,directoryMetaEntries:new Map,discoverySnapshot:null,discoverySnapshotLoaded:!1,discoverySnapshotPath:i.default.resolve(a,c.dir,`route-discovery-${s}.json`)}}function p(e,t=i.default.dirname(i.default.resolve(e))){let n=u(e),r=i.default.resolve(t),a=f(n,r,`legacy`);return{docsDir:n,cacheRoot:r,docCache:a.docCache,parserCache:a.parserCache,cachedFileList:a.cachedFileList,localizedPathCache:a.localizedPathCache,cachedNativeDocs:a.cachedNativeDocs,frontmatterHashes:a.frontmatterHashes,directoryMeta:a.directoryMeta,cachedDirectoryMetaFiles:a.cachedDirectoryMetaFiles,variants:new Map([[`legacy`,a]]),activeVariant:a,activeGenerations:new Map,generationEpoch:0,disposed:!1}}const m=new Map;function h(e,t,n=!1){if(e.disposed)throw Error(`[boltdocs] Route cache context has been disposed.`);let r=e.variants.get(t);if(!r&&(r=f(e.docsDir,e.cacheRoot,t),e.variants.set(t,r),e.variants.size>8)){for(let[n,r]of e.variants)if(!(n===t||r===e.activeVariant)&&!e.activeGenerations.has(n)){e.variants.delete(n);break}}return n&&(e.activeVariant=r,e.docCache=r.docCache,e.parserCache=r.parserCache,e.cachedFileList=r.cachedFileList,e.localizedPathCache=r.localizedPathCache,e.cachedNativeDocs=r.cachedNativeDocs,e.frontmatterHashes=r.frontmatterHashes,e.directoryMeta=r.directoryMeta,e.cachedDirectoryMetaFiles=r.cachedDirectoryMetaFiles),r}function g(e,t){e.activeVariant===t&&(e.cachedFileList=t.cachedFileList,e.cachedNativeDocs=t.cachedNativeDocs,e.frontmatterHashes=t.frontmatterHashes,e.directoryMeta=t.directoryMeta,e.cachedDirectoryMetaFiles=t.cachedDirectoryMetaFiles)}function _(e,t){return o.default.createHash(`sha1`).update(JSON.stringify({basePath:t||e?.base||`/docs`,i18n:e?.i18n,versions:e?.versions,drafts:e?.drafts,featureFlags:e?.featureFlags,fileRouting:e?.experimental?.fileRouting,sidebarGroups:e?.theme?.sidebarGroups})).digest(`hex`)}function v(e,t){let n=u(e),r=m.get(n),i=t??r;(!i||r===i)&&m.delete(n),i&&(i.disposed=!0,i.generationEpoch++,i.activeGenerations.clear(),i.variants.clear(),i.activeVariant=null,i.cachedFileList=null,i.localizedPathCache.clear(),i.cachedNativeDocs=null,i.frontmatterHashes.clear(),i.directoryMeta=null,i.cachedDirectoryMetaFiles=null)}function y(e){let t=u(e),n=m.get(t);return n||(n=p(t),m.set(t,n)),n}const b=p(i.default.resolve(process.cwd(),`docs`)),x=b.docCache;function S(e){try{a.default.rmSync(e.discoverySnapshotPath,{force:!0})}catch{}}function C(e){let t=typeof e==`string`?y(e):e??b;for(let e of t.variants.values())e.cachedFileList=null,e.localizedPathCache.clear(),e.cachedNativeDocs=null,e.frontmatterHashes.clear(),e.directoryMeta=null,e.cachedDirectoryMetaFiles=null,e.discoverySnapshot=null,e.discoverySnapshotLoaded=!1,S(e),e.docCache.invalidateAll(),e.parserCache.clear();t.cachedFileList=null,t.localizedPathCache.clear(),t.cachedNativeDocs=null,t.frontmatterHashes.clear(),t.directoryMeta=null,t.cachedDirectoryMetaFiles=null,t.generationEpoch++}function w(e,t){let n=typeof t==`string`?y(t):t??b,r=i.default.resolve(e);for(let e of n.variants.values()){for(let t of e.directoryMetaEntries.keys())i.default.resolve(t)===r&&e.directoryMetaEntries.delete(t);e.directoryMeta=null,e.cachedDirectoryMetaFiles=null,e.discoverySnapshot=null,e.discoverySnapshotLoaded=!1,S(e)}n.directoryMeta=null,n.cachedDirectoryMetaFiles=null,n.generationEpoch++}function T(e,t){let n=typeof t==`string`?y(t):t??b;for(let t of n.variants.values())t.docCache.invalidate(e),t.parserCache.invalidate(e),t.cachedNativeDocs?.[e.replace(/\\/g,`/`)]&&delete t.cachedNativeDocs[e.replace(/\\/g,`/`)],t.frontmatterHashes.delete(e);n.cachedNativeDocs=n.activeVariant?.cachedNativeDocs??null,n.frontmatterHashes.delete(e),n.generationEpoch++}function E(e){return e.sort((e,t)=>{let n=e.group?e.groupPosition??999:e.sidebarPosition??999,r=t.group?t.groupPosition??999:t.sidebarPosition??999;return n===r?!e.group&&t.group?-1:e.group&&!t.group?1:e.group&&t.group&&e.group!==t.group?(e.groupTitle||e.group).localeCompare(t.groupTitle||t.group):D(e,t):n-r})}function D(e,t){if(e.sidebarPosition!==void 0&&t.sidebarPosition!==void 0){let n=e.sidebarPosition-t.sidebarPosition;if(n!==0)return n}else if(e.sidebarPosition!==void 0)return-1;else if(t.sidebarPosition!==void 0)return 1;let n=e.title.localeCompare(t.title);return n===0?e.path.localeCompare(t.path):n}const O=new Map;function k(e){let{lastUpdated:t,...n}=e;return o.default.createHash(`md5`).update(JSON.stringify(n)).digest(`hex`)}async function A(e){try{let{data:n}=await t.d(e);return k(n)}catch{return``}}function j(e,t,n){let r=n?.frontmatterHashes??t?.frontmatterHashes??O,i=r.get(e);if(i===void 0){let a=(n?.docCache??t?.docCache??x).getStale(e);a?.route?.frontmatter&&(i=k(a.route.frontmatter),r.set(e,i))}return i}function M(e,t,n,r){(r?.frontmatterHashes??n?.frontmatterHashes??O).set(e,t)}function N(e,t,n){(n?.frontmatterHashes??t?.frontmatterHashes??O).delete(e)}const P=Symbol(`route-generation-invalidated`);async function F(e,t,n){let r=[...t].sort((e,t)=>{if(i.default.dirname(e)===i.default.dirname(t)){let n=i.default.basename(e),r=i.default.basename(t);if(n===`_meta.json`&&r===`meta.json`)return-1;if(n===`meta.json`&&r===`_meta.json`)return 1}return e.localeCompare(t)}),a=new Set(r),o=n.directoryMetaEntries;for(let e of o.keys())a.has(e)||o.delete(e);await Promise.all(r.map(async e=>{let t;try{t=await c.default.stat(e)}catch(t){o.delete(e),(0,s.warn)(`Failed to stat meta.json: ${t instanceof Error?t.message:String(t)}`);return}let n=o.get(e);if(!(n&&n.mtimeMs===t.mtimeMs&&n.size===t.size))try{let n=await c.default.readFile(e,`utf8`);o.set(e,{mtimeMs:t.mtimeMs,size:t.size,content:JSON.parse(n)})}catch(t){o.delete(e),(0,s.warn)(`Failed to read meta.json: ${t instanceof Error?t.message:String(t)}`)}}));let l={};for(let t of r){let n=o.get(t);if(!n)continue;let r=i.default.relative(e,i.default.dirname(t)).replace(/\\/g,`/`);l[r||`.`]=n.content}return l}async function I(e,n){if(!n.discoverySnapshotPath||t.o().noCache)return null;if(n.discoverySnapshotLoaded)return n.discoverySnapshot;n.discoverySnapshotLoaded=!0;try{let t=await c.default.readFile(n.discoverySnapshotPath,`utf8`),r=JSON.parse(t),a=e=>Array.isArray(e)&&e.every(e=>typeof e==`string`),o=r.files,s=r.directoryMetaFiles,l=r.directories&&typeof r.directories==`object`?Object.entries(r.directories):[],u=i.default.resolve(e),d=await c.default.realpath(u),f=e=>{let t=i.default.resolve(e);return t===u||t.startsWith(`${u}${i.default.sep}`)},p=e=>/\.(?:md|mdx)$/i.test(e),m=e=>{let t=i.default.basename(e);return t===`meta.json`||t===`_meta.json`};if(r.version!==1||!a(o)||!a(s)||!r.directories||typeof r.directories!=`object`||Array.isArray(r.directories)||o.some(e=>!f(e)||!p(e))||s.some(e=>!f(e)||!m(e))||l.some(([e,t])=>!f(e)||typeof t!=`number`||!Number.isFinite(t)))return null;let h=e=>{let t=i.default.resolve(e);return t===d||t.startsWith(`${d}${i.default.sep}`)},g=await Promise.all([...o,...s].map(async e=>{try{return(await c.default.lstat(e)).isFile()?h(await c.default.realpath(e)):!1}catch{return!1}})),_=await Promise.all(l.map(async([e,t])=>{try{let n=await c.default.stat(e);return n.isDirectory()&&n.mtimeMs===t&&h(await c.default.realpath(e))}catch{return!1}}));if(g.every(Boolean)&&_.every(Boolean)){let e={version:1,files:o,directoryMetaFiles:s,directories:Object.fromEntries(l)};return n.discoverySnapshot=e,e}}catch{}return null}async function L(e,n){if(t.o().noCache){e.discoverySnapshot=null,e.discoverySnapshotLoaded=!1;return}e.discoverySnapshot=n,e.discoverySnapshotLoaded=!0;try{await c.default.mkdir(i.default.dirname(e.discoverySnapshotPath),{recursive:!0}),await c.default.writeFile(e.discoverySnapshotPath,JSON.stringify(n))}catch{}}async function R(e,t,n){if(!n){let n=await I(e,t);if(n)return n}let r=await new l.fdir({excludeSymlinks:!0}).withFullPaths().filter(t=>{let n=i.default.basename(t),r=n===`meta.json`||n===`_meta.json`;return!(t.endsWith(`.md`)||t.endsWith(`.mdx`))&&!r?!1:!i.default.relative(e,t).replace(/\\/g,`/`).split(`/`).some(e=>e.startsWith(`_`)&&e!==`_index.md`&&e!==`_index.mdx`&&e!==`_meta.json`)}).crawl(e).withPromise(),a=r.filter(e=>{let t=i.default.basename(e);return t===`meta.json`||t===`_meta.json`}).sort((e,t)=>e.localeCompare(t)),o=r.filter(e=>e.endsWith(`.md`)||e.endsWith(`.mdx`)),s=[/index\./i,/intro/i,/getting-started/i,/readme/i],u=o.map(e=>{let t=s.findIndex(t=>t.test(i.default.basename(e)));return{file:e,score:t===-1?2**53-1:t}});u.sort((e,t)=>e.score-t.score||e.file.localeCompare(t.file));let d=u.map(({file:e})=>e),f=[...d,...a],p=new Set([i.default.resolve(e)]);for(let t of f){let n=i.default.dirname(t);for(;n.startsWith(i.default.resolve(e))&&(p.add(n),n!==i.default.resolve(e));)n=i.default.dirname(n)}let m=await Promise.all([...p].sort().map(async e=>{try{return[e,(await c.default.stat(e)).mtimeMs]}catch{return null}})),h={version:1,files:d,directoryMetaFiles:a,directories:Object.fromEntries(m.filter(e=>e!==null))};return await L(t,h),h}async function z(e,t,n){let r=Array(e.length),i=0;async function a(){for(;i<e.length;){let t=i++;r[t]=await n(e[t])}}return await Promise.all(Array.from({length:Math.min(t,e.length)},()=>a())),r}function B(e,t){w(e,t)}function V(e,t){let n=typeof t==`string`?y(t):t;if(n){let t=e.replace(/\\/g,`/`);(i.default.basename(t)===`meta.json`||i.default.basename(t)===`_meta.json`)&&w(e,n),n.cachedNativeDocs?.[t]&&delete n.cachedNativeDocs[t],T(e,n);return}T(e)}function H(e){if(e){C(e);return}C()}async function U(e,n,r,a=!1,o,s){let c=o??y(e);if(c.disposed)throw Error(`[boltdocs] Route cache context has been disposed.`);let l=_(n,r);if(s&&s.fingerprint!==l)throw Error(`[boltdocs] Route cache variant does not match the requested route configuration fingerprint.`);if(s&&c.variants.get(l)!==s)throw Error(`[boltdocs] Route cache variant does not belong to the requested route cache context.`);let u=c.activeGenerations.get(l);if(u)return u;let d=s??h(c,l),f=c.generationEpoch,p=(async()=>{let o=r||n?.base||`/docs`;await d.docCache.load();let s,l=await R(e,d,a||t.o().noCache);s=l.files.filter(r=>n?.experimental?.fileRouting?!t.u(i.default.relative(e,r)).split(`/`).includes(`pages-external`):!0);let u=l.directoryMetaFiles;d.cachedFileList=s,d.cachedDirectoryMetaFiles=u,d.directoryMeta=await F(e,u,d),g(c,d),d.docCache.pruneStale(new Set(s));let p=process.env.NODE_ENV===`test`||process.env.VITEST===`true`,m,h=!0;for(let e of s)if(!d.docCache.get(e)){h=!1;break}if(h)m=s.map(e=>{let t=d.docCache.get(e);if(!t)throw Error(`[boltdocs] Route cache entry disappeared for ${e}`);return t});else{if(!p&&!d.cachedNativeDocs)try{let{runParser:t}=await import(`@bdocs/parser`);d.cachedNativeDocs=await t(e,!0)}catch{}if(!p&&d.cachedNativeDocs!==null&&d.cachedNativeDocs){let{parseDocFileWithNative:t}=await Promise.resolve().then(()=>require(`./native-nLA4Jr0T.cjs`)),r=s.filter(e=>!d.cachedNativeDocs?.[e.replace(/\\/g,`/`)]);if(r.length>0)try{let{runParserFiles:t}=await import(`@bdocs/parser`),n=await t(e,r,!0);d.cachedNativeDocs={...d.cachedNativeDocs,...n}}catch{}let i=s.some(e=>!d.cachedNativeDocs?.[e.replace(/\\/g,`/`)])?(await Promise.resolve().then(()=>require(`./parser-vPaKvzLp.cjs`))).parseDocFile:void 0;m=await z(s,32,async r=>{let a=d.docCache.get(r);if(a)return a;let s=r.replace(/\\/g,`/`),c=d.cachedNativeDocs[s];if(c){let i=await t(r,c,e,o,n,d.parserCache);return d.docCache.set(r,i),i}else{if(!i)throw Error(`[boltdocs] Native parser did not return a document for ${r}`);let t=await i(r,e,o,n,d.parserCache);return d.docCache.set(r,t),t}})}else{let{parseDocFile:t}=await Promise.resolve().then(()=>require(`./parser-vPaKvzLp.cjs`));m=await z(s,32,async r=>{let i=d.docCache.get(r);if(i)return i;let a=await t(r,e,o,n,d.parserCache);return d.docCache.set(r,a),a})}}if(c.generationEpoch!==f)throw P;for(let e of m)M(e.route.componentPath,k(e.route.frontmatter||{}),c,d);d.docCache.save();let _=[],v=new Map,y=process.env.NODE_ENV||`development`,b=n?.drafts?.visible||process.env.BOLTDOCS_DRAFTS===`true`||(n?.drafts?.environments?.includes(y)??!1);for(let e of m)if(!(e.route.draft&&!b)){if(e.route.featureFlags&&n?.featureFlags){if(!e.route.featureFlags.every(e=>{let t=n.featureFlags?.[e];return t===!0||t===y}))continue}else if(e.route.featureFlags&&!n?.featureFlags)continue;if(e.inferredCollection){let t=e.inferredCollection;v.has(t)||v.set(t,[]),v.get(t).push(e)}else _.push(e)}let x=new Map,S=[],C=n?.i18n?.defaultLocale||``;for(let e of _)if(e.isGroupIndex&&e.relativeDir&&S.push(e),e.relativeDir){let n=`${e.route.locale||C}:${e.relativeDir}`,r=x.get(n);r?r.position===void 0&&e.inferredGroupPosition!==void 0&&(r.position=e.inferredGroupPosition):(r={title:t.t(e.relativeDir),position:e.inferredGroupPosition},x.set(n,r))}for(let e of S){let t=`${e.route.locale||C}:${e.relativeDir}`,n=x.get(t);e.groupMeta&&(n.title=e.groupMeta.title,e.groupMeta.position!==void 0&&(n.position=e.groupMeta.position),e.groupMeta.icon&&(n.icon=e.groupMeta.icon))}if(n?.theme?.sidebarGroups){let e=n.i18n?Array.isArray(n.i18n.locales)?n.i18n.locales:Object.keys(n.i18n.locales):[C];for(let[r,i]of Object.entries(n.theme.sidebarGroups))for(let n of e){let e=`${n}:${r}`,a=x.get(e),o;typeof i.title==`string`?o=i.title:i.title&&(o=i.title[n]||i.title[C]),a?(o&&(a.title=o),i.icon&&(a.icon=i.icon)):x.set(e,{title:o||t.t(r),icon:i.icon})}}let w=Array(_.length);for(let e=0;e<_.length;e++){let n=_[e],r=n.relativeDir,i=n.route.locale||C,a=r?`${i}:${r}`:void 0,o=a?x.get(a):void 0,s;o&&(s=typeof o.title==`string`?o.title:o.title[i]||o.title[C]),w[e]={...n.route,group:r,groupTitle:s||(r?t.t(r):void 0),groupPosition:o?.position,groupIcon:o?.icon}}let T=[];for(let[,e]of v)for(let t of e)T.push({...t.route,collection:t.inferredCollection});T.sort((e,t)=>{let n=e=>{if(!e)return-1/0;let t=new Date(e).getTime();return Number.isFinite(t)?t:-1/0},r=n(e.date),i=n(t.date)-r;return i===0?e.path.localeCompare(t.path):i});let D=w;if(n?.i18n){let e=W(w,n,o,d.localizedPathCache);D=[...w,...e]}let O=[...E(D),...T];if(c.generationEpoch!==f)throw P;return O})();c.activeGenerations.set(l,p);try{return await p}catch(t){if(t!==P)throw t;if(c.disposed)throw Error(`[boltdocs] Route cache context was disposed during generation.`);d.docCache.invalidateAll(),d.parserCache.clear(),c.activeGenerations.get(l)===p&&c.activeGenerations.delete(l);let i=0;for(;i<10;)try{return await U(e,n,r,a,c)}catch(e){if(e!==P)throw e;if(c.disposed)throw Error(`[boltdocs] Route cache context was disposed during generation.`);i++}throw Error(`[boltdocs] Route generation was repeatedly invalidated by concurrent file changes.`)}finally{c.activeGenerations.get(l)===p&&c.activeGenerations.delete(l)}}function W(e,t,n,r){let i=t.i18n;if(!i)return[];let a=i.defaultLocale,o=Array.isArray(i.locales)?i.locales:Object.keys(i.locales),s=[],c=new Map,l=[];for(let t of e){let e=t.locale||a,n=c.get(e);n||(n=new Set,c.set(e,n)),n.add(t.path),e===a&&l.push(t)}for(let e of o){if(e===a)continue;let i=c.get(e)||new Set;for(let o of l){let c=G(o.path,a,e,n,t,r);c!==o.path&&(i.has(c)||s.push({...o,path:c,locale:e}))}}return s}function G(e,t,n,r,i,a){let o=`${e}:${n}`,s=a.get(o);if(s)return s;let c=r.startsWith(`/`)?r:`/`+r,l=c;if(i?.versions){let t=i.versions.prefix||``;for(let n of i.versions.versions){let r=`${c}/${t+n.path}`;if(e.startsWith(r)){l=r;break}let i=`${c}/${n.path}`;if(e.startsWith(i)){l=i;break}}}let u=e.substring(l.length),d=`/${t}`;if(u.startsWith(d+`/`))u=`/`+n+`/`+u.substring(d.length+1);else if(u===d)u=`/`+n;else if(u===`/`||u===``)u=`/`+n;else{let e=u.startsWith(`/`)?``:`/`;u=`/`+n+e+u}let f=l+u;return a.size>2e3&&a.clear(),a.set(o,f),f}Object.defineProperty(exports,`a`,{enumerable:!0,get:function(){return A}}),Object.defineProperty(exports,`c`,{enumerable:!0,get:function(){return M}}),Object.defineProperty(exports,`d`,{enumerable:!0,get:function(){return y}}),Object.defineProperty(exports,`f`,{enumerable:!0,get:function(){return h}}),Object.defineProperty(exports,`i`,{enumerable:!0,get:function(){return H}}),Object.defineProperty(exports,`l`,{enumerable:!0,get:function(){return v}}),Object.defineProperty(exports,`m`,{enumerable:!0,get:function(){return w}}),Object.defineProperty(exports,`n`,{enumerable:!0,get:function(){return B}}),Object.defineProperty(exports,`o`,{enumerable:!0,get:function(){return j}}),Object.defineProperty(exports,`p`,{enumerable:!0,get:function(){return _}}),Object.defineProperty(exports,`r`,{enumerable:!0,get:function(){return V}}),Object.defineProperty(exports,`s`,{enumerable:!0,get:function(){return N}}),Object.defineProperty(exports,`t`,{enumerable:!0,get:function(){return U}}),Object.defineProperty(exports,`u`,{enumerable:!0,get:function(){return x}});
+const e=require(`./chunk-D1Md3oWO.cjs`),t=require(`./utils-ej6_SjIZ.cjs`),n=require(`./node/cache.cjs`),r=require(`./cache-CJE9nWLE.cjs`);let i=require(`node:path`);i=e.r(i);let a=require(`node:fs`);a=e.r(a);let o=require(`node:crypto`);o=e.r(o);let s=require(`@bdocs/dui`),c=require(`node:fs/promises`);c=e.r(c);let l=require(`fdir`);function u(e){return i.default.resolve(e)}function d(e,t){return o.default.createHash(`sha1`).update(`${u(e)}:${t}`).digest(`hex`).slice(0,16)}function f(e,a,o){let s=d(e,o),c=t.o();return{fingerprint:o,docCache:new n.FileCache({name:`routes-${s}`,root:a}),parserCache:new r.t(a,s),cachedFileList:null,localizedPathCache:new Map,cachedNativeDocs:null,frontmatterHashes:new Map,directoryMeta:null,cachedDirectoryMetaFiles:null,directoryMetaEntries:new Map,discoverySnapshot:null,discoverySnapshotLoaded:!1,discoverySnapshotPath:i.default.resolve(a,c.dir,`route-discovery-${s}.json`)}}function p(e,t=i.default.dirname(i.default.resolve(e))){let n=u(e),r=i.default.resolve(t),a=f(n,r,`legacy`);return{docsDir:n,cacheRoot:r,docCache:a.docCache,parserCache:a.parserCache,cachedFileList:a.cachedFileList,localizedPathCache:a.localizedPathCache,cachedNativeDocs:a.cachedNativeDocs,frontmatterHashes:a.frontmatterHashes,directoryMeta:a.directoryMeta,cachedDirectoryMetaFiles:a.cachedDirectoryMetaFiles,variants:new Map([[`legacy`,a]]),activeVariant:a,activeGenerations:new Map,generationEpoch:0,disposed:!1}}const m=new Map;function h(e,t,n=!1){if(e.disposed)throw Error(`[boltdocs] Route cache context has been disposed.`);let r=e.variants.get(t);if(!r&&(r=f(e.docsDir,e.cacheRoot,t),e.variants.set(t,r),e.variants.size>8)){for(let[n,r]of e.variants)if(!(n===t||r===e.activeVariant)&&!e.activeGenerations.has(n)){e.variants.delete(n);break}}return n&&(e.activeVariant=r,e.docCache=r.docCache,e.parserCache=r.parserCache,e.cachedFileList=r.cachedFileList,e.localizedPathCache=r.localizedPathCache,e.cachedNativeDocs=r.cachedNativeDocs,e.frontmatterHashes=r.frontmatterHashes,e.directoryMeta=r.directoryMeta,e.cachedDirectoryMetaFiles=r.cachedDirectoryMetaFiles),r}function g(e,t){e.activeVariant===t&&(e.cachedFileList=t.cachedFileList,e.cachedNativeDocs=t.cachedNativeDocs,e.frontmatterHashes=t.frontmatterHashes,e.directoryMeta=t.directoryMeta,e.cachedDirectoryMetaFiles=t.cachedDirectoryMetaFiles)}function _(e,t){return o.default.createHash(`sha1`).update(JSON.stringify({basePath:t||e?.base||`/docs`,i18n:e?.i18n,versions:e?.versions,drafts:e?.drafts,featureFlags:e?.featureFlags,fileRouting:e?.experimental?.fileRouting,sidebarGroups:e?.theme?.sidebarGroups})).digest(`hex`)}function v(e,t){let n=u(e),r=m.get(n),i=t??r;(!i||r===i)&&m.delete(n),i&&(i.disposed=!0,i.generationEpoch++,i.activeGenerations.clear(),i.variants.clear(),i.activeVariant=null,i.cachedFileList=null,i.localizedPathCache.clear(),i.cachedNativeDocs=null,i.frontmatterHashes.clear(),i.directoryMeta=null,i.cachedDirectoryMetaFiles=null)}function y(e){let t=u(e),n=m.get(t);return n||(n=p(t),m.set(t,n)),n}const b=p(i.default.resolve(process.cwd(),`docs`)),x=b.docCache;function S(e){try{a.default.rmSync(e.discoverySnapshotPath,{force:!0})}catch{}}function C(e){let t=typeof e==`string`?y(e):e??b;for(let e of t.variants.values())e.cachedFileList=null,e.localizedPathCache.clear(),e.cachedNativeDocs=null,e.frontmatterHashes.clear(),e.directoryMeta=null,e.cachedDirectoryMetaFiles=null,e.discoverySnapshot=null,e.discoverySnapshotLoaded=!1,S(e),e.docCache.invalidateAll(),e.parserCache.clear();t.cachedFileList=null,t.localizedPathCache.clear(),t.cachedNativeDocs=null,t.frontmatterHashes.clear(),t.directoryMeta=null,t.cachedDirectoryMetaFiles=null,t.generationEpoch++}function w(e,t){let n=typeof t==`string`?y(t):t??b,r=i.default.resolve(e);for(let e of n.variants.values()){for(let t of e.directoryMetaEntries.keys())i.default.resolve(t)===r&&e.directoryMetaEntries.delete(t);e.directoryMeta=null,e.cachedDirectoryMetaFiles=null,e.discoverySnapshot=null,e.discoverySnapshotLoaded=!1,S(e)}n.directoryMeta=null,n.cachedDirectoryMetaFiles=null,n.generationEpoch++}function T(e,t){let n=typeof t==`string`?y(t):t??b;for(let t of n.variants.values())t.docCache.invalidate(e),t.parserCache.invalidate(e),t.cachedNativeDocs?.[e.replace(/\\/g,`/`)]&&delete t.cachedNativeDocs[e.replace(/\\/g,`/`)],t.frontmatterHashes.delete(e);n.cachedNativeDocs=n.activeVariant?.cachedNativeDocs??null,n.frontmatterHashes.delete(e),n.generationEpoch++}function E(e){return e.sort((e,t)=>{let n=e.group?e.groupPosition??999:e.sidebarPosition??999,r=t.group?t.groupPosition??999:t.sidebarPosition??999;return n===r?!e.group&&t.group?-1:e.group&&!t.group?1:e.group&&t.group&&e.group!==t.group?(e.groupTitle||e.group).localeCompare(t.groupTitle||t.group):D(e,t):n-r})}function D(e,t){if(e.sidebarPosition!==void 0&&t.sidebarPosition!==void 0){let n=e.sidebarPosition-t.sidebarPosition;if(n!==0)return n}else if(e.sidebarPosition!==void 0)return-1;else if(t.sidebarPosition!==void 0)return 1;let n=e.title.localeCompare(t.title);return n===0?e.path.localeCompare(t.path):n}const O=new Map;function k(e){let{lastUpdated:t,...n}=e;return o.default.createHash(`md5`).update(JSON.stringify(n)).digest(`hex`)}async function A(e){try{let{data:n}=await t.d(e);return k(n)}catch{return``}}function j(e,t,n){let r=n?.frontmatterHashes??t?.frontmatterHashes??O,i=r.get(e);if(i===void 0){let a=(n?.docCache??t?.docCache??x).getStale(e);a?.route?.frontmatter&&(i=k(a.route.frontmatter),r.set(e,i))}return i}function M(e,t,n,r){(r?.frontmatterHashes??n?.frontmatterHashes??O).set(e,t)}function N(e,t,n){(n?.frontmatterHashes??t?.frontmatterHashes??O).delete(e)}const P=Symbol(`route-generation-invalidated`);async function F(e,t,n){let r=[...t].sort((e,t)=>{if(i.default.dirname(e)===i.default.dirname(t)){let n=i.default.basename(e),r=i.default.basename(t);if(n===`_meta.json`&&r===`meta.json`)return-1;if(n===`meta.json`&&r===`_meta.json`)return 1}return e.localeCompare(t)}),a=new Set(r),o=n.directoryMetaEntries;for(let e of o.keys())a.has(e)||o.delete(e);await Promise.all(r.map(async e=>{let t;try{t=await c.default.stat(e)}catch(t){o.delete(e),(0,s.warn)(`Failed to stat meta.json: ${t instanceof Error?t.message:String(t)}`);return}let n=o.get(e);if(!(n&&n.mtimeMs===t.mtimeMs&&n.size===t.size))try{let n=await c.default.readFile(e,`utf8`);o.set(e,{mtimeMs:t.mtimeMs,size:t.size,content:JSON.parse(n)})}catch(t){o.delete(e),(0,s.warn)(`Failed to read meta.json: ${t instanceof Error?t.message:String(t)}`)}}));let l={};for(let t of r){let n=o.get(t);if(!n)continue;let r=i.default.relative(e,i.default.dirname(t)).replace(/\\/g,`/`);l[r||`.`]=n.content}return l}async function I(e,n){if(!n.discoverySnapshotPath||t.o().noCache)return null;if(n.discoverySnapshotLoaded)return n.discoverySnapshot;n.discoverySnapshotLoaded=!0;try{let t=await c.default.readFile(n.discoverySnapshotPath,`utf8`),r=JSON.parse(t),a=e=>Array.isArray(e)&&e.every(e=>typeof e==`string`),o=r.files,s=r.directoryMetaFiles,l=r.directories&&typeof r.directories==`object`?Object.entries(r.directories):[],u=i.default.resolve(e),d=await c.default.realpath(u),f=e=>{let t=i.default.resolve(e);return t===u||t.startsWith(`${u}${i.default.sep}`)},p=e=>/\.(?:md|mdx)$/i.test(e),m=e=>{let t=i.default.basename(e);return t===`meta.json`||t===`_meta.json`};if(r.version!==1||!a(o)||!a(s)||!r.directories||typeof r.directories!=`object`||Array.isArray(r.directories)||o.some(e=>!f(e)||!p(e))||s.some(e=>!f(e)||!m(e))||l.some(([e,t])=>!f(e)||typeof t!=`number`||!Number.isFinite(t)))return null;let h=e=>{let t=i.default.resolve(e);return t===d||t.startsWith(`${d}${i.default.sep}`)},g=await Promise.all([...o,...s].map(async e=>{try{return(await c.default.lstat(e)).isFile()?h(await c.default.realpath(e)):!1}catch{return!1}})),_=await Promise.all(l.map(async([e,t])=>{try{let n=await c.default.stat(e);return n.isDirectory()&&n.mtimeMs===t&&h(await c.default.realpath(e))}catch{return!1}}));if(g.every(Boolean)&&_.every(Boolean)){let e={version:1,files:o,directoryMetaFiles:s,directories:Object.fromEntries(l)};return n.discoverySnapshot=e,e}}catch{}return null}async function L(e,n){if(t.o().noCache){e.discoverySnapshot=null,e.discoverySnapshotLoaded=!1;return}e.discoverySnapshot=n,e.discoverySnapshotLoaded=!0;try{await c.default.mkdir(i.default.dirname(e.discoverySnapshotPath),{recursive:!0}),await c.default.writeFile(e.discoverySnapshotPath,JSON.stringify(n))}catch{}}async function R(e,t,n){if(!n){let n=await I(e,t);if(n)return n}let r=await new l.fdir({excludeSymlinks:!0}).withFullPaths().filter(t=>{let n=i.default.basename(t),r=n===`meta.json`||n===`_meta.json`;return!(t.endsWith(`.md`)||t.endsWith(`.mdx`))&&!r?!1:!i.default.relative(e,t).replace(/\\/g,`/`).split(`/`).some(e=>e.startsWith(`_`)&&e!==`_index.md`&&e!==`_index.mdx`&&e!==`_meta.json`)}).crawl(e).withPromise(),a=r.filter(e=>{let t=i.default.basename(e);return t===`meta.json`||t===`_meta.json`}).sort((e,t)=>e.localeCompare(t)),o=r.filter(e=>e.endsWith(`.md`)||e.endsWith(`.mdx`)),s=[/index\./i,/intro/i,/getting-started/i,/readme/i],u=o.map(e=>{let t=s.findIndex(t=>t.test(i.default.basename(e)));return{file:e,score:t===-1?2**53-1:t}});u.sort((e,t)=>e.score-t.score||e.file.localeCompare(t.file));let d=u.map(({file:e})=>e),f=[...d,...a],p=new Set([i.default.resolve(e)]);for(let t of f){let n=i.default.dirname(t);for(;n.startsWith(i.default.resolve(e))&&(p.add(n),n!==i.default.resolve(e));)n=i.default.dirname(n)}let m=await Promise.all([...p].sort().map(async e=>{try{return[e,(await c.default.stat(e)).mtimeMs]}catch{return null}})),h={version:1,files:d,directoryMetaFiles:a,directories:Object.fromEntries(m.filter(e=>e!==null))};return await L(t,h),h}async function z(e,t,n){let r=Array(e.length),i=0;async function a(){for(;i<e.length;){let t=i++;r[t]=await n(e[t])}}return await Promise.all(Array.from({length:Math.min(t,e.length)},()=>a())),r}function B(e,t){w(e,t)}function V(e,t){let n=typeof t==`string`?y(t):t;if(n){let t=e.replace(/\\/g,`/`);(i.default.basename(t)===`meta.json`||i.default.basename(t)===`_meta.json`)&&w(e,n),n.cachedNativeDocs?.[t]&&delete n.cachedNativeDocs[t],T(e,n);return}T(e)}function H(e){if(e){C(e);return}C()}async function U(e,n,r,a=!1,o,s){let c=o??y(e);if(c.disposed)throw Error(`[boltdocs] Route cache context has been disposed.`);let l=_(n,r);if(s&&s.fingerprint!==l)throw Error(`[boltdocs] Route cache variant does not match the requested route configuration fingerprint.`);if(s&&c.variants.get(l)!==s)throw Error(`[boltdocs] Route cache variant does not belong to the requested route cache context.`);let u=c.activeGenerations.get(l);if(u)return u;let d=s??h(c,l),f=c.generationEpoch,p=(async()=>{let o=r||n?.base||`/docs`;await d.docCache.load();let s,l=await R(e,d,a||t.o().noCache);s=l.files.filter(r=>n?.experimental?.fileRouting?!t.u(i.default.relative(e,r)).split(`/`).includes(`pages-external`):!0);let u=l.directoryMetaFiles;d.cachedFileList=s,d.cachedDirectoryMetaFiles=u,d.directoryMeta=await F(e,u,d),g(c,d),d.docCache.pruneStale(new Set(s));let p=process.env.NODE_ENV===`test`||process.env.VITEST===`true`,m,h=!0;for(let e of s)if(!d.docCache.get(e)){h=!1;break}if(h)m=s.map(e=>{let t=d.docCache.get(e);if(!t)throw Error(`[boltdocs] Route cache entry disappeared for ${e}`);return t});else{if(!p&&!d.cachedNativeDocs)try{let{runParser:t}=await import(`@bdocs/parser`);d.cachedNativeDocs=await t(e,!0)}catch{}if(!p&&d.cachedNativeDocs!==null&&d.cachedNativeDocs){let{parseDocFileWithNative:t}=await Promise.resolve().then(()=>require(`./native-BbtRkce5.cjs`)),r=s.filter(e=>!d.cachedNativeDocs?.[e.replace(/\\/g,`/`)]);if(r.length>0)try{let{runParserFiles:t}=await import(`@bdocs/parser`),n=await t(e,r,!0);d.cachedNativeDocs={...d.cachedNativeDocs,...n}}catch{}let i=s.some(e=>!d.cachedNativeDocs?.[e.replace(/\\/g,`/`)])?(await Promise.resolve().then(()=>require(`./parser-DJLWTiO-.cjs`))).parseDocFile:void 0;m=await z(s,32,async r=>{let a=d.docCache.get(r);if(a)return a;let s=r.replace(/\\/g,`/`),c=d.cachedNativeDocs[s];if(c){let i=await t(r,c,e,o,n,d.parserCache);return d.docCache.set(r,i),i}else{if(!i)throw Error(`[boltdocs] Native parser did not return a document for ${r}`);let t=await i(r,e,o,n,d.parserCache);return d.docCache.set(r,t),t}})}else{let{parseDocFile:t}=await Promise.resolve().then(()=>require(`./parser-DJLWTiO-.cjs`));m=await z(s,32,async r=>{let i=d.docCache.get(r);if(i)return i;let a=await t(r,e,o,n,d.parserCache);return d.docCache.set(r,a),a})}}if(c.generationEpoch!==f)throw P;for(let e of m)M(e.route.componentPath,k(e.route.frontmatter||{}),c,d);d.docCache.save();let _=[],v=new Map,y=process.env.NODE_ENV||`development`,b=n?.drafts?.visible||process.env.BOLTDOCS_DRAFTS===`true`||(n?.drafts?.environments?.includes(y)??!1);for(let e of m)if(!(e.route.draft&&!b)){if(e.route.featureFlags&&n?.featureFlags){if(!e.route.featureFlags.every(e=>{let t=n.featureFlags?.[e];return t===!0||t===y}))continue}else if(e.route.featureFlags&&!n?.featureFlags)continue;if(e.inferredCollection){let t=e.inferredCollection;v.has(t)||v.set(t,[]),v.get(t).push(e)}else _.push(e)}let x=new Map,S=[],C=n?.i18n?.defaultLocale||``;for(let e of _)if(e.isGroupIndex&&e.relativeDir&&S.push(e),e.relativeDir){let n=`${e.route.locale||C}:${e.relativeDir}`,r=x.get(n);r?r.position===void 0&&e.inferredGroupPosition!==void 0&&(r.position=e.inferredGroupPosition):(r={title:t.t(e.relativeDir),position:e.inferredGroupPosition},x.set(n,r))}for(let e of S){let t=`${e.route.locale||C}:${e.relativeDir}`,n=x.get(t);e.groupMeta&&(n.title=e.groupMeta.title,e.groupMeta.position!==void 0&&(n.position=e.groupMeta.position),e.groupMeta.icon&&(n.icon=e.groupMeta.icon))}if(n?.theme?.sidebarGroups){let e=n.i18n?Array.isArray(n.i18n.locales)?n.i18n.locales:Object.keys(n.i18n.locales):[C];for(let[r,i]of Object.entries(n.theme.sidebarGroups))for(let n of e){let e=`${n}:${r}`,a=x.get(e),o;typeof i.title==`string`?o=i.title:i.title&&(o=i.title[n]||i.title[C]),a?(o&&(a.title=o),i.icon&&(a.icon=i.icon)):x.set(e,{title:o||t.t(r),icon:i.icon})}}let w=Array(_.length);for(let e=0;e<_.length;e++){let n=_[e],r=n.relativeDir,i=n.route.locale||C,a=r?`${i}:${r}`:void 0,o=a?x.get(a):void 0,s;o&&(s=typeof o.title==`string`?o.title:o.title[i]||o.title[C]),w[e]={...n.route,group:r,groupTitle:s||(r?t.t(r):void 0),groupPosition:o?.position,groupIcon:o?.icon}}let T=[];for(let[,e]of v)for(let t of e)T.push({...t.route,collection:t.inferredCollection});T.sort((e,t)=>{let n=e=>{if(!e)return-1/0;let t=new Date(e).getTime();return Number.isFinite(t)?t:-1/0},r=n(e.date),i=n(t.date)-r;return i===0?e.path.localeCompare(t.path):i});let D=w;if(n?.i18n){let e=W(w,n,o,d.localizedPathCache);D=[...w,...e]}let O=[...E(D),...T];if(c.generationEpoch!==f)throw P;return O})();c.activeGenerations.set(l,p);try{return await p}catch(t){if(t!==P)throw t;if(c.disposed)throw Error(`[boltdocs] Route cache context was disposed during generation.`);d.docCache.invalidateAll(),d.parserCache.clear(),c.activeGenerations.get(l)===p&&c.activeGenerations.delete(l);let i=0;for(;i<10;)try{return await U(e,n,r,a,c)}catch(e){if(e!==P)throw e;if(c.disposed)throw Error(`[boltdocs] Route cache context was disposed during generation.`);i++}throw Error(`[boltdocs] Route generation was repeatedly invalidated by concurrent file changes.`)}finally{c.activeGenerations.get(l)===p&&c.activeGenerations.delete(l)}}function W(e,t,n,r){let i=t.i18n;if(!i)return[];let a=i.defaultLocale,o=Array.isArray(i.locales)?i.locales:Object.keys(i.locales),s=[],c=new Map,l=[];for(let t of e){let e=t.locale||a,n=c.get(e);n||(n=new Set,c.set(e,n)),n.add(t.path),e===a&&l.push(t)}for(let e of o){if(e===a)continue;let i=c.get(e)||new Set;for(let o of l){let c=G(o.path,a,e,n,t,r);c!==o.path&&(i.has(c)||s.push({...o,path:c,locale:e}))}}return s}function G(e,t,n,r,i,a){let o=`${e}:${n}`,s=a.get(o);if(s)return s;let c=r.startsWith(`/`)?r:`/`+r,l=c;if(i?.versions){let t=i.versions.prefix||``;for(let n of i.versions.versions){let r=`${c}/${t+n.path}`;if(e.startsWith(r)){l=r;break}let i=`${c}/${n.path}`;if(e.startsWith(i)){l=i;break}}}let u=e.substring(l.length),d=`/${t}`;if(u.startsWith(d+`/`))u=`/`+n+`/`+u.substring(d.length+1);else if(u===d)u=`/`+n;else if(u===`/`||u===``)u=`/`+n;else{let e=u.startsWith(`/`)?``:`/`;u=`/`+n+e+u}let f=l+u;return a.size>2e3&&a.clear(),a.set(o,f),f}Object.defineProperty(exports,`a`,{enumerable:!0,get:function(){return A}}),Object.defineProperty(exports,`c`,{enumerable:!0,get:function(){return M}}),Object.defineProperty(exports,`d`,{enumerable:!0,get:function(){return y}}),Object.defineProperty(exports,`f`,{enumerable:!0,get:function(){return h}}),Object.defineProperty(exports,`i`,{enumerable:!0,get:function(){return H}}),Object.defineProperty(exports,`l`,{enumerable:!0,get:function(){return v}}),Object.defineProperty(exports,`m`,{enumerable:!0,get:function(){return w}}),Object.defineProperty(exports,`n`,{enumerable:!0,get:function(){return B}}),Object.defineProperty(exports,`o`,{enumerable:!0,get:function(){return j}}),Object.defineProperty(exports,`p`,{enumerable:!0,get:function(){return _}}),Object.defineProperty(exports,`r`,{enumerable:!0,get:function(){return V}}),Object.defineProperty(exports,`s`,{enumerable:!0,get:function(){return N}}),Object.defineProperty(exports,`t`,{enumerable:!0,get:function(){return U}}),Object.defineProperty(exports,`u`,{enumerable:!0,get:function(){return x}});