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

package/README.md

@@ -34,7 +34,7 @@ import '@docsearch/css';
 docsearch({
   container: '#docsearch',
   appId: 'YOUR_APP_ID',
-  indexName: 'YOUR_INDEX_NAME',
+  indices: ['YOUR_INDEX_NAME'],
   apiKey: 'YOUR_SEARCH_API_KEY',
 });
 ```
@@ -53,7 +53,7 @@ import '@docsearch/css';
 docsearch({
   container: '#docsearch',
   appId: 'YOUR_APP_ID',
-  indexName: 'YOUR_INDEX_NAME',
+  indices: ['YOUR_INDEX_NAME'],
   apiKey: 'YOUR_SEARCH_API_KEY',
 });
 ```
@@ -66,7 +66,7 @@ For a standalone keyword-only script, load the explicit UMD file:
   window.docsearch({
     container: '#docsearch',
     appId: 'YOUR_APP_ID',
-    indexName: 'YOUR_INDEX_NAME',
+    indices: ['YOUR_INDEX_NAME'],
     apiKey: 'YOUR_SEARCH_API_KEY',
   });
 </script>

package/dist/esm/docsearch.d.ts

@@ -1,4 +1,4 @@
-/*! @docsearch/js 5.0.0-beta.0 (UNRELEASED 1b6607c) | MIT License | © Algolia, Inc. and contributors | https://docsearch.algolia.com */
+/*! @docsearch/js 5.0.0-beta.2 (UNRELEASED c7e1a88) | MIT License | © Algolia, Inc. and contributors | https://docsearch.algolia.com */
 import { DocSearchProps as DocSearchProps$1 } from "@docsearch/react";
 import { InitialAskAiMessage } from "@docsearch/core";
 //#region ../../node_modules/.bun/preact@11.0.0-beta.0/node_modules/preact/src/index.d.ts

package/dist/esm/docsearch.js

@@ -1,4 +1,4 @@
-/*! @docsearch/js 5.0.0-beta.0 (UNRELEASED 1b6607c) | MIT License | © Algolia, Inc. and contributors | https://docsearch.algolia.com */
+/*! @docsearch/js 5.0.0-beta.2 (UNRELEASED c7e1a88) | MIT License | © Algolia, Inc. and contributors | https://docsearch.algolia.com */
 //#region \0rolldown/runtime.js
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
@@ -1182,7 +1182,7 @@ function DocSearchButtonKey({ reactsToKey, children }) {
 
 //#endregion
 //#region ../docsearch-react/dist/esm/version.js
-const version$1 = "5.0.0-beta.0";
+const version$1 = "5.0.0-beta.2";
 
 //#endregion
 //#region \0@oxc-project+runtime@0.139.0/helpers/esm/OverloadYield.js
@@ -12159,7 +12159,7 @@ function useMixedToggleClickHandler(params) {
 //#endregion
 //#region ../../node_modules/.bun/@base-ui+react@1.6.0+fce4ea6354698f9c/node_modules/@base-ui/react/menu/trigger/MenuTrigger.mjs
 init_compat();
-const _excluded$10 = [
+const _excluded$9 = [
 	"render",
 	"className",
 	"style",
@@ -12179,9 +12179,9 @@ const BOUNDARY_OFFSET = 2;
 *
 * Documentation: [Base UI Menu](https://base-ui.com/react/components/menu)
 */
-const MenuTrigger$1 = fastComponentRef(function MenuTrigger(componentProps, forwardedRef) {
+const MenuTrigger = fastComponentRef(function MenuTrigger(componentProps, forwardedRef) {
 	var _handle$store;
-	const { render, className, style, disabled: disabledProp = false, nativeButton = true, id: idProp, openOnHover: openOnHoverProp, delay = 100, closeDelay = 0, handle, payload } = componentProps, elementProps = _objectWithoutProperties$5(componentProps, _excluded$10);
+	const { render, className, style, disabled: disabledProp = false, nativeButton = true, id: idProp, openOnHover: openOnHoverProp, delay = 100, closeDelay = 0, handle, payload } = componentProps, elementProps = _objectWithoutProperties$5(componentProps, _excluded$9);
 	const rootContext = useMenuRootContext(true);
 	const store = (_handle$store = handle === null || handle === void 0 ? void 0 : handle.store) !== null && _handle$store !== void 0 ? _handle$store : rootContext === null || rootContext === void 0 ? void 0 : rootContext.store;
 	if (!store) throw new Error(formatErrorMessage(85));
@@ -12380,7 +12380,7 @@ function useMenuParent() {
 }
 
 //#endregion
-//#region ../docsearch-react/dist/esm/normalizeDocSearchIndexes-DAzlMybx.js
+//#region ../docsearch-react/dist/esm/normalizeDocSearchIndexes-D8P3VEXa.js
 init_compat();
 function capitalize(text) {
 	return `${text.charAt(0).toLocaleUpperCase()}${text.substring(1)}`;
@@ -12441,6 +12441,10 @@ function identity(x) {
 function isModifierEvent(event) {
 	return event.button === 1 || event.altKey || event.ctrlKey || event.metaKey || event.shiftKey;
 }
+function isQueryEmpty(query) {
+	if (!query || query.trim().length === 0) return true;
+	return false;
+}
 function noop$1(..._args) {}
 const regexHighlightTags = /(<mark>|<\/mark>)/g;
 const regexHasHighlightTags = RegExp(regexHighlightTags.source);
@@ -12556,6 +12560,22 @@ function getFacetLabel(facet) {
 	if (facet.label) return facet.label;
 	return facet.key.replace(/[._-]+/g, " ").replace(/\b\w/g, (letter) => letter.toUpperCase());
 }
+function deriveDefaultSelectedFacetsFromIndex(indices) {
+	const defaultFacets = {};
+	for (const index of indices) {
+		var _index$searchParamete;
+		const facetFilters = (_index$searchParamete = index.searchParameters) === null || _index$searchParamete === void 0 ? void 0 : _index$searchParamete.facetFilters;
+		for (const facetFilter of Array.isArray(facetFilters) ? facetFilters : [facetFilters]) {
+			if (typeof facetFilter !== "string") continue;
+			const separatorIndex = facetFilter.indexOf(":");
+			if (separatorIndex <= 0) continue;
+			const key = facetFilter.slice(0, separatorIndex);
+			const value = facetFilter.slice(separatorIndex + 1);
+			if (key && value) defaultFacets[key] = value;
+		}
+	}
+	return defaultFacets;
+}
 const _excluded$6$4 = ["className", "type"];
 function Chip({ children }) {
 	return /* @__PURE__ */ En.createElement("div", { className: "DocSearch-Chip" }, children);
@@ -12585,12 +12605,14 @@ function Menu$1(_ref) {
 	let props = _extends({}, (_objectDestructuringEmpty(_ref), _ref));
 	return /* @__PURE__ */ En.createElement(MenuRoot, props);
 }
-function MenuTrigger(_ref2) {
+Menu$1.Trigger = En.forwardRef((_ref2, ref) => {
 	let { className } = _ref2, props = _objectWithoutProperties$6(_ref2, _excluded$5$4);
 	const cn = `DocSearch-Menu-Trigger${className ? ` ${className}` : ""}`;
-	return /* @__PURE__ */ En.createElement(MenuTrigger$1, _objectSpread2$2({ className: cn }, props));
-}
-Menu$1.Trigger = MenuTrigger;
+	return /* @__PURE__ */ En.createElement(MenuTrigger, _objectSpread2$2({
+		className: cn,
+		ref
+	}, props));
+});
 function MenuPopup(_ref3) {
 	let { align = "start", alignOffset = 0, side = "bottom", sideOffset = 4, collisionBoundary = "clipping-ancestors", container } = _ref3, props = _objectWithoutProperties$6(_ref3, _excluded2$3);
 	return /* @__PURE__ */ En.createElement(MenuPortal, { container }, /* @__PURE__ */ En.createElement(MenuPositioner, {
@@ -12658,9 +12680,10 @@ const SelectedFacetChip = En.memo(function SelectedFacetChip({ facetKey, facetLa
 });
 const FacetBar = En.memo(function FacetBar({ facets, selections, onSelectionChange, clearSelections, translations = {} }) {
 	const { defaultValueLabel = "All", facetMenuTriggerAriaLabel = "selected", clearAllLabel = "Clear all", facetsAriaLabel = "Search filters", selectedFacetsAriaLabel = "Selected search filters", clearFacetAriaLabel = "Clear filter:" } = translations;
+	const visibleFacetKeys = En.useMemo(() => new Set(facets.map((f) => f.key)), [facets]);
 	const selectionsToDisplay = En.useMemo(() => {
-		return Object.entries(selections).filter(([_, value]) => Boolean(value));
-	}, [selections]);
+		return Object.entries(selections).filter(([key, value]) => Boolean(value) && visibleFacetKeys.has(key));
+	}, [selections, visibleFacetKeys]);
 	const triggerRefs = En.useRef(/* @__PURE__ */ new Map());
 	const registerTrigger = En.useCallback((facetKey, el) => {
 		if (el) triggerRefs.current.set(facetKey, el);
@@ -12833,21 +12856,15 @@ function useFacetValues({ facets, indexes, searchClient }) {
 	En.useEffect(() => {
 		let isMounted = true;
 		const facetKeys = stableFacetKeys ? stableFacetKeys.split(",") : [];
-		if (facetKeys.length === 0 || indexes.length === 0) {
-			setFacetValues({});
-			return () => {
-				isMounted = false;
-			};
-		}
-		searchClient.search({ requests: indexes.map((index) => {
-			var _index$searchParamete2;
-			return _objectSpread2$2(_objectSpread2$2({}, (_index$searchParamete2 = index.searchParameters) !== null && _index$searchParamete2 !== void 0 ? _index$searchParamete2 : {}), {}, {
-				indexName: index.name,
-				query: "",
-				hitsPerPage: 0,
-				facets: facetKeys
-			});
-		}) }).then(({ results }) => {
+		if (facetKeys.length === 0 || indexes.length === 0) return () => {
+			isMounted = false;
+		};
+		searchClient.search({ requests: indexes.map((index) => ({
+			indexName: index.name,
+			query: "",
+			hitsPerPage: 0,
+			facets: facetKeys
+		})) }).then(({ results }) => {
 			if (!isMounted) return;
 			const valuesByFacet = facetKeys.reduce((acc, facet) => {
 				acc[facet] = [];
@@ -12876,19 +12893,23 @@ function useFacetValues({ facets, indexes, searchClient }) {
 }
 function useDocSearchFacets({ facets, indexes, searchClient, onSelectionsChange }) {
 	const normalizedFacets = En.useMemo(() => normalizeFacets(facets), [facets]);
+	const normalizedFacetsRef = En.useRef(normalizedFacets);
 	const facetValues = useFacetValues({
 		facets: normalizedFacets,
 		indexes,
 		searchClient
 	});
-	const [facetSelections, setFacetSelections] = En.useState({});
+	const [facetSelections, setFacetSelections] = En.useState(() => deriveDefaultSelectedFacetsFromIndex(indexes));
 	const facetSelectionsRef = En.useRef(facetSelections);
 	const onSelectionsChangeRef = En.useRef(onSelectionsChange);
-	onSelectionsChangeRef.current = onSelectionsChange;
 	const visibleFacets = En.useMemo(() => normalizedFacets.map((facet) => {
 		var _facetValues$facet$ke;
 		return _objectSpread2$2(_objectSpread2$2({}, facet), {}, { values: (_facetValues$facet$ke = facetValues[facet.key]) !== null && _facetValues$facet$ke !== void 0 ? _facetValues$facet$ke : [] });
 	}).filter((facet) => facet.values.length > 0), [facetValues, normalizedFacets]);
+	En.useLayoutEffect(() => {
+		normalizedFacetsRef.current = normalizedFacets;
+		onSelectionsChangeRef.current = onSelectionsChange;
+	});
 	const applySelections = En.useCallback((next) => {
 		var _onSelectionsChangeRe;
 		facetSelectionsRef.current = next;
@@ -12902,13 +12923,14 @@ function useDocSearchFacets({ facets, indexes, searchClient, onSelectionsChange
 		handleFacetSelectionChange: En.useCallback((facet, value) => {
 			if (facetSelectionsRef.current[facet] === value) return;
 			const next = _objectSpread2$2({}, facetSelectionsRef.current);
-			if (value === "") delete next[facet];
-			else next[facet] = value;
+			next[facet] = value;
 			applySelections(next);
 		}, [applySelections]),
 		clearFacetSelections: En.useCallback(() => {
 			if (Object.keys(facetSelectionsRef.current).length === 0) return;
-			applySelections({});
+			const next = {};
+			for (const facet of normalizedFacetsRef.current) if (facetSelectionsRef.current[facet.key]) next[facet.key] = "";
+			applySelections(next);
 		}, [applySelections])
 	};
 }
@@ -13270,9 +13292,9 @@ function ErrorScreen({ translations = {} }) {
 	const { titleText = "Unable to fetch results", helpText = "You might want to check your network connection." } = translations;
 	return /* @__PURE__ */ En.createElement("div", { className: "DocSearch-ErrorScreen" }, /* @__PURE__ */ En.createElement("div", { className: "DocSearch-Screen-Icon" }, /* @__PURE__ */ En.createElement(ErrorIcon, null)), /* @__PURE__ */ En.createElement("p", { className: "DocSearch-Title" }, titleText), /* @__PURE__ */ En.createElement("p", { className: "DocSearch-Help" }, helpText));
 }
-const _excluded$1$8 = ["translations"];
+const _excluded$1$7 = ["translations"];
 function NoResultsScreen(_ref) {
-	let { translations = {} } = _ref, props = _objectWithoutProperties$6(_ref, _excluded$1$8);
+	let { translations = {} } = _ref, props = _objectWithoutProperties$6(_ref, _excluded$1$7);
 	const { noResultsText = "No results found for", suggestedQueryText = "Try searching for", reportMissingResultsText = "Believe this query should return results?", reportMissingResultsLinkText = "Let us know." } = translations;
 	const searchSuggestions = props.state.context.searchSuggestions;
 	return /* @__PURE__ */ En.createElement("div", { className: `DocSearch-NoResults ${props.canHandleAskAi ? "DocSearch-NoResults--withAskAi" : ""}` }, /* @__PURE__ */ En.createElement("div", { className: "DocSearch-Screen-Icon" }, /* @__PURE__ */ En.createElement(NoResultsIcon, null)), /* @__PURE__ */ En.createElement("p", { className: "DocSearch-Title" }, noResultsText, " \"", /* @__PURE__ */ En.createElement("strong", null, props.state.query), "\""), searchSuggestions && searchSuggestions.length > 0 && /* @__PURE__ */ En.createElement("div", { className: "DocSearch-NoResults-Prefill-List" }, /* @__PURE__ */ En.createElement("p", { className: "DocSearch-Help" }, suggestedQueryText, ":"), /* @__PURE__ */ En.createElement("div", { className: "DocSearch-NoResults-Prefill-List-Items" }, searchSuggestions.slice(0, 3).reduce((acc, search) => [...acc, /* @__PURE__ */ En.createElement("p", { key: search }, /* @__PURE__ */ En.createElement(SearchIcon, { size: 16 }), /* @__PURE__ */ En.createElement("button", {
@@ -13307,13 +13329,9 @@ function HitResultBadge({ item, resultBadgeKey, translations = {} }) {
 	if (badgeValue === null || badgeValue.length === 0) return null;
 	return /* @__PURE__ */ En.createElement("div", { className: "DocSearch-Hit-badge" }, /* @__PURE__ */ En.createElement("span", { className: "DocSearch-VisuallyHiddenForAccessibility" }, `${resultBadgeLabelText}: ${badgeValue}`), /* @__PURE__ */ En.createElement("span", { "aria-hidden": "true" }, badgeValue));
 }
-const _excluded$9 = ["translations", "resultBadgeKey"];
+const _excluded$10 = ["translations", "resultBadgeKey"];
 function ResultsScreen(_ref) {
-	let { translations = {}, resultBadgeKey } = _ref, props = _objectWithoutProperties$6(_ref, _excluded$9);
-	const { resultsSectionTitle = "Results" } = translations;
-	const renderIcon = En.useCallback(({ item }) => {
-		return /* @__PURE__ */ En.createElement("div", { className: "DocSearch-Hit-icon" }, /* @__PURE__ */ En.createElement(SourceIcon, { type: item.type }));
-	}, []);
+	let { translations = {}, resultBadgeKey } = _ref, props = _objectWithoutProperties$6(_ref, _excluded$10);
 	const renderAction = En.useCallback(() => {
 		return /* @__PURE__ */ En.createElement("div", { className: "DocSearch-Hit-action" }, /* @__PURE__ */ En.createElement(SelectIcon, null));
 	}, []);
@@ -13326,22 +13344,45 @@ function ResultsScreen(_ref) {
 	}, [resultBadgeKey, translations.resultBadgeLabelText]);
 	return /* @__PURE__ */ En.createElement("div", { className: "DocSearch-Dropdown-Container" }, props.state.collections.map((collection) => {
 		if (collection.items.length === 0) return null;
+		const title = removeHighlightTags(collection.items[0]);
 		return /* @__PURE__ */ En.createElement(Results, _objectSpread2$2(_objectSpread2$2({}, props), {}, {
 			key: collection.source.sourceId,
 			translations,
-			title: resultsSectionTitle,
+			title,
 			collection,
-			renderIcon,
+			renderIcon: ({ item, index }) => {
+				var _collection$items;
+				return /* @__PURE__ */ En.createElement(En.Fragment, null, item.__docsearch_parent && /* @__PURE__ */ En.createElement("svg", {
+					className: "DocSearch-Hit-Tree",
+					viewBox: "0 0 24 54"
+				}, /* @__PURE__ */ En.createElement("g", {
+					stroke: "currentColor",
+					fill: "none",
+					fillRule: "evenodd",
+					strokeLinecap: "round",
+					strokeLinejoin: "round"
+				}, item.__docsearch_parent !== ((_collection$items = collection.items[index + 1]) === null || _collection$items === void 0 ? void 0 : _collection$items.__docsearch_parent) ? /* @__PURE__ */ En.createElement("path", { d: "M8 6v21M20 27H8.3" }) : /* @__PURE__ */ En.createElement("path", { d: "M8 6v42M20 27H8.3" }))), /* @__PURE__ */ En.createElement("div", { className: "DocSearch-Hit-icon" }, /* @__PURE__ */ En.createElement(SourceIcon, { type: item.type })));
+			},
 			renderAction,
 			renderResultBadge
 		}));
 	}), props.resultsFooterComponent && /* @__PURE__ */ En.createElement("section", { className: "DocSearch-HitsFooter" }, /* @__PURE__ */ En.createElement(props.resultsFooterComponent, { state: props.state })));
 }
 function createFacetFilters(searchParametersFacetFilters, facetSelections) {
-	const dynamicFacetFilters = Object.entries(facetSelections).filter(([, value]) => value).map(([facet, value]) => `${facet}:${value}`);
-	if (dynamicFacetFilters.length === 0) return searchParametersFacetFilters;
-	if (!searchParametersFacetFilters) return dynamicFacetFilters;
-	return [...searchParametersFacetFilters, ...dynamicFacetFilters];
+	const selections = Object.entries(facetSelections);
+	const selectedFacets = new Set(selections.map(([facet]) => facet));
+	const dynamicFacetFilters = [];
+	for (const [facet, selection] of selections) if (selection !== "") dynamicFacetFilters.push(`${facet}:${selection}`);
+	if (selectedFacets.size === 0) return searchParametersFacetFilters;
+	let configuredFacetFilters = [];
+	if (searchParametersFacetFilters && Array.isArray(searchParametersFacetFilters)) configuredFacetFilters = searchParametersFacetFilters;
+	else if (searchParametersFacetFilters) configuredFacetFilters = [searchParametersFacetFilters];
+	return [...configuredFacetFilters.filter((facetFilter) => {
+		if (typeof facetFilter !== "string") return true;
+		const separatorIndex = facetFilter.indexOf(":");
+		const facet = facetFilter.slice(0, separatorIndex);
+		return separatorIndex <= 0 || !selectedFacets.has(facet);
+	}), ...dynamicFacetFilters];
 }
 function buildNoQuerySources({ recentSearches, favoriteSearches, saveRecentSearch, onClose, disableUserPersonalization }) {
 	if (disableUserPersonalization) return [];
@@ -13408,7 +13449,7 @@ async function buildQuerySources({ query, state: sourcesState, setContext, setSt
 				highlightPostTag: (_searchParams$highlig2 = searchParams === null || searchParams === void 0 ? void 0 : searchParams.highlightPostTag) !== null && _searchParams$highlig2 !== void 0 ? _searchParams$highlig2 : "</mark>",
 				hitsPerPage: (_searchParams$hitsPer = searchParams === null || searchParams === void 0 ? void 0 : searchParams.hitsPerPage) !== null && _searchParams$hitsPer !== void 0 ? _searchParams$hitsPer : 20,
 				clickAnalytics: (_searchParams$clickAn = searchParams === null || searchParams === void 0 ? void 0 : searchParams.clickAnalytics) !== null && _searchParams$clickAn !== void 0 ? _searchParams$clickAn : insightsActive
-			}, searchParams !== null && searchParams !== void 0 ? searchParams : {}), facetFilters ? { facetFilters } : {});
+			}, searchParams), facetFilters ? { facetFilters } : {});
 		}) });
 		return results.flatMap((res) => {
 			const result = res;
@@ -13431,9 +13472,8 @@ async function buildQuerySources({ query, state: sourcesState, setContext, setSt
 					apiKey
 				}
 			};
-			const items = Object.values(sources).flat();
-			return {
-				sourceId: `hits_${result.index}`,
+			return Object.values(sources).map((items, index) => ({
+				sourceId: `hits_${result.index}_${index}`,
 				onSelect({ item, event }) {
 					saveRecentSearch(item);
 					if (!isModifierEvent(event)) onClose();
@@ -13447,26 +13487,18 @@ async function buildQuerySources({ query, state: sourcesState, setContext, setSt
 						const potentialParent = groupedHits.find((siblingItem) => siblingItem.type === "lvl1" && siblingItem.hierarchy.lvl1 === item.hierarchy.lvl1);
 						if (item.type !== "lvl1" && potentialParent) parent = potentialParent;
 						return _objectSpread2$2(_objectSpread2$2({}, item), {}, { __docsearch_parent: parent }, insightsParams);
-					}).flat()).flat();
+					})).flat();
 				}
-			};
+			}));
 		});
 	} catch (error) {
 		if (error.name === "RetryError") setStatus("error");
 		throw error;
 	}
 }
-function normalizeDocSearchIndexes({ indexName, indices = [], searchParameters }) {
-	const indexes = [];
-	if (indexName && indexName !== "") indexes.push({
-		name: indexName,
-		searchParameters
-	});
-	if (indices.length > 0) indices.forEach((index) => {
-		indexes.push(typeof index === "string" ? { name: index } : index);
-	});
-	if (indexes.length < 1) throw new Error("Must supply either `indexName` or `indices` for DocSearch to work");
-	return indexes;
+function normalizeDocSearchIndexes({ indices }) {
+	if (!Array.isArray(indices) || indices.length < 1) throw new Error("Must supply at least one `indices` entry for DocSearch");
+	return indices.map((index) => typeof index === "string" ? { name: index } : index);
 }
 
 //#endregion
@@ -16277,7 +16309,7 @@ function createAutocomplete(options) {
 }
 
 //#endregion
-//#region ../docsearch-react/dist/esm/DocSearchModal-CpvDjo1O.js
+//#region ../docsearch-react/dist/esm/DocSearchModal-D_tfhoN1.js
 init_compat();
 const _excluded$3 = ["translations"];
 function KeywordSearchBox(_ref) {
@@ -16301,9 +16333,9 @@ function KeywordSearchBox(_ref) {
 		actionsBeforeClose
 	}));
 }
-const _excluded$2 = ["translations"];
+const _excluded$2$1 = ["translations"];
 function KeywordStartScreen(_ref) {
-	let { translations = {} } = _ref, props = _objectWithoutProperties$6(_ref, _excluded$2);
+	let { translations = {} } = _ref, props = _objectWithoutProperties$6(_ref, _excluded$2$1);
 	return /* @__PURE__ */ En.createElement("div", { className: "DocSearch-Dropdown-Container" }, /* @__PURE__ */ En.createElement(StoredSearchesSections, _objectSpread2$2(_objectSpread2$2({}, props), {}, { translations })));
 }
 const _excluded$1$1 = ["translations"];
@@ -16311,14 +16343,16 @@ const ScreenState = En.memo((_ref) => {
 	var _props$state;
 	let { translations = {} } = _ref, props = _objectWithoutProperties$6(_ref, _excluded$1$1);
 	if (((_props$state = props.state) === null || _props$state === void 0 ? void 0 : _props$state.status) === "error") return /* @__PURE__ */ En.createElement(ErrorScreen, { translations: translations === null || translations === void 0 ? void 0 : translations.errorScreen });
-	if (!props.state.query) return /* @__PURE__ */ En.createElement(KeywordStartScreen, _objectSpread2$2(_objectSpread2$2({}, props), {}, {
+	if (isQueryEmpty(props.state.query)) return /* @__PURE__ */ En.createElement(KeywordStartScreen, _objectSpread2$2(_objectSpread2$2({}, props), {}, {
 		hasCollections: props.hasCollections,
 		translations: translations === null || translations === void 0 ? void 0 : translations.startScreen
 	}));
 	if (!props.hasCollections) return /* @__PURE__ */ En.createElement(NoResultsScreen, _objectSpread2$2(_objectSpread2$2({}, props), {}, { translations: translations === null || translations === void 0 ? void 0 : translations.noResultsScreen }));
 	return /* @__PURE__ */ En.createElement(ResultsScreen, _objectSpread2$2(_objectSpread2$2({}, props), {}, { translations: translations === null || translations === void 0 ? void 0 : translations.resultsScreen }));
-}, function areEqual(_prevProps, nextProps) {
-	return nextProps.state.status === "loading" || nextProps.state.status === "stalled";
+}, function areEqual(prevProps, nextProps) {
+	const isLoading = nextProps.state.status === "loading" || nextProps.state.status === "stalled";
+	const isWaitingForCollections = nextProps.state.status === "idle" && !isQueryEmpty(nextProps.state.query) && prevProps.state.query !== nextProps.state.query && prevProps.state.collections === nextProps.state.collections;
+	return isLoading || isWaitingForCollections;
 });
 const _excluded$4 = [
 	"appId",
@@ -16340,8 +16374,6 @@ const _excluded$4 = [
 	"recentSearchesLimit",
 	"recentSearchesWithFavoritesLimit",
 	"indices",
-	"indexName",
-	"searchParameters",
 	"facets"
 ];
 const _excluded2 = [
@@ -16351,7 +16383,7 @@ const _excluded2 = [
 ];
 function DocSearchModal(_ref) {
 	var _translations$searchB;
-	let { appId, apiKey, maxResultsPerGroup, theme, onClose = noop$1, transformItems = identity, hitComponent = Hit, resultsFooterComponent = () => null, navigator, initialScrollY = 0, transformSearchClient = identity, disableUserPersonalization = false, initialQuery: initialQueryFromProp = "", translations = {}, getMissingResultsUrl, insights = false, recentSearchesLimit = 7, recentSearchesWithFavoritesLimit = 4, indices = [], indexName, searchParameters, facets } = _ref, props = _objectWithoutProperties$6(_ref, _excluded$4);
+	let { appId, apiKey, maxResultsPerGroup, theme, onClose = noop$1, transformItems = identity, hitComponent = Hit, resultsFooterComponent = () => null, navigator, initialScrollY = 0, transformSearchClient = identity, disableUserPersonalization = false, initialQuery: initialQueryFromProp = "", translations = {}, getMissingResultsUrl, insights = false, recentSearchesLimit = 7, recentSearchesWithFavoritesLimit = 4, indices, facets } = _ref, props = _objectWithoutProperties$6(_ref, _excluded$4);
 	const { footer: footerTranslations, searchBox: searchBoxTranslations, facets: facetBarTranslations } = translations, screenStateTranslations = _objectWithoutProperties$6(translations, _excluded2);
 	const [state, setState] = En.useState({
 		query: "",
@@ -16366,15 +16398,7 @@ function DocSearchModal(_ref) {
 	const { containerRef, modalRef, formElementRef, dropdownRef, inputRef, snippetLength } = useModalRefs();
 	const { initialQuery, initialQueryFromSelection } = useInitialModalQuery(initialQueryFromProp);
 	const searchClient = useSearchClient(appId, apiKey, transformSearchClient);
-	const indexes = En.useMemo(() => normalizeDocSearchIndexes({
-		indexName,
-		indices,
-		searchParameters
-	}), [
-		indexName,
-		indices,
-		searchParameters
-	]);
+	const indexes = En.useMemo(() => normalizeDocSearchIndexes({ indices }), [indices]);
 	const defaultIndexName = indexes[0].name;
 	const autocompleteRef = En.useRef(void 0);
 	const { visibleFacets, facetSelections, facetSelectionsRef, handleFacetSelectionChange, clearFacetSelections } = useDocSearchFacets({
@@ -16411,7 +16435,7 @@ function DocSearchModal(_ref) {
 			setState(changes.state);
 		},
 		getSources({ query, state: sourcesState, setContext, setStatus }) {
-			if (!query) return buildNoQuerySources({
+			if (isQueryEmpty(query)) return buildNoQuerySources({
 				recentSearches,
 				favoriteSearches,
 				saveRecentSearch,
@@ -16460,7 +16484,7 @@ function DocSearchModal(_ref) {
 	});
 	let showDocsearchDropdown = true;
 	const hasCollections = state.collections.some((collection) => collection.items.length > 0);
-	if (state.status === "idle" && hasCollections === false && state.query.length === 0) showDocsearchDropdown = false;
+	if (state.status === "idle" && hasCollections === false && isQueryEmpty(state.query)) showDocsearchDropdown = false;
 	return /* @__PURE__ */ En.createElement(ModalShell, {
 		state,
 		containerRef,
@@ -16472,13 +16496,13 @@ function DocSearchModal(_ref) {
 		searchBox: /* @__PURE__ */ En.createElement(KeywordSearchBox, _objectSpread2$2(_objectSpread2$2({}, autocomplete), {}, {
 			state,
 			placeholder: placeholder || "Search docs",
-			autoFocus: initialQuery.length === 0,
+			autoFocus: isQueryEmpty(initialQuery),
 			inputRef,
 			isFromSelection: Boolean(initialQuery) && initialQuery === initialQueryFromSelection,
 			translations: searchBoxTranslations,
 			onClose
 		})),
-		filterBar: state.query !== "" ? /* @__PURE__ */ En.createElement(FacetBar, {
+		filterBar: !isQueryEmpty(state.query) ? /* @__PURE__ */ En.createElement(FacetBar, {
 			facets: visibleFacets,
 			selections: facetSelections,
 			translations: facetBarTranslations,
@@ -16656,8 +16680,10 @@ function _objectWithoutProperties(e, t) {
 	}
 	return i;
 }
-const _excluded$1 = [
+const _excluded$2 = [
 	"children",
+	"appId",
+	"apiKey",
 	"theme",
 	"onReady",
 	"onOpen",
@@ -16668,7 +16694,7 @@ const _excluded$1 = [
 const Context = En.createContext(void 0);
 Context.displayName = "DocSearchContext";
 function DocSearchInner$1(_ref, ref) {
-	let { children, theme, onReady, onOpen, onClose, onSidepanelOpen, onSidepanelClose } = _ref, props = _objectWithoutProperties(_ref, _excluded$1);
+	let { children, appId, apiKey, theme, onReady, onOpen, onClose, onSidepanelOpen, onSidepanelClose } = _ref, props = _objectWithoutProperties(_ref, _excluded$2);
 	const [docsearchState, setDocsearchState] = En.useState("ready");
 	const [initialQuery, setInitialQuery] = En.useState(props.initialQuery || "");
 	const searchButtonRef = En.useRef(null);
@@ -16775,6 +16801,8 @@ function DocSearchInner$1(_ref, ref) {
 		keyboardShortcuts
 	});
 	const value = En.useMemo(() => ({
+		appId,
+		apiKey,
 		docsearchState,
 		setDocsearchState,
 		searchButtonRef,
@@ -16789,6 +16817,8 @@ function DocSearchInner$1(_ref, ref) {
 		registerView,
 		isHybridModeSupported
 	}), [
+		appId,
+		apiKey,
 		docsearchState,
 		searchButtonRef,
 		initialQuery,
@@ -16815,19 +16845,28 @@ function useDocSearch() {
 //#endregion
 //#region ../docsearch-react/dist/esm/index.js
 init_compat();
-function DocSearchComponent(props, ref) {
-	return /* @__PURE__ */ En.createElement(DocSearch$1, _objectSpread2$2(_objectSpread2$2({}, props), {}, { ref }), /* @__PURE__ */ En.createElement(DocSearchInner, props));
+const _excluded$1 = ["appId", "apiKey"];
+function DocSearchComponent(_ref, ref) {
+	let { appId, apiKey } = _ref, props = _objectWithoutProperties$6(_ref, _excluded$1);
+	return /* @__PURE__ */ En.createElement(DocSearch$1, _objectSpread2$2(_objectSpread2$2({}, props), {}, {
+		appId,
+		apiKey,
+		ref
+	}), /* @__PURE__ */ En.createElement(DocSearchInner, props));
 }
 const DocSearch = En.forwardRef(DocSearchComponent);
 function DocSearchInner(props) {
 	var _props$translations, _props$translations2, _props$portalContaine;
-	const { searchButtonRef, keyboardShortcuts, isModalActive, initialQuery, openModal, closeModal } = useDocSearch();
+	const { searchButtonRef, keyboardShortcuts, isModalActive, initialQuery, openModal, closeModal, appId, apiKey } = useDocSearch();
+	if (!appId || !apiKey) throw new Error("`DocSearch` requires `appId` and `apiKey` props.");
 	return /* @__PURE__ */ En.createElement(En.Fragment, null, /* @__PURE__ */ En.createElement(DocSearchButton, {
 		keyboardShortcuts,
 		ref: searchButtonRef,
 		translations: (_props$translations = props.translations) === null || _props$translations === void 0 ? void 0 : _props$translations.button,
 		onClick: openModal
 	}), isModalActive && H(/* @__PURE__ */ En.createElement(DocSearchModal, _objectSpread2$2(_objectSpread2$2({}, props), {}, {
+		appId,
+		apiKey,
 		initialScrollY: window.scrollY,
 		initialQuery,
 		translations: props === null || props === void 0 || (_props$translations2 = props.translations) === null || _props$translations2 === void 0 ? void 0 : _props$translations2.modal,