@ariakit/react-core 0.3.12 → 0.3.13

package/cjs/checkbox/checkbox-check.d.ts

@@ -12,7 +12,14 @@ import type { CheckboxStore } from "./checkbox-store.js";
  */
 export declare const useCheckboxCheck: import("../utils/types.js").Hook<CheckboxCheckOptions<"span">>;
 /**
- * Renders a check mark icon, usually inside a `Checkbox` component.
+ * Renders a checkmark icon when the
+ * [`checked`](https://ariakit.org/reference/checkbox-check#checked) prop is
+ * `true`. The icon can be overridden by providing a different one as children.
+ *
+ * When rendered inside a [`Checkbox`](https://ariakit.org/reference/checkbox)
+ * component, the
+ * [`checked`](https://ariakit.org/reference/checkbox-check#checked) prop is
+ * automatically derived from the context.
  * @see https://ariakit.org/components/checkbox
  * @example
  * ```jsx
@@ -22,18 +29,19 @@ export declare const useCheckboxCheck: import("../utils/types.js").Hook<Checkbox
 export declare const CheckboxCheck: import("../utils/types.js").Component<CheckboxCheckOptions<"span">>;
 export interface CheckboxCheckOptions<T extends As = "span"> extends Options<T> {
     /**
-     * Object returned by the `useCheckboxStore` hook. If not provided, the parent
-     * `Checkbox` component's context will be used. If the `checked` prop is
-     * provided, it will override this prop.
+     * Object returned by the
+     * [`useCheckboxStore`](https://ariakit.org/reference/use-checkbox-store)
+     * hook.
      */
     store?: CheckboxStore;
     /**
-     * Determines if the check mark should be displayed. This value is
-     * automatically derived from the
-     * [`store`](https://ariakit.org/reference/checkbox-check#store) prop or the
-     * parent [`Checkbox`](https://ariakit.org/reference/checkbox) component.
+     * Determines if the checkmark should be rendered. This value is automatically
+     * derived from the context when it exists. Manually setting this prop will
+     * supersede the derived value.
      *
-     * Manually setting this prop will supersede the derived value.
+     * Live examples:
+     * - [Submenu with
+     *   Combobox](https://ariakit.org/examples/menu-nested-combobox)
      */
     checked?: boolean;
 }

package/cjs/checkbox/checkbox-provider.cjs

@@ -1,10 +1,10 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});"use client";
 
 
-var _63UPRTFZcjs = require('../__chunks/63UPRTFZ.cjs');
+var _VPQQSYH7cjs = require('../__chunks/VPQQSYH7.cjs');
 
 
-var _VPQQSYH7cjs = require('../__chunks/VPQQSYH7.cjs');
+var _63UPRTFZcjs = require('../__chunks/63UPRTFZ.cjs');
 require('../__chunks/RNZNGEL4.cjs');
 require('../__chunks/OLOZ5JT2.cjs');
 require('../__chunks/EO6LS72H.cjs');

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

