@ariakit/react-core 0.3.12 → 0.3.13

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

@@ -20,11 +20,16 @@ import type { ComboboxStore } from "./combobox-store.js";
  */
 export declare const useComboboxDisclosure: import("../utils/types.js").Hook<ComboboxDisclosureOptions<"button">>;
 /**
- * Renders a combobox disclosure button that toggles the combobox popover
+ * Renders a combobox disclosure button that toggles the
+ * [`ComboboxPopover`](https://ariakit.org/reference/combobox-popover) element's
  * visibility when clicked.
+ *
+ * Although this button is not tabbable, it remains accessible to screen reader
+ * users. On clicking, it automatically shifts focus to the
+ * [`Combobox`](https://ariakit.org/reference/combobox) element.
  * @see https://ariakit.org/components/combobox
  * @example
- * ```jsx
+ * ```jsx {3}
  * <ComboboxProvider>
  *   <Combobox />
  *   <ComboboxDisclosure />

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

@@ -16,11 +16,11 @@ import type { ComboboxStore } from "./combobox-store.js";
 export declare const useComboboxGroupLabel: import("../utils/types.js").Hook<ComboboxGroupLabelOptions<"div">>;
 /**
  * Renders a label in a combobox group. This component should be wrapped with
- * `ComboboxGroup` so the `aria-labelledby` is correctly set on the combobox
- * group element.
+ * [`ComboboxGroup`](https://ariakit.org/reference/combobox-group) so the
+ * `aria-labelledby` is correctly set on the group element.
  * @see https://ariakit.org/components/combobox
  * @example
- * ```jsx
+ * ```jsx {5}
  * <ComboboxProvider>
  *   <Combobox />
  *   <ComboboxPopover>
@@ -38,7 +38,7 @@ export interface ComboboxGroupLabelOptions<T extends As = "div"> extends Composi
     /**
      * Object returned by the
      * [`useComboboxStore`](https://ariakit.org/reference/use-combobox-store)
-     * hook. If not provided, the parent
+     * hook. If not provided, the closest
      * [`ComboboxList`](https://ariakit.org/reference/combobox-list) or
      * [`ComboboxPopover`](https://ariakit.org/reference/combobox-popover)
      * components' context will be used.

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

@@ -16,11 +16,11 @@ import type { ComboboxStore } from "./combobox-store.js";
 export declare const useComboboxGroupLabel: import("../utils/types.js").Hook<ComboboxGroupLabelOptions<"div">>;
 /**
  * Renders a label in a combobox group. This component should be wrapped with
- * `ComboboxGroup` so the `aria-labelledby` is correctly set on the combobox
- * group element.
+ * [`ComboboxGroup`](https://ariakit.org/reference/combobox-group) so the
+ * `aria-labelledby` is correctly set on the group element.
  * @see https://ariakit.org/components/combobox
  * @example
- * ```jsx
+ * ```jsx {5}
  * <ComboboxProvider>
  *   <Combobox />
  *   <ComboboxPopover>
@@ -38,7 +38,7 @@ export interface ComboboxGroupLabelOptions<T extends As = "div"> extends Composi
     /**
      * Object returned by the
      * [`useComboboxStore`](https://ariakit.org/reference/use-combobox-store)
-     * hook. If not provided, the parent
+     * hook. If not provided, the closest
      * [`ComboboxList`](https://ariakit.org/reference/combobox-list) or
      * [`ComboboxPopover`](https://ariakit.org/reference/combobox-popover)
      * components' context will be used.

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

@@ -20,10 +20,14 @@ import type { ComboboxStore } from "./combobox-store.js";
  */
 export declare const useComboboxGroup: import("../utils/types.js").Hook<ComboboxGroupOptions<"div">>;
 /**
- * Renders a combobox group.
+ * Renders a group for
+ * [`ComboboxItem`](https://ariakit.org/reference/combobox-item) elements.
+ * Optionally, a
+ * [`ComboboxGroupLabel`](https://ariakit.org/reference/combobox-group-label)
+ * can be rendered as a child to provide a label for the group.
  * @see https://ariakit.org/components/combobox
  * @example
- * ```jsx
+ * ```jsx {4-8}
  * <ComboboxProvider>
  *   <Combobox />
  *   <ComboboxPopover>
@@ -41,7 +45,7 @@ export interface ComboboxGroupOptions<T extends As = "div"> extends CompositeGro
     /**
      * Object returned by the
      * [`useComboboxStore`](https://ariakit.org/reference/use-combobox-store)
-     * hook. If not provided, the parent
+     * hook. If not provided, the closest
      * [`ComboboxList`](https://ariakit.org/reference/combobox-list) or
      * [`ComboboxPopover`](https://ariakit.org/reference/combobox-popover)
      * components' context will be used.

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

@@ -20,10 +20,14 @@ import type { ComboboxStore } from "./combobox-store.js";
  */
 export declare const useComboboxGroup: import("../utils/types.js").Hook<ComboboxGroupOptions<"div">>;
 /**
- * Renders a combobox group.
+ * Renders a group for
+ * [`ComboboxItem`](https://ariakit.org/reference/combobox-item) elements.
+ * Optionally, a
+ * [`ComboboxGroupLabel`](https://ariakit.org/reference/combobox-group-label)
+ * can be rendered as a child to provide a label for the group.
  * @see https://ariakit.org/components/combobox
  * @example
- * ```jsx
+ * ```jsx {4-8}
  * <ComboboxProvider>
  *   <Combobox />
  *   <ComboboxPopover>
@@ -41,7 +45,7 @@ export interface ComboboxGroupOptions<T extends As = "div"> extends CompositeGro
     /**
      * Object returned by the
      * [`useComboboxStore`](https://ariakit.org/reference/use-combobox-store)
-     * hook. If not provided, the parent
+     * hook. If not provided, the closest
      * [`ComboboxList`](https://ariakit.org/reference/combobox-list) or
      * [`ComboboxPopover`](https://ariakit.org/reference/combobox-popover)
      * components' context will be used.

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

@@ -14,12 +14,15 @@ import type { ComboboxStore } from "./combobox-store.js";
  */
 export declare const useComboboxItemCheck: import("../utils/types.js").Hook<ComboboxItemCheckOptions<"span">>;
 /**
- * Renders a checkmark inside a
- * [`ComboboxItem`](https://ariakit.org/reference/combobox-item) component. This
- * component must be wrapped with
- * [`ComboboxItem`](https://ariakit.org/reference/combobox-item) or the
+ * Renders a checkmark icon when the
  * [`checked`](https://ariakit.org/reference/combobox-item-check#checked) prop
- * must be explicitly passed to the component.
+ * is `true`. The icon can be overridden by providing a different one as
+ * children.
+ *
+ * When rendered inside a
+ * [`ComboboxItem`](https://ariakit.org/reference/combobox-item) component, the
+ * [`checked`](https://ariakit.org/reference/combobox-item-check#checked) prop
+ * is automatically derived from the context.
  * @see https://ariakit.org/components/combobox
  * @example
  * ```jsx {5,9}
@@ -43,18 +46,8 @@ export interface ComboboxItemCheckOptions<T extends As = "span"> extends Checkbo
     /**
      * 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.
+     * hook.
      */
     store?: ComboboxStore;
