boltdocs 2.9.2 → 3.0.0

package/dist/client/index.js

@@ -4,11 +4,11 @@
  * Licensed under the MIT License.
  */
 import { $ as TextAlignStart, C as RoutesProvider, D as Check, E as ArrowLeft, F as FaceBad, I as FaceGood, J as Moon, K as Menu, L as FaceRegular, M as Copy, O as ChevronDown, P as ExternalLink, Q as Sun, S as normalizePath, U as Languages, V as Home, X as Pencil, _ as Link$1, at as useBoltdocsContext, b as useLocalizedTo, et as X, it as BoltdocsProvider, j as CircleHelp, nt as ConfigContext, q as Monitor, rt as useConfig, s as Github, tt as icons_exports, x as useRoutes, y as cn } from "../icons-dev-kJyGWNeg.js";
-import { c as ThemeProvider, l as useTheme } from "../image-BCDyLHyD.js";
-import { n as useCodeBlock, r as copyToClipboard, t as mdx_components_default } from "../mdx-DFbspTP9.js";
+import { c as ThemeProvider, l as useTheme } from "../image-C9md50h2.js";
+import { n as useCodeBlock, r as copyToClipboard, t as mdx_components_default } from "../mdx-DhyMkc35.js";
 import { A as useUI, C as useSidebar, D as ButtonGroup, O as Breadcrumbs$2, S as useLocation, T as Menu$1, f as PageNav$1, k as UIProvider, m as OnThisPage$1, n as Sidebar$1, t as DocsLayout$1, w as Tabs$1, x as useSearchHighlight } from "../docs-layout-6FQ8__ok.js";
-import { a as Button$1, n as Navbar$1, r as ErrorBoundary$1 } from "../search-dialog-DaR66wl0.js";
-import { n as useSearch, r as InternalErrorBoundary, t as SearchDialog } from "../search-dialog-CaOO1Q4i.js";
+import { a as Button$1, n as Navbar$1, r as ErrorBoundary$1 } from "../search-dialog-DaeSPvEo.js";
+import { n as useSearch, r as InternalErrorBoundary, t as SearchDialog } from "../search-dialog-DoGobmuG.js";
 import { ViteReactSSG } from "@bdocs/ssg";
 import { Suspense, createContext, isValidElement, lazy, use, useCallback, useEffect, useLayoutEffect, useMemo, useRef, useState } from "react";
 import { Link, Outlet, useLoaderData, useLocation as useLocation$1, useMatches, useNavigate } from "react-router-dom";
@@ -17,6 +17,7 @@ import * as ReactHelmetAsync from "react-helmet-async";
 import { Button } from "react-aria-components";
 import virtualCustomComponents from "virtual:boltdocs-mdx-components";
 import virtualIcons from "virtual:boltdocs-icons";
+import DOMPurify from "isomorphic-dompurify";
 import UserLayout from "virtual:boltdocs-layout";
 
 //#region src/client/app/mdx-components-context.tsx
@@ -154,6 +155,152 @@ const mdxComponentsDefault = {
 	"404": NotFound
 };
 
