@ariakit/react-core 0.4.1 → 0.4.3

package/cjs/combobox/combobox-row.cjs

@@ -1,21 +1,21 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});"use client";
 
 
-var _OBT2YMBCcjs = require('../__chunks/OBT2YMBC.cjs');
+var _GZY6WVTScjs = require('../__chunks/GZY6WVTS.cjs');
 
 
-var _RYQJ4G5Hcjs = require('../__chunks/RYQJ4G5H.cjs');
-require('../__chunks/4XFLDG56.cjs');
-require('../__chunks/Q6CVYJBO.cjs');
-require('../__chunks/FNVFJ5AF.cjs');
-require('../__chunks/OLPMMKKO.cjs');
-require('../__chunks/XRJBC7H7.cjs');
+var _2IJSEADJcjs = require('../__chunks/2IJSEADJ.cjs');
+require('../__chunks/VPI3EKVY.cjs');
+require('../__chunks/NEK2UEJN.cjs');
+require('../__chunks/77BAEZ2Z.cjs');
+require('../__chunks/GDEDCFNU.cjs');
+require('../__chunks/NTNMOEWE.cjs');
 
 
 
 
-var _Q67LZMDTcjs = require('../__chunks/Q67LZMDT.cjs');
-require('../__chunks/EO6LS72H.cjs');
+var _NGD3IQDBcjs = require('../__chunks/NGD3IQDB.cjs');
+require('../__chunks/TW3SFX4C.cjs');
 require('../__chunks/CJDHQUBR.cjs');
 
 
@@ -26,10 +26,10 @@ var _AV6KTKLEcjs = require('../__chunks/AV6KTKLE.cjs');
 var _dom = require('@ariakit/core/utils/dom');
 var _misc = require('@ariakit/core/utils/misc');
 var TagName = "div";
