boltdocs 3.3.6 → 3.4.0

package/dist/{link-q1qHNGK_.js → link-CSe_oD8Y.js}

@@ -3,8 +3,8 @@
  * Copyright (c) 2026 Jesus Alcala
  * Licensed under the MIT License.
  */
-import { E as useLocation, O as useNavigate, c as hasUriScheme, h as resolveUrlReference, k as usePrefetch, l as hasUrlBase, m as parseUrlReference } from "./router-CZBxMRAH.js";
-import { createContext, use, useCallback, useEffect, useMemo, useState } from "react";
+import { E as useLocation, O as useNavigate, V as useConfig, c as hasUriScheme, h as resolveUrlReference, k as usePrefetch, l as hasUrlBase, m as parseUrlReference, z as useViewTransition } from "./router-B5e8k4qK.js";
+import React, { createContext, use, useCallback, useEffect, useMemo, useState } from "react";
 import { Fragment as Fragment$1, jsx, jsxs } from "react/jsx-runtime";
 import { clsx } from "clsx";
 import { twMerge } from "tailwind-merge";
@@ -39,10 +39,10 @@ function getSavedPrefs() {
 		return {};
 	}
 }
-const globalRegistry$1 = globalThis;
-const existingContext = globalRegistry$1[BOLTDOCS_CONTEXT_SYMBOL];
+const globalRegistry = globalThis;
+const existingContext = globalRegistry[BOLTDOCS_CONTEXT_SYMBOL];
 const BoltdocsContext = existingContext || createContext(void 0);
-if (!existingContext) Reflect.set(globalRegistry$1, BOLTDOCS_CONTEXT_SYMBOL, BoltdocsContext);
+if (!existingContext) Reflect.set(globalRegistry, BOLTDOCS_CONTEXT_SYMBOL, BoltdocsContext);
 function BoltdocsProvider({ children, initialLocale = "", initialVersion = "" }) {
 	const [locale, setLocaleState] = useState(() => {
 		if (initialLocale) return initialLocale;
@@ -65,7 +65,7 @@ function BoltdocsProvider({ children, initialLocale = "", initialVersion = "" })
 			return newL;
 		});
 		if (typeof globalThis !== "undefined") Reflect.set(globalThis, BOLTDOCS_INSTANCE_SYMBOL, {
-			...globalRegistry$1[BOLTDOCS_INSTANCE_SYMBOL],
+			...globalRegistry[BOLTDOCS_INSTANCE_SYMBOL],
 			currentLocale: newL
 		});
 		if (typeof window !== "undefined") try {
@@ -83,7 +83,7 @@ function BoltdocsProvider({ children, initialLocale = "", initialVersion = "" })
 			return newV;
 		});
 		if (typeof globalThis !== "undefined") Reflect.set(globalThis, BOLTDOCS_INSTANCE_SYMBOL, {
-			...globalRegistry$1[BOLTDOCS_INSTANCE_SYMBOL],
+			...globalRegistry[BOLTDOCS_INSTANCE_SYMBOL],
 			currentVersion: newV
 		});
 		if (typeof window !== "undefined") try {
@@ -122,41 +122,6 @@ function useBoltdocsContext() {
 	return context;
 }
 
-//#endregion
-//#region src/client/app/config-context.tsx
-/**
-* Context for the global documentation configuration.
-* Using a global singleton pattern to survive dual-package or duplicated-code hazards.
-*/
-const CONFIG_CONTEXT_SYMBOL = Symbol.for("__BDOCS_CONFIG_CONTEXT__");
-const CONFIG_INSTANCE_SYMBOL = Symbol.for("__BDOCS_CONFIG_INSTANCE__");
-const globalRegistry = globalThis;
-const existingConfigContext = globalRegistry[CONFIG_CONTEXT_SYMBOL];
-const ConfigContext = existingConfigContext || createContext(null);
-if (!existingConfigContext) globalRegistry[CONFIG_CONTEXT_SYMBOL] = ConfigContext;
-/**
-* Hook to access the Boltdocs configuration when one is available.
-*
-* Low-level primitives such as icons can also be rendered standalone (for
-* example in a component preview or a unit test), so they must not be forced
-* to mount the full application provider just to render an inline SVG.
-*/
-function useOptionalConfig() {
-	const context = use(ConfigContext);
-	if (context) return context;
-	const globalConfig = globalRegistry[CONFIG_INSTANCE_SYMBOL];
-	if (globalConfig) return globalConfig;
-	return null;
-}
-/**
-* Hook to access the Boltdocs configuration.
-*/
-function useConfig() {
-	const config = useOptionalConfig();
-	if (!config) throw new Error("useConfig must be used within a ConfigProvider");
-	return config;
-}
-
 //#endregion
 //#region src/client/components/ui-base/icons.tsx
 var icons_exports = /* @__PURE__ */ __exportAll({
@@ -564,6 +529,66 @@ const FaceBad = createIcon("FaceBad", /* @__PURE__ */ jsxs(Fragment$1, { childre
 	})
 ] }));
 
