@docsearch/js 5.0.0-beta.2 → 5.0.0-beta.3

package/dist/esm/index.d.ts

@@ -1,6 +1,7 @@
-/*! @docsearch/js 5.0.0-beta.2 (UNRELEASED c7e1a88) | MIT License | © Algolia, Inc. and contributors | https://docsearch.algolia.com */
-import { DocSearchAIProps as DocSearchAIProps$1 } from "@docsearch/react/docsearchAi";
+/*! @docsearch/js 5.0.0-beta.3 (UNRELEASED b044250) | MIT License | © Algolia, Inc. and contributors | https://docsearch.algolia.com */
 import { InitialAskAiMessage } from "@docsearch/core";
+import { HitComponentProps, ResultsFooterComponentProps } from "@docsearch/react";
+import { DocSearchAIProps as DocSearchAIProps$1 } from "@docsearch/react/docsearchAi";
 //#region ../../node_modules/.bun/preact@11.0.0-beta.0/node_modules/preact/src/index.d.ts
 import JSX = JSXInternal;
 //#endregion
@@ -19,18 +20,49 @@ interface DocSearchCallbacks {
   onClose?: () => void;
   interceptAskAiEvent?: (initialMessage: InitialAskAiMessage) => boolean | void;
 }
-type DocSearchProps<TProps> = DocSearchCallbacks & Omit<TProps, 'onSidepanelClose' | 'onSidepanelOpen'> & {
+type TemplateHelpers = {
+  html: typeof html;
+};
+type TemplateFnReturnType = JSX.Element | string | (() => JSX.Element) | null;
+type HitComponentFn = (props: HitComponentProps, helpers: TemplateHelpers) => TemplateFnReturnType;
+type ResultsFooterComponentFn = (props: ResultsFooterComponentProps, helpers: TemplateHelpers) => TemplateFnReturnType;
+type FooterActionFn = (props: never, helpers: TemplateHelpers) => TemplateFnReturnType;
+type DocSearchProps<TProps> = DocSearchCallbacks & Omit<TProps, 'onSidepanelClose' | 'onSidepanelOpen' | 'hitComponent' | 'resultsFooterComponent' | 'footerAction'> & {
   container: HTMLElement | string;
   environment?: typeof window;
+  /**
+   * Custom component to render an individual hit. Supports template patterns:
+   *
+   * - HTML strings with html helper: (props, { html }) => html`<div>...</div>`
+   * - JSX templates: (props) => <div>...</div>
+   * - Function-based templates: (props) => string | JSX.Element | Function.
+   */
+  hitComponent?: HitComponentFn;
+  /**
+   * Custom component rendered at the bottom of the results panel. Supports
+   * template patterns:
+   *
+   * - HTML strings with html helper: (props, { html }) => html`<div>...</div>`
+   * - JSX templates: (props) => <div>...</div>
+   * - Function-based templates: (props) => string | JSX.Element | Function.
+   */
+  resultsFooterComponent?: ResultsFooterComponentFn;
+  /**
+   * A custom action that can be rendered in the Modal's footer before the
+   * Algolia logo. The component will be rendered as a child of `<div
+   * className="DocSearch-Footer-Action" />`. Supports template patterns:
+   *
+   * - HTML strings with html helper: (props, { html }) => html`<div>...</div>`
+   * - JSX templates: (props) => <div>...</div>
+   * - Function-based templates: (props) => string | JSX.Element | Function.
+   */
+  footerAction?: FooterActionFn;
 };
 declare const html: (strings: TemplateStringsArray, ...values: unknown[]) => JSX.Element;
-type TemplateHelpers = Record<string, unknown> & {
-  html: typeof html;
-};
 //#endregion
 //#region src/docsearchAi.d.ts
 type DocSearchAIProps = DocSearchProps<DocSearchAIProps$1>;
 declare const docsearchAi: (allProps: DocSearchAIProps) => DocSearchInstance;
 //#endregion
-export { type DocSearchCallbacks, type DocSearchInstance, type DocSearchAIProps as DocSearchProps, type TemplateHelpers, docsearchAi as default };
+export { type DocSearchCallbacks, type DocSearchInstance, type DocSearchAIProps as DocSearchProps, type FooterActionFn, type HitComponentFn, type ResultsFooterComponentFn, type TemplateHelpers, docsearchAi as default };
 //# sourceMappingURL=index.d.ts.map

package/dist/esm/index.js

@@ -1,4 +1,4 @@
-/*! @docsearch/js 5.0.0-beta.2 (UNRELEASED c7e1a88) | MIT License | © Algolia, Inc. and contributors | https://docsearch.algolia.com */
+/*! @docsearch/js 5.0.0-beta.3 (UNRELEASED b044250) | MIT License | © Algolia, Inc. and contributors | https://docsearch.algolia.com */
 //#region \0rolldown/runtime.js
 var __create = Object.create;
 var __defProp$1 = Object.defineProperty;
@@ -1188,7 +1188,7 @@ function DocSearchButtonKey({ reactsToKey, children }) {
 
 //#endregion
 //#region ../docsearch-react/dist/esm/version.js
-const version$2 = "5.0.0-beta.2";
+const version$2 = "5.0.0-beta.3";
 
 //#endregion
 //#region \0@oxc-project+runtime@0.139.0/helpers/esm/OverloadYield.js
@@ -12496,7 +12496,7 @@ function useMenuParent() {
 }
 
 //#endregion
-//#region ../docsearch-react/dist/esm/normalizeDocSearchIndexes-D8P3VEXa.js
+//#region ../docsearch-react/dist/esm/normalizeDocSearchIndexes-ChnVvoVt.js
 init_compat();
 function capitalize(text) {
 	return `${text.charAt(0).toLocaleUpperCase()}${text.substring(1)}`;
@@ -12952,12 +12952,13 @@ function CommandIcon(props) {
 		strokeWidth: "1.4"
 	}, props.children));
 }
