@ariakit/react-core 0.3.0 → 0.3.2

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

@@ -24,22 +24,27 @@ export declare const useComboboxGroup: import("../utils/types.js").Hook<Combobox
  * @see https://ariakit.org/components/combobox
  * @example
  * ```jsx
- * const combobox = useComboboxStore();
- * <Combobox store={store} />
- * <ComboboxPopover store={store}>
- *   <ComboboxGroup>
- *     <ComboboxGroupLabel>Label</ComboboxGroupLabel>
- *     <ComboboxItem value="Item 1" />
- *     <ComboboxItem value="Item 2" />
- *   </ComboboxGroup>
- * </ComboboxPopover>
+ * <ComboboxProvider>
+ *   <Combobox />
+ *   <ComboboxPopover>
+ *     <ComboboxGroup>
+ *       <ComboboxGroupLabel>Fruits</ComboboxGroupLabel>
+ *       <ComboboxItem value="Apple" />
+ *       <ComboboxItem value="Banana" />
+ *     </ComboboxGroup>
+ *   </ComboboxPopover>
+ * </ComboboxProvider>
  * ```
  */
 export declare const ComboboxGroup: import("../utils/types.js").Component<ComboboxGroupOptions<"div">>;
 export interface ComboboxGroupOptions<T extends As = "div"> extends CompositeGroupOptions<T> {
     /**
-     * Object returned by the `useComboboxStore` hook. If not provided, the parent
-     * `ComboboxList` or `ComboboxPopover` components' context will be used.
+     * 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;
 }

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

@@ -30,14 +30,14 @@ export declare const useComboboxItemValue: import("../utils/types.js").Hook<Comb
  * @see https://ariakit.org/components/combobox
  * @example
  * ```jsx
- * const combobox = useComboboxStore({ value: "p" });
- *
- * <Combobox store={combobox} />
- * <ComboboxPopover store={combobox}>
- *   <ComboboxItem value="Apple">
- *     <ComboboxItemValue />
- *   </ComboboxItem>
- * </ComboboxPopover>
+ * <ComboboxProvider value="p">
+ *   <Combobox />
+ *   <ComboboxPopover>
+ *     <ComboboxItem value="Apple">
+ *       <ComboboxItemValue />
+ *     </ComboboxItem>
+ *   </ComboboxPopover>
+ * </ComboboxProvider>
  *
  * // The Apple item will have a value element that looks like this:
  * <span>
@@ -51,8 +51,12 @@ export declare const useComboboxItemValue: import("../utils/types.js").Hook<Comb
 export declare const ComboboxItemValue: import("../utils/types.js").Component<ComboboxItemValueOptions<"span">>;
 export interface ComboboxItemValueOptions<T extends As = "span"> extends Options<T> {
     /**
-     * Object returned by the `useComboboxStore` hook. If not provided, the parent
-     * `ComboboxList` or `ComboboxPopover` components' context will be used.
+     * 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;
     /**

package/cjs/combobox/combobox-item.cjs

@@ -7,7 +7,7 @@ var _LPFT4ZFHcjs = require('../__chunks/LPFT4ZFH.cjs');
 var _ZBG4TGVLcjs = require('../__chunks/ZBG4TGVL.cjs');
 
 
-var _EGFAX26Ucjs = require('../__chunks/EGFAX26U.cjs');
+var _G33PRHOGcjs = require('../__chunks/G33PRHOG.cjs');
 require('../__chunks/NPDPNCSD.cjs');
 require('../__chunks/FMI5QF7N.cjs');
 require('../__chunks/KLZID3QO.cjs');
@@ -23,7 +23,7 @@ require('../__chunks/LHHW5ZQP.cjs');
 
 
 var _Z5PUIG6Acjs = require('../__chunks/Z5PUIG6A.cjs');
-require('../__chunks/42FA4OOB.cjs');
+require('../__chunks/I63PYP2U.cjs');
 
 
 
@@ -129,7 +129,7 @@ var useComboboxItem = _Z5PUIG6Acjs.createHook.call(void 0,
       onKeyDown
     });
     const moveOnKeyPressProp = _5WLTMVVQcjs.useBooleanEvent.call(void 0, moveOnKeyPress);
-    props = _EGFAX26Ucjs.useCompositeItem.call(void 0, _72I2GWXFcjs.__spreadProps.call(void 0, _72I2GWXFcjs.__spreadValues.call(void 0, {
+    props = _G33PRHOGcjs.useCompositeItem.call(void 0, _72I2GWXFcjs.__spreadProps.call(void 0, _72I2GWXFcjs.__spreadValues.call(void 0, {
       store
     }, props), {
       getItem,

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

@@ -16,42 +16,67 @@ import type { ComboboxStore } from "./combobox-store.js";
  */
 export declare const useComboboxItem: import("../utils/types.js").Hook<ComboboxItemOptions<"div">>;
 /**
- * Renders a combobox item inside a combobox list or popover. The `role` prop
- * will be automatically set based on the `ComboboxList` or `ComboboxPopover`
- * own `role` prop. For example, if the `ComboboxPopover` component's `role`
- * prop is set to `listbox` (default), the `ComboboxItem` `role` will be set to
- * `option`. By default, the `value` prop will be rendered as the children, but
- * this can be overriden.
+ * Renders a combobox item inside a
+ * [`ComboboxList`](https://ariakit.org/reference/combobox-list) or
+ * [`ComboboxPopover`](https://ariakit.org/reference/combobox-popover)
+ * components. The `role` prop will be automatically set based on the list's own
+ * `role` prop. For example, if the list `role` is set to `listbox` (default),
+ * the `ComboboxItem` `role` will be set to `option`.
+ *
+ * By default, the
+ * [`value`](https://ariakit.org/reference/combobox-item#value) prop will be
+ * rendered as the children, but this can be overriden.
  * @see https://ariakit.org/components/combobox
  * @example
  * ```jsx
- * const combobox = useComboboxStore();
- * <Combobox store={combobox} />
- * <ComboboxPopover store={combobox}>
- *   <ComboboxItem value="Item 1" />
- *   <ComboboxItem value="Item 2" />
- *   <ComboboxItem value="Item 3" />
- * </ComboboxPopover>
+ * <ComboboxProvider>
+ *   <Combobox />
+ *   <ComboboxPopover>
+ *     <ComboboxItem value="Apple" />
+ *     <ComboboxItem value="Banana" />
+ *     <ComboboxItem value="Orange" />
+ *   </ComboboxPopover>
+ * </ComboboxProvider>
  * ```
  */
 export declare const ComboboxItem: import("../utils/types.js").Component<ComboboxItemOptions<"div">>;
 export interface ComboboxItemOptions<T extends As = "div"> extends CompositeItemOptions<T>, CompositeHoverOptions<T> {
     /**
-     * Object returned by the `useComboboxStore` hook. If not provided, the parent
-     * `ComboboxList` or `ComboboxPopover` components' context will be used.
+     * 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;
     /**
      * The value of the item. This will be rendered as the children by default.
-     *   - If `setValueOnClick` is set to `true`, this will be the value of the
-     *     combobox input when the user clicks on this item.
-     *   - If the `autoComplete` prop on the `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)
+     * - [ComboboxCancel](https://ariakit.org/examples/combobox-cancel)
+     * - [ComboboxDisclosure](https://ariakit.org/examples/combobox-disclosure)
+     * - [Combobox filtering](https://ariakit.org/examples/combobox-filtering)
+     * - [ComboboxGroup](https://ariakit.org/examples/combobox-group)
+     * - [Textarea with inline
+     *   Combobox](https://ariakit.org/examples/combobox-textarea)
      */
     value?: string;
     /**
      * Whether to hide the combobox when this item is clicked.
+     *
+     * Live examples:
+     * - [Combobox with links](https://ariakit.org/examples/combobox-links)
      * @default true
      */
     hideOnClick?: BooleanOrCallback<MouseEvent<HTMLElement>>;

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

@@ -20,24 +20,31 @@ export declare const useComboboxList: import("../utils/types.js").Hook<ComboboxL
 /**
  * Renders a combobox list. The `role` prop is set to `listbox` by default, but
  * can be overriden by any other valid combobox popup role (`listbox`, `menu`,
- * `tree`, `grid` or `dialog`). The `aria-labelledby` prop is set to the
- * combobox input element's `id` by default.
+ * `tree`, `grid` or `dialog`).
+ *
+ * The `aria-labelledby` prop is set to the combobox input element's `id` by
+ * default.
  * @see https://ariakit.org/components/combobox
  * @example
  * ```jsx
- * const combobox = useComboboxStore();
- * <Combobox store={combobox} />
- * <ComboboxList store={combobox}>
- *   <ComboboxItem value="Item 1" />
- *   <ComboboxItem value="Item 2" />
- *   <ComboboxItem value="Item 3" />
- * </ComboboxList>
+ * <ComboboxProvider>
+ *   <Combobox />
+ *   <ComboboxList>
+ *     <ComboboxItem value="Apple" />
+ *     <ComboboxItem value="Banana" />
+ *     <ComboboxItem value="Orange" />
+ *   </ComboboxList>
+ * </ComboboxProvider>
  * ```
  */
 export declare const ComboboxList: import("../utils/types.js").Component<ComboboxListOptions<"div">>;
 export interface ComboboxListOptions<T extends As = "div"> extends FocusableOptions<T>, Pick<DisclosureContentOptions, "alwaysVisible"> {
     /**
-     * Object returned by the `useComboboxStore` hook.
+     * 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;
 }

package/cjs/combobox/combobox-popover.cjs

@@ -8,9 +8,9 @@ require('../__chunks/H7R5D2FR.cjs');
 require('../__chunks/NHZBX2RS.cjs');
 
 
-var _3XB4P6CYcjs = require('../__chunks/3XB4P6CY.cjs');
-require('../__chunks/OPL3VHF2.cjs');
-require('../__chunks/O5YI3KG3.cjs');
+var _XOHN6PERcjs = require('../__chunks/XOHN6PER.cjs');
+require('../__chunks/QEG5AJH6.cjs');
+require('../__chunks/HCQYEOCO.cjs');
 require('../__chunks/6BAHKJ5K.cjs');
 require('../__chunks/DPLHWKRP.cjs');
 require('../__chunks/W32FX7DM.cjs');
@@ -43,8 +43,8 @@ require('../__chunks/KSFAO77E.cjs');
 
 
 var _Z5PUIG6Acjs = require('../__chunks/Z5PUIG6A.cjs');
-require('../__chunks/DEXAWU62.cjs');
-require('../__chunks/42FA4OOB.cjs');
+require('../__chunks/3ULNMLN7.cjs');
+require('../__chunks/I63PYP2U.cjs');
 require('../__chunks/5WLTMVVQ.cjs');
 require('../__chunks/7WUTS26Y.cjs');
 
@@ -88,7 +88,7 @@ var useComboboxPopover = _Z5PUIG6Acjs.createHook.call(void 0,
     );
     const baseElement = store.useState("baseElement");
     props = _7F6H5HXCcjs.useComboboxList.call(void 0, _72I2GWXFcjs.__spreadValues.call(void 0, { store, alwaysVisible }, props));
-    props = _3XB4P6CYcjs.usePopover.call(void 0, _72I2GWXFcjs.__spreadProps.call(void 0, _72I2GWXFcjs.__spreadValues.call(void 0, {
+    props = _XOHN6PERcjs.usePopover.call(void 0, _72I2GWXFcjs.__spreadProps.call(void 0, _72I2GWXFcjs.__spreadValues.call(void 0, {
       store,
       alwaysVisible,
       autoFocusOnShow: false,

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

@@ -24,13 +24,14 @@ export declare const useComboboxPopover: import("../utils/types.js").Hook<Combob
  * @see https://ariakit.org/components/combobox
  * @example
  * ```jsx
- * const combobox = useComboboxStore();
- * <Combobox store={combobox} />
- * <ComboboxPopover store={combobox}>
- *   <ComboboxItem value="Item 1" />
- *   <ComboboxItem value="Item 2" />
- *   <ComboboxItem value="Item 3" />
- * </ComboboxPopover>
+ * <ComboboxProvider>
+ *   <Combobox />
+ *   <ComboboxPopover>
+ *     <ComboboxItem value="Apple" />
+ *     <ComboboxItem value="Banana" />
+ *     <ComboboxItem value="Orange" />
+ *   </ComboboxPopover>
+ * </ComboboxProvider>
  * ```
  */
 export declare const ComboboxPopover: import("../utils/types.js").Component<ComboboxPopoverOptions<"div">>;

package/cjs/combobox/combobox-provider.cjs

@@ -1,21 +1,21 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});
 
-var _HRC6DHTDcjs = require('../__chunks/HRC6DHTD.cjs');
+var _4ULJINEPcjs = require('../__chunks/4ULJINEP.cjs');
 
 
 var _ZBG4TGVLcjs = require('../__chunks/ZBG4TGVL.cjs');
-require('../__chunks/RE3KB52D.cjs');
-require('../__chunks/KAZTJBAF.cjs');
+require('../__chunks/FWCQCCG3.cjs');
+require('../__chunks/GCTYF2Y6.cjs');
 require('../__chunks/H7R5D2FR.cjs');
 require('../__chunks/NHZBX2RS.cjs');
 require('../__chunks/AKOG5S2T.cjs');
 require('../__chunks/W6ZRSMO5.cjs');
 require('../__chunks/A2NMYLCG.cjs');
 require('../__chunks/Z5PUIG6A.cjs');
-require('../__chunks/MMJ2ISJ4.cjs');
-require('../__chunks/VRJL6LRK.cjs');
-require('../__chunks/DEXAWU62.cjs');
-require('../__chunks/42FA4OOB.cjs');
+require('../__chunks/E4C2KZA5.cjs');
+require('../__chunks/NATUYKIW.cjs');
+require('../__chunks/3ULNMLN7.cjs');
+require('../__chunks/I63PYP2U.cjs');
 require('../__chunks/5WLTMVVQ.cjs');
 require('../__chunks/7WUTS26Y.cjs');
 require('../__chunks/72I2GWXF.cjs');
@@ -23,7 +23,7 @@ require('../__chunks/72I2GWXF.cjs');
 // src/combobox/combobox-provider.tsx
 var _jsxruntime = require('react/jsx-runtime');
 function ComboboxProvider(props = {}) {
-  const store = _HRC6DHTDcjs.useComboboxStore.call(void 0, props);
+  const store = _4ULJINEPcjs.useComboboxStore.call(void 0, props);
   return /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _ZBG4TGVLcjs.ComboboxContextProvider, { value: store, children: props.children });
 }
 

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

