@ariakit/react-core 0.3.2 → 0.3.4

package/cjs/select/select-list.cjs

@@ -1,24 +1,25 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});
 
 
-var _OX7M6AXHcjs = require('../__chunks/OX7M6AXH.cjs');
+var _QMFZ4CLTcjs = require('../__chunks/QMFZ4CLT.cjs');
 require('../__chunks/DC66R2NY.cjs');
 require('../__chunks/I2EPCLS6.cjs');
-require('../__chunks/6G5GJF5Q.cjs');
+require('../__chunks/SELCJFCB.cjs');
 require('../__chunks/KLZID3QO.cjs');
 require('../__chunks/H7R5D2FR.cjs');
 require('../__chunks/NHZBX2RS.cjs');
-require('../__chunks/5E5FKYEO.cjs');
+require('../__chunks/L2VQ4YLN.cjs');
 require('../__chunks/AKOG5S2T.cjs');
 require('../__chunks/W6ZRSMO5.cjs');
 require('../__chunks/A2NMYLCG.cjs');
-require('../__chunks/BFLDQF3L.cjs');
+require('../__chunks/GQAB4M3B.cjs');
 require('../__chunks/LHHW5ZQP.cjs');
 require('../__chunks/Z5PUIG6A.cjs');
+require('../__chunks/EVNF7KMT.cjs');
 require('../__chunks/5WLTMVVQ.cjs');
 require('../__chunks/7WUTS26Y.cjs');
 require('../__chunks/72I2GWXF.cjs');
 
 
 
-exports.SelectList = _OX7M6AXHcjs.SelectList; exports.useSelectList = _OX7M6AXHcjs.useSelectList;
+exports.SelectList = _QMFZ4CLTcjs.SelectList; exports.useSelectList = _QMFZ4CLTcjs.useSelectList;

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

@@ -20,37 +20,47 @@ import type { SelectStore } from "./select-store.js";
  */
 export declare const useSelectList: import("../utils/types.js").Hook<SelectListOptions<"div">>;
 /**
- * Renders a select list. The `role` prop is set to `listbox` by default, but
- * can be overriden by any other valid select popup role (`listbox`, `menu`,
- * `tree`, `grid` or `dialog`). The `aria-labelledby` prop is set to the select
- * input element's `id` by default.
+ * Renders a select list. The `role` attribute is set to `listbox` by default,
+ * but can be overriden by any other valid select popup role (`listbox`, `menu`,
+ * `tree`, `grid` or `dialog`).
+ *
+ * The `aria-labelledby` attribute is set to the
+ * [`Select`](https://ariakit.org/reference/select) element's `id` by default.
  * @see https://ariakit.org/components/select
  * @example
- * ```jsx
- * const select = useSelectStore();
- * <Select store={select} />
- * <SelectList store={select}>
- *   <SelectItem value="Apple" />
- *   <SelectItem value="Orange" />
- * </SelectList>
+ * ```jsx {3-6}
+ * <SelectProvider>
+ *   <Select />
+ *   <SelectList>
+ *     <SelectItem value="Apple" />
+ *     <SelectItem value="Orange" />
+ *   </SelectList>
+ * </SelectProvider>
  * ```
  */
 export declare const SelectList: import("../utils/types.js").Component<SelectListOptions<"div">>;
 export interface SelectListOptions<T extends As = "div"> extends CompositeOptions<T>, CompositeTypeaheadOptions<T>, Pick<DisclosureContentOptions, "alwaysVisible"> {
     /**
-     * Object returned by the `useSelectStore` hook.
+     * Object returned by the
+     * [`useSelectStore`](https://ariakit.org/reference/use-select-store) hook. If
+     * not provided, the closest
+     * [`SelectProvider`](https://ariakit.org/reference/select-provider)
+     * component's context will be used.
      */
     store?: SelectStore;
     /**
      * Whether the select value should be reset to the value before the list got
-     * shown when Escape is pressed. This has effect only when `selectOnMove` is
-     * `true` on the select store.
+     * shown when Escape is pressed. This has effect only when
+     * [`setValueOnMove`](https://ariakit.org/reference/select-provider#setvalueonmove)
+     * is `true`.
      * @default true
      */
     resetOnEscape?: BooleanOrCallback<KeyboardEvent<HTMLElement>>;
     /**
-     * Whether the select list should be hidden when the user presses Enter or
-     * Space while the list is focused (that is, no item is selected).
+     * Whether the [`SelectList`](https://ariakit.org/reference/select-list) or
+     * [`SelectPopover`](https://ariakit.org/reference/select-popover) components
+     * should be hidden when the user presses Enter or Space while the list
+     * element is focused and no item is active.
      * @default true
      */
     hideOnEnter?: BooleanOrCallback<KeyboardEvent<HTMLElement>>;

package/cjs/select/select-popover.cjs

@@ -1,28 +1,30 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});
 
