@ariakit/react-core 0.4.0 → 0.4.1

package/cjs/button/button.cjs

@@ -2,9 +2,9 @@
 
 
 
-var _MMDU7VRJcjs = require('../__chunks/MMDU7VRJ.cjs');
-require('../__chunks/ZMTZTMRS.cjs');
-require('../__chunks/5QD55NKL.cjs');
+var _M7WN4XJHcjs = require('../__chunks/M7WN4XJH.cjs');
+require('../__chunks/Z7QK7V4M.cjs');
+require('../__chunks/XRZ2L7EA.cjs');
 require('../__chunks/75KXQZJX.cjs');
 require('../__chunks/Q67LZMDT.cjs');
 require('../__chunks/EO6LS72H.cjs');
@@ -13,4 +13,4 @@ require('../__chunks/AV6KTKLE.cjs');
 
 
 
-exports.Button = _MMDU7VRJcjs.Button; exports.useButton = _MMDU7VRJcjs.useButton;
+exports.Button = _M7WN4XJHcjs.Button; exports.useButton = _M7WN4XJHcjs.useButton;

package/cjs/checkbox/checkbox.cjs

@@ -2,11 +2,11 @@
 
 
 
-var _OUTZPTLJcjs = require('../__chunks/OUTZPTLJ.cjs');
+var _EYTZU2B4cjs = require('../__chunks/EYTZU2B4.cjs');
 require('../__chunks/OIGGI6DI.cjs');
 require('../__chunks/ERFHNHON.cjs');
-require('../__chunks/ZMTZTMRS.cjs');
-require('../__chunks/5QD55NKL.cjs');
+require('../__chunks/Z7QK7V4M.cjs');
+require('../__chunks/XRZ2L7EA.cjs');
 require('../__chunks/75KXQZJX.cjs');
 require('../__chunks/Q67LZMDT.cjs');
 require('../__chunks/OLOZ5JT2.cjs');
@@ -16,4 +16,4 @@ require('../__chunks/AV6KTKLE.cjs');
 
 
 
-exports.Checkbox = _OUTZPTLJcjs.Checkbox; exports.useCheckbox = _OUTZPTLJcjs.useCheckbox;
+exports.Checkbox = _EYTZU2B4cjs.Checkbox; exports.useCheckbox = _EYTZU2B4cjs.useCheckbox;

package/cjs/combobox/combobox-cancel.cjs

@@ -1,17 +1,17 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});"use client";
 
 
-var _MMDU7VRJcjs = require('../__chunks/MMDU7VRJ.cjs');
+var _M7WN4XJHcjs = require('../__chunks/M7WN4XJH.cjs');
 
 
 var _OBT2YMBCcjs = require('../__chunks/OBT2YMBC.cjs');
-require('../__chunks/ZMTZTMRS.cjs');
+require('../__chunks/Z7QK7V4M.cjs');
 require('../__chunks/4XFLDG56.cjs');
 require('../__chunks/Q6CVYJBO.cjs');
 require('../__chunks/FNVFJ5AF.cjs');
 require('../__chunks/OLPMMKKO.cjs');
 require('../__chunks/XRJBC7H7.cjs');
-require('../__chunks/5QD55NKL.cjs');
+require('../__chunks/XRZ2L7EA.cjs');
 require('../__chunks/75KXQZJX.cjs');
 
 
@@ -83,7 +83,7 @@ var useComboboxCancel = _Q67LZMDTcjs.createHook.call(void 0,
     }, props), {
       onClick
     });
-    props = _MMDU7VRJcjs.useButton.call(void 0, props);
+    props = _M7WN4XJHcjs.useButton.call(void 0, props);
     return props;
   }
 );

package/cjs/combobox/combobox-disclosure.cjs

@@ -1,19 +1,19 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});"use client";
 
 
-var _K5V42RR6cjs = require('../__chunks/K5V42RR6.cjs');
-require('../__chunks/JH5Y3M4V.cjs');
-require('../__chunks/MMDU7VRJ.cjs');
+var _PIZ222UUcjs = require('../__chunks/PIZ222UU.cjs');
+require('../__chunks/QCQVRINH.cjs');
+require('../__chunks/M7WN4XJH.cjs');
 
 
 var _OBT2YMBCcjs = require('../__chunks/OBT2YMBC.cjs');