-    /**
-     * Whether the check mark should be shown. This value is automatically
-     * inferred from the parent
-     * [`ComboboxItem`](https://ariakit.org/reference/combobox-item) component.
-     * Manually setting this prop will override the inferred value.
-     */
-    checked?: boolean;
 }
 export type ComboboxItemCheckProps<T extends As = "span"> = Props<ComboboxItemCheckOptions<T>>;

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

@@ -14,12 +14,15 @@ import type { ComboboxStore } from "./combobox-store.js";
  */
 export declare const useComboboxItemCheck: import("../utils/types.js").Hook<ComboboxItemCheckOptions<"span">>;
 /**
- * Renders a checkmark inside a
- * [`ComboboxItem`](https://ariakit.org/reference/combobox-item) component. This
- * component must be wrapped with
- * [`ComboboxItem`](https://ariakit.org/reference/combobox-item) or the
+ * Renders a checkmark icon when the
  * [`checked`](https://ariakit.org/reference/combobox-item-check#checked) prop
- * must be explicitly passed to the component.
+ * is `true`. The icon can be overridden by providing a different one as
+ * children.
+ *
+ * When rendered inside a
+ * [`ComboboxItem`](https://ariakit.org/reference/combobox-item) component, the
+ * [`checked`](https://ariakit.org/reference/combobox-item-check#checked) prop
+ * is automatically derived from the context.
  * @see https://ariakit.org/components/combobox
  * @example
  * ```jsx {5,9}
@@ -43,18 +46,8 @@ export interface ComboboxItemCheckOptions<T extends As = "span"> extends Checkbo
     /**
      * 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.
+     * hook.
      */
     store?: ComboboxStore;