+//#endregion
+//#region src/client/utils/i18n.ts
+/**
+* Retrieves the correct translation from a value that can be either
+* a simple string or a map of locale-specific strings.
+*
+* @param value - The text to translate
+* @param locale - The current active locale (e.g., 'en', 'es')
+* @returns The translated string
+*/
+function getTranslated(value, locale) {
+	if (!value) return "";
+	if (typeof value === "string") return value;
+	if (locale && value[locale]) return value[locale];
+	return Object.values(value)[0] || "";
+}
+
+//#endregion
+//#region src/client/app/head.tsx
+function Head({ siteTitle, siteDescription, routes }) {
+	const location = useLocation$1();
+	const config = useConfig();
+	const { currentLocale, currentRoute } = useRoutes();
+	const route = useMemo(() => {
+		if (currentRoute) return currentRoute;
+		const normalizedPath = location.pathname.endsWith("/") && location.pathname.length > 1 ? location.pathname.slice(0, -1) : location.pathname;
+		return routes?.find?.((r) => {
+			return (r.path.endsWith("/") && r.path.length > 1 ? r.path.slice(0, -1) : r.path) === normalizedPath;
+		});
+	}, [
+		routes,
+		location.pathname,
+		currentRoute
+	]);
+	const pageTitle = route?.title;
+	const translatedSiteDescription = getTranslated(siteDescription, currentLocale);
+	const pageDescription = route?.description || translatedSiteDescription || "";
+	const translatedSiteTitle = getTranslated(siteTitle, currentLocale);
+	const finalTitle = pageTitle ? `${pageTitle} | ${translatedSiteTitle}` : translatedSiteTitle;
+	const seo = route?.seo || {};
+	const canonicalUrl = seo.canonical || (config?.siteUrl && route?.path ? `${config.siteUrl.replace(/\/$/, "")}${route.path}` : void 0);
+	const ogUrl = seo["og:url"] || canonicalUrl || (typeof window !== "undefined" ? window.location.href : void 0);
+	const globalMetatags = config?.seo?.metatags || {};
+	const defaultOgImage = config?.seo?.thumbnails?.background;
+	let ogImage = seo["og:image"] || route?.coverImage || defaultOgImage;
+	if (ogImage && config?.siteUrl && !/^https?:\/\/|^\/\//.test(ogImage)) ogImage = `${config.siteUrl.endsWith("/") ? config.siteUrl.slice(0, -1) : config.siteUrl}${ogImage.startsWith("/") ? ogImage : `/${ogImage}`}`;
+	return /* @__PURE__ */ jsxs(Helmet, { children: [
+		/* @__PURE__ */ jsx("title", { children: finalTitle }),
+		/* @__PURE__ */ jsx("meta", {
+			name: "description",
+			content: pageDescription
+		}),
+		/* @__PURE__ */ jsx("meta", {
+			property: "og:title",
+			content: finalTitle
+		}),
+		/* @__PURE__ */ jsx("meta", {
+			property: "og:description",
+			content: pageDescription
+		}),
+		/* @__PURE__ */ jsx("meta", {
+			property: "og:type",
+			content: "article"
+		}),
+		canonicalUrl && /* @__PURE__ */ jsx("link", {
+			rel: "canonical",
+			href: canonicalUrl
+		}),
+		ogUrl && /* @__PURE__ */ jsx("meta", {
+			property: "og:url",
+			content: ogUrl
+		}),
+		/* @__PURE__ */ jsx("meta", {
+			name: "twitter:card",
+			content: ogImage ? "summary_large_image" : "summary"
+		}),
+		/* @__PURE__ */ jsx("meta", {
+			name: "twitter:title",
+			content: finalTitle
+		}),
+		/* @__PURE__ */ jsx("meta", {
+			name: "twitter:description",
+			content: pageDescription
+		}),
+		ogImage && /* @__PURE__ */ jsx("meta", {
+			name: "twitter:image",
+			content: ogImage
+		}),
+		ogImage && /* @__PURE__ */ jsx("meta", {
+			property: "og:image",
+			content: ogImage
+		}),
+		/* @__PURE__ */ jsx("meta", {
+			name: "generator",
+			content: "Boltdocs"
+		}),
+		config?.seo?.verification?.google && /* @__PURE__ */ jsx("meta", {
+			name: "google-site-verification",
+			content: config.seo.verification.google
+		}),
+		config?.seo?.verification?.bing && /* @__PURE__ */ jsx("meta", {
+			name: "msvalidate.01",
+			content: config.seo.verification.bing
+		}),
+		config?.seo?.verification?.yandex && /* @__PURE__ */ jsx("meta", {
+			name: "yandex-verification",
+			content: config.seo.verification.yandex
+		}),
+		config?.seo?.verification?.pinterest && /* @__PURE__ */ jsx("meta", {
+			name: "p:domain_verify",
+			content: config.seo.verification.pinterest
+		}),
+		config?.seo?.verification?.facebook && /* @__PURE__ */ jsx("meta", {
+			name: "facebook-domain-verification",
+			content: config.seo.verification.facebook
+		}),
+		Object.entries(globalMetatags).map(([key, value]) => {
+			return key.startsWith("og:") || key.startsWith("music:") || key.startsWith("video:") || key.startsWith("article:") || key.startsWith("book:") || key.startsWith("profile:") ? /* @__PURE__ */ jsx("meta", {
+				property: key,
+				content: value
+			}, key) : /* @__PURE__ */ jsx("meta", {
+				name: key,
+				content: value
+			}, key);
+		}),
+		Object.entries(seo).map(([key, value]) => {
+			if (key === "noindex" && value === true) return /* @__PURE__ */ jsx("meta", {
+				name: "robots",
+				content: "noindex"
+			}, "noindex");
+			if (key === "robots") return /* @__PURE__ */ jsx("meta", {
+				name: "robots",
+				content: value
+			}, "robots");
+			if (key === "canonical" || key === "og:url" || key === "og:image" || key === "twitter:image") return null;
+			return key.startsWith("og:") || key.startsWith("music:") || key.startsWith("video:") || key.startsWith("article:") || key.startsWith("book:") || key.startsWith("profile:") ? /* @__PURE__ */ jsx("meta", {
+				property: key,
+				content: value
+			}, key) : /* @__PURE__ */ jsx("meta", {
+				name: key,
+				content: value
+			}, key);
+		})
+	] });
+}
+
 //#endregion
 //#region src/client/collections/collections-context.tsx
 const CollectionsContext = createContext({});
@@ -246,6 +393,11 @@ function BoltdocsShell({ config, routes, components = {}, collectionsData }) {
 								routeMap
 							}),
 							/* @__PURE__ */ jsx(I18nUpdater, { config }),