-var _OX7M6AXHcjs = require('../__chunks/OX7M6AXH.cjs');
+var _QMFZ4CLTcjs = require('../__chunks/QMFZ4CLT.cjs');
 require('../__chunks/DC66R2NY.cjs');
 
 
 var _I2EPCLS6cjs = require('../__chunks/I2EPCLS6.cjs');
-require('../__chunks/6G5GJF5Q.cjs');
+require('../__chunks/SELCJFCB.cjs');
 require('../__chunks/KLZID3QO.cjs');
 require('../__chunks/H7R5D2FR.cjs');
 require('../__chunks/NHZBX2RS.cjs');
 
 
-var _XOHN6PERcjs = require('../__chunks/XOHN6PER.cjs');
-require('../__chunks/QEG5AJH6.cjs');
-require('../__chunks/HCQYEOCO.cjs');
-require('../__chunks/6BAHKJ5K.cjs');
-require('../__chunks/DPLHWKRP.cjs');
+var _VAY4A33Acjs = require('../__chunks/VAY4A33A.cjs');
+
+
+var _QFGI3BJEcjs = require('../__chunks/QFGI3BJE.cjs');
+require('../__chunks/R7CSCUVW.cjs');
+require('../__chunks/RWS2MAR2.cjs');
+require('../__chunks/DFFFHQVQ.cjs');
 require('../__chunks/W32FX7DM.cjs');
-require('../__chunks/JKMBJCXA.cjs');
-require('../__chunks/INDMFBTS.cjs');
-require('../__chunks/NBCR3CLP.cjs');
+require('../__chunks/QK4GI6B3.cjs');
+require('../__chunks/COHI5HTS.cjs');
+require('../__chunks/F4RJLWZG.cjs');
 require('../__chunks/56NPFF7P.cjs');
 require('../__chunks/Z3TLXRS7.cjs');
-require('../__chunks/PD5YFDLO.cjs');
+require('../__chunks/TLA46MN6.cjs');
 require('../__chunks/X2GXTE3P.cjs');
 require('../__chunks/VTRMALP6.cjs');
 require('../__chunks/BWQVQDGC.cjs');
@@ -34,11 +36,11 @@ require('../__chunks/CKEXTQ2S.cjs');
 require('../__chunks/NS56XHXG.cjs');
 require('../__chunks/CQSUIL2D.cjs');
 require('../__chunks/OAEUR56W.cjs');
-require('../__chunks/5E5FKYEO.cjs');
+require('../__chunks/L2VQ4YLN.cjs');
 require('../__chunks/AKOG5S2T.cjs');
 require('../__chunks/W6ZRSMO5.cjs');
 require('../__chunks/A2NMYLCG.cjs');
-require('../__chunks/BFLDQF3L.cjs');
+require('../__chunks/GQAB4M3B.cjs');
 require('../__chunks/LHHW5ZQP.cjs');
 require('../__chunks/KSFAO77E.cjs');
 
@@ -46,8 +48,9 @@ require('../__chunks/KSFAO77E.cjs');
 
 
 var _Z5PUIG6Acjs = require('../__chunks/Z5PUIG6A.cjs');