@@ -3,8 +3,10 @@ import type { PickRequired } from "@ariakit/core/utils/types";
 import type { CheckboxStoreProps, CheckboxStoreValue } from "./checkbox-store.js";
 type Value = CheckboxStoreValue;
 /**
- * Provides a checkbox store to its descendants. This is useful to create a
- * group of checkboxes that share the same store.
+ * Provides a checkbox store for its descendants. This comes in handy when
+ * creating a group of checkboxes that share the same state. `CheckboxProvider`
+ * can efficiently manage the value of a checkbox, whether it's a single string,
+ * number, or boolean value, or an array of such values.
  * @see https://ariakit.org/components/checkbox
  * @example
  * ```jsx

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

@@ -3,8 +3,10 @@ import type { PickRequired } from "@ariakit/core/utils/types";
 import type { CheckboxStoreProps, CheckboxStoreValue } from "./checkbox-store.js";
 type Value = CheckboxStoreValue;
 /**
- * Provides a checkbox store to its descendants. This is useful to create a
- * group of checkboxes that share the same store.
+ * Provides a checkbox store for its descendants. This comes in handy when
+ * creating a group of checkboxes that share the same state. `CheckboxProvider`
+ * can efficiently manage the value of a checkbox, whether it's a single string,
+ * number, or boolean value, or an array of such values.
  * @see https://ariakit.org/components/checkbox
  * @example
  * ```jsx

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

@@ -3,7 +3,8 @@ import type { PickRequired } from "@ariakit/core/utils/types";
 import type { Store } from "../utils/store.js";
 export declare function useCheckboxStoreProps<T extends Core.CheckboxStore>(store: T, update: () => void, props: CheckboxStoreProps): T;
 /**
- * Creates a checkbox store.
+ * Creates a checkbox store to conveniently manage a checkbox value,
+ * whether it's a string, number, boolean, or an array of strings or numbers.
  * @see https://ariakit.org/components/checkbox
  * @example
  * ```jsx
@@ -18,8 +19,9 @@ export type CheckboxStoreState<T extends CheckboxStoreValue = CheckboxStoreValue
 export type CheckboxStoreFunctions<T extends CheckboxStoreValue = CheckboxStoreValue> = Core.CheckboxStoreFunctions<T>;
 export interface CheckboxStoreOptions<T extends CheckboxStoreValue = CheckboxStoreValue> extends Core.CheckboxStoreOptions<T> {
     /**
-     * A callback that gets called when the `value` state changes.
-     * @param value The new value.
+     * A callback that gets called when the
+     * [`value`](https://ariakit.org/reference/checkbox-provider#value) state
+     * changes.
      * @example
      * function MyCheckbox({ value, onChange }) {
      *   const checkbox = useCheckboxStore({ value, setValue: onChange });

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

@@ -3,7 +3,8 @@ import type { PickRequired } from "@ariakit/core/utils/types";
 import type { Store } from "../utils/store.js";
 export declare function useCheckboxStoreProps<T extends Core.CheckboxStore>(store: T, update: () => void, props: CheckboxStoreProps): T;
 /**
- * Creates a checkbox store.
+ * Creates a checkbox store to conveniently manage a checkbox value,
+ * whether it's a string, number, boolean, or an array of strings or numbers.
  * @see https://ariakit.org/components/checkbox
  * @example
  * ```jsx
@@ -18,8 +19,9 @@ export type CheckboxStoreState<T extends CheckboxStoreValue = CheckboxStoreValue
 export type CheckboxStoreFunctions<T extends CheckboxStoreValue = CheckboxStoreValue> = Core.CheckboxStoreFunctions<T>;
 export interface CheckboxStoreOptions<T extends CheckboxStoreValue = CheckboxStoreValue> extends Core.CheckboxStoreOptions<T> {
     /**
-     * A callback that gets called when the `value` state changes.
-     * @param value The new value.
+     * A callback that gets called when the
+     * [`value`](https://ariakit.org/reference/checkbox-provider#value) state
+     * changes.
      * @example
      * function MyCheckbox({ value, onChange }) {
      *   const checkbox = useCheckboxStore({ value, setValue: onChange });

package/cjs/checkbox/checkbox.cjs

@@ -2,11 +2,11 @@
 
 
 
-var _BBS4RP44cjs = require('../__chunks/BBS4RP44.cjs');
+var _2UEWAQWGcjs = require('../__chunks/2UEWAQWG.cjs');
 require('../__chunks/63UPRTFZ.cjs');
 require('../__chunks/ERFHNHON.cjs');
-require('../__chunks/DAJUUBUI.cjs');
-require('../__chunks/Z3GCTNW4.cjs');
+require('../__chunks/OSTQZD2E.cjs');
+require('../__chunks/VUEWHLYH.cjs');
 require('../__chunks/75KXQZJX.cjs');
 require('../__chunks/RNZNGEL4.cjs');
 require('../__chunks/OLOZ5JT2.cjs');
@@ -16,4 +16,4 @@ require('../__chunks/AV6KTKLE.cjs');
 
 
 
-exports.Checkbox = _BBS4RP44cjs.Checkbox; exports.useCheckbox = _BBS4RP44cjs.useCheckbox;
+exports.Checkbox = _2UEWAQWGcjs.Checkbox; exports.useCheckbox = _2UEWAQWGcjs.useCheckbox;

package/cjs/checkbox/checkbox.d.cts

@@ -40,18 +40,21 @@ export interface CheckboxOptions<T extends As = "input"> extends CommandOptions<
     store?: CheckboxStore;
     /**
      * The native `name` attribute.
+     *
+     * Live examples:
+     * - [MenuItemCheckbox](https://ariakit.org/examples/menu-item-checkbox)
      */
     name?: string;
     /**
      * The value of the checkbox. This is useful when the same checkbox store is
-     * used for multiple `Checkbox` elements, in which case the value will be an
-     * array of checked values.
+     * used for multiple [`Checkbox`](https://ariakit.org/reference/checkbox)
+     * elements, in which case the value will be an array of checked values.
      *
      * Live examples:
      * - [Checkbox group](https://ariakit.org/examples/checkbox-group)
      * - [MenuItemCheckbox](https://ariakit.org/examples/menu-item-checkbox)
      * @example
-     * ```jsx
+     * ```jsx "value"
      * <CheckboxProvider defaultValue={["Apple", "Orange"]}>
      *   <Checkbox value="Apple" />
      *   <Checkbox value="Orange" />
@@ -61,18 +64,20 @@ export interface CheckboxOptions<T extends As = "input"> extends CommandOptions<
      */
     value?: InputHTMLAttributes<HTMLInputElement>["value"];
     /**
-     * The default `checked` state of the checkbox. This prop is ignored if the
-     * `checked` or the `store` props are provided.
+     * The default checked state of the checkbox. This prop is ignored if the
+     * [`checked`](https://ariakit.org/reference/checkbox#checked) or the
+     * [`store`](https://ariakit.org/reference/checkbox#store) props are provided.
      */
     defaultChecked?: "mixed" | boolean;
     /**
-     * The `checked` state of the checkbox. This will override the value inferred
-     * from `store` prop, if provided. This can be `"mixed"` to indicate that the
-     * checkbox is partially checked.
+     * The checked state of the checkbox. This will override the value inferred
+     * from [`store`](https://ariakit.org/reference/checkbox#store) prop, if
+     * provided. This can be `"mixed"` to indicate that the checkbox is partially
+     * checked.
      */
     checked?: "mixed" | boolean;
     /**
-     * A function that is called when the checkbox's `checked` store changes.
+     * A function that is called when the checkbox's checked state changes.
      */
     onChange?: (event: ChangeEvent<HTMLInputElement>) => void;
 }