+							/* @__PURE__ */ jsx(Head, {
+								siteTitle: config.theme?.title,
+								siteDescription: config.theme?.description,
+								routes
+							}),
 							/* @__PURE__ */ jsx(InternalErrorBoundary, { children: /* @__PURE__ */ jsx(Outlet, {}) })
 						]
 					})]
@@ -518,23 +670,6 @@ function GithubStars({ repo }) {
 	});
 }
 
-//#endregion
-//#region src/client/utils/i18n.ts
-/**
-* Retrieves the correct translation from a value that can be either
-* a simple string or a map of locale-specific strings.
-*
-* @param value - The text to translate
-* @param locale - The current active locale (e.g., 'en', 'es')
-* @returns The translated string
-*/
-function getTranslated(value, locale) {
-	if (!value) return "";
-	if (typeof value === "string") return value;
-	if (locale && value[locale]) return value[locale];
-	return Object.values(value)[0] || "";
-}
-
 //#endregion
 //#region src/client/hooks/use-navbar.ts
 function useNavbar() {
@@ -758,7 +893,7 @@ function Tabs({ tabs, routes }) {
 		if (!iconName) return null;
 		if (iconName.trim().startsWith("<svg")) return /* @__PURE__ */ jsx("span", {
 			className: "h-4 w-4",
-			dangerouslySetInnerHTML: { __html: iconName }
+			dangerouslySetInnerHTML: { __html: DOMPurify.sanitize(iconName, { USE_PROFILES: { svg: true } }) }
 		});
 		const icons = {
 			...icons_exports,
@@ -1021,7 +1156,7 @@ function createGtagAnalytics(config) {
 			window.gtag?.("event", "page_view", {
 				page_path: path,
 				page_title: title || document.title,
-				send_to: config?.ga4?.measurementId
+				send_to: config?.analytics?.ga4?.measurementId
 			});
 		},
 		trackEvent: ({ action, category, label, value, params }) => {
@@ -1029,7 +1164,7 @@ function createGtagAnalytics(config) {
 				event_category: category,
 				event_label: label,
 				value,
-				send_to: config?.ga4?.measurementId,
+				send_to: config?.analytics?.ga4?.measurementId,
 				...params
 			});
 		},
@@ -1037,20 +1172,20 @@ function createGtagAnalytics(config) {
 			window.gtag?.("event", "search", {
 				search_term: query,
 				results_count: resultsCount,
-				send_to: config?.ga4?.measurementId
+				send_to: config?.analytics?.ga4?.measurementId
 			});
 		},
 		trackDownload: (file, type) => {
 			window.gtag?.("event", "file_download", {
 				file_name: file,
 				file_type: type || file.split(".").pop(),
-				send_to: config?.ga4?.measurementId
+				send_to: config?.analytics?.ga4?.measurementId
 			});
 		},
 		trackExternalLink: (url) => {
 			window.gtag?.("event", "external_link", {
 				link_url: url,
-				send_to: config?.ga4?.measurementId
+				send_to: config?.analytics?.ga4?.measurementId
 			});
 		},
 		isEnabled: true
@@ -1063,7 +1198,7 @@ function createDataLayerAnalytics(config) {
 				event: "page_view",
 				page_path: path,
 				page_title: title || document.title,
-				send_to: config?.gtm?.tagId
+				send_to: config?.analytics?.gtm?.tagId
 			});
 		},
 		trackEvent: ({ action, category, label, value, params }) => {
@@ -1072,7 +1207,7 @@ function createDataLayerAnalytics(config) {
 				event_category: category,
 				event_label: label,
 				value,
-				send_to: config?.gtm?.tagId,
+				send_to: config?.analytics?.gtm?.tagId,
 				...params
 			});
 		},