-require('../__chunks/3ULNMLN7.cjs');
-require('../__chunks/I63PYP2U.cjs');
+require('../__chunks/ZZZ5MQHA.cjs');
+require('../__chunks/HSOKUBYY.cjs');
+require('../__chunks/EVNF7KMT.cjs');
 require('../__chunks/5WLTMVVQ.cjs');
 require('../__chunks/7WUTS26Y.cjs');
 
@@ -61,15 +64,18 @@ var useSelectPopover = _Z5PUIG6Acjs.createHook.call(void 0,
     var _b = _a, { store, alwaysVisible } = _b, props = _72I2GWXFcjs.__objRest.call(void 0, _b, ["store", "alwaysVisible"]);
     const context = _I2EPCLS6cjs.useSelectProviderContext.call(void 0, );
     store = store || context;
-    props = _OX7M6AXHcjs.useSelectList.call(void 0, _72I2GWXFcjs.__spreadValues.call(void 0, { store, alwaysVisible }, props));
-    props = _XOHN6PERcjs.usePopover.call(void 0, _72I2GWXFcjs.__spreadValues.call(void 0, { store, alwaysVisible }, props));
+    props = _QMFZ4CLTcjs.useSelectList.call(void 0, _72I2GWXFcjs.__spreadValues.call(void 0, { store, alwaysVisible }, props));
+    props = _VAY4A33Acjs.usePopover.call(void 0, _72I2GWXFcjs.__spreadValues.call(void 0, { store, alwaysVisible }, props));
     return props;
   }
 );
-var SelectPopover = _Z5PUIG6Acjs.createComponent.call(void 0, (props) => {
-  const htmlProps = useSelectPopover(props);
-  return _Z5PUIG6Acjs.createElement.call(void 0, "div", htmlProps);
-});
+var SelectPopover = _QFGI3BJEcjs.createDialogComponent.call(void 0, 
+  _Z5PUIG6Acjs.createComponent.call(void 0, (props) => {
+    const htmlProps = useSelectPopover(props);
+    return _Z5PUIG6Acjs.createElement.call(void 0, "div", htmlProps);
+  }),
+  _I2EPCLS6cjs.useSelectProviderContext
+);
 if (process.env.NODE_ENV !== "production") {
   SelectPopover.displayName = "SelectPopover";
 }

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

@@ -16,18 +16,19 @@ import type { SelectListOptions } from "./select-list.js";
  */
 export declare const useSelectPopover: import("../utils/types.js").Hook<SelectPopoverOptions<"div">>;
 /**
- * Renders a select popover. The `role` prop is set to `listbox` by default, but
- * can be overriden by any other valid select popup role (`listbox`, `menu`,
- * `tree`, `grid` or `dialog`).
+ * Renders a select popover. The `role` attribute is set to `listbox` by
+ * default, but can be overriden by any other valid select popup role
+ * (`listbox`, `menu`, `tree`, `grid` or `dialog`).
  * @see https://ariakit.org/components/select
  * @example
- * ```jsx
- * const select = useSelectStore();
- * <Select store={select} />
- * <SelectPopover store={select}>
- *   <SelectItem value="Apple" />
- *   <SelectItem value="Orange" />
- * </SelectPopover>
+ * ```jsx {3-6}
+ * <SelectProvider>
+ *   <Select />
+ *   <SelectPopover>
+ *     <SelectItem value="Apple" />
+ *     <SelectItem value="Orange" />
+ *   </SelectPopover>
+ * </SelectProvider>
  * ```
  */
 export declare const SelectPopover: import("../utils/types.js").Component<SelectPopoverOptions<"div">>;

package/cjs/select/select-provider.cjs

@@ -1,22 +1,22 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});
 
-var _DMTOMUIMcjs = require('../__chunks/DMTOMUIM.cjs');
+var _QBOBT66Ycjs = require('../__chunks/QBOBT66Y.cjs');
 require('../__chunks/ZBG4TGVL.cjs');
 
 
 var _I2EPCLS6cjs = require('../__chunks/I2EPCLS6.cjs');