package/cjs/checkbox/checkbox.d.ts

@@ -40,18 +40,21 @@ export interface CheckboxOptions<T extends As = "input"> extends CommandOptions<
     store?: CheckboxStore;
     /**
      * The native `name` attribute.
+     *
+     * Live examples:
+     * - [MenuItemCheckbox](https://ariakit.org/examples/menu-item-checkbox)
      */
     name?: string;
     /**
      * The value of the checkbox. This is useful when the same checkbox store is
-     * used for multiple `Checkbox` elements, in which case the value will be an
-     * array of checked values.
+     * used for multiple [`Checkbox`](https://ariakit.org/reference/checkbox)
+     * elements, in which case the value will be an array of checked values.
      *
      * Live examples:
      * - [Checkbox group](https://ariakit.org/examples/checkbox-group)
      * - [MenuItemCheckbox](https://ariakit.org/examples/menu-item-checkbox)
      * @example
-     * ```jsx
+     * ```jsx "value"
      * <CheckboxProvider defaultValue={["Apple", "Orange"]}>
      *   <Checkbox value="Apple" />
      *   <Checkbox value="Orange" />
@@ -61,18 +64,20 @@ export interface CheckboxOptions<T extends As = "input"> extends CommandOptions<
      */
     value?: InputHTMLAttributes<HTMLInputElement>["value"];
     /**
-     * The default `checked` state of the checkbox. This prop is ignored if the
-     * `checked` or the `store` props are provided.
+     * The default checked state of the checkbox. This prop is ignored if the
+     * [`checked`](https://ariakit.org/reference/checkbox#checked) or the
+     * [`store`](https://ariakit.org/reference/checkbox#store) props are provided.
      */
     defaultChecked?: "mixed" | boolean;
     /**
-     * The `checked` state of the checkbox. This will override the value inferred
-     * from `store` prop, if provided. This can be `"mixed"` to indicate that the
-     * checkbox is partially checked.
+     * The checked state of the checkbox. This will override the value inferred
+     * from [`store`](https://ariakit.org/reference/checkbox#store) prop, if
+     * provided. This can be `"mixed"` to indicate that the checkbox is partially
+     * checked.
      */
     checked?: "mixed" | boolean;
     /**
-     * A function that is called when the checkbox's `checked` store changes.
+     * A function that is called when the checkbox's checked state changes.
      */
     onChange?: (event: ChangeEvent<HTMLInputElement>) => void;
 }

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

