@ariakit/react-core 0.3.6 → 0.3.8

package/cjs/combobox/combobox-item.cjs

@@ -1,11 +1,12 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});"use client";
 
 
-var _RRW7YVFRcjs = require('../__chunks/RRW7YVFR.cjs');
+var _IPYAEPOTcjs = require('../__chunks/IPYAEPOT.cjs');
 
 
 
-var _VEG6PRAGcjs = require('../__chunks/VEG6PRAG.cjs');
+
+var _3WCBE6SUcjs = require('../__chunks/3WCBE6SU.cjs');
 
 
 var _P43G7USHcjs = require('../__chunks/P43G7USH.cjs');
@@ -44,13 +45,24 @@ var _events = require('@ariakit/core/utils/events');
 var _focus = require('@ariakit/core/utils/focus');
 var _misc = require('@ariakit/core/utils/misc');
 var _jsxruntime = require('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 = _RNZNGEL4cjs.createHook.call(void 0, 
   (_a) => {
     var _b = _a, {
       store,
       value,
-      hideOnClick = value != null,
-      setValueOnClick = true,
+      hideOnClick,
+      selectValueOnClick = true,
+      setValueOnClick,
       focusOnHover = false,
       moveOnKeyPress = true,
       getItem: getItemProp
@@ -58,12 +70,13 @@ var useComboboxItem = _RNZNGEL4cjs.createHook.call(void 0,
       "store",
       "value",
       "hideOnClick",
+      "selectValueOnClick",
       "setValueOnClick",
       "focusOnHover",
       "moveOnKeyPress",
       "getItem"
     ]);
-    const context = _VEG6PRAGcjs.useComboboxScopedContext.call(void 0, );
+    const context = _3WCBE6SUcjs.useComboboxScopedContext.call(void 0, );
     store = store || context;
     _misc.invariant.call(void 0, 
       store,
@@ -79,8 +92,14 @@ var useComboboxItem = _RNZNGEL4cjs.createHook.call(void 0,
       },
       [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 = _EO6LS72Hcjs.useBooleanEvent.call(void 0, setValueOnClick);
+    const selectValueOnClickProp = _EO6LS72Hcjs.useBooleanEvent.call(void 0, selectValueOnClick);
     const hideOnClickProp = _EO6LS72Hcjs.useBooleanEvent.call(void 0, hideOnClick);
     const onClick = _EO6LS72Hcjs.useEvent.call(void 0, (event) => {
       onClickProp == null ? void 0 : onClickProp(event);
@@ -90,8 +109,20 @@ var useComboboxItem = _RNZNGEL4cjs.createHook.call(void 0,
         return;
       if (_events.isOpeningInNewTab.call(void 0, 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 = _RNZNGEL4cjs.createHook.call(void 0,
         }
       }
     });
+    const selected = store.useState(
+      (state) => isSelected(state.selectedValue, value)
+    );
+    if (multiSelectable && selected != null) {
+      props["aria-selected"] = selected;
+    }
     props = _EO6LS72Hcjs.useWrapElement.call(void 0, 
       props,
-      (element) => /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _VEG6PRAGcjs.ComboboxItemValueContext.Provider, { value, children: element }),
-      [value]
+      (element) => /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _3WCBE6SUcjs.ComboboxItemValueContext.Provider, { value, children: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _3WCBE6SUcjs.ComboboxItemCheckedContext.Provider, { value: selected != null ? selected : false, children: element }) }),
+      [value, selected]
     );
     const contentElement = store.useState("contentElement");
     props = _AV6KTKLEcjs.__spreadProps.call(void 0, _AV6KTKLEcjs.__spreadValues.call(void 0, {
@@ -146,7 +183,7 @@ var useComboboxItem = _RNZNGEL4cjs.createHook.call(void 0,
         return true;
       }
     }));
-    props = _RRW7YVFRcjs.useCompositeHover.call(void 0, _AV6KTKLEcjs.__spreadValues.call(void 0, { store, focusOnHover }, props));
+    props = _IPYAEPOTcjs.useCompositeHover.call(void 0, _AV6KTKLEcjs.__spreadValues.call(void 0, { store, focusOnHover }, props));
     return props;
   }
 );

package/cjs/combobox/combobox-item.d.cts

@@ -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/cjs/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/cjs/combobox/combobox-label.cjs

@@ -0,0 +1,55 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});"use client";
+
+
+var _3WCBE6SUcjs = require('../__chunks/3WCBE6SU.cjs');
+require('../__chunks/UZNYSPKP.cjs');
+require('../__chunks/BZTDJIVT.cjs');
+require('../__chunks/UVBBMANL.cjs');
+require('../__chunks/F2A2ZQDB.cjs');
+require('../__chunks/S6UU7NA4.cjs');
+
+
+
+
+var _RNZNGEL4cjs = require('../__chunks/RNZNGEL4.cjs');
+require('../__chunks/EO6LS72H.cjs');
+require('../__chunks/CJDHQUBR.cjs');
+
+
+
+var _AV6KTKLEcjs = require('../__chunks/AV6KTKLE.cjs');
+
+// src/combobox/combobox-label.ts
+var _misc = require('@ariakit/core/utils/misc');
+var useComboboxLabel = _RNZNGEL4cjs.createHook.call(void 0, 
+  (_a) => {
+    var _b = _a, { store } = _b, props = _AV6KTKLEcjs.__objRest.call(void 0, _b, ["store"]);
+    const context = _3WCBE6SUcjs.useComboboxProviderContext.call(void 0, );
+    store = store || context;
+    _misc.invariant.call(void 0, 
+      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 = _AV6KTKLEcjs.__spreadValues.call(void 0, {
+      htmlFor: comboboxId
+    }, props);
+    return props;
+  }
+);
+var ComboboxLabel = _RNZNGEL4cjs.createMemoComponent.call(void 0, 
+  (props) => {
+    const htmlProps = useComboboxLabel(props);
+    return _RNZNGEL4cjs.createElement.call(void 0, "label", htmlProps);
+  }
+);
+if (process.env.NODE_ENV !== "production") {
+  ComboboxLabel.displayName = "ComboboxLabel";
+}
+
+
+
+exports.ComboboxLabel = ComboboxLabel; exports.useComboboxLabel = useComboboxLabel;

package/cjs/combobox/combobox-label.d.cts

@@ -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/cjs/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/cjs/combobox/combobox-list.cjs

@@ -2,8 +2,8 @@
 
 
 
-var _QU2266CJcjs = require('../__chunks/QU2266CJ.cjs');
-require('../__chunks/VEG6PRAG.cjs');
+var _WH4I6OSNcjs = require('../__chunks/WH4I6OSN.cjs');
+require('../__chunks/3WCBE6SU.cjs');
 require('../__chunks/UZNYSPKP.cjs');
 require('../__chunks/BZTDJIVT.cjs');
 require('../__chunks/7BSMGTGR.cjs');
@@ -20,4 +20,4 @@ require('../__chunks/AV6KTKLE.cjs');
 
 
 
-exports.ComboboxList = _QU2266CJcjs.ComboboxList; exports.useComboboxList = _QU2266CJcjs.useComboboxList;
+exports.ComboboxList = _WH4I6OSNcjs.ComboboxList; exports.useComboboxList = _WH4I6OSNcjs.useComboboxList;

package/cjs/combobox/combobox-popover.cjs

@@ -1,15 +1,15 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});"use client";
 
 
-var _QU2266CJcjs = require('../__chunks/QU2266CJ.cjs');
+var _WH4I6OSNcjs = require('../__chunks/WH4I6OSN.cjs');
 
 
-var _VEG6PRAGcjs = require('../__chunks/VEG6PRAG.cjs');
+var _3WCBE6SUcjs = require('../__chunks/3WCBE6SU.cjs');
 require('../__chunks/UZNYSPKP.cjs');
 require('../__chunks/BZTDJIVT.cjs');
 
 