-    /**
-     * Whether the check mark should be shown. This value is automatically
-     * inferred from the parent
-     * [`ComboboxItem`](https://ariakit.org/reference/combobox-item) component.
-     * Manually setting this prop will override the inferred value.
-     */
-    checked?: boolean;
 }
 export type ComboboxItemCheckProps<T extends As = "span"> = Props<ComboboxItemCheckOptions<T>>;

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

@@ -23,13 +23,16 @@ import type { ComboboxStore } from "./combobox-store.js";
  */
 export declare const useComboboxItemValue: import("../utils/types.js").Hook<ComboboxItemValueOptions<"span">>;
 /**
- * Renders a value element inside a combobox item. The value will be split into
- * span elements. The portions of the value that correspond to the store value
- * will have a `data-user-value` attribute. The other portions will have a
- * `data-autocomplete-value` attribute.
+ * Renders a value element inside a
+ * [`ComboboxItem`](https://ariakit.org/reference/combobox-item). The value will
+ * be split into span elements. The portions of the value that correspond to the
+ * combobox value will have a
+ * [`data-user-value`](https://ariakit.org/guide/styling#data-user-value)
+ * attribute. The other portions will have a [`data-autocomplete-value`](https://ariakit.org/guide/styling#data-autocomplete-value)
+ * attribute.
  * @see https://ariakit.org/components/combobox
  * @example
- * ```jsx
+ * ```jsx {5} "value"
  * <ComboboxProvider value="p">
  *   <Combobox />
  *   <ComboboxPopover>
@@ -53,15 +56,17 @@ export interface ComboboxItemValueOptions<T extends As = "span"> extends Options
     /**
      * Object returned by the
      * [`useComboboxStore`](https://ariakit.org/reference/use-combobox-store)
-     * hook. If not provided, the parent
+     * hook. If not provided, the closest
      * [`ComboboxList`](https://ariakit.org/reference/combobox-list) or
      * [`ComboboxPopover`](https://ariakit.org/reference/combobox-popover)
      * components' context will be used.
      */
     store?: ComboboxStore;
     /**
-     * The current combobox item value. If not provided, the parent `ComboboxItem`
-     * component's `value` prop will be used.
+     * The current combobox item value. If not provided, the parent
+     * [`ComboboxItem`](https://ariakit.org/reference/combobox-item) component's
+     * [`value`](https://ariakit.org/reference/combobox-item#value) prop will be
+     * used.
      */
     value?: string;
 }

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

