boltdocs 3.2.1 → 3.3.0

package/dist/{search-dialog-BRFno7HD.cjs → search-dialog-CIeIUhAn.cjs}

@@ -3,22 +3,97 @@
  * Copyright (c) 2026 Jesus Alcala
  * Licensed under the MIT License.
  */
-const require_link = require('./link-D1Gjkb-2.cjs');
-const require_search_dialog = require('./search-dialog-B1NERUNx.cjs');
+const require_router = require('./router-C3kygdRK.cjs');
+const require_link = require('./link-vZjmD-es.cjs');
+const require_search_dialog = require('./search-dialog-x_qHU8ty.cjs');
 let react = require("react");
-let react_router_dom = require("react-router-dom");
 let react_jsx_runtime = require("react/jsx-runtime");
 let flexsearch = require("flexsearch");
 let virtual_boltdocs_search = require("virtual:boltdocs-search");
-virtual_boltdocs_search = require_link.__toESM(virtual_boltdocs_search);
+virtual_boltdocs_search = require_router.__toESM(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 = require_link.useRoutesContext();
+	const allRoutes = routeContext.routes;
+	const routeIndex = routeContext.index || {
+		byPath: new Map(allRoutes.map((route) => [require_link.normalizePath(route.path), route])),
+		hintsByPath: /* @__PURE__ */ new Map(),
+		collectionNames: []
+	};
+	const config = require_link.useConfig();
+	const location = require_router.useLocation();
+	const { pathname } = location;
+	const { currentLocale: currentLocaleStore, currentVersion: currentVersionStore } = require_link.useBoltdocsContext();
+	const currentPath = require_link.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 = (0, react.useMemo)(() => {
+		if (!allRoutes) return [];
+		const alternateCounts = /* @__PURE__ */ new Map();
+		const defaultLocale = config.i18n?.defaultLocale || "";
+		const defaultVersion = config.versions?.defaultVersion || "";
+		for (const r of allRoutes) {
+			const locale = r.locale || defaultLocale;
+			const version = r.version || defaultVersion;
+			const key = `${r.filePath}::${locale}::${version}`;
+			alternateCounts.set(key, (alternateCounts.get(key) || 0) + 1);
+		}
+		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 = (0, react.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 }) {
+function InternalFallback({ error, resetErrorBoundary, className }) {
 	return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
-		className: "p-2 font-mono flex flex-col items-center justify-between min-h-[30vh]",
+		className: require_link.cn("p-2 font-mono flex flex-col items-center justify-between min-h-[30vh]", className),
 		children: [
 			/* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
-				className: "text-lg font-semibold text-red-500",
+				className: "text-lg font-semibold text-danger-500",
 				children: "Something went wrong"
 			}),
 			error?.message && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("pre", {
@@ -28,7 +103,7 @@ function InternalFallback({ error, resetErrorBoundary }) {
 			/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
 				type: "button",
 				onClick: resetErrorBoundary,
-				className: "px-2 py-3 mt-2 bg-slate-100 rounded border-slate-200 border font-mono font-semibold text-slate-700 hover:scale-105 transition-transform active:scale-95 cursor-pointer",
+				className: "px-2 py-3 mt-2 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"
 			})
 		]
@@ -45,14 +120,98 @@ function InternalErrorBoundary({ children, fallback }) {
 //#endregion
 //#region src/client/hooks/use-search.ts
 function useSearch(routes) {
-	const { currentLocale, currentVersion } = require_link.useRoutes();
+	const { currentLocale, currentVersion } = useRoutes();
 	const config = require_link.useConfig();
 	const algoliaConfig = config.integrations?.search?.algolia;
 	const [isOpen, setIsOpen] = (0, react.useState)(false);
 	const [query, setQuery] = (0, react.useState)("");
 	const [index, setIndex] = (0, react.useState)(null);
 	const [algoliaResults, setAlgoliaResults] = (0, react.useState)([]);
-	const navigate = (0, react_router_dom.useNavigate)();
+	const [searchData, setSearchData] = (0, react.useState)([]);
+	const [searchDataLoading, setSearchDataLoading] = (0, react.useState)(false);
+	const [searchDataError, setSearchDataError] = (0, react.useState)(null);
+	const searchGeneration = (0, react.useRef)(0);
+	const loadingGeneration = (0, react.useRef)(null);
+	const navigate = require_router.useNavigate();
+	(0, react.useEffect)(() => {
+		if (algoliaConfig || !isOpen) return;
+		if (searchData.length > 0) return;
+		setSearchDataLoading(true);
+		setSearchDataError(null);
+		let active = true;
+		const generation = ++searchGeneration.current;
+		loadingGeneration.current = generation;
+		(0, virtual_boltdocs_search.default)().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
+	]);
+	(0, react.useEffect)(() => {
+		if (!{}.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 (0, virtual_boltdocs_search.default)({ 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 = {}.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);
+		};
+	}, []);
 	(0, react.useEffect)(() => {
 		const handleKeyDown = (e) => {
 			if ((/Mac/.test(navigator.userAgent) ? e.metaKey : e.ctrlKey) && (e.key === "k" || e.key === "j")) {
@@ -65,29 +224,30 @@ function useSearch(routes) {
 	}, []);
 	const handleSelect = (0, react.useCallback)((key) => {
 		const path = String(key);
+		if (!path) return;
 		setIsOpen(false);
-		const [baseUrl, hash] = path.split("#");
-		navigate(`${baseUrl}${query ? `?hl=${encodeURIComponent(query)}` : ""}${hash ? `#${hash}` : ""}`);
-		if (hash) setTimeout(() => {
-			const el = document.getElementById(hash);
-			if (el) el.scrollIntoView({ behavior: "smooth" });
-		}, 100);
+		const url = new URL(path, window.location.origin);
+		if (query) url.searchParams.set("hl", query);
+		navigate(`${url.pathname}${url.search}${url.hash}`);
 	}, [navigate, query]);
 	(0, react.useEffect)(() => {
 		if (algoliaConfig) return;
-		if (!isOpen || index) return;
+		if (!isOpen || searchData.length === 0 || index) return;
 		const newIndex = new flexsearch.Index({
-			preset: "match",
-			tokenize: "full",
-			resolution: 9,
+			tokenize: "forward",
 			cache: true
 		});
-		for (const doc of virtual_boltdocs_search.default) newIndex.add(doc.id, `${doc.title} ${doc.content}`);
+		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
+		algoliaConfig,
+		searchData
 	]);
 	(0, react.useEffect)(() => {
 		if (!algoliaConfig) return;
@@ -120,7 +280,7 @@ function useSearch(routes) {
 							const urlObj = new URL(path);
 							path = urlObj.pathname + urlObj.search + urlObj.hash;
 						}
-					} catch (e) {}
+					} catch {}
 					const hierarchy = hit.hierarchy || {};
 					const levels = [
 						hierarchy.lvl0,
@@ -153,11 +313,6 @@ function useSearch(routes) {
 		currentLocale,
 		currentVersion
 	]);
-	const searchDataMap = (0, react.useMemo)(() => {
-		const map = /* @__PURE__ */ new Map();
-		for (const doc of virtual_boltdocs_search.default) map.set(doc.id, doc);
-		return map;
-	}, []);
 	return {
 		isOpen,
 		setIsOpen,
@@ -184,11 +339,12 @@ function useSearch(routes) {
 			const results = [];
 			const seen = /* @__PURE__ */ new Set();
 			for (const id of searchResults) {
-				const doc = searchDataMap.get(id);
+				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;
-				if (!(!currentLocale || docLocale === currentLocale) || !(!currentVersion || docVersion === currentVersion)) continue;
+				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({
@@ -197,21 +353,24 @@ function useSearch(routes) {
 					path: doc.url,
 					bio: doc.display,
 					groupTitle: doc.display.split(" > ")[0],
-					isHeading: doc.url.includes("#")
+					isHeading: doc.url.includes("#"),
+					localeMatch
 				});
 			}
-			return results.slice(0, 10);
+			return results.filter((result) => result.localeMatch).slice(0, 10);
 		}, [
 			query,
 			index,
 			currentLocale,
 			currentVersion,
 			routes,
-			searchDataMap,
+			searchData,
 			algoliaConfig,
 			algoliaResults,
 			config
 		]),
+		searchDataLoading,
+		searchDataError,
 		handleSelect,
 		input: {
 			value: query,
@@ -222,17 +381,17 @@ function useSearch(routes) {
 
 //#endregion
 //#region src/client/components/ui-base/search-dialog.tsx
-function Highlight({ text, query }) {
+function Highlight({ text, query, markClassName }) {
 	if (!query || !text) return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(react_jsx_runtime.Fragment, { children: text });
 	const escapedQuery = query.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 	const regex = new RegExp(`(${escapedQuery})`, "gi");
 	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(react_jsx_runtime.Fragment, { children: text.split(regex).map((part, i) => regex.test(part) ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("mark", {
-		className: "bg-primary-500/20 text-primary-600 dark:text-primary-400 font-bold px-0.5 rounded-sm",
+		className: require_link.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 }) {
-	const { isOpen, setIsOpen, query, setQuery, list, handleSelect } = useSearch(routes);
+function SearchDialog({ routes, className, markClassName }) {
+	const { isOpen, setIsOpen, query, setQuery, list, searchDataLoading, searchDataError, handleSelect } = useSearch(routes);
 	return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [
 		/* @__PURE__ */ (0, react_jsx_runtime.jsxs)(require_search_dialog.Navbar.SearchTrigger.Desktop, {
 			onPress: () => setIsOpen(true),
@@ -254,14 +413,13 @@ function SearchDialog({ routes }) {
 			isOpen,
 			isDismissable: true,
 			onOpenChange: () => setIsOpen(false),
-			className: "fixed inset-0 z-100 flex items-center justify-center p-4 bg-black/40 backdrop-blur-xs animate-fade-in",
+			className: require_link.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__ */ (0, react_jsx_runtime.jsx)(require_search_dialog.SearchDialog.Content, {
 				className: "w-full max-w-lg bg-main border border-subtle shadow-md rounded-2xl overflow-hidden p-6",
 				children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_search_dialog.SearchDialog.Dialog, {
 					"aria-label": "Search documentation",
 					className: "flex flex-col min-h-0 h-[450px]",
 					children: /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(require_search_dialog.SearchDialog.Autocomplete, {
-						onSelectionChange: handleSelect,
 						className: "flex flex-col min-h-0",
 						children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)(require_search_dialog.SearchDialog.Input, {
 							value: query,
@@ -275,10 +433,19 @@ function SearchDialog({ routes }) {
 								className: "text-muted hover:text-body hover:bg-surface rounded-md p-1 cursor-pointer select-none transition-colors",
 								children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_link.X, { size: 16 })
 							})]
-						}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_search_dialog.SearchDialog.List, {
+						}), searchDataLoading ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+							className: "flex flex-1 items-center justify-center px-4 py-8 text-sm text-muted",
+							children: "Loading search index…"
+						}) : searchDataError ? /* @__PURE__ */ (0, react_jsx_runtime.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__ */ (0, react_jsx_runtime.jsx)("div", {
+							className: "flex flex-1 items-center justify-center px-4 py-8 text-sm text-muted",
+							children: "No results found."
+						}) : /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_search_dialog.SearchDialog.List, {
 							items: list,
+							onAction: handleSelect,
 							children: (item) => /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(require_search_dialog.SearchDialog.Item, {
-								onPress: () => handleSelect(item.id),
 								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__ */ (0, react_jsx_runtime.jsx)(require_search_dialog.SearchDialog.Item.Icon, {
@@ -290,13 +457,15 @@ function SearchDialog({ routes }) {
 										className: "text-sm font-medium text-body truncate dark:group-hover:text-primary-100",
 										children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(Highlight, {
 											text: item.title,
-											query
+											query,
+											markClassName
 										})
 									}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_search_dialog.SearchDialog.Item.Bio, {
 										className: "text-xs text-muted truncate",
 										children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(Highlight, {
 											text: item.bio,
-											query
+											query,
+											markClassName
 										})
 									})]
 								})]
@@ -322,6 +491,12 @@ Object.defineProperty(exports, 'SearchDialog', {
     return SearchDialog;
   }
 });
+Object.defineProperty(exports, 'useRoutes', {
+  enumerable: true,
+  get: function () {
+    return useRoutes;
+  }
+});
 Object.defineProperty(exports, 'useSearch', {
   enumerable: true,
   get: function () {

package/dist/{search-dialog-D6TvjcuV.js → search-dialog-DtmxmfEu.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-Bp_P1MPP.js";
 
 export { SearchDialog };