@ariakit/core 0.3.9 → 0.3.10

package/CHANGELOG.md

@@ -1,5 +1,10 @@
 # @ariakit/core
 
+## 0.3.10
+
+- Fixed [`CompositeItem`](https://ariakit.org/reference/composite-item) triggering blur on focus.
+- Improved JSDocs.
+
 ## 0.3.9
 
 - Fixed `Maximum update depth exceeded` warning when rendering multiple collection items on the page.

package/cjs/__chunks/{2UK5WUJX.cjs → 5CBCKBZ2.cjs}

@@ -37,8 +37,6 @@ function createStore(initialState, ...stores) {
     return () => setups.delete(callback);
   };
   const storeInit = () => {
-    if (!stores.length)
-      return _3UT5FE6Kcjs.noop;
     const initialized = instances.size;
     const instance = Symbol();
     instances.add(instance);

package/cjs/__chunks/{UTICNXST.cjs → CWDUO5EV.cjs}

@@ -1,10 +1,10 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});"use client";
 
 
-var _JNFZSNOIcjs = require('./JNFZSNOI.cjs');
+var _ZXCB7MXNcjs = require('./ZXCB7MXN.cjs');
 
 
-var _2UK5WUJXcjs = require('./2UK5WUJX.cjs');
+var _5CBCKBZ2cjs = require('./5CBCKBZ2.cjs');
 
 
 var _3UT5FE6Kcjs = require('./3UT5FE6K.cjs');