-var useComboboxRow = _Q67LZMDTcjs.createHook.call(void 0, 
+var useComboboxRow = _NGD3IQDBcjs.createHook.call(void 0, 
   function useComboboxRow2(_a) {
     var _b = _a, { store } = _b, props = _AV6KTKLEcjs.__objRest.call(void 0, _b, ["store"]);
-    const context = _OBT2YMBCcjs.useComboboxScopedContext.call(void 0, );
+    const context = _2IJSEADJcjs.useComboboxScopedContext.call(void 0, );
     store = store || context;
     _misc.invariant.call(void 0, 
       store,
@@ -39,13 +39,13 @@ var useComboboxRow = _Q67LZMDTcjs.createHook.call(void 0,
     const popupRole = _dom.getPopupRole.call(void 0, contentElement);
     const role = popupRole === "grid" ? "row" : "presentation";
     props = _AV6KTKLEcjs.__spreadValues.call(void 0, { role }, props);
-    props = _RYQJ4G5Hcjs.useCompositeRow.call(void 0, _AV6KTKLEcjs.__spreadValues.call(void 0, { store }, props));
+    props = _GZY6WVTScjs.useCompositeRow.call(void 0, _AV6KTKLEcjs.__spreadValues.call(void 0, { store }, props));
     return props;
   }
 );
-var ComboboxRow = _Q67LZMDTcjs.forwardRef.call(void 0, function ComboboxRow2(props) {
+var ComboboxRow = _NGD3IQDBcjs.forwardRef.call(void 0, function ComboboxRow2(props) {
   const htmlProps = useComboboxRow(props);
-  return _Q67LZMDTcjs.createElement.call(void 0, TagName, htmlProps);
+  return _NGD3IQDBcjs.createElement.call(void 0, TagName, htmlProps);
 });
 
 

package/cjs/combobox/combobox-separator.cjs

@@ -1,22 +1,22 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});"use client";
 
 
-var _OBT2YMBCcjs = require('../__chunks/OBT2YMBC.cjs');
+var _2IJSEADJcjs = require('../__chunks/2IJSEADJ.cjs');
 
 
-var _AIKNQVVLcjs = require('../__chunks/AIKNQVVL.cjs');
-require('../__chunks/FG4Y7VYM.cjs');
-require('../__chunks/4XFLDG56.cjs');
-require('../__chunks/Q6CVYJBO.cjs');
-require('../__chunks/FNVFJ5AF.cjs');
-require('../__chunks/OLPMMKKO.cjs');
-require('../__chunks/XRJBC7H7.cjs');
+var _RGSJYRTCcjs = require('../__chunks/RGSJYRTC.cjs');
+require('../__chunks/IDFJXUSF.cjs');
+require('../__chunks/VPI3EKVY.cjs');
+require('../__chunks/NEK2UEJN.cjs');
+require('../__chunks/77BAEZ2Z.cjs');
+require('../__chunks/GDEDCFNU.cjs');
+require('../__chunks/NTNMOEWE.cjs');
 
 
 
 
-var _Q67LZMDTcjs = require('../__chunks/Q67LZMDT.cjs');
-require('../__chunks/EO6LS72H.cjs');
+var _NGD3IQDBcjs = require('../__chunks/NGD3IQDB.cjs');
+require('../__chunks/TW3SFX4C.cjs');
 require('../__chunks/CJDHQUBR.cjs');
 
 
@@ -26,20 +26,20 @@ var _AV6KTKLEcjs = require('../__chunks/AV6KTKLE.cjs');
 // src/combobox/combobox-separator.ts
 var _misc = require('@ariakit/core/utils/misc');
 var TagName = "hr";
-var useComboboxSeparator = _Q67LZMDTcjs.createHook.call(void 0, function useComboboxSeparator2(_a) {
+var useComboboxSeparator = _NGD3IQDBcjs.createHook.call(void 0, function useComboboxSeparator2(_a) {
   var _b = _a, { store } = _b, props = _AV6KTKLEcjs.__objRest.call(void 0, _b, ["store"]);
-  const context = _OBT2YMBCcjs.useComboboxScopedContext.call(void 0, );
+  const context = _2IJSEADJcjs.useComboboxScopedContext.call(void 0, );
   store = store || context;
   _misc.invariant.call(void 0, 
     store,
     process.env.NODE_ENV !== "production" && "ComboboxSeparator must be wrapped in a ComboboxList or ComboboxPopover component."
   );
-  props = _AIKNQVVLcjs.useCompositeSeparator.call(void 0, _AV6KTKLEcjs.__spreadValues.call(void 0, { store }, props));
+  props = _RGSJYRTCcjs.useCompositeSeparator.call(void 0, _AV6KTKLEcjs.__spreadValues.call(void 0, { store }, props));
   return props;
 });
-var ComboboxSeparator = _Q67LZMDTcjs.forwardRef.call(void 0, function ComboboxSeparator2(props) {
+var ComboboxSeparator = _NGD3IQDBcjs.forwardRef.call(void 0, function ComboboxSeparator2(props) {
   const htmlProps = useComboboxSeparator(props);
-  return _Q67LZMDTcjs.createElement.call(void 0, TagName, htmlProps);
+  return _NGD3IQDBcjs.createElement.call(void 0, TagName, htmlProps);
 });
 
 

package/cjs/combobox/combobox-store.cjs

@@ -2,17 +2,17 @@
 
 
 
-var _OUHSDH5Bcjs = require('../__chunks/OUHSDH5B.cjs');
-require('../__chunks/LUL2YWZ3.cjs');
-require('../__chunks/CDNJPIEG.cjs');
-require('../__chunks/GOS3JJKQ.cjs');
-require('../__chunks/AD7LA3CE.cjs');
-require('../__chunks/QJZAESAR.cjs');
-require('../__chunks/OLOZ5JT2.cjs');
-require('../__chunks/EO6LS72H.cjs');
+var _NDVZ37O3cjs = require('../__chunks/NDVZ37O3.cjs');
+require('../__chunks/4H5ZMMOI.cjs');
+require('../__chunks/Q7DU7FP7.cjs');
+require('../__chunks/6RJSKW2C.cjs');
+require('../__chunks/V3ZO7ICA.cjs');
+require('../__chunks/N6YOHUBI.cjs');
+require('../__chunks/GXMZA6DT.cjs');
+require('../__chunks/TW3SFX4C.cjs');
 require('../__chunks/CJDHQUBR.cjs');
 require('../__chunks/AV6KTKLE.cjs');
 
 
 
-exports.useComboboxStore = _OUHSDH5Bcjs.useComboboxStore; exports.useComboboxStoreProps = _OUHSDH5Bcjs.useComboboxStoreProps;
+exports.useComboboxStore = _NDVZ37O3cjs.useComboboxStore; exports.useComboboxStoreProps = _NDVZ37O3cjs.useComboboxStoreProps;

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

@@ -51,9 +51,10 @@ export interface ComboboxStoreOptions<T extends ComboboxStoreSelectedValue = Com
      */
     setValue?: (value: ComboboxStoreState<T>["value"]) => void;
     /**
-     * A callback that gets called when the
+     * A callback that's invoked when the
      * [`selectedValue`](https://ariakit.org/reference/combobox-provider#selectedvalue)
-     * state changes.
+     * state changes, typically when the user selects an item. This can be used to
+     * implement behavior like `onSelect` or `onItemSelect`.
      *
      * Live examples:
      * - [Multi-selectable

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

@@ -51,9 +51,10 @@ export interface ComboboxStoreOptions<T extends ComboboxStoreSelectedValue = Com
      */
     setValue?: (value: ComboboxStoreState<T>["value"]) => void;
     /**
-     * A callback that gets called when the
+     * A callback that's invoked when the
      * [`selectedValue`](https://ariakit.org/reference/combobox-provider#selectedvalue)
-     * state changes.
+     * state changes, typically when the user selects an item. This can be used to
+     * implement behavior like `onSelect` or `onItemSelect`.
      *
      * Live examples:
      * - [Multi-selectable

package/cjs/combobox/combobox.cjs

@@ -1,26 +1,26 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});"use client";
 
 
-var _O45NLQRZcjs = require('../__chunks/O45NLQRZ.cjs');
+var _YH42XRHRcjs = require('../__chunks/YH42XRHR.cjs');
 
 
-var _OBT2YMBCcjs = require('../__chunks/OBT2YMBC.cjs');
+var _2IJSEADJcjs = require('../__chunks/2IJSEADJ.cjs');
 
 
-var _T5YJMXLPcjs = require('../__chunks/T5YJMXLP.cjs');
+var _EKW5CERCcjs = require('../__chunks/EKW5CERC.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/XRZ2L7EA.cjs');
+require('../__chunks/VPI3EKVY.cjs');
+require('../__chunks/NEK2UEJN.cjs');
+require('../__chunks/77BAEZ2Z.cjs');
+require('../__chunks/GDEDCFNU.cjs');
+require('../__chunks/NTNMOEWE.cjs');
+require('../__chunks/FHRIPOYF.cjs');
 require('../__chunks/75KXQZJX.cjs');
 
 
 
 
-var _Q67LZMDTcjs = require('../__chunks/Q67LZMDT.cjs');
+var _NGD3IQDBcjs = require('../__chunks/NGD3IQDB.cjs');
 
 
 
@@ -30,7 +30,7 @@ var _Q67LZMDTcjs = require('../__chunks/Q67LZMDT.cjs');
 
 
 
-var _EO6LS72Hcjs = require('../__chunks/EO6LS72H.cjs');
+var _TW3SFX4Ccjs = require('../__chunks/TW3SFX4C.cjs');
 require('../__chunks/CJDHQUBR.cjs');
 
 
@@ -77,7 +77,16 @@ function isInputEvent(event) {
 function isAriaAutoCompleteValue(value) {
   return value === "inline" || value === "list" || value === "both" || value === "none";
 }
-var useCombobox = _Q67LZMDTcjs.createHook.call(void 0, 
+function getDefaultAutoSelectId(items) {
+  const item = items.find((item2) => {
+    var _a;
+    if (item2.disabled)
+      return false;
+    return ((_a = item2.element) == null ? void 0 : _a.getAttribute("role")) !== "tab";
+  });
+  return item == null ? void 0 : item.id;
+}
+var useCombobox = _NGD3IQDBcjs.createHook.call(void 0, 
   function useCombobox2(_a) {
     var _b = _a, {
       store,
@@ -110,14 +119,14 @@ var useCombobox = _Q67LZMDTcjs.createHook.call(void 0,
       "moveOnKeyPress",
       "autoComplete"
     ]);
-    const context = _OBT2YMBCcjs.useComboboxProviderContext.call(void 0, );
+    const context = _2IJSEADJcjs.useComboboxProviderContext.call(void 0, );
     store = store || context;
     _misc.invariant.call(void 0, 
       store,
       process.env.NODE_ENV !== "production" && "Combobox must receive a `store` prop or be wrapped in a ComboboxProvider component."
     );
     const ref = _react.useRef.call(void 0, null);
-    const [valueUpdated, forceValueUpdate] = _EO6LS72Hcjs.useForceUpdate.call(void 0, );
+    const [valueUpdated, forceValueUpdate] = _TW3SFX4Ccjs.useForceUpdate.call(void 0, );
     const canAutoSelectRef = _react.useRef.call(void 0, false);
     const composingRef = _react.useRef.call(void 0, false);
     const autoSelect = store.useState(
@@ -125,7 +134,7 @@ var useCombobox = _Q67LZMDTcjs.createHook.call(void 0,
     );
     const inline = autoComplete === "inline" || autoComplete === "both";
     const [canInline, setCanInline] = _react.useState.call(void 0, inline);
-    _EO6LS72Hcjs.useUpdateLayoutEffect.call(void 0, () => {
+    _TW3SFX4Ccjs.useUpdateLayoutEffect.call(void 0, () => {
       if (!inline)
         return;
       setCanInline(true);
@@ -198,7 +207,7 @@ var useCombobox = _Q67LZMDTcjs.createHook.call(void 0,
       storeValue
     ]);
     const scrollingElementRef = _react.useRef.call(void 0, null);
-    const getAutoSelectIdProp = _EO6LS72Hcjs.useEvent.call(void 0, getAutoSelectId);
+    const getAutoSelectIdProp = _TW3SFX4Ccjs.useEvent.call(void 0, getAutoSelectId);
     const autoSelectIdRef = _react.useRef.call(void 0, null);
     _react.useEffect.call(void 0, () => {
       if (!open)
@@ -232,21 +241,21 @@ var useCombobox = _Q67LZMDTcjs.createHook.call(void 0,
         scrollingElement.removeEventListener("scroll", onScroll, true);
       };
     }, [open, contentElement, store]);
-    _EO6LS72Hcjs.useSafeLayoutEffect.call(void 0, () => {
+    _TW3SFX4Ccjs.useSafeLayoutEffect.call(void 0, () => {
       if (!storeValue)
         return;
       if (composingRef.current)
         return;
       canAutoSelectRef.current = true;
     }, [storeValue]);
-    _EO6LS72Hcjs.useSafeLayoutEffect.call(void 0, () => {
+    _TW3SFX4Ccjs.useSafeLayoutEffect.call(void 0, () => {
       if (autoSelect !== "always" && open)
         return;
       canAutoSelectRef.current = open;
     }, [autoSelect, open]);
     const resetValueOnSelect = store.useState("resetValueOnSelect");
-    _EO6LS72Hcjs.useUpdateEffect.call(void 0, () => {
-      var _a2;
+    _TW3SFX4Ccjs.useUpdateEffect.call(void 0, () => {
+      var _a2, _b2;
       const canAutoSelect = canAutoSelectRef.current;
       if (!store)
         return;
@@ -264,11 +273,11 @@ var useCombobox = _Q67LZMDTcjs.createHook.call(void 0,
       }
       if (autoSelect && canAutoSelect) {
         const userAutoSelectId = getAutoSelectIdProp(items);
-        const autoSelectId = userAutoSelectId !== void 0 ? userAutoSelectId : store.first();
+        const autoSelectId = userAutoSelectId !== void 0 ? userAutoSelectId : (_a2 = getDefaultAutoSelectId(items)) != null ? _a2 : store.first();
         autoSelectIdRef.current = autoSelectId;
         store.move(autoSelectId != null ? autoSelectId : null);
       } else {
-        const element = (_a2 = store.item(activeId)) == null ? void 0 : _a2.element;
+        const element = (_b2 = store.item(activeId)) == null ? void 0 : _b2.element;
         if (element && "scrollIntoView" in element) {
           element.scrollIntoView({ block: "nearest", inline: "nearest" });
         }
@@ -304,9 +313,9 @@ var useCombobox = _Q67LZMDTcjs.createHook.call(void 0,
       };
     }, [inline, contentElement, store, value]);
     const onChangeProp = props.onChange;
-    const showOnChangeProp = _EO6LS72Hcjs.useBooleanEvent.call(void 0, showOnChange);
-    const setValueOnChangeProp = _EO6LS72Hcjs.useBooleanEvent.call(void 0, setValueOnChange);
-    const onChange = _EO6LS72Hcjs.useEvent.call(void 0, (event) => {
+    const showOnChangeProp = _TW3SFX4Ccjs.useBooleanEvent.call(void 0, showOnChange);
+    const setValueOnChangeProp = _TW3SFX4Ccjs.useBooleanEvent.call(void 0, setValueOnChange);
+    const onChange = _TW3SFX4Ccjs.useEvent.call(void 0, (event) => {
       onChangeProp == null ? void 0 : onChangeProp(event);
       if (event.defaultPrevented)
         return;
@@ -342,7 +351,7 @@ var useCombobox = _Q67LZMDTcjs.createHook.call(void 0,
       }
     });
     const onCompositionEndProp = props.onCompositionEnd;
-    const onCompositionEnd = _EO6LS72Hcjs.useEvent.call(void 0, (event) => {
+    const onCompositionEnd = _TW3SFX4Ccjs.useEvent.call(void 0, (event) => {
       canAutoSelectRef.current = true;
       composingRef.current = false;
       onCompositionEndProp == null ? void 0 : onCompositionEndProp(event);
@@ -353,12 +362,12 @@ var useCombobox = _Q67LZMDTcjs.createHook.call(void 0,
       forceValueUpdate();
     });
     const onMouseDownProp = props.onMouseDown;
-    const blurActiveItemOnClickProp = _EO6LS72Hcjs.useBooleanEvent.call(void 0, 
+    const blurActiveItemOnClickProp = _TW3SFX4Ccjs.useBooleanEvent.call(void 0, 
       blurActiveItemOnClick != null ? blurActiveItemOnClick : () => !!(store == null ? void 0 : store.getState().includesBaseElement)
     );
-    const setValueOnClickProp = _EO6LS72Hcjs.useBooleanEvent.call(void 0, setValueOnClick);
-    const showOnClickProp = _EO6LS72Hcjs.useBooleanEvent.call(void 0, showOnClick);
-    const onMouseDown = _EO6LS72Hcjs.useEvent.call(void 0, (event) => {
+    const setValueOnClickProp = _TW3SFX4Ccjs.useBooleanEvent.call(void 0, setValueOnClick);
+    const showOnClickProp = _TW3SFX4Ccjs.useBooleanEvent.call(void 0, showOnClick);
+    const onMouseDown = _TW3SFX4Ccjs.useEvent.call(void 0, (event) => {
       onMouseDownProp == null ? void 0 : onMouseDownProp(event);
       if (event.defaultPrevented)
         return;
@@ -379,8 +388,8 @@ var useCombobox = _Q67LZMDTcjs.createHook.call(void 0,
       }
     });
     const onKeyDownProp = props.onKeyDown;
-    const showOnKeyPressProp = _EO6LS72Hcjs.useBooleanEvent.call(void 0, showOnKeyPress);
-    const onKeyDown = _EO6LS72Hcjs.useEvent.call(void 0, (event) => {
+    const showOnKeyPressProp = _TW3SFX4Ccjs.useBooleanEvent.call(void 0, showOnKeyPress);
+    const onKeyDown = _TW3SFX4Ccjs.useEvent.call(void 0, (event) => {
       onKeyDownProp == null ? void 0 : onKeyDownProp(event);
       if (!event.repeat) {
         canAutoSelectRef.current = false;
@@ -410,13 +419,13 @@ var useCombobox = _Q67LZMDTcjs.createHook.call(void 0,
       }
     });
     const onBlurProp = props.onBlur;
-    const onBlur = _EO6LS72Hcjs.useEvent.call(void 0, (event) => {
+    const onBlur = _TW3SFX4Ccjs.useEvent.call(void 0, (event) => {
       canAutoSelectRef.current = false;
       onBlurProp == null ? void 0 : onBlurProp(event);
       if (event.defaultPrevented)
         return;
     });
-    const id = _EO6LS72Hcjs.useId.call(void 0, props.id);
+    const id = _TW3SFX4Ccjs.useId.call(void 0, props.id);
     const ariaAutoComplete = isAriaAutoCompleteValue(autoComplete) ? autoComplete : void 0;
     const isActiveItem = store.useState((state) => state.activeId === null);
     props = _AV6KTKLEcjs.__spreadProps.call(void 0, _AV6KTKLEcjs.__spreadValues.call(void 0, {
@@ -429,14 +438,14 @@ var useCombobox = _Q67LZMDTcjs.createHook.call(void 0,
       "data-active-item": isActiveItem || void 0,
       value
     }, props), {
-      ref: _EO6LS72Hcjs.useMergeRefs.call(void 0, ref, props.ref),
+      ref: _TW3SFX4Ccjs.useMergeRefs.call(void 0, ref, props.ref),
       onChange,
       onCompositionEnd,
       onMouseDown,
       onKeyDown,
       onBlur
     });
-    props = _T5YJMXLPcjs.useComposite.call(void 0, _AV6KTKLEcjs.__spreadProps.call(void 0, _AV6KTKLEcjs.__spreadValues.call(void 0, {
+    props = _EKW5CERCcjs.useComposite.call(void 0, _AV6KTKLEcjs.__spreadProps.call(void 0, _AV6KTKLEcjs.__spreadValues.call(void 0, {
       store,
       focusable
     }, props), {
@@ -450,13 +459,13 @@ var useCombobox = _Q67LZMDTcjs.createHook.call(void 0,
         return true;
       }
     }));
-    props = _O45NLQRZcjs.usePopoverAnchor.call(void 0, _AV6KTKLEcjs.__spreadValues.call(void 0, { store }, props));
+    props = _YH42XRHRcjs.usePopoverAnchor.call(void 0, _AV6KTKLEcjs.__spreadValues.call(void 0, { store }, props));
     return _AV6KTKLEcjs.__spreadValues.call(void 0, { autoComplete: "off" }, props);
   }
 );
-var Combobox = _Q67LZMDTcjs.forwardRef.call(void 0, function Combobox2(props) {
+var Combobox = _NGD3IQDBcjs.forwardRef.call(void 0, function Combobox2(props) {
   const htmlProps = useCombobox(props);
-  return _Q67LZMDTcjs.createElement.call(void 0, TagName, htmlProps);
+  return _NGD3IQDBcjs.createElement.call(void 0, TagName, htmlProps);
 });
 
 

package/cjs/combobox/combobox.d.cts

@@ -48,26 +48,27 @@ 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` or `"always"`, the
-     * exact behavior will depend on the value of the
+     * Determines if the first enabled item will be automatically focused when the
+     * combobox input value changes. If set to `true` or `"always"`, the exact
+     * behavior hinges 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
-     *   popup opens, and the input value changes to reflect this. The inline
-     *   completion string will be highlighted and will have a selected state.
+     *   is `both` or `inline`, the first enabled item is automatically focused as
+     *   the user types in the input. The value gets appended with the completion
+     *   string if it matches. The inline completion string will be highlighted
+     *   and selected.
      * - If [`autoComplete`](https://ariakit.org/reference/combobox#autocomplete)
-     *   is `list` or `none`, the first item is automatically focused when the
-     *   popup opens, but the input value doesn't change.
+     *   is `list` or `none`, the first enabled item is automatically focused as
+     *   the user types in the input, but the input value is not appended with the
+     *   item value.
      *
-     * When it's set to `"always"`, the first enabled item will be automatically
-     * highlighted when the combobox list opens.
+     * If set to `"always"`, the first enabled item is auto-highlighted when the
+     * combobox list opens, not just when the input value changes.
      *
-     * To change which item is auto selected, use the
+     * To change which item gets auto-selected, use the
      * [`getAutoSelectId`](https://ariakit.org/reference/combobox#getautoselectid)
      * prop.
      *
-     *
      * Live examples:
      * - [Command Menu](https://ariakit.org/examples/dialog-combobox-command-menu)
      * - [ComboboxGroup](https://ariakit.org/examples/combobox-group)
@@ -87,9 +88,6 @@ export interface ComboboxOptions<T extends ElementType = TagName> extends Compos
      *
      * By default, the first enabled item is auto selected. This function is handy
      * if you prefer a different item to be auto selected.
-     *
-     * Live examples:
-     * - [Combobox with tabs](https://ariakit.org/examples/combobox-tabs)
      * @example
      * ```jsx
      * <Combobox

package/cjs/combobox/combobox.d.ts

@@ -48,26 +48,27 @@ 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` or `"always"`, the
-     * exact behavior will depend on the value of the
+     * Determines if the first enabled item will be automatically focused when the
+     * combobox input value changes. If set to `true` or `"always"`, the exact
+     * behavior hinges 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
-     *   popup opens, and the input value changes to reflect this. The inline
-     *   completion string will be highlighted and will have a selected state.
+     *   is `both` or `inline`, the first enabled item is automatically focused as
+     *   the user types in the input. The value gets appended with the completion
+     *   string if it matches. The inline completion string will be highlighted
+     *   and selected.
      * - If [`autoComplete`](https://ariakit.org/reference/combobox#autocomplete)
-     *   is `list` or `none`, the first item is automatically focused when the
-     *   popup opens, but the input value doesn't change.
+     *   is `list` or `none`, the first enabled item is automatically focused as
+     *   the user types in the input, but the input value is not appended with the
+     *   item value.
      *
-     * When it's set to `"always"`, the first enabled item will be automatically
-     * highlighted when the combobox list opens.
+     * If set to `"always"`, the first enabled item is auto-highlighted when the
+     * combobox list opens, not just when the input value changes.
      *
-     * To change which item is auto selected, use the
+     * To change which item gets auto-selected, use the
      * [`getAutoSelectId`](https://ariakit.org/reference/combobox#getautoselectid)
      * prop.
      *
-     *
      * Live examples:
      * - [Command Menu](https://ariakit.org/examples/dialog-combobox-command-menu)
      * - [ComboboxGroup](https://ariakit.org/examples/combobox-group)
@@ -87,9 +88,6 @@ export interface ComboboxOptions<T extends ElementType = TagName> extends Compos
      *
      * By default, the first enabled item is auto selected. This function is handy
      * if you prefer a different item to be auto selected.
-     *
-     * Live examples:
-     * - [Combobox with tabs](https://ariakit.org/examples/combobox-tabs)
      * @example
      * ```jsx
      * <Combobox

package/cjs/command/command.cjs

@@ -2,14 +2,14 @@
 
 
 
-var _Z7QK7V4Mcjs = require('../__chunks/Z7QK7V4M.cjs');
-require('../__chunks/XRZ2L7EA.cjs');
+var _U4NXCMZ3cjs = require('../__chunks/U4NXCMZ3.cjs');
+require('../__chunks/FHRIPOYF.cjs');
 require('../__chunks/75KXQZJX.cjs');
-require('../__chunks/Q67LZMDT.cjs');
-require('../__chunks/EO6LS72H.cjs');
+require('../__chunks/NGD3IQDB.cjs');
+require('../__chunks/TW3SFX4C.cjs');
 require('../__chunks/CJDHQUBR.cjs');
 require('../__chunks/AV6KTKLE.cjs');
 
 
 
-exports.Command = _Z7QK7V4Mcjs.Command; exports.useCommand = _Z7QK7V4Mcjs.useCommand;
+exports.Command = _U4NXCMZ3cjs.Command; exports.useCommand = _U4NXCMZ3cjs.useCommand;

package/cjs/composite/composite-container.cjs

@@ -2,16 +2,16 @@
 
 
 
-var _I5SQKHRZcjs = require('../__chunks/I5SQKHRZ.cjs');
+var _MJP4XPFZcjs = require('../__chunks/MJP4XPFZ.cjs');
 require('../__chunks/6ZZYUFPW.cjs');
-require('../__chunks/4XFLDG56.cjs');
-require('../__chunks/Q6CVYJBO.cjs');
-require('../__chunks/Q67LZMDT.cjs');
-require('../__chunks/OLOZ5JT2.cjs');
-require('../__chunks/EO6LS72H.cjs');
+require('../__chunks/VPI3EKVY.cjs');
+require('../__chunks/NEK2UEJN.cjs');
+require('../__chunks/NGD3IQDB.cjs');
+require('../__chunks/GXMZA6DT.cjs');
+require('../__chunks/TW3SFX4C.cjs');
 require('../__chunks/CJDHQUBR.cjs');
 require('../__chunks/AV6KTKLE.cjs');
 
 
 
-exports.CompositeContainer = _I5SQKHRZcjs.CompositeContainer; exports.useCompositeContainer = _I5SQKHRZcjs.useCompositeContainer;
+exports.CompositeContainer = _MJP4XPFZcjs.CompositeContainer; exports.useCompositeContainer = _MJP4XPFZcjs.useCompositeContainer;

package/cjs/composite/composite-context.cjs

@@ -7,10 +7,10 @@
 
 
 
-var _4XFLDG56cjs = require('../__chunks/4XFLDG56.cjs');
-require('../__chunks/Q6CVYJBO.cjs');
-require('../__chunks/Q67LZMDT.cjs');
-require('../__chunks/EO6LS72H.cjs');
+var _VPI3EKVYcjs = require('../__chunks/VPI3EKVY.cjs');
+require('../__chunks/NEK2UEJN.cjs');
+require('../__chunks/NGD3IQDB.cjs');
+require('../__chunks/TW3SFX4C.cjs');
 require('../__chunks/CJDHQUBR.cjs');
 require('../__chunks/AV6KTKLE.cjs');
 
@@ -21,4 +21,4 @@ require('../__chunks/AV6KTKLE.cjs');
 
 
 
-exports.CompositeContextProvider = _4XFLDG56cjs.CompositeContextProvider; exports.CompositeItemContext = _4XFLDG56cjs.CompositeItemContext; exports.CompositeRowContext = _4XFLDG56cjs.CompositeRowContext; exports.CompositeScopedContextProvider = _4XFLDG56cjs.CompositeScopedContextProvider; exports.useCompositeContext = _4XFLDG56cjs.useCompositeContext; exports.useCompositeProviderContext = _4XFLDG56cjs.useCompositeProviderContext; exports.useCompositeScopedContext = _4XFLDG56cjs.useCompositeScopedContext;
+exports.CompositeContextProvider = _VPI3EKVYcjs.CompositeContextProvider; exports.CompositeItemContext = _VPI3EKVYcjs.CompositeItemContext; exports.CompositeRowContext = _VPI3EKVYcjs.CompositeRowContext; exports.CompositeScopedContextProvider = _VPI3EKVYcjs.CompositeScopedContextProvider; exports.useCompositeContext = _VPI3EKVYcjs.useCompositeContext; exports.useCompositeProviderContext = _VPI3EKVYcjs.useCompositeProviderContext; exports.useCompositeScopedContext = _VPI3EKVYcjs.useCompositeScopedContext;

package/cjs/composite/composite-group-label.cjs

@@ -2,14 +2,14 @@
 
 
 
-var _2CZCHCJMcjs = require('../__chunks/2CZCHCJM.cjs');
-require('../__chunks/GMXGH5P5.cjs');
+var _LKX2GEFMcjs = require('../__chunks/LKX2GEFM.cjs');
+require('../__chunks/Q45O26MP.cjs');
 require('../__chunks/FE3YCURH.cjs');
-require('../__chunks/Q67LZMDT.cjs');
-require('../__chunks/EO6LS72H.cjs');
+require('../__chunks/NGD3IQDB.cjs');
+require('../__chunks/TW3SFX4C.cjs');
 require('../__chunks/CJDHQUBR.cjs');
 require('../__chunks/AV6KTKLE.cjs');
 
 
 
-exports.CompositeGroupLabel = _2CZCHCJMcjs.CompositeGroupLabel; exports.useCompositeGroupLabel = _2CZCHCJMcjs.useCompositeGroupLabel;
+exports.CompositeGroupLabel = _LKX2GEFMcjs.CompositeGroupLabel; exports.useCompositeGroupLabel = _LKX2GEFMcjs.useCompositeGroupLabel;

package/cjs/composite/composite-group.cjs

@@ -2,14 +2,14 @@
 
 
 
-var _BTE5YB27cjs = require('../__chunks/BTE5YB27.cjs');
-require('../__chunks/47V4ED4R.cjs');
+var _G4TVYYCTcjs = require('../__chunks/G4TVYYCT.cjs');
+require('../__chunks/422GLKBK.cjs');
 require('../__chunks/FE3YCURH.cjs');
-require('../__chunks/Q67LZMDT.cjs');
-require('../__chunks/EO6LS72H.cjs');
+require('../__chunks/NGD3IQDB.cjs');
+require('../__chunks/TW3SFX4C.cjs');
 require('../__chunks/CJDHQUBR.cjs');
 require('../__chunks/AV6KTKLE.cjs');
 
 
 
-exports.CompositeGroup = _BTE5YB27cjs.CompositeGroup; exports.useCompositeGroup = _BTE5YB27cjs.useCompositeGroup;
+exports.CompositeGroup = _G4TVYYCTcjs.CompositeGroup; exports.useCompositeGroup = _G4TVYYCTcjs.useCompositeGroup;