boltdocs 2.9.2 → 3.0.0

package/dist/client/index.cjs

@@ -5,11 +5,11 @@
  */
 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_mdx = require('../mdx-9QJoSITt.cjs');
+const require_image = require('../image-CR6UlaI5.cjs');
+const require_mdx = require('../mdx-DJBg5DuL.cjs');
 const require_docs_layout = require('../docs-layout-3TpAt6MB.cjs');
-const require_search_dialog = require('../search-dialog-BhXg05Ri.cjs');
-const require_search_dialog$1 = require('../search-dialog-BsAiQgnx.cjs');
+const require_search_dialog = require('../search-dialog-D4rplZMv.cjs');
+const require_search_dialog$1 = require('../search-dialog-CwNh8lIN.cjs');
 let react = require("react");
 let react_router_dom = require("react-router-dom");
 let react_jsx_runtime = require("react/jsx-runtime");
@@ -20,6 +20,8 @@ let virtual_boltdocs_mdx_components = require("virtual:boltdocs-mdx-components")
 virtual_boltdocs_mdx_components = require_icons_dev.__toESM(virtual_boltdocs_mdx_components);
 let virtual_boltdocs_icons = require("virtual:boltdocs-icons");
 virtual_boltdocs_icons = require_icons_dev.__toESM(virtual_boltdocs_icons);
+let isomorphic_dompurify = require("isomorphic-dompurify");
+isomorphic_dompurify = require_icons_dev.__toESM(isomorphic_dompurify);
 let virtual_boltdocs_layout = require("virtual:boltdocs-layout");
 virtual_boltdocs_layout = require_icons_dev.__toESM(virtual_boltdocs_layout);
 let _bdocs_ssg = require("@bdocs/ssg");
@@ -159,6 +161,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 = (0, react_router_dom.useLocation)();
+	const config = require_icons_dev.useConfig();
+	const { currentLocale, currentRoute } = require_icons_dev.useRoutes();
+	const route = (0, react.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__ */ (0, react_jsx_runtime.jsxs)(Helmet, { children: [
+		/* @__PURE__ */ (0, react_jsx_runtime.jsx)("title", { children: finalTitle }),
+		/* @__PURE__ */ (0, react_jsx_runtime.jsx)("meta", {
+			name: "description",
+			content: pageDescription
+		}),
+		/* @__PURE__ */ (0, react_jsx_runtime.jsx)("meta", {
+			property: "og:title",
+			content: finalTitle
+		}),
+		/* @__PURE__ */ (0, react_jsx_runtime.jsx)("meta", {
+			property: "og:description",
+			content: pageDescription
+		}),
+		/* @__PURE__ */ (0, react_jsx_runtime.jsx)("meta", {
+			property: "og:type",
+			content: "article"
+		}),
+		canonicalUrl && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("link", {
+			rel: "canonical",
+			href: canonicalUrl
+		}),
+		ogUrl && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("meta", {
+			property: "og:url",
+			content: ogUrl
+		}),
+		/* @__PURE__ */ (0, react_jsx_runtime.jsx)("meta", {
+			name: "twitter:card",
+			content: ogImage ? "summary_large_image" : "summary"
+		}),
+		/* @__PURE__ */ (0, react_jsx_runtime.jsx)("meta", {
+			name: "twitter:title",
+			content: finalTitle
+		}),
+		/* @__PURE__ */ (0, react_jsx_runtime.jsx)("meta", {
+			name: "twitter:description",
+			content: pageDescription
+		}),
+		ogImage && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("meta", {
+			name: "twitter:image",
+			content: ogImage
+		}),
+		ogImage && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("meta", {
+			property: "og:image",
+			content: ogImage
+		}),
+		/* @__PURE__ */ (0, react_jsx_runtime.jsx)("meta", {
+			name: "generator",
+			content: "Boltdocs"
+		}),
+		config?.seo?.verification?.google && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("meta", {
+			name: "google-site-verification",
+			content: config.seo.verification.google
+		}),
+		config?.seo?.verification?.bing && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("meta", {
+			name: "msvalidate.01",
+			content: config.seo.verification.bing
+		}),
+		config?.seo?.verification?.yandex && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("meta", {
+			name: "yandex-verification",
+			content: config.seo.verification.yandex
+		}),
+		config?.seo?.verification?.pinterest && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("meta", {
+			name: "p:domain_verify",
+			content: config.seo.verification.pinterest
+		}),
+		config?.seo?.verification?.facebook && /* @__PURE__ */ (0, react_jsx_runtime.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__ */ (0, react_jsx_runtime.jsx)("meta", {
+				property: key,
+				content: value
+			}, key) : /* @__PURE__ */ (0, react_jsx_runtime.jsx)("meta", {
+				name: key,
+				content: value
+			}, key);
+		}),
+		Object.entries(seo).map(([key, value]) => {
+			if (key === "noindex" && value === true) return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("meta", {
+				name: "robots",
+				content: "noindex"
+			}, "noindex");
+			if (key === "robots") return /* @__PURE__ */ (0, react_jsx_runtime.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__ */ (0, react_jsx_runtime.jsx)("meta", {
+				property: key,
+				content: value
+			}, key) : /* @__PURE__ */ (0, react_jsx_runtime.jsx)("meta", {
+				name: key,
+				content: value
+			}, key);
+		})
+	] });
+}
+
 //#endregion
 //#region src/client/collections/collections-context.tsx
 const CollectionsContext = (0, react.createContext)({});