-require('../__chunks/ZMTZTMRS.cjs');
+require('../__chunks/Z7QK7V4M.cjs');
 require('../__chunks/4XFLDG56.cjs');
 require('../__chunks/Q6CVYJBO.cjs');
 require('../__chunks/FNVFJ5AF.cjs');
 require('../__chunks/OLPMMKKO.cjs');
 require('../__chunks/XRJBC7H7.cjs');
-require('../__chunks/5QD55NKL.cjs');
+require('../__chunks/XRZ2L7EA.cjs');
 require('../__chunks/75KXQZJX.cjs');
 
 
@@ -85,7 +85,7 @@ var useComboboxDisclosure = _Q67LZMDTcjs.createHook.call(void 0, function useCom
     onMouseDown,
     onClick
   });
-  props = _K5V42RR6cjs.useDialogDisclosure.call(void 0, _AV6KTKLEcjs.__spreadValues.call(void 0, { store }, props));
+  props = _PIZ222UUcjs.useDialogDisclosure.call(void 0, _AV6KTKLEcjs.__spreadValues.call(void 0, { store }, props));
   return props;
 });
 var ComboboxDisclosure = _Q67LZMDTcjs.forwardRef.call(void 0, function ComboboxDisclosure2(props) {

package/cjs/combobox/combobox-item.cjs

@@ -9,8 +9,8 @@ var _JAG4YGQZcjs = require('../__chunks/JAG4YGQZ.cjs');
 var _OBT2YMBCcjs = require('../__chunks/OBT2YMBC.cjs');
 
 
-var _QWP2WC6Ecjs = require('../__chunks/QWP2WC6E.cjs');
-require('../__chunks/ZMTZTMRS.cjs');
+var _VYKATRVCcjs = require('../__chunks/VYKATRVC.cjs');
+require('../__chunks/Z7QK7V4M.cjs');
 require('../__chunks/XWCNZ2IP.cjs');
 require('../__chunks/6ZZYUFPW.cjs');
 require('../__chunks/4XFLDG56.cjs');
@@ -18,7 +18,7 @@ require('../__chunks/Q6CVYJBO.cjs');
 require('../__chunks/FNVFJ5AF.cjs');
 require('../__chunks/OLPMMKKO.cjs');
 require('../__chunks/XRJBC7H7.cjs');
-require('../__chunks/5QD55NKL.cjs');
+require('../__chunks/XRZ2L7EA.cjs');
 require('../__chunks/75KXQZJX.cjs');
 
 
@@ -127,7 +127,6 @@ var useComboboxItem = _Q67LZMDTcjs.createHook.call(void 0,
         }
       }
       if (hideOnClickProp(event)) {
-        store == null ? void 0 : store.move(null);
         store == null ? void 0 : store.hide();
       }
     });
@@ -171,7 +170,7 @@ var useComboboxItem = _Q67LZMDTcjs.createHook.call(void 0,
       onKeyDown
     });
     const moveOnKeyPressProp = _EO6LS72Hcjs.useBooleanEvent.call(void 0, moveOnKeyPress);
