@docsearch/js 5.0.5 → 5.1.0

package/dist/esm/docsearch.js

@@ -1,4 +1,4 @@
-/*! @docsearch/js 5.0.5 (UNRELEASED 5c6c897) | MIT License | © Algolia, Inc. and contributors | https://docsearch.algolia.com */
+/*! @docsearch/js 5.1.0 (UNRELEASED 189dcc9) | MIT License | © Algolia, Inc. and contributors | https://docsearch.algolia.com */
 //#region \0rolldown/runtime.js
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
@@ -1144,9 +1144,9 @@ function usePlatformKeys() {
 		key
 	};
 }
-const _excluded$25 = ["translations", "keyboardShortcuts"];
+const _excluded$28 = ["translations", "keyboardShortcuts"];
 const DocSearchButton = En.forwardRef((_ref, ref) => {
-	let { translations = {}, keyboardShortcuts } = _ref, props = _objectWithoutProperties$6(_ref, _excluded$25);
+	let { translations = {}, keyboardShortcuts } = _ref, props = _objectWithoutProperties$6(_ref, _excluded$28);
 	const { buttonText = "Search", buttonAriaLabel = "Search" } = translations;
 	const resolvedShortcuts = getKeyboardShortcuts(keyboardShortcuts);
 	const { actionKeyReactsTo, actionKeyAltText, actionKeyLabel, key } = usePlatformKeys();
@@ -1182,7 +1182,7 @@ function DocSearchButtonKey({ reactsToKey, children }) {
 
 //#endregion
 //#region ../docsearch-react/dist/esm/version.js
-const version$1 = "5.0.5";
+const version$1 = "5.1.0";
 
 //#endregion
 //#region \0@oxc-project+runtime@0.139.0/helpers/esm/OverloadYield.js
@@ -2094,7 +2094,7 @@ function _objectWithoutProperties$5(e, t) {
 
 //#endregion
 //#region ../../node_modules/.bun/algoliasearch@5.55.2/node_modules/algoliasearch/dist/lite/builds/browser.js
-const _excluded$24 = [
+const _excluded$27 = [
 	"appId",
 	"apiKey",
 	"authMode",
@@ -2131,7 +2131,7 @@ function getDefaultHosts(appId) {
 	]));
 }
 function createLiteClient(_ref) {
-	let { appId: appIdOption, apiKey: apiKeyOption, authMode, algoliaAgents } = _ref, options = _objectWithoutProperties$5(_ref, _excluded$24);
+	let { appId: appIdOption, apiKey: apiKeyOption, authMode, algoliaAgents } = _ref, options = _objectWithoutProperties$5(_ref, _excluded$27);
 	const auth = createAuth(appIdOption, apiKeyOption, authMode);
 	const transporter = createTransporter(_objectSpread2$1(_objectSpread2$1({ hosts: getDefaultHosts(appIdOption) }, options), {}, {
 		algoliaAgent: getAlgoliaAgent({
@@ -2606,13 +2606,13 @@ function createStorage(key) {
 		}
 	};
 }
-const _excluded$23 = ["_highlightResult", "_snippetResult"];
+const _excluded$26 = ["_highlightResult", "_snippetResult"];
 function createStoredSearches({ key, limit = 5 }) {
 	const storage = createStorage(key);
 	let items = storage.getItem().slice(0, limit);
 	return {
 		add(item) {
-			const _ref = item, { _highlightResult, _snippetResult } = _ref, hit = _objectWithoutProperties$6(_ref, _excluded$23);
+			const _ref = item, { _highlightResult, _snippetResult } = _ref, hit = _objectWithoutProperties$6(_ref, _excluded$26);
 			const isQueryAlreadySaved = items.findIndex((x) => x.objectID === hit.objectID);
 			if (isQueryAlreadySaved > -1) items.splice(isQueryAlreadySaved, 1);
 			items.unshift(hit);
@@ -3220,6 +3220,16 @@ function useControlled({ controlled, default: defaultProp, name, state = "value"
 	}, [])];
 }
 
+//#endregion
+//#region ../../node_modules/.bun/@base-ui+react@1.6.0+fce4ea6354698f9c/node_modules/@base-ui/react/menu/checkbox-item/MenuCheckboxItemContext.mjs
+init_compat();
+const MenuCheckboxItemContext = /*#__PURE__*/ K$1(void 0);
+function useMenuCheckboxItemContext() {
+	const context = j$1(MenuCheckboxItemContext);
+	if (context === void 0) throw new Error(formatErrorMessage(30));
+	return context;
+}
+
 //#endregion
 //#region ../../node_modules/.bun/@floating-ui+utils@0.2.12/node_modules/@floating-ui/utils/dist/floating-ui.utils.dom.mjs
 function hasWindow() {
@@ -3431,7 +3441,7 @@ function useFocusableWhenDisabled(parameters) {
 //#endregion
 //#region ../../node_modules/.bun/@base-ui+react@1.6.0+fce4ea6354698f9c/node_modules/@base-ui/react/internals/use-button/useButton.mjs
 init_compat();
-const _excluded$22 = [
+const _excluded$25 = [
 	"onClick",
 	"onMouseDown",
 	"onKeyUp",
@@ -3462,7 +3472,7 @@ function useButton(parameters = {}) {
 	useIsoLayoutEffect(updateDisabled, [updateDisabled]);
 	return {
 		getButtonProps: b((externalProps = {}) => {
-			const { onClick: externalOnClick, onMouseDown: externalOnMouseDown, onKeyUp: externalOnKeyUp, onKeyDown: externalOnKeyDown, onPointerDown: externalOnPointerDown } = externalProps, otherExternalProps = _objectWithoutProperties$5(externalProps, _excluded$22);
+			const { onClick: externalOnClick, onMouseDown: externalOnMouseDown, onKeyUp: externalOnKeyUp, onKeyDown: externalOnKeyDown, onPointerDown: externalOnPointerDown } = externalProps, otherExternalProps = _objectWithoutProperties$5(externalProps, _excluded$25);
 			return mergeProps({
 				onClick(event) {
 					if (disabled) {
@@ -3946,6 +3956,92 @@ function u(t, e, n, f, u, i) {
 //#region ../../node_modules/.bun/preact@11.0.0-beta.0/node_modules/preact/compat/jsx-runtime.mjs
 init_compat();
 
+//#endregion
+//#region ../../node_modules/.bun/@base-ui+react@1.6.0+fce4ea6354698f9c/node_modules/@base-ui/react/menu/checkbox-item/MenuCheckboxItem.mjs
+init_compat();
+const _excluded$24 = [
+	"render",
+	"className",
+	"id",
+	"label",
+	"nativeButton",
+	"disabled",
+	"closeOnClick",
+	"checked",
+	"defaultChecked",
+	"onCheckedChange",
+	"style"
+];
+/**
+* A menu item that toggles a setting on or off.
+* Renders a `<div>` element.
+*
+* Documentation: [Base UI Menu](https://base-ui.com/react/components/menu)
+*/
+const MenuCheckboxItem$1 = /*#__PURE__*/ M(function MenuCheckboxItem(componentProps, forwardedRef) {
+	const { render, className, id: idProp, label, nativeButton = false, disabled = false, closeOnClick = false, checked: checkedProp, defaultChecked, onCheckedChange, style } = componentProps, elementProps = _objectWithoutProperties$5(componentProps, _excluded$24);
+	const listItem = useCompositeListItem({ label });
+	const menuPositionerContext = useMenuPositionerContext(true);
+	const id = useBaseUiId(idProp);
+	const { store } = useMenuRootContext();
+	const highlighted = store.useState("isActive", listItem.index);
+	const itemProps = store.useState("itemProps");
+	const [checked, setChecked] = useControlled({
+		controlled: checkedProp,
+		default: defaultChecked !== null && defaultChecked !== void 0 ? defaultChecked : false,
+		name: "MenuCheckboxItem",
+		state: "checked"
+	});
+	const { getItemProps, itemRef } = useMenuItem({
+		closeOnClick,
+		disabled,
+		highlighted,
+		id,
+		store,
+		nativeButton,
+		nodeId: menuPositionerContext === null || menuPositionerContext === void 0 ? void 0 : menuPositionerContext.context.nodeId,
+		itemMetadata: REGULAR_ITEM
+	});
+	const state = q$1(() => ({
+		disabled,
+		highlighted,
+		checked
+	}), [
+		disabled,
+		highlighted,
+		checked
+	]);
+	function handleClick(event) {
+		const details = createChangeEventDetails(itemPress, event.nativeEvent, void 0, { preventUnmountOnClose() {} });
+		onCheckedChange === null || onCheckedChange === void 0 || onCheckedChange(!checked, details);
+		if (details.isCanceled) return;
+		setChecked((currentlyChecked) => !currentlyChecked);
+	}
+	const element = useRenderElement("div", componentProps, {
+		state,
+		stateAttributesMapping: itemMapping,
+		props: [
+			itemProps,
+			{
+				role: "menuitemcheckbox",
+				"aria-checked": checked,
+				onClick: handleClick
+			},
+			elementProps,
+			getItemProps
+		],
+		ref: [
+			itemRef,
+			forwardedRef,
+			listItem.ref
+		]
+	});
+	return /*#__PURE__*/ u(MenuCheckboxItemContext.Provider, {
+		value: state,
+		children: element
+	});
+});
+
 //#endregion
 //#region ../../node_modules/.bun/@base-ui+utils@0.3.1+fce4ea6354698f9c/node_modules/@base-ui/utils/useOnMount.mjs
 init_compat();
@@ -4205,6 +4301,47 @@ function useOpenChangeComplete(parameters) {
 	]);
 }
 
+//#endregion
+//#region ../../node_modules/.bun/@base-ui+react@1.6.0+fce4ea6354698f9c/node_modules/@base-ui/react/menu/checkbox-item-indicator/MenuCheckboxItemIndicator.mjs
+init_compat();
+const _excluded$23 = [
+	"render",
+	"className",
+	"style",
+	"keepMounted"
+];
+/**
+* Indicates whether the checkbox item is ticked.
+* Renders a `<span>` element.
+*
+* Documentation: [Base UI Menu](https://base-ui.com/react/components/menu)
+*/
+const MenuCheckboxItemIndicator = /*#__PURE__*/ M(function MenuCheckboxItemIndicator(componentProps, forwardedRef) {
+	const { render, className, style, keepMounted = false } = componentProps, elementProps = _objectWithoutProperties$5(componentProps, _excluded$23);
+	const item = useMenuCheckboxItemContext();
+	const indicatorRef = F$1(null);
+	const { transitionStatus, setMounted } = useTransitionStatus(item.checked);
+	useOpenChangeComplete({
+		open: item.checked,
+		ref: indicatorRef,
+		onComplete() {
+			if (!item.checked) setMounted(false);
+		}
+	});
+	return useRenderElement("span", componentProps, {
+		state: {
+			checked: item.checked,
+			disabled: item.disabled,
+			highlighted: item.highlighted,
+			transitionStatus
+		},
+		ref: [forwardedRef, indicatorRef],
+		stateAttributesMapping: itemMapping,
+		props: _objectSpread2$1({ "aria-hidden": true }, elementProps),
+		enabled: keepMounted || item.checked
+	});
+});
+
 //#endregion
 //#region ../../node_modules/.bun/@base-ui+react@1.6.0+fce4ea6354698f9c/node_modules/@base-ui/react/menu/group/MenuGroupContext.mjs
 init_compat();
@@ -4218,7 +4355,7 @@ function useMenuGroupRootContext() {
 //#endregion
 //#region ../../node_modules/.bun/@base-ui+react@1.6.0+fce4ea6354698f9c/node_modules/@base-ui/react/menu/group-label/MenuGroupLabel.mjs
 init_compat();
-const _excluded$21 = [
+const _excluded$22 = [
 	"render",
 	"className",
 	"style",
@@ -4231,7 +4368,7 @@ const _excluded$21 = [
 * Documentation: [Base UI Menu](https://base-ui.com/react/components/menu)
 */
 const MenuGroupLabel$1 = /*#__PURE__*/ M(function MenuGroupLabel(componentProps, forwardedRef) {
-	const { render, className, style, id: idProp } = componentProps, elementProps = _objectWithoutProperties$5(componentProps, _excluded$21);
+	const { render, className, style, id: idProp } = componentProps, elementProps = _objectWithoutProperties$5(componentProps, _excluded$22);
 	const id = useBaseUiId(idProp);
 	const setLabelId = useMenuGroupRootContext();
 	useIsoLayoutEffect(() => {
@@ -4249,6 +4386,61 @@ const MenuGroupLabel$1 = /*#__PURE__*/ M(function MenuGroupLabel(componentProps,
 	});
 });
 
+//#endregion
+//#region ../../node_modules/.bun/@base-ui+react@1.6.0+fce4ea6354698f9c/node_modules/@base-ui/react/menu/item/MenuItem.mjs
+init_compat();
+const _excluded$21 = [
+	"render",
+	"className",
+	"id",
+	"label",
+	"nativeButton",
+	"disabled",
+	"closeOnClick",
+	"style"
+];
+/**
+* An individual interactive item in the menu.
+* Renders a `<div>` element.
+*
+* Documentation: [Base UI Menu](https://base-ui.com/react/components/menu)
+*/
+const MenuItem$1 = /*#__PURE__*/ M(function MenuItem(componentProps, forwardedRef) {
+	const { render, className, id: idProp, label, nativeButton = false, disabled = false, closeOnClick = true, style } = componentProps, elementProps = _objectWithoutProperties$5(componentProps, _excluded$21);
+	const listItem = useCompositeListItem({ label });
+	const menuPositionerContext = useMenuPositionerContext(true);
+	const id = useBaseUiId(idProp);
+	const { store } = useMenuRootContext();
+	const highlighted = store.useState("isActive", listItem.index);
+	const itemProps = store.useState("itemProps");
+	const { getItemProps, itemRef } = useMenuItem({
+		closeOnClick,
+		disabled,
+		highlighted,
+		id,
+		store,
+		nativeButton,
+		nodeId: menuPositionerContext === null || menuPositionerContext === void 0 ? void 0 : menuPositionerContext.context.nodeId,
+		itemMetadata: REGULAR_ITEM
+	});
+	return useRenderElement("div", componentProps, {
+		state: {
+			disabled,
+			highlighted
+		},
+		props: [
+			itemProps,
+			elementProps,
+			getItemProps
+		],
+		ref: [
+			itemRef,
+			forwardedRef,
+			listItem.ref
+		]
+	});
+});
+
 //#endregion
 //#region ../../node_modules/.bun/@base-ui+utils@0.3.1+fce4ea6354698f9c/node_modules/@base-ui/utils/useTimeout.mjs
 const EMPTY = 0;
@@ -6206,7 +6398,7 @@ const _excluded4$2 = [
 	"crossAxis",
 	"limiter"
 ];
-const _excluded5$1 = ["apply"];
+const _excluded5$2 = ["apply"];
 function computeCoordsFromPlacement(_ref, placement, rtl) {
 	let { reference, floating } = _ref;
 	const sideAxis = getSideAxis(placement);
@@ -6640,7 +6832,7 @@ const size$2 = function(options) {
 		options,
 		async fn(state) {
 			const { placement, rects, platform, elements } = state;
-			const _evaluate5 = evaluate(options, state), { apply = () => {} } = _evaluate5, detectOverflowOptions = _objectWithoutProperties$5(_evaluate5, _excluded5$1);
+			const _evaluate5 = evaluate(options, state), { apply = () => {} } = _evaluate5, detectOverflowOptions = _objectWithoutProperties$5(_evaluate5, _excluded5$2);
 			const overflow = await platform.detectOverflow(state, detectOverflowOptions);
 			const side = getSide(placement);
 			const alignment = getAlignment(placement);
@@ -12380,7 +12572,7 @@ function useMenuParent() {
 }
 
 //#endregion
-//#region ../docsearch-react/dist/esm/normalizeDocSearchIndexes-CFHzf-sx.js
+//#region ../docsearch-react/dist/esm/normalizeDocSearchIndexes-B_bI_ytC.js
 init_compat();
 function capitalize(text) {
 	return `${text.charAt(0).toLocaleUpperCase()}${text.substring(1)}`;
@@ -12560,18 +12752,58 @@ function getFacetLabel(facet) {
 	if (facet.label) return facet.label;
 	return facet.key.replace(/[._-]+/g, " ").replace(/\b\w/g, (letter) => letter.toUpperCase());
 }
+/**
+* Extracts the facet key from an Algolia `facetFilters` string entry such as
+* `language:en`. Returns `null` when the entry doesn't have a `key:value`
+* shape.
+*/
+function getFacetFilterKey(facetFilter) {
+	const separatorIndex = facetFilter.indexOf(":");
+	return separatorIndex <= 0 ? null : facetFilter.slice(0, separatorIndex);
+}
+function parseFacetFilter(facetFilter) {
+	const key = getFacetFilterKey(facetFilter);
+	if (key === null) return null;
+	const value = facetFilter.slice(key.length + 1);
+	return value ? {
+		key,
+		value
+	} : null;
+}
+/**
+* Reads the initial facet selections from the configured `facetFilters` of each
+* index. Later indices override earlier ones for the same facet key.
+*
+* - A `key:value` string selects a single value.
+* - A nested OR group whose entries all share the same key (for example
+*   `['docusaurus_tag:default', 'docusaurus_tag:docs-default-current']`)
+*   selects every value in the group.
+* - OR groups that mix facet keys can't map to a single facet and are ignored.
+*/
 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;
+			if (typeof facetFilter === "string") {
+				const parsed = parseFacetFilter(facetFilter);
+				if (parsed) defaultFacets[parsed.key] = [parsed.value];
+				continue;
+			}
+			if (!Array.isArray(facetFilter) || facetFilter.length === 0) continue;
+			let groupKey = null;
+			const groupValues = [];
+			for (const entry of facetFilter) {
+				const parsed = typeof entry === "string" ? parseFacetFilter(entry) : null;
+				if (!parsed || groupKey !== null && parsed.key !== groupKey) {
+					groupKey = null;
+					break;
+				}
+				groupKey = parsed.key;
+				groupValues.push(parsed.value);
+			}
+			if (groupKey !== null) defaultFacets[groupKey] = groupValues;
 		}
 	}
 	return defaultFacets;
@@ -12599,8 +12831,10 @@ const _excluded2$3 = [
 	"collisionBoundary",
 	"container"
 ];
-const _excluded3$1 = ["className", "children"];
-const _excluded4$1 = ["className"];
+const _excluded3$1 = ["className"];
+const _excluded4$1 = ["className", "children"];
+const _excluded5$1 = ["className", "children"];
+const _excluded6$1 = ["className"];
 function Menu$1(_ref) {
 	let props = _extends({}, (_objectDestructuringEmpty(_ref), _ref));
 	return /* @__PURE__ */ En.createElement(MenuRoot, props);
@@ -12625,13 +12859,19 @@ function MenuPopup(_ref3) {
 	}, /* @__PURE__ */ En.createElement(MenuPopup$1, _objectSpread2$2({ className: "DocSearch-Menu-Popup" }, props))));
 }
 Menu$1.Popup = MenuPopup;
-function MenuRadioGroup(_ref4) {
-	let props = _extends({}, (_objectDestructuringEmpty(_ref4), _ref4));
+function MenuItem(_ref4) {
+	let { className } = _ref4, props = _objectWithoutProperties$6(_ref4, _excluded3$1);
+	const cn = `DocSearch-Menu-Item${className ? ` ${className}` : ""}`;
+	return /* @__PURE__ */ En.createElement(MenuItem$1, _objectSpread2$2({ className: cn }, props));
+}
+Menu$1.Item = MenuItem;
+function MenuRadioGroup(_ref5) {
+	let props = _extends({}, (_objectDestructuringEmpty(_ref5), _ref5));
 	return /* @__PURE__ */ En.createElement(MenuRadioGroup$1, props);
 }
 Menu$1.RadioGroup = MenuRadioGroup;
-function MenuRadioItem(_ref5) {
-	let { className, children } = _ref5, props = _objectWithoutProperties$6(_ref5, _excluded3$1);
+function MenuRadioItem(_ref6) {
+	let { className, children } = _ref6, props = _objectWithoutProperties$6(_ref6, _excluded4$1);
 	const cn = `DocSearch-Menu-Item DocSearch-Menu-RadioItem${className ? ` ${className}` : ""}`;
 	return /* @__PURE__ */ En.createElement(MenuRadioItem$1, _objectSpread2$2({
 		className: cn,
@@ -12639,40 +12879,76 @@ function MenuRadioItem(_ref5) {
 	}, props), /* @__PURE__ */ En.createElement("span", { className: "DocSearch-Menu-RadioItem-Indicator" }, /* @__PURE__ */ En.createElement(MenuRadioItemIndicator, null, /* @__PURE__ */ En.createElement(CheckIcon, null))), children);
 }
 Menu$1.RadioItem = MenuRadioItem;
-function MenuGroupLabel(_ref6) {
-	let { className } = _ref6, props = _objectWithoutProperties$6(_ref6, _excluded4$1);
+function MenuCheckboxItem(_ref7) {
+	let { className, children } = _ref7, props = _objectWithoutProperties$6(_ref7, _excluded5$1);
+	const cn = `DocSearch-Menu-Item DocSearch-Menu-CheckboxItem${className ? ` ${className}` : ""}`;
+	return /* @__PURE__ */ En.createElement(MenuCheckboxItem$1, _objectSpread2$2({ className: cn }, props), /* @__PURE__ */ En.createElement("span", { className: "DocSearch-Menu-CheckboxItem-Indicator" }, /* @__PURE__ */ En.createElement(MenuCheckboxItemIndicator, null, /* @__PURE__ */ En.createElement(CheckIcon, null))), children);
+}
+Menu$1.CheckboxItem = MenuCheckboxItem;
+function MenuGroupLabel(_ref8) {
+	let { className } = _ref8, props = _objectWithoutProperties$6(_ref8, _excluded6$1);
 	const cn = `DocSearch-Menu-GroupLabel${className ? ` ${className}` : ""}`;
 	return /* @__PURE__ */ En.createElement(MenuGroupLabel$1, _objectSpread2$2({ className: cn }, props));
 }
 Menu$1.GroupLabel = MenuGroupLabel;
-const FacetMenu = En.memo(function FacetMenu({ facet, selectedValue, defaultValueLabel, onSelectionChange, registerTrigger, menuTriggerSelectedAriaLabel }) {
+const EMPTY_SELECTION$1 = [];
+const FacetValueItem = En.memo(function FacetValueItem({ facetKey, value, checked, onToggle }) {
+	const handleCheckedChange = En.useCallback(() => {
+		onToggle(facetKey, value);
+	}, [
+		facetKey,
+		onToggle,
+		value
+	]);
+	return /* @__PURE__ */ En.createElement(Menu$1.CheckboxItem, {
+		checked,
+		label: value,
+		onCheckedChange: handleCheckedChange
+	}, capitalize(value));
+});
+function toggleValue(value) {
+	return (currentValues) => currentValues.includes(value) ? currentValues.filter((selected) => selected !== value) : [...currentValues, value];
+}
+function removeValue(value) {
+	return (currentValues) => currentValues.filter((selected) => selected !== value);
+}
+const FacetMenu = En.memo(function FacetMenu({ facet, selectedValues, defaultValueLabel, onSelectionChange, registerTrigger, menuTriggerSelectedAriaLabel }) {
 	const label = getFacetLabel(facet);
-	const handleValueChange = En.useCallback((value) => {
-		onSelectionChange(facet.key, value);
+	const hasSelection = selectedValues.length > 0;
+	const selectedSet = En.useMemo(() => new Set(selectedValues), [selectedValues]);
+	const handleToggleValue = En.useCallback((facetKey, value) => {
+		onSelectionChange(facetKey, toggleValue(value));
+	}, [onSelectionChange]);
+	const handleSelectAll = En.useCallback(() => {
+		onSelectionChange(facet.key, EMPTY_SELECTION$1);
 	}, [facet.key, onSelectionChange]);
 	const triggerRef = En.useCallback((el) => {
 		registerTrigger(facet.key, el);
 	}, [facet.key, registerTrigger]);
 	return /* @__PURE__ */ En.createElement(Menu$1, null, /* @__PURE__ */ En.createElement(Menu$1.Trigger, {
 		ref: triggerRef,
-		"data-has-selection": Boolean(selectedValue),
-		"aria-label": selectedValue ? `${label}, ${selectedValue} ${menuTriggerSelectedAriaLabel}` : label
-	}, /* @__PURE__ */ En.createElement("span", null, capitalize(label)), /* @__PURE__ */ En.createElement(ChevronIcon, null)), /* @__PURE__ */ En.createElement(Menu$1.Popup, null, /* @__PURE__ */ En.createElement(Menu$1.RadioGroup, {
-		value: selectedValue,
-		onValueChange: handleValueChange
-	}, /* @__PURE__ */ En.createElement(Menu$1.RadioItem, {
-		value: "",
-		label: `${defaultValueLabel} ${label}`
-	}, defaultValueLabel), facet.values.map((value) => /* @__PURE__ */ En.createElement(Menu$1.RadioItem, {
+		"data-has-selection": hasSelection,
+		"aria-label": hasSelection ? `${label}, ${selectedValues.join(", ")} ${menuTriggerSelectedAriaLabel}` : label
+	}, /* @__PURE__ */ En.createElement("span", null, capitalize(label)), /* @__PURE__ */ En.createElement(ChevronIcon, null)), /* @__PURE__ */ En.createElement(Menu$1.Popup, null, /* @__PURE__ */ En.createElement(Menu$1.Item, {
+		className: "DocSearch-Menu-ResetItem",
+		label: `${defaultValueLabel} ${label}`,
+		onClick: handleSelectAll
+	}, defaultValueLabel), facet.values.map((value) => /* @__PURE__ */ En.createElement(FacetValueItem, {
 		key: value,
+		facetKey: facet.key,
 		value,
-		label: value
-	}, capitalize(value))))));
+		checked: selectedSet.has(value),
+		onToggle: handleToggleValue
+	}))));
 });
 const SelectedFacetChip = En.memo(function SelectedFacetChip({ facetKey, facetLabel, value, dismissAriaLabel, onDismiss }) {
 	const handleDismissFacet = En.useCallback((e) => {
-		onDismiss(facetKey, e);
-	}, [facetKey, onDismiss]);
+		onDismiss(facetKey, value, e);
+	}, [
+		facetKey,
+		onDismiss,
+		value
+	]);
 	return /* @__PURE__ */ En.createElement(Chip, null, capitalize(value), /* @__PURE__ */ En.createElement(Chip.Dismiss, {
 		"aria-label": `${dismissAriaLabel} ${capitalize(value)} (${facetLabel})`,
 		onClick: handleDismissFacet
@@ -12682,14 +12958,19 @@ const FacetBar = En.memo(function FacetBar({ facets, selections, onSelectionChan
 	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(([key, value]) => Boolean(value) && visibleFacetKeys.has(key));
+		const entries = [];
+		for (const [key, values] of Object.entries(selections)) {
+			if (!visibleFacetKeys.has(key)) continue;
+			for (const value of values) entries.push([key, value]);
+		}
+		return entries;
 	}, [selections, visibleFacetKeys]);
 	const triggerRefs = En.useRef(/* @__PURE__ */ new Map());
 	const registerTrigger = En.useCallback((facetKey, el) => {
 		if (el) triggerRefs.current.set(facetKey, el);
 		else triggerRefs.current.delete(facetKey);
 	}, []);
-	const handleDismissFacet = En.useCallback((facetKey, ev) => {
+	const handleDismissFacet = En.useCallback((facetKey, value, ev) => {
 		const dismissButton = ev.currentTarget;
 		const selectionBar = dismissButton.closest(".DocSearch-FacetSelectionBar");
 		if (selectionBar) {
@@ -12699,7 +12980,7 @@ const FacetBar = En.memo(function FacetBar({ facets, selections, onSelectionChan
 			const target = (_ref = (_dismissButtons = dismissButtons[index + 1]) !== null && _dismissButtons !== void 0 ? _dismissButtons : dismissButtons[index - 1]) !== null && _ref !== void 0 ? _ref : triggerRefs.current.get(facetKey);
 			target === null || target === void 0 || target.focus();
 		}
-		onSelectionChange(facetKey, "");
+		onSelectionChange(facetKey, removeValue(value));
 	}, [onSelectionChange]);
 	const handleClearAll = En.useCallback(() => {
 		var _triggerRefs$current$;
@@ -12714,11 +12995,10 @@ const FacetBar = En.memo(function FacetBar({ facets, selections, onSelectionChan
 		"aria-label": facetsAriaLabel
 	}, facets.map((facet) => {
 		var _selections$facet$key;
-		const selectedValue = (_selections$facet$key = selections[facet.key]) !== null && _selections$facet$key !== void 0 ? _selections$facet$key : "";
 		return /* @__PURE__ */ En.createElement(FacetMenu, {
 			key: facet.key,
 			facet,
-			selectedValue,
+			selectedValues: (_selections$facet$key = selections[facet.key]) !== null && _selections$facet$key !== void 0 ? _selections$facet$key : EMPTY_SELECTION$1,
 			defaultValueLabel,
 			registerTrigger,
 			menuTriggerSelectedAriaLabel: facetMenuTriggerAriaLabel,
@@ -12731,7 +13011,7 @@ const FacetBar = En.memo(function FacetBar({ facets, selections, onSelectionChan
 	}, selectionsToDisplay.map(([key, value]) => {
 		var _facetLabels$get;
 		return /* @__PURE__ */ En.createElement(SelectedFacetChip, {
-			key,
+			key: `${key}:${value}`,
 			facetKey: key,
 			facetLabel: (_facetLabels$get = facetLabels.get(key)) !== null && _facetLabels$get !== void 0 ? _facetLabels$get : key,
 			value,
@@ -12892,6 +13172,19 @@ function useFacetValues({ facets, indexes, searchClient }) {
 	]);
 	return facetValues;
 }
+const EMPTY_SELECTION = [];
+/**
+* Compares two selections for a facet. A missing entry and an empty array are
+* both "nothing selected" so clearing an untouched facet doesn't trigger a
+* refresh.
+*/
+function areSelectionsEqual(a, b) {
+	const left = a !== null && a !== void 0 ? a : EMPTY_SELECTION;
+	const right = b !== null && b !== void 0 ? b : EMPTY_SELECTION;
+	if (left === right) return true;
+	if (left.length !== right.length) return false;
+	return left.every((value, index) => value === right[index]);
+}
 function useDocSearchFacets({ facets, indexes, searchClient, onSelectionsChange }) {
 	const normalizedFacets = En.useMemo(() => normalizeFacets(facets), [facets]);
 	const normalizedFacetsRef = En.useRef(normalizedFacets);
@@ -12921,16 +13214,23 @@ function useDocSearchFacets({ facets, indexes, searchClient, onSelectionsChange
 		visibleFacets,
 		facetSelections,
 		facetSelectionsRef,
-		handleFacetSelectionChange: En.useCallback((facet, value) => {
-			if (facetSelectionsRef.current[facet] === value) return;
-			const next = _objectSpread2$2({}, facetSelectionsRef.current);
-			next[facet] = value;
-			applySelections(next);
+		handleFacetSelectionChange: En.useCallback((facet, update) => {
+			const existing = facetSelectionsRef.current[facet];
+			const values = typeof update === "function" ? update(existing !== null && existing !== void 0 ? existing : EMPTY_SELECTION) : update;
+			if (areSelectionsEqual(existing, values)) return;
+			applySelections(_objectSpread2$2(_objectSpread2$2({}, facetSelectionsRef.current), {}, { [facet]: values }));
 		}, [applySelections]),
 		clearFacetSelections: En.useCallback(() => {
-			if (Object.keys(facetSelectionsRef.current).length === 0) return;
+			const current = facetSelectionsRef.current;
 			const next = {};
-			for (const facet of normalizedFacetsRef.current) if (facetSelectionsRef.current[facet.key]) next[facet.key] = "";
+			let hasSelectedValues = false;
+			for (const facet of normalizedFacetsRef.current) {
+				const values = current[facet.key];
+				if (values === void 0) continue;
+				if (values.length > 0) hasSelectedValues = true;
+				next[facet.key] = EMPTY_SELECTION;
+			}
+			if (!hasSelectedValues) return;
 			applySelections(next);
 		}, [applySelections])
 	};
@@ -13364,21 +13664,31 @@ function ResultsScreen(_ref) {
 		}));
 	}), props.resultsFooterComponent && /* @__PURE__ */ En.createElement("section", { className: "DocSearch-HitsFooter" }, /* @__PURE__ */ En.createElement(props.resultsFooterComponent, { state: props.state })));
 }
+function isFacetFilterOverridden(facetFilter, selectedFacets) {
+	if (typeof facetFilter === "string") {
+		const key = getFacetFilterKey(facetFilter);
+		return key !== null && selectedFacets.has(key);
+	}
+	return facetFilter.length > 0 && facetFilter.every((entry) => isFacetFilterOverridden(entry, selectedFacets));
+}
+/**
+* Merges configured `facetFilters` with the user's facet selections.
+*
+* Multiple values selected for the same facet are combined into an OR group
+* (nested array). Different facets are combined with AND (top-level entries),
+* following Algolia `facetFilters` semantics.
+*/
 function createFacetFilters(searchParametersFacetFilters, facetSelections) {
 	const selections = Object.entries(facetSelections);
+	if (selections.length === 0) return searchParametersFacetFilters;
 	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;
+	for (const [facet, values] of selections) if (values.length === 1) dynamicFacetFilters.push(`${facet}:${values[0]}`);
+	else if (values.length > 1) dynamicFacetFilters.push(values.map((value) => `${facet}:${value}`));
 	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];
+	return [...configuredFacetFilters.filter((facetFilter) => !isFacetFilterOverridden(facetFilter, selectedFacets)), ...dynamicFacetFilters];
 }
 function buildNoQuerySources({ recentSearches, favoriteSearches, saveRecentSearch, onClose, disableUserPersonalization }) {
 	if (disableUserPersonalization) return [];
@@ -16305,7 +16615,7 @@ function createAutocomplete(options) {
 }
 
 //#endregion
-//#region ../docsearch-react/dist/esm/DocSearchModal-Cgdi4eHY.js
+//#region ../docsearch-react/dist/esm/DocSearchModal-CLcbYBea.js
 init_compat();
 const _excluded$3 = ["translations"];
 function KeywordSearchBox(_ref) {