boltdocs 3.3.5 → 3.4.0

package/dist/{link-CgdI6O2o.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, {
-			...globalThis[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, {
-			...globalThis[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
 /**
@@ -590,13 +615,58 @@ function resolvePublicAssetUrl(value, base) {
 
 //#endregion
 //#region src/client/app/routes-context.tsx
+const emptyRouteIndex = {
+	byPath: /* @__PURE__ */ new Map(),
+	hintsByPath: /* @__PURE__ */ new Map(),
+	collectionNames: [],
+	byCollectionPath: /* @__PURE__ */ new Map(),
+	countsByFilePath: /* @__PURE__ */ new Map()
+};
+function getCollectionPathKey(route) {
+	if (!route.collection) return void 0;
+	const parts = normalizePath(route.path).split("/").filter(Boolean);
+	const collectionIndex = parts.indexOf(route.collection);
+	if (collectionIndex < 0) return void 0;
+	return `/${parts.slice(collectionIndex).join("/")}`;
+}
+/** Build all client route lookup structures in one cached pass. */
+function createRouteIndex(routes) {
+	const byPath = /* @__PURE__ */ new Map();
+	const hintsByPath = /* @__PURE__ */ new Map();
+	const byCollectionPath = /* @__PURE__ */ new Map();
+	const countsByFilePath = /* @__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
+		});
+		countsByFilePath.set(route.filePath, (countsByFilePath.get(route.filePath) || 0) + 1);
+		if (route.collection) {
+			collectionNames.add(route.collection);
+			const collectionPath = getCollectionPathKey(route);
+			if (collectionPath) {
+				const variants = byCollectionPath.get(collectionPath) || [];
+				variants.push(route);
+				byCollectionPath.set(collectionPath, variants);
+			}
+		}
+	}
+	return {
+		byPath,
+		hintsByPath,
+		byCollectionPath,
+		countsByFilePath,
+		collectionNames: [...collectionNames]
+	};
+}
 const RoutesContext = createContext({
 	routes: [],
-	index: {
-		byPath: /* @__PURE__ */ new Map(),
-		hintsByPath: /* @__PURE__ */ new Map(),
-		collectionNames: []
-	}
+	index: emptyRouteIndex
 });
 /**
 * Hook to access the processed routes list from the closest provider.
@@ -609,27 +679,7 @@ function useRoutesContext() {
 */
 function RoutesProvider({ routes: initialRoutes, children }) {
 	const [routes, setRoutes] = useState(initialRoutes);
-	const index = useMemo(() => {
-		const byPath = /* @__PURE__ */ new Map();
-		const hintsByPath = /* @__PURE__ */ new Map();
-		const collectionNames = /* @__PURE__ */ new Set();
-		for (const route of routes) {
-			if (!route.path) continue;
-			const path = normalizePath(route.path);
-			byPath.set(path, route);
-			hintsByPath.set(path, {
-				path: route.path,
-				kind: route.collection ? "collection" : void 0,
-				collection: route.collection
-			});
-			if (route.collection) collectionNames.add(route.collection);
-		}
-		return {
-			byPath,
-			hintsByPath,
-			collectionNames: [...collectionNames]
-		};
-	}, [routes]);
+	const index = useMemo(() => createRouteIndex(routes), [routes]);
 	useEffect(() => {
 		if (!import.meta.hot) return;
 		const handler = (payload) => {
@@ -723,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
 /**
@@ -818,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);
@@ -828,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,
@@ -869,4 +867,4 @@ function NavLink(props) {
 }
 
 //#endregion
-export { Languages as A, TextAlignStart as B, FaceBad as C, Hash as D, FileText as E, Moon as F, useOptionalConfig as G, icons_exports as H, MoreVertical as I, BoltdocsProvider as K, Pencil as L, Link$1 as M, Menu as N, Home as O, Monitor as P, Search as R, ExternalLink as S, FaceRegular as T, ConfigContext as U, X as V, useConfig as W, ChevronLeft as _, useViewTransition as a, Copy as b, RoutesProvider as c, resolvePublicAssetUrl as d, AlertCircle as f, ChevronDown as g, Check as h, startViewTransition as i, Lightbulb as j, Info as k, useRoutesContext as l, ArrowLeft as m, NavLink as n, cn as o, AlertTriangle as p, useBoltdocsContext as q, TransitionLink as r, useLocalizedTo as s, Link as t, normalizePath as u, ChevronRight as v, FaceGood as w, CornerDownLeft as x, CircleHelp as y, Sun as z };
+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 };