@@ -1081,7 +1216,7 @@ function createDataLayerAnalytics(config) {
 				event: "search",
 				search_term: query,
 				results_count: resultsCount,
-				send_to: config?.gtm?.tagId
+				send_to: config?.analytics?.gtm?.tagId
 			});
 		},
 		trackDownload: (file, type) => {
@@ -1089,14 +1224,14 @@ function createDataLayerAnalytics(config) {
 				event: "file_download",
 				file_name: file,
 				file_type: type || file.split(".").pop(),
-				send_to: config?.gtm?.tagId
+				send_to: config?.analytics?.gtm?.tagId
 			});
 		},
 		trackExternalLink: (url) => {
 			window.dataLayer?.push({
 				event: "external_link",
 				link_url: url,
-				send_to: config?.gtm?.tagId
+				send_to: config?.analytics?.gtm?.tagId
 			});
 		},
 		isEnabled: true
@@ -1298,13 +1433,13 @@ function I18nSelector({ className }) {
 
 //#endregion
 //#region src/client/components/ui-base/navbar.tsx
-const SearchDialog$1 = lazy(() => import("../search-dialog-DRNJsxOv.js").then((m) => ({ default: m.SearchDialog })));
+const SearchDialog$1 = lazy(() => import("../search-dialog-CQneRo8T.js").then((m) => ({ default: m.SearchDialog })));
 function Navbar() {
 	const { links, title, logo, logoProps, github, social, config } = useNavbar();
 	const { routes, currentRoute, isCollectionPage, currentVersion, currentLocale } = useRoutes();
 	const { isSidebarOpen, toggleSidebar } = useUI();
 	const [isMobileMenuOpen, setIsMobileMenuOpen] = useState(false);
-	const themeConfig = config.theme || {};
+	const themeConfig = config.theme;
 	const isDocs = !!currentRoute?.filePath && !isCollectionPage;
 	const hasTabs = themeConfig?.tabs && themeConfig.tabs.length > 0;
 	return /* @__PURE__ */ jsxs(Navbar$1.Root, {
@@ -1334,15 +1469,18 @@ function Navbar() {
 						children: config.versions && currentVersion && /* @__PURE__ */ jsx(VersionSelector, {})
 					})
 				] }),