@@ -17,7 +17,7 @@ var _AV6KTKLEcjs = require('./AV6KTKLE.cjs');
 function createMenubarStore(props = {}) {
   var _a;
   const syncState = (_a = props.store) == null ? void 0 : _a.getState();
-  const composite = _JNFZSNOIcjs.createCompositeStore.call(void 0, _AV6KTKLEcjs.__spreadProps.call(void 0, _AV6KTKLEcjs.__spreadValues.call(void 0, {}, props), {
+  const composite = _ZXCB7MXNcjs.createCompositeStore.call(void 0, _AV6KTKLEcjs.__spreadProps.call(void 0, _AV6KTKLEcjs.__spreadValues.call(void 0, {}, props), {
     orientation: _3UT5FE6Kcjs.defaultValue.call(void 0, 
       props.orientation,
       syncState == null ? void 0 : syncState.orientation,
@@ -26,7 +26,7 @@ function createMenubarStore(props = {}) {
     focusLoop: _3UT5FE6Kcjs.defaultValue.call(void 0, props.focusLoop, syncState == null ? void 0 : syncState.focusLoop, true)
   }));
   const initialState = _AV6KTKLEcjs.__spreadValues.call(void 0, {}, composite.getState());
-  const menubar = _2UK5WUJXcjs.createStore.call(void 0, initialState, composite, props.store);
+  const menubar = _5CBCKBZ2cjs.createStore.call(void 0, initialState, composite, props.store);
   return _AV6KTKLEcjs.__spreadValues.call(void 0, _AV6KTKLEcjs.__spreadValues.call(void 0, {}, composite), menubar);
 }
 

package/cjs/__chunks/{5SIVMOID.cjs → HMO4CKUP.cjs}

@@ -1,10 +1,10 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});"use client";
 
 
-var _EFIT5L4Xcjs = require('./EFIT5L4X.cjs');
+var _Y6PHIDP6cjs = require('./Y6PHIDP6.cjs');
 
 
-var _2UK5WUJXcjs = require('./2UK5WUJX.cjs');
+var _5CBCKBZ2cjs = require('./5CBCKBZ2.cjs');
 
 
 var _3UT5FE6Kcjs = require('./3UT5FE6K.cjs');
@@ -17,7 +17,7 @@ var _AV6KTKLEcjs = require('./AV6KTKLE.cjs');
 function createHovercardStore(props = {}) {
   var _a;
   const syncState = (_a = props.store) == null ? void 0 : _a.getState();
-  const popover = _EFIT5L4Xcjs.createPopoverStore.call(void 0, _AV6KTKLEcjs.__spreadProps.call(void 0, _AV6KTKLEcjs.__spreadValues.call(void 0, {}, props), {
+  const popover = _Y6PHIDP6cjs.createPopoverStore.call(void 0, _AV6KTKLEcjs.__spreadProps.call(void 0, _AV6KTKLEcjs.__spreadValues.call(void 0, {}, props), {
     placement: _3UT5FE6Kcjs.defaultValue.call(void 0, 
       props.placement,
       syncState == null ? void 0 : syncState.placement,
@@ -31,7 +31,7 @@ function createHovercardStore(props = {}) {
     hideTimeout: _3UT5FE6Kcjs.defaultValue.call(void 0, props.hideTimeout, syncState == null ? void 0 : syncState.hideTimeout),
     autoFocusOnShow: _3UT5FE6Kcjs.defaultValue.call(void 0, syncState == null ? void 0 : syncState.autoFocusOnShow, false)
   });
-  const hovercard = _2UK5WUJXcjs.createStore.call(void 0, initialState, popover, props.store);
+  const hovercard = _5CBCKBZ2cjs.createStore.call(void 0, initialState, popover, props.store);
   return _AV6KTKLEcjs.__spreadProps.call(void 0, _AV6KTKLEcjs.__spreadValues.call(void 0, _AV6KTKLEcjs.__spreadValues.call(void 0, {}, popover), hovercard), {
     setAutoFocusOnShow: (value) => hovercard.setState("autoFocusOnShow", value)
   });

package/cjs/__chunks/{2LS4JJ4S.cjs → MFSCSSBJ.cjs}

@@ -1,11 +1,11 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});"use client";
 
 
-var _GJFZ5ZPPcjs = require('./GJFZ5ZPP.cjs');
+var _MWNFQD55cjs = require('./MWNFQD55.cjs');
 
 // src/dialog/dialog-store.ts
 function createDialogStore(props = {}) {
-  return _GJFZ5ZPPcjs.createDisclosureStore.call(void 0, props);
+  return _MWNFQD55cjs.createDisclosureStore.call(void 0, props);
 }
 
 

package/cjs/__chunks/{GJFZ5ZPP.cjs → MWNFQD55.cjs}

@@ -7,7 +7,7 @@
 
 
 
-var _2UK5WUJXcjs = require('./2UK5WUJX.cjs');
+var _5CBCKBZ2cjs = require('./5CBCKBZ2.cjs');
 
 
 var _3UT5FE6Kcjs = require('./3UT5FE6K.cjs');
@@ -18,11 +18,11 @@ var _AV6KTKLEcjs = require('./AV6KTKLE.cjs');
 
 // src/disclosure/disclosure-store.ts
 function createDisclosureStore(props = {}) {
-  const store = _2UK5WUJXcjs.mergeStore.call(void 0, 
+  const store = _5CBCKBZ2cjs.mergeStore.call(void 0, 
     props.store,
-    _2UK5WUJXcjs.omit.call(void 0, props.disclosure, ["contentElement", "disclosureElement"])
+    _5CBCKBZ2cjs.omit.call(void 0, props.disclosure, ["contentElement", "disclosureElement"])
   );
-  _2UK5WUJXcjs.throwOnConflictingProps.call(void 0, props, store);
+  _5CBCKBZ2cjs.throwOnConflictingProps.call(void 0, props, store);
   const syncState = store == null ? void 0 : store.getState();
   const open = _3UT5FE6Kcjs.defaultValue.call(void 0, 
     props.open,
@@ -39,26 +39,26 @@ function createDisclosureStore(props = {}) {
     contentElement: _3UT5FE6Kcjs.defaultValue.call(void 0, syncState == null ? void 0 : syncState.contentElement, null),
     disclosureElement: _3UT5FE6Kcjs.defaultValue.call(void 0, syncState == null ? void 0 : syncState.disclosureElement, null)
   };
-  const disclosure = _2UK5WUJXcjs.createStore.call(void 0, initialState, store);
-  _2UK5WUJXcjs.setup.call(void 0, 
+  const disclosure = _5CBCKBZ2cjs.createStore.call(void 0, initialState, store);
+  _5CBCKBZ2cjs.setup.call(void 0, 
     disclosure,
-    () => _2UK5WUJXcjs.sync.call(void 0, disclosure, ["animated", "animating"], (state) => {
+    () => _5CBCKBZ2cjs.sync.call(void 0, disclosure, ["animated", "animating"], (state) => {
       if (state.animated)
         return;
       disclosure.setState("animating", false);
     })
   );
-  _2UK5WUJXcjs.setup.call(void 0, 
+  _5CBCKBZ2cjs.setup.call(void 0, 
     disclosure,
-    () => _2UK5WUJXcjs.subscribe.call(void 0, disclosure, ["open"], () => {
+    () => _5CBCKBZ2cjs.subscribe.call(void 0, disclosure, ["open"], () => {
       if (!disclosure.getState().animated)
         return;
       disclosure.setState("animating", true);
     })
   );
-  _2UK5WUJXcjs.setup.call(void 0, 
+  _5CBCKBZ2cjs.setup.call(void 0, 
     disclosure,
-    () => _2UK5WUJXcjs.sync.call(void 0, disclosure, ["open", "animating"], (state) => {
+    () => _5CBCKBZ2cjs.sync.call(void 0, disclosure, ["open", "animating"], (state) => {
       disclosure.setState("mounted", state.open || state.animating);
     })
   );

package/cjs/__chunks/{EFIT5L4X.cjs → Y6PHIDP6.cjs}

@@ -1,13 +1,13 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});"use client";
 
 
-var _2LS4JJ4Scjs = require('./2LS4JJ4S.cjs');
+var _MFSCSSBJcjs = require('./MFSCSSBJ.cjs');
 
 
 
 
 
-var _2UK5WUJXcjs = require('./2UK5WUJX.cjs');
+var _5CBCKBZ2cjs = require('./5CBCKBZ2.cjs');
 
 
 var _3UT5FE6Kcjs = require('./3UT5FE6K.cjs');
@@ -24,9 +24,9 @@ function createPopoverStore(_a = {}) {
   } = _b, props = _AV6KTKLEcjs.__objRest.call(void 0, _b, [
     "popover"
   ]);
-  const store = _2UK5WUJXcjs.mergeStore.call(void 0, 
+  const store = _5CBCKBZ2cjs.mergeStore.call(void 0, 
     props.store,
-    _2UK5WUJXcjs.omit.call(void 0, otherPopover, [
+    _5CBCKBZ2cjs.omit.call(void 0, otherPopover, [
       "arrowElement",
       "anchorElement",
       "contentElement",
@@ -34,9 +34,9 @@ function createPopoverStore(_a = {}) {
       "disclosureElement"
     ])
   );
-  _2UK5WUJXcjs.throwOnConflictingProps.call(void 0, props, store);
+  _5CBCKBZ2cjs.throwOnConflictingProps.call(void 0, props, store);
   const syncState = store == null ? void 0 : store.getState();
-  const dialog = _2LS4JJ4Scjs.createDialogStore.call(void 0, _AV6KTKLEcjs.__spreadProps.call(void 0, _AV6KTKLEcjs.__spreadValues.call(void 0, {}, props), { store }));
+  const dialog = _MFSCSSBJcjs.createDialogStore.call(void 0, _AV6KTKLEcjs.__spreadProps.call(void 0, _AV6KTKLEcjs.__spreadValues.call(void 0, {}, props), { store }));
   const placement = _3UT5FE6Kcjs.defaultValue.call(void 0, 
     props.placement,
     syncState == null ? void 0 : syncState.placement,
@@ -50,7 +50,7 @@ function createPopoverStore(_a = {}) {
     arrowElement: _3UT5FE6Kcjs.defaultValue.call(void 0, syncState == null ? void 0 : syncState.arrowElement, null),
     rendered: Symbol("rendered")
   });
-  const popover = _2UK5WUJXcjs.createStore.call(void 0, initialState, dialog, store);
+  const popover = _5CBCKBZ2cjs.createStore.call(void 0, initialState, dialog, store);
   return _AV6KTKLEcjs.__spreadProps.call(void 0, _AV6KTKLEcjs.__spreadValues.call(void 0, _AV6KTKLEcjs.__spreadValues.call(void 0, {}, dialog), popover), {
     setAnchorElement: (element) => popover.setState("anchorElement", element),
     setPopoverElement: (element) => popover.setState("popoverElement", element),

package/cjs/__chunks/{UCLKUBNP.cjs → YLMJBIQM.cjs}

@@ -5,7 +5,7 @@
 
 
 
-var _2UK5WUJXcjs = require('./2UK5WUJX.cjs');
+var _5CBCKBZ2cjs = require('./5CBCKBZ2.cjs');
 
 
 
@@ -69,7 +69,7 @@ function getPrivateStore(store) {
 }
 function createCollectionStore(props = {}) {
   var _a;
-  _2UK5WUJXcjs.throwOnConflictingProps.call(void 0, props, props.store);
+  _5CBCKBZ2cjs.throwOnConflictingProps.call(void 0, props, props.store);
   const syncState = (_a = props.store) == null ? void 0 : _a.getState();
   const items = _3UT5FE6Kcjs.defaultValue.call(void 0, 
     props.items,
@@ -83,22 +83,25 @@ function createCollectionStore(props = {}) {
     renderedItems: _3UT5FE6Kcjs.defaultValue.call(void 0, syncState == null ? void 0 : syncState.renderedItems, [])
   };
   const syncPrivateStore = getPrivateStore(props.store);
-  const privateStore = _2UK5WUJXcjs.createStore.call(void 0, 
+  const privateStore = _5CBCKBZ2cjs.createStore.call(void 0, 
     { renderedItems: initialState.renderedItems },
     syncPrivateStore
   );
-  const collection = _2UK5WUJXcjs.createStore.call(void 0, initialState, props.store);
-  _2UK5WUJXcjs.setup.call(void 0, collection, () => _2UK5WUJXcjs.init.call(void 0, privateStore));
-  _2UK5WUJXcjs.setup.call(void 0, privateStore, () => {
-    return _2UK5WUJXcjs.batch.call(void 0, privateStore, ["renderedItems"], (state) => {
+  const collection = _5CBCKBZ2cjs.createStore.call(void 0, initialState, props.store);
+  const sortItems = (renderedItems) => {
+    const sortedItems = sortBasedOnDOMPosition(renderedItems);
+    privateStore.setState("renderedItems", sortedItems);
+    collection.setState("renderedItems", sortedItems);
+  };
+  _5CBCKBZ2cjs.setup.call(void 0, collection, () => _5CBCKBZ2cjs.init.call(void 0, privateStore));
+  _5CBCKBZ2cjs.setup.call(void 0, privateStore, () => {
+    return _5CBCKBZ2cjs.batch.call(void 0, 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 +111,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 });

package/cjs/__chunks/{JNFZSNOI.cjs → ZXCB7MXN.cjs}

@@ -1,12 +1,12 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});"use client";
 
 
-var _UCLKUBNPcjs = require('./UCLKUBNP.cjs');
+var _YLMJBIQMcjs = require('./YLMJBIQM.cjs');
 
 
 
 
-var _2UK5WUJXcjs = require('./2UK5WUJX.cjs');
+var _5CBCKBZ2cjs = require('./5CBCKBZ2.cjs');
 
 
 var _3UT5FE6Kcjs = require('./3UT5FE6K.cjs');
@@ -124,7 +124,7 @@ function verticalizeItems(items) {
 function createCompositeStore(props = {}) {
   var _a;
   const syncState = (_a = props.store) == null ? void 0 : _a.getState();
-  const collection = _UCLKUBNPcjs.createCollectionStore.call(void 0, props);
+  const collection = _YLMJBIQMcjs.createCollectionStore.call(void 0, props);
   const activeId = _3UT5FE6Kcjs.defaultValue.call(void 0, 
     props.activeId,
     syncState == null ? void 0 : syncState.activeId,
@@ -154,10 +154,10 @@ function createCompositeStore(props = {}) {
     focusWrap: _3UT5FE6Kcjs.defaultValue.call(void 0, props.focusWrap, syncState == null ? void 0 : syncState.focusWrap, false),
     focusShift: _3UT5FE6Kcjs.defaultValue.call(void 0, props.focusShift, syncState == null ? void 0 : syncState.focusShift, false)
   });
-  const composite = _2UK5WUJXcjs.createStore.call(void 0, initialState, collection, props.store);
-  _2UK5WUJXcjs.setup.call(void 0, 
+  const composite = _5CBCKBZ2cjs.createStore.call(void 0, initialState, collection, props.store);
+  _5CBCKBZ2cjs.setup.call(void 0, 
     composite,
-    () => _2UK5WUJXcjs.sync.call(void 0, composite, ["renderedItems", "activeId"], (state) => {
+    () => _5CBCKBZ2cjs.sync.call(void 0, composite, ["renderedItems", "activeId"], (state) => {
       composite.setState("activeId", (activeId2) => {
         var _a2;
         if (activeId2 !== void 0)

package/cjs/checkbox/checkbox-store.cjs

@@ -2,7 +2,7 @@
 
 
 
-var _2UK5WUJXcjs = require('../__chunks/2UK5WUJX.cjs');
+var _5CBCKBZ2cjs = require('../__chunks/5CBCKBZ2.cjs');
 
 
 var _3UT5FE6Kcjs = require('../__chunks/3UT5FE6K.cjs');
@@ -14,7 +14,7 @@ var _AV6KTKLEcjs = require('../__chunks/AV6KTKLE.cjs');
 // src/checkbox/checkbox-store.ts
 function createCheckboxStore(props = {}) {
   var _a;
-  _2UK5WUJXcjs.throwOnConflictingProps.call(void 0, props, props.store);
+  _5CBCKBZ2cjs.throwOnConflictingProps.call(void 0, props, props.store);
   const syncState = (_a = props.store) == null ? void 0 : _a.getState();
   const initialState = {
     value: _3UT5FE6Kcjs.defaultValue.call(void 0, 
@@ -24,7 +24,7 @@ function createCheckboxStore(props = {}) {
       false
     )
   };
-  const checkbox = _2UK5WUJXcjs.createStore.call(void 0, initialState, props.store);
+  const checkbox = _5CBCKBZ2cjs.createStore.call(void 0, initialState, props.store);
   return _AV6KTKLEcjs.__spreadProps.call(void 0, _AV6KTKLEcjs.__spreadValues.call(void 0, {}, checkbox), {
     setValue: (value) => checkbox.setState("value", value)
   });

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

@@ -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/cjs/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/cjs/collection/collection-store.cjs

@@ -1,11 +1,11 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});"use client";
 
 
-var _UCLKUBNPcjs = require('../__chunks/UCLKUBNP.cjs');
-require('../__chunks/2UK5WUJX.cjs');
+var _YLMJBIQMcjs = require('../__chunks/YLMJBIQM.cjs');
+require('../__chunks/5CBCKBZ2.cjs');
 require('../__chunks/3UT5FE6K.cjs');
 require('../__chunks/5F4DVUNS.cjs');
 require('../__chunks/AV6KTKLE.cjs');
 
 
-exports.createCollectionStore = _UCLKUBNPcjs.createCollectionStore;
+exports.createCollectionStore = _YLMJBIQMcjs.createCollectionStore;

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

@@ -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/cjs/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/cjs/combobox/combobox-store.cjs

@@ -1,20 +1,20 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});"use client";
 
 
-var _EFIT5L4Xcjs = require('../__chunks/EFIT5L4X.cjs');
-require('../__chunks/2LS4JJ4S.cjs');
-require('../__chunks/GJFZ5ZPP.cjs');
+var _Y6PHIDP6cjs = require('../__chunks/Y6PHIDP6.cjs');
+require('../__chunks/MFSCSSBJ.cjs');
+require('../__chunks/MWNFQD55.cjs');
 
 
-var _JNFZSNOIcjs = require('../__chunks/JNFZSNOI.cjs');
-require('../__chunks/UCLKUBNP.cjs');
+var _ZXCB7MXNcjs = require('../__chunks/ZXCB7MXN.cjs');
+require('../__chunks/YLMJBIQM.cjs');
 
 
 
 
 
 
-var _2UK5WUJXcjs = require('../__chunks/2UK5WUJX.cjs');
+var _5CBCKBZ2cjs = require('../__chunks/5CBCKBZ2.cjs');
 
 
 var _3UT5FE6Kcjs = require('../__chunks/3UT5FE6K.cjs');
@@ -33,7 +33,7 @@ var _AV6KTKLEcjs = require('../__chunks/AV6KTKLE.cjs');
 var isSafariOnMobile = _YIUPKKEKcjs.isSafari.call(void 0, ) && _YIUPKKEKcjs.isTouchDevice.call(void 0, );
 function createComboboxStore(props = {}) {
   var _a;
-  _2UK5WUJXcjs.throwOnConflictingProps.call(void 0, props, props.store);
+  _5CBCKBZ2cjs.throwOnConflictingProps.call(void 0, props, props.store);
   const syncState = (_a = props.store) == null ? void 0 : _a.getState();
   const activeId = _3UT5FE6Kcjs.defaultValue.call(void 0, 
     props.activeId,
@@ -41,7 +41,7 @@ function createComboboxStore(props = {}) {
     props.defaultActiveId,
     null
   );
-  const composite = _JNFZSNOIcjs.createCompositeStore.call(void 0, _AV6KTKLEcjs.__spreadProps.call(void 0, _AV6KTKLEcjs.__spreadValues.call(void 0, {}, props), {
+  const composite = _ZXCB7MXNcjs.createCompositeStore.call(void 0, _AV6KTKLEcjs.__spreadProps.call(void 0, _AV6KTKLEcjs.__spreadValues.call(void 0, {}, props), {
     activeId,
     includesBaseElement: _3UT5FE6Kcjs.defaultValue.call(void 0, 
       props.includesBaseElement,
@@ -61,7 +61,7 @@ function createComboboxStore(props = {}) {
       !isSafariOnMobile
     )
   }));
-  const popover = _EFIT5L4Xcjs.createPopoverStore.call(void 0, _AV6KTKLEcjs.__spreadProps.call(void 0, _AV6KTKLEcjs.__spreadValues.call(void 0, {}, props), {
+  const popover = _Y6PHIDP6cjs.createPopoverStore.call(void 0, _AV6KTKLEcjs.__spreadProps.call(void 0, _AV6KTKLEcjs.__spreadValues.call(void 0, {}, props), {
     placement: _3UT5FE6Kcjs.defaultValue.call(void 0, 
       props.placement,
       syncState == null ? void 0 : syncState.placement,
@@ -96,10 +96,10 @@ function createComboboxStore(props = {}) {
     ),
     activeValue: syncState == null ? void 0 : syncState.activeValue
   });
-  const combobox = _2UK5WUJXcjs.createStore.call(void 0, initialState, composite, popover, props.store);
-  _2UK5WUJXcjs.setup.call(void 0, 
+  const combobox = _5CBCKBZ2cjs.createStore.call(void 0, initialState, composite, popover, props.store);
+  _5CBCKBZ2cjs.setup.call(void 0, 
     combobox,
-    () => _2UK5WUJXcjs.sync.call(void 0, combobox, ["resetValueOnHide", "mounted"], (state) => {
+    () => _5CBCKBZ2cjs.sync.call(void 0, combobox, ["resetValueOnHide", "mounted"], (state) => {
       if (!state.resetValueOnHide)
         return;
       if (state.mounted)
@@ -107,34 +107,34 @@ function createComboboxStore(props = {}) {
       combobox.setState("value", value);
     })
   );
-  _2UK5WUJXcjs.setup.call(void 0, 
+  _5CBCKBZ2cjs.setup.call(void 0, 
     combobox,
-    () => _2UK5WUJXcjs.sync.call(void 0, combobox, ["resetValueOnSelect", "selectedValue"], (state) => {
+    () => _5CBCKBZ2cjs.sync.call(void 0, combobox, ["resetValueOnSelect", "selectedValue"], (state) => {
       if (!state.resetValueOnSelect)
         return;
       combobox.setState("value", value);
     })
   );
-  _2UK5WUJXcjs.setup.call(void 0, 
+  _5CBCKBZ2cjs.setup.call(void 0, 
     combobox,
-    () => _2UK5WUJXcjs.batch.call(void 0, combobox, ["mounted"], (state) => {
+    () => _5CBCKBZ2cjs.batch.call(void 0, combobox, ["mounted"], (state) => {
       if (state.mounted)
         return;
       combobox.setState("activeId", activeId);
       combobox.setState("moves", 0);
     })
   );
-  _2UK5WUJXcjs.setup.call(void 0, 
+  _5CBCKBZ2cjs.setup.call(void 0, 
     combobox,
-    () => _2UK5WUJXcjs.sync.call(void 0, combobox, ["moves", "activeId"], (state, prevState) => {
+    () => _5CBCKBZ2cjs.sync.call(void 0, combobox, ["moves", "activeId"], (state, prevState) => {
       if (state.moves === prevState.moves) {
         combobox.setState("activeValue", void 0);
       }
     })
   );
-  _2UK5WUJXcjs.setup.call(void 0, 
+  _5CBCKBZ2cjs.setup.call(void 0, 
     combobox,
-    () => _2UK5WUJXcjs.batch.call(void 0, combobox, ["moves", "renderedItems"], (state, prev) => {
+    () => _5CBCKBZ2cjs.batch.call(void 0, combobox, ["moves", "renderedItems"], (state, prev) => {
       if (state.moves === prev.moves)
         return;
       const { activeId: activeId2 } = combobox.getState();

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

@@ -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/cjs/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;
     /**