@@ -17,8 +17,10 @@ import type { CollectionStore } from "./collection-store.js";
 export declare const useCollectionItem: import("../utils/types.js").Hook<CollectionItemOptions<"div">>;
 /**
  * Renders an item in a collection. The collection store can be passed
- * explicitly through the `store` prop or implicitly through the parent
- * `Collection` component.
+ * explicitly through the
+ * [`store`](https://ariakit.org/reference/collection-item#store) prop or
+ * implicitly through the parent
+ * [`Collection`](https://ariakit.org/reference/collection) component.
  * @see https://ariakit.org/components/collection
  * @example
  * ```jsx
@@ -33,14 +35,27 @@ export interface CollectionItemOptions<T extends As = "div"> extends Options<T>
     /**
      * Object returned by the
      * [`useCollectionStore`](https://ariakit.org/reference/use-collection-store)
-     * hook. If not provided, the parent
+     * hook. If not provided, the closest
      * [`Collection`](https://ariakit.org/reference/collection) or
      * [`CollectionProvider`](https://ariakit.org/reference/collection-provider)
      * components' context will be used.
+     *
+     * Live examples:
+     * - [Navigation Menubar](https://ariakit.org/examples/menubar-navigation)
      */
     store?: CollectionStore;
     /**
-     * Whether the item should be registered to the store.
+     * The unique ID of the item. This will be used to register the item in the
+     * store and for the element's `id` attribute. If not provided, a unique ID
+     * will be automatically generated.
+     *
+     * Live examples:
+     * - [Combobox with tabs](https://ariakit.org/examples/combobox-tabs)
+     * - [Tab with React Router](https://ariakit.org/examples/tab-react-router)
+     */
+    id?: string;
+    /**
+     * Whether the item should be registered as part of the collection.
      *
      * Live examples:
      * - [Combobox with tabs](https://ariakit.org/examples/combobox-tabs)
@@ -48,13 +63,12 @@ export interface CollectionItemOptions<T extends As = "div"> extends Options<T>
      */
     shouldRegisterItem?: boolean;
     /**
-     * A memoized function that returns props that will be passed along with the
-     * item when it gets registered to the store.
+     * A memoized function that returns props to be passed with the item during
+     * its registration in the store.
      * @example
      * ```jsx
-     * const store = useCollectionStore();
-     * const getItem = useCallback((item) => ({ ...item, custom: true }), []);
-     * <CollectionItem store={store} getItem={getItem} />
+     * const getItem = useCallback((data) => ({ ...data, custom: true }), []);
+     * <CollectionItem getItem={getItem} />
      * ```
      */
     getItem?: (props: CollectionStoreItem) => CollectionStoreItem;

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