-require('../__chunks/FWCQCCG3.cjs');
-require('../__chunks/GCTYF2Y6.cjs');
+require('../__chunks/232HWSNY.cjs');
+require('../__chunks/76UBACFC.cjs');
 require('../__chunks/H7R5D2FR.cjs');
 require('../__chunks/NHZBX2RS.cjs');
 require('../__chunks/AKOG5S2T.cjs');
 require('../__chunks/W6ZRSMO5.cjs');
 require('../__chunks/A2NMYLCG.cjs');
 require('../__chunks/Z5PUIG6A.cjs');
-require('../__chunks/E4C2KZA5.cjs');
-require('../__chunks/NATUYKIW.cjs');
-require('../__chunks/3ULNMLN7.cjs');
-require('../__chunks/I63PYP2U.cjs');
+require('../__chunks/O6SYRTZH.cjs');
+require('../__chunks/ZZZ5MQHA.cjs');
+require('../__chunks/HSOKUBYY.cjs');
+require('../__chunks/EVNF7KMT.cjs');
 require('../__chunks/5WLTMVVQ.cjs');
 require('../__chunks/7WUTS26Y.cjs');
 require('../__chunks/72I2GWXF.cjs');
@@ -24,7 +24,7 @@ require('../__chunks/72I2GWXF.cjs');
 // src/select/select-provider.tsx
 var _jsxruntime = require('react/jsx-runtime');
 function SelectProvider(props = {}) {
-  const store = _DMTOMUIMcjs.useSelectStore.call(void 0, props);
+  const store = _QBOBT66Ycjs.useSelectStore.call(void 0, props);
   return /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _I2EPCLS6cjs.SelectContextProvider, { value: store, children: props.children });
 }
 

package/cjs/select/select-renderer.cjs

@@ -1,10 +1,10 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});
 
-var _SKVJLFWScjs = require('../__chunks/SKVJLFWS.cjs');
+var _6UYPIKG4cjs = require('../__chunks/6UYPIKG4.cjs');
 
 
 
-var _BPPAZUXPcjs = require('../__chunks/BPPAZUXP.cjs');
+var _J37FS72Ucjs = require('../__chunks/J37FS72U.cjs');
 
 
 var _I2EPCLS6cjs = require('../__chunks/I2EPCLS6.cjs');
@@ -19,7 +19,7 @@ require('../__chunks/A2NMYLCG.cjs');
 var _Z5PUIG6Acjs = require('../__chunks/Z5PUIG6A.cjs');
 
 
-var _I63PYP2Ucjs = require('../__chunks/I63PYP2U.cjs');
+var _EVNF7KMTcjs = require('../__chunks/EVNF7KMT.cjs');
 require('../__chunks/5WLTMVVQ.cjs');
 require('../__chunks/7WUTS26Y.cjs');
 
@@ -71,14 +71,14 @@ function useSelectRenderer(_a) {
   ]);
   const context = _I2EPCLS6cjs.useSelectContext.call(void 0, );
   store = store || context;