@@ -23,13 +23,16 @@ import type { ComboboxStore } from "./combobox-store.js";
  */
 export declare const useComboboxItemValue: import("../utils/types.js").Hook<ComboboxItemValueOptions<"span">>;
 /**
- * Renders a value element inside a combobox item. The value will be split into
- * span elements. The portions of the value that correspond to the store value
- * will have a `data-user-value` attribute. The other portions will have a
- * `data-autocomplete-value` attribute.
+ * Renders a value element inside a
+ * [`ComboboxItem`](https://ariakit.org/reference/combobox-item). The value will
+ * be split into span elements. The portions of the value that correspond to the
+ * combobox value will have a
+ * [`data-user-value`](https://ariakit.org/guide/styling#data-user-value)
+ * attribute. The other portions will have a [`data-autocomplete-value`](https://ariakit.org/guide/styling#data-autocomplete-value)
+ * attribute.
  * @see https://ariakit.org/components/combobox
  * @example
- * ```jsx
+ * ```jsx {5} "value"
  * <ComboboxProvider value="p">
  *   <Combobox />
  *   <ComboboxPopover>
@@ -53,15 +56,17 @@ export interface ComboboxItemValueOptions<T extends As = "span"> extends Options
     /**
      * Object returned by the
      * [`useComboboxStore`](https://ariakit.org/reference/use-combobox-store)
-     * hook. If not provided, the parent
+     * hook. If not provided, the closest
      * [`ComboboxList`](https://ariakit.org/reference/combobox-list) or
      * [`ComboboxPopover`](https://ariakit.org/reference/combobox-popover)
      * components' context will be used.
      */
     store?: ComboboxStore;
     /**
-     * The current combobox item value. If not provided, the parent `ComboboxItem`
-     * component's `value` prop will be used.
+     * The current combobox item value. If not provided, the parent
+     * [`ComboboxItem`](https://ariakit.org/reference/combobox-item) component's
+     * [`value`](https://ariakit.org/reference/combobox-item#value) prop will be
+     * used.
      */
     value?: string;
 }

package/cjs/combobox/combobox-item.cjs

@@ -9,8 +9,8 @@ var _IPYAEPOTcjs = require('../__chunks/IPYAEPOT.cjs');
 var _3WCBE6SUcjs = require('../__chunks/3WCBE6SU.cjs');
 
 
-var _IO6J4PANcjs = require('../__chunks/IO6J4PAN.cjs');
-require('../__chunks/DAJUUBUI.cjs');
+var _GSETTLOUcjs = require('../__chunks/GSETTLOU.cjs');
+require('../__chunks/OSTQZD2E.cjs');
 require('../__chunks/R5A2WTWB.cjs');
 require('../__chunks/6ZZYUFPW.cjs');
 require('../__chunks/UZNYSPKP.cjs');
@@ -18,7 +18,7 @@ require('../__chunks/BZTDJIVT.cjs');
 require('../__chunks/UVBBMANL.cjs');
 require('../__chunks/F2A2ZQDB.cjs');
 require('../__chunks/S6UU7NA4.cjs');
-require('../__chunks/Z3GCTNW4.cjs');
+require('../__chunks/VUEWHLYH.cjs');
 require('../__chunks/75KXQZJX.cjs');
 
 
@@ -169,7 +169,7 @@ var useComboboxItem = _RNZNGEL4cjs.createHook.call(void 0,
       onKeyDown
     });
     const moveOnKeyPressProp = _EO6LS72Hcjs.useBooleanEvent.call(void 0, moveOnKeyPress);
