@ariakit/react-core 0.3.1 → 0.3.3

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

@@ -16,27 +16,31 @@ import type { SelectStore } from "./select-store.js";
  */
 export declare const useSelectLabel: import("../utils/types.js").Hook<SelectLabelOptions<"div">>;
 /**
- * Renders a label for the `Select` component. Since it's not a native select
- * element, we can't use the native label element. The `SelectLabel` component
- * will move focus and click on the `Select` component when the user clicks on
- * the label.
+ * Renders a label for the [`Select`](https://ariakit.org/reference/select)
+ * component. Since it's not a native select element, we can't use the native
+ * label element. This component will move focus and click on the
+ * [`Select`](https://ariakit.org/reference/select) component when clicked.
  * @see https://ariakit.org/components/select
  * @example
- * ```jsx
- * const select = useSelectStore({ defaultValue: "Apple" });
- * <SelectLabel store={select}>Favorite fruit</SelectLabel>
- * <Select store={select} />
- * <SelectPopover store={select}>
- *   <SelectItem value="Apple" />
- *   <SelectItem value="Orange" />
- * </SelectPopover>
+ * ```jsx {2}
+ * <SelectProvider defaultValue="Apple">
+ *   <SelectLabel>Favorite fruit</SelectLabel>
+ *   <Select />
+ *   <SelectPopover>
+ *     <SelectItem value="Apple" />
+ *     <SelectItem value="Orange" />
+ *   </SelectPopover>
+ * </SelectProvider>
  * ```
  */
 export declare const SelectLabel: import("../utils/types.js").Component<SelectLabelOptions<"div">>;
 export interface SelectLabelOptions<T extends As = "div"> extends Options<T> {
     /**
-     * Object returned by the `useSelectStore` hook. If not provided, the parent
-     * `Select` component's context will be used.
+     * 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;
 }

package/cjs/select/select-list.cjs

@@ -1,10 +1,10 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});
 
 
-var _OX7M6AXHcjs = require('../__chunks/OX7M6AXH.cjs');
+var _2U6ETSVZcjs = require('../__chunks/2U6ETSVZ.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');
@@ -12,7 +12,7 @@ require('../__chunks/5E5FKYEO.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/5WLTMVVQ.cjs');
@@ -21,4 +21,4 @@ require('../__chunks/72I2GWXF.cjs');
 
 
 
-exports.SelectList = _OX7M6AXHcjs.SelectList; exports.useSelectList = _OX7M6AXHcjs.useSelectList;
+exports.SelectList = _2U6ETSVZcjs.SelectList; exports.useSelectList = _2U6ETSVZcjs.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,28 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});
 
-var _OX7M6AXHcjs = require('../__chunks/OX7M6AXH.cjs');
+var _2U6ETSVZcjs = require('../__chunks/2U6ETSVZ.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 _PHDU6PLMcjs = require('../__chunks/PHDU6PLM.cjs');
-require('../__chunks/ZEASCR4B.cjs');
-require('../__chunks/J63NAJOO.cjs');
-require('../__chunks/6BAHKJ5K.cjs');
-require('../__chunks/DPLHWKRP.cjs');
+var _WUQKDMC4cjs = require('../__chunks/WUQKDMC4.cjs');
+require('../__chunks/PQU457XU.cjs');
+require('../__chunks/45OYD4CU.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');
@@ -38,7 +38,7 @@ require('../__chunks/5E5FKYEO.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 +46,8 @@ require('../__chunks/KSFAO77E.cjs');
 
 
 var _Z5PUIG6Acjs = require('../__chunks/Z5PUIG6A.cjs');
-require('../__chunks/6MLKTO2T.cjs');
-require('../__chunks/I63PYP2U.cjs');
+require('../__chunks/HRUFFILM.cjs');
+require('../__chunks/UHRHLHM2.cjs');
 require('../__chunks/5WLTMVVQ.cjs');
 require('../__chunks/7WUTS26Y.cjs');
 
@@ -61,8 +61,8 @@ 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 = _PHDU6PLMcjs.usePopover.call(void 0, _72I2GWXFcjs.__spreadValues.call(void 0, { store, alwaysVisible }, props));
+    props = _2U6ETSVZcjs.useSelectList.call(void 0, _72I2GWXFcjs.__spreadValues.call(void 0, { store, alwaysVisible }, props));
+    props = _WUQKDMC4cjs.usePopover.call(void 0, _72I2GWXFcjs.__spreadValues.call(void 0, { store, alwaysVisible }, props));
     return props;
   }
 );

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 _OAQQQ7LScjs = require('../__chunks/OAQQQ7LS.cjs');
+var _J72SOT4Scjs = require('../__chunks/J72SOT4S.cjs');
 require('../__chunks/ZBG4TGVL.cjs');
 
 
 var _I2EPCLS6cjs = require('../__chunks/I2EPCLS6.cjs');
-require('../__chunks/FWCQCCG3.cjs');
-require('../__chunks/GCTYF2Y6.cjs');
+require('../__chunks/JDIVO6OK.cjs');
+require('../__chunks/K5M7LOPE.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/P2EILHN6.cjs');
-require('../__chunks/BPMML63M.cjs');
-require('../__chunks/6MLKTO2T.cjs');
-require('../__chunks/I63PYP2U.cjs');
+require('../__chunks/Z6EBOLR5.cjs');
+require('../__chunks/3MYGLY4O.cjs');
+require('../__chunks/HRUFFILM.cjs');
+require('../__chunks/UHRHLHM2.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 = _OAQQQ7LScjs.useSelectStore.call(void 0, props);
+  const store = _J72SOT4Scjs.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 _O7UGQ5NRcjs = require('../__chunks/O7UGQ5NR.cjs');
 
 
 
-var _BPPAZUXPcjs = require('../__chunks/BPPAZUXP.cjs');
+var _4WUYORFXcjs = require('../__chunks/4WUYORFX.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 _UHRHLHM2cjs = require('../__chunks/UHRHLHM2.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 = _UHRHLHM2cjs.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 = _UHRHLHM2cjs.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 _O7UGQ5NRcjs.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 = _4WUYORFXcjs.getCollectionRendererItem; exports.getSelectRendererItemId = _4WUYORFXcjs.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 _OAQQQ7LScjs = require('../__chunks/OAQQQ7LS.cjs');
+var _J72SOT4Scjs = require('../__chunks/J72SOT4S.cjs');
 require('../__chunks/ZBG4TGVL.cjs');
-require('../__chunks/FWCQCCG3.cjs');
-require('../__chunks/GCTYF2Y6.cjs');
+require('../__chunks/JDIVO6OK.cjs');
+require('../__chunks/K5M7LOPE.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/P2EILHN6.cjs');
-require('../__chunks/BPMML63M.cjs');
-require('../__chunks/6MLKTO2T.cjs');
-require('../__chunks/I63PYP2U.cjs');
+require('../__chunks/Z6EBOLR5.cjs');
+require('../__chunks/3MYGLY4O.cjs');
+require('../__chunks/HRUFFILM.cjs');
+require('../__chunks/UHRHLHM2.cjs');
 require('../__chunks/5WLTMVVQ.cjs');
 require('../__chunks/7WUTS26Y.cjs');
 require('../__chunks/72I2GWXF.cjs');
 
 
 
-exports.useSelectStore = _OAQQQ7LScjs.useSelectStore; exports.useSelectStoreProps = _OAQQQ7LScjs.useSelectStoreProps;
+exports.useSelectStore = _J72SOT4Scjs.useSelectStore; exports.useSelectStoreProps = _J72SOT4Scjs.useSelectStoreProps;

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

@@ -13,7 +13,7 @@ export declare function useSelectStoreProps<T extends Core.SelectStore>(store: T
             <K extends keyof import("@ariakit/core/combobox/combobox-store").ComboboxStoreState>(key: K): import("@ariakit/core/combobox/combobox-store").ComboboxStoreState[K];
             <V>(selector: (state: import("@ariakit/core/combobox/combobox-store").ComboboxStoreState) => V): V;
         };
-    }) | undefined;
+    }) | null | undefined;
 };
 /**
  * Creates a select store.
@@ -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>;
     /**
@@ -55,7 +51,7 @@ export interface SelectStoreOptions<T extends Value = Value> extends Core.Select
      * - [Multi-selectable
      *   Combobox](https://ariakit.org/examples/combobox-multiple)
      */
-    combobox?: ComboboxStore;
+    combobox?: ComboboxStore | null;
 }
 export type SelectStoreProps<T extends Value = Value> = SelectStoreOptions<T> & Core.SelectStoreProps<T>;
 export type SelectStore<T extends Value = Value> = SelectStoreFunctions<T> & Store<Core.SelectStore<T>>;

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 _IK6X277Scjs = require('../__chunks/IK6X277S.cjs');
+require('../__chunks/VI6T32XI.cjs');
+require('../__chunks/RXP7Z4XR.cjs');
 require('../__chunks/XH2CZ7VF.cjs');
-require('../__chunks/ZQTMT453.cjs');
+require('../__chunks/KMOIJMBF.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/FXRXBA2Y.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 = _IK6X277Scjs.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) => {