@@ -17,8 +17,10 @@ import type { CollectionStore } from "./collection-store.js";
 export declare const useCollectionItem: import("../utils/types.js").Hook<CollectionItemOptions<"div">>;
 /**
  * Renders an item in a collection. The collection store can be passed
- * explicitly through the `store` prop or implicitly through the parent
- * `Collection` component.
+ * explicitly through the
+ * [`store`](https://ariakit.org/reference/collection-item#store) prop or
+ * implicitly through the parent
+ * [`Collection`](https://ariakit.org/reference/collection) component.
  * @see https://ariakit.org/components/collection
  * @example
  * ```jsx
@@ -33,14 +35,27 @@ export interface CollectionItemOptions<T extends As = "div"> extends Options<T>
     /**
      * Object returned by the
      * [`useCollectionStore`](https://ariakit.org/reference/use-collection-store)
-     * hook. If not provided, the parent
+     * hook. If not provided, the closest
      * [`Collection`](https://ariakit.org/reference/collection) or
      * [`CollectionProvider`](https://ariakit.org/reference/collection-provider)
      * components' context will be used.
+     *
+     * Live examples:
+     * - [Navigation Menubar](https://ariakit.org/examples/menubar-navigation)
      */
     store?: CollectionStore;
     /**
-     * Whether the item should be registered to the store.
+     * The unique ID of the item. This will be used to register the item in the
+     * store and for the element's `id` attribute. If not provided, a unique ID
+     * will be automatically generated.
+     *
+     * Live examples:
+     * - [Combobox with tabs](https://ariakit.org/examples/combobox-tabs)
+     * - [Tab with React Router](https://ariakit.org/examples/tab-react-router)
+     */
+    id?: string;
+    /**
+     * Whether the item should be registered as part of the collection.
      *
      * Live examples:
      * - [Combobox with tabs](https://ariakit.org/examples/combobox-tabs)
@@ -48,13 +63,12 @@ export interface CollectionItemOptions<T extends As = "div"> extends Options<T>
      */
     shouldRegisterItem?: boolean;
     /**
-     * A memoized function that returns props that will be passed along with the
-     * item when it gets registered to the store.
+     * A memoized function that returns props to be passed with the item during
+     * its registration in the store.
      * @example
      * ```jsx
-     * const store = useCollectionStore();
-     * const getItem = useCallback((item) => ({ ...item, custom: true }), []);
-     * <CollectionItem store={store} getItem={getItem} />
+     * const getItem = useCallback((data) => ({ ...data, custom: true }), []);
+     * <CollectionItem getItem={getItem} />
      * ```
      */
     getItem?: (props: CollectionStoreItem) => CollectionStoreItem;

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