-    props = _QWP2WC6Ecjs.useCompositeItem.call(void 0, _AV6KTKLEcjs.__spreadProps.call(void 0, _AV6KTKLEcjs.__spreadValues.call(void 0, {
+    props = _VYKATRVCcjs.useCompositeItem.call(void 0, _AV6KTKLEcjs.__spreadProps.call(void 0, _AV6KTKLEcjs.__spreadValues.call(void 0, {
       store
     }, props), {
       getItem,

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

@@ -90,6 +90,7 @@ export interface ComboboxItemOptions<T extends ElementType = TagName> extends Co
      * - [Combobox with links](https://ariakit.org/examples/combobox-links)
      * - [Submenu with
      *   Combobox](https://ariakit.org/examples/menu-nested-combobox)
+     * - [Command Menu](https://ariakit.org/examples/dialog-combobox-command-menu)
      */
     hideOnClick?: BooleanOrCallback<MouseEvent<HTMLElement>>;
     /**

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

@@ -90,6 +90,7 @@ export interface ComboboxItemOptions<T extends ElementType = TagName> extends Co
      * - [Combobox with links](https://ariakit.org/examples/combobox-links)
      * - [Submenu with
      *   Combobox](https://ariakit.org/examples/menu-nested-combobox)
+     * - [Command Menu](https://ariakit.org/examples/dialog-combobox-command-menu)
      */
     hideOnClick?: BooleanOrCallback<MouseEvent<HTMLElement>>;
     /**

package/cjs/combobox/combobox-list.cjs

@@ -2,11 +2,11 @@
 
 
 
-var _T32XRZLLcjs = require('../__chunks/T32XRZLL.cjs');
+var _FEBBQUM7cjs = require('../__chunks/FEBBQUM7.cjs');
 require('../__chunks/OBT2YMBC.cjs');
 require('../__chunks/4XFLDG56.cjs');
 require('../__chunks/Q6CVYJBO.cjs');
-require('../__chunks/JFOUIQSF.cjs');
+require('../__chunks/THCBJSSM.cjs');
 require('../__chunks/FNVFJ5AF.cjs');
 require('../__chunks/OLPMMKKO.cjs');
 require('../__chunks/XRJBC7H7.cjs');
@@ -18,4 +18,4 @@ require('../__chunks/AV6KTKLE.cjs');
 
 
 
-exports.ComboboxList = _T32XRZLLcjs.ComboboxList; exports.useComboboxList = _T32XRZLLcjs.useComboboxList;
+exports.ComboboxList = _FEBBQUM7cjs.ComboboxList; exports.useComboboxList = _FEBBQUM7cjs.useComboboxList;

package/cjs/combobox/combobox-popover.cjs

@@ -1,7 +1,7 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});"use client";
 
 
-var _T32XRZLLcjs = require('../__chunks/T32XRZLL.cjs');
+var _FEBBQUM7cjs = require('../__chunks/FEBBQUM7.cjs');
 
 
 var _OBT2YMBCcjs = require('../__chunks/OBT2YMBC.cjs');
@@ -9,11 +9,11 @@ require('../__chunks/4XFLDG56.cjs');
 require('../__chunks/Q6CVYJBO.cjs');
 
 
-var _ID5QP4WTcjs = require('../__chunks/ID5QP4WT.cjs');
+var _LM5EDRV3cjs = require('../__chunks/LM5EDRV3.cjs');
 
 
-var _YHNU4DBCcjs = require('../__chunks/YHNU4DBC.cjs');
-require('../__chunks/6RCPYDT6.cjs');
+var _JJH3U4MGcjs = require('../__chunks/JJH3U4MG.cjs');
+require('../__chunks/375RXJFL.cjs');
 require('../__chunks/4OFNVXGN.cjs');
 require('../__chunks/PZL34OVO.cjs');
 require('../__chunks/344F3DYO.cjs');
@@ -34,11 +34,11 @@ require('../__chunks/O2WTAUCQ.cjs');
 require('../__chunks/CVD2AZE2.cjs');
 require('../__chunks/2BIO7R5N.cjs');
 require('../__chunks/SFDUOV6F.cjs');
-require('../__chunks/JFOUIQSF.cjs');
+require('../__chunks/THCBJSSM.cjs');
 require('../__chunks/FNVFJ5AF.cjs');
 require('../__chunks/OLPMMKKO.cjs');
 require('../__chunks/XRJBC7H7.cjs');
-require('../__chunks/5QD55NKL.cjs');
+require('../__chunks/XRZ2L7EA.cjs');
 require('../__chunks/75KXQZJX.cjs');
 require('../__chunks/HQKST6ZJ.cjs');
 
@@ -94,8 +94,8 @@ var useComboboxPopover = _Q67LZMDTcjs.createHook.call(void 0,
       process.env.NODE_ENV !== "production" && "ComboboxPopover must receive a `store` prop or be wrapped in a ComboboxProvider component."
     );
     const baseElement = store.useState("baseElement");
-    props = _T32XRZLLcjs.useComboboxList.call(void 0, _AV6KTKLEcjs.__spreadValues.call(void 0, { store, alwaysVisible }, props));
-    props = _ID5QP4WTcjs.usePopover.call(void 0, _AV6KTKLEcjs.__spreadProps.call(void 0, _AV6KTKLEcjs.__spreadValues.call(void 0, {
+    props = _FEBBQUM7cjs.useComboboxList.call(void 0, _AV6KTKLEcjs.__spreadValues.call(void 0, { store, alwaysVisible }, props));
+    props = _LM5EDRV3cjs.usePopover.call(void 0, _AV6KTKLEcjs.__spreadProps.call(void 0, _AV6KTKLEcjs.__spreadValues.call(void 0, {
       store,
       modal,
       alwaysVisible,
@@ -151,7 +151,7 @@ var useComboboxPopover = _Q67LZMDTcjs.createHook.call(void 0,
     return props;
   }
 );
-var ComboboxPopover = _YHNU4DBCcjs.createDialogComponent.call(void 0, 
+var ComboboxPopover = _JJH3U4MGcjs.createDialogComponent.call(void 0, 
   _Q67LZMDTcjs.forwardRef.call(void 0, function ComboboxPopover2(props) {
     const htmlProps = useComboboxPopover(props);
     return _Q67LZMDTcjs.createElement.call(void 0, TagName, htmlProps);

package/cjs/combobox/combobox.cjs

@@ -7,14 +7,14 @@ var _O45NLQRZcjs = require('../__chunks/O45NLQRZ.cjs');
 var _OBT2YMBCcjs = require('../__chunks/OBT2YMBC.cjs');
 
 
-var _NCXCQQBNcjs = require('../__chunks/NCXCQQBN.cjs');
+var _T5YJMXLPcjs = require('../__chunks/T5YJMXLP.cjs');
 require('../__chunks/6ZZYUFPW.cjs');
 require('../__chunks/4XFLDG56.cjs');
 require('../__chunks/Q6CVYJBO.cjs');
 require('../__chunks/FNVFJ5AF.cjs');
 require('../__chunks/OLPMMKKO.cjs');
 require('../__chunks/XRJBC7H7.cjs');
-require('../__chunks/5QD55NKL.cjs');
+require('../__chunks/XRZ2L7EA.cjs');
 require('../__chunks/75KXQZJX.cjs');
 
 
@@ -87,8 +87,11 @@ var useCombobox = _Q67LZMDTcjs.createHook.call(void 0,
       showOnChange = true,
       setValueOnChange = true,
       showOnMouseDown = true,
+      showOnClick = showOnMouseDown,
+      blurActiveItemOnClick,
       setValueOnClick = true,
       showOnKeyDown = true,
+      showOnKeyPress = showOnKeyDown,
       moveOnKeyPress = true,
       autoComplete = "list"
     } = _b, props = _AV6KTKLEcjs.__objRest.call(void 0, _b, [
@@ -99,8 +102,11 @@ var useCombobox = _Q67LZMDTcjs.createHook.call(void 0,
       "showOnChange",
       "setValueOnChange",
       "showOnMouseDown",
+      "showOnClick",
+      "blurActiveItemOnClick",
       "setValueOnClick",
       "showOnKeyDown",
+      "showOnKeyPress",
       "moveOnKeyPress",
       "autoComplete"
     ]);
@@ -115,7 +121,7 @@ var useCombobox = _Q67LZMDTcjs.createHook.call(void 0,
     const canAutoSelectRef = _react.useRef.call(void 0, false);
     const composingRef = _react.useRef.call(void 0, false);
     const autoSelect = store.useState(
-      (state) => !!autoSelectProp && state.virtualFocus
+      (state) => state.virtualFocus && autoSelectProp
     );
     const inline = autoComplete === "inline" || autoComplete === "both";
     const [canInline, setCanInline] = _react.useState.call(void 0, inline);
@@ -234,16 +240,18 @@ var useCombobox = _Q67LZMDTcjs.createHook.call(void 0,
       canAutoSelectRef.current = true;
     }, [storeValue]);
     _EO6LS72Hcjs.useSafeLayoutEffect.call(void 0, () => {
-      if (open)
+      if (autoSelect !== "always" && open)
         return;
-      canAutoSelectRef.current = false;
-    }, [open]);
+      canAutoSelectRef.current = open;
+    }, [autoSelect, open]);
     const resetValueOnSelect = store.useState("resetValueOnSelect");
     _EO6LS72Hcjs.useUpdateEffect.call(void 0, () => {
       var _a2;
       const canAutoSelect = canAutoSelectRef.current;
       if (!store)
         return;
+      if (!open)
+        return;
       if ((!autoSelect || !canAutoSelect) && !resetValueOnSelect)
         return;
       const { baseElement, contentElement: contentElement2, activeId } = store.getState();
@@ -268,6 +276,7 @@ var useCombobox = _Q67LZMDTcjs.createHook.call(void 0,
       return;
     }, [
       store,
+      open,
       valueUpdated,
       storeValue,
       autoSelect,
@@ -344,8 +353,11 @@ var useCombobox = _Q67LZMDTcjs.createHook.call(void 0,
       forceValueUpdate();
     });
     const onMouseDownProp = props.onMouseDown;
+    const blurActiveItemOnClickProp = _EO6LS72Hcjs.useBooleanEvent.call(void 0, 
+      blurActiveItemOnClick != null ? blurActiveItemOnClick : () => !!(store == null ? void 0 : store.getState().includesBaseElement)
+    );
     const setValueOnClickProp = _EO6LS72Hcjs.useBooleanEvent.call(void 0, setValueOnClick);
-    const showOnMouseDownProp = _EO6LS72Hcjs.useBooleanEvent.call(void 0, showOnMouseDown);
+    const showOnClickProp = _EO6LS72Hcjs.useBooleanEvent.call(void 0, showOnClick);
     const onMouseDown = _EO6LS72Hcjs.useEvent.call(void 0, (event) => {
       onMouseDownProp == null ? void 0 : onMouseDownProp(event);
       if (event.defaultPrevented)
@@ -356,16 +368,18 @@ var useCombobox = _Q67LZMDTcjs.createHook.call(void 0,
         return;
       if (!store)
         return;
-      store.setActiveId(null);
+      if (blurActiveItemOnClickProp(event)) {
+        store.setActiveId(null);
+      }
       if (setValueOnClickProp(event)) {
         store.setValue(value);
       }
-      if (showOnMouseDownProp(event)) {
+      if (showOnClickProp(event)) {
         _events.queueBeforeEvent.call(void 0, event.currentTarget, "mouseup", store.show);
       }
     });
     const onKeyDownProp = props.onKeyDown;
-    const showOnKeyDownProp = _EO6LS72Hcjs.useBooleanEvent.call(void 0, showOnKeyDown);
+    const showOnKeyPressProp = _EO6LS72Hcjs.useBooleanEvent.call(void 0, showOnKeyPress);
     const onKeyDown = _EO6LS72Hcjs.useEvent.call(void 0, (event) => {
       onKeyDownProp == null ? void 0 : onKeyDownProp(event);
       if (!event.repeat) {
@@ -389,7 +403,7 @@ var useCombobox = _Q67LZMDTcjs.createHook.call(void 0,
       if (activeId !== null)
         return;
       if (event.key === "ArrowUp" || event.key === "ArrowDown") {
-        if (showOnKeyDownProp(event)) {
+        if (showOnKeyPressProp(event)) {
           event.preventDefault();
           store.show();
         }
@@ -422,7 +436,7 @@ var useCombobox = _Q67LZMDTcjs.createHook.call(void 0,
       onKeyDown,
       onBlur
     });
-    props = _NCXCQQBNcjs.useComposite.call(void 0, _AV6KTKLEcjs.__spreadProps.call(void 0, _AV6KTKLEcjs.__spreadValues.call(void 0, {
+    props = _T5YJMXLPcjs.useComposite.call(void 0, _AV6KTKLEcjs.__spreadProps.call(void 0, _AV6KTKLEcjs.__spreadValues.call(void 0, {
       store,
       focusable
     }, props), {

package/cjs/combobox/combobox.d.cts

@@ -49,8 +49,8 @@ export interface ComboboxOptions<T extends ElementType = TagName> extends Compos
     store?: ComboboxStore;
     /**
      * Whether the first enabled item will be automatically selected when the
-     * combobox input value changes. When it's set to `true`, the exact behavior
-     * will depend on the value of the
+     * combobox input value changes. When it's set to `true` or `"always"`, the
+     * exact behavior will depend on the value of the
      * [`autoComplete`](https://ariakit.org/reference/combobox#autocomplete) prop:
      * - If [`autoComplete`](https://ariakit.org/reference/combobox#autocomplete)
      *   is `both` or `inline`, the first item is automatically focused when the
@@ -60,13 +60,16 @@ export interface ComboboxOptions<T extends ElementType = TagName> extends Compos
      *   is `list` or `none`, the first item is automatically focused when the
      *   popup opens, but the input value doesn't change.
      *
+     * When it's set to `"always"`, the first enabled item will be automatically
+     * highlighted when the combobox list opens.
+     *
      * To change which item is auto selected, use the
      * [`getAutoSelectId`](https://ariakit.org/reference/combobox#getautoselectid)
      * prop.
      *
+     *
      * Live examples:
-     * - [Combobox with integrated
-     *   filter](https://ariakit.org/examples/combobox-filtering-integrated)
+     * - [Command Menu](https://ariakit.org/examples/dialog-combobox-command-menu)
      * - [ComboboxGroup](https://ariakit.org/examples/combobox-group)
      * - [Combobox with links](https://ariakit.org/examples/combobox-links)
      * - [Textarea with inline
@@ -75,7 +78,7 @@ export interface ComboboxOptions<T extends ElementType = TagName> extends Compos
      * - [Select with Combobox](https://ariakit.org/examples/select-combobox)
      * @default false
      */
-    autoSelect?: boolean;
+    autoSelect?: boolean | "always";
     /**
      * Function that takes the currently rendered items and returns the id of the
      * item to be auto selected when the
@@ -134,6 +137,14 @@ export interface ComboboxOptions<T extends ElementType = TagName> extends Compos
      * @default "list"
      */
     autoComplete?: StringWithValue<Required<AriaAttributes>["aria-autocomplete"]>;
+    /**
+     * Determines if the highlighted item should lose focus when the user clicks
+     * on the combobox input element. By default, this prop's value is set
+     * according to the
+     * [`includesBaseElement`](https://ariakit.org/reference/combobox-provider#includesbaseelement)
+     * value.
+     */
+    blurActiveItemOnClick?: BooleanOrCallback<MouseEvent<HTMLElement>>;
     /**
      * Whether the [`ComboboxList`](https://ariakit.org/reference/combobox-list)
      * or [`ComboboxPopover`](https://ariakit.org/reference/combobox-popover)
@@ -149,6 +160,16 @@ export interface ComboboxOptions<T extends ElementType = TagName> extends Compos
      * ```
      */
     showOnChange?: BooleanOrCallback<ChangeEvent<HTMLElement>>;
+    /**
+     * Whether the [`ComboboxList`](https://ariakit.org/reference/combobox-list)
+     * or [`ComboboxPopover`](https://ariakit.org/reference/combobox-popover)
+     * components should be shown when the input is clicked.
+     * @deprecated Use
+     * [`showOnClick`](https://ariakit.org/reference/combobox#showonclick)
+     * instead.
+     * @default true
+     */
+    showOnMouseDown?: BooleanOrCallback<MouseEvent<HTMLElement>>;
     /**
      * Whether the [`ComboboxList`](https://ariakit.org/reference/combobox-list)
      * or [`ComboboxPopover`](https://ariakit.org/reference/combobox-popover)
@@ -160,10 +181,21 @@ export interface ComboboxOptions<T extends ElementType = TagName> extends Compos
      * @default true
      * @example
      * ```jsx
-     * <Combobox showOnMouseDown={value.length > 1} />
+     * <Combobox showOnClick={value.length > 1} />
      * ```
      */
-    showOnMouseDown?: BooleanOrCallback<MouseEvent<HTMLElement>>;
+    showOnClick?: BooleanOrCallback<MouseEvent<HTMLElement>>;
+    /**
+     * Whether the [`ComboboxList`](https://ariakit.org/reference/combobox-list)
+     * or [`ComboboxPopover`](https://ariakit.org/reference/combobox-popover)
+     * components should be shown when the user presses the arrow up or down keys
+     * while focusing on the combobox input element.
+     * @deprecated Use
+     * [`showOnKeyPress`](https://ariakit.org/reference/combobox#showonkeypress)
+     * instead.
+     * @default true
+     */
+    showOnKeyDown?: BooleanOrCallback<ReactKeyboardEvent<HTMLElement>>;
     /**
      * Whether the [`ComboboxList`](https://ariakit.org/reference/combobox-list)
      * or [`ComboboxPopover`](https://ariakit.org/reference/combobox-popover)
@@ -176,10 +208,10 @@ export interface ComboboxOptions<T extends ElementType = TagName> extends Compos
      * @default true
      * @example
      * ```jsx
-     * <Combobox showOnKeyDown={value.length > 1} />
+     * <Combobox showOnKeyPress={value.length > 1} />
      * ```
      */
-    showOnKeyDown?: BooleanOrCallback<ReactKeyboardEvent<HTMLElement>>;
+    showOnKeyPress?: BooleanOrCallback<ReactKeyboardEvent<HTMLElement>>;
     /**
      * Whether the combobox
      * [`value`](https://ariakit.org/reference/combobox-provider#value) state

package/cjs/combobox/combobox.d.ts

@@ -49,8 +49,8 @@ export interface ComboboxOptions<T extends ElementType = TagName> extends Compos
     store?: ComboboxStore;
     /**
      * Whether the first enabled item will be automatically selected when the
-     * combobox input value changes. When it's set to `true`, the exact behavior
-     * will depend on the value of the
+     * combobox input value changes. When it's set to `true` or `"always"`, the
+     * exact behavior will depend on the value of the
      * [`autoComplete`](https://ariakit.org/reference/combobox#autocomplete) prop:
      * - If [`autoComplete`](https://ariakit.org/reference/combobox#autocomplete)
      *   is `both` or `inline`, the first item is automatically focused when the
@@ -60,13 +60,16 @@ export interface ComboboxOptions<T extends ElementType = TagName> extends Compos
      *   is `list` or `none`, the first item is automatically focused when the
      *   popup opens, but the input value doesn't change.
      *
+     * When it's set to `"always"`, the first enabled item will be automatically
+     * highlighted when the combobox list opens.
+     *
      * To change which item is auto selected, use the
      * [`getAutoSelectId`](https://ariakit.org/reference/combobox#getautoselectid)
      * prop.
      *
+     *
      * Live examples:
-     * - [Combobox with integrated
-     *   filter](https://ariakit.org/examples/combobox-filtering-integrated)
+     * - [Command Menu](https://ariakit.org/examples/dialog-combobox-command-menu)
      * - [ComboboxGroup](https://ariakit.org/examples/combobox-group)
      * - [Combobox with links](https://ariakit.org/examples/combobox-links)
      * - [Textarea with inline
@@ -75,7 +78,7 @@ export interface ComboboxOptions<T extends ElementType = TagName> extends Compos
      * - [Select with Combobox](https://ariakit.org/examples/select-combobox)
      * @default false
      */
-    autoSelect?: boolean;
+    autoSelect?: boolean | "always";
     /**
      * Function that takes the currently rendered items and returns the id of the
      * item to be auto selected when the
@@ -134,6 +137,14 @@ export interface ComboboxOptions<T extends ElementType = TagName> extends Compos
      * @default "list"
      */
     autoComplete?: StringWithValue<Required<AriaAttributes>["aria-autocomplete"]>;
+    /**
+     * Determines if the highlighted item should lose focus when the user clicks
+     * on the combobox input element. By default, this prop's value is set
+     * according to the
+     * [`includesBaseElement`](https://ariakit.org/reference/combobox-provider#includesbaseelement)
+     * value.
+     */
+    blurActiveItemOnClick?: BooleanOrCallback<MouseEvent<HTMLElement>>;
     /**
      * Whether the [`ComboboxList`](https://ariakit.org/reference/combobox-list)
      * or [`ComboboxPopover`](https://ariakit.org/reference/combobox-popover)
@@ -149,6 +160,16 @@ export interface ComboboxOptions<T extends ElementType = TagName> extends Compos
      * ```
      */
     showOnChange?: BooleanOrCallback<ChangeEvent<HTMLElement>>;
+    /**
+     * Whether the [`ComboboxList`](https://ariakit.org/reference/combobox-list)
+     * or [`ComboboxPopover`](https://ariakit.org/reference/combobox-popover)
+     * components should be shown when the input is clicked.
+     * @deprecated Use
+     * [`showOnClick`](https://ariakit.org/reference/combobox#showonclick)
+     * instead.
+     * @default true
+     */
+    showOnMouseDown?: BooleanOrCallback<MouseEvent<HTMLElement>>;
     /**
      * Whether the [`ComboboxList`](https://ariakit.org/reference/combobox-list)
      * or [`ComboboxPopover`](https://ariakit.org/reference/combobox-popover)
@@ -160,10 +181,21 @@ export interface ComboboxOptions<T extends ElementType = TagName> extends Compos
      * @default true
      * @example
      * ```jsx
-     * <Combobox showOnMouseDown={value.length > 1} />
+     * <Combobox showOnClick={value.length > 1} />
      * ```
      */
-    showOnMouseDown?: BooleanOrCallback<MouseEvent<HTMLElement>>;
+    showOnClick?: BooleanOrCallback<MouseEvent<HTMLElement>>;
+    /**
+     * Whether the [`ComboboxList`](https://ariakit.org/reference/combobox-list)
+     * or [`ComboboxPopover`](https://ariakit.org/reference/combobox-popover)
+     * components should be shown when the user presses the arrow up or down keys
+     * while focusing on the combobox input element.
+     * @deprecated Use
+     * [`showOnKeyPress`](https://ariakit.org/reference/combobox#showonkeypress)
+     * instead.
+     * @default true
+     */
+    showOnKeyDown?: BooleanOrCallback<ReactKeyboardEvent<HTMLElement>>;
     /**
      * Whether the [`ComboboxList`](https://ariakit.org/reference/combobox-list)
      * or [`ComboboxPopover`](https://ariakit.org/reference/combobox-popover)
@@ -176,10 +208,10 @@ export interface ComboboxOptions<T extends ElementType = TagName> extends Compos
      * @default true
      * @example
      * ```jsx
-     * <Combobox showOnKeyDown={value.length > 1} />
+     * <Combobox showOnKeyPress={value.length > 1} />
      * ```
      */
-    showOnKeyDown?: BooleanOrCallback<ReactKeyboardEvent<HTMLElement>>;
+    showOnKeyPress?: BooleanOrCallback<ReactKeyboardEvent<HTMLElement>>;
     /**
      * Whether the combobox
      * [`value`](https://ariakit.org/reference/combobox-provider#value) state

package/cjs/command/command.cjs

@@ -2,8 +2,8 @@
 
 
 
-var _ZMTZTMRScjs = require('../__chunks/ZMTZTMRS.cjs');
-require('../__chunks/5QD55NKL.cjs');
+var _Z7QK7V4Mcjs = require('../__chunks/Z7QK7V4M.cjs');
+require('../__chunks/XRZ2L7EA.cjs');
 require('../__chunks/75KXQZJX.cjs');
 require('../__chunks/Q67LZMDT.cjs');
 require('../__chunks/EO6LS72H.cjs');
@@ -12,4 +12,4 @@ require('../__chunks/AV6KTKLE.cjs');
 
 
 
-exports.Command = _ZMTZTMRScjs.Command; exports.useCommand = _ZMTZTMRScjs.useCommand;
+exports.Command = _Z7QK7V4Mcjs.Command; exports.useCommand = _Z7QK7V4Mcjs.useCommand;

package/cjs/composite/composite-hover.d.cts

@@ -88,6 +88,7 @@ export interface CompositeHoverOptions<_T extends ElementType = TagName> extends
      * - [Submenu with
      *   Combobox](https://ariakit.org/examples/menu-nested-combobox)
      * - [Combobox with tabs](https://ariakit.org/examples/combobox-tabs)
+     * - [Command Menu](https://ariakit.org/examples/dialog-combobox-command-menu)
      */
     blurOnHoverEnd?: BooleanOrCallback<ReactMouseEvent<HTMLElement>>;
 }

package/cjs/composite/composite-hover.d.ts

@@ -88,6 +88,7 @@ export interface CompositeHoverOptions<_T extends ElementType = TagName> extends
      * - [Submenu with
      *   Combobox](https://ariakit.org/examples/menu-nested-combobox)
      * - [Combobox with tabs](https://ariakit.org/examples/combobox-tabs)
+     * - [Command Menu](https://ariakit.org/examples/dialog-combobox-command-menu)
      */
     blurOnHoverEnd?: BooleanOrCallback<ReactMouseEvent<HTMLElement>>;
 }

package/cjs/composite/composite-item.cjs

@@ -2,13 +2,13 @@
 
 
 
-var _QWP2WC6Ecjs = require('../__chunks/QWP2WC6E.cjs');
-require('../__chunks/ZMTZTMRS.cjs');
+var _VYKATRVCcjs = require('../__chunks/VYKATRVC.cjs');
+require('../__chunks/Z7QK7V4M.cjs');
 require('../__chunks/XWCNZ2IP.cjs');
 require('../__chunks/6ZZYUFPW.cjs');
 require('../__chunks/4XFLDG56.cjs');
 require('../__chunks/Q6CVYJBO.cjs');
-require('../__chunks/5QD55NKL.cjs');
+require('../__chunks/XRZ2L7EA.cjs');
 require('../__chunks/75KXQZJX.cjs');
 require('../__chunks/Q67LZMDT.cjs');
 require('../__chunks/OLOZ5JT2.cjs');
@@ -18,4 +18,4 @@ require('../__chunks/AV6KTKLE.cjs');
 
 
 
-exports.CompositeItem = _QWP2WC6Ecjs.CompositeItem; exports.useCompositeItem = _QWP2WC6Ecjs.useCompositeItem;
+exports.CompositeItem = _VYKATRVCcjs.CompositeItem; exports.useCompositeItem = _VYKATRVCcjs.useCompositeItem;