@@ -23,27 +23,32 @@ export declare const useComboboxRow: import("../utils/types.js").Hook<ComboboxRo
  * @see https://ariakit.org/components/combobox
  * @example
  * ```jsx
- * const combobox = useComboboxStore();
- * <Combobox store={combobox} />
- * <ComboboxPopover store={combobox}>
- *   <ComboboxRow>
- *     <ComboboxItem value="Item 1.1" />
- *     <ComboboxItem value="Item 1.2" />
- *     <ComboboxItem value="Item 1.3" />
- *   </ComboboxRow>
- *   <ComboboxRow>
- *     <ComboboxItem value="Item 2.1" />
- *     <ComboboxItem value="Item 2.2" />
- *     <ComboboxItem value="Item 2.3" />
- *   </ComboboxRow>
- * </ComboboxPopover>
+ * <ComboboxProvider>
+ *   <Combobox />
+ *   <ComboboxPopover>
+ *     <ComboboxRow>
+ *       <ComboboxItem value="Item 1.1" />
+ *       <ComboboxItem value="Item 1.2" />
+ *       <ComboboxItem value="Item 1.3" />
+ *     </ComboboxRow>
+ *     <ComboboxRow>
+ *       <ComboboxItem value="Item 2.1" />
+ *       <ComboboxItem value="Item 2.2" />
+ *       <ComboboxItem value="Item 2.3" />
+ *     </ComboboxRow>
+ *   </ComboboxPopover>
+ * </ComboboxProvider>
  * ```
  */
 export declare const ComboboxRow: import("../utils/types.js").Component<ComboboxRowOptions<"div">>;
 export interface ComboboxRowOptions<T extends As = "div"> extends CompositeRowOptions<T> {
     /**
-     * Object returned by the `useComboboxStore` hook. If not provided, the parent
-     * `ComboboxList` or `ComboboxPopover` components' context will be used.
+     * 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;
 }

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

@@ -22,21 +22,26 @@ export declare const useComboboxSeparator: import("../utils/types.js").Hook<Comb
  * @see https://ariakit.org/components/combobox
  * @example
  * ```jsx
- * const combobox = useComboboxStore();
- * <Combobox store={combobox} />
- * <ComboboxPopover store={combobox}>
- *   <ComboboxItem value="Item 1" />
- *   <ComboboxSeparator />
- *   <ComboboxItem value="Item 2" />
- *   <ComboboxItem value="Item 3" />
- * </ComboboxPopover>
+ * <ComboboxProvider>
+ *   <Combobox />
+ *   <ComboboxPopover>
+ *     <ComboboxItem value="Item 1" />
+ *     <ComboboxSeparator />
+ *     <ComboboxItem value="Item 2" />
+ *     <ComboboxItem value="Item 3" />
+ *   </ComboboxPopover>
+ * </ComboboxProvider>
  * ```
  */
 export declare const ComboboxSeparator: import("../utils/types.js").Component<ComboboxSeparatorOptions<"hr">>;
 export interface ComboboxSeparatorOptions<T extends As = "hr"> extends CompositeSeparatorOptions<T> {
     /**
-     * Object returned by the `useComboboxStore` hook. If not provided, the parent
-     * `ComboboxList` or `ComboboxPopover` components' context will be used.
+     * 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;
 }

package/cjs/combobox/combobox-store.cjs

@@ -1,17 +1,17 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});
 
 
-var _HRC6DHTDcjs = require('../__chunks/HRC6DHTD.cjs');
-require('../__chunks/RE3KB52D.cjs');
-require('../__chunks/KAZTJBAF.cjs');
-require('../__chunks/MMJ2ISJ4.cjs');
-require('../__chunks/VRJL6LRK.cjs');
-require('../__chunks/DEXAWU62.cjs');
-require('../__chunks/42FA4OOB.cjs');
+var _4ULJINEPcjs = require('../__chunks/4ULJINEP.cjs');
+require('../__chunks/FWCQCCG3.cjs');
+require('../__chunks/GCTYF2Y6.cjs');
+require('../__chunks/E4C2KZA5.cjs');
+require('../__chunks/NATUYKIW.cjs');
+require('../__chunks/3ULNMLN7.cjs');
+require('../__chunks/I63PYP2U.cjs');
 require('../__chunks/5WLTMVVQ.cjs');
 require('../__chunks/7WUTS26Y.cjs');
 require('../__chunks/72I2GWXF.cjs');
 
 
 
-exports.useComboboxStore = _HRC6DHTDcjs.useComboboxStore; exports.useComboboxStoreProps = _HRC6DHTDcjs.useComboboxStoreProps;
+exports.useComboboxStore = _4ULJINEPcjs.useComboboxStore; exports.useComboboxStoreProps = _4ULJINEPcjs.useComboboxStoreProps;

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

@@ -26,11 +26,16 @@ export interface ComboboxStoreFunctions extends Core.ComboboxStoreFunctions, Com
 export interface ComboboxStoreOptions extends Core.ComboboxStoreOptions, CompositeStoreOptions<ComboboxStoreItem>, PopoverStoreOptions {
     /**
      * A callback that gets called when the `value` state changes.
+     *
+     * Live examples:
+     * - [Combobox filtering](https://ariakit.org/examples/combobox-filtering)
+     * - [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.
-     * @example
-     * function MyCombobox({ value, onChange }) {
-     *   const combobox = useComboboxStore({ value, setValue: onChange });
-     * }
      */
     setValue?: (value: ComboboxStoreState["value"]) => void;
 }

package/cjs/combobox/combobox.d.ts

@@ -25,31 +25,38 @@ export declare const useCombobox: import("../utils/types.js").Hook<ComboboxOptio
  * @see https://ariakit.org/components/combobox
  * @example
  * ```jsx
- * const combobox = useComboboxStore();
- * <Combobox store={combobox} />
- * <ComboboxPopover store={combobox}>
- *   <ComboboxItem value="Apple" />
- *   <ComboboxItem value="Banana" />
- *   <ComboboxItem value="Orange" />
- * </ComboboxPopover>
+ * <ComboboxProvider>
+ *   <Combobox />
+ *   <ComboboxPopover>
+ *     <ComboboxItem value="Apple" />
+ *     <ComboboxItem value="Banana" />
+ *     <ComboboxItem value="Orange" />
+ *   </ComboboxPopover>
+ * </ComboboxProvider>
  * ```
  */
 export declare const Combobox: import("../utils/types.js").Component<ComboboxOptions<"input">>;
 export interface ComboboxOptions<T extends As = "input"> extends CompositeOptions<T>, PopoverAnchorOptions<T> {
     /**
-     * Object returned by the `useComboboxStore` hook.
+     * 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;
     /**
      * Whether the first 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 `autoComplete` prop:
-     * - If `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.
-     * - If `autoComplete` is `list` or `none`, the first item is automatically
-     *   focused when the popup opens, but the input value doesn't change.
+     * depend on the value of
+     * [`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.
+     * - 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.
      *
      * Live examples:
      * - [ComboboxCancel](https://ariakit.org/examples/combobox-cancel)
@@ -57,26 +64,39 @@ export interface ComboboxOptions<T extends As = "input"> extends CompositeOption
      * - [Combobox with links](https://ariakit.org/examples/combobox-links)
      * - [Textarea with inline
      *   Combobox](https://ariakit.org/examples/combobox-textarea)
+     * - [Menu with Combobox](https://ariakit.org/examples/menu-combobox)
+     * - [Select with Combobox](https://ariakit.org/examples/select-combobox)
      * @default false
      */
     autoSelect?: boolean;
     /**
-     * Whether the items will be filtered based on `value` and whether the input
-     * value will temporarily change based on the active item. If `defaultList` or
-     * `list` are provided, this will be set to `list` by default, otherwise it'll
-     * default to `none`.
-     * - `both`: the items will be filtered based on `value` and the input value
-     *   will temporarily change based on the active item.
-     * - `list`: the items will be filtered based on `value` and the input value
-     *   will NOT change based on the active item.
-     * - `inline`: the items are static, that is, they won't be filtered based on
-     *   `value`, but the input value will temporarily change based on the active
-     *   item.
+     * Whether the items will be filtered based on
+     * [`value`](https://ariakit.org/reference/combobox-provider#value) and
+     * whether the input value will temporarily change based on the active item.
+     *
+     * This prop is based on the standard
+     * [`aria-autocomplete`](https://w3c.github.io/aria/#aria-autocomplete)
+     * attribute, accepting the same values:
+     * - `both`: indicates that the items will be filtered based on
+     *   [`value`](https://ariakit.org/reference/combobox-provider#value) and the
+     *   input value will temporarily change based on the active item. The
+     *   filtering logic must be implemented by the consumer of this component,
+     *   whereas Ariakit will automatically provide the inline autocompletion
+     *   behavior.
+     * - `list` (default): indicates that the items will be filtered based on
+     *   [`value`](https://ariakit.org/reference/combobox-provider#value) and the
+     *   input value will NOT change based on the active item. The filtering logic
+     *   must be implemented by the consumer of this component.
+     * - `inline`: indicates that the items are static, that is, they won't be
+     *   filtered, but the input value will temporarily change based on the active
+     *   item. Ariakit will automatically provide the inline autocompletion
+     *   behavior
      * - `none`: the items are static and the input value will NOT change based on
      *   the active item.
      *
      * Live examples:
      * - [ComboboxGroup](https://ariakit.org/examples/combobox-group)
+     * @default "list"
      */
     autoComplete?: StringWithValue<Required<AriaAttributes>["aria-autocomplete"]>;
     /**
@@ -105,8 +125,9 @@ export interface ComboboxOptions<T extends As = "input"> extends CompositeOption
      */
     setValueOnChange?: BooleanOrCallback<ChangeEvent<HTMLElement>>;
     /**
-     * Whether the combobox list/popover should be shown when the input is
-     * clicked.
+     * 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.
      *
      * Live examples:
      * - [Textarea with inline
@@ -114,15 +135,15 @@ export interface ComboboxOptions<T extends As = "input"> extends CompositeOption
      * @default true
      * @example
      * ```jsx
-     * const combobox = useComboboxStore();
-     * const canShow = combobox.useState((state) => state.value.length > 1);
-     * <Combobox store={combobox} showOnMouseDown={canShow} />
+     * <Combobox showOnMouseDown={value.length > 1} />
      * ```
      */
     showOnMouseDown?: BooleanOrCallback<MouseEvent<HTMLElement>>;
     /**
-     * Whether the combobox list/popover should be shown when the user presses
-     * the arrow up or down keys while focusing on the combobox input element.
+     * 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.
      *
      * Live examples:
      * - [Textarea with inline
@@ -130,9 +151,7 @@ export interface ComboboxOptions<T extends As = "input"> extends CompositeOption
      * @default true
      * @example
      * ```jsx
-     * const combobox = useComboboxStore();
-     * const canShow = combobox.useState((state) => state.value.length > 1);
-     * <Combobox store={combobox} showOnKeyDown={canShow} />
+     * <Combobox showOnKeyDown={value.length > 1} />
      * ```
      */
     showOnKeyDown?: BooleanOrCallback<ReactKeyboardEvent<HTMLElement>>;