@ariakit/core 0.3.9 → 0.3.11

package/cjs/toolbar/toolbar-store.cjs

@@ -1,12 +1,12 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});"use client";
 
 
-var _JNFZSNOIcjs = require('../__chunks/JNFZSNOI.cjs');
-require('../__chunks/UCLKUBNP.cjs');
-require('../__chunks/2UK5WUJX.cjs');
+var _BFE5R4EZcjs = require('../__chunks/BFE5R4EZ.cjs');
+require('../__chunks/MI6NUQYQ.cjs');
+require('../__chunks/F6HPKLO2.cjs');
 
 
-var _3UT5FE6Kcjs = require('../__chunks/3UT5FE6K.cjs');
+var _KBNYGXWIcjs = require('../__chunks/KBNYGXWI.cjs');
 require('../__chunks/5F4DVUNS.cjs');
 require('../__chunks/ULSPM3Y3.cjs');
 
@@ -18,13 +18,13 @@ var _AV6KTKLEcjs = require('../__chunks/AV6KTKLE.cjs');
 function createToolbarStore(props = {}) {
   var _a;
   const syncState = (_a = props.store) == null ? void 0 : _a.getState();
-  return _JNFZSNOIcjs.createCompositeStore.call(void 0, _AV6KTKLEcjs.__spreadProps.call(void 0, _AV6KTKLEcjs.__spreadValues.call(void 0, {}, props), {
-    orientation: _3UT5FE6Kcjs.defaultValue.call(void 0, 
+  return _BFE5R4EZcjs.createCompositeStore.call(void 0, _AV6KTKLEcjs.__spreadProps.call(void 0, _AV6KTKLEcjs.__spreadValues.call(void 0, {}, props), {
+    orientation: _KBNYGXWIcjs.defaultValue.call(void 0, 
       props.orientation,
       syncState == null ? void 0 : syncState.orientation,
       "horizontal"
     ),
-    focusLoop: _3UT5FE6Kcjs.defaultValue.call(void 0, props.focusLoop, syncState == null ? void 0 : syncState.focusLoop, true)
+    focusLoop: _KBNYGXWIcjs.defaultValue.call(void 0, props.focusLoop, syncState == null ? void 0 : syncState.focusLoop, true)
   }));
 }
 

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

@@ -5,13 +5,9 @@ import type { Store, StoreOptions, StoreProps } from "../utils/store.js";
  */
 export declare function createToolbarStore(props?: ToolbarStoreProps): ToolbarStore;
 export interface ToolbarStoreState extends CompositeStoreState {
-    /**
-     * @default "horizontal"
-     */
+    /** @default "horizontal" */
     orientation: CompositeStoreState["orientation"];
-    /**
-     * @default true
-     */
+    /** @default true */
     focusLoop: CompositeStoreState["focusLoop"];
 }
 export interface ToolbarStoreFunctions extends CompositeStoreFunctions {

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

@@ -5,13 +5,9 @@ import type { Store, StoreOptions, StoreProps } from "../utils/store.js";
  */
 export declare function createToolbarStore(props?: ToolbarStoreProps): ToolbarStore;
 export interface ToolbarStoreState extends CompositeStoreState {
-    /**
-     * @default "horizontal"
-     */
+    /** @default "horizontal" */
     orientation: CompositeStoreState["orientation"];
-    /**
-     * @default true
-     */
+    /** @default true */
     focusLoop: CompositeStoreState["focusLoop"];
 }
 export interface ToolbarStoreFunctions extends CompositeStoreFunctions {

package/cjs/tooltip/tooltip-store.cjs

@@ -1,16 +1,16 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});"use client";
 
 
-var _5SIVMOIDcjs = require('../__chunks/5SIVMOID.cjs');
-require('../__chunks/EFIT5L4X.cjs');
-require('../__chunks/2LS4JJ4S.cjs');
-require('../__chunks/GJFZ5ZPP.cjs');
+var _TQTGWD5Kcjs = require('../__chunks/TQTGWD5K.cjs');
+require('../__chunks/E53JW5BD.cjs');
+require('../__chunks/I3Y4EXEF.cjs');
+require('../__chunks/OTVLDMN2.cjs');
 
 
-var _2UK5WUJXcjs = require('../__chunks/2UK5WUJX.cjs');
+var _F6HPKLO2cjs = require('../__chunks/F6HPKLO2.cjs');
 
 
-var _3UT5FE6Kcjs = require('../__chunks/3UT5FE6K.cjs');
+var _KBNYGXWIcjs = require('../__chunks/KBNYGXWI.cjs');
 
 
 
@@ -20,19 +20,19 @@ var _AV6KTKLEcjs = require('../__chunks/AV6KTKLE.cjs');
 function createTooltipStore(props = {}) {
   var _a;
   const syncState = (_a = props.store) == null ? void 0 : _a.getState();
-  const hovercard = _5SIVMOIDcjs.createHovercardStore.call(void 0, _AV6KTKLEcjs.__spreadProps.call(void 0, _AV6KTKLEcjs.__spreadValues.call(void 0, {}, props), {
-    placement: _3UT5FE6Kcjs.defaultValue.call(void 0, 
+  const hovercard = _TQTGWD5Kcjs.createHovercardStore.call(void 0, _AV6KTKLEcjs.__spreadProps.call(void 0, _AV6KTKLEcjs.__spreadValues.call(void 0, {}, props), {
+    placement: _KBNYGXWIcjs.defaultValue.call(void 0, 
       props.placement,
       syncState == null ? void 0 : syncState.placement,
       "top"
     ),
-    hideTimeout: _3UT5FE6Kcjs.defaultValue.call(void 0, props.hideTimeout, syncState == null ? void 0 : syncState.hideTimeout, 0)
+    hideTimeout: _KBNYGXWIcjs.defaultValue.call(void 0, props.hideTimeout, syncState == null ? void 0 : syncState.hideTimeout, 0)
   }));
   const initialState = _AV6KTKLEcjs.__spreadProps.call(void 0, _AV6KTKLEcjs.__spreadValues.call(void 0, {}, hovercard.getState()), {
-    type: _3UT5FE6Kcjs.defaultValue.call(void 0, props.type, syncState == null ? void 0 : syncState.type, "description"),
-    skipTimeout: _3UT5FE6Kcjs.defaultValue.call(void 0, props.skipTimeout, syncState == null ? void 0 : syncState.skipTimeout, 300)
+    type: _KBNYGXWIcjs.defaultValue.call(void 0, props.type, syncState == null ? void 0 : syncState.type, "description"),
+    skipTimeout: _KBNYGXWIcjs.defaultValue.call(void 0, props.skipTimeout, syncState == null ? void 0 : syncState.skipTimeout, 300)
   });
-  const tooltip = _2UK5WUJXcjs.createStore.call(void 0, initialState, hovercard, props.store);
+  const tooltip = _F6HPKLO2cjs.createStore.call(void 0, initialState, hovercard, props.store);
   return _AV6KTKLEcjs.__spreadValues.call(void 0, _AV6KTKLEcjs.__spreadValues.call(void 0, {}, hovercard), tooltip);
 }
 

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

@@ -5,9 +5,15 @@ import type { Store, StoreOptions, StoreProps } from "../utils/store.js";
  */
 export declare function createTooltipStore(props?: TooltipStoreProps): TooltipStore;
 export interface TooltipStoreState extends HovercardStoreState {
+    /** @default "top" */
+    placement: HovercardStoreState["placement"];
+    /** @default 0 */
+    hideTimeout?: HovercardStoreState["hideTimeout"];
     /**
      * Determines whether the tooltip is being used as a label or a description
      * for the anchor element.
+     * @deprecated Render a visually hidden label or use the `aria-label` or
+     * `aria-labelledby` attributes on the anchor element instead.
      * @default "description"
      */
     type: "label" | "description";
@@ -17,10 +23,6 @@ export interface TooltipStoreState extends HovercardStoreState {
      * @default 300
      */
     skipTimeout: number;
-    /** @default "top" */
-    placement: HovercardStoreState["placement"];
-    /** @default 0 */
-    hideTimeout?: HovercardStoreState["hideTimeout"];
 }
 export type TooltipStoreFunctions = HovercardStoreFunctions;
 export interface TooltipStoreOptions extends HovercardStoreOptions, StoreOptions<TooltipStoreState, "type" | "placement" | "timeout" | "showTimeout" | "hideTimeout" | "skipTimeout"> {

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

@@ -5,9 +5,15 @@ import type { Store, StoreOptions, StoreProps } from "../utils/store.js";
  */
 export declare function createTooltipStore(props?: TooltipStoreProps): TooltipStore;
 export interface TooltipStoreState extends HovercardStoreState {
+    /** @default "top" */
+    placement: HovercardStoreState["placement"];
+    /** @default 0 */
+    hideTimeout?: HovercardStoreState["hideTimeout"];
     /**
      * Determines whether the tooltip is being used as a label or a description
      * for the anchor element.
+     * @deprecated Render a visually hidden label or use the `aria-label` or
+     * `aria-labelledby` attributes on the anchor element instead.
      * @default "description"
      */
     type: "label" | "description";
@@ -17,10 +23,6 @@ export interface TooltipStoreState extends HovercardStoreState {
      * @default 300
      */
     skipTimeout: number;
-    /** @default "top" */
-    placement: HovercardStoreState["placement"];
-    /** @default 0 */
-    hideTimeout?: HovercardStoreState["hideTimeout"];
 }
 export type TooltipStoreFunctions = HovercardStoreFunctions;
 export interface TooltipStoreOptions extends HovercardStoreOptions, StoreOptions<TooltipStoreState, "type" | "placement" | "timeout" | "showTimeout" | "hideTimeout" | "skipTimeout"> {

package/cjs/utils/misc.cjs

@@ -20,7 +20,7 @@
 
 
 
-var _3UT5FE6Kcjs = require('../__chunks/3UT5FE6K.cjs');
+var _KBNYGXWIcjs = require('../__chunks/KBNYGXWI.cjs');
 require('../__chunks/AV6KTKLE.cjs');
 
 
@@ -43,4 +43,4 @@ require('../__chunks/AV6KTKLE.cjs');
 
 
 
-exports.afterPaint = _3UT5FE6Kcjs.afterPaint; exports.applyState = _3UT5FE6Kcjs.applyState; exports.beforePaint = _3UT5FE6Kcjs.beforePaint; exports.chain = _3UT5FE6Kcjs.chain; exports.cx = _3UT5FE6Kcjs.cx; exports.defaultValue = _3UT5FE6Kcjs.defaultValue; exports.disabledFromProps = _3UT5FE6Kcjs.disabledFromProps; exports.getKeys = _3UT5FE6Kcjs.getKeys; exports.hasOwnProperty = _3UT5FE6Kcjs.hasOwnProperty; exports.identity = _3UT5FE6Kcjs.identity; exports.invariant = _3UT5FE6Kcjs.invariant; exports.isEmpty = _3UT5FE6Kcjs.isEmpty; exports.isFalsyBooleanCallback = _3UT5FE6Kcjs.isFalsyBooleanCallback; exports.isInteger = _3UT5FE6Kcjs.isInteger; exports.isObject = _3UT5FE6Kcjs.isObject; exports.noop = _3UT5FE6Kcjs.noop; exports.normalizeString = _3UT5FE6Kcjs.normalizeString; exports.omit = _3UT5FE6Kcjs.omit; exports.pick = _3UT5FE6Kcjs.pick; exports.shallowEqual = _3UT5FE6Kcjs.shallowEqual;
+exports.afterPaint = _KBNYGXWIcjs.afterPaint; exports.applyState = _KBNYGXWIcjs.applyState; exports.beforePaint = _KBNYGXWIcjs.beforePaint; exports.chain = _KBNYGXWIcjs.chain; exports.cx = _KBNYGXWIcjs.cx; exports.defaultValue = _KBNYGXWIcjs.defaultValue; exports.disabledFromProps = _KBNYGXWIcjs.disabledFromProps; exports.getKeys = _KBNYGXWIcjs.getKeys; exports.hasOwnProperty = _KBNYGXWIcjs.hasOwnProperty; exports.identity = _KBNYGXWIcjs.identity; exports.invariant = _KBNYGXWIcjs.invariant; exports.isEmpty = _KBNYGXWIcjs.isEmpty; exports.isFalsyBooleanCallback = _KBNYGXWIcjs.isFalsyBooleanCallback; exports.isInteger = _KBNYGXWIcjs.isInteger; exports.isObject = _KBNYGXWIcjs.isObject; exports.noop = _KBNYGXWIcjs.noop; exports.normalizeString = _KBNYGXWIcjs.normalizeString; exports.omit = _KBNYGXWIcjs.omit; exports.pick = _KBNYGXWIcjs.pick; exports.shallowEqual = _KBNYGXWIcjs.shallowEqual;

package/cjs/utils/store.cjs

@@ -10,8 +10,8 @@
 
 
 
-var _2UK5WUJXcjs = require('../__chunks/2UK5WUJX.cjs');
-require('../__chunks/3UT5FE6K.cjs');
+var _F6HPKLO2cjs = require('../__chunks/F6HPKLO2.cjs');
+require('../__chunks/KBNYGXWI.cjs');
 require('../__chunks/AV6KTKLE.cjs');
 
 
@@ -24,4 +24,4 @@ require('../__chunks/AV6KTKLE.cjs');
 
 
 
-exports.batch = _2UK5WUJXcjs.batch; exports.createStore = _2UK5WUJXcjs.createStore; exports.init = _2UK5WUJXcjs.init; exports.mergeStore = _2UK5WUJXcjs.mergeStore; exports.omit = _2UK5WUJXcjs.omit; exports.pick = _2UK5WUJXcjs.pick; exports.setup = _2UK5WUJXcjs.setup; exports.subscribe = _2UK5WUJXcjs.subscribe; exports.sync = _2UK5WUJXcjs.sync; exports.throwOnConflictingProps = _2UK5WUJXcjs.throwOnConflictingProps;
+exports.batch = _F6HPKLO2cjs.batch; exports.createStore = _F6HPKLO2cjs.createStore; exports.init = _F6HPKLO2cjs.init; exports.mergeStore = _F6HPKLO2cjs.mergeStore; exports.omit = _F6HPKLO2cjs.omit; exports.pick = _F6HPKLO2cjs.pick; exports.setup = _F6HPKLO2cjs.setup; exports.subscribe = _F6HPKLO2cjs.subscribe; exports.sync = _F6HPKLO2cjs.sync; exports.throwOnConflictingProps = _F6HPKLO2cjs.throwOnConflictingProps;

package/esm/__chunks/{TLN4ALYH.js → 22K762VQ.js}

@@ -5,11 +5,11 @@ import {
   init,
   setup,
   throwOnConflictingProps
-} from "./A2J4XZ5T.js";
+} from "./EAHJFCU4.js";
 import {
   chain,
   defaultValue
-} from "./I2VQ3XGR.js";
+} from "./Y3OOHFCN.js";
 import {
   getDocument
 } from "./DLOEKDPY.js";
@@ -84,21 +84,29 @@ function createCollectionStore(props = {}) {
   };
   const syncPrivateStore = getPrivateStore(props.store);
   const privateStore = createStore(
-    { renderedItems: initialState.renderedItems },
+    { items, renderedItems: initialState.renderedItems },
     syncPrivateStore
   );
   const collection = createStore(initialState, props.store);
+  const sortItems = (renderedItems) => {
+    const sortedItems = sortBasedOnDOMPosition(renderedItems);
+    privateStore.setState("renderedItems", sortedItems);
+    collection.setState("renderedItems", sortedItems);
+  };
   setup(collection, () => init(privateStore));
+  setup(privateStore, () => {
+    return batch(privateStore, ["items"], (state) => {
+      collection.setState("items", state.items);
+    });
+  });
   setup(privateStore, () => {
     return batch(privateStore, ["renderedItems"], (state) => {
       let firstRun = true;
-      const raf = requestAnimationFrame(() => {
+      let raf = requestAnimationFrame(() => {
         const { renderedItems } = collection.getState();
         if (state.renderedItems === renderedItems)
           return;
-        const sortedItems = sortBasedOnDOMPosition(state.renderedItems);
-        privateStore.setState("renderedItems", sortedItems);
-        collection.setState("renderedItems", sortedItems);
+        sortItems(state.renderedItems);
       });
       if (typeof IntersectionObserver !== "function") {
         return () => cancelAnimationFrame(raf);
@@ -108,7 +116,8 @@ function createCollectionStore(props = {}) {
           firstRun = false;
           return;
         }
-        privateStore.setState("renderedItems", [...state.renderedItems]);
+        cancelAnimationFrame(raf);
+        raf = requestAnimationFrame(() => sortItems(state.renderedItems));
       };
       const root = getCommonParent(state.renderedItems);
       const observer = new IntersectionObserver(ioCallback, { root });
@@ -158,7 +167,11 @@ function createCollectionStore(props = {}) {
     };
     return unmergeItem;
   };
-  const registerItem = (item) => mergeItem(item, (getItems) => collection.setState("items", getItems), true);
+  const registerItem = (item) => mergeItem(
+    item,
+    (getItems) => privateStore.setState("items", getItems),
+    true
+  );
   return __spreadProps(__spreadValues({}, collection), {
     registerItem,
     renderItem: (item) => chain(

package/esm/__chunks/{J6JIOWCS.js → AF6IUUFN.js}

@@ -1,16 +1,16 @@
 "use client";
 import {
   createDialogStore
-} from "./LT2OYWRD.js";
+} from "./SX2XFD6A.js";
 import {
   createStore,
   mergeStore,
   omit,
   throwOnConflictingProps
-} from "./A2J4XZ5T.js";
+} from "./EAHJFCU4.js";
 import {
   defaultValue
-} from "./I2VQ3XGR.js";
+} from "./Y3OOHFCN.js";
 import {
   __objRest,
   __spreadProps,

package/esm/__chunks/{A2J4XZ5T.js → EAHJFCU4.js}

@@ -8,7 +8,7 @@ import {
   noop,
   omit,
   pick
-} from "./I2VQ3XGR.js";
+} from "./Y3OOHFCN.js";
 import {
   __spreadProps,
   __spreadValues
@@ -37,8 +37,6 @@ function createStore(initialState, ...stores) {
     return () => setups.delete(callback);
   };
   const storeInit = () => {
-    if (!stores.length)
-      return noop;
     const initialized = instances.size;
     const instance = Symbol();
     instances.add(instance);

package/esm/__chunks/{DLX2AS6C.js → IERTEJ3A.js}

@@ -1,15 +1,15 @@
 "use client";
 import {
   createCollectionStore
-} from "./TLN4ALYH.js";
+} from "./22K762VQ.js";
 import {
   createStore,
   setup,
   sync
-} from "./A2J4XZ5T.js";
+} from "./EAHJFCU4.js";
 import {
   defaultValue
-} from "./I2VQ3XGR.js";
+} from "./Y3OOHFCN.js";
 import {
   flatten2DArray,
   reverseArray

package/esm/__chunks/{T3DVYGXI.js → SOLWE6E5.js}

@@ -1,13 +1,13 @@
 "use client";
 import {
   createPopoverStore
-} from "./J6JIOWCS.js";
+} from "./AF6IUUFN.js";
 import {
   createStore
-} from "./A2J4XZ5T.js";
+} from "./EAHJFCU4.js";
 import {
   defaultValue
-} from "./I2VQ3XGR.js";
+} from "./Y3OOHFCN.js";
 import {
   __spreadProps,
   __spreadValues

package/esm/__chunks/{LT2OYWRD.js → SX2XFD6A.js}

@@ -1,7 +1,7 @@
 "use client";
 import {
   createDisclosureStore
-} from "./NKLTHWCR.js";
+} from "./Z5IGYIPT.js";
 
 // src/dialog/dialog-store.ts
 function createDialogStore(props = {}) {

package/esm/__chunks/{EZ2TTBAQ.js → XU3EOSCU.js}

@@ -1,13 +1,13 @@
 "use client";
 import {
   createCompositeStore
-} from "./DLX2AS6C.js";
+} from "./IERTEJ3A.js";
 import {
   createStore
-} from "./A2J4XZ5T.js";
+} from "./EAHJFCU4.js";
 import {
   defaultValue
-} from "./I2VQ3XGR.js";
+} from "./Y3OOHFCN.js";
 import {
   __spreadProps,
   __spreadValues

package/esm/__chunks/{I2VQ3XGR.js → Y3OOHFCN.js}

@@ -63,6 +63,9 @@ function isInteger(arg) {
   return String(Math.floor(Number(arg))) === arg;
 }
 function hasOwnProperty(object, prop) {
+  if (typeof Object.hasOwn === "function") {
+    return Object.hasOwn(object, prop);
+  }
   return Object.prototype.hasOwnProperty.call(object, prop);
 }
 function chain(...fns) {

package/esm/__chunks/{NKLTHWCR.js → Z5IGYIPT.js}

@@ -7,10 +7,10 @@ import {
   subscribe,
   sync,
   throwOnConflictingProps
-} from "./A2J4XZ5T.js";
+} from "./EAHJFCU4.js";
 import {
   defaultValue
-} from "./I2VQ3XGR.js";
+} from "./Y3OOHFCN.js";
 import {
   __spreadProps,
   __spreadValues

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

@@ -17,7 +17,8 @@ export interface CheckboxStoreState<T extends CheckboxStoreValue = CheckboxStore
 }
 export interface CheckboxStoreFunctions<T extends CheckboxStoreValue = CheckboxStoreValue> {
     /**
-     * Sets the `value` state.
+     * Sets the [`value`](https://ariakit.org/reference/checkbox-provider#value)
+     * state.
      * @example
      * store.setValue(true);
      * store.setValue((value) => !value);
@@ -26,7 +27,9 @@ export interface CheckboxStoreFunctions<T extends CheckboxStoreValue = CheckboxS
 }
 export interface CheckboxStoreOptions<T extends CheckboxStoreValue = CheckboxStoreValue> extends StoreOptions<CheckboxStoreState<T>, "value"> {
     /**
-     * The default value of the checkbox.
+     * The default
+     * [`value`](https://ariakit.org/reference/checkbox-provider#value) state of
+     * the checkbox.
      *
      * Live examples:
      * - [Custom Checkbox](https://ariakit.org/examples/checkbox-custom)

package/esm/checkbox/checkbox-store.js

@@ -2,10 +2,10 @@
 import {
   createStore,
   throwOnConflictingProps
-} from "../__chunks/A2J4XZ5T.js";
+} from "../__chunks/EAHJFCU4.js";
 import {
   defaultValue
-} from "../__chunks/I2VQ3XGR.js";
+} from "../__chunks/Y3OOHFCN.js";
 import {
   __spreadProps,
   __spreadValues

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

@@ -16,16 +16,18 @@ export interface CollectionStoreItem {
 }
 export interface CollectionStoreState<T extends CollectionStoreItem = CollectionStoreItem> {
     /**
-     * Lists all the items with their meta data. This state is automatically
-     * updated when an item is registered or unregistered with the `registerItem`
+     * Lists all items along with their metadata. This state is automatically
+     * updated when an item is registered or unregistered using the
+     * [`registerItem`](https://ariakit.org/reference/use-collection-store#registeritem)
      * function.
      */
     items: T[];
     /**
-     * Lists all the items that are currently rendered. This state is
-     * automatically updated when an item is rendered or unrendered with the
-     * `renderItem` function. This state is also automatically sorted based on
-     * their DOM position.
+     * Lists all items, along with their metadata, in the exact order they appear in
+     * the DOM. This state is automatically updated when an item is rendered or
+     * unmounted using the
+     * [`renderItem`](https://ariakit.org/reference/use-collection-store#renderitem)
+     * function.
      */
     renderedItems: T[];
 }
@@ -33,7 +35,6 @@ export interface CollectionStoreFunctions<T extends CollectionStoreItem = Collec
     /**
      * Registers an item in the collection. This function returns a cleanup
      * function that unregisters the item.
-     * @param item The item to register.
      * @example
      * const unregisterItem = store.registerItem({ id: "item-1" });
      * // on cleanup
@@ -42,8 +43,7 @@ export interface CollectionStoreFunctions<T extends CollectionStoreItem = Collec
     registerItem: BivariantCallback<(item: T) => () => void>;
     /**
      * Renders an item in the collection. This function returns a cleanup function
-     * that unrenders the item.
-     * @param item The item to render.
+     * that unmounts the item.
      * @example
      * const unrenderItem = store.renderItem({ id: "item-1" });
      * // on cleanup
@@ -52,7 +52,6 @@ export interface CollectionStoreFunctions<T extends CollectionStoreItem = Collec
     renderItem: BivariantCallback<(item: T) => () => void>;
     /**
      * Gets an item by its id.
-     * @param id The id of the item.
      * @example
      * const item = store.item("item-1");
      */
@@ -60,7 +59,8 @@ export interface CollectionStoreFunctions<T extends CollectionStoreItem = Collec
 }
 export interface CollectionStoreOptions<T extends CollectionStoreItem = CollectionStoreItem> extends StoreOptions<CollectionStoreState<T>, "items"> {
     /**
-     * The defaut value for the `items` state.
+     * The defaut value for the
+     * [`items`](https://ariakit.org/reference/collection-provider#items) state.
      * @default []
      */
     defaultItems?: CollectionStoreState<T>["items"];

package/esm/collection/collection-store.js

@@ -1,9 +1,9 @@
 "use client";
 import {
   createCollectionStore
-} from "../__chunks/TLN4ALYH.js";
-import "../__chunks/A2J4XZ5T.js";
-import "../__chunks/I2VQ3XGR.js";
+} from "../__chunks/22K762VQ.js";
+import "../__chunks/EAHJFCU4.js";
+import "../__chunks/Y3OOHFCN.js";
 import "../__chunks/DLOEKDPY.js";
 import "../__chunks/4R3V3JGP.js";
 export {

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

@@ -32,7 +32,9 @@ export interface ComboboxStoreState<T extends ComboboxStoreSelectedValue = Combo
      */
     value: string;
     /**
-     * The value of the current active item.
+     * The value of the currently active item. This state automatically updates as
+     * the user navigates the combobox items either by keyboard or mouse click.
+     * Note that it doesn't update when the user simply hovers over the items.
      */
     activeValue: string | undefined;
     /**

package/esm/combobox/combobox-store.js

@@ -1,23 +1,23 @@
 "use client";
 import {
   createPopoverStore
-} from "../__chunks/J6JIOWCS.js";
-import "../__chunks/LT2OYWRD.js";
-import "../__chunks/NKLTHWCR.js";
+} from "../__chunks/AF6IUUFN.js";
+import "../__chunks/SX2XFD6A.js";
+import "../__chunks/Z5IGYIPT.js";
 import {
   createCompositeStore
-} from "../__chunks/DLX2AS6C.js";
-import "../__chunks/TLN4ALYH.js";
+} from "../__chunks/IERTEJ3A.js";
+import "../__chunks/22K762VQ.js";
 import {
   batch,
   createStore,
   setup,
   sync,
   throwOnConflictingProps
-} from "../__chunks/A2J4XZ5T.js";
+} from "../__chunks/EAHJFCU4.js";
 import {
   defaultValue
-} from "../__chunks/I2VQ3XGR.js";
+} from "../__chunks/Y3OOHFCN.js";
 import {
   isSafari,
   isTouchDevice

package/esm/composite/composite-overflow-store.js

@@ -1,11 +1,11 @@
 "use client";
 import {
   createPopoverStore
-} from "../__chunks/J6JIOWCS.js";
-import "../__chunks/LT2OYWRD.js";
-import "../__chunks/NKLTHWCR.js";
-import "../__chunks/A2J4XZ5T.js";
-import "../__chunks/I2VQ3XGR.js";
+} from "../__chunks/AF6IUUFN.js";
+import "../__chunks/SX2XFD6A.js";
+import "../__chunks/Z5IGYIPT.js";
+import "../__chunks/EAHJFCU4.js";
+import "../__chunks/Y3OOHFCN.js";
 import "../__chunks/4R3V3JGP.js";
 
 // src/composite/composite-overflow-store.ts