@clarify-labs/renderer 0.6.7 → 0.7.1

package/output/{shell-DvTfFx6M.js → PageActions-yoDRjkq8.js}

@@ -3,19 +3,22 @@ import { Fragment, Suspense, createContext, forwardRef, useContext, useEffect, u
 import { Link, useLocation, useNavigate } from "react-router-dom";
 import { CloseButton, Dialog, DialogBackdrop, DialogPanel, Menu, MenuButton, MenuItem, MenuItems, TransitionChild } from "@headlessui/react";
 import * as LucideIcons from "lucide-react";
-import { Check, ChevronDown, Copy, ExternalLink, FileText, Globe2, Link2, Menu as Menu$1, Moon, MoreHorizontal, PencilLine, Search, SearchX, Sun, X } from "lucide-react";
+import { Check, ChevronDown, Copy, ExternalLink, FileText, Globe2, Link2, LoaderCircle, Menu as Menu$1, Moon, MoreHorizontal, PencilLine, Search, SearchX, Sun, X } from "lucide-react";
 import { Fragment as Fragment$1, jsx, jsxs } from "react/jsx-runtime";
 import { AnimatePresence, motion, useIsPresent, useScroll, useTransform } from "framer-motion";
 import { create, createStore, useStore } from "zustand";
 //#region source/core/context.tsx
-var ClarifyConfigContext = createContext(null);
-var ClarifyLocaleContext = createContext(void 0);
+var ConfigContext = createContext(null);
+var LocaleContext = createContext(void 0);
 var OpenApisContext = createContext({});
-function useClarifyConfig() {
-	const config = useContext(ClarifyConfigContext);
-	if (!config) throw new Error("[clarify] useClarifyConfig must be used within a ClarifyConfigContext.Provider");
+function useConfig() {
+	const config = useContext(ConfigContext);
+	if (!config) throw new Error("[clarify] useConfig must be used within a ConfigContext.Provider");
 	return config;
 }
+function useLocale() {
+	return useContext(LocaleContext);
+}
 function useOpenApis() {
 	return useContext(OpenApisContext);
 }
@@ -214,8 +217,8 @@ function translateBuiltInText(locale, key, replacements = {}) {
 	return value;
 }
 function useBuiltInText(locale) {
-	const config = useContext(ClarifyConfigContext);
-	const currentLocale = useContext(ClarifyLocaleContext);
+	const config = useContext(ConfigContext);
+	const currentLocale = useContext(LocaleContext);
 	const resolvedLocale = locale ?? currentLocale ?? config?.i18n?.defaultLocale;
 	return (key, replacements) => translateBuiltInText(resolvedLocale, key, replacements);
 }
@@ -277,7 +280,7 @@ function getAbsoluteUrl(path) {
 	return new URL(path, window.location.href).href;
 }
 function ContentActions(arg0) {
-	const { hasTabs = false, route, routePrefix } = arg0;
+	const { route, routePrefix } = arg0;
 	const t = useBuiltInText();
 	const [copied, setCopied] = useState("idle");
 	if (!route?.contentArtifactUrl && !route?.sourceUrl) return null;
@@ -328,29 +331,36 @@ function ContentActions(arg0) {
 	const primaryAction = actions[0];
 	const PrimaryIcon = primaryAction && copied === primaryAction.key ? Check : primaryAction?.icon ?? PencilLine;
 	return /* @__PURE__ */ jsx("div", {
-		className: `clarify-content-actions sticky z-20 flex justify-end py-4 ${hasTabs ? "top-16 lg:top-30" : "top-16"}`,
+		className: "clarify-content-actions not-prose flex shrink-0 justify-start sm:justify-end",
 		children: /* @__PURE__ */ jsxs(Menu, {
 			as: "div",
-			className: "clarify-content-actions-menu relative inline-flex text-sm font-medium",
+			className: "clarify-content-actions-menu relative inline-flex min-w-0 text-sm font-medium",
 			children: [/* @__PURE__ */ jsxs("div", {
-				className: "clarify-content-actions-group inline-flex overflow-hidden rounded-full border border-(--clarify-theme-tokens-colors-border) bg-(--clarify-theme-tokens-colors-surface)/90 shadow-sm shadow-zinc-900/5 backdrop-blur",
+				className: "clarify-content-actions-group inline-flex min-w-0 overflow-hidden rounded-full border border-(--clarify-theme-tokens-colors-border) bg-(--clarify-theme-tokens-colors-surface) shadow-sm shadow-zinc-900/5",
 				children: [primaryAction ? /* @__PURE__ */ jsxs("button", {
 					type: "button",
 					onClick: primaryAction.run,
-					className: "clarify-content-actions-primary clarify-ui-control inline-flex h-8 items-center gap-1.5 px-3 transition",
-					children: [/* @__PURE__ */ jsx(PrimaryIcon, { className: "h-3.5 w-3.5" }), copied === primaryAction.key ? t("actions.copied") : primaryAction.label]
+					className: "clarify-content-actions-primary clarify-ui-control inline-flex h-8 min-w-0 items-center gap-1.5 px-2.5 transition sm:px-3",
+					children: [/* @__PURE__ */ jsx(PrimaryIcon, { className: "h-3.5 w-3.5 shrink-0" }), /* @__PURE__ */ jsx("span", {
+						className: "truncate",
+						children: copied === primaryAction.key ? t("actions.copied") : primaryAction.label
+					})]
 				}) : /* @__PURE__ */ jsxs("a", {
 					href: route.sourceUrl,
 					target: "_blank",
 					rel: "noreferrer",
-					className: "clarify-content-actions-primary clarify-ui-control inline-flex h-8 items-center gap-1.5 px-3 no-underline transition",
-					children: [/* @__PURE__ */ jsx(PrimaryIcon, { className: "h-3.5 w-3.5" }), t("contentActions.editPage")]
+					className: "clarify-content-actions-primary clarify-ui-control inline-flex h-8 min-w-0 items-center gap-1.5 px-2.5 no-underline transition sm:px-3",
+					children: [/* @__PURE__ */ jsx(PrimaryIcon, { className: "h-3.5 w-3.5 shrink-0" }), /* @__PURE__ */ jsx("span", {
+						className: "truncate",
+						children: t("contentActions.editPage")
+					})]
 				}), /* @__PURE__ */ jsx(MenuButton, {
 					className: "clarify-content-actions-trigger clarify-ui-control inline-flex h-8 w-8 items-center justify-center border-l border-(--clarify-theme-tokens-colors-border) transition",
 					"aria-label": t("contentActions.copyOptions"),
 					children: /* @__PURE__ */ jsx(ChevronDown, { className: "h-3.5 w-3.5" })
 				})]
 			}), /* @__PURE__ */ jsxs(MenuItems, {
+				modal: false,
 				anchor: "bottom end",
 				className: "clarify-content-actions-list clarify-ui-menu z-30 mt-2 w-(--clarify-ui-action-menu-width) origin-top-right rounded-(--clarify-theme-tokens-radius-xl) border border-(--clarify-theme-tokens-colors-border) bg-(--clarify-theme-tokens-colors-surface) p-1.5 shadow-xl shadow-zinc-900/5 transition [--anchor-gap:--spacing(2)] focus:outline-none data-closed:scale-95 data-closed:opacity-0",
 				children: [
@@ -480,27 +490,116 @@ function ContentActions(arg0) {
 	});
 }
 //#endregion
+//#region source/theme/cookies.ts
+var themeCookieName = "clarify-theme";
+var localeCookieName = "clarify-locale";
+var preferenceCookieMaxAge = 3600 * 24 * 365;
+var cookiePath = "/";
+function isThemePreference(value) {
+	return value === "light" || value === "dark" || value === "system";
+}
+function readThemeCookie() {
+	if (typeof document === "undefined") return null;
+	const value = readCookieValue(themeCookieName);
+	return isThemePreference(value) ? value : null;
+}
+function getStoredThemePreference() {
+	return readThemeCookie() ?? "system";
+}
+function storeThemePreference(theme) {
+	storeSharedPreferenceCookie(themeCookieName, theme);
+}
+function readLocaleCookie() {
+	if (typeof document === "undefined") return null;
+	return readCookieValue(localeCookieName);
+}
+function getStoredLocalePreference(locales) {
+	const locale = readLocaleCookie();
+	if (!locale) return null;
+	return locales && !locales.includes(locale) ? null : locale;
+}
+function storeLocalePreference(locale) {
+	storeSharedPreferenceCookie(localeCookieName, locale);
+}
+function storeSharedPreferenceCookie(name, value) {
+	if (typeof document === "undefined") return;
+	const domains = resolveSharedCookieDomains();
+	const domain = resolveWritableSharedCookieDomain(domains, name);
+	deleteCookie(name);
+	for (const candidateDomain of domains) deleteCookie(name, { domain: candidateDomain });
+	writeCookie(name, value, {
+		domain: domain ?? void 0,
+		maxAge: preferenceCookieMaxAge
+	});
+}
+function resolveSharedCookieDomains(hostname = typeof window !== "undefined" ? window.location.hostname : "") {
+	const normalizedHostname = hostname.toLowerCase().replace(/\.$/, "");
+	if (!normalizedHostname || normalizedHostname === "localhost" || normalizedHostname.endsWith(".localhost") || isIpAddress(normalizedHostname)) return [];
+	const parts = normalizedHostname.split(".");
+	if (parts.length < 2) return [];
+	const domains = [];
+	for (let index = parts.length - 2; index >= 0; index -= 1) domains.push(parts.slice(index).join("."));
+	return domains;
+}
+function resolveWritableSharedCookieDomain(domains, probePrefix = themeCookieName) {
+	for (const domain of domains) {
+		const probeName = `${probePrefix}-probe-${Date.now()}-${Math.random().toString(36).slice(2)}`;
+		const probeValue = "1";
+		writeCookie(probeName, probeValue, {
+			domain,
+			maxAge: 60
+		});
+		const isWritable = readCookieValue(probeName) === probeValue;
+		deleteCookie(probeName, { domain });
+		if (isWritable) return domain;
+	}
+	return null;
+}
+function readCookieValue(cookieName) {
+	const cookies = document.cookie ? document.cookie.split("; ") : [];
+	for (const cookie of cookies) {
+		const separatorIndex = cookie.indexOf("=");
+		const name = separatorIndex === -1 ? cookie : cookie.slice(0, separatorIndex);
+		if (decodeURIComponent(name) !== cookieName) continue;
+		return separatorIndex === -1 ? "" : decodeURIComponent(cookie.slice(separatorIndex + 1));
+	}
+	return null;
+}
+function deleteCookie(name, options = {}) {
+	writeCookie(name, "", {
+		domain: options.domain,
+		maxAge: 0
+	});
+}
+function writeCookie(name, value, options) {
+	const attributes = [
+		`${encodeURIComponent(name)}=${encodeURIComponent(value)}`,
+		`Path=${cookiePath}`,
+		`Max-Age=${options.maxAge}`,
+		"SameSite=Lax"
+	];
+	if (options.domain) attributes.push(`Domain=.${options.domain}`);
+	if (typeof window !== "undefined" && window.location.protocol === "https:") attributes.push("Secure");
+	try {
+		document.cookie = attributes.join("; ");
+	} catch {}
+}
+function isIpAddress(hostname) {
+	return /^\d{1,3}(?:\.\d{1,3}){3}$/.test(hostname) || hostname.includes(":");
+}
+//#endregion
 //#region source/theme/ThemeProvider.tsx
 var ThemeContext = createContext(null);
-var storageKey = "clarify:theme";
 function getSystemTheme() {
 	if (typeof window === "undefined") return "light";
 	return window.matchMedia("(prefers-color-scheme: dark)").matches ? "dark" : "light";
 }
 function getStoredTheme() {
 	if (typeof window === "undefined") return "system";
-	try {
-		const storedTheme = window.localStorage.getItem(storageKey);
-		return storedTheme === "light" || storedTheme === "dark" || storedTheme === "system" ? storedTheme : "system";
-	} catch {
-		return "system";
-	}
+	return getStoredThemePreference();
 }
 function storeTheme(theme) {
-	if (typeof window === "undefined") return;
-	try {
-		window.localStorage.setItem(storageKey, theme);
-	} catch {}
+	storeThemePreference(theme);
 }
 function applyTheme(resolvedTheme) {
 	if (typeof document === "undefined") return;
@@ -737,7 +836,7 @@ function SectionBadge(arg0) {
 	});
 }
 function NavLink(arg0) {
-	const { href, children, badge, icon, active = false, isAnchorLink = false } = arg0;
+	const { href, children, badge, icon, active = false, isAnchorLink = false, level } = arg0;
 	function handleClick() {
 		if (!isAnchorLink) return;
 		const hashIndex = href.indexOf("#");
@@ -755,7 +854,8 @@ function NavLink(arg0) {
 		to: href,
 		"aria-current": active ? "page" : void 0,
 		onClick: handleClick,
-		className: clsx("clarify-navigation-link flex h-8 items-center justify-between gap-2 pr-3 transition", isAnchorLink ? "clarify-navigation-anchor-link pl-7" : "pl-4"),
+		className: clsx("clarify-navigation-link flex h-8 items-center justify-between gap-2 pr-3 transition", isAnchorLink ? "clarify-navigation-anchor-link" : "pl-4"),
+		style: isAnchorLink ? { paddingLeft: `${1.75 + Math.max(0, (level ?? 2) - 2) * .75}rem` } : void 0,
 		children: /* @__PURE__ */ jsxs("span", {
 			className: "flex min-w-0 flex-1 items-center gap-2",
 			children: [
@@ -844,7 +944,7 @@ function NavigationGroup(arg0) {
 	const [pathname, sections] = useInitialValue([normalizeRoutePath(useLocation().pathname), useSectionStore((s) => s.sections)], isInsideMobileNavigation);
 	const isActiveGroup = group.links.findIndex((link) => isSameRoutePath(link.href, pathname)) !== -1;
 	return /* @__PURE__ */ jsxs("li", {
-		className: clsx("clarify-navigation-group relative mt-6", className),
+		className: clsx("clarify-navigation-group relative mb-6", className),
 		children: [/* @__PURE__ */ jsxs("h2", {
 			className: "clarify-navigation-group-title flex items-center gap-2",
 			children: [/* @__PURE__ */ jsx(NavigationIcon, {
@@ -899,6 +999,7 @@ function NavigationGroup(arg0) {
 										badge: section.badge,
 										tags: section.tags,
 										isAnchorLink: true,
+										level: section.level,
 										children: section.title
 									}) }, section.id))
 								}) : null
@@ -1043,7 +1144,7 @@ function MobileNavigation(arg0) {
 	});
 }
 //#endregion
-//#region source/shell/Search.tsx
+//#region source/shell/search/items.ts
 function routeGroupTitles(navigation) {
 	const titles = /* @__PURE__ */ new Map();
 	for (const node of navigation) if (node.children?.length) for (const child of node.children) titles.set(child.path, node.title);
@@ -1080,53 +1181,85 @@ function buildSearchItems(routes, navigation) {
 		})) ?? []];
 	});
 }
-function escapeRegExp(value) {
-	return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
-}
-function HighlightQuery(arg0) {
-	const { text, query } = arg0;
-	if (!query) return text;
-	return /* @__PURE__ */ jsx(Fragment$1, { children: text.split(new RegExp(`(${escapeRegExp(query)})`, "ig")).map((part, index) => part.toLowerCase() === query.toLowerCase() ? /* @__PURE__ */ jsx("mark", {
-		className: "bg-transparent text-(--clarify-theme-tokens-colors-primary) underline",
-		children: part
-	}, index) : /* @__PURE__ */ jsx(Fragment, { children: part }, index)) });
+//#endregion
+//#region source/shell/search/pagefind.ts
+var pagefindPromises = /* @__PURE__ */ new Map();
+function pagefindCacheKey(routePrefix, locale) {
+	return `${routePrefix || "/"}:${locale || "default"}`;
 }
-function SearchResult(arg0) {
-	const { result, query, active, onSelect } = arg0;
-	const id = useId();
-	const hierarchy = [result.sectionTitle, result.pageTitle].filter((value) => typeof value === "string");
-	return /* @__PURE__ */ jsxs("li", {
-		id,
-		className: clsx("clarify-search-result group block cursor-default px-4 py-3", active && "clarify-search-result-active"),
-		"aria-selected": active,
-		onMouseDown: (event) => {
-			event.preventDefault();
-			onSelect();
-		},
-		children: [/* @__PURE__ */ jsx("div", {
-			className: "clarify-search-result-title",
-			children: /* @__PURE__ */ jsx(HighlightQuery, {
-				text: result.title,
-				query
-			})
-		}), hierarchy.length > 0 ? /* @__PURE__ */ jsx("div", {
-			className: "clarify-search-result-hierarchy mt-1 truncate whitespace-nowrap",
-			children: hierarchy.map((item, itemIndex, items) => /* @__PURE__ */ jsxs(Fragment, { children: [/* @__PURE__ */ jsx(HighlightQuery, {
-				text: item,
-				query
-			}), /* @__PURE__ */ jsx("span", {
-				className: itemIndex === items.length - 1 ? "sr-only" : "clarify-search-result-separator mx-2",
-				children: "/"
-			})] }, `${item}-${itemIndex}`))
-		}) : null]
+function logSearchDebug(message, data) {
+	if (typeof window === "undefined") return;
+	console.info(`[clarify:search] ${message}`, data ?? "");
+}
+function loadPagefind(routePrefix, locale) {
+	if (typeof window === "undefined") return Promise.resolve(null);
+	const language = locale ?? document.documentElement.lang;
+	const cacheKey = pagefindCacheKey(routePrefix, language);
+	const cachedPagefind = pagefindPromises.get(cacheKey);
+	if (cachedPagefind) {
+		logSearchDebug("reuse Pagefind instance promise", {
+			cacheKey,
+			language,
+			routePrefix
+		});
+		return cachedPagefind;
+	}
+	const pagefindUrl = prefixHref("/pagefind/pagefind.js", routePrefix);
+	logSearchDebug("create Pagefind instance promise", {
+		cacheKey,
+		language,
+		pagefindUrl,
+		routePrefix
+	});
+	const pagefindPromise = import(
+		/* @vite-ignore */
+		pagefindUrl
+).then(async (module) => {
+		const previousLanguage = document.documentElement.lang;
+		if (language) document.documentElement.lang = language;
+		logSearchDebug("create Pagefind instance", {
+			cacheKey,
+			detectedLanguage: document.documentElement.lang,
+			previousLanguage
+		});
+		const pagefind = module.createInstance();
+		if (previousLanguage && previousLanguage !== language) document.documentElement.lang = previousLanguage;
+		await pagefind.init?.();
+		logSearchDebug("Pagefind instance ready", {
+			cacheKey,
+			language
+		});
+		return pagefind;
+	}).catch((error) => {
+		pagefindPromises.delete(cacheKey);
+		console.warn("[clarify:search] Pagefind instance failed", {
+			cacheKey,
+			language,
+			error
+		});
+		return null;
 	});
+	pagefindPromises.set(cacheKey, pagefindPromise);
+	return pagefindPromise;
 }
+function normalizePagefindUrl(url, routePrefix) {
+	const parsedUrl = new URL(url, window.location.origin);
+	let pathname = parsedUrl.pathname;
+	const prefix = routePrefix && routePrefix !== "/" ? `/${routePrefix.replace(/^\/+|\/+$/g, "")}` : "";
+	if (prefix && (pathname === prefix || pathname.startsWith(`${prefix}/`))) pathname = pathname.slice(prefix.length) || "/";
+	return `${pathname}${parsedUrl.search}${parsedUrl.hash}`;
+}
+//#endregion
+//#region source/shell/search/SearchInput.tsx
 var SearchInput = forwardRef(function SearchInput(arg0, inputRef) {
-	const { query, setQuery, onClose, onSubmit, activeDescendantId } = arg0;
+	const { query, setQuery, onClose, onSubmit, activeDescendantId, loading = false } = arg0;
 	const t = useBuiltInText();
 	return /* @__PURE__ */ jsxs("div", {
 		className: "clarify-search-input group relative flex h-12",
-		children: [/* @__PURE__ */ jsx(Search, { className: "pointer-events-none absolute top-0 left-3 h-full w-5 stroke-(--clarify-theme-tokens-colors-muted)" }), /* @__PURE__ */ jsx("input", {
+		children: [/* @__PURE__ */ jsx(loading ? LoaderCircle : Search, {
+			"aria-hidden": "true",
+			className: clsx("pointer-events-none absolute top-0 left-3 h-full w-5 stroke-(--clarify-theme-tokens-colors-muted)", loading && "animate-spin")
+		}), /* @__PURE__ */ jsx("input", {
 			ref: inputRef,
 			"data-autofocus": true,
 			role: "combobox",
@@ -1148,20 +1281,120 @@ var SearchInput = forwardRef(function SearchInput(arg0, inputRef) {
 		})]
 	});
 });
+//#endregion
+//#region source/shell/search/Highlight.tsx
+function stripHtml(value) {
+	if (typeof document === "undefined") return value.replace(/<[^>]*>/g, "");
+	const template = document.createElement("template");
+	template.innerHTML = value;
+	return template.content.textContent ?? "";
+}
+function escapeRegExp(value) {
+	return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+function HighlightQuery(arg0) {
+	const { text, query } = arg0;
+	if (!query) return text;
+	return /* @__PURE__ */ jsx(Fragment$1, { children: text.split(new RegExp(`(${escapeRegExp(query)})`, "ig")).map((part, index) => part.toLowerCase() === query.toLowerCase() ? /* @__PURE__ */ jsx("mark", {
+		className: "bg-transparent text-(--clarify-theme-tokens-colors-primary) underline",
+		children: part
+	}, index) : /* @__PURE__ */ jsx(Fragment, { children: part }, index)) });
+}
+function renderExcerptNode(node, key) {
+	if (node.nodeType === Node.TEXT_NODE) return node.textContent;
+	if (node.nodeType !== Node.ELEMENT_NODE) return null;
+	const element = node;
+	const children = Array.from(element.childNodes).map((child, index) => renderExcerptNode(child, `${key}-${index}`));
+	if (element.tagName.toLowerCase() === "mark") return /* @__PURE__ */ jsx("mark", {
+		className: "bg-transparent text-(--clarify-theme-tokens-colors-primary) underline",
+		children
+	}, key);
+	return /* @__PURE__ */ jsx(Fragment, { children }, key);
+}
+function HighlightExcerpt(arg0) {
+	const { excerpt, query } = arg0;
+	if (typeof document === "undefined" || !excerpt.includes("<mark")) return /* @__PURE__ */ jsx(HighlightQuery, {
+		text: stripHtml(excerpt),
+		query
+	});
+	const template = document.createElement("template");
+	template.innerHTML = excerpt;
+	return /* @__PURE__ */ jsx(Fragment$1, { children: Array.from(template.content.childNodes).map((node, index) => renderExcerptNode(node, String(index))) });
+}
+//#endregion
+//#region source/shell/search/SearchResult.tsx
+function SearchResult(arg0) {
+	const { result, query, active, onActive, onSelect } = arg0;
+	const id = useId();
+	const hierarchy = result.type === "quick" ? [result.sectionTitle, result.pageTitle].filter((value) => typeof value === "string") : [];
+	return /* @__PURE__ */ jsxs("li", {
+		id,
+		className: clsx("clarify-search-result group block cursor-pointer px-4 py-3", active && "clarify-search-result-active"),
+		"aria-selected": active,
+		onMouseEnter: onActive,
+		onMouseMove: onActive,
+		onMouseDown: (event) => {
+			event.preventDefault();
+			onSelect();
+		},
+		children: [
+			/* @__PURE__ */ jsx("div", {
+				className: "clarify-search-result-title",
+				children: /* @__PURE__ */ jsx(HighlightQuery, {
+					text: result.title,
+					query
+				})
+			}),
+			hierarchy.length > 0 ? /* @__PURE__ */ jsx("div", {
+				className: "clarify-search-result-hierarchy mt-1 truncate whitespace-nowrap",
+				children: hierarchy.map((item, itemIndex, items) => /* @__PURE__ */ jsxs(Fragment, { children: [/* @__PURE__ */ jsx(HighlightQuery, {
+					text: item,
+					query
+				}), /* @__PURE__ */ jsx("span", {
+					className: itemIndex === items.length - 1 ? "sr-only" : "clarify-search-result-separator mx-2",
+					children: "/"
+				})] }, `${item}-${itemIndex}`))
+			}) : null,
+			result.type === "full-text" && result.excerpt ? /* @__PURE__ */ jsx("p", {
+				className: "clarify-search-result-excerpt mt-1 line-clamp-2 text-xs leading-5 text-(--clarify-theme-tokens-colors-muted)",
+				children: /* @__PURE__ */ jsx(HighlightExcerpt, {
+					excerpt: result.excerpt,
+					query
+				})
+			}) : null
+		]
+	});
+}
+//#endregion
+//#region source/shell/search/SearchDialog.tsx
 function SearchDialog(arg0) {
-	const { open, setOpen, routes, navigation, className, onNavigate = () => {} } = arg0;
+	const { open, setOpen, routes, navigation, routePrefix = "/", currentLocale, className, onNavigate = () => {} } = arg0;
 	const t = useBuiltInText();
 	const navigate = useNavigate();
 	const location = useLocation();
 	const inputRef = useRef(null);
 	const [query, setQuery] = useState("");
 	const [activeIndex, setActiveIndex] = useState(0);
+	const [fullTextState, setFullTextState] = useState(null);
+	const [pagefindState, setPagefindState] = useState(null);
 	const searchItems = useMemo(() => buildSearchItems(routes, navigation), [navigation, routes]);
-	const results = useMemo(() => {
+	const quickResults = useMemo(() => {
 		const normalizedQuery = query.trim().toLowerCase();
 		if (!normalizedQuery) return [];
-		return searchItems.filter((item) => item.keywords.includes(normalizedQuery)).slice(0, 8);
+		return searchItems.filter((item) => item.keywords.includes(normalizedQuery)).slice(0, 8).map((item) => ({
+			...item,
+			type: "quick"
+		}));
 	}, [query, searchItems]);
+	const pagefindKey = pagefindCacheKey(routePrefix, currentLocale);
+	const activePagefindState = pagefindState?.key === pagefindKey ? pagefindState : null;
+	const pagefind = activePagefindState?.pagefind ?? null;
+	const pagefindAvailable = activePagefindState?.available ?? null;
+	const trimmedQuery = query.trim();
+	const fullTextKey = `${pagefindKey}:${trimmedQuery}`;
+	const results = (fullTextState?.key === fullTextKey ? fullTextState.results : null) ?? quickResults;
+	const searchInputLoading = pagefindAvailable === null || Boolean(trimmedQuery && pagefind && fullTextState?.key !== fullTextKey);
+	const showNoResults = query && results.length === 0 && pagefindAvailable !== null;
 	useEffect(() => {
 		setOpen(false);
 	}, [
@@ -1170,6 +1403,98 @@ function SearchDialog(arg0) {
 		location.hash,
 		setOpen
 	]);
+	useEffect(() => {
+		let cancelled = false;
+		logSearchDebug("locale or route prefix changed; reload Pagefind", {
+			currentLocale,
+			routePrefix,
+			documentLanguage: document.documentElement.lang
+		});
+		loadPagefind(routePrefix, currentLocale).then((loadedPagefind) => {
+			if (cancelled) {
+				logSearchDebug("ignore stale Pagefind load", {
+					currentLocale,
+					routePrefix
+				});
+				return;
+			}
+			logSearchDebug("Pagefind load applied", {
+				currentLocale,
+				routePrefix,
+				available: Boolean(loadedPagefind)
+			});
+			setPagefindState({
+				key: pagefindKey,
+				pagefind: loadedPagefind,
+				available: Boolean(loadedPagefind)
+			});
+		});
+		return () => {
+			cancelled = true;
+			logSearchDebug("cancel Pagefind load effect", {
+				currentLocale,
+				routePrefix
+			});
+		};
+	}, [
+		currentLocale,
+		pagefindKey,
+		routePrefix
+	]);
+	useEffect(() => {
+		let cancelled = false;
+		if (!trimmedQuery || !pagefind) return void 0;
+		Promise.resolve().then(async () => {
+			if (cancelled) return;
+			try {
+				logSearchDebug("run Pagefind search", {
+					currentLocale,
+					query: trimmedQuery,
+					routePrefix
+				});
+				const search = await pagefind.search(trimmedQuery, { limit: 8 });
+				const data = await Promise.all(search.results.map(async (result) => ({
+					id: result.id,
+					data: await result.data()
+				})));
+				if (cancelled) return;
+				logSearchDebug("Pagefind search results", {
+					currentLocale,
+					query: trimmedQuery,
+					count: data.length
+				});
+				setFullTextState({
+					key: fullTextKey,
+					results: data.map(({ id, data }) => ({
+						type: "full-text",
+						id,
+						title: data.meta.title || data.url,
+						url: normalizePagefindUrl(data.url, routePrefix),
+						excerpt: data.excerpt
+					}))
+				});
+			} catch (error) {
+				console.warn("[clarify:search] Pagefind search failed", {
+					currentLocale,
+					query: trimmedQuery,
+					error
+				});
+				if (!cancelled) setFullTextState({
+					key: fullTextKey,
+					results: null
+				});
+			}
+		});
+		return () => {
+			cancelled = true;
+		};
+	}, [
+		currentLocale,
+		fullTextKey,
+		pagefind,
+		routePrefix,
+		trimmedQuery
+	]);
 	useEffect(() => {
 		if (open) return void 0;
 		function onKeyDown(event) {
@@ -1222,10 +1547,11 @@ function SearchDialog(arg0) {
 					query,
 					setQuery: updateQuery,
 					onClose: closeDialog,
-					onSubmit: () => selectResult()
+					onSubmit: () => selectResult(),
+					loading: searchInputLoading
 				}), /* @__PURE__ */ jsxs("div", {
 					className: "border-t border-(--clarify-theme-tokens-colors-border) bg-(--clarify-theme-tokens-colors-background) empty:hidden dark:border-zinc-100/5 dark:bg-white/2.5",
-					children: [query && results.length === 0 ? /* @__PURE__ */ jsxs("div", {
+					children: [showNoResults ? /* @__PURE__ */ jsxs("div", {
 						className: "p-6 text-center",
 						children: [/* @__PURE__ */ jsx(SearchX, { className: "mx-auto h-5 w-5 stroke-(--clarify-theme-tokens-colors-foreground) dark:stroke-zinc-600" }), /* @__PURE__ */ jsx("p", {
 							className: "mt-2 text-xs text-(--clarify-theme-tokens-colors-muted) dark:text-zinc-400",
@@ -1239,14 +1565,17 @@ function SearchDialog(arg0) {
 							result,
 							query,
 							active: resultIndex === activeIndex,
+							onActive: () => setActiveIndex(resultIndex),
 							onSelect: () => selectResult(result)
-						}, result.url))
+						}, result.type === "full-text" ? result.id : result.url))
 					}) : null]
 				})]
 			})
 		})]
 	});
 }
+//#endregion
+//#region source/shell/search/useSearchProps.ts
 function useSearchProps() {
 	const buttonRef = useRef(null);
 	const [open, setOpen] = useState(false);
@@ -1263,12 +1592,14 @@ function useSearchProps() {
 		}
 	};
 }
+//#endregion
+//#region source/shell/Search.tsx
 function getModifierKey() {
 	if (typeof navigator === "undefined") return "Ctrl ";
 	return /(Mac|iPhone|iPod|iPad)/i.test(navigator.platform) ? "⌘" : "Ctrl ";
 }
 function Search$1(arg0) {
-	const { routes, navigation } = arg0;
+	const { routes, navigation, routePrefix, currentLocale } = arg0;
 	const t = useBuiltInText();
 	const modifierKey = getModifierKey();
 	const { buttonProps, dialogProps } = useSearchProps();
@@ -1298,13 +1629,15 @@ function Search$1(arg0) {
 				className: "hidden lg:block",
 				routes,
 				navigation,
+				routePrefix,
+				currentLocale,
 				...dialogProps
 			})
 		})]
 	});
 }
 function MobileSearch(arg0) {
-	const { routes, navigation, onNavigate } = arg0;
+	const { routes, navigation, routePrefix, currentLocale, onNavigate } = arg0;
 	const t = useBuiltInText();
 	const { buttonProps, dialogProps } = useSearchProps();
 	return /* @__PURE__ */ jsxs("div", {
@@ -1321,6 +1654,8 @@ function MobileSearch(arg0) {
 				className: "lg:hidden",
 				routes,
 				navigation,
+				routePrefix,
+				currentLocale,
 				onNavigate,
 				...dialogProps
 			})
@@ -1399,6 +1734,7 @@ function LanguageSwitcher(arg0) {
 				const selected = locale.code === selectedLocale;
 				return [/* @__PURE__ */ jsx(MenuItem, { children: ({ focus }) => /* @__PURE__ */ jsxs(Link, {
 					to: `${localizedPath}${suffix}`,
+					onClick: () => storeLocalePreference(locale.code),
 					className: clsx("clarify-language-switcher-item clarify-ui-menu-item flex items-center justify-between rounded-(--clarify-theme-tokens-radius-lg) px-3 py-2 no-underline transition", focus && "clarify-ui-menu-item-focus", selected && "clarify-ui-menu-item-active"),
 					"aria-current": selected ? "true" : void 0,
 					lang: locale.code,
@@ -1427,6 +1763,10 @@ function TopLevelNavItem(arg0) {
 		children
 	}) });
 }
+function resolveHomeHref(config, currentLocale) {
+	const homeUrl = config.homeUrl ?? "/";
+	return isExternalHref(homeUrl) ? homeUrl : localizeHref(homeUrl, config, currentLocale);
+}
 function MobileNavbarMenu(arg0) {
 	const { links, config, currentLocale } = arg0;
 	const t = useBuiltInText();
@@ -1508,94 +1848,137 @@ function ProductTabs(arg0) {
 	});
 }
 var Header = forwardRef(function Header(arg0, ref) {
-	const { config, navigation, tabs, routes, currentLocale, currentRoute, className, ...props } = arg0;
+	const { config, navigation, tabs, routes, currentLocale, currentRoute, banner, className, ...props } = arg0;
 	const t = useBuiltInText();
 	const { isOpen: mobileNavIsOpen } = useMobileNavigationStore();
 	const isInsideMobileNavigation = useIsInsideMobileNavigation();
+	const homeHref = resolveHomeHref(config, currentLocale);
+	const homeExternal = isExternalHref(homeHref);
 	const { scrollY } = useScroll();
 	const bgOpacityLight = useTransform(scrollY, [0, 72], ["70%", "95%"]);
 	const bgOpacityDark = useTransform(scrollY, [0, 72], ["60%", "92%"]);
 	return /* @__PURE__ */ jsxs(motion.header, {
 		...props,
 		ref,
+		"data-pagefind-ignore": true,
 		className: clsx(className, "clarify-header fixed inset-x-0 top-0 z-50 border-b border-(--clarify-theme-tokens-colors-border) bg-(--clarify-theme-tokens-colors-background)/(--bg-opacity-light) backdrop-blur-xs transition dark:border-white/10 dark:bg-zinc-950/(--bg-opacity-dark) dark:backdrop-blur-sm", isInsideMobileNavigation && "bg-(--clarify-theme-tokens-colors-background) dark:bg-zinc-950"),
 		style: {
 			"--bg-opacity-light": bgOpacityLight,
 			"--bg-opacity-dark": bgOpacityDark
 		},
-		children: [/* @__PURE__ */ jsxs("div", {
-			className: clsx("clarify-header-main relative mx-auto flex h-14 w-full max-w-(--clarify-theme-layout-max-width) items-center justify-between gap-6 px-4 sm:px-6 lg:px-5", (isInsideMobileNavigation || !mobileNavIsOpen) && "shadow-none"),
-			children: [
-				/* @__PURE__ */ jsxs("div", {
-					className: "clarify-header-left flex min-w-0 items-center gap-5",
-					children: [/* @__PURE__ */ jsx("div", {
-						className: "clarify-mobile-brand flex items-center gap-5 lg:hidden",
-						children: /* @__PURE__ */ jsx(MobileNavigation, {
-							config,
-							navigation,
-							tabs,
-							routes,
-							currentLocale,
-							currentRoute
-						})
-					}), /* @__PURE__ */ jsxs(CloseButton, {
-						as: Link,
-						to: localizeHref("/", config, currentLocale),
-						"aria-label": t("navbar.home"),
-						className: "clarify-brand flex min-w-0 items-center gap-2 no-underline",
-						children: [/* @__PURE__ */ jsx(SiteLogo, {
-							logo: config.logo,
-							className: "h-6 w-6 shrink-0"
-						}), /* @__PURE__ */ jsx("span", {
-							className: "clarify-brand-title truncate font-semibold",
-							children: config.title
-						})]
-					})]
-				}),
-				/* @__PURE__ */ jsx("div", {
-					className: "clarify-header-center absolute left-1/2 hidden -translate-x-1/2 lg:block",
-					children: /* @__PURE__ */ jsx(Search$1, {
-						routes,
-						navigation
-					})
-				}),
-				/* @__PURE__ */ jsxs("div", {
-					className: "clarify-header-actions flex shrink-0 items-center gap-5",
-					children: [
-						config.navbar?.links?.length ? /* @__PURE__ */ jsx("nav", {
-							className: "clarify-top-nav hidden md:block",
-							children: /* @__PURE__ */ jsx("ul", {
-								role: "list",
-								className: "flex items-center gap-8",
-								children: config.navbar.links.map((link) => /* @__PURE__ */ jsx(TopLevelNavItem, {
-									href: localizeHref(link.href, config, currentLocale),
-									children: resolveLocalizedText(link.label, currentLocale, config.i18n?.defaultLocale)
-								}, link.href))
+		children: [
+			/* @__PURE__ */ jsxs("div", {
+				className: clsx("clarify-header-main relative mx-auto flex h-14 w-full max-w-(--clarify-theme-layout-max-width) items-center justify-between gap-6 px-4 sm:px-6 lg:px-5", (isInsideMobileNavigation || !mobileNavIsOpen) && "shadow-none"),
+				children: [
+					/* @__PURE__ */ jsxs("div", {
+						className: "clarify-header-left flex min-w-0 items-center gap-5",
+						children: [/* @__PURE__ */ jsx("div", {
+							className: "clarify-mobile-brand flex items-center gap-5 lg:hidden",
+							children: /* @__PURE__ */ jsx(MobileNavigation, {
+								config,
+								navigation,
+								tabs,
+								routes,
+								currentLocale,
+								currentRoute
 							})
-						}) : null,
-						config.navbar?.links?.length ? /* @__PURE__ */ jsx("div", { className: "hidden md:block md:h-5 md:w-px md:bg-(--clarify-theme-tokens-colors-border) md:dark:bg-white/15" }) : null,
-						/* @__PURE__ */ jsx(MobileSearch, {
+						}), homeExternal ? /* @__PURE__ */ jsxs(CloseButton, {
+							as: "a",
+							href: homeHref,
+							"aria-label": t("navbar.home"),
+							className: "clarify-brand flex min-w-0 items-center gap-2 no-underline",
+							children: [/* @__PURE__ */ jsx(SiteLogo, {
+								logo: config.logo,
+								className: "h-6 w-auto shrink-0 object-contain"
+							}), /* @__PURE__ */ jsx("span", {
+								className: "clarify-brand-title truncate font-semibold",
+								children: config.title
+							})]
+						}) : /* @__PURE__ */ jsxs(CloseButton, {
+							as: Link,
+							to: homeHref,
+							"aria-label": t("navbar.home"),
+							className: "clarify-brand flex min-w-0 items-center gap-2 no-underline",
+							children: [/* @__PURE__ */ jsx(SiteLogo, {
+								logo: config.logo,
+								className: "h-6 w-auto shrink-0 object-contain"
+							}), /* @__PURE__ */ jsx("span", {
+								className: "clarify-brand-title truncate font-semibold",
+								children: config.title
+							})]
+						})]
+					}),
+					/* @__PURE__ */ jsx("div", {
+						className: "clarify-header-center absolute left-1/2 hidden -translate-x-1/2 lg:block",
+						children: /* @__PURE__ */ jsx(Search$1, {
 							routes,
-							navigation
-						}),
-						/* @__PURE__ */ jsx(LanguageSwitcher, {
-							config,
-							currentLocale,
-							currentRoute
-						}),
-						/* @__PURE__ */ jsx(ThemeToggle, {}),
-						/* @__PURE__ */ jsx(MobileNavbarMenu, {
-							links: config.navbar?.links,
-							config,
+							navigation,
+							routePrefix: config.routePrefix,
 							currentLocale
 						})
-					]
-				})
-			]
-		}), /* @__PURE__ */ jsx(ProductTabs, { tabs })]
+					}),
+					/* @__PURE__ */ jsxs("div", {
+						className: "clarify-header-actions flex shrink-0 items-center gap-5",
+						children: [
+							config.navbar?.links?.length ? /* @__PURE__ */ jsx("nav", {
+								className: "clarify-top-nav hidden md:block",
+								children: /* @__PURE__ */ jsx("ul", {
+									role: "list",
+									className: "flex items-center gap-8",
+									children: config.navbar.links.map((link) => /* @__PURE__ */ jsx(TopLevelNavItem, {
+										href: localizeHref(link.href, config, currentLocale),
+										children: resolveLocalizedText(link.label, currentLocale, config.i18n?.defaultLocale)
+									}, link.href))
+								})
+							}) : null,
+							config.navbar?.links?.length ? /* @__PURE__ */ jsx("div", { className: "hidden md:block md:h-5 md:w-px md:bg-(--clarify-theme-tokens-colors-border) md:dark:bg-white/15" }) : null,
+							/* @__PURE__ */ jsx(MobileSearch, {
+								routes,
+								navigation,
+								routePrefix: config.routePrefix,
+								currentLocale
+							}),
+							/* @__PURE__ */ jsx(LanguageSwitcher, {
+								config,
+								currentLocale,
+								currentRoute
+							}),
+							/* @__PURE__ */ jsx(ThemeToggle, {}),
+							/* @__PURE__ */ jsx(MobileNavbarMenu, {
+								links: config.navbar?.links,
+								config,
+								currentLocale
+							})
+						]
+					})
+				]
+			}),
+			banner,
+			/* @__PURE__ */ jsx(ProductTabs, { tabs })
+		]
 	});
 });
 //#endregion
-export { useClarifyConfig as C, OpenApisContext as S, prefixHref as _, useSectionStore as a, ClarifyConfigContext as b, resolveLucideIconName as c, ThemeToggle as d, ThemeProvider as f, localizeHref as g, isExternalHref as h, SectionProvider as i, isSameRoutePath as l, ContentActions as m, Navigation as n, remToPx as o, useTheme as p, safeDecodeURIComponent as r, lucideIconRegistry as s, Header as t, normalizeRoutePath as u, copyTextToClipboard as v, useOpenApis as w, ClarifyLocaleContext as x, useBuiltInText as y };
+//#region source/app/PageActions.tsx
+var PageActionsContext = createContext({});
+function PageActionsProvider(props) {
+	const { children, route, routePrefix } = props;
+	return /* @__PURE__ */ jsx(PageActionsContext.Provider, {
+		value: {
+			route,
+			routePrefix
+		},
+		children
+	});
+}
+function PageTitleActions() {
+	const { route, routePrefix } = useContext(PageActionsContext);
+	return /* @__PURE__ */ jsx(ContentActions, {
+		route,
+		routePrefix
+	});
+}
+//#endregion
+export { OpenApisContext as A, isExternalHref as C, useBuiltInText as D, copyTextToClipboard as E, useLocale as M, useOpenApis as N, ConfigContext as O, themeCookieName as S, prefixHref as T, getStoredThemePreference as _, safeDecodeURIComponent as a, storeLocalePreference as b, remToPx as c, isSameRoutePath as d, normalizeRoutePath as f, getStoredLocalePreference as g, useTheme as h, Navigation as i, useConfig as j, LocaleContext as k, lucideIconRegistry as l, ThemeProvider as m, PageTitleActions as n, SectionProvider as o, ThemeToggle as p, Header as r, useSectionStore as s, PageActionsProvider as t, resolveLucideIconName as u, localeCookieName as v, localizeHref as w, storeThemePreference as x, readLocaleCookie as y };
 
-//# sourceMappingURL=shell-DvTfFx6M.js.map
+//# sourceMappingURL=PageActions-yoDRjkq8.js.map