-function Footer({ translations = {}, isAskAiActive = false }) {
+function Footer({ translations = {}, isAskAiActive = false, footerAction }) {
 	const { selectText = "Select", selectKeyAriaLabel = "Enter key", submitQuestionText = "Submit question", navigateText = "Navigate", navigateUpKeyAriaLabel = "Arrow up", navigateDownKeyAriaLabel = "Arrow down", closeText = "Close", backToSearchText = "Back to search", closeKeyAriaLabel = "Escape key", poweredByText = "Powered by" } = translations;
-	return /* @__PURE__ */ En.createElement(En.Fragment, null, /* @__PURE__ */ En.createElement("div", { className: "DocSearch-Logo" }, /* @__PURE__ */ En.createElement(AlgoliaLogo, { translations: { poweredByText } })), /* @__PURE__ */ En.createElement("ul", { className: "DocSearch-Commands" }, /* @__PURE__ */ En.createElement("li", null, /* @__PURE__ */ En.createElement("kbd", { className: "DocSearch-Commands-Key" }, /* @__PURE__ */ En.createElement(CommandIcon, { ariaLabel: navigateDownKeyAriaLabel }, /* @__PURE__ */ En.createElement("path", { d: "M12 5v14" }), /* @__PURE__ */ En.createElement("path", { d: "m19 12-7 7-7-7" }))), /* @__PURE__ */ En.createElement("kbd", { className: "DocSearch-Commands-Key" }, /* @__PURE__ */ En.createElement(CommandIcon, { ariaLabel: navigateUpKeyAriaLabel }, /* @__PURE__ */ En.createElement("path", { d: "m5 12 7-7 7 7" }), /* @__PURE__ */ En.createElement("path", { d: "M12 19V5" }))), /* @__PURE__ */ En.createElement("span", { className: "DocSearch-Label" }, navigateText)), /* @__PURE__ */ En.createElement("li", null, /* @__PURE__ */ En.createElement("kbd", { className: "DocSearch-Commands-Key" }, /* @__PURE__ */ En.createElement(CommandIcon, { ariaLabel: selectKeyAriaLabel }, /* @__PURE__ */ En.createElement("polyline", { points: "9 10 4 15 9 20" }), /* @__PURE__ */ En.createElement("path", { d: "M20 4v7a4 4 0 0 1-4 4H4" }))), /* @__PURE__ */ En.createElement("span", { className: "DocSearch-Label" }, isAskAiActive ? submitQuestionText : selectText)), /* @__PURE__ */ En.createElement("li", null, /* @__PURE__ */ En.createElement("kbd", { className: "DocSearch-Commands-Key" }, /* @__PURE__ */ En.createElement("span", { className: "DocSearch-Escape-Key" }, "ESC")), /* @__PURE__ */ En.createElement("span", {
+	const hasFooterAction = footerAction !== null && footerAction !== void 0 && typeof footerAction !== "boolean";
+	return /* @__PURE__ */ En.createElement(En.Fragment, null, /* @__PURE__ */ En.createElement("ul", { className: "DocSearch-Commands" }, /* @__PURE__ */ En.createElement("li", null, /* @__PURE__ */ En.createElement("kbd", { className: "DocSearch-Commands-Key" }, /* @__PURE__ */ En.createElement(CommandIcon, { ariaLabel: navigateDownKeyAriaLabel }, /* @__PURE__ */ En.createElement("path", { d: "M12 5v14" }), /* @__PURE__ */ En.createElement("path", { d: "m19 12-7 7-7-7" }))), /* @__PURE__ */ En.createElement("kbd", { className: "DocSearch-Commands-Key" }, /* @__PURE__ */ En.createElement(CommandIcon, { ariaLabel: navigateUpKeyAriaLabel }, /* @__PURE__ */ En.createElement("path", { d: "m5 12 7-7 7 7" }), /* @__PURE__ */ En.createElement("path", { d: "M12 19V5" }))), /* @__PURE__ */ En.createElement("span", { className: "DocSearch-Label" }, navigateText)), /* @__PURE__ */ En.createElement("li", null, /* @__PURE__ */ En.createElement("kbd", { className: "DocSearch-Commands-Key" }, /* @__PURE__ */ En.createElement(CommandIcon, { ariaLabel: selectKeyAriaLabel }, /* @__PURE__ */ En.createElement("polyline", { points: "9 10 4 15 9 20" }), /* @__PURE__ */ En.createElement("path", { d: "M20 4v7a4 4 0 0 1-4 4H4" }))), /* @__PURE__ */ En.createElement("span", { className: "DocSearch-Label" }, isAskAiActive ? submitQuestionText : selectText)), /* @__PURE__ */ En.createElement("li", null, /* @__PURE__ */ En.createElement("kbd", { className: "DocSearch-Commands-Key" }, /* @__PURE__ */ En.createElement("span", { className: "DocSearch-Escape-Key" }, "ESC")), /* @__PURE__ */ En.createElement("span", {
 		className: "DocSearch-Label",
 		"aria-label": closeKeyAriaLabel
-	}, isAskAiActive ? backToSearchText : closeText))));
+	}, isAskAiActive ? backToSearchText : closeText))), /* @__PURE__ */ En.createElement("div", { className: "DocSearch-Footer-Actions" }, hasFooterAction && /* @__PURE__ */ En.createElement("div", { className: "DocSearch-Footer-Action" }, footerAction), /* @__PURE__ */ En.createElement("div", { className: "DocSearch-Logo" }, /* @__PURE__ */ En.createElement(AlgoliaLogo, { translations: { poweredByText } }))));
 }
 function Hit({ hit, children }) {
 	return /* @__PURE__ */ En.createElement("a", { href: hit.url }, children);
@@ -13115,7 +13116,7 @@ function useTrapFocus({ container }) {
 		};
 	}, [container]);
 }