+//#endregion
+//#region src/client/router/prefetch-viewport.ts
+/**
+* Viewport-triggered route prefetching.
+*
+* Hover prefetching only warms a link once the pointer commits to it, which
+* misses the most common case: a reader scrolls the sidebar, reads a heading,
+* and clicks without ever hovering. Every destination they are plausibly
+* heading for sits on screen, untouched.
+*
+* A single shared `IntersectionObserver` watches anchors registered by
+* `Link` and fires the normal prefetch pipeline when one becomes visible, so
+* the route chunk and its loader data are already cached by the time the click
+* lands. Hover keeps working and still wins: whichever signal arrives first
+* populates `prefetchCache`, and the other is a cache hit.
+*
+* The existing prefetch queue bounds the cost (two in flight, a shallow
+* backlog) and drops work when saturated, so this stays opportunistic
+* exactly like hover prefetching is.
+*/
+/**
+* Start slightly before the link is on screen so a short scroll already feels
+* instant, without warming the whole page below the fold.
+*/
+const VIEWPORT_PREFETCH_MARGIN = "200px 0px";
+let observer = null;
+const pending = /* @__PURE__ */ new WeakMap();
+function getObserver() {
+	if (typeof window === "undefined") return null;
+	if (typeof IntersectionObserver === "undefined") return null;
+	if (observer) return observer;
+	observer = new IntersectionObserver((entries) => {
+		for (const entry of entries) {
+			if (!entry.isIntersecting) continue;
+			const run = pending.get(entry.target);
+			if (!run) continue;
+			observer?.unobserve(entry.target);
+			pending.delete(entry.target);
+			run();
+		}
+	}, { rootMargin: VIEWPORT_PREFETCH_MARGIN });
+	return observer;
+}
+/**
+* Watches `element` and invokes `run` once it approaches the viewport.
+*
+* Returns a cleanup function. Safe to call during SSR, where it is a no-op.
+*/
+function observeForPrefetch(element, run) {
+	if (!element) return () => {};
+	const target = getObserver();
+	if (!target) return () => {};
+	pending.set(element, run);
+	target.observe(element);
+	return () => {
+		target.unobserve(element);
+		pending.delete(element);
+	};
+}
+
 //#endregion
 //#region src/client/utils/path.ts
 /**
@@ -748,74 +773,6 @@ function cn(...inputs) {
 	return twMerge(clsx(inputs));
 }
 
-//#endregion
-//#region src/client/view-transitions.ts
-function resolveOptions(options) {
-	if (options?.enabled === false) return void 0;
-	return {
-		enabled: true,
-		...options?.types?.length ? { types: options.types } : {}
-	};
-}
-function isNativeViewTransitionSupported() {
-	return typeof document !== "undefined" && typeof document.startViewTransition === "function";
-}
-/**
-* Starts a native document transition when the browser supports it. On older
-* browsers, the update still runs normally and the function returns null.
-*/
-function startViewTransition(update, options) {
-	const resolved = resolveOptions(options);
-	if (typeof document === "undefined" || resolved?.enabled !== true) {
-		update();
-		return null;
-	}
-	const start = document.startViewTransition;
-	if (!start) {
-		update();
-		return null;
-	}
-	const types = options?.types;
-	return start.call(document, {
-		update,
-		...types?.length ? { types } : {}
-	});
-}
-/**
-* Returns a transition-aware runner that follows the project's experimental
-* configuration. It is safe to use in custom layouts and external pages.
-*
-* The returned value is callable for backwards compatibility:
-* `transition(() => setState(...))`. It also exposes `run` and `start` aliases
-* for discoverability in editor autocomplete.
-*/
-function useViewTransition() {
-	const configured = useOptionalConfig()?.experimental?.viewTransitions;
-	const enabled = configured === true || typeof configured === "object" && configured.enabled === true;
-	const supported = isNativeViewTransitionSupported();
-	const run = useCallback((update, options) => {
-		if (!enabled && options?.enabled !== true) {
-			update();
-			return null;
-		}
-		const configuredTypes = typeof configured === "object" ? configured.types : void 0;
-		return startViewTransition(update, {
-			...options,
-			types: options?.types || configuredTypes
-		});
-	}, [configured, enabled]);
-	return useMemo(() => Object.assign(run, {
-		run,
-		start: run,
-		enabled,
-		supported
-	}), [
-		enabled,
-		run,
-		supported
-	]);
-}
-
 //#endregion
 //#region src/client/components/primitives/link.tsx
 /**
@@ -843,7 +800,7 @@ function Link(props) {
 		}
 	};
 	const handlePrefetch = () => {
-		if (prefetch === "hover" && localizedHref) prefetchRoute(localizedHref);
+		if (prefetch !== "none" && localizedHref) prefetchRoute(localizedHref);
 	};
 	const handleMouseEnter = (e) => {
 		onMouseEnter?.(e);
@@ -853,9 +810,25 @@ function Link(props) {
 		onFocus?.(e);
 		handlePrefetch();
 	};
+	const anchorRef = React.useRef(null);
+	const setRef = React.useCallback((node) => {
+		anchorRef.current = node;
+		if (typeof ref === "function") ref(node);
+		else if (ref) ref.current = node;
+	}, [ref]);
+	React.useEffect(() => {
+		if (prefetch !== "viewport" || !localizedHref) return;
+		return observeForPrefetch(anchorRef.current, () => {
+			prefetchRoute(localizedHref);
+		});
+	}, [
+		prefetch,
+		localizedHref,
+		prefetchRoute
+	]);
 	return /* @__PURE__ */ jsx("a", {
 		...rest,
-		ref,
+		ref: setRef,
 		href: localizedHref,
 		target: linkTarget,
 		download,
@@ -894,4 +867,4 @@ function NavLink(props) {
 }
 
 //#endregion
-export { Info as A, Sun as B, ExternalLink as C, FileText as D, FaceRegular as E, Monitor as F, useConfig as G, X as H, Moon as I, useBoltdocsContext as J, useOptionalConfig as K, MoreVertical as L, Lightbulb as M, Link$1 as N, Hash as O, Menu as P, Pencil as R, CornerDownLeft as S, FaceGood as T, icons_exports as U, TextAlignStart as V, ConfigContext as W, ChevronDown as _, useViewTransition as a, CircleHelp as b, RoutesProvider as c, normalizePath as d, resolvePublicAssetUrl as f, Check as g, ArrowLeft as h, startViewTransition as i, Languages as j, Home as k, createRouteIndex as l, AlertTriangle as m, NavLink as n, cn as o, AlertCircle as p, BoltdocsProvider as q, TransitionLink as r, useLocalizedTo as s, Link as t, useRoutesContext as u, ChevronLeft as v, FaceBad as w, Copy as x, ChevronRight as y, Search as z };
+export { Lightbulb as A, X as B, FaceGood as C, Home as D, Hash as E, MoreVertical as F, BoltdocsProvider as H, Pencil as I, Search as L, Menu as M, Monitor as N, Info as O, Moon as P, Sun as R, FaceBad as S, FileText as T, useBoltdocsContext as U, icons_exports as V, ChevronRight as _, useLocalizedTo as a, CornerDownLeft as b, useRoutesContext as c, AlertCircle as d, AlertTriangle as f, ChevronLeft as g, ChevronDown as h, cn as i, Link$1 as j, Languages as k, normalizePath as l, Check as m, NavLink as n, RoutesProvider as o, ArrowLeft as p, TransitionLink as r, createRouteIndex as s, Link as t, resolvePublicAssetUrl as u, CircleHelp as v, FaceRegular as w, ExternalLink as x, Copy as y, TextAlignStart as z };

package/dist/{link-hLWOsx0x.cjs → link-Xb69Oy2F.cjs}

@@ -3,8 +3,9 @@
  * Copyright (c) 2026 Jesus Alcala
  * Licensed under the MIT License.
  */
-const require_router = require('./router-C3kygdRK.cjs');
+const require_router = require('./router-DKC0Lu0n.cjs');
 let react = require("react");
+react = require_router.__toESM(react);
 let react_jsx_runtime = require("react/jsx-runtime");
 let clsx = require("clsx");
 let tailwind_merge = require("tailwind-merge");
@@ -22,10 +23,10 @@ function getSavedPrefs() {
 		return {};
 	}
 }
-const globalRegistry$1 = globalThis;
-const existingContext = globalRegistry$1[BOLTDOCS_CONTEXT_SYMBOL];
+const globalRegistry = globalThis;
+const existingContext = globalRegistry[BOLTDOCS_CONTEXT_SYMBOL];
 const BoltdocsContext = existingContext || (0, react.createContext)(void 0);
-if (!existingContext) Reflect.set(globalRegistry$1, BOLTDOCS_CONTEXT_SYMBOL, BoltdocsContext);
+if (!existingContext) Reflect.set(globalRegistry, BOLTDOCS_CONTEXT_SYMBOL, BoltdocsContext);
 function BoltdocsProvider({ children, initialLocale = "", initialVersion = "" }) {
 	const [locale, setLocaleState] = (0, react.useState)(() => {
 		if (initialLocale) return initialLocale;
@@ -48,7 +49,7 @@ function BoltdocsProvider({ children, initialLocale = "", initialVersion = "" })
 			return newL;
 		});
 		if (typeof globalThis !== "undefined") Reflect.set(globalThis, BOLTDOCS_INSTANCE_SYMBOL, {
-			...globalRegistry$1[BOLTDOCS_INSTANCE_SYMBOL],
+			...globalRegistry[BOLTDOCS_INSTANCE_SYMBOL],
 			currentLocale: newL
 		});
 		if (typeof window !== "undefined") try {
@@ -66,7 +67,7 @@ function BoltdocsProvider({ children, initialLocale = "", initialVersion = "" })
 			return newV;
 		});
 		if (typeof globalThis !== "undefined") Reflect.set(globalThis, BOLTDOCS_INSTANCE_SYMBOL, {
-			...globalRegistry$1[BOLTDOCS_INSTANCE_SYMBOL],
+			...globalRegistry[BOLTDOCS_INSTANCE_SYMBOL],
 			currentVersion: newV
 		});
 		if (typeof window !== "undefined") try {
@@ -105,41 +106,6 @@ function useBoltdocsContext() {
 	return context;
 }
 
-//#endregion
-//#region src/client/app/config-context.tsx
-/**
-* Context for the global documentation configuration.
-* Using a global singleton pattern to survive dual-package or duplicated-code hazards.
-*/
-const CONFIG_CONTEXT_SYMBOL = Symbol.for("__BDOCS_CONFIG_CONTEXT__");
-const CONFIG_INSTANCE_SYMBOL = Symbol.for("__BDOCS_CONFIG_INSTANCE__");
-const globalRegistry = globalThis;
-const existingConfigContext = globalRegistry[CONFIG_CONTEXT_SYMBOL];
-const ConfigContext = existingConfigContext || (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/components/ui-base/icons.tsx
 var icons_exports = /* @__PURE__ */ require_router.__exportAll({
@@ -547,6 +513,66 @@ const FaceBad = createIcon("FaceBad", /* @__PURE__ */ (0, react_jsx_runtime.jsxs
 	})
 ] }));
 
+//#endregion
+//#region src/client/router/prefetch-viewport.ts
+/**
+* Viewport-triggered route prefetching.
+*
+* Hover prefetching only warms a link once the pointer commits to it, which
+* misses the most common case: a reader scrolls the sidebar, reads a heading,
+* and clicks without ever hovering. Every destination they are plausibly
+* heading for sits on screen, untouched.
+*
+* A single shared `IntersectionObserver` watches anchors registered by
+* `Link` and fires the normal prefetch pipeline when one becomes visible, so
+* the route chunk and its loader data are already cached by the time the click
+* lands. Hover keeps working and still wins: whichever signal arrives first
+* populates `prefetchCache`, and the other is a cache hit.
+*
+* The existing prefetch queue bounds the cost (two in flight, a shallow
+* backlog) and drops work when saturated, so this stays opportunistic
+* exactly like hover prefetching is.
+*/
+/**
+* Start slightly before the link is on screen so a short scroll already feels
+* instant, without warming the whole page below the fold.
+*/
+const VIEWPORT_PREFETCH_MARGIN = "200px 0px";
+let observer = null;
+const pending = /* @__PURE__ */ new WeakMap();
+function getObserver() {
+	if (typeof window === "undefined") return null;
+	if (typeof IntersectionObserver === "undefined") return null;
+	if (observer) return observer;
+	observer = new IntersectionObserver((entries) => {
+		for (const entry of entries) {
+			if (!entry.isIntersecting) continue;
+			const run = pending.get(entry.target);
+			if (!run) continue;
+			observer?.unobserve(entry.target);
+			pending.delete(entry.target);
+			run();
+		}
+	}, { rootMargin: VIEWPORT_PREFETCH_MARGIN });
+	return observer;
+}
+/**
+* Watches `element` and invokes `run` once it approaches the viewport.
+*
+* Returns a cleanup function. Safe to call during SSR, where it is a no-op.
+*/
+function observeForPrefetch(element, run) {
+	if (!element) return () => {};
+	const target = getObserver();
+	if (!target) return () => {};
+	pending.set(element, run);
+	target.observe(element);
+	return () => {
+		target.unobserve(element);
+		pending.delete(element);
+	};
+}
+
 //#endregion
 //#region src/client/utils/path.ts
 /**
@@ -668,7 +694,7 @@ function RoutesProvider({ routes: initialRoutes, children }) {
 //#endregion
 //#region src/client/hooks/use-localized-to.ts
 function useLocalizedTo(to) {
-	const config = useConfig();
+	const config = require_router.useConfig();
 	const routeContext = useRoutesContext();
 	const routeIndex = routeContext.index || {
 		byPath: new Map(routeContext.routes.map((route) => [route.path, route])),
@@ -731,74 +757,6 @@ 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
 /**
@@ -810,7 +768,7 @@ function Link(props) {
 	const target = href ?? to ?? "";
 	const navigate = require_router.useNavigate();
 	const prefetchRoute = require_router.usePrefetch();
-	const runTransition = useViewTransition();
+	const runTransition = require_router.useViewTransition();
 	const localizedHref = useLocalizedTo(target);
 	const handleClick = (e) => {
 		onClick?.(e);
@@ -826,7 +784,7 @@ function Link(props) {
 		}
 	};
 	const handlePrefetch = () => {
-		if (prefetch === "hover" && localizedHref) prefetchRoute(localizedHref);
+		if (prefetch !== "none" && localizedHref) prefetchRoute(localizedHref);
 	};
 	const handleMouseEnter = (e) => {
 		onMouseEnter?.(e);
@@ -836,9 +794,25 @@ function Link(props) {
 		onFocus?.(e);
 		handlePrefetch();
 	};
+	const anchorRef = react.default.useRef(null);
+	const setRef = react.default.useCallback((node) => {
+		anchorRef.current = node;
+		if (typeof ref === "function") ref(node);
+		else if (ref) ref.current = node;
+	}, [ref]);
+	react.default.useEffect(() => {
+		if (prefetch !== "viewport" || !localizedHref) return;
+		return observeForPrefetch(anchorRef.current, () => {
+			prefetchRoute(localizedHref);
+		});
+	}, [
+		prefetch,
+		localizedHref,
+		prefetchRoute
+	]);
 	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("a", {
 		...rest,
-		ref,
+		ref: setRef,
 		href: localizedHref,
 		target: linkTarget,
 		download,
@@ -931,12 +905,6 @@ Object.defineProperty(exports, 'CircleHelp', {
     return CircleHelp;
   }
 });
-Object.defineProperty(exports, 'ConfigContext', {
-  enumerable: true,
-  get: function () {
-    return ConfigContext;
-  }
-});
 Object.defineProperty(exports, 'Copy', {
   enumerable: true,
   get: function () {
@@ -1123,45 +1091,21 @@ Object.defineProperty(exports, 'resolvePublicAssetUrl', {
     return resolvePublicAssetUrl;
   }
 });
-Object.defineProperty(exports, 'startViewTransition', {
-  enumerable: true,
-  get: function () {
-    return startViewTransition;
-  }
-});
 Object.defineProperty(exports, 'useBoltdocsContext', {
   enumerable: true,
   get: function () {
     return useBoltdocsContext;
   }
 });
-Object.defineProperty(exports, 'useConfig', {
-  enumerable: true,
-  get: function () {
-    return useConfig;
-  }
-});
 Object.defineProperty(exports, 'useLocalizedTo', {
   enumerable: true,
   get: function () {
     return useLocalizedTo;
   }
 });
-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 useViewTransition;
-  }
 });