-  const items = _I63PYP2Ucjs.useStoreState.call(void 0, store, (state) => {
+  const items = _EVNF7KMTcjs.useStoreState.call(void 0, store, (state) => {
     if (!state)
       return itemsProp;
     if (!state.mounted)
       return 0;
     return itemsProp != null ? itemsProp : state.items;
   });
-  const value = _I63PYP2Ucjs.useStoreState.call(void 0, store, (state) => valueProp != null ? valueProp : state == null ? void 0 : state.value);
+  const value = _EVNF7KMTcjs.useStoreState.call(void 0, store, (state) => valueProp != null ? valueProp : state == null ? void 0 : state.value);
   const valueIndices = _react.useMemo.call(void 0, () => {
     if (!items)
       return [];
@@ -96,7 +96,7 @@ function useSelectRenderer(_a) {
     }
     return valueIndices;
   }, [valueIndices, persistentIndicesProp]);
-  return _SKVJLFWScjs.useCompositeRenderer.call(void 0, _72I2GWXFcjs.__spreadValues.call(void 0, {
+  return _6UYPIKG4cjs.useCompositeRenderer.call(void 0, _72I2GWXFcjs.__spreadValues.call(void 0, {
     store,
     items,
     persistentIndices
@@ -110,4 +110,4 @@ var SelectRenderer = _Z5PUIG6Acjs.forwardRef.call(void 0, function SelectRendere
 
 
 
-exports.SelectRenderer = SelectRenderer; exports.getSelectRendererItem = _BPPAZUXPcjs.getCollectionRendererItem; exports.getSelectRendererItemId = _BPPAZUXPcjs.getCollectionRendererItemId;
+exports.SelectRenderer = SelectRenderer; exports.getSelectRendererItem = _J37FS72Ucjs.getCollectionRendererItem; exports.getSelectRendererItemId = _J37FS72Ucjs.getCollectionRendererItemId;

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

@@ -21,26 +21,31 @@ export declare const useSelectRow: import("../utils/types.js").Hook<SelectRowOpt
  * Renders a select row.
  * @see https://ariakit.org/components/select
  * @example
- * ```jsx
- * const select = useSelectStore();
- * <Select store={select} />
- * <SelectPopover store={select}>
- *   <SelectRow>
- *     <SelectItem value="Apple" />
- *     <SelectItem value="Orange" />
- *   </SelectRow>
- *   <SelectRow>
- *     <SelectItem value="Banana" />
- *     <SelectItem value="Grape" />
- *   </SelectRow>
- * </SelectPopover>
+ * ```jsx {4-11}
+ * <SelectProvider>
+ *   <Select />
+ *   <SelectPopover>
+ *     <SelectRow>
+ *       <SelectItem value="Apple" />
+ *       <SelectItem value="Orange" />
+ *     </SelectRow>
+ *     <SelectRow>
+ *       <SelectItem value="Banana" />
+ *       <SelectItem value="Grape" />
+ *     </SelectRow>
+ *   </SelectPopover>
+ * </SelectProvider>
  * ```
  */
 export declare const SelectRow: import("../utils/types.js").Component<SelectRowOptions<"div">>;
 export interface SelectRowOptions<T extends As = "div"> extends CompositeRowOptions<T> {
     /**
-     * Object returned by the `useSelectStore` hook. If not provided, the parent
-     * `SelectList` or `SelectPopover` components' context will be used.
+     * Object returned by the
+     * [`useSelectStore`](https://ariakit.org/reference/use-select-store) hook. If
+     * not provided, the parent
+     * [`SelectList`](https://ariakit.org/reference/select-list) or
+     * [`SelectPopover`](https://ariakit.org/reference/select-popover) components'
+     * context will be used.
      */
     store?: SelectStore;
 }

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

@@ -21,22 +21,27 @@ export declare const useSelectSeparator: import("../utils/types.js").Hook<Select
  * Renders a separator element for select items.
  * @see https://ariakit.org/components/select
  * @example
- * ```jsx
- * const select = useSelectStore();
- * <Select store={select} />
- * <SelectPopover store={select}>
- *   <SelectItem value="Item 1" />
- *   <SelectSeparator />
- *   <SelectItem value="Item 2" />
- *   <SelectItem value="Item 3" />
- * </SelectPopover>
+ * ```jsx {5}
+ * <SelectProvider>
+ *   <Select />
+ *   <SelectPopover>
+ *     <SelectItem value="Item 1" />
+ *     <SelectSeparator />
+ *     <SelectItem value="Item 2" />
+ *     <SelectItem value="Item 3" />
+ *   </SelectPopover>
+ * </SelectProvider>
  * ```
  */
 export declare const SelectSeparator: import("../utils/types.js").Component<SelectSeparatorOptions<"hr">>;
 export interface SelectSeparatorOptions<T extends As = "hr"> extends CompositeSeparatorOptions<T> {
     /**
-     * Object returned by the `useSelectStore` hook. If not provided, the parent
-     * `SelectList` or `SelectPopover` components' context will be used.
+     * Object returned by the
+     * [`useSelectStore`](https://ariakit.org/reference/use-select-store) hook. If
+     * not provided, the parent
+     * [`SelectList`](https://ariakit.org/reference/select-list) or
+     * [`SelectPopover`](https://ariakit.org/reference/select-popover) components'
+     * context will be used.
      */
     store?: SelectStore;
 }

package/cjs/select/select-store.cjs

@@ -1,24 +1,24 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});
 
 
-var _DMTOMUIMcjs = require('../__chunks/DMTOMUIM.cjs');
+var _QBOBT66Ycjs = require('../__chunks/QBOBT66Y.cjs');
 require('../__chunks/ZBG4TGVL.cjs');
-require('../__chunks/FWCQCCG3.cjs');
-require('../__chunks/GCTYF2Y6.cjs');
+require('../__chunks/232HWSNY.cjs');
+require('../__chunks/76UBACFC.cjs');
 require('../__chunks/H7R5D2FR.cjs');
 require('../__chunks/NHZBX2RS.cjs');
 require('../__chunks/AKOG5S2T.cjs');
 require('../__chunks/W6ZRSMO5.cjs');
 require('../__chunks/A2NMYLCG.cjs');
 require('../__chunks/Z5PUIG6A.cjs');
-require('../__chunks/E4C2KZA5.cjs');
-require('../__chunks/NATUYKIW.cjs');
-require('../__chunks/3ULNMLN7.cjs');
-require('../__chunks/I63PYP2U.cjs');
+require('../__chunks/O6SYRTZH.cjs');
+require('../__chunks/ZZZ5MQHA.cjs');
+require('../__chunks/HSOKUBYY.cjs');
+require('../__chunks/EVNF7KMT.cjs');
 require('../__chunks/5WLTMVVQ.cjs');
 require('../__chunks/7WUTS26Y.cjs');
 require('../__chunks/72I2GWXF.cjs');
 
 
 
-exports.useSelectStore = _DMTOMUIMcjs.useSelectStore; exports.useSelectStoreProps = _DMTOMUIMcjs.useSelectStoreProps;
+exports.useSelectStore = _QBOBT66Ycjs.useSelectStore; exports.useSelectStoreProps = _QBOBT66Ycjs.useSelectStoreProps;

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

@@ -40,10 +40,6 @@ export interface SelectStoreOptions<T extends Value = Value> extends Core.Select
     /**
      * Function that will be called when the `value` state changes.
      * @param value The new value.
-     * @example
-     * function MySelect({ value, onChange }) {
-     *   const select = useSelectStore({ value, setValue: onChange });
-     * }
      */
     setValue?: BivariantCallback<(value: SelectStoreState<T>["value"]) => void>;
     /**

package/cjs/select/select.cjs

@@ -1,10 +1,10 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});
 
-var _2VQBXUAIcjs = require('../__chunks/2VQBXUAI.cjs');
-require('../__chunks/LCKU3TYW.cjs');
-require('../__chunks/JNVNPB37.cjs');
+var _YLOTLD6Scjs = require('../__chunks/YLOTLD6S.cjs');
+require('../__chunks/35G5ZXPH.cjs');
+require('../__chunks/VGU6RMHO.cjs');
 require('../__chunks/XH2CZ7VF.cjs');
-require('../__chunks/ZQTMT453.cjs');
+require('../__chunks/EZKYHQVF.cjs');
 
 
 var _FTX6TAJCcjs = require('../__chunks/FTX6TAJC.cjs');
@@ -16,14 +16,14 @@ var _DC66R2NYcjs = require('../__chunks/DC66R2NY.cjs');
 
 
 var _I2EPCLS6cjs = require('../__chunks/I2EPCLS6.cjs');
-require('../__chunks/NPDPNCSD.cjs');
+require('../__chunks/HWZH54NB.cjs');
 require('../__chunks/KLZID3QO.cjs');
 require('../__chunks/H7R5D2FR.cjs');
 require('../__chunks/NHZBX2RS.cjs');
 require('../__chunks/AKOG5S2T.cjs');
 require('../__chunks/W6ZRSMO5.cjs');
 require('../__chunks/A2NMYLCG.cjs');
-require('../__chunks/BFLDQF3L.cjs');
+require('../__chunks/GQAB4M3B.cjs');
 require('../__chunks/LHHW5ZQP.cjs');
 
 
@@ -272,7 +272,7 @@ var useSelect = _Z5PUIG6Acjs.createHook.call(void 0,
       onKeyDown,
       onMouseDown
     });
-    props = _2VQBXUAIcjs.usePopoverDisclosure.call(void 0, _72I2GWXFcjs.__spreadValues.call(void 0, { store, toggleOnClick }, props));
+    props = _YLOTLD6Scjs.usePopoverDisclosure.call(void 0, _72I2GWXFcjs.__spreadValues.call(void 0, { store, toggleOnClick }, props));
     props = _DC66R2NYcjs.useCompositeTypeahead.call(void 0, _72I2GWXFcjs.__spreadValues.call(void 0, { store }, props));
     return props;
   }

package/cjs/select/select.d.ts

@@ -19,44 +19,66 @@ export declare const useSelect: import("../utils/types.js").Hook<SelectOptions<"
  * Renders a select button.
  * @see https://ariakit.org/components/select
  * @example
- * ```jsx
- * const select = useSelectStore();
- * <Select store={select} />
- * <SelectPopover store={select}>
- *   <SelectItem value="Apple" />
- *   <SelectItem value="Orange" />
- * </SelectPopover>
+ * ```jsx {2}
+ * <SelectProvider>
+ *   <Select />
+ *   <SelectPopover>
+ *     <SelectItem value="Apple" />
+ *     <SelectItem value="Orange" />
+ *   </SelectPopover>
+ * </SelectProvider>
  * ```
  */
 export declare const Select: import("../utils/types.js").Component<SelectOptions<"button">>;
 export interface SelectOptions<T extends As = "button"> extends PopoverDisclosureOptions<T>, CompositeTypeaheadOptions<T>, Pick<SelectHTMLAttributes<HTMLSelectElement>, "name" | "form" | "required"> {
     /**
-     * Object returned by the `useSelectStore` hook.
+     * Object returned by the
+     * [`useSelectStore`](https://ariakit.org/reference/use-select-store) hook. If
+     * not provided, the closest
+     * [`SelectProvider`](https://ariakit.org/reference/select-provider)
+     * component's context will be used.
      */
     store?: SelectStore;
     /**
-     * Determines whether the select list will be shown when the user presses
-     * arrow keys while the select element is focused.
+     * Determines whether the
+     * [`SelectList`](https://ariakit.org/reference/select-list) or
+     * [`SelectPopover`](https://ariakit.org/reference/select-popover) components
+     * will be shown when the user presses arrow keys while the select element is
+     * focused.
+     *
+     * Live examples:
+     * - [Select grid](https://ariakit.org/examples/select-grid)
      * @default true
      */
     showOnKeyDown?: BooleanOrCallback<KeyboardEvent<HTMLElement>>;
     /**
-     * Determines whether pressing arrow keys will move the active item even
-     * when the select list is hidden.
+     * Determines whether pressing arrow keys will move the active item even when
+     * the [`SelectList`](https://ariakit.org/reference/select-list) or
+     * [`SelectPopover`](https://ariakit.org/reference/select-popover) components
+     * is hidden.
      * @default false
      */
     moveOnKeyDown?: BooleanOrCallback<KeyboardEvent<HTMLElement>>;
     /**
-     * Determines whether `store.toggle()` will be called on click. By default,
-     * the select list will be shown on press (on mouse down and on key down).
-     * If this prop is set to `true`, the select list will be shown on click
-     * instead.
+     * Determines whether
+     * [`toggle`](https://ariakit.org/reference/use-select-store#toggle) will be
+     * called on click. By default, the
+     * [`SelectList`](https://ariakit.org/reference/select-list) or
+     * [`SelectPopover`](https://ariakit.org/reference/select-popover) components
+     * will be shown on press (on mouse down and on key down). If this prop is set
+     * to `true`, the [`SelectList`](https://ariakit.org/reference/select-list) or
+     * [`SelectPopover`](https://ariakit.org/reference/select-popover) components
+     * will be shown on click instead.
      * @default false
      */
     toggleOnClick?: BooleanOrCallback<MouseEvent<HTMLElement>>;
     /**
      * Determines whether pressing space, enter or mouse down will toggle the
-     * select list. This will be ignored if `toggleOnClick` is set to `true`.
+     * [`SelectList`](https://ariakit.org/reference/select-list) or
+     * [`SelectPopover`](https://ariakit.org/reference/select-popover) components.
+     * This prop will be ignored if
+     * [`toggleOnClick`](https://ariakit.org/reference/select#toggleonclick) is
+     * set to `true`.
      * @default true
      */
     toggleOnPress?: BooleanOrCallback<MouseEvent<HTMLElement> | KeyboardEvent<HTMLElement>>;

package/cjs/tab/tab-list.cjs

@@ -4,11 +4,11 @@
 var _HBZJ2UC5cjs = require('../__chunks/HBZJ2UC5.cjs');
 
 
-var _6G5GJF5Qcjs = require('../__chunks/6G5GJF5Q.cjs');
+var _SELCJFCBcjs = require('../__chunks/SELCJFCB.cjs');
 require('../__chunks/KLZID3QO.cjs');
 require('../__chunks/H7R5D2FR.cjs');
 require('../__chunks/NHZBX2RS.cjs');
-require('../__chunks/BFLDQF3L.cjs');
+require('../__chunks/GQAB4M3B.cjs');
 require('../__chunks/LHHW5ZQP.cjs');
 
 
@@ -47,7 +47,7 @@ var useTabList = _Z5PUIG6Acjs.createHook.call(void 0, (_a) => {
     role: "tablist",
     "aria-orientation": orientation
   }, props);
-  props = _6G5GJF5Qcjs.useComposite.call(void 0, _72I2GWXFcjs.__spreadValues.call(void 0, { store }, props));
+  props = _SELCJFCBcjs.useComposite.call(void 0, _72I2GWXFcjs.__spreadValues.call(void 0, { store }, props));
   return props;
 });
 var TabList = _Z5PUIG6Acjs.createComponent.call(void 0, (props) => {

package/cjs/tab/tab-list.d.ts

@@ -21,20 +21,25 @@ export declare const useTabList: import("../utils/types.js").Hook<TabListOptions
  * Renders a tab list element.
  * @see https://ariakit.org/components/tab
  * @example
- * ```jsx
- * const tab = useTabStore();
- * <TabList store={tab}>
- *   <Tab>Tab 1</Tab>
- *   <Tab>Tab 2</Tab>
- * </TabList>
- * <TabPanel store={tab}>Panel 1</TabPanel>
- * <TabPanel store={tab}>Panel 2</TabPanel>
+ * ```jsx {2-5}
+ * <TabProvider>
+ *   <TabList>
+ *     <Tab>Tab 1</Tab>
+ *     <Tab>Tab 2</Tab>
+ *   </TabList>
+ *   <TabPanel>Panel 1</TabPanel>
+ *   <TabPanel>Panel 2</TabPanel>
+ * </TabProvider>
  * ```
  */
 export declare const TabList: import("../utils/types.js").Component<TabListOptions<"div">>;
 export interface TabListOptions<T extends As = "div"> extends CompositeOptions<T> {
     /**
-     * Object returned by the `useTabStore` hook.
+     * Object returned by the
+     * [`useTabStore`](https://ariakit.org/reference/use-tab-store) hook. If not
+     * provided, the closest
+     * [`TabProvider`](https://ariakit.org/reference/tab-provider) component's
+     * context will be used.
      */
     store?: TabStore;
 }