-    props = _IO6J4PANcjs.useCompositeItem.call(void 0, _AV6KTKLEcjs.__spreadProps.call(void 0, _AV6KTKLEcjs.__spreadValues.call(void 0, {
+    props = _GSETTLOUcjs.useCompositeItem.call(void 0, _AV6KTKLEcjs.__spreadProps.call(void 0, _AV6KTKLEcjs.__spreadValues.call(void 0, {
       store
     }, props), {
       getItem,

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

@@ -16,19 +16,16 @@ import type { ComboboxStore } from "./combobox-store.js";
  */
 export declare const useComboboxItem: import("../utils/types.js").Hook<ComboboxItemOptions<"div">>;
 /**
- * Renders a combobox item inside a
+ * Renders a combobox item inside
  * [`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`.
+ * components.
  *
- * By default, the
- * [`value`](https://ariakit.org/reference/combobox-item#value) prop will be
- * rendered as the children, but this can be overriden.
+ * 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
+ * ```jsx {4-6}
  * <ComboboxProvider>
  *   <Combobox />
  *   <ComboboxPopover>
@@ -44,10 +41,13 @@ export interface ComboboxItemOptions<T extends As = "div"> extends CompositeItem
     /**
      * Object returned by the
      * [`useComboboxStore`](https://ariakit.org/reference/use-combobox-store)
-     * hook. If not provided, the parent
+     * hook. If not provided, the closest
      * [`ComboboxList`](https://ariakit.org/reference/combobox-list) or
      * [`ComboboxPopover`](https://ariakit.org/reference/combobox-popover)
      * components' context will be used.
+     *
+     * Live examples:
+     * - [Navigation Menubar](https://ariakit.org/examples/menubar-navigation)
      */
     store?: ComboboxStore;
     /**
@@ -86,6 +86,8 @@ export interface ComboboxItemOptions<T extends As = "div"> extends CompositeItem
      *
      * Live examples:
      * - [Combobox with links](https://ariakit.org/examples/combobox-links)
+     * - [Submenu with
+     *   Combobox](https://ariakit.org/examples/menu-nested-combobox)
      */
     hideOnClick?: BooleanOrCallback<MouseEvent<HTMLElement>>;
     /**

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

@@ -16,19 +16,16 @@ import type { ComboboxStore } from "./combobox-store.js";
  */
 export declare const useComboboxItem: import("../utils/types.js").Hook<ComboboxItemOptions<"div">>;
 /**
- * Renders a combobox item inside a
+ * Renders a combobox item inside
  * [`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`.
+ * components.
  *
- * By default, the
- * [`value`](https://ariakit.org/reference/combobox-item#value) prop will be
- * rendered as the children, but this can be overriden.
+ * 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
+ * ```jsx {4-6}
  * <ComboboxProvider>
  *   <Combobox />
  *   <ComboboxPopover>
@@ -44,10 +41,13 @@ export interface ComboboxItemOptions<T extends As = "div"> extends CompositeItem
     /**
      * Object returned by the
      * [`useComboboxStore`](https://ariakit.org/reference/use-combobox-store)
-     * hook. If not provided, the parent
+     * hook. If not provided, the closest
      * [`ComboboxList`](https://ariakit.org/reference/combobox-list) or
      * [`ComboboxPopover`](https://ariakit.org/reference/combobox-popover)
      * components' context will be used.
+     *
+     * Live examples:
+     * - [Navigation Menubar](https://ariakit.org/examples/menubar-navigation)
      */
     store?: ComboboxStore;
     /**
@@ -86,6 +86,8 @@ export interface ComboboxItemOptions<T extends As = "div"> extends CompositeItem
      *
      * Live examples:
      * - [Combobox with links](https://ariakit.org/examples/combobox-links)
+     * - [Submenu with
+     *   Combobox](https://ariakit.org/examples/menu-nested-combobox)
      */
     hideOnClick?: BooleanOrCallback<MouseEvent<HTMLElement>>;
     /**

package/cjs/combobox/combobox-list.cjs

@@ -2,7 +2,7 @@
 
 
 
-var _D4TG5DM4cjs = require('../__chunks/D4TG5DM4.cjs');
+var _UPU6KE6Ccjs = require('../__chunks/UPU6KE6C.cjs');
 require('../__chunks/3WCBE6SU.cjs');
 require('../__chunks/UZNYSPKP.cjs');
 require('../__chunks/BZTDJIVT.cjs');
@@ -10,7 +10,7 @@ require('../__chunks/YPVQYY4J.cjs');
 require('../__chunks/UVBBMANL.cjs');
 require('../__chunks/F2A2ZQDB.cjs');
 require('../__chunks/S6UU7NA4.cjs');
-require('../__chunks/Z3GCTNW4.cjs');
+require('../__chunks/VUEWHLYH.cjs');
 require('../__chunks/75KXQZJX.cjs');
 require('../__chunks/RNZNGEL4.cjs');
 require('../__chunks/OLOZ5JT2.cjs');
@@ -20,4 +20,4 @@ require('../__chunks/AV6KTKLE.cjs');
 
 
 
-exports.ComboboxList = _D4TG5DM4cjs.ComboboxList; exports.useComboboxList = _D4TG5DM4cjs.useComboboxList;
+exports.ComboboxList = _UPU6KE6Ccjs.ComboboxList; exports.useComboboxList = _UPU6KE6Ccjs.useComboboxList;

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

@@ -21,12 +21,9 @@ 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.
  * @see https://ariakit.org/components/combobox
  * @example
- * ```jsx
+ * ```jsx {3-7}
  * <ComboboxProvider>
  *   <Combobox />
  *   <ComboboxList>

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

@@ -21,12 +21,9 @@ 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.
  * @see https://ariakit.org/components/combobox
  * @example
- * ```jsx
+ * ```jsx {3-7}
  * <ComboboxProvider>
  *   <Combobox />
  *   <ComboboxList>

package/cjs/combobox/combobox-popover.cjs

@@ -1,7 +1,7 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});"use client";
 
 
-var _D4TG5DM4cjs = require('../__chunks/D4TG5DM4.cjs');
+var _UPU6KE6Ccjs = require('../__chunks/UPU6KE6C.cjs');
 
 
 var _3WCBE6SUcjs = require('../__chunks/3WCBE6SU.cjs');
@@ -9,12 +9,12 @@ require('../__chunks/UZNYSPKP.cjs');
 require('../__chunks/BZTDJIVT.cjs');
 
 
-var _KDG57VZVcjs = require('../__chunks/KDG57VZV.cjs');
+var _CIZTEPFOcjs = require('../__chunks/CIZTEPFO.cjs');
 
 
-var _EKB76T2Ucjs = require('../__chunks/EKB76T2U.cjs');
+var _FGHQW2WScjs = require('../__chunks/FGHQW2WS.cjs');
 require('../__chunks/WZ3DRKGP.cjs');
-require('../__chunks/NKR65BKC.cjs');
+require('../__chunks/KSPMHEYZ.cjs');
 require('../__chunks/PZL34OVO.cjs');
 require('../__chunks/344F3DYO.cjs');
 require('../__chunks/KREY6HXD.cjs');
@@ -22,11 +22,11 @@ require('../__chunks/5ZOCN23X.cjs');
 require('../__chunks/JVDUGICD.cjs');
 require('../__chunks/VV6WA3I6.cjs');
 require('../__chunks/7YLCVXZ7.cjs');
+require('../__chunks/5GTNIPQ6.cjs');
 require('../__chunks/7TN63K2T.cjs');
+require('../__chunks/V24PR4PW.cjs');
 require('../__chunks/6IUEXB4L.cjs');
 require('../__chunks/JF225FQ5.cjs');
-require('../__chunks/5GTNIPQ6.cjs');
-require('../__chunks/V24PR4PW.cjs');
 require('../__chunks/7566TIRW.cjs');
 require('../__chunks/J3OG6T3B.cjs');
 require('../__chunks/65LGW5LY.cjs');
@@ -38,7 +38,7 @@ require('../__chunks/YPVQYY4J.cjs');
 require('../__chunks/UVBBMANL.cjs');
 require('../__chunks/F2A2ZQDB.cjs');
 require('../__chunks/S6UU7NA4.cjs');
-require('../__chunks/Z3GCTNW4.cjs');
+require('../__chunks/VUEWHLYH.cjs');
 require('../__chunks/75KXQZJX.cjs');
 require('../__chunks/R66IWXK6.cjs');
 
@@ -93,8 +93,8 @@ var useComboboxPopover = _RNZNGEL4cjs.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 = _D4TG5DM4cjs.useComboboxList.call(void 0, _AV6KTKLEcjs.__spreadValues.call(void 0, { store, alwaysVisible }, props));
-    props = _KDG57VZVcjs.usePopover.call(void 0, _AV6KTKLEcjs.__spreadProps.call(void 0, _AV6KTKLEcjs.__spreadValues.call(void 0, {
+    props = _UPU6KE6Ccjs.useComboboxList.call(void 0, _AV6KTKLEcjs.__spreadValues.call(void 0, { store, alwaysVisible }, props));
+    props = _CIZTEPFOcjs.usePopover.call(void 0, _AV6KTKLEcjs.__spreadProps.call(void 0, _AV6KTKLEcjs.__spreadValues.call(void 0, {
       store,
       modal,
       alwaysVisible,
@@ -150,7 +150,7 @@ var useComboboxPopover = _RNZNGEL4cjs.createHook.call(void 0,
     return props;
   }
 );
-var ComboboxPopover = _EKB76T2Ucjs.createDialogComponent.call(void 0, 
+var ComboboxPopover = _FGHQW2WScjs.createDialogComponent.call(void 0, 
   _RNZNGEL4cjs.createComponent.call(void 0, (props) => {
     const htmlProps = useComboboxPopover(props);
     return _RNZNGEL4cjs.createElement.call(void 0, "div", htmlProps);

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

@@ -19,11 +19,10 @@ export declare const useComboboxPopover: import("../utils/types.js").Hook<Combob
 /**
  * Renders a combobox popover. 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.
+ * `menu`, `tree`, `grid` or `dialog`).
  * @see https://ariakit.org/components/combobox
  * @example
- * ```jsx
+ * ```jsx {3-7}
  * <ComboboxProvider>
  *   <Combobox />
  *   <ComboboxPopover>

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

@@ -19,11 +19,10 @@ export declare const useComboboxPopover: import("../utils/types.js").Hook<Combob
 /**
  * Renders a combobox popover. 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.
+ * `menu`, `tree`, `grid` or `dialog`).
  * @see https://ariakit.org/components/combobox
  * @example
- * ```jsx
+ * ```jsx {3-7}
  * <ComboboxProvider>
  *   <Combobox />
  *   <ComboboxPopover>

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

@@ -3,7 +3,8 @@ 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.
+ * Provides a combobox store that controls the state of
+ * [Combobox](https://ariakit.org/components/combobox) components.
  * @see https://ariakit.org/components/combobox
  * @example
  * ```jsx

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

@@ -3,7 +3,8 @@ 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.
+ * Provides a combobox store that controls the state of
+ * [Combobox](https://ariakit.org/components/combobox) components.
  * @see https://ariakit.org/components/combobox
  * @example
  * ```jsx

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

@@ -19,10 +19,13 @@ import type { ComboboxStore } from "./combobox-store.js";
  */
 export declare const useComboboxRow: import("../utils/types.js").Hook<ComboboxRowOptions<"div">>;
 /**
- * Renders a combobox row.
+ * Renders a combobox row that allows two-dimensional arrow key navigation.
+ * [`ComboboxItem`](https://ariakit.org/reference/combobox-item) elements
+ * wrapped within this component will automatically receive a
+ * [`rowId`](https://ariakit.org/reference/combobox-item#rowid) prop.
  * @see https://ariakit.org/components/combobox
  * @example
- * ```jsx
+ * ```jsx {4-13}
  * <ComboboxProvider>
  *   <Combobox />
  *   <ComboboxPopover>
@@ -45,7 +48,7 @@ export interface ComboboxRowOptions<T extends As = "div"> extends CompositeRowOp
     /**
      * Object returned by the
      * [`useComboboxStore`](https://ariakit.org/reference/use-combobox-store)
-     * hook. If not provided, the parent
+     * hook. If not provided, the closest
      * [`ComboboxList`](https://ariakit.org/reference/combobox-list) or
      * [`ComboboxPopover`](https://ariakit.org/reference/combobox-popover)
      * components' context will be used.

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

@@ -19,10 +19,13 @@ import type { ComboboxStore } from "./combobox-store.js";
  */
 export declare const useComboboxRow: import("../utils/types.js").Hook<ComboboxRowOptions<"div">>;
 /**
- * Renders a combobox row.
+ * Renders a combobox row that allows two-dimensional arrow key navigation.
+ * [`ComboboxItem`](https://ariakit.org/reference/combobox-item) elements
+ * wrapped within this component will automatically receive a
+ * [`rowId`](https://ariakit.org/reference/combobox-item#rowid) prop.
  * @see https://ariakit.org/components/combobox
  * @example
- * ```jsx
+ * ```jsx {4-13}
  * <ComboboxProvider>
  *   <Combobox />
  *   <ComboboxPopover>
@@ -45,7 +48,7 @@ export interface ComboboxRowOptions<T extends As = "div"> extends CompositeRowOp
     /**
      * Object returned by the
      * [`useComboboxStore`](https://ariakit.org/reference/use-combobox-store)
-     * hook. If not provided, the parent
+     * hook. If not provided, the closest
      * [`ComboboxList`](https://ariakit.org/reference/combobox-list) or
      * [`ComboboxPopover`](https://ariakit.org/reference/combobox-popover)
      * components' context will be used.