@ariakit/core 0.1.2 → 0.1.4

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # @ariakit/core
 
+## 0.1.4
+
+### Patch Changes
+
+- Updated JSDocs.
+
+## 0.1.3
+
+### Patch Changes
+
+- Added support for native radio buttons within forms, that work with roving tabindex, to all `focus` utilities. ([#2313](https://github.com/ariakit/ariakit/pull/2313))
+
+- Updated validate and submit callbacks on `Form` so they always run in a consistent order. ([#2319](https://github.com/ariakit/ariakit/pull/2319))
+
+- Marked internal store functions as deprecated/experimental. ([#2316](https://github.com/ariakit/ariakit/pull/2316))
+
 ## 0.1.2
 
 ### Patch Changes

package/cjs/__chunks/{IBEUC4KN.cjs → 4DQ3OTE7.cjs}

@@ -75,8 +75,7 @@ function createCollectionStore(props = {}) {
     return privateStore.syncBatch(
       (state) => {
         let firstRun = true;
-        let raf = 0;
-        raf = requestAnimationFrame(sortItems);
+        let raf = requestAnimationFrame(sortItems);
         if (typeof IntersectionObserver !== "function")
           return;
         const callback = () => {

package/cjs/__chunks/{6GFPNMAE.cjs → W5IHD6VG.cjs}

@@ -1,6 +1,6 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
 
-var _IBEUC4KNcjs = require('./IBEUC4KN.cjs');
+var _4DQ3OTE7cjs = require('./4DQ3OTE7.cjs');
 
 
 var _ZPOXPO2Lcjs = require('./ZPOXPO2L.cjs');
@@ -114,7 +114,7 @@ function verticalizeItems(items) {
 }
 function createCompositeStore(props = {}) {
   const syncState = _optionalChain([props, 'access', _4 => _4.store, 'optionalAccess', _5 => _5.getState, 'call', _6 => _6()]);
-  const collection = _IBEUC4KNcjs.createCollectionStore.call(void 0, props);
+  const collection = _4DQ3OTE7cjs.createCollectionStore.call(void 0, props);
   const activeId = _QNEPGQLLcjs.defaultValue.call(void 0, 
     props.activeId,
     _optionalChain([syncState, 'optionalAccess', _7 => _7.activeId]),

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

@@ -10,6 +10,9 @@ export type CheckboxStoreValue = Value;
 export interface CheckboxStoreState<T extends Value = Value> {
     /**
      * The checked state of the checkbox.
+     *
+     * Live examples:
+     * - [Custom Checkbox](https://ariakit.org/examples/checkbox-custom)
      */
     value: ToPrimitive<T>;
 }
@@ -25,6 +28,10 @@ export interface CheckboxStoreFunctions<T extends Value = Value> {
 export interface CheckboxStoreOptions<T extends Value = Value> extends StoreOptions<CheckboxStoreState<T>, "value"> {
     /**
      * The default value of the checkbox.
+     *
+     * Live examples:
+     * - [Custom Checkbox](https://ariakit.org/examples/checkbox-custom)
+     * - [Checkbox group](https://ariakit.org/examples/checkbox-group)
      * @default false
      */
     defaultValue?: CheckboxStoreState<T>["value"];

package/cjs/collection/collection-store.cjs

@@ -1,9 +1,9 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});
 
-var _IBEUC4KNcjs = require('../__chunks/IBEUC4KN.cjs');
+var _4DQ3OTE7cjs = require('../__chunks/4DQ3OTE7.cjs');
 require('../__chunks/ZPOXPO2L.cjs');
 require('../__chunks/QNEPGQLL.cjs');
 require('../__chunks/OFNGELMA.cjs');
 
 
-exports.createCollectionStore = _IBEUC4KNcjs.createCollectionStore;
+exports.createCollectionStore = _4DQ3OTE7cjs.createCollectionStore;

package/cjs/combobox/combobox-store.cjs

@@ -5,8 +5,8 @@ require('../__chunks/ZJEEK57E.cjs');
 require('../__chunks/QYB6XH64.cjs');
 
 
-var _6GFPNMAEcjs = require('../__chunks/6GFPNMAE.cjs');
-require('../__chunks/IBEUC4KN.cjs');
+var _W5IHD6VGcjs = require('../__chunks/W5IHD6VG.cjs');
+require('../__chunks/4DQ3OTE7.cjs');
 
 
 
@@ -57,7 +57,7 @@ function createComboboxStore({
     props.defaultActiveId,
     null
   );
-  const composite = _6GFPNMAEcjs.createCompositeStore.call(void 0, {
+  const composite = _W5IHD6VGcjs.createCompositeStore.call(void 0, {
     ...props,
     store,
     activeId,

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

@@ -19,6 +19,15 @@ export interface ComboboxStoreState extends CompositeStoreState<Item>, PopoverSt
     includesBaseElement: boolean;
     /**
      * The input value.
+     *
+     * Live examples:
+     * - [ComboboxGroup](https://ariakit.org/examples/combobox-group)
+     * - [Combobox with links](https://ariakit.org/examples/combobox-links)
+     * - [Filterable Combobox](https://ariakit.org/examples/combobox-matches)
+     * - [Multi-selectable
+     *   Combobox](https://ariakit.org/examples/combobox-multiple)
+     * - [Textarea with inline
+     *   Combobox](https://ariakit.org/examples/combobox-textarea)
      */
     value: string;
     /**
@@ -27,12 +36,23 @@ export interface ComboboxStoreState extends CompositeStoreState<Item>, PopoverSt
     activeValue: string | undefined;
     /**
      * Whether to reset the value when the combobox popover is hidden.
+     *
+     * Live examples:
+     * - [Multi-selectable
+     *   Combobox](https://ariakit.org/examples/combobox-multiple)
+     * @default false
      */
     resetValueOnHide: boolean;
 }
 export interface ComboboxStoreFunctions extends CompositeStoreFunctions<Item>, PopoverStoreFunctions {
     /**
      * Sets the `value` state.
+     *
+     * Live examples:
+     * - [Multi-selectable
+     *   Combobox](https://ariakit.org/examples/combobox-multiple)
+     * - [Textarea with inline
+     *   Combobox](https://ariakit.org/examples/combobox-textarea)
      * @example
      * store.setValue("Hello world");
      * store.setValue((value) => value + "!");
@@ -58,6 +78,10 @@ export interface ComboboxStoreOptions extends StoreOptions<ComboboxStoreState, "
     select?: SelectStore;
     /**
      * The combobox initial value.
+     *
+     * Live examples:
+     * - [Multi-selectable
+     *   Combobox](https://ariakit.org/examples/combobox-multiple)
      * @default ""
      */
     defaultValue?: ComboboxStoreState["value"];

package/cjs/composite/composite-store.cjs

@@ -1,11 +1,11 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});
 
-var _6GFPNMAEcjs = require('../__chunks/6GFPNMAE.cjs');
-require('../__chunks/IBEUC4KN.cjs');
+var _W5IHD6VGcjs = require('../__chunks/W5IHD6VG.cjs');
+require('../__chunks/4DQ3OTE7.cjs');
 require('../__chunks/ZPOXPO2L.cjs');
 require('../__chunks/QNEPGQLL.cjs');
 require('../__chunks/OFNGELMA.cjs');
 require('../__chunks/GDZQUFNP.cjs');
 
 
-exports.createCompositeStore = _6GFPNMAEcjs.createCompositeStore;
+exports.createCompositeStore = _W5IHD6VGcjs.createCompositeStore;

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

@@ -25,6 +25,10 @@ export interface CompositeStoreState<T extends Item = Item> extends CollectionSt
      * tabindex](https://www.w3.org/WAI/ARIA/apg/practices/keyboard-interface/#kbd_roving_tabindex).
      * DOM focus will remain on the composite element while its items receive
      * virtual focus.
+     *
+     * Live examples:
+     * - [Multi-selectable
+     *   Combobox](https://ariakit.org/examples/combobox-multiple)
      * @default false
      */
     virtualFocus: boolean;
@@ -32,9 +36,9 @@ export interface CompositeStoreState<T extends Item = Item> extends CollectionSt
      * Defines the orientation of the composite widget. If the composite has a
      * single row or column (one-dimensional), the `orientation` value determines
      * which arrow keys can be used to move focus:
-     *   - `both`: all arrow keys work.
-     *   - `horizontal`: only left and right arrow keys work.
-     *   - `vertical`: only up and down arrow keys work.
+     * - `both`: all arrow keys work.
+     * - `horizontal`: only left and right arrow keys work.
+     * - `vertical`: only up and down arrow keys work.
      *
      * It doesn't have any effect on two-dimensional composites.
      * @default "both"
@@ -52,27 +56,27 @@ export interface CompositeStoreState<T extends Item = Item> extends CollectionSt
      * composite widget.
      *
      * On one-dimensional composites:
-     *   - `true` loops from the last item to the first item and vice-versa.
-     *   - `horizontal` loops only if `orientation` is `horizontal` or not set.
-     *   - `vertical` loops only if `orientation` is `vertical` or not set.
-     *   - If `includesBaseElement` is set to `true` (or `activeId` is initially
-     *     set to `null`), the composite element will be focused in between the
-     *     last and first items.
+     * - `true` loops from the last item to the first item and vice-versa.
+     * - `horizontal` loops only if `orientation` is `horizontal` or not set.
+     * - `vertical` loops only if `orientation` is `vertical` or not set.
+     * - If `includesBaseElement` is set to `true` (or `activeId` is initially set
+     *   to `null`), the composite element will be focused in between the last and
+     *   first items.
      *
      * On two-dimensional composites (when using `CompositeRow`):
-     *   - `true` loops from the last row/column item to the first item in the
-     *     same row/column and vice-versa. If it's the last item in the last row,
-     *     it moves to the first item in the first row and vice-versa.
-     *   - `horizontal` loops only from the last row item to the first item in the
-     *     same row.
-     *   - `vertical` loops only from the last column item to the first item in
-     *     the column row.
-     *   - If `includesBaseElement` is set to `true` (or `activeId` is initially
-     *     set to `null`), vertical loop will have no effect as moving down from
-     *     the last row or up from the first row will focus the composite element.
-     *   - If `focusWrap` matches the value of `focusLoop`, it'll wrap between the
-     *     last item in the last row or column and the first item in the first row
-     *     or column and vice-versa.
+     * - `true` loops from the last row/column item to the first item in the same
+     *   row/column and vice-versa. If it's the last item in the last row, it
+     *   moves to the first item in the first row and vice-versa.
+     * - `horizontal` loops only from the last row item to the first item in the
+     *   same row.
+     * - `vertical` loops only from the last column item to the first item in the
+     *   column row.
+     * - If `includesBaseElement` is set to `true` (or `activeId` is initially set
+     *   to `null`), vertical loop will have no effect as moving down from the
+     *   last row or up from the first row will focus the composite element.
+     * - If `focusWrap` matches the value of `focusLoop`, it'll wrap between the
+     *   last item in the last row or column and the first item in the first row
+     *   or column and vice-versa.
      * @default false
      */
     focusLoop: boolean | Orientation;
@@ -80,12 +84,12 @@ export interface CompositeStoreState<T extends Item = Item> extends CollectionSt
      * **Works only on two-dimensional composites**. If enabled, moving to the
      * next item from the last one in a row or column will focus the first item in
      * the next row or column and vice-versa.
-     *   - `true` wraps between rows and columns.
-     *   - `horizontal` wraps only between rows.
-     *   - `vertical` wraps only between columns.
-     *   - If `focusLoop` matches the value of `focusWrap`, it'll wrap between the
-     *     last item in the last row or column and the first item in the first row
-     *     or column and vice-versa.
+     * - `true` wraps between rows and columns.
+     * - `horizontal` wraps only between rows.
+     * - `vertical` wraps only between columns.
+     * - If `focusLoop` matches the value of `focusWrap`, it'll wrap between the
+     *   last item in the last row or column and the first item in the first row
+     *   or column and vice-versa.
      * @default false
      */
     focusWrap: boolean | Orientation;
@@ -108,12 +112,12 @@ export interface CompositeStoreState<T extends Item = Item> extends CollectionSt
     includesBaseElement: boolean;
     /**
      * The current focused item `id`.
-     *   - `null` focuses the base composite element and users will be able to
-     *     navigate out of it using arrow keys.
-     *   - If `activeId` is initially set to `null`, the `includesBaseElement`
-     *     prop will also default to `true`, which means the base composite
-     *     element itself will have focus and users will be able to navigate to it
-     *     using arrow keys.
+     * - `null` focuses the base composite element and users will be able to
+     *   navigate out of it using arrow keys.
+     * - If `activeId` is initially set to `null`, the `includesBaseElement` prop
+     *   will also default to `true`, which means the base composite element
+     *   itself will have focus and users will be able to navigate to it using
+     *   arrow keys.
      */
     activeId: string | null | undefined;
 }

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

@@ -15,16 +15,26 @@ export interface DisclosureStoreState {
      * this will be the same as `open`. Otherwise, it will wait for the animation
      * to complete before becoming `false` so the content is not unmounted while
      * animating.
+     *
+     * Live examples:
+     * - [Combobox with links](https://ariakit.org/examples/combobox-links)
+     * - [Textarea with inline
+     *   Combobox](https://ariakit.org/examples/combobox-textarea)
      */
     mounted: boolean;
     /**
      * Determines whether the content should animate when it is shown or hidden.
-     *   - If `true`, the `animating` state will be `true` when the content is
-     *     shown or hidden and it will wait for `stopAnimation` to be called or a
-     *     CSS animation/transition to end before becoming `false`.
-     *   - If it's set to a number, the `animating` state will be `true` when the
-     *     content is shown or hidden and it will wait for the number of
-     *     milliseconds to pass before becoming `false`.
+     * - If `true`, the `animating` state will be `true` when the content is shown
+     *   or hidden and it will wait for `stopAnimation` to be called or a CSS
+     *   animation/transition to end before becoming `false`.
+     * - If it's set to a number, the `animating` state will be `true` when the
+     *   content is shown or hidden and it will wait for the number of
+     *   milliseconds to pass before becoming `false`.
+     *
+     * Live examples:
+     * - [Animated Combobox](https://ariakit.org/examples/combobox-animated)
+     * - [Animated Dialog](https://ariakit.org/examples/dialog-animated)
+     * - [Animated Select](https://ariakit.org/examples/select-animated)
      * @default false
      */
     animated: boolean | number;
@@ -44,6 +54,10 @@ export interface DisclosureStoreState {
 export interface DisclosureStoreFunctions {
     /**
      * Sets the `open` state.
+     *
+     * Live examples:
+     * - [Textarea with inline
+     *   Combobox](https://ariakit.org/examples/combobox-textarea)
      * @example
      * store.setOpen(true);
      * store.setOpen((open) => !open);
@@ -51,10 +65,18 @@ export interface DisclosureStoreFunctions {
     setOpen: SetState<DisclosureStoreState["open"]>;
     /**
      * Sets the `open` state to `true`.
+     *
+     * Live examples:
+     * - [Textarea with inline
+     *   Combobox](https://ariakit.org/examples/combobox-textarea)
      */
     show: () => void;
     /**
      * Sets the `open` state to `false`.
+     *
+     * Live examples:
+     * - [Textarea with inline
+     *   Combobox](https://ariakit.org/examples/combobox-textarea)
      */
     hide: () => void;
     /**

package/cjs/form/form-store.cjs

@@ -1,6 +1,6 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
 
-var _IBEUC4KNcjs = require('../__chunks/IBEUC4KN.cjs');
+var _4DQ3OTE7cjs = require('../__chunks/4DQ3OTE7.cjs');
 
 
 var _ZPOXPO2Lcjs = require('../__chunks/ZPOXPO2L.cjs');
@@ -102,7 +102,7 @@ function createNames() {
 }
 function createFormStore(props = {}) {
   const syncState = _optionalChain([props, 'access', _ => _.store, 'optionalAccess', _2 => _2.getState, 'call', _3 => _3()]);
-  const collection = _IBEUC4KNcjs.createCollectionStore.call(void 0, props);
+  const collection = _4DQ3OTE7cjs.createCollectionStore.call(void 0, props);
   const values = _QNEPGQLLcjs.defaultValue.call(void 0, 
     props.values,
     _optionalChain([syncState, 'optionalAccess', _4 => _4.values]),
@@ -139,9 +139,10 @@ function createFormStore(props = {}) {
     form.setState("validating", true);
     form.setState("errors", {});
     try {
-      const callbacks = [...validateCallbacks];
-      const results = callbacks.map((callback) => callback(form.getState()));
-      await Promise.all(results).then(nextFrame);
+      for (const callback of validateCallbacks) {
+        await callback(form.getState());
+      }
+      await nextFrame();
       return !hasMessages(form.getState().errors);
     } finally {
       form.setState("validating", false);
@@ -204,11 +205,10 @@ function createFormStore(props = {}) {
       form.setState("touched", setAll(form.getState().values, true));
       try {
         if (await validate()) {
-          const callbacks = [...submitCallbacks];
-          const results = callbacks.map(
-            (callback) => callback(form.getState())
-          );
-          await Promise.all(results).then(nextFrame);
+          for (const callback of submitCallbacks) {
+            await callback(form.getState());
+          }
+          await nextFrame();
           if (!hasMessages(form.getState().errors)) {
             form.setState("submitSucceed", (count) => count + 1);
             return true;

package/cjs/menu/menu-bar-store.cjs

@@ -1,7 +1,7 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
 
-var _6GFPNMAEcjs = require('../__chunks/6GFPNMAE.cjs');
-require('../__chunks/IBEUC4KN.cjs');
+var _W5IHD6VGcjs = require('../__chunks/W5IHD6VG.cjs');
+require('../__chunks/4DQ3OTE7.cjs');
 require('../__chunks/ZPOXPO2L.cjs');
 
 
@@ -12,7 +12,7 @@ require('../__chunks/GDZQUFNP.cjs');
 // src/menu/menu-bar-store.ts
 function createMenuBarStore(props = {}) {
   const syncState = _optionalChain([props, 'access', _ => _.store, 'optionalAccess', _2 => _2.getState, 'call', _3 => _3()]);
-  return _6GFPNMAEcjs.createCompositeStore.call(void 0, {
+  return _W5IHD6VGcjs.createCompositeStore.call(void 0, {
     ...props,
     orientation: _QNEPGQLLcjs.defaultValue.call(void 0, 
       props.orientation,

package/cjs/menu/menu-store.cjs

@@ -6,8 +6,8 @@ require('../__chunks/ZJEEK57E.cjs');
 require('../__chunks/QYB6XH64.cjs');
 
 
-var _6GFPNMAEcjs = require('../__chunks/6GFPNMAE.cjs');
-require('../__chunks/IBEUC4KN.cjs');
+var _W5IHD6VGcjs = require('../__chunks/W5IHD6VG.cjs');
+require('../__chunks/4DQ3OTE7.cjs');
 
 
 
@@ -36,7 +36,7 @@ function createMenuStore({
     )])
   );
   const syncState = store.getState();
-  const composite = _6GFPNMAEcjs.createCompositeStore.call(void 0, {
+  const composite = _W5IHD6VGcjs.createCompositeStore.call(void 0, {
     ...props,
     store,
     orientation: _QNEPGQLLcjs.defaultValue.call(void 0, 

package/cjs/radio/radio-store.cjs

@@ -1,7 +1,7 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
 
-var _6GFPNMAEcjs = require('../__chunks/6GFPNMAE.cjs');
-require('../__chunks/IBEUC4KN.cjs');
+var _W5IHD6VGcjs = require('../__chunks/W5IHD6VG.cjs');
+require('../__chunks/4DQ3OTE7.cjs');
 
 
 var _ZPOXPO2Lcjs = require('../__chunks/ZPOXPO2L.cjs');
@@ -16,7 +16,7 @@ function createRadioStore({
   ...props
 } = {}) {
   const syncState = _optionalChain([props, 'access', _ => _.store, 'optionalAccess', _2 => _2.getState, 'call', _3 => _3()]);
-  const composite = _6GFPNMAEcjs.createCompositeStore.call(void 0, {
+  const composite = _W5IHD6VGcjs.createCompositeStore.call(void 0, {
     ...props,
     focusLoop: _QNEPGQLLcjs.defaultValue.call(void 0, props.focusLoop, _optionalChain([syncState, 'optionalAccess', _4 => _4.focusLoop]), true)
   });

package/cjs/select/select-store.cjs

@@ -5,8 +5,8 @@ require('../__chunks/ZJEEK57E.cjs');
 require('../__chunks/QYB6XH64.cjs');
 
 
-var _6GFPNMAEcjs = require('../__chunks/6GFPNMAE.cjs');
-require('../__chunks/IBEUC4KN.cjs');
+var _W5IHD6VGcjs = require('../__chunks/W5IHD6VG.cjs');
+require('../__chunks/4DQ3OTE7.cjs');
 
 
 
@@ -39,7 +39,7 @@ function createSelectStore({
     )])
   );
   const syncState = store.getState();
-  const composite = _6GFPNMAEcjs.createCompositeStore.call(void 0, {
+  const composite = _W5IHD6VGcjs.createCompositeStore.call(void 0, {
     ...props,
     store,
     virtualFocus: _QNEPGQLLcjs.defaultValue.call(void 0, 

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

@@ -35,6 +35,10 @@ export interface SelectStoreState<T extends Value = Value> extends CompositeStor
     placement: PopoverStoreState["placement"];
     /**
      * The select value.
+     *
+     * Live examples:
+     * - [Multi-selectable
+     *   Combobox](https://ariakit.org/examples/combobox-multiple)
      */
     value: MutableValue<T>;
     /**
@@ -55,6 +59,10 @@ export interface SelectStoreState<T extends Value = Value> extends CompositeStor
 export interface SelectStoreFunctions<T extends Value = Value> extends CompositeStoreFunctions<Item>, PopoverStoreFunctions {
     /**
      * Sets the `value` state.
+     *
+     * Live examples:
+     * - [Multi-selectable
+     *   Combobox](https://ariakit.org/examples/combobox-multiple)
      * @example
      * store.setValue("Apple");
      * store.setValue(["Apple", "Banana"]);
@@ -75,10 +83,18 @@ export interface SelectStoreOptions<T extends Value = Value> extends StoreOption
      * A reference to a combobox store. This is used when combining the combobox
      * with a select (e.g., select with a search input). The stores will share the
      * same state.
+     *
+     * Live examples:
+     * - [Multi-selectable
+     *   Combobox](https://ariakit.org/examples/combobox-multiple)
      */
     combobox?: ComboboxStore;
     /**
      * The default value. If not set, the first non-disabled item will be used.
+     *
+     * Live examples:
+     * - [Multi-selectable
+     *   Combobox](https://ariakit.org/examples/combobox-multiple)
      */
     defaultValue?: SelectStoreState<T>["value"];
 }

package/cjs/tab/tab-store.cjs

@@ -1,9 +1,9 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
 
-var _6GFPNMAEcjs = require('../__chunks/6GFPNMAE.cjs');
+var _W5IHD6VGcjs = require('../__chunks/W5IHD6VG.cjs');
 
 
-var _IBEUC4KNcjs = require('../__chunks/IBEUC4KN.cjs');
+var _4DQ3OTE7cjs = require('../__chunks/4DQ3OTE7.cjs');
 
 
 var _ZPOXPO2Lcjs = require('../__chunks/ZPOXPO2L.cjs');
@@ -16,7 +16,7 @@ require('../__chunks/GDZQUFNP.cjs');
 // src/tab/tab-store.ts
 function createTabStore(props = {}) {
   const syncState = _optionalChain([props, 'access', _ => _.store, 'optionalAccess', _2 => _2.getState, 'call', _3 => _3()]);
-  const composite = _6GFPNMAEcjs.createCompositeStore.call(void 0, {
+  const composite = _W5IHD6VGcjs.createCompositeStore.call(void 0, {
     ...props,
     orientation: _QNEPGQLLcjs.defaultValue.call(void 0, 
       props.orientation,
@@ -25,7 +25,7 @@ function createTabStore(props = {}) {
     ),
     focusLoop: _QNEPGQLLcjs.defaultValue.call(void 0, props.focusLoop, _optionalChain([syncState, 'optionalAccess', _5 => _5.focusLoop]), true)
   });
-  const panels = _IBEUC4KNcjs.createCollectionStore.call(void 0, );
+  const panels = _4DQ3OTE7cjs.createCollectionStore.call(void 0, );
   const initialState = {
     ...composite.getState(),
     selectedId: _QNEPGQLLcjs.defaultValue.call(void 0, 

package/cjs/toolbar/toolbar-store.cjs

@@ -1,7 +1,7 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
 
-var _6GFPNMAEcjs = require('../__chunks/6GFPNMAE.cjs');
-require('../__chunks/IBEUC4KN.cjs');
+var _W5IHD6VGcjs = require('../__chunks/W5IHD6VG.cjs');
+require('../__chunks/4DQ3OTE7.cjs');
 require('../__chunks/ZPOXPO2L.cjs');
 
 
@@ -12,7 +12,7 @@ require('../__chunks/GDZQUFNP.cjs');
 // src/toolbar/toolbar-store.ts
 function createToolbarStore(props = {}) {
   const syncState = _optionalChain([props, 'access', _ => _.store, 'optionalAccess', _2 => _2.getState, 'call', _3 => _3()]);
-  return _6GFPNMAEcjs.createCompositeStore.call(void 0, {
+  return _W5IHD6VGcjs.createCompositeStore.call(void 0, {
     ...props,
     orientation: _QNEPGQLLcjs.defaultValue.call(void 0, 
       props.orientation,