boltdocs 3.2.2 → 3.3.1

package/dist/search-dialog-DRiXejws.js

@@ -0,0 +1,501 @@
+/**
+ * Boltdocs - https://boltdocs.vercel.app
+ * Copyright (c) 2026 Jesus Alcala
+ * Licensed under the MIT License.
+ */
+import { R as Search, V as X, W as useConfig, l as useRoutesContext, o as cn, q as useBoltdocsContext, u as normalizePath } from "./link-CgdI6O2o.js";
+import { E as useLocation, O as useNavigate } from "./router-CZBxMRAH.js";
+import { i as ErrorBoundary, n as Navbar, t as SearchDialog$1 } from "./search-dialog-BqkzDTq2.js";
+import { useCallback, useEffect, useMemo, useRef, useState } from "react";
+import { Fragment as Fragment$1, jsx, jsxs } from "react/jsx-runtime";
+import { Index } from "flexsearch";
+import fetchSearchData from "virtual:boltdocs-search";
+
+//#region src/client/hooks/use-routes.ts
+/**
+* Hook to access the framework's routing state.
+* Returns both the complete set of routes and a filtered list based on the current
+* version and locale.
+*/
+function useRoutes() {
+	const routeContext = useRoutesContext();
+	const allRoutes = routeContext.routes;
+	const routeIndex = routeContext.index || {
+		byPath: new Map(allRoutes.map((route) => [normalizePath(route.path), route])),
+		hintsByPath: /* @__PURE__ */ new Map(),
+		collectionNames: []
+	};
+	const config = useConfig();
+	const location = useLocation();
+	const { pathname } = location;
+	const { currentLocale: currentLocaleStore, currentVersion: currentVersionStore } = useBoltdocsContext();
+	const currentPath = normalizePath(pathname);
+	const currentRoute = routeIndex.byPath.get(currentPath);
+	const pathParts = pathname.split("/").filter(Boolean);
+	const urlLocale = config.i18n ? pathParts.find((part) => Array.isArray(config.i18n?.locales) ? config.i18n?.locales.includes(part) : part in (config.i18n?.locales || {})) : void 0;
+	const currentLocale = config.i18n ? urlLocale || currentLocaleStore || config.i18n.defaultLocale : void 0;
+	const configuredVersions = config.versions?.versions || [];
+	const currentVersion = config.versions ? configuredVersions.some((version) => version.path === currentVersionStore) ? currentVersionStore : config.versions.defaultVersion : void 0;
+	const routes = useMemo(() => {
+		if (!allRoutes) return [];
+		const alternateCounts = /* @__PURE__ */ new Map();
+		const defaultLocale = config.i18n?.defaultLocale || "";
+		const defaultVersion = config.versions?.defaultVersion || "";
+		for (const r of allRoutes) {
+			const locale = r.locale || defaultLocale;
+			const version = r.version || defaultVersion;
+			const key = `${r.filePath}::${locale}::${version}`;
+			alternateCounts.set(key, (alternateCounts.get(key) || 0) + 1);
+		}
+		return allRoutes.filter((r) => {
+			const localeMatch = config.i18n ? (r.locale || config.i18n.defaultLocale) === currentLocale : true;
+			const versionMatch = config.versions ? (r.version || config.versions.defaultVersion) === currentVersion : true;
+			if (!(localeMatch && versionMatch)) return false;
+			const pathParts = pathname.split("/").filter(Boolean);
+			const isCurrentLocalePrefixed = !!(config.i18n && pathParts.includes(currentLocaleStore || config.i18n.defaultLocale));
+			const isCurrentVersionPrefixed = !!(config.versions && !!currentVersion && pathParts.includes(currentVersion));
+			const isRouteLocalePrefixed = !!r.locale;
+			const isRouteVersionPrefixed = !!r.version;
+			const locale = r.locale || defaultLocale;
+			const version = r.version || defaultVersion;
+			const key = `${r.filePath}::${locale}::${version}`;
+			if ((alternateCounts.get(key) || 0) > 1) {
+				const localeMismatch = config.i18n && isCurrentLocalePrefixed !== isRouteLocalePrefixed;
+				const versionMismatch = config.versions && isCurrentVersionPrefixed !== isRouteVersionPrefixed;
+				if (localeMismatch || versionMismatch) return false;
+			}
+			return true;
+		});
+	}, [
+		allRoutes,
+		config,
+		pathname,
+		currentLocale,
+		currentVersion,
+		currentLocaleStore
+	]);
+	const collections = useMemo(() => new Set(routeIndex.collectionNames), [routeIndex.collectionNames]);
+	return {
+		routes,
+		allRoutes,
+		currentRoute,
+		isCollectionPage: !!currentRoute?.collection || location.pathname.split("/").filter(Boolean).some((segment) => collections.has(segment.toLowerCase())),
+		currentLocale,
+		currentVersion
+	};
+}
+
+//#endregion
+//#region src/client/components/internal/error-boundary.tsx
+function InternalFallback({ error, resetErrorBoundary, className }) {
+	return /* @__PURE__ */ jsxs("div", {
+		role: "alert",
+		className: cn("p-2 font-mono flex flex-col items-center justify-between min-h-[30vh]", className),
+		children: [
+			/* @__PURE__ */ jsx("p", {
+				className: "text-lg font-semibold text-danger-500",
+				children: "Something went wrong"
+			}),
+			error?.message && /* @__PURE__ */ jsx("pre", {
+				className: "text-sm mt-2 max-w-md overflow-auto whitespace-pre-wrap break-word",
+				children: error.message
+			}),
+			error?.stack && /* @__PURE__ */ jsxs("details", {
+				className: "mt-2 max-w-md text-left text-xs",
+				children: [/* @__PURE__ */ jsx("summary", {
+					className: "cursor-pointer text-muted select-none outline-none",
+					children: "Error details"
+				}), /* @__PURE__ */ jsx("pre", {
+					className: "mt-2 p-2 bg-soft rounded border-subtle border overflow-auto max-h-48 whitespace-pre-wrap break-words",
+					children: error.stack
+				})]
+			}),
+			/* @__PURE__ */ jsxs("div", {
+				className: "flex items-center gap-2 mt-2",
+				children: [/* @__PURE__ */ jsx("button", {
+					type: "button",
+					onClick: resetErrorBoundary,
+					className: "px-2 py-3 bg-soft rounded border-subtle border font-mono font-semibold text-body hover:scale-105 transition-transform active:scale-95 cursor-pointer",
+					children: "Try again"
+				}), typeof window !== "undefined" && /* @__PURE__ */ jsx("button", {
+					type: "button",
+					onClick: () => window.location.reload(),
+					className: "px-2 py-3 rounded font-mono font-semibold text-muted hover:text-body transition-colors cursor-pointer",
+					children: "Reload page"
+				})]
+			})
+		]
+	});
+}
+function InternalErrorBoundary({ children, fallback, resetKeys }) {
+	return /* @__PURE__ */ jsx(ErrorBoundary, {
+		fallback,
+		resetKeys,
+		FallbackComponent: !fallback ? InternalFallback : void 0,
+		children
+	});
+}
+
+//#endregion
+//#region src/client/hooks/use-search.ts
+function useSearch(routes) {
+	const { currentLocale, currentVersion } = useRoutes();
+	const config = useConfig();
+	const algoliaConfig = config.integrations?.search?.algolia;
+	const [isOpen, setIsOpen] = useState(false);
+	const [query, setQuery] = useState("");
+	const [index, setIndex] = useState(null);
+	const [algoliaResults, setAlgoliaResults] = useState([]);
+	const [searchData, setSearchData] = useState([]);
+	const [searchDataLoading, setSearchDataLoading] = useState(false);
+	const [searchDataError, setSearchDataError] = useState(null);
+	const searchGeneration = useRef(0);
+	const loadingGeneration = useRef(null);
+	const navigate = useNavigate();
+	useEffect(() => {
+		if (algoliaConfig || !isOpen) return;
+		if (searchData.length > 0) return;
+		setSearchDataLoading(true);
+		setSearchDataError(null);
+		let active = true;
+		const generation = ++searchGeneration.current;
+		loadingGeneration.current = generation;
+		fetchSearchData().then((data) => {
+			if (!active || generation !== searchGeneration.current) return;
+			setSearchData(data || []);
+			if (loadingGeneration.current === generation) {
+				loadingGeneration.current = null;
+				setSearchDataLoading(false);
+			}
+		}).catch((err) => {
+			if (!active || generation !== searchGeneration.current) return;
+			console.error("[boltdocs] Failed to load search index:", err);
+			setSearchDataError(err);
+			if (loadingGeneration.current === generation) {
+				loadingGeneration.current = null;
+				setSearchDataLoading(false);
+			}
+		});
+		return () => {
+			active = false;
+		};
+	}, [
+		isOpen,
+		algoliaConfig,
+		searchData.length
+	]);
+	useEffect(() => {
+		if (!import.meta.hot) return;
+		const applyFrontmatterDelta = (payload) => {
+			const updated = payload.search?.updated ?? [];
+			const deleted = new Set(payload.search?.deleted ?? []);
+			searchGeneration.current += 1;
+			if (loadingGeneration.current !== null) {
+				loadingGeneration.current = null;
+				setSearchDataLoading(false);
+			}
+			setSearchData((prev) => {
+				const map = new Map(prev.map((d) => [d.id, d]));
+				for (const doc of updated) map.set(doc.id, doc);
+				for (const id of deleted) map.delete(id);
+				return Array.from(map.values());
+			});
+			setIndex(null);
+		};
+		const refreshFromAsset = async () => {
+			const generation = ++searchGeneration.current;
+			loadingGeneration.current = generation;
+			setSearchDataLoading(true);
+			try {
+				const data = await fetchSearchData({ bustCache: true });
+				if (generation !== searchGeneration.current) return;
+				setSearchData(data || []);
+				setSearchDataError(null);
+				setIndex(null);
+			} catch (error) {
+				if (generation !== searchGeneration.current) return;
+				console.error("[boltdocs] Failed to refresh search index:", error);
+				setSearchDataError(error instanceof Error ? error : new Error(String(error)));
+			} finally {
+				if (generation === searchGeneration.current) {
+					loadingGeneration.current = null;
+					setSearchDataLoading(false);
+				}
+			}
+		};
+		const hot = import.meta.hot;
+		hot.on("boltdocs:frontmatter-update", applyFrontmatterDelta);
+		hot.on("boltdocs:mdx-update", refreshFromAsset);
+		return () => {
+			hot.off?.("boltdocs:frontmatter-update", applyFrontmatterDelta);
+			hot.off?.("boltdocs:mdx-update", refreshFromAsset);
+		};
+	}, []);
+	useEffect(() => {
+		const handleKeyDown = (e) => {
+			if ((/Mac/.test(navigator.userAgent) ? e.metaKey : e.ctrlKey) && (e.key === "k" || e.key === "j")) {
+				e.preventDefault();
+				setIsOpen((prev) => !prev);
+			}
+		};
+		window.addEventListener("keydown", handleKeyDown);
+		return () => window.removeEventListener("keydown", handleKeyDown);
+	}, []);
+	const handleSelect = useCallback((key) => {
+		const path = String(key);
+		if (!path) return;
+		setIsOpen(false);
+		const url = new URL(path, window.location.origin);
+		if (query) url.searchParams.set("hl", query);
+		navigate(`${url.pathname}${url.search}${url.hash}`);
+	}, [navigate, query]);
+	useEffect(() => {
+		if (algoliaConfig) return;
+		if (!isOpen || searchData.length === 0 || index) return;
+		const newIndex = new Index({
+			tokenize: "forward",
+			cache: true
+		});
+		for (let i = 0; i < searchData.length; i++) {
+			const doc = searchData[i];
+			if (!doc) continue;
+			newIndex.add(i, `${doc.title} ${doc.content}`);
+		}
+		setIndex(newIndex);
+	}, [
+		isOpen,
+		index,
+		algoliaConfig,
+		searchData
+	]);
+	useEffect(() => {
+		if (!algoliaConfig) return;
+		if (!query) {
+			setAlgoliaResults([]);
+			return;
+		}
+		const delayDebounceFn = setTimeout(async () => {
+			try {
+				const url = `https://${algoliaConfig.appId}-dsn.algolia.net/1/indexes/${algoliaConfig.indexName}/query`;
+				const facetFilters = [];
+				if (currentLocale) facetFilters.push(`lang:${currentLocale}`);
+				if (currentVersion) facetFilters.push(`version:${currentVersion}`);
+				let params = `query=${encodeURIComponent(query)}&hitsPerPage=20`;
+				if (facetFilters.length > 0) params += `&facetFilters=${encodeURIComponent(JSON.stringify(facetFilters))}`;
+				const response = await fetch(url, {
+					method: "POST",
+					headers: {
+						"Content-Type": "application/json",
+						"X-Algolia-API-Key": algoliaConfig.apiKey,
+						"X-Algolia-Application-Id": algoliaConfig.appId
+					},
+					body: JSON.stringify({ params })
+				});
+				if (!response.ok) throw new Error(`Algolia search request failed: ${response.statusText}`);
+				setAlgoliaResults(((await response.json()).hits || []).map((hit) => {
+					let path = hit.url || "";
+					try {
+						if (path.startsWith("http://") || path.startsWith("https://")) {
+							const urlObj = new URL(path);
+							path = urlObj.pathname + urlObj.search + urlObj.hash;
+						}
+					} catch {}
+					const hierarchy = hit.hierarchy || {};
+					const levels = [
+						hierarchy.lvl0,
+						hierarchy.lvl1,
+						hierarchy.lvl2,
+						hierarchy.lvl3,
+						hierarchy.lvl4,
+						hierarchy.lvl5,
+						hierarchy.lvl6
+					].filter(Boolean);
+					const title = levels[levels.length - 1] || "Documentation";
+					const bio = levels.join(" > ");
+					return {
+						id: hit.objectID || path,
+						title,
+						path,
+						bio,
+						groupTitle: hierarchy.lvl0 || "Docs",
+						isHeading: !!hit.anchor || path.includes("#")
+					};
+				}));
+			} catch (err) {
+				console.error("Error fetching search results from Algolia:", err);
+			}
+		}, 250);
+		return () => clearTimeout(delayDebounceFn);
+	}, [
+		query,
+		algoliaConfig,
+		currentLocale,
+		currentVersion
+	]);
+	return {
+		isOpen,
+		setIsOpen,
+		query,
+		setQuery,
+		list: useMemo(() => {
+			if (!query) return routes.filter((r) => {
+				const routeLocale = r.locale || config.i18n?.defaultLocale;
+				const routeVersion = r.version || config.versions?.defaultVersion;
+				return (!currentLocale || routeLocale === currentLocale) && (!currentVersion || routeVersion === currentVersion);
+			}).slice(0, 10).map((r) => ({
+				id: r.path,
+				title: r.title,
+				path: r.path,
+				bio: r.description || "",
+				groupTitle: r.groupTitle
+			}));
+			if (algoliaConfig) return algoliaResults;
+			if (!index) return [];
+			const searchResults = index.search(query, {
+				limit: 20,
+				suggest: true
+			});
+			const results = [];
+			const seen = /* @__PURE__ */ new Set();
+			for (const id of searchResults) {
+				const doc = searchData[typeof id === "number" ? id : Number(id)];
+				if (!doc) continue;
+				const docLocale = doc.locale || config.i18n?.defaultLocale;
+				const docVersion = doc.version || config.versions?.defaultVersion;
+				const localeMatch = !currentLocale || docLocale === currentLocale || !doc.locale && currentLocale === config.i18n?.defaultLocale;
+				if (!(!currentVersion || docVersion === currentVersion)) continue;
+				if (seen.has(doc.url)) continue;
+				seen.add(doc.url);
+				results.push({
+					id: doc.url,
+					title: doc.title,
+					path: doc.url,
+					bio: doc.display,
+					groupTitle: doc.display.split(" > ")[0],
+					isHeading: doc.url.includes("#"),
+					localeMatch
+				});
+			}
+			return results.filter((result) => result.localeMatch).slice(0, 10);
+		}, [
+			query,
+			index,
+			currentLocale,
+			currentVersion,
+			routes,
+			searchData,
+			algoliaConfig,
+			algoliaResults,
+			config
+		]),
+		searchDataLoading,
+		searchDataError,
+		handleSelect,
+		input: {
+			value: query,
+			onChange: (e) => setQuery(e.target.value)
+		}
+	};
+}
+
+//#endregion
+//#region src/client/components/ui-base/search-dialog.tsx
+function Highlight({ text, query, markClassName }) {
+	if (!query || !text) return /* @__PURE__ */ jsx(Fragment$1, { children: text });
+	const escapedQuery = query.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+	const regex = new RegExp(`(${escapedQuery})`, "gi");
+	return /* @__PURE__ */ jsx(Fragment$1, { children: text.split(regex).map((part, i) => regex.test(part) ? /* @__PURE__ */ jsx("mark", {
+		className: cn("bg-primary-500/20 text-primary-600 dark:text-primary-400 font-bold px-0.5 rounded-sm", markClassName),
+		children: part
+	}, i) : part) });
+}
+function SearchDialog({ routes, className, markClassName }) {
+	const { isOpen, setIsOpen, query, setQuery, list, searchDataLoading, searchDataError, handleSelect } = useSearch(routes);
+	return /* @__PURE__ */ jsxs(Fragment$1, { children: [
+		/* @__PURE__ */ jsxs(Navbar.SearchTrigger.Desktop, {
+			onPress: () => setIsOpen(true),
+			className: "rounded-xl border border-subtle bg-surface text-muted transition-all duration-200 hover:border-primary-500/50 hover:text-body hover:bg-soft/50 hover:shadow-sm active:scale-[0.98] focus-visible:ring-2 focus-visible:ring-primary-500/30",
+			children: [/* @__PURE__ */ jsxs("div", {
+				className: "flex items-center gap-2",
+				children: [/* @__PURE__ */ jsx(Search, { size: 16 }), /* @__PURE__ */ jsx("span", {
+					className: "hidden sm:inline-block",
+					children: "Search docs..."
+				})]
+			}), /* @__PURE__ */ jsx(Navbar.SearchTrigger.Kbd, { className: "[&_kbd]:bg-main [&_kbd]:border [&_kbd]:border-subtle [&_kbd]:rounded [&_kbd]:px-1.5 [&_kbd]:h-5 [&_kbd]:w-5" })]
+		}),
+		/* @__PURE__ */ jsx(Navbar.SearchTrigger.Mobile, {
+			onPress: () => setIsOpen(true),
+			className: "rounded-xl text-muted transition-all duration-200 hover:text-body active:scale-95 focus-visible:ring-2 focus-visible:ring-primary-500/30",
+			children: /* @__PURE__ */ jsx(Search, { size: 20 })
+		}),
+		/* @__PURE__ */ jsx(InternalErrorBoundary, { children: /* @__PURE__ */ jsx(SearchDialog$1.Overlay, {
+			isOpen,
+			isDismissable: true,
+			onOpenChange: () => setIsOpen(false),
+			className: cn("fixed inset-0 z-100 flex items-center justify-center p-4 bg-black/40 backdrop-blur-xs animate-fade-in", className),
+			children: /* @__PURE__ */ jsx(SearchDialog$1.Content, {
+				className: "w-full max-w-lg bg-main border border-subtle shadow-md rounded-2xl overflow-hidden p-6",
+				children: /* @__PURE__ */ jsx(SearchDialog$1.Dialog, {
+					"aria-label": "Search documentation",
+					className: "flex flex-col min-h-0 h-[450px]",
+					children: /* @__PURE__ */ jsxs(SearchDialog$1.Autocomplete, {
+						className: "flex flex-col min-h-0",
+						children: [/* @__PURE__ */ jsxs(SearchDialog$1.Input, {
+							value: query,
+							onChange: setQuery,
+							className: "flex items-center gap-2 border border-subtle bg-surface px-4 py-2.5 rounded-xl focus-within:border-primary-500 mb-4",
+							children: [/* @__PURE__ */ jsx(SearchDialog$1.Input.SearchInput, {
+								placeholder: "Search documentation...",
+								className: "w-full bg-transparent outline-none text-body text-sm"
+							}), query && /* @__PURE__ */ jsx(SearchDialog$1.Input.Button, {
+								onPress: () => setQuery(""),
+								className: "text-muted hover:text-body hover:bg-surface rounded-md p-1 cursor-pointer select-none transition-colors",
+								children: /* @__PURE__ */ jsx(X, { size: 16 })
+							})]
+						}), searchDataLoading ? /* @__PURE__ */ jsx("div", {
+							className: "flex flex-1 items-center justify-center px-4 py-8 text-sm text-muted",
+							children: "Loading search index…"
+						}) : searchDataError ? /* @__PURE__ */ jsx("div", {
+							className: "flex flex-1 items-center justify-center px-4 py-8 text-center text-sm text-muted",
+							children: "Search is temporarily unavailable."
+						}) : query && list.length === 0 ? /* @__PURE__ */ jsx("div", {
+							className: "flex flex-1 items-center justify-center px-4 py-8 text-sm text-muted",
+							children: "No results found."
+						}) : /* @__PURE__ */ jsx(SearchDialog$1.List, {
+							items: list,
+							onAction: handleSelect,
+							children: (item) => /* @__PURE__ */ jsxs(SearchDialog$1.Item, {
+								textValue: item.title,
+								className: "flex items-center gap-3 px-4 py-2 rounded-xl group dark:hover:bg-primary-300/40 hover:bg-primary-200/50 transition-colors duration-100",
+								children: [/* @__PURE__ */ jsx(SearchDialog$1.Item.Icon, {
+									isHeading: item.isHeading,
+									className: "text-muted group-hover:text-primary-500 group-focus:text-primary-500"
+								}), /* @__PURE__ */ jsxs("div", {
+									className: "flex flex-col justify-center min-w-0",
+									children: [/* @__PURE__ */ jsx(SearchDialog$1.Item.Title, {
+										className: "text-sm font-medium text-body truncate dark:group-hover:text-primary-100",
+										children: /* @__PURE__ */ jsx(Highlight, {
+											text: item.title,
+											query,
+											markClassName
+										})
+									}), /* @__PURE__ */ jsx(SearchDialog$1.Item.Bio, {
+										className: "text-xs text-muted truncate",
+										children: /* @__PURE__ */ jsx(Highlight, {
+											text: item.bio,
+											query,
+											markClassName
+										})
+									})]
+								})]
+							}, item.id)
+						})]
+					})
+				})
+			})
+		}) })
+	] });
+}
+
+//#endregion
+export { useRoutes as i, useSearch as n, InternalErrorBoundary as r, SearchDialog as t };

package/dist/{search-dialog-DHqwjJuG.cjs → search-dialog-DmirOMPg.cjs}

@@ -3,6 +3,6 @@
  * Copyright (c) 2026 Jesus Alcala
  * Licensed under the MIT License.
  */
-const require_search_dialog = require('./search-dialog-BRFno7HD.cjs');
+const require_search_dialog = require('./search-dialog-D3jtaw6w.cjs');
 
 exports.SearchDialog = require_search_dialog.SearchDialog;

package/dist/{search-dialog-D6TvjcuV.js → search-dialog-MmwxFMmE.js}

@@ -3,6 +3,6 @@
  * Copyright (c) 2026 Jesus Alcala
  * Licensed under the MIT License.
  */
-import { t as SearchDialog } from "./search-dialog-BmxHiKwt.js";
+import { t as SearchDialog } from "./search-dialog-DRiXejws.js";
 
 export { SearchDialog };