@@ -251,6 +399,11 @@ function BoltdocsShell({ config, routes, components = {}, collectionsData }) {
 								routeMap
 							}),
 							/* @__PURE__ */ (0, react_jsx_runtime.jsx)(I18nUpdater, { config }),
+							/* @__PURE__ */ (0, react_jsx_runtime.jsx)(Head, {
+								siteTitle: config.theme?.title,
+								siteDescription: config.theme?.description,
+								routes
+							}),
 							/* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_search_dialog$1.InternalErrorBoundary, { children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(react_router_dom.Outlet, {}) })
 						]
 					})]
@@ -523,23 +676,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() {
@@ -763,7 +899,7 @@ function Tabs({ tabs, routes }) {
 		if (!iconName) return null;
 		if (iconName.trim().startsWith("<svg")) return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
 			className: "h-4 w-4",
-			dangerouslySetInnerHTML: { __html: iconName }
+			dangerouslySetInnerHTML: { __html: isomorphic_dompurify.default.sanitize(iconName, { USE_PROFILES: { svg: true } }) }
 		});
 		const icons = {
 			...require_icons_dev.icons_exports,
@@ -1026,7 +1162,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 }) => {
@@ -1034,7 +1170,7 @@ function createGtagAnalytics(config) {
 				event_category: category,
 				event_label: label,
 				value,
-				send_to: config?.ga4?.measurementId,
+				send_to: config?.analytics?.ga4?.measurementId,
 				...params
 			});
 		},
@@ -1042,20 +1178,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
@@ -1068,7 +1204,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 }) => {
@@ -1077,7 +1213,7 @@ function createDataLayerAnalytics(config) {
 				event_category: category,
 				event_label: label,
 				value,
-				send_to: config?.gtm?.tagId,
+				send_to: config?.analytics?.gtm?.tagId,
 				...params
 			});
 		},
@@ -1086,7 +1222,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) => {
@@ -1094,14 +1230,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
@@ -1303,13 +1439,13 @@ function I18nSelector({ className }) {
 
 //#endregion
 //#region src/client/components/ui-base/navbar.tsx
-const SearchDialog$1 = (0, react.lazy)(() => Promise.resolve().then(() => require("../search-dialog-CzwvKoLW.cjs")).then((m) => ({ default: m.SearchDialog })));
+const SearchDialog$1 = (0, react.lazy)(() => Promise.resolve().then(() => require("../search-dialog-cHJoKjts.cjs")).then((m) => ({ default: m.SearchDialog })));
 function Navbar() {
 	const { links, title, logo, logoProps, github, social, config } = useNavbar();
 	const { routes, currentRoute, isCollectionPage, currentVersion, currentLocale } = require_icons_dev.useRoutes();
 	const { isSidebarOpen, toggleSidebar } = require_docs_layout.useUI();
 	const [isMobileMenuOpen, setIsMobileMenuOpen] = (0, react.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__ */ (0, react_jsx_runtime.jsxs)(require_search_dialog.Navbar.Root, {
@@ -1339,15 +1475,18 @@ function Navbar() {
 						children: config.versions && currentVersion && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(VersionSelector, {})
 					})
 				] }),