-var _ISGOCBDCcjs = require('../__chunks/ISGOCBDC.cjs');
+var _RIZYIKBEcjs = require('../__chunks/RIZYIKBE.cjs');
 
 
 var _XFPRAS3Jcjs = require('../__chunks/XFPRAS3J.cjs');
@@ -84,15 +84,15 @@ var useComboboxPopover = _RNZNGEL4cjs.createHook.call(void 0,
       "alwaysVisible",
       "hideOnInteractOutside"
     ]);
-    const context = _VEG6PRAGcjs.useComboboxProviderContext.call(void 0, );
+    const context = _3WCBE6SUcjs.useComboboxProviderContext.call(void 0, );
     store = store || context;
     _misc.invariant.call(void 0, 
       store,
       process.env.NODE_ENV !== "production" && "ComboboxPopover must receive a `store` prop or be wrapped in a ComboboxProvider component."
     );
     const baseElement = store.useState("baseElement");
-    props = _QU2266CJcjs.useComboboxList.call(void 0, _AV6KTKLEcjs.__spreadValues.call(void 0, { store, alwaysVisible }, props));
-    props = _ISGOCBDCcjs.usePopover.call(void 0, _AV6KTKLEcjs.__spreadProps.call(void 0, _AV6KTKLEcjs.__spreadValues.call(void 0, {
+    props = _WH4I6OSNcjs.useComboboxList.call(void 0, _AV6KTKLEcjs.__spreadValues.call(void 0, { store, alwaysVisible }, props));
+    props = _RIZYIKBEcjs.usePopover.call(void 0, _AV6KTKLEcjs.__spreadProps.call(void 0, _AV6KTKLEcjs.__spreadValues.call(void 0, {
       store,
       alwaysVisible,
       autoFocusOnShow: false,
@@ -126,7 +126,7 @@ var ComboboxPopover = _XFPRAS3Jcjs.createDialogComponent.call(void 0,
     const htmlProps = useComboboxPopover(props);
     return _RNZNGEL4cjs.createElement.call(void 0, "div", htmlProps);
   }),
-  _VEG6PRAGcjs.useComboboxProviderContext
+  _3WCBE6SUcjs.useComboboxProviderContext
 );
 if (process.env.NODE_ENV !== "production") {
   ComboboxPopover.displayName = "ComboboxPopover";

package/cjs/combobox/combobox-provider.cjs

@@ -1,10 +1,10 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});"use client";
 
 
-var _AYDXWQBFcjs = require('../__chunks/AYDXWQBF.cjs');
+var _L3WS5HGIcjs = require('../__chunks/L3WS5HGI.cjs');
 
 
-var _VEG6PRAGcjs = require('../__chunks/VEG6PRAG.cjs');
+var _3WCBE6SUcjs = require('../__chunks/3WCBE6SU.cjs');
 require('../__chunks/A5RWZSX7.cjs');
 require('../__chunks/TUVU5ERH.cjs');
 require('../__chunks/UZNYSPKP.cjs');
@@ -24,8 +24,8 @@ require('../__chunks/AV6KTKLE.cjs');
 // src/combobox/combobox-provider.tsx
 var _jsxruntime = require('react/jsx-runtime');
 function ComboboxProvider(props = {}) {
-  const store = _AYDXWQBFcjs.useComboboxStore.call(void 0, props);
-  return /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _VEG6PRAGcjs.ComboboxContextProvider, { value: store, children: props.children });
+  const store = _L3WS5HGIcjs.useComboboxStore.call(void 0, props);
+  return /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _3WCBE6SUcjs.ComboboxContextProvider, { value: store, children: props.children });
 }
 
 

package/cjs/combobox/combobox-provider.d.cts

@@ -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/cjs/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/cjs/combobox/combobox-row.cjs

@@ -1,7 +1,7 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});"use client";
 
 
-var _VEG6PRAGcjs = require('../__chunks/VEG6PRAG.cjs');
+var _3WCBE6SUcjs = require('../__chunks/3WCBE6SU.cjs');
 
 
 var _GJX4AG2Lcjs = require('../__chunks/GJX4AG2L.cjs');
@@ -28,7 +28,7 @@ var _misc = require('@ariakit/core/utils/misc');
 var useComboboxRow = _RNZNGEL4cjs.createHook.call(void 0, 
   (_a) => {
     var _b = _a, { store } = _b, props = _AV6KTKLEcjs.__objRest.call(void 0, _b, ["store"]);
-    const context = _VEG6PRAGcjs.useComboboxScopedContext.call(void 0, );
+    const context = _3WCBE6SUcjs.useComboboxScopedContext.call(void 0, );
     store = store || context;
     _misc.invariant.call(void 0, 
       store,

package/cjs/combobox/combobox-separator.cjs

@@ -1,7 +1,7 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});"use client";
 
 
-var _VEG6PRAGcjs = require('../__chunks/VEG6PRAG.cjs');
+var _3WCBE6SUcjs = require('../__chunks/3WCBE6SU.cjs');
 
 
 var _F34KLJKGcjs = require('../__chunks/F34KLJKG.cjs');
@@ -28,7 +28,7 @@ var _misc = require('@ariakit/core/utils/misc');
 var useComboboxSeparator = _RNZNGEL4cjs.createHook.call(void 0, 
   (_a) => {
     var _b = _a, { store } = _b, props = _AV6KTKLEcjs.__objRest.call(void 0, _b, ["store"]);
-    const context = _VEG6PRAGcjs.useComboboxScopedContext.call(void 0, );
+    const context = _3WCBE6SUcjs.useComboboxScopedContext.call(void 0, );
     store = store || context;
     _misc.invariant.call(void 0, 
       store,

package/cjs/combobox/combobox-store.cjs

@@ -2,7 +2,7 @@
 
 
 
-var _AYDXWQBFcjs = require('../__chunks/AYDXWQBF.cjs');
+var _L3WS5HGIcjs = require('../__chunks/L3WS5HGI.cjs');
 require('../__chunks/A5RWZSX7.cjs');
 require('../__chunks/TUVU5ERH.cjs');
 require('../__chunks/65GJIQK5.cjs');
@@ -15,4 +15,4 @@ require('../__chunks/AV6KTKLE.cjs');
 
 
 
-exports.useComboboxStore = _AYDXWQBFcjs.useComboboxStore; exports.useComboboxStoreProps = _AYDXWQBFcjs.useComboboxStoreProps;
+exports.useComboboxStore = _L3WS5HGIcjs.useComboboxStore; exports.useComboboxStoreProps = _L3WS5HGIcjs.useComboboxStoreProps;

package/cjs/combobox/combobox-store.d.cts

@@ -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 {};