-function useDocSearchModalEffects({ initialScrollY, modalRef, snippetLength, theme }) {
+function useDocSearchModalEffects({ initialScrollY, modalRef, theme }) {
 	useTheme({ theme });
 	En.useEffect(() => {
 		document.body.classList.add("DocSearch--active");
@@ -13135,9 +13136,6 @@ function useDocSearchModalEffects({ initialScrollY, modalRef, snippetLength, the
 			document.body.style.marginInlineEnd = "0px";
 		};
 	}, []);
-	En.useEffect(() => {
-		if (window.matchMedia("(max-width: 768px)").matches) snippetLength.current = 5;
-	}, [snippetLength]);
 	En.useEffect(() => {
 		function setFullViewportHeight() {
 			if (modalRef.current) {
@@ -13152,7 +13150,7 @@ function useDocSearchModalEffects({ initialScrollY, modalRef, snippetLength, the
 		};
 	}, [modalRef]);
 }
-function useModalEnvironment({ getEnvironmentProps, containerRef, dropdownRef, formElementRef, inputRef, initialScrollY, modalRef, snippetLength, theme }) {
+function useModalEnvironment({ getEnvironmentProps, containerRef, dropdownRef, formElementRef, inputRef, initialScrollY, modalRef, theme }) {
 	useTouchEvents({
 		getEnvironmentProps,
 		panelElement: dropdownRef.current,
@@ -13163,7 +13161,6 @@ function useModalEnvironment({ getEnvironmentProps, containerRef, dropdownRef, f
 	useDocSearchModalEffects({
 		initialScrollY,
 		modalRef,
-		snippetLength,
 		theme
 	});
 }
@@ -13173,8 +13170,7 @@ function useModalRefs() {
 		modalRef: En.useRef(null),
 		formElementRef: En.useRef(null),
 		dropdownRef: En.useRef(null),
-		inputRef: En.useRef(null),
-		snippetLength: En.useRef(15)
+		inputRef: En.useRef(null)
 	};
 }
 function useRefreshOnInitialQuery({ initialQuery, inputRef, refresh }) {
@@ -13528,7 +13524,7 @@ function buildNoQuerySources({ recentSearches, favoriteSearches, saveRecentSearc
 		}
 	}];
 }
-async function buildQuerySources({ query, state: sourcesState, setContext, setStatus, searchClient, indexes, snippetLength, insights, appId, apiKey, maxResultsPerGroup, transformItems = identity, saveRecentSearch, onClose, facetSelections }) {
+async function buildQuerySources({ query, state: sourcesState, setContext, setStatus, searchClient, indexes, insights, appId, apiKey, maxResultsPerGroup, transformItems = identity, saveRecentSearch, onClose, facetSelections }) {
 	const insightsActive = insights;
 	try {
 		const { results } = await searchClient.search({ requests: indexes.map((index) => {
@@ -13552,13 +13548,13 @@ async function buildQuerySources({ query, state: sourcesState, setContext, setSt
 					"url"
 				],
 				attributesToSnippet: (_searchParams$attribu2 = searchParams === null || searchParams === void 0 ? void 0 : searchParams.attributesToSnippet) !== null && _searchParams$attribu2 !== void 0 ? _searchParams$attribu2 : [
-					`hierarchy.lvl1:${snippetLength.current}`,
-					`hierarchy.lvl2:${snippetLength.current}`,
-					`hierarchy.lvl3:${snippetLength.current}`,
-					`hierarchy.lvl4:${snippetLength.current}`,
-					`hierarchy.lvl5:${snippetLength.current}`,
-					`hierarchy.lvl6:${snippetLength.current}`,
-					`content:${snippetLength.current}`
+					`hierarchy.lvl1:15`,
+					`hierarchy.lvl2:15`,
+					`hierarchy.lvl3:15`,
+					`hierarchy.lvl4:15`,
+					`hierarchy.lvl5:15`,
+					`hierarchy.lvl6:15`,
+					`content:15`
 				],
 				snippetEllipsisText: (_searchParams$snippet = searchParams === null || searchParams === void 0 ? void 0 : searchParams.snippetEllipsisText) !== null && _searchParams$snippet !== void 0 ? _searchParams$snippet : "…",
 				highlightPreTag: (_searchParams$highlig = searchParams === null || searchParams === void 0 ? void 0 : searchParams.highlightPreTag) !== null && _searchParams$highlig !== void 0 ? _searchParams$highlig : "<mark>",
@@ -27408,7 +27404,7 @@ function useChat(_ref2 = {}) {
 }
 
 //#endregion
-//#region ../docsearch-react/dist/esm/useSuggestedQuestions-Ds7H1JCr.js
+//#region ../docsearch-react/dist/esm/useSuggestedQuestions-DwcUPOf_.js
 init_compat();
 function AlertIcon(props) {
 	return /* @__PURE__ */ En.createElement("svg", _objectSpread2$2({
@@ -27864,19 +27860,52 @@ function SourcesPanel({ links, titleText = "Source", pluralTitleText = "Sources"
 		rel: "noopener noreferrer"
 	}, /* @__PURE__ */ En.createElement(ContentIcon, null), /* @__PURE__ */ En.createElement("span", { className: "DocSearch-AskAiScreen-Sources-source-title" }, l.title || l.url)))))));
 }
-/**
-* Escapes HTML special characters to prevent XSS attacks. This should be used
-* for any user-provided content that will be displayed.
-*/
-function escapeHtml$1(unsafe) {
+/** Escapes HTML special characters for safe interpolation into HTML strings. */
+function escapeHtml(unsafe) {
 	return unsafe.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&#039;");
 }
+/** Strips HTML tags and escapes the remainder for plain-text React children. */
+function sanitizeUserInput(input) {
+	return escapeHtml(input.replace(/<[^>]*>/g, ""));
+}
+function decodeUrlForSchemeCheck(value) {
+	let current = value;
+	for (let i = 0; i < 3; i += 1) try {
+		const decoded = decodeURIComponent(current);
+		if (decoded === current) break;
+		current = decoded;
+	} catch (_unused) {
+		break;
+	}
+	return current;
+}
+function stripControlsAndWhitespace(value) {
+	let result = "";
+	for (let i = 0; i < value.length; i += 1) {
+		const code = value.charCodeAt(i);
+		if (code > 32 && code !== 127) result += value[i];
+	}
+	return result;
+}
 /**
-* Sanitizes user input to prevent XSS attacks. Removes any HTML tags and
-* escapes special characters.
+* Returns a URL safe for href/src, or '' if unsafe. Does not HTML-escape —
+* callers building HTML strings must escape separately.
 */
-function sanitizeUserInput(input) {
-	return escapeHtml$1(input.replace(/<[^>]*>/g, ""));
+function sanitizeUrl(url) {
+	if (!url) return "";
+	const trimmed = url.trim();
+	if (!trimmed) return "";
+	const normalized = stripControlsAndWhitespace(decodeUrlForSchemeCheck(trimmed));
+	if (!normalized) return "";
+	if (normalized.startsWith("//")) return "";
+	if (!/^[a-zA-Z][a-zA-Z0-9+.-]*:/.test(normalized)) return trimmed;
+	try {
+		const parsed = new URL(normalized);
+		if (parsed.protocol === "http:" || parsed.protocol === "https:" || parsed.protocol === "mailto:") return normalized;
+	} catch (_unused2) {
+		return "";
+	}
+	return "";
 }
 function extractLinksFromMessage(message) {
 	const links = [];
@@ -27891,8 +27920,8 @@ function extractLinksFromMessage(message) {
 		const markdownMatches = cleanText.matchAll(markdownLinkRegex);
 		for (const match of markdownMatches) {
 			const title = match[1].trim();
-			const url = match[2];
-			if (!seen.has(url)) {
+			const url = sanitizeUrl(match[2]);
+			if (url && !seen.has(url)) {
 				seen.add(url);
 				links.push({
 					url,
@@ -27902,8 +27931,8 @@ function extractLinksFromMessage(message) {
 		}
 		const plainUrls = cleanText.matchAll(plainLinkRegex);
 		for (const match of plainUrls) {
-			const cleanUrl = match[0].replace(/[.,;:!?]+$/, "");
-			if (!seen.has(cleanUrl)) {
+			const cleanUrl = sanitizeUrl(match[0].replace(/[.,;:!?]+$/, ""));
+			if (cleanUrl && !seen.has(cleanUrl)) {
 				seen.add(cleanUrl);
 				links.push({ url: cleanUrl });
 			}
@@ -27939,11 +27968,11 @@ const getMessageContent = (message) => {
 	var _message$parts;
 	return ((_message$parts = message === null || message === void 0 ? void 0 : message.parts) !== null && _message$parts !== void 0 ? _message$parts : []).filter((part) => part.type === "text").map((part) => part.text).join("\n\n");
 };
-/** Helper function to check if error is a thread depth error (AI-217). */
+/** Helper function to check if an error reports the conversation depth limit. */
 function isThreadDepthError(error) {
 	var _error$message;
 	if (!error) return false;
-	return ((_error$message = error.message) === null || _error$message === void 0 ? void 0 : _error$message.includes("AI-217")) || false;
+	return /(?:ai-217|conversation\s+depth)/i.test((_error$message = error.message) !== null && _error$message !== void 0 ? _error$message : "");
 }
 const EMPTY_TOOLS = Object.freeze({});
 function isAIToolPart(part) {
@@ -28091,12 +28120,10 @@ function ToolCall({ part, translations, tools, onSearchQueryClick, memoryEnabled
 	});
 	return null;
 }
-function escapeHtml(html) {
-	return html.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&#39;");
-}
 const renderer = new k.Renderer();
 renderer.code = ({ text, lang = "", escaped }) => {
-	const languageClass = lang ? `language-${lang}` : "";
+	const safeLang = /^[a-zA-Z0-9_-]+$/.test(lang) ? lang : "";
+	const languageClass = safeLang ? `language-${safeLang}` : "";
 	const safeCode = escaped ? text : escapeHtml(text);
 	return `
     <div class="DocSearch-CodeSnippet">
@@ -28106,15 +28133,28 @@ renderer.code = ({ text, lang = "", escaped }) => {
   `;
 };
 renderer.link = ({ href, title, text }) => {
+	const safeHref = escapeHtml(sanitizeUrl(href));
+	const textEscaped = escapeHtml(text);
+	if (!safeHref) return textEscaped;
+	return `<a href="${safeHref}"${title ? ` title="${escapeHtml(title)}"` : ""} target="_blank" rel="noopener noreferrer">${textEscaped}</a>`;
+};
+renderer.image = ({ href, title, text }) => {
+	const safeHref = escapeHtml(sanitizeUrl(href));
+	if (!safeHref) return escapeHtml(text);
 	const titleAttr = title ? ` title="${escapeHtml(title)}"` : "";
-	return `<a href="${href ? escapeHtml(href) : ""}"${titleAttr} target="_blank" rel="noopener noreferrer">${escapeHtml(text)}</a>`;
+	return `<img src="${safeHref}" alt="${escapeHtml(text)}"${titleAttr} />`;
 };
-const MemoizedMarkdown = D$1(({ content, copyButtonText, copyButtonCopiedText, isStreaming }) => {
-	const html = q$2(() => k.parse(content, {
+renderer.html = ({ text }) => escapeHtml(text);
+/** Parses markdown into HTML safe for `dangerouslySetInnerHTML`. */
+function parseMarkdownToSafeHtml(content) {
+	return k.parse(content, {
 		gfm: true,
 		breaks: true,
 		renderer
-	}), [content]);
+	});
+}
+const MemoizedMarkdown = D$1(({ content, copyButtonText, copyButtonCopiedText, isStreaming }) => {
+	const html = q$2(() => parseMarkdownToSafeHtml(content), [content]);
 	const containerRef = F$2(null);
 	_$1(() => {
 		const container = containerRef.current;
@@ -31268,7 +31308,7 @@ function createAutocomplete(options) {
 }
 
 //#endregion
-//#region ../docsearch-react/dist/esm/DocSearchAskAiModal-BczGFkvR.js
+//#region ../docsearch-react/dist/esm/DocSearchAskAiModal-C_sH1j8Y.js
 init_compat();
 function MessageIcon() {
 	return /* @__PURE__ */ En.createElement("svg", {
@@ -31813,7 +31853,8 @@ const _excluded$7 = [
 	"recentSearchesWithFavoritesLimit",
 	"indices",
 	"facets",
-	"isHybridModeSupported"
+	"isHybridModeSupported",
+	"footerAction"
 ];
 const _excluded2 = [
 	"footer",
@@ -31822,7 +31863,7 @@ const _excluded2 = [
 ];
 function DocSearchAskAiModal(_ref) {
 	var _translations$searchB, _askAiConfig$memory$e, _askAiConfig$memory, _askAiConfig$tools;
-	let { appId, apiKey, askAi, maxResultsPerGroup, theme, onClose = noop$2, transformItems = identity, hitComponent = Hit, resultsFooterComponent = () => null, navigator, initialScrollY = 0, transformSearchClient = identity, disableUserPersonalization = false, initialQuery: initialQueryFromProp = "", translations = {}, getMissingResultsUrl, insights = false, onAskAiToggle, interceptAskAiEvent, isAskAiActive = false, recentSearchesLimit = 7, recentSearchesWithFavoritesLimit = 4, indices, facets, isHybridModeSupported = false } = _ref, props = _objectWithoutProperties$6(_ref, _excluded$7);
+	let { appId, apiKey, askAi, maxResultsPerGroup, theme, onClose = noop$2, transformItems = identity, hitComponent = Hit, resultsFooterComponent = () => null, navigator, initialScrollY = 0, transformSearchClient = identity, disableUserPersonalization = false, initialQuery: initialQueryFromProp = "", translations = {}, getMissingResultsUrl, insights = false, onAskAiToggle, interceptAskAiEvent, isAskAiActive = false, recentSearchesLimit = 7, recentSearchesWithFavoritesLimit = 4, indices, facets, isHybridModeSupported = false, footerAction } = _ref, props = _objectWithoutProperties$6(_ref, _excluded$7);
 	const { footer: footerTranslations, searchBox: searchBoxTranslations, facets: facetBarTranslations } = translations, screenStateTranslations = _objectWithoutProperties$6(translations, _excluded2);
 	const [state, setState] = En.useState({
 		query: "",
@@ -31843,7 +31884,7 @@ function DocSearchAskAiModal(_ref) {
 		var _translations$searchB3;
 		placeholder = (translations === null || translations === void 0 || (_translations$searchB3 = translations.searchBox) === null || _translations$searchB3 === void 0 ? void 0 : _translations$searchB3.placeholderTextAskAi) || "Ask another question...";
 	}
-	const { containerRef, modalRef, formElementRef, dropdownRef, inputRef, snippetLength } = useModalRefs();
+	const { containerRef, modalRef, formElementRef, dropdownRef, inputRef } = useModalRefs();
 	const { initialQuery, initialQueryFromSelection } = useInitialModalQuery(initialQueryFromProp);
 	const searchClient = useSearchClient(appId, apiKey, transformSearchClient);
 	const askAiConfig = typeof askAi === "object" ? askAi : null;
@@ -31997,7 +32038,6 @@ function DocSearchAskAiModal(_ref) {
 				setStatus,
 				searchClient,
 				indexes,
-				snippetLength,
 				insights: Boolean(insights),
 				appId,
 				apiKey,
@@ -32027,7 +32067,6 @@ function DocSearchAskAiModal(_ref) {
 		inputRef,
 		initialScrollY,
 		modalRef,
-		snippetLength,
 		theme
 	});
 	En.useEffect(() => {
@@ -32166,7 +32205,8 @@ function DocSearchAskAiModal(_ref) {
 		})),
 		footer: /* @__PURE__ */ En.createElement(Footer, {
 			translations: footerTranslations,
-			isAskAiActive
+			isAskAiActive,
+			footerAction
 		}),
 		onClose
 	});
@@ -32251,7 +32291,7 @@ init_compat();
 function isEditingContent(event) {
 	const element = event.composedPath()[0];
 	const tagName = element.tagName;
-	return element.isContentEditable || tagName === "INPUT" || tagName === "SELECT" || tagName === "TEXTAREA";
+	return element.isContentEditable || tagName === "INPUT" || tagName === "SELECT" || tagName === "TEXTAREA" || tagName === "BUTTON";
 }
 function useDocSearchKeyboardEvents({ isOpen, isAskAiActive, onAskAiToggle, onClose, onOpen, keyboardShortcuts = DEFAULT_KEYBOARD_SHORTCUTS }) {
 	En.useEffect(() => {
@@ -32549,7 +32589,8 @@ const _excluded = [
 	"environment",
 	"transformSearchClient",
 	"hitComponent",
-	"resultsFooterComponent"
+	"resultsFooterComponent",
+	"footerAction"
 ];
 function getHTMLElement(value, env) {
 	if (typeof value !== "string") return value;
@@ -32572,14 +32613,16 @@ function createTemplateFunction(original) {
 function createDocSearch(Component, version) {
 	return (allProps) => {
 		const input = allProps;
-		const { container, environment, transformSearchClient, hitComponent, resultsFooterComponent } = input, rest = _objectWithoutProperties$5(input, _excluded);
+		const { container, environment, transformSearchClient, hitComponent, resultsFooterComponent, footerAction } = input, rest = _objectWithoutProperties$5(input, _excluded);
 		const containerElement = getHTMLElement(container, environment || (typeof window !== "undefined" ? window : void 0));
 		const ref = b$2();
 		let isReady = false;
+		const FooterAction = createTemplateFunction(footerAction);
 		J$1(_$2(Component, _objectSpread2$1(_objectSpread2$1({}, rest), {}, {
 			ref,
 			hitComponent: createTemplateFunction(hitComponent),
 			resultsFooterComponent: createTemplateFunction(resultsFooterComponent),
+			footerAction: FooterAction ? _$2(FooterAction, null) : void 0,
 			transformSearchClient: (searchClient) => {
 				if (typeof searchClient === "object" && searchClient !== null && "addAlgoliaAgent" in searchClient && typeof searchClient.addAlgoliaAgent === "function") searchClient.addAlgoliaAgent("docsearch.js", version);
 				return typeof transformSearchClient === "function" ? transformSearchClient(searchClient) : searchClient;