-				/* @__PURE__ */ jsx(Navbar$1.Center, { children: /* @__PURE__ */ jsx(Suspense, {
-					fallback: /* @__PURE__ */ jsx("div", { className: "h-9 w-32 animate-pulse rounded-md bg-surface" }),
-					children: /* @__PURE__ */ jsx(SearchDialog$1, { routes: routes || [] })
+				/* @__PURE__ */ jsx(Navbar$1.Center, { children: /* @__PURE__ */ jsx("div", {
+					className: "flex items-center gap-2",
+					children: /* @__PURE__ */ jsx(Suspense, {
+						fallback: /* @__PURE__ */ jsx("div", { className: "h-9 w-32 animate-pulse rounded-md bg-surface" }),
+						children: /* @__PURE__ */ jsx(SearchDialog$1, { routes: routes || [] })
+					})
 				}) }),
 				/* @__PURE__ */ jsxs(Navbar$1.Right, { children: [
 					/* @__PURE__ */ jsx(Suspense, {
 						fallback: null,
 						children: /* @__PURE__ */ jsx("div", {
-							className: "lg:hidden",
+							className: "lg:hidden flex items-center gap-1",
 							children: /* @__PURE__ */ jsx(SearchDialog$1, { routes: routes || [] })
 						})
 					}),
@@ -1693,6 +1831,69 @@ function Feedback({ className }) {
 	});
 }
 
+//#endregion
+//#region src/client/components/ui-base/giscus.tsx
+function Giscus({ className }) {
+	const config = useConfig();
+	const { resolvedTheme } = useTheme();
+	const ref = useRef(null);
+	const initializedRef = useRef(false);
+	const giscusConfig = config.integrations?.feedback?.giscus;
+	useEffect(() => {
+		if (!giscusConfig) return;
+		const theme = giscusConfig.theme || (resolvedTheme === "dark" ? "dark" : "light");
+		const session = {
+			repo: giscusConfig.repo,
+			"repo-id": giscusConfig.repoId,
+			category: giscusConfig.category,
+			"category-id": giscusConfig.categoryId,
+			mapping: giscusConfig.mapping || "pathname",
+			strict: String(giscusConfig.strict ?? "0"),
+			"reactions-enabled": String(giscusConfig.reactionsEnabled ?? "1"),
+			"emit-metadata": String(giscusConfig.emitMetadata ?? "0"),
+			"input-position": giscusConfig.inputPosition || "bottom",
+			lang: giscusConfig.lang || "en",
+			loading: giscusConfig.loading || "lazy"
+		};
+		if (!initializedRef.current) {
+			initializedRef.current = true;
+			const script = document.createElement("script");
+			script.src = "https://giscus.app/client.js";
+			script.setAttribute("data-repo", session.repo);
+			script.setAttribute("data-repo-id", session["repo-id"]);
+			if (session.category) script.setAttribute("data-category", session.category);
+			if (session["category-id"]) script.setAttribute("data-category-id", session["category-id"]);
+			script.setAttribute("data-mapping", session.mapping);
+			script.setAttribute("data-strict", session.strict);
+			script.setAttribute("data-reactions-enabled", session["reactions-enabled"]);
+			script.setAttribute("data-emit-metadata", session["emit-metadata"]);
+			script.setAttribute("data-input-position", session["input-position"]);
+			script.setAttribute("data-lang", session.lang);
+			script.setAttribute("data-loading", session.loading);
+			script.setAttribute("data-theme", theme);
+			script.setAttribute("crossorigin", "anonymous");
+			script.async = true;
+			if (ref.current) ref.current.appendChild(script);
+			return () => {
+				initializedRef.current = false;
+				if (script.parentNode) script.parentNode.removeChild(script);
+				(ref.current?.querySelectorAll("iframe"))?.forEach((iframe) => iframe.remove());
+			};
+		}
+	}, [giscusConfig]);
+	useEffect(() => {
+		if (!giscusConfig || !initializedRef.current) return;
+		const theme = giscusConfig.theme || (resolvedTheme === "dark" ? "dark" : "light");
+		const iframe = ref.current?.querySelector("iframe.giscus-frame");
+		if (iframe) iframe.contentWindow?.postMessage({ giscus: { setConfig: { theme } } }, "https://giscus.app");
+	}, [resolvedTheme, giscusConfig]);
+	if (!giscusConfig) return null;
+	return /* @__PURE__ */ jsx("div", {
+		ref,
+		className: cn("w-full max-w-2xl mt-12 mb-6", className)
+	});
+}
+
 //#endregion
 //#region src/client/ssg/mdx-elements.tsx
 const Loading = () => /* @__PURE__ */ jsx("div", {
@@ -1731,117 +1932,14 @@ const NotFoundWrapper = () => {
 	return /* @__PURE__ */ jsx(components.NotFound || components["404"] || NotFound, {});
 };
 
-//#endregion
-//#region src/client/app/head.tsx
-function Head({ siteTitle, siteDescription, routes }) {
-	const location = useLocation$1();
-	const config = useConfig();
-	const { currentLocale } = useRoutes();
-	const currentRoute = useMemo(() => routes?.find?.((r) => r.path === location.pathname), [routes, location.pathname]);
-	const pageTitle = currentRoute?.title;
-	const translatedSiteDescription = getTranslated(siteDescription, currentLocale);
-	const pageDescription = currentRoute?.description || translatedSiteDescription || "";
-	const translatedSiteTitle = getTranslated(siteTitle, currentLocale);
-	const finalTitle = pageTitle ? `${pageTitle} | ${translatedSiteTitle}` : translatedSiteTitle;
-	const seo = currentRoute?.seo || {};
-	const canonicalUrl = seo.canonical || (config?.siteUrl && currentRoute?.path ? `${config.siteUrl.replace(/\/$/, "")}${currentRoute.path}` : void 0);
-	const ogUrl = seo["og:url"] || canonicalUrl || (typeof window !== "undefined" ? window.location.href : void 0);
-	const globalMetatags = config?.seo?.metatags || {};
-	const defaultOgImage = config?.seo?.thumbnails?.background;
-	const ogImage = seo["og:image"] || defaultOgImage;
-	return /* @__PURE__ */ jsxs(Helmet, { children: [
-		/* @__PURE__ */ jsx("title", { children: finalTitle }),
-		/* @__PURE__ */ jsx("meta", {
-			name: "description",
-			content: pageDescription
-		}),
-		/* @__PURE__ */ jsx("meta", {
-			property: "og:title",
-			content: finalTitle
-		}),
-		/* @__PURE__ */ jsx("meta", {
-			property: "og:description",
-			content: pageDescription
-		}),
-		/* @__PURE__ */ jsx("meta", {
-			property: "og:type",
-			content: "article"
-		}),
-		canonicalUrl && /* @__PURE__ */ jsx("link", {
-			rel: "canonical",
-			href: canonicalUrl
-		}),
-		ogUrl && /* @__PURE__ */ jsx("meta", {
-			property: "og:url",
-			content: ogUrl
-		}),
-		/* @__PURE__ */ jsx("meta", {
-			name: "twitter:card",
-			content: "summary"
-		}),
-		/* @__PURE__ */ jsx("meta", {
-			name: "twitter:title",
-			content: finalTitle
-		}),
-		/* @__PURE__ */ jsx("meta", {
-			name: "twitter:description",
-			content: pageDescription
-		}),
-		ogImage && /* @__PURE__ */ jsx("meta", {
-			name: "twitter:image",
-			content: ogImage
-		}),
-		ogImage && /* @__PURE__ */ jsx("meta", {
-			property: "og:image",
-			content: ogImage
-		}),
-		/* @__PURE__ */ jsx("meta", {
-			name: "generator",
-			content: "Boltdocs"
-		}),
-		Object.entries(globalMetatags).map(([key, value]) => {
-			return key.startsWith("og:") || key.startsWith("music:") || key.startsWith("video:") || key.startsWith("article:") || key.startsWith("book:") || key.startsWith("profile:") ? /* @__PURE__ */ jsx("meta", {
-				property: key,
-				content: value
-			}, key) : /* @__PURE__ */ jsx("meta", {
-				name: key,
-				content: value
-			}, key);
-		}),
-		Object.entries(seo).map(([key, value]) => {
-			if (key === "noindex" && value === true) return /* @__PURE__ */ jsx("meta", {
-				name: "robots",
-				content: "noindex"
-			}, "noindex");
-			if (key === "robots") return /* @__PURE__ */ jsx("meta", {
-				name: "robots",
-				content: value
-			}, "robots");
-			if (key === "canonical" || key === "og:url") return null;
-			return key.startsWith("og:") || key.startsWith("music:") || key.startsWith("video:") || key.startsWith("article:") || key.startsWith("book:") || key.startsWith("profile:") ? /* @__PURE__ */ jsx("meta", {
-				property: key,
-				content: value
-			}, key) : /* @__PURE__ */ jsx("meta", {
-				name: key,
-				content: value
-			}, key);
-		})
-	] });
-}
-
 //#endregion
 //#region src/client/app/docs-layout.tsx
 function DocsLayout({ collectionsData }) {
-	const config = useConfig();
-	const { currentRoute, allRoutes } = useRoutes();
-	const content = /* @__PURE__ */ jsxs(Fragment, { children: [/* @__PURE__ */ jsx(Head, {
-		siteTitle: config.theme?.title,
-		siteDescription: config.theme?.description,
-		routes: allRoutes || []
-	}), /* @__PURE__ */ jsx(InternalErrorBoundary, { children: /* @__PURE__ */ jsx(UserLayout, {
+	const { currentRoute } = useRoutes();
+	const content = /* @__PURE__ */ jsx(InternalErrorBoundary, { children: /* @__PURE__ */ jsx(UserLayout, {
 		route: currentRoute,
 		children: /* @__PURE__ */ jsx(Outlet, {})
-	}) })] });
+	}) });
 	if (collectionsData) return /* @__PURE__ */ jsx(CollectionsContext.Provider, {
 		value: collectionsData,
 		children: content
@@ -2318,6 +2416,18 @@ function createRoutes(options) {
 function DocsLayoutComponent({ children }) {
 	const { routes: filteredRoutes, currentRoute, isCollectionPage } = useRoutes();
 	const config = useConfig();
+	const AskAiDialog = useMergedComponents().AskAiDialog;
+	const [isAskAiOpen, setIsAskAiOpen] = useState(false);
+	useEffect(() => {
+		const handleOpen = () => setIsAskAiOpen(true);
+		const handleClose = () => setIsAskAiOpen(false);
+		window.addEventListener("boltdocs:ask-ai:open", handleOpen);
+		window.addEventListener("boltdocs:ask-ai:close", handleClose);
+		return () => {
+			window.removeEventListener("boltdocs:ask-ai:open", handleOpen);
+			window.removeEventListener("boltdocs:ask-ai:close", handleClose);
+		};
+	}, []);
 	return /* @__PURE__ */ jsxs(DocsLayout$1, {
 		className: "selection:bg-primary-500/10 selection:text-primary-500",
 		children: [/* @__PURE__ */ jsx(Navbar, {}), /* @__PURE__ */ jsxs(DocsLayout$1.Body, {
@@ -2354,15 +2464,17 @@ function DocsLayoutComponent({ children }) {
 								children
 							}) }),
 							!isCollectionPage && /* @__PURE__ */ jsx(Feedback, {}),
+							!isCollectionPage && /* @__PURE__ */ jsx(Giscus, {}),
 							/* @__PURE__ */ jsx(DocsLayout$1.Footer, { children: !isCollectionPage && /* @__PURE__ */ jsx(PageNav, {}) })
 						]
 					})
 				}),
-				/* @__PURE__ */ jsx(OnThisPage, {
+				AskAiDialog && /* @__PURE__ */ jsx(AskAiDialog, {}),
+				!isCollectionPage && !isAskAiOpen && /* @__PURE__ */ jsx(OnThisPage, {
 					headings: currentRoute?.headings,
-					editLink: config.theme?.editLink,
+					filePath: currentRoute?.filePath,
 					communityHelp: config.theme?.communityHelp,
-					filePath: currentRoute?.filePath
+					editLink: config.theme?.editLink
 				})
 			]
 		})]

package/dist/client/mdx.cjs

@@ -4,7 +4,7 @@
  * Licensed under the MIT License.
  */
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_mdx = require('../mdx-9QJoSITt.cjs');
+const require_mdx = require('../mdx-DJBg5DuL.cjs');
 
 //#region src/client/mdx.ts
 const { Card, Cards, Callout, Field, Image } = require_mdx.mdx_components_default;

package/dist/client/mdx.js

@@ -3,7 +3,7 @@
  * Copyright (c) 2026 Jesus Alcala
  * Licensed under the MIT License.
  */
-import { t as mdx_components_default } from "../mdx-DFbspTP9.js";
+import { t as mdx_components_default } from "../mdx-DhyMkc35.js";
 
 //#region src/client/mdx.ts
 const { Card, Cards, Callout, Field, Image } = mdx_components_default;

package/dist/client/primitives.cjs

@@ -5,9 +5,9 @@
  */
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_icons_dev = require('../icons-dev-BryEFkJu.cjs');
-const require_image = require('../image-DWdmichO.cjs');
+const require_image = require('../image-CR6UlaI5.cjs');
 const require_docs_layout = require('../docs-layout-3TpAt6MB.cjs');
-const require_search_dialog = require('../search-dialog-BhXg05Ri.cjs');
+const require_search_dialog = require('../search-dialog-D4rplZMv.cjs');
 let react_jsx_runtime = require("react/jsx-runtime");
 
 //#region src/client/components/primitives/skeleton.tsx

package/dist/client/primitives.d.cts

@@ -1,10 +1,10 @@
 
-import { A as BoltdocsRoutePathWithFallback, a as SidebarItem, c as SidebarItemsProps, d as SidebarMobile, f as SidebarRoot, i as SidebarHeader, l as SidebarLink, m as ComponentBase, n as SidebarContent, o as SidebarItemProps, p as SidebarSubGroup, r as SidebarGroup, s as SidebarItems, t as Sidebar, u as SidebarLinkProps } from "../sidebar-BtJyWHy4.cjs";
+import { A as BoltdocsRoutePathWithFallback, a as SidebarItem, c as SidebarItemsProps, d as SidebarMobile, f as SidebarRoot, i as SidebarHeader, l as SidebarLink, m as ComponentBase, n as SidebarContent, o as SidebarItemProps, p as SidebarSubGroup, r as SidebarGroup, s as SidebarItems, t as Sidebar, u as SidebarLinkProps } from "../sidebar-7gIifpBX.cjs";
 import * as React$2 from "react";
 import { Component, ComponentProps, ComponentType, ErrorInfo, ImgHTMLAttributes, ReactNode, RefObject } from "react";
 import * as _$react_jsx_runtime0 from "react/jsx-runtime";
 import * as RAC from "react-aria-components";
-import { LinkProps as LinkProps$1, PopoverProps as PopoverProps$1 } from "react-aria-components";
+import { PopoverProps as PopoverProps$1 } from "react-aria-components";
 
 //#region src/client/components/primitives/docs-layout.d.ts
 /**
@@ -527,7 +527,7 @@ declare function MenuSeparator(props: RAC.SeparatorProps): _$react_jsx_runtime0.
 //#endregion
 //#region src/client/components/primitives/page-nav.d.ts
 interface PageNavProps extends ComponentBase {
-  to: string;
+  to: BoltdocsRoutePathWithFallback;
   direction: 'prev' | 'next';
 }
 declare function PageNav({
@@ -706,8 +706,10 @@ declare function BreadcrumbsLink({
   href,
   className,
   ...props
-}: LinkProps$1 & {
+}: {
+  href: BoltdocsRoutePathWithFallback;
   className?: string;
+  children?: React.ReactNode;
 }): _$react_jsx_runtime0.JSX.Element;
 declare function BreadcrumbsSeparator({
   className
@@ -716,7 +718,7 @@ declare function BreadcrumbsSeparator({
 //#region src/client/components/primitives/navbar.d.ts
 interface NavbarLinkProps extends Omit<ComponentBase, 'children'> {
   label: ReactNode;
-  href: string;
+  href: BoltdocsRoutePathWithFallback;
   to?: 'internal' | 'external';
 }
 interface NavbarLogoProps extends Omit<ComponentBase, 'children'> {
@@ -724,7 +726,7 @@ interface NavbarLogoProps extends Omit<ComponentBase, 'children'> {
   alt: string;
   width?: number;
   height?: number;
-  href?: string;
+  href?: BoltdocsRoutePathWithFallback;
 }
 interface NavbarSearchTriggerProps extends ComponentBase {
   onPress: () => void;
@@ -796,7 +798,7 @@ declare function NavbarTitle({
   className,
   href
 }: {
-  href?: string;
+  href?: BoltdocsRoutePathWithFallback;
 } & ComponentBase): _$react_jsx_runtime0.JSX.Element;
 declare function NavbarLinks({
   children,
@@ -822,7 +824,7 @@ declare function NavbarDropdownItem({
   label,
   className
 }: {
-  href: string;
+  href: BoltdocsRoutePathWithFallback;
   label: string;
   className?: string;
 }): _$react_jsx_runtime0.JSX.Element;