@ariakit/react-core 0.3.11 → 0.3.13

package/cjs/checkbox/checkbox-provider.cjs

@@ -1,12 +1,12 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});"use client";
 
 
-var _63UPRTFZcjs = require('../__chunks/63UPRTFZ.cjs');
+var _VPQQSYH7cjs = require('../__chunks/VPQQSYH7.cjs');
 
 
-var _VSDH37LIcjs = require('../__chunks/VSDH37LI.cjs');
+var _63UPRTFZcjs = require('../__chunks/63UPRTFZ.cjs');
 require('../__chunks/RNZNGEL4.cjs');
-require('../__chunks/B233QVZE.cjs');
+require('../__chunks/OLOZ5JT2.cjs');
 require('../__chunks/EO6LS72H.cjs');
 require('../__chunks/CJDHQUBR.cjs');
 require('../__chunks/AV6KTKLE.cjs');
@@ -14,7 +14,7 @@ require('../__chunks/AV6KTKLE.cjs');
 // src/checkbox/checkbox-provider.tsx
 var _jsxruntime = require('react/jsx-runtime');
 function CheckboxProvider(props = {}) {
-  const store = _VSDH37LIcjs.useCheckboxStore.call(void 0, props);
+  const store = _VPQQSYH7cjs.useCheckboxStore.call(void 0, props);
   return /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _63UPRTFZcjs.CheckboxContextProvider, { value: store, children: props.children });
 }
 

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.cjs

@@ -2,12 +2,12 @@
 
 
 
-var _VSDH37LIcjs = require('../__chunks/VSDH37LI.cjs');
-require('../__chunks/B233QVZE.cjs');
+var _VPQQSYH7cjs = require('../__chunks/VPQQSYH7.cjs');
+require('../__chunks/OLOZ5JT2.cjs');
 require('../__chunks/EO6LS72H.cjs');
 require('../__chunks/CJDHQUBR.cjs');
 require('../__chunks/AV6KTKLE.cjs');
 
 
 
-exports.useCheckboxStore = _VSDH37LIcjs.useCheckboxStore; exports.useCheckboxStoreProps = _VSDH37LIcjs.useCheckboxStoreProps;
+exports.useCheckboxStore = _VPQQSYH7cjs.useCheckboxStore; exports.useCheckboxStoreProps = _VPQQSYH7cjs.useCheckboxStoreProps;

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,18 +2,18 @@
 
 
 
-var _KQUC6RXTcjs = require('../__chunks/KQUC6RXT.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/B233QVZE.cjs');
+require('../__chunks/OLOZ5JT2.cjs');
 require('../__chunks/EO6LS72H.cjs');
 require('../__chunks/CJDHQUBR.cjs');
 require('../__chunks/AV6KTKLE.cjs');
 
 
 
-exports.Checkbox = _KQUC6RXTcjs.Checkbox; exports.useCheckbox = _KQUC6RXTcjs.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
@@ -31,23 +33,42 @@ export declare const useCollectionItem: import("../utils/types.js").Hook<Collect
 export declare const CollectionItem: import("../utils/types.js").Component<CollectionItemOptions<"div">>;
 export interface CollectionItemOptions<T extends As = "div"> extends Options<T> {
     /**
-     * Object returned by the `useCollectionStore` hook. If not provided, the
-     * parent `Collection` component's context will be used.
+     * Object returned by the
+     * [`useCollectionStore`](https://ariakit.org/reference/use-collection-store)
+     * 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)
      * @default true
      */
     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
@@ -31,23 +33,42 @@ export declare const useCollectionItem: import("../utils/types.js").Hook<Collect
 export declare const CollectionItem: import("../utils/types.js").Component<CollectionItemOptions<"div">>;
 export interface CollectionItemOptions<T extends As = "div"> extends Options<T> {
     /**
-     * Object returned by the `useCollectionStore` hook. If not provided, the
-     * parent `Collection` component's context will be used.
+     * Object returned by the
+     * [`useCollectionStore`](https://ariakit.org/reference/use-collection-store)
+     * 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)
      * @default true
      */
     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.cjs

@@ -1,12 +1,12 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});"use client";
 
 
-var _DKOWT2IJcjs = require('../__chunks/DKOWT2IJ.cjs');
+var _CDNJPIEGcjs = require('../__chunks/CDNJPIEG.cjs');
 
 
 var _BZTDJIVTcjs = require('../__chunks/BZTDJIVT.cjs');
 require('../__chunks/RNZNGEL4.cjs');