@@ -2,7 +2,8 @@ import type { ReactElement, ReactNode } from "react";
 import type { PickRequired } from "@ariakit/core/utils/types";
 import type { CollectionStoreItem, CollectionStoreProps } from "./collection-store.js";
 /**
- * Provides a collection store to CollectionItem components.
+ * Provides a collection store to
+ * [`CollectionItem`](https://ariakit.org/reference/collection-item) components.
  * @see https://ariakit.org/components/collection
  * @example
  * ```jsx

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

@@ -2,7 +2,8 @@ import type { ReactElement, ReactNode } from "react";
 import type { PickRequired } from "@ariakit/core/utils/types";
 import type { CollectionStoreItem, CollectionStoreProps } from "./collection-store.js";
 /**
- * Provides a collection store to CollectionItem components.
+ * Provides a collection store to
+ * [`CollectionItem`](https://ariakit.org/reference/collection-item) components.
  * @see https://ariakit.org/components/collection
  * @example
  * ```jsx

package/cjs/collection/collection-renderer.d.cts

@@ -327,7 +327,7 @@ export interface CollectionRendererOptions<T extends Item = any> {
     /**
      * Object returned by the
      * [`useCollectionStore`](https://ariakit.org/reference/use-collection-store)
-     * hook. If not provided, the parent
+     * hook. If not provided, the closest
      * [Collection](https://ariakit.org/components/collection) component's
      * context will be used.
      *

package/cjs/collection/collection-renderer.d.ts

@@ -327,7 +327,7 @@ export interface CollectionRendererOptions<T extends Item = any> {
     /**
      * Object returned by the
      * [`useCollectionStore`](https://ariakit.org/reference/use-collection-store)
-     * hook. If not provided, the parent
+     * hook. If not provided, the closest
      * [Collection](https://ariakit.org/components/collection) component's
      * context will be used.
      *

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

@@ -3,11 +3,13 @@ import type { BivariantCallback, PickRequired } from "@ariakit/core/utils/types"
 import type { Store } from "../utils/store.js";
 export declare function useCollectionStoreProps<T extends Core.CollectionStore>(store: T, update: () => void, props: CollectionStoreProps): T;
 /**
- * Creates a collection store.
+ * Creates a collection store to control
+ * [Collection](https://ariakit.org/components/collection) components.
  * @see https://ariakit.org/components/collection
  * @example
  * ```jsx
  * const collection = useCollectionStore();
+ *
  * <Collection store={collection}>
  *   <CollectionItem>Item</CollectionItem>
  *   <CollectionItem>Item</CollectionItem>
@@ -25,8 +27,9 @@ export interface CollectionStoreFunctions<T extends CollectionStoreItem = Collec
 }
 export interface CollectionStoreOptions<T extends CollectionStoreItem = CollectionStoreItem> extends Core.CollectionStoreOptions<T> {
     /**
-     * A callback that gets called when the `items` state changes.
-     * @param items The new items.
+     * A callback that gets called when the
+     * [`items`](https://ariakit.org/reference/collection-provider#items) state
+     * changes.
      * @example
      * const [items, setItems] = useState([]);
      * const collection = useCollectionStore({ items, setItems });

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

@@ -3,11 +3,13 @@ import type { BivariantCallback, PickRequired } from "@ariakit/core/utils/types"
 import type { Store } from "../utils/store.js";
 export declare function useCollectionStoreProps<T extends Core.CollectionStore>(store: T, update: () => void, props: CollectionStoreProps): T;
 /**
- * Creates a collection store.
+ * Creates a collection store to control
+ * [Collection](https://ariakit.org/components/collection) components.
  * @see https://ariakit.org/components/collection
  * @example
  * ```jsx
  * const collection = useCollectionStore();
+ *
  * <Collection store={collection}>
  *   <CollectionItem>Item</CollectionItem>
  *   <CollectionItem>Item</CollectionItem>
@@ -25,8 +27,9 @@ export interface CollectionStoreFunctions<T extends CollectionStoreItem = Collec
 }
 export interface CollectionStoreOptions<T extends CollectionStoreItem = CollectionStoreItem> extends Core.CollectionStoreOptions<T> {
     /**
-     * A callback that gets called when the `items` state changes.
-     * @param items The new items.
+     * A callback that gets called when the
+     * [`items`](https://ariakit.org/reference/collection-provider#items) state
+     * changes.
      * @example
      * const [items, setItems] = useState([]);
      * const collection = useCollectionStore({ items, setItems });

package/cjs/collection/collection.d.cts

@@ -18,9 +18,10 @@ import type { CollectionStore } from "./collection-store.js";
  */
 export declare const useCollection: import("../utils/types.js").Hook<CollectionOptions<"div">>;
 /**
- * Renders a simple wrapper for collection items. It receives the collection
- * store through the `store` prop and provides context for `CollectionItem`
- * components.
+ * Renders a simple wrapper for collection items. It accepts a collection store
+ * through the [`store`](https://ariakit.org/reference/collection#store) prop
+ * and provides context for
+ * [`CollectionItem`](https://ariakit.org/reference/collection-item) components.
  * @see https://ariakit.org/components/collection
  * @example
  * ```jsx

package/cjs/collection/collection.d.ts

@@ -18,9 +18,10 @@ import type { CollectionStore } from "./collection-store.js";
  */
 export declare const useCollection: import("../utils/types.js").Hook<CollectionOptions<"div">>;
 /**
- * Renders a simple wrapper for collection items. It receives the collection
- * store through the `store` prop and provides context for `CollectionItem`
- * components.
+ * Renders a simple wrapper for collection items. It accepts a collection store
+ * through the [`store`](https://ariakit.org/reference/collection#store) prop
+ * and provides context for
+ * [`CollectionItem`](https://ariakit.org/reference/collection-item) components.
  * @see https://ariakit.org/components/collection
  * @example
  * ```jsx

package/cjs/combobox/combobox-cancel.cjs

@@ -1,17 +1,17 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});"use client";
 
 
-var _5UTRYT6Ecjs = require('../__chunks/5UTRYT6E.cjs');
+var _REJALU3Pcjs = require('../__chunks/REJALU3P.cjs');
 
 
 var _3WCBE6SUcjs = require('../__chunks/3WCBE6SU.cjs');
-require('../__chunks/DAJUUBUI.cjs');
+require('../__chunks/OSTQZD2E.cjs');
 require('../__chunks/UZNYSPKP.cjs');
 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');
 
 
@@ -82,7 +82,7 @@ var useComboboxCancel = _RNZNGEL4cjs.createHook.call(void 0,
     }, props), {
       onClick
     });
-    props = _5UTRYT6Ecjs.useButton.call(void 0, props);
+    props = _REJALU3Pcjs.useButton.call(void 0, props);
     return props;
   }
 );

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

@@ -15,10 +15,11 @@ import type { ComboboxStore } from "./combobox-store.js";
  */
 export declare const useComboboxCancel: import("../utils/types.js").Hook<ComboboxCancelOptions<"button">>;
 /**
- * Renders a combobox cancel button that clears the combobox input when clicked.
+ * Renders a combobox cancel button that clears the combobox input value when
+ * clicked.
  * @see https://ariakit.org/components/combobox
  * @example
- * ```jsx
+ * ```jsx {3}
  * <ComboboxProvider>
  *   <Combobox />
  *   <ComboboxCancel />

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

@@ -15,10 +15,11 @@ import type { ComboboxStore } from "./combobox-store.js";
  */
 export declare const useComboboxCancel: import("../utils/types.js").Hook<ComboboxCancelOptions<"button">>;
 /**
- * Renders a combobox cancel button that clears the combobox input when clicked.
+ * Renders a combobox cancel button that clears the combobox input value when
+ * clicked.
  * @see https://ariakit.org/components/combobox
  * @example
- * ```jsx
+ * ```jsx {3}
  * <ComboboxProvider>
  *   <Combobox />
  *   <ComboboxCancel />

package/cjs/combobox/combobox-disclosure.cjs

@@ -1,19 +1,19 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});"use client";
 
 
-var _QCG6J6X5cjs = require('../__chunks/QCG6J6X5.cjs');
-require('../__chunks/LFHNPG2L.cjs');
-require('../__chunks/5UTRYT6E.cjs');
+var _NLVGDNPEcjs = require('../__chunks/NLVGDNPE.cjs');
+require('../__chunks/2FTVUUOK.cjs');
+require('../__chunks/REJALU3P.cjs');
 
 
 var _3WCBE6SUcjs = require('../__chunks/3WCBE6SU.cjs');
-require('../__chunks/DAJUUBUI.cjs');
+require('../__chunks/OSTQZD2E.cjs');
 require('../__chunks/UZNYSPKP.cjs');
 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');
 
 
@@ -85,7 +85,7 @@ var useComboboxDisclosure = _RNZNGEL4cjs.createHook.call(void 0,
       onMouseDown,
       onClick
     });
-    props = _QCG6J6X5cjs.useDialogDisclosure.call(void 0, _AV6KTKLEcjs.__spreadValues.call(void 0, { store }, props));
+    props = _NLVGDNPEcjs.useDialogDisclosure.call(void 0, _AV6KTKLEcjs.__spreadValues.call(void 0, { store }, props));
     return props;
   }
 );

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

@@ -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 />