-				/* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_search_dialog.Navbar.Center, { children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(react.Suspense, {
-					fallback: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", { className: "h-9 w-32 animate-pulse rounded-md bg-surface" }),
-					children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(SearchDialog$1, { routes: routes || [] })
+				/* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_search_dialog.Navbar.Center, { children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+					className: "flex items-center gap-2",
+					children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(react.Suspense, {
+						fallback: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", { className: "h-9 w-32 animate-pulse rounded-md bg-surface" }),
+						children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(SearchDialog$1, { routes: routes || [] })
+					})
 				}) }),
 				/* @__PURE__ */ (0, react_jsx_runtime.jsxs)(require_search_dialog.Navbar.Right, { children: [
 					/* @__PURE__ */ (0, react_jsx_runtime.jsx)(react.Suspense, {
 						fallback: null,
 						children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
-							className: "lg:hidden",
+							className: "lg:hidden flex items-center gap-1",
 							children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(SearchDialog$1, { routes: routes || [] })
 						})
 					}),
@@ -1698,6 +1837,69 @@ function Feedback({ className }) {
 	});
 }
 
+//#endregion
+//#region src/client/components/ui-base/giscus.tsx
+function Giscus({ className }) {
+	const config = require_icons_dev.useConfig();
+	const { resolvedTheme } = require_image.useTheme();
+	const ref = (0, react.useRef)(null);
+	const initializedRef = (0, react.useRef)(false);
+	const giscusConfig = config.integrations?.feedback?.giscus;
+	(0, react.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]);
+	(0, react.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__ */ (0, react_jsx_runtime.jsx)("div", {
+		ref,
+		className: require_icons_dev.cn("w-full max-w-2xl mt-12 mb-6", className)
+	});
+}
+
 //#endregion
 //#region src/client/ssg/mdx-elements.tsx
 const Loading = () => /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
@@ -1736,117 +1938,14 @@ const NotFoundWrapper = () => {
 	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(components.NotFound || components["404"] || NotFound, {});
 };
 
-//#endregion
-//#region src/client/app/head.tsx
-function Head({ siteTitle, siteDescription, routes }) {
-	const location = (0, react_router_dom.useLocation)();
-	const config = require_icons_dev.useConfig();
-	const { currentLocale } = require_icons_dev.useRoutes();
-	const currentRoute = (0, react.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__ */ (0, react_jsx_runtime.jsxs)(Helmet, { children: [
-		/* @__PURE__ */ (0, react_jsx_runtime.jsx)("title", { children: finalTitle }),
-		/* @__PURE__ */ (0, react_jsx_runtime.jsx)("meta", {
-			name: "description",
-			content: pageDescription
-		}),
-		/* @__PURE__ */ (0, react_jsx_runtime.jsx)("meta", {
-			property: "og:title",
-			content: finalTitle
-		}),
-		/* @__PURE__ */ (0, react_jsx_runtime.jsx)("meta", {
-			property: "og:description",
-			content: pageDescription
-		}),
-		/* @__PURE__ */ (0, react_jsx_runtime.jsx)("meta", {
-			property: "og:type",
-			content: "article"
-		}),
-		canonicalUrl && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("link", {
-			rel: "canonical",
-			href: canonicalUrl
-		}),
-		ogUrl && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("meta", {
-			property: "og:url",
-			content: ogUrl
-		}),
-		/* @__PURE__ */ (0, react_jsx_runtime.jsx)("meta", {
-			name: "twitter:card",
-			content: "summary"
-		}),
-		/* @__PURE__ */ (0, react_jsx_runtime.jsx)("meta", {
-			name: "twitter:title",
-			content: finalTitle
-		}),
-		/* @__PURE__ */ (0, react_jsx_runtime.jsx)("meta", {
-			name: "twitter:description",
-			content: pageDescription
-		}),
-		ogImage && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("meta", {
-			name: "twitter:image",
-			content: ogImage
-		}),
-		ogImage && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("meta", {
-			property: "og:image",
-			content: ogImage
-		}),
-		/* @__PURE__ */ (0, react_jsx_runtime.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__ */ (0, react_jsx_runtime.jsx)("meta", {
-				property: key,
-				content: value
-			}, key) : /* @__PURE__ */ (0, react_jsx_runtime.jsx)("meta", {
-				name: key,
-				content: value
-			}, key);
-		}),
-		Object.entries(seo).map(([key, value]) => {
-			if (key === "noindex" && value === true) return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("meta", {
-				name: "robots",
-				content: "noindex"
-			}, "noindex");
-			if (key === "robots") return /* @__PURE__ */ (0, react_jsx_runtime.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__ */ (0, react_jsx_runtime.jsx)("meta", {
-				property: key,
-				content: value
-			}, key) : /* @__PURE__ */ (0, react_jsx_runtime.jsx)("meta", {
-				name: key,
-				content: value
-			}, key);
-		})
-	] });
-}
-
 //#endregion
 //#region src/client/app/docs-layout.tsx
 function DocsLayout({ collectionsData }) {
-	const config = require_icons_dev.useConfig();
-	const { currentRoute, allRoutes } = require_icons_dev.useRoutes();
-	const content = /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(Head, {
-		siteTitle: config.theme?.title,
-		siteDescription: config.theme?.description,
-		routes: allRoutes || []
-	}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_search_dialog$1.InternalErrorBoundary, { children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(virtual_boltdocs_layout.default, {
+	const { currentRoute } = require_icons_dev.useRoutes();
+	const content = /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_search_dialog$1.InternalErrorBoundary, { children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(virtual_boltdocs_layout.default, {
 		route: currentRoute,
 		children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(react_router_dom.Outlet, {})
-	}) })] });
+	}) });
 	if (collectionsData) return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(CollectionsContext.Provider, {
 		value: collectionsData,
 		children: content
@@ -2323,6 +2422,18 @@ function createRoutes(options) {
 function DocsLayoutComponent({ children }) {
 	const { routes: filteredRoutes, currentRoute, isCollectionPage } = require_icons_dev.useRoutes();
 	const config = require_icons_dev.useConfig();
+	const AskAiDialog = useMergedComponents().AskAiDialog;
+	const [isAskAiOpen, setIsAskAiOpen] = (0, react.useState)(false);
+	(0, react.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__ */ (0, react_jsx_runtime.jsxs)(require_docs_layout.DocsLayout, {
 		className: "selection:bg-primary-500/10 selection:text-primary-500",
 		children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(Navbar, {}), /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(require_docs_layout.DocsLayout.Body, {
@@ -2359,15 +2470,17 @@ function DocsLayoutComponent({ children }) {
 								children
 							}) }),
 							!isCollectionPage && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(Feedback, {}),
+							!isCollectionPage && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(Giscus, {}),
 							/* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_docs_layout.DocsLayout.Footer, { children: !isCollectionPage && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(PageNav, {}) })
 						]
 					})
 				}),
-				/* @__PURE__ */ (0, react_jsx_runtime.jsx)(OnThisPage, {
+				AskAiDialog && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(AskAiDialog, {}),
+				!isCollectionPage && !isAskAiOpen && /* @__PURE__ */ (0, react_jsx_runtime.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/index.d.cts

@@ -1,6 +1,6 @@
 
-import { A as BoltdocsRoutePathWithFallback, C as SiteConfig, D as BoltdocsLocale, E as BoltdocsIntegrationsConfig, M as BoltdocsTypes, N as BoltdocsVersion, O as BoltdocsMdxComponents, S as SidebarProps, T as BoltdocsConfig, _ as CollectionPostLoaderData, b as NavbarLink, g as CollectionListLoaderData, h as BoltdocsTab, j as BoltdocsSocialLink, k as BoltdocsRoutePath, v as ComponentRoute, w as TabsProps, x as OnThisPageProps, y as LayoutProps } from "../sidebar-BtJyWHy4.cjs";
-import { a as ErrorBoundary, c as OnThisPage, i as CopyMarkdown, l as Sidebar, n as NotFound, o as PageNav, r as SearchDialog, s as Breadcrumbs, t as Banner, u as Navbar } from "../banner-C_xkGxzI.cjs";
+import { A as BoltdocsRoutePathWithFallback, C as SiteConfig, D as BoltdocsLocale, E as BoltdocsIntegrationsConfig, M as BoltdocsTypes, N as BoltdocsVersion, O as BoltdocsMdxComponents, S as SidebarProps, T as BoltdocsConfig, _ as CollectionPostLoaderData, b as NavbarLink, g as CollectionListLoaderData, h as BoltdocsTab, j as BoltdocsSocialLink, k as BoltdocsRoutePath, v as ComponentRoute, w as TabsProps, x as OnThisPageProps, y as LayoutProps } from "../sidebar-7gIifpBX.cjs";
+import { a as ErrorBoundary, c as OnThisPage, i as CopyMarkdown, l as Sidebar, n as NotFound, o as PageNav, r as SearchDialog, s as Breadcrumbs, t as Banner, u as Navbar } from "../banner-DNSkgUsO.cjs";
 import * as _$react from "react";
 import React$1, { ComponentType, JSXElementConstructor, ReactNode } from "react";
 import { RouteRecord, ViteReactSSG } from "@bdocs/ssg";
@@ -140,6 +140,7 @@ declare function useSearch(routes: ComponentRoute[]): {
   query: string;
   setQuery: _$react.Dispatch<_$react.SetStateAction<string>>;
   list: any[];
+  handleSelect: (key: React.Key) => void;
   input: {
     value: string;
     onChange: (e: React.ChangeEvent<HTMLInputElement>) => void;
@@ -234,7 +235,7 @@ declare function useRoutes(): {
  * Hook to automatically localize a path based on the current version and locale context.
  * It ensures that navigation preserves the active version and language across the entire site.
  */
-declare function useLocalizedTo(to: string): string;
+declare function useLocalizedTo(to: BoltdocsRoutePathWithFallback): string;
 declare function useLocalizedTo(to: LinkProps['to']): LinkProps['to'];
 //#endregion
 //#region src/client/hooks/use-location.d.ts

package/dist/client/index.d.ts

@@ -1,6 +1,6 @@
 
-import { A as BoltdocsRoutePathWithFallback, C as SiteConfig, D as BoltdocsLocale, E as BoltdocsIntegrationsConfig, M as BoltdocsTypes, N as BoltdocsVersion, O as BoltdocsMdxComponents, S as SidebarProps, T as BoltdocsConfig, _ as CollectionPostLoaderData, b as NavbarLink, g as CollectionListLoaderData, h as BoltdocsTab, j as BoltdocsSocialLink, k as BoltdocsRoutePath, v as ComponentRoute, w as TabsProps, x as OnThisPageProps, y as LayoutProps } from "../sidebar-C4fuRYYS.js";
-import { a as ErrorBoundary, c as OnThisPage, i as CopyMarkdown, l as Sidebar, n as NotFound, o as PageNav, r as SearchDialog, s as Breadcrumbs, t as Banner, u as Navbar } from "../banner-D2NddBfF.js";
+import { A as BoltdocsRoutePathWithFallback, C as SiteConfig, D as BoltdocsLocale, E as BoltdocsIntegrationsConfig, M as BoltdocsTypes, N as BoltdocsVersion, O as BoltdocsMdxComponents, S as SidebarProps, T as BoltdocsConfig, _ as CollectionPostLoaderData, b as NavbarLink, g as CollectionListLoaderData, h as BoltdocsTab, j as BoltdocsSocialLink, k as BoltdocsRoutePath, v as ComponentRoute, w as TabsProps, x as OnThisPageProps, y as LayoutProps } from "../sidebar-BAKgJ-Er.js";
+import { a as ErrorBoundary, c as OnThisPage, i as CopyMarkdown, l as Sidebar, n as NotFound, o as PageNav, r as SearchDialog, s as Breadcrumbs, t as Banner, u as Navbar } from "../banner-CfdalYLL.js";
 import { RouteRecord, ViteReactSSG } from "@bdocs/ssg";
 import * as _$react from "react";
 import React$1, { ComponentType, JSXElementConstructor, ReactNode } from "react";
@@ -140,6 +140,7 @@ declare function useSearch(routes: ComponentRoute[]): {
   query: string;
   setQuery: _$react.Dispatch<_$react.SetStateAction<string>>;
   list: any[];
+  handleSelect: (key: React.Key) => void;
   input: {
     value: string;
     onChange: (e: React.ChangeEvent<HTMLInputElement>) => void;
@@ -234,7 +235,7 @@ declare function useRoutes(): {
  * Hook to automatically localize a path based on the current version and locale context.
  * It ensures that navigation preserves the active version and language across the entire site.
  */
-declare function useLocalizedTo(to: string): string;
+declare function useLocalizedTo(to: BoltdocsRoutePathWithFallback): string;
 declare function useLocalizedTo(to: LinkProps['to']): LinkProps['to'];
 //#endregion
 //#region src/client/hooks/use-location.d.ts