-require('../__chunks/B233QVZE.cjs');
+require('../__chunks/OLOZ5JT2.cjs');
 require('../__chunks/EO6LS72H.cjs');
 require('../__chunks/CJDHQUBR.cjs');
 require('../__chunks/AV6KTKLE.cjs');
@@ -14,7 +14,7 @@ require('../__chunks/AV6KTKLE.cjs');
 // src/collection/collection-provider.tsx
 var _jsxruntime = require('react/jsx-runtime');
 function CollectionProvider(props = {}) {
-  const store = _DKOWT2IJcjs.useCollectionStore.call(void 0, props);
+  const store = _CDNJPIEGcjs.useCollectionStore.call(void 0, props);
   return /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _BZTDJIVTcjs.CollectionContextProvider, { value: store, children: props.children });
 }
 

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.cjs

@@ -4,10 +4,10 @@
 
 
 
-var _T5G6DLC6cjs = require('../__chunks/T5G6DLC6.cjs');
+var _6LVRCU4Jcjs = require('../__chunks/6LVRCU4J.cjs');
 require('../__chunks/BZTDJIVT.cjs');
 require('../__chunks/RNZNGEL4.cjs');
-require('../__chunks/B233QVZE.cjs');
+require('../__chunks/OLOZ5JT2.cjs');
 require('../__chunks/EO6LS72H.cjs');
 require('../__chunks/CJDHQUBR.cjs');
 require('../__chunks/AV6KTKLE.cjs');
@@ -16,4 +16,4 @@ require('../__chunks/AV6KTKLE.cjs');
 
 
 
-exports.CollectionRenderer = _T5G6DLC6cjs.CollectionRenderer; exports.getCollectionRendererItem = _T5G6DLC6cjs.getCollectionRendererItem; exports.getCollectionRendererItemId = _T5G6DLC6cjs.getCollectionRendererItemId; exports.useCollectionRenderer = _T5G6DLC6cjs.useCollectionRenderer;
+exports.CollectionRenderer = _6LVRCU4Jcjs.CollectionRenderer; exports.getCollectionRendererItem = _6LVRCU4Jcjs.getCollectionRendererItem; exports.getCollectionRendererItemId = _6LVRCU4Jcjs.getCollectionRendererItemId; exports.useCollectionRenderer = _6LVRCU4Jcjs.useCollectionRenderer;

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.cjs

@@ -2,12 +2,12 @@
 
 
 
-var _DKOWT2IJcjs = require('../__chunks/DKOWT2IJ.cjs');
-require('../__chunks/B233QVZE.cjs');
+var _CDNJPIEGcjs = require('../__chunks/CDNJPIEG.cjs');
+require('../__chunks/OLOZ5JT2.cjs');
 require('../__chunks/EO6LS72H.cjs');
 require('../__chunks/CJDHQUBR.cjs');
 require('../__chunks/AV6KTKLE.cjs');
 
 
 
-exports.useCollectionStore = _DKOWT2IJcjs.useCollectionStore; exports.useCollectionStoreProps = _DKOWT2IJcjs.useCollectionStoreProps;
+exports.useCollectionStore = _CDNJPIEGcjs.useCollectionStore; exports.useCollectionStoreProps = _CDNJPIEGcjs.useCollectionStoreProps;

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