@ariakit/react-core 0.3.6 → 0.3.8

package/esm/combobox/combobox-cancel.js

@@ -4,7 +4,7 @@ import {
 } from "../__chunks/VDNZBO4W.js";
 import {
   useComboboxProviderContext
-} from "../__chunks/MTC2KUZZ.js";
+} from "../__chunks/W76OTZCC.js";
 import "../__chunks/NWCBQ4CV.js";
 import "../__chunks/IB7YUKH5.js";
 import "../__chunks/4UUKJZ4V.js";

package/esm/combobox/combobox-context.d.ts

@@ -12,9 +12,10 @@ import type { ComboboxStore } from "./combobox-store.js";
  *   // Use the store...
  * }
  */
-export declare const useComboboxContext: () => ComboboxStore | undefined;
-export declare const useComboboxScopedContext: (onlyScoped?: boolean) => ComboboxStore | undefined;
-export declare const useComboboxProviderContext: () => ComboboxStore | undefined;
-export declare const ComboboxContextProvider: (props: import("react").ProviderProps<ComboboxStore | undefined>) => import("react/jsx-runtime").JSX.Element;
-export declare const ComboboxScopedContextProvider: (props: import("react").ProviderProps<ComboboxStore | undefined>) => import("react/jsx-runtime").JSX.Element;
+export declare const useComboboxContext: () => ComboboxStore<string | string[]> | undefined;
+export declare const useComboboxScopedContext: (onlyScoped?: boolean) => ComboboxStore<string | string[]> | undefined;
+export declare const useComboboxProviderContext: () => ComboboxStore<string | string[]> | undefined;
+export declare const ComboboxContextProvider: (props: import("react").ProviderProps<ComboboxStore<string | string[]> | undefined>) => import("react/jsx-runtime").JSX.Element;
+export declare const ComboboxScopedContextProvider: (props: import("react").ProviderProps<ComboboxStore<string | string[]> | undefined>) => import("react/jsx-runtime").JSX.Element;
 export declare const ComboboxItemValueContext: import("react").Context<string | undefined>;
+export declare const ComboboxItemCheckedContext: import("react").Context<boolean>;

package/esm/combobox/combobox-context.js

@@ -1,12 +1,13 @@
 "use client";
 import {
   ComboboxContextProvider,
+  ComboboxItemCheckedContext,
   ComboboxItemValueContext,
   ComboboxScopedContextProvider,
   useComboboxContext,
   useComboboxProviderContext,
   useComboboxScopedContext
-} from "../__chunks/MTC2KUZZ.js";
+} from "../__chunks/W76OTZCC.js";
 import "../__chunks/IB7YUKH5.js";
 import "../__chunks/4UUKJZ4V.js";
 import "../__chunks/7H5KSHHF.js";
@@ -18,6 +19,7 @@ import "../__chunks/XM66DUTO.js";
 import "../__chunks/4R3V3JGP.js";
 export {
   ComboboxContextProvider,
+  ComboboxItemCheckedContext,
   ComboboxItemValueContext,
   ComboboxScopedContextProvider,
   useComboboxContext,

package/esm/combobox/combobox-disclosure.js

@@ -6,7 +6,7 @@ import "../__chunks/BHEJ6NUH.js";
 import "../__chunks/VDNZBO4W.js";
 import {
   useComboboxProviderContext
-} from "../__chunks/MTC2KUZZ.js";
+} from "../__chunks/W76OTZCC.js";
 import "../__chunks/NWCBQ4CV.js";
 import "../__chunks/IB7YUKH5.js";
 import "../__chunks/4UUKJZ4V.js";

package/esm/combobox/combobox-item-check.d.ts

@@ -0,0 +1,60 @@
+import type { CheckboxCheckOptions } from "../checkbox/checkbox-check.jsx";
+import type { As, Props } from "../utils/types.js";
+import type { ComboboxStore } from "./combobox-store.js";
+/**
+ * Returns props to create a `ComboboxItemCheck` component. This hook must be
+ * used in a component that's wrapped with `ComboboxItem` or the `checked` prop
+ * must be explicitly passed to the component.
+ * @see https://ariakit.org/components/combobox
+ * @example
+ * ```jsx
+ * const props = useComboboxItemCheck({ checked: true });
+ * <Role {...props} />
+ * ```
+ */
+export declare const useComboboxItemCheck: import("../utils/types.js").Hook<ComboboxItemCheckOptions<"span">>;
+/**
+ * Renders a checkmark inside a
+ * [`ComboboxItem`](https://ariakit.org/reference/combobox-item) component. This
+ * component must be wrapped with
+ * [`ComboboxItem`](https://ariakit.org/reference/combobox-item) or the
+ * [`checked`](https://ariakit.org/reference/combobox-item-check#checked) prop
+ * must be explicitly passed to the component.
+ * @see https://ariakit.org/components/combobox
+ * @example
+ * ```jsx {5,9}
+ * <ComboboxProvider>
+ *   <Combobox />
+ *   <ComboboxPopover>
+ *     <ComboboxItem value="Apple">
+ *       <ComboboxItemCheck />
+ *       Apple
+ *     </ComboboxItem>
+ *     <ComboboxItem value="Orange">
+ *       <ComboboxItemCheck />
+ *       Orange
+ *     </ComboboxItem>
+ *   </ComboboxPopover>
+ * </ComboboxProvider>
+ * ```
+ */
+export declare const ComboboxItemCheck: import("../utils/types.js").Component<ComboboxItemCheckOptions<"span">>;
+export interface ComboboxItemCheckOptions<T extends As = "span"> extends CheckboxCheckOptions<T> {
+    /**
+     * Object returned by the
+     * [`useComboboxStore`](https://ariakit.org/reference/use-combobox-store)
+     * hook. If not provided, the parent
+     * [`ComboboxList`](https://ariakit.org/reference/combobox-list) or
+     * [`ComboboxPopover`](https://ariakit.org/reference/combobox-popover)
+     * components' context will be used.
+     */
+    store?: ComboboxStore;
+    /**
+     * Whether the check mark should be shown. This value is automatically
+     * inferred from the parent
+     * [`ComboboxItem`](https://ariakit.org/reference/combobox-item) component.
+     * Manually setting this prop will override the inferred value.
+     */
+    checked?: boolean;
+}
+export type ComboboxItemCheckProps<T extends As = "span"> = Props<ComboboxItemCheckOptions<T>>;

package/esm/combobox/combobox-item-check.js

@@ -0,0 +1,50 @@
+"use client";
+import {
+  useCheckboxCheck
+} from "../__chunks/MW2F7SEA.js";
+import "../__chunks/6XBVQI3K.js";
+import {
+  ComboboxItemCheckedContext
+} from "../__chunks/W76OTZCC.js";
+import "../__chunks/IB7YUKH5.js";
+import "../__chunks/4UUKJZ4V.js";
+import "../__chunks/7H5KSHHF.js";
+import "../__chunks/G6BJYYBK.js";
+import "../__chunks/OAYFXAQ2.js";
+import {
+  createComponent,
+  createElement,
+  createHook
+} from "../__chunks/3ORBWXWF.js";
+import "../__chunks/6O5OEQGF.js";
+import "../__chunks/XM66DUTO.js";
+import {
+  __objRest,
+  __spreadProps,
+  __spreadValues
+} from "../__chunks/4R3V3JGP.js";
+
+// src/combobox/combobox-item-check.ts
+import { useContext } from "react";
+var useComboboxItemCheck = createHook(
+  (_a) => {
+    var _b = _a, { store, checked } = _b, props = __objRest(_b, ["store", "checked"]);
+    const context = useContext(ComboboxItemCheckedContext);
+    checked = checked != null ? checked : context;
+    props = useCheckboxCheck(__spreadProps(__spreadValues({}, props), { checked }));
+    return props;
+  }
+);
+var ComboboxItemCheck = createComponent(
+  (props) => {
+    const htmlProps = useComboboxItemCheck(props);
+    return createElement("span", htmlProps);
+  }
+);
+if (process.env.NODE_ENV !== "production") {
+  ComboboxItemCheck.displayName = "ComboboxItemCheck";
+}
+export {
+  ComboboxItemCheck,
+  useComboboxItemCheck
+};

package/esm/combobox/combobox-item-value.js

@@ -2,7 +2,7 @@
 import {
   ComboboxItemValueContext,
   useComboboxScopedContext
-} from "../__chunks/MTC2KUZZ.js";
+} from "../__chunks/W76OTZCC.js";
 import "../__chunks/IB7YUKH5.js";
 import "../__chunks/4UUKJZ4V.js";
 import "../__chunks/7H5KSHHF.js";

package/esm/combobox/combobox-item.d.ts

@@ -52,15 +52,15 @@ export interface ComboboxItemOptions<T extends As = "div"> extends CompositeItem
     store?: ComboboxStore;
     /**
      * The value of the item. This will be rendered as the children by default.
-     *   - If
-     *     [`setValueOnClick`](https://ariakit.org/reference/combobox-item#setvalueonclick)
-     *     is set to `true`, this will be the value of the combobox input when the
-     *     user clicks on this item.
-     *   - If the
-     *     [`autoComplete`](https://ariakit.org/reference/combobox#autocomplete)
-     *     prop on the [`Combobox`](https://ariakit.org/reference/combobox)
-     *     component is set to `both` or `inline`, this will be the value of the
-     *     combobox input when the combobox loses focus.
+     * - If
+     *   [`setValueOnClick`](https://ariakit.org/reference/combobox-item#setvalueonclick)
+     *   is set to `true`, this will be the value of the combobox input when the
+     *   user clicks on this item.
+     * - If the
+     *   [`autoComplete`](https://ariakit.org/reference/combobox#autocomplete)
+     *   prop on the [`Combobox`](https://ariakit.org/reference/combobox)
+     *   component is set to `both` or `inline`, this will be the value of the
+     *   combobox input when the combobox loses focus.
      *
      * Live examples:
      * - [Animated Combobox](https://ariakit.org/examples/combobox-animated)
@@ -73,18 +73,36 @@ export interface ComboboxItemOptions<T extends As = "div"> extends CompositeItem
      */
     value?: string;
     /**
-     * Whether to hide the combobox when this item is clicked.
+     * Whether to hide the combobox when this item is clicked. By default, the
+     * combobox will be hidden when the user clicks on an item with a
+     * [`value`](https://ariakit.org/reference/combobox-item#value) prop, unless
+     * the combobox is
+     * [multi-selectable](https://ariakit.org/examples/combobox-multiple).
      *
      * Live examples:
      * - [Combobox with links](https://ariakit.org/examples/combobox-links)
-     * @default true
      */
     hideOnClick?: BooleanOrCallback<MouseEvent<HTMLElement>>;
     /**
-     * Whether to set the combobox value with this item's value when this item is
-     * clicked.
+     * Whether to set the
+     * [`selectedValue`](https://ariakit.org/reference/combobox-provider#selectedvalue)
+     * state using this item's
+     * [`value`](https://ariakit.org/reference/combobox-item#value) when the item
+     * is clicked.
      * @default true
      */
+    selectValueOnClick?: BooleanOrCallback<MouseEvent<HTMLElement>>;
+    /**
+     * Whether to set the combobox
+     * [`value`](https://ariakit.org/reference/combobox-provider#value) state
+     * using this item's
+     * [`value`](https://ariakit.org/reference/combobox-item#value) when the item
+     * is clicked. The default is `true`, unless the combobox is
+     * [multi-selectable](https://ariakit.org/examples/combobox-multiple).
+     *
+     * Live examples:
+     * - [Menu with Combobox](https://ariakit.org/examples/menu-combobox)
+     */
     setValueOnClick?: BooleanOrCallback<MouseEvent<HTMLElement>>;
     /**
      * @default false

package/esm/combobox/combobox-item.js

@@ -1,11 +1,12 @@
 "use client";
 import {
   useCompositeHover
-} from "../__chunks/BRO2JF5P.js";
+} from "../__chunks/G6ONQ5EH.js";
 import {
+  ComboboxItemCheckedContext,
   ComboboxItemValueContext,
   useComboboxScopedContext
-} from "../__chunks/MTC2KUZZ.js";
+} from "../__chunks/W76OTZCC.js";
 import {
   useCompositeItem
 } from "../__chunks/5PEPOQU7.js";
@@ -44,13 +45,24 @@ import { isDownloading, isOpeningInNewTab } from "@ariakit/core/utils/events";
 import { hasFocus } from "@ariakit/core/utils/focus";
 import { invariant } from "@ariakit/core/utils/misc";
 import { jsx } from "react/jsx-runtime";
+function isSelected(storeValue, itemValue) {
+  if (itemValue == null)
+    return;
+  if (storeValue == null)
+    return false;
+  if (Array.isArray(storeValue)) {
+    return storeValue.includes(itemValue);
+  }
+  return storeValue === itemValue;
+}
 var useComboboxItem = createHook(
   (_a) => {
     var _b = _a, {
       store,
       value,
-      hideOnClick = value != null,
-      setValueOnClick = true,
+      hideOnClick,
+      selectValueOnClick = true,
+      setValueOnClick,
       focusOnHover = false,
       moveOnKeyPress = true,
       getItem: getItemProp
@@ -58,6 +70,7 @@ var useComboboxItem = createHook(
       "store",
       "value",
       "hideOnClick",
+      "selectValueOnClick",
       "setValueOnClick",
       "focusOnHover",
       "moveOnKeyPress",
@@ -79,8 +92,14 @@ var useComboboxItem = createHook(
       },
       [value, getItemProp]
     );
+    const multiSelectable = store.useState(
+      (state) => Array.isArray(state.selectedValue)
+    );
+    setValueOnClick = setValueOnClick != null ? setValueOnClick : !multiSelectable;
+    hideOnClick = hideOnClick != null ? hideOnClick : value != null && !multiSelectable;
     const onClickProp = props.onClick;
     const setValueOnClickProp = useBooleanEvent(setValueOnClick);
+    const selectValueOnClickProp = useBooleanEvent(selectValueOnClick);
     const hideOnClickProp = useBooleanEvent(hideOnClick);
     const onClick = useEvent((event) => {
       onClickProp == null ? void 0 : onClickProp(event);
@@ -90,8 +109,20 @@ var useComboboxItem = createHook(
         return;
       if (isOpeningInNewTab(event))
         return;
-      if (value != null && setValueOnClickProp(event)) {
-        store == null ? void 0 : store.setValue(value);
+      if (value != null) {
+        if (selectValueOnClickProp(event)) {
+          store == null ? void 0 : store.setSelectedValue((prevValue) => {
+            if (!Array.isArray(prevValue))
+              return value;
+            if (prevValue.includes(value)) {
+              return prevValue.filter((v) => v !== value);
+            }
+            return [...prevValue, value];
+          });
+        }
+        if (setValueOnClickProp(event)) {
+          store == null ? void 0 : store.setValue(value);
+        }
       }
       if (hideOnClickProp(event)) {
         store == null ? void 0 : store.move(null);
@@ -116,10 +147,16 @@ var useComboboxItem = createHook(
         }
       }
     });
+    const selected = store.useState(
+      (state) => isSelected(state.selectedValue, value)
+    );
+    if (multiSelectable && selected != null) {
+      props["aria-selected"] = selected;
+    }
     props = useWrapElement(
       props,
-      (element) => /* @__PURE__ */ jsx(ComboboxItemValueContext.Provider, { value, children: element }),
-      [value]
+      (element) => /* @__PURE__ */ jsx(ComboboxItemValueContext.Provider, { value, children: /* @__PURE__ */ jsx(ComboboxItemCheckedContext.Provider, { value: selected != null ? selected : false, children: element }) }),
+      [value, selected]
     );
     const contentElement = store.useState("contentElement");
     props = __spreadProps(__spreadValues({

package/esm/combobox/combobox-label.d.ts

@@ -0,0 +1,42 @@
+import type { As, Options, Props } from "../utils/types.js";
+import type { ComboboxStore } from "./combobox-store.js";
+/**
+ * Returns props to create a `ComboboxLabel` component.
+ * @see https://ariakit.org/components/combobox
+ * @example
+ * ```jsx
+ * const store = useComboboxStore();
+ * const props = useComboboxLabel({ store });
+ * <Role {...props}>Favorite fruit</Role>
+ * <Combobox store={store} />
+ * ```
+ */
+export declare const useComboboxLabel: import("../utils/types.js").Hook<ComboboxLabelOptions<"label">>;
+/**
+ * Renders a label for the [`Combobox`](https://ariakit.org/reference/combobox)
+ * component.
+ * @see https://ariakit.org/components/combobox
+ * @example
+ * ```jsx {2}
+ * <ComboboxProvider>
+ *   <ComboboxLabel>Favorite fruit</ComboboxLabel>
+ *   <Combobox />
+ *   <ComboboxPopover>
+ *     <ComboboxItem value="Apple" />
+ *     <ComboboxItem value="Orange" />
+ *   </ComboboxPopover>
+ * </ComboboxProvider>
+ * ```
+ */
+export declare const ComboboxLabel: import("../utils/types.js").Component<ComboboxLabelOptions<"label">>;
+export interface ComboboxLabelOptions<T extends As = "label"> extends Options<T> {
+    /**
+     * Object returned by the
+     * [`useComboboxStore`](https://ariakit.org/reference/use-combobox-store)
+     * hook. If not provided, the closest
+     * [`ComboboxProvider`](https://ariakit.org/reference/combobox-provider)
+     * component's context will be used.
+     */
+    store?: ComboboxStore;
+}
+export type ComboboxLabelProps<T extends As = "label"> = Props<ComboboxLabelOptions<T>>;

package/esm/combobox/combobox-label.js

@@ -0,0 +1,55 @@
+"use client";
+import {
+  useComboboxProviderContext
+} from "../__chunks/W76OTZCC.js";
+import "../__chunks/IB7YUKH5.js";
+import "../__chunks/4UUKJZ4V.js";
+import "../__chunks/7H5KSHHF.js";
+import "../__chunks/G6BJYYBK.js";
+import "../__chunks/OAYFXAQ2.js";
+import {
+  createElement,
+  createHook,
+  createMemoComponent
+} from "../__chunks/3ORBWXWF.js";
+import "../__chunks/6O5OEQGF.js";
+import "../__chunks/XM66DUTO.js";
+import {
+  __objRest,
+  __spreadValues
+} from "../__chunks/4R3V3JGP.js";
+
+// src/combobox/combobox-label.ts
+import { invariant } from "@ariakit/core/utils/misc";
+var useComboboxLabel = createHook(
+  (_a) => {
+    var _b = _a, { store } = _b, props = __objRest(_b, ["store"]);
+    const context = useComboboxProviderContext();
+    store = store || context;
+    invariant(
+      store,
+      process.env.NODE_ENV !== "production" && "ComboboxLabel must receive a `store` prop or be wrapped in a ComboboxProvider component."
+    );
+    const comboboxId = store.useState((state) => {
+      var _a2;
+      return (_a2 = state.baseElement) == null ? void 0 : _a2.id;
+    });
+    props = __spreadValues({
+      htmlFor: comboboxId
+    }, props);
+    return props;
+  }
+);
+var ComboboxLabel = createMemoComponent(
+  (props) => {
+    const htmlProps = useComboboxLabel(props);
+    return createElement("label", htmlProps);
+  }
+);
+if (process.env.NODE_ENV !== "production") {
+  ComboboxLabel.displayName = "ComboboxLabel";
+}
+export {
+  ComboboxLabel,
+  useComboboxLabel
+};

package/esm/combobox/combobox-list.js

@@ -2,8 +2,8 @@
 import {
   ComboboxList,
   useComboboxList
-} from "../__chunks/KFUKDUTY.js";
-import "../__chunks/MTC2KUZZ.js";
+} from "../__chunks/4AMOOZBQ.js";
+import "../__chunks/W76OTZCC.js";
 import "../__chunks/IB7YUKH5.js";
 import "../__chunks/4UUKJZ4V.js";
 import "../__chunks/A7CE3X6M.js";

package/esm/combobox/combobox-popover.js

@@ -1,15 +1,15 @@
 "use client";
 import {
   useComboboxList
-} from "../__chunks/KFUKDUTY.js";
+} from "../__chunks/4AMOOZBQ.js";
 import {
   useComboboxProviderContext
-} from "../__chunks/MTC2KUZZ.js";
+} from "../__chunks/W76OTZCC.js";
 import "../__chunks/IB7YUKH5.js";
 import "../__chunks/4UUKJZ4V.js";
 import {
   usePopover
-} from "../__chunks/KB2HXEVC.js";
+} from "../__chunks/WBQC3LL4.js";
 import {
   createDialogComponent
 } from "../__chunks/U7WGY7YX.js";

package/esm/combobox/combobox-provider.d.ts

@@ -1,5 +1,7 @@
-import type { ReactNode } from "react";
-import type { ComboboxStoreProps } from "./combobox-store.js";
+import type { ReactElement, ReactNode } from "react";
+import type { PickRequired } from "@ariakit/core/utils/types";
+import type { ComboboxStoreProps, ComboboxStoreSelectedValue } from "./combobox-store.js";
+type Value = ComboboxStoreSelectedValue;
 /**
  * Provides a combobox store to Combobox components.
  * @see https://ariakit.org/components/combobox
@@ -15,7 +17,9 @@ import type { ComboboxStoreProps } from "./combobox-store.js";
  * </ComboboxProvider>
  * ```
  */
-export declare function ComboboxProvider(props?: ComboboxProviderProps): import("react/jsx-runtime").JSX.Element;
-export interface ComboboxProviderProps extends ComboboxStoreProps {
+export declare function ComboboxProvider<T extends Value = Value>(props: PickRequired<ComboboxProviderProps<T>, "selectedValue" | "defaultSelectedValue">): ReactElement;
+export declare function ComboboxProvider(props?: ComboboxProviderProps): ReactElement;
+export interface ComboboxProviderProps<T extends Value = Value> extends ComboboxStoreProps<T> {
     children?: ReactNode;
 }
+export {};

package/esm/combobox/combobox-provider.js

@@ -1,10 +1,10 @@
 "use client";
 import {
   useComboboxStore
-} from "../__chunks/24AKC2LC.js";
+} from "../__chunks/ZETMAOTK.js";
 import {
   ComboboxContextProvider
-} from "../__chunks/MTC2KUZZ.js";
+} from "../__chunks/W76OTZCC.js";
 import "../__chunks/ELWRSPQ7.js";
 import "../__chunks/5A2VZUUV.js";
 import "../__chunks/IB7YUKH5.js";

package/esm/combobox/combobox-row.js

@@ -1,7 +1,7 @@
 "use client";
 import {
   useComboboxScopedContext
-} from "../__chunks/MTC2KUZZ.js";
+} from "../__chunks/W76OTZCC.js";
 import {
   useCompositeRow
 } from "../__chunks/BNUFNEVY.js";

package/esm/combobox/combobox-separator.js

@@ -1,7 +1,7 @@
 "use client";
 import {
   useComboboxScopedContext
-} from "../__chunks/MTC2KUZZ.js";
+} from "../__chunks/W76OTZCC.js";
 import {
   useCompositeSeparator
 } from "../__chunks/ENRQQ6LK.js";

package/esm/combobox/combobox-store.d.ts

@@ -1,7 +1,9 @@
 import * as Core from "@ariakit/core/combobox/combobox-store";
+import type { PickRequired } from "@ariakit/core/utils/types";
 import type { CompositeStoreFunctions, CompositeStoreOptions, CompositeStoreState } from "../composite/composite-store.js";
 import type { PopoverStoreFunctions, PopoverStoreOptions, PopoverStoreState } from "../popover/popover-store.js";
 import type { Store } from "../utils/store.js";
+type Value = Core.ComboboxStoreSelectedValue;
 export declare function useComboboxStoreProps<T extends Core.ComboboxStore>(store: T, update: () => void, props: ComboboxStoreProps): T;
 /**
  * Creates a combobox store.
@@ -17,27 +19,44 @@ export declare function useComboboxStoreProps<T extends Core.ComboboxStore>(stor
  * </ComboboxPopover>
  * ```
  */
+export declare function useComboboxStore<T extends Value = Value>(props: PickRequired<ComboboxStoreProps<T>, "selectedValue" | "defaultSelectedValue">): ComboboxStore<T>;
 export declare function useComboboxStore(props?: ComboboxStoreProps): ComboboxStore;
 export type ComboboxStoreItem = Core.ComboboxStoreItem;
-export interface ComboboxStoreState extends Core.ComboboxStoreState, CompositeStoreState<ComboboxStoreItem>, PopoverStoreState {
+export type ComboboxStoreSelectedValue = Core.ComboboxStoreSelectedValue;
+export interface ComboboxStoreState<T extends Value = Value> extends Core.ComboboxStoreState<T>, CompositeStoreState<ComboboxStoreItem>, PopoverStoreState {
 }
-export interface ComboboxStoreFunctions extends Core.ComboboxStoreFunctions, CompositeStoreFunctions<ComboboxStoreItem>, PopoverStoreFunctions {
+export interface ComboboxStoreFunctions<T extends Value = Value> extends Core.ComboboxStoreFunctions<T>, CompositeStoreFunctions<ComboboxStoreItem>, PopoverStoreFunctions {
 }
-export interface ComboboxStoreOptions extends Core.ComboboxStoreOptions, CompositeStoreOptions<ComboboxStoreItem>, PopoverStoreOptions {
+export interface ComboboxStoreOptions<T extends Value = Value> extends Core.ComboboxStoreOptions<T>, CompositeStoreOptions<ComboboxStoreItem>, PopoverStoreOptions {
     /**
-     * A callback that gets called when the `value` state changes.
+     * A callback that gets called when the
+     * [`value`](https://ariakit.org/reference/combobox-provider#value) state
+     * changes.
      *
      * Live examples:
-     * - [Combobox filtering](https://ariakit.org/examples/combobox-filtering)
+     * - [Combobox with integrated
+     *   filter](https://ariakit.org/examples/combobox-filtering-integrated)
      * - [ComboboxGroup](https://ariakit.org/examples/combobox-group)
      * - [Combobox with links](https://ariakit.org/examples/combobox-links)
      * - [Multi-selectable
      *   Combobox](https://ariakit.org/examples/combobox-multiple)
      * - [Menu with Combobox](https://ariakit.org/examples/menu-combobox)
      * - [Select with Combobox](https://ariakit.org/examples/select-combobox)
-     * @param value The new value.
      */
-    setValue?: (value: ComboboxStoreState["value"]) => void;
+    setValue?: (value: ComboboxStoreState<T>["value"]) => void;
+    /**
+     * A callback that gets called when the
+     * [`selectedValue`](https://ariakit.org/reference/combobox-provider#selectedvalue)
+     * state changes.
+     *
+     * Live examples:
+     * - [Multi-selectable
+     *   Combobox](https://ariakit.org/examples/combobox-multiple)
+     */
+    setSelectedValue?: (value: ComboboxStoreState<T>["selectedValue"]) => void;
+}
+export interface ComboboxStoreProps<T extends Value = Value> extends ComboboxStoreOptions<T>, Core.ComboboxStoreProps<T> {
+}
+export interface ComboboxStore<T extends Value = Value> extends ComboboxStoreFunctions<T>, Store<Core.ComboboxStore<T>> {
 }
-export type ComboboxStoreProps = ComboboxStoreOptions & Core.ComboboxStoreProps;
-export type ComboboxStore = ComboboxStoreFunctions & Store<Core.ComboboxStore>;
+export {};

package/esm/combobox/combobox-store.js

@@ -2,7 +2,7 @@
 import {
   useComboboxStore,
   useComboboxStoreProps
-} from "../__chunks/24AKC2LC.js";
+} from "../__chunks/ZETMAOTK.js";
 import "../__chunks/ELWRSPQ7.js";
 import "../__chunks/5A2VZUUV.js";
 import "../__chunks/UNZQE6T7.js";

package/esm/combobox/combobox.d.ts

@@ -59,7 +59,8 @@ export interface ComboboxOptions<T extends As = "input"> extends CompositeOption
      *   popup opens, but the input value doesn't change.
      *
      * Live examples:
-     * - [ComboboxCancel](https://ariakit.org/examples/combobox-cancel)
+     * - [Combobox with integrated
+     *   filter](https://ariakit.org/examples/combobox-filtering-integrated)
      * - [ComboboxGroup](https://ariakit.org/examples/combobox-group)
      * - [Combobox with links](https://ariakit.org/examples/combobox-links)
      * - [Textarea with inline