@ariakit/react-core 0.3.12 → 0.3.13

package/cjs/radio/radio-group.d.cts

@@ -16,15 +16,17 @@ import type { RadioStore } from "./radio-store.js";
  */
 export declare const useRadioGroup: import("../utils/types.js").Hook<RadioGroupOptions<"div">>;
 /**
- * Renders a radio group element.
+ * Renders a [`radiogroup`](https://w3c.github.io/aria/#radiogroup) element that
+ * manages a group of [`Radio`](https://ariakit.org/reference/radio) elements.
  * @see https://ariakit.org/components/radio
  * @example
  * ```jsx
- * const radio = useRadioStore();
- * <RadioGroup store={radio}>
- *   <Radio value="Apple" />
- *   <Radio value="Orange" />
- * </RadioGroup>
+ * <RadioProvider>
+ *   <RadioGroup>
+ *     <Radio value="Apple" />
+ *     <Radio value="Orange" />
+ *   </RadioGroup>
+ * </RadioProvider>
  * ```
  */
 export declare const RadioGroup: import("../utils/types.js").Component<RadioGroupOptions<"div">>;

package/cjs/radio/radio-group.d.ts

@@ -16,15 +16,17 @@ import type { RadioStore } from "./radio-store.js";
  */
 export declare const useRadioGroup: import("../utils/types.js").Hook<RadioGroupOptions<"div">>;
 /**
- * Renders a radio group element.
+ * Renders a [`radiogroup`](https://w3c.github.io/aria/#radiogroup) element that
+ * manages a group of [`Radio`](https://ariakit.org/reference/radio) elements.
  * @see https://ariakit.org/components/radio
  * @example
  * ```jsx
- * const radio = useRadioStore();
- * <RadioGroup store={radio}>
- *   <Radio value="Apple" />
- *   <Radio value="Orange" />
- * </RadioGroup>
+ * <RadioProvider>
+ *   <RadioGroup>
+ *     <Radio value="Apple" />
+ *     <Radio value="Orange" />
+ *   </RadioGroup>
+ * </RadioProvider>
  * ```
  */
 export declare const RadioGroup: import("../utils/types.js").Component<RadioGroupOptions<"div">>;

package/cjs/radio/radio-provider.d.cts

@@ -1,7 +1,8 @@
 import type { ReactNode } from "react";
 import type { RadioStoreProps } from "./radio-store.js";
 /**
- * Provides a radio store to Radio components.
+ * Provides a radio store to [Radio](https://ariakit.org/components/radio)
+ * components.
  * @see https://ariakit.org/components/radio
  * @example
  * ```jsx

package/cjs/radio/radio-provider.d.ts

@@ -1,7 +1,8 @@
 import type { ReactNode } from "react";
 import type { RadioStoreProps } from "./radio-store.js";
 /**
- * Provides a radio store to Radio components.
+ * Provides a radio store to [Radio](https://ariakit.org/components/radio)
+ * components.
  * @see https://ariakit.org/components/radio
  * @example
  * ```jsx

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

@@ -3,11 +3,13 @@ import type { CompositeStoreFunctions, CompositeStoreOptions, CompositeStoreStat
 import type { Store } from "../utils/store.js";
 export declare function useRadioStoreProps<T extends Core.RadioStore>(store: T, update: () => void, props: RadioStoreProps): T;
 /**
- * Creates a radio store.
+ * Creates a radio store to control the state of
+ * [Radio](https://ariakit.org/components/radio) components.
  * @see https://ariakit.org/components/radio
  * @example
  * ```jsx
  * const radio = useRadioStore();
+ *
  * <RadioGroup store={radio}>
  *   <Radio value="Apple" />
  *   <Radio value="Orange" />
@@ -21,7 +23,9 @@ export interface RadioStoreFunctions extends Core.RadioStoreFunctions, Composite
 }
 export interface RadioStoreOptions extends Core.RadioStoreOptions, CompositeStoreOptions {
     /**
-     * Function that will be called when the `value` state changes.
+     * Function that will be called when the
+     * [`value`](https://ariakit.org/reference/radio-provider#value) state
+     * changes.
      */
     setValue?: (value: RadioStoreState["value"]) => void;
 }

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

@@ -3,11 +3,13 @@ import type { CompositeStoreFunctions, CompositeStoreOptions, CompositeStoreStat
 import type { Store } from "../utils/store.js";
 export declare function useRadioStoreProps<T extends Core.RadioStore>(store: T, update: () => void, props: RadioStoreProps): T;
 /**
- * Creates a radio store.
+ * Creates a radio store to control the state of
+ * [Radio](https://ariakit.org/components/radio) components.
  * @see https://ariakit.org/components/radio
  * @example
  * ```jsx
  * const radio = useRadioStore();
+ *
  * <RadioGroup store={radio}>
  *   <Radio value="Apple" />
  *   <Radio value="Orange" />
@@ -21,7 +23,9 @@ export interface RadioStoreFunctions extends Core.RadioStoreFunctions, Composite
 }
 export interface RadioStoreOptions extends Core.RadioStoreOptions, CompositeStoreOptions {
     /**
-     * Function that will be called when the `value` state changes.
+     * Function that will be called when the
+     * [`value`](https://ariakit.org/reference/radio-provider#value) state
+     * changes.
      */
     setValue?: (value: RadioStoreState["value"]) => void;
 }

package/cjs/radio/radio.cjs

@@ -2,15 +2,15 @@
 
 
 
-var _G2ZXRZ2Rcjs = require('../__chunks/G2ZXRZ2R.cjs');
+var _MMRX6FNScjs = require('../__chunks/MMRX6FNS.cjs');
 require('../__chunks/HEEQY4DZ.cjs');
-require('../__chunks/IO6J4PAN.cjs');
-require('../__chunks/DAJUUBUI.cjs');
+require('../__chunks/GSETTLOU.cjs');
+require('../__chunks/OSTQZD2E.cjs');
 require('../__chunks/R5A2WTWB.cjs');
 require('../__chunks/6ZZYUFPW.cjs');
 require('../__chunks/UZNYSPKP.cjs');
 require('../__chunks/BZTDJIVT.cjs');
-require('../__chunks/Z3GCTNW4.cjs');
+require('../__chunks/VUEWHLYH.cjs');
 require('../__chunks/75KXQZJX.cjs');
 require('../__chunks/RNZNGEL4.cjs');
 require('../__chunks/OLOZ5JT2.cjs');
@@ -20,4 +20,4 @@ require('../__chunks/AV6KTKLE.cjs');
 
 
 
-exports.Radio = _G2ZXRZ2Rcjs.Radio; exports.useRadio = _G2ZXRZ2Rcjs.useRadio;
+exports.Radio = _MMRX6FNScjs.Radio; exports.useRadio = _MMRX6FNScjs.useRadio;

package/cjs/radio/radio.d.cts

@@ -18,15 +18,17 @@ import type { RadioStore } from "./radio-store.js";
  */
 export declare const useRadio: import("../utils/types.js").Hook<RadioOptions<"input">>;
 /**
- * Renders a radio button element.
+ * Renders a radio button element that's typically wrapped in a
+ * [`RadioGroup`](https://ariakit.org/reference/radio-group) component.
  * @see https://ariakit.org/components/radio
  * @example
- * ```jsx
- * const radio = useRadioStore();
- * <RadioGroup store={radio}>
- *   <Radio value="Apple" />
- *   <Radio value="Orange" />
- * </RadioGroup>
+ * ```jsx {3-4}
+ * <RadioProvider>
+ *   <RadioGroup>
+ *     <Radio value="Apple" />
+ *     <Radio value="Orange" />
+ *   </RadioGroup>
+ * </RadioProvider>
  * ```
  */
 export declare const Radio: import("../utils/types.js").Component<RadioOptions<"input">>;
@@ -40,20 +42,26 @@ export interface RadioOptions<T extends As = "input"> extends CompositeItemOptio
      * context will be used.
      */
     store?: RadioStore;
-    /**
-     * The native `name` attribute.
-     */
-    name?: string;
     /**
      * The value of the radio button.
+     *
+     * Live examples:
+     * - [FormRadio](https://ariakit.org/examples/form-radio)
+     * - [MenuItemRadio](https://ariakit.org/examples/menu-item-radio)
      */
     value: string | number;
     /**
-     * Whether the radio button is checked.
+     * The native `name` attribute.
+     */
+    name?: string;
+    /**
+     * Determines if the radio button is checked. Using this prop will make the
+     * radio button controlled and override the
+     * [`value`](https://ariakit.org/reference/radio-provider#value) state.
      */
     checked?: boolean;
     /**
-     * Callback function that is called when the radio button store changes.
+     * Callback function that is called when the radio button state changes.
      */
     onChange?: BivariantCallback<(event: SyntheticEvent<HTMLInputElement>) => void>;
 }

package/cjs/radio/radio.d.ts

@@ -18,15 +18,17 @@ import type { RadioStore } from "./radio-store.js";
  */
 export declare const useRadio: import("../utils/types.js").Hook<RadioOptions<"input">>;
 /**
- * Renders a radio button element.
+ * Renders a radio button element that's typically wrapped in a
+ * [`RadioGroup`](https://ariakit.org/reference/radio-group) component.
  * @see https://ariakit.org/components/radio
  * @example
- * ```jsx
- * const radio = useRadioStore();
- * <RadioGroup store={radio}>
- *   <Radio value="Apple" />
- *   <Radio value="Orange" />
- * </RadioGroup>
+ * ```jsx {3-4}
+ * <RadioProvider>
+ *   <RadioGroup>
+ *     <Radio value="Apple" />
+ *     <Radio value="Orange" />
+ *   </RadioGroup>
+ * </RadioProvider>
  * ```
  */
 export declare const Radio: import("../utils/types.js").Component<RadioOptions<"input">>;
@@ -40,20 +42,26 @@ export interface RadioOptions<T extends As = "input"> extends CompositeItemOptio
      * context will be used.
      */
     store?: RadioStore;
-    /**
-     * The native `name` attribute.
-     */
-    name?: string;
     /**
      * The value of the radio button.
+     *
+     * Live examples:
+     * - [FormRadio](https://ariakit.org/examples/form-radio)
+     * - [MenuItemRadio](https://ariakit.org/examples/menu-item-radio)
      */
     value: string | number;
     /**
-     * Whether the radio button is checked.
+     * The native `name` attribute.
+     */
+    name?: string;
+    /**
+     * Determines if the radio button is checked. Using this prop will make the
+     * radio button controlled and override the
+     * [`value`](https://ariakit.org/reference/radio-provider#value) state.
      */
     checked?: boolean;
     /**
-     * Callback function that is called when the radio button store changes.
+     * Callback function that is called when the radio button state changes.
      */
     onChange?: BivariantCallback<(event: SyntheticEvent<HTMLInputElement>) => void>;
 }

package/cjs/role/role.d.cts

@@ -14,9 +14,9 @@ type RoleElements = {
  */
 export declare const useRole: import("../utils/types.js").Hook<RoleOptions<"div">>;
 /**
- * Renders an abstract element that supports the `render` prop a `wrapElement`
- * prop that can be used to wrap the underlying element with React Portal,
- * Context or other component types.
+ * Renders an abstract element that supports the `render` prop and a
+ * `wrapElement` prop that can be used to wrap the underlying element with React
+ * Portal, Context or other component types.
  * @see https://ariakit.org/components/role
  * @example
  * ```jsx

package/cjs/role/role.d.ts

@@ -14,9 +14,9 @@ type RoleElements = {
  */
 export declare const useRole: import("../utils/types.js").Hook<RoleOptions<"div">>;
 /**
- * Renders an abstract element that supports the `render` prop a `wrapElement`
- * prop that can be used to wrap the underlying element with React Portal,
- * Context or other component types.
+ * Renders an abstract element that supports the `render` prop and a
+ * `wrapElement` prop that can be used to wrap the underlying element with React
+ * Portal, Context or other component types.
  * @see https://ariakit.org/components/role
  * @example
  * ```jsx

package/cjs/select/select-group-label.d.cts

@@ -16,8 +16,8 @@ import type { SelectStore } from "./select-store.js";
 export declare const useSelectGroupLabel: import("../utils/types.js").Hook<SelectGroupLabelOptions<"div">>;
 /**
  * Renders a label in a select group. This component must be wrapped with
- * `SelectGroup` so the `aria-labelledby` prop is properly set on the select
- * group element.
+ * [`SelectGroup`](https://ariakit.org/reference/select-group) so the
+ * `aria-labelledby` prop is properly set on the select group element.
  * @see https://ariakit.org/components/select
  * @example
  * ```jsx {5,10}

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

@@ -16,8 +16,8 @@ import type { SelectStore } from "./select-store.js";
 export declare const useSelectGroupLabel: import("../utils/types.js").Hook<SelectGroupLabelOptions<"div">>;
 /**
  * Renders a label in a select group. This component must be wrapped with
- * `SelectGroup` so the `aria-labelledby` prop is properly set on the select
- * group element.
+ * [`SelectGroup`](https://ariakit.org/reference/select-group) so the
+ * `aria-labelledby` prop is properly set on the select group element.
  * @see https://ariakit.org/components/select
  * @example
  * ```jsx {5,10}

package/cjs/select/select-group.d.cts

@@ -20,7 +20,10 @@ import type { SelectStore } from "./select-store.js";
  */
 export declare const useSelectGroup: import("../utils/types.js").Hook<SelectGroupOptions<"div">>;
 /**
- * Renders a select group.
+ * Renders a group for [`SelectItem`](https://ariakit.org/reference/select-item)
+ * elements. Optionally, a
+ * [`SelectGroupLabel`](https://ariakit.org/reference/select-group-label) can be
+ * rendered as a child to provide a label for the group.
  * @see https://ariakit.org/components/select
  * @example
  * ```jsx {4-8}

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

@@ -20,7 +20,10 @@ import type { SelectStore } from "./select-store.js";
  */
 export declare const useSelectGroup: import("../utils/types.js").Hook<SelectGroupOptions<"div">>;
 /**
- * Renders a select group.
+ * Renders a group for [`SelectItem`](https://ariakit.org/reference/select-item)
+ * elements. Optionally, a
+ * [`SelectGroupLabel`](https://ariakit.org/reference/select-group-label) can be
+ * rendered as a child to provide a label for the group.
  * @see https://ariakit.org/components/select
  * @example
  * ```jsx {4-8}

package/cjs/select/select-item-check.d.cts

@@ -14,9 +14,14 @@ import type { SelectStore } from "./select-store.js";
  */
 export declare const useSelectItemCheck: import("../utils/types.js").Hook<SelectItemCheckOptions<"span">>;
 /**
- * Renders a checkmark inside a `SelectItem` component. This component must be
- * wrapped with `SelectItem` or the `checked` prop must be explicitly passed to
- * the component.
+ * Renders a checkmark icon when the
+ * [`checked`](https://ariakit.org/reference/select-item-check#checked) prop is
+ * `true`. The icon can be overridden by providing a different one as children.
+ *
+ * When rendered inside a
+ * [`SelectItem`](https://ariakit.org/reference/select-item) component, the
+ * [`checked`](https://ariakit.org/reference/select-item-check#checked) prop is
+ * automatically derived from the context.
  * @see https://ariakit.org/components/select
  * @example
  * ```jsx {5,9}
@@ -39,19 +44,8 @@ export declare const SelectItemCheck: import("../utils/types.js").Component<Sele
 export interface SelectItemCheckOptions<T extends As = "span"> extends CheckboxCheckOptions<T> {
     /**
      * 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.
+     * [`useSelectStore`](https://ariakit.org/reference/use-select-store) hook.
      */
     store?: SelectStore;
-    /**
-     * Whether the check mark should be shown. This value is automatically
-     * inferred from the parent
-     * [`SelectItem`](https://ariakit.org/reference/select-item) component.
-     * Manually setting this prop will override the inferred value.
-     */
-    checked?: boolean;
 }
 export type SelectItemCheckProps<T extends As = "span"> = Props<SelectItemCheckOptions<T>>;

package/cjs/select/select-item-check.d.ts

@@ -14,9 +14,14 @@ import type { SelectStore } from "./select-store.js";
  */
 export declare const useSelectItemCheck: import("../utils/types.js").Hook<SelectItemCheckOptions<"span">>;
 /**
- * Renders a checkmark inside a `SelectItem` component. This component must be
- * wrapped with `SelectItem` or the `checked` prop must be explicitly passed to
- * the component.
+ * Renders a checkmark icon when the
+ * [`checked`](https://ariakit.org/reference/select-item-check#checked) prop is
+ * `true`. The icon can be overridden by providing a different one as children.
+ *
+ * When rendered inside a
+ * [`SelectItem`](https://ariakit.org/reference/select-item) component, the
+ * [`checked`](https://ariakit.org/reference/select-item-check#checked) prop is
+ * automatically derived from the context.
  * @see https://ariakit.org/components/select
  * @example
  * ```jsx {5,9}
@@ -39,19 +44,8 @@ export declare const SelectItemCheck: import("../utils/types.js").Component<Sele
 export interface SelectItemCheckOptions<T extends As = "span"> extends CheckboxCheckOptions<T> {
     /**
      * 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.
+     * [`useSelectStore`](https://ariakit.org/reference/use-select-store) hook.
      */
     store?: SelectStore;
-    /**
-     * Whether the check mark should be shown. This value is automatically
-     * inferred from the parent
-     * [`SelectItem`](https://ariakit.org/reference/select-item) component.
-     * Manually setting this prop will override the inferred value.
-     */
-    checked?: boolean;
 }
 export type SelectItemCheckProps<T extends As = "span"> = Props<SelectItemCheckOptions<T>>;

package/cjs/select/select-item.cjs

@@ -8,8 +8,8 @@ var _IPYAEPOTcjs = require('../__chunks/IPYAEPOT.cjs');
 var _2WCJJQSKcjs = require('../__chunks/2WCJJQSK.cjs');
 
 
-var _IO6J4PANcjs = require('../__chunks/IO6J4PAN.cjs');
-require('../__chunks/DAJUUBUI.cjs');
+var _GSETTLOUcjs = require('../__chunks/GSETTLOU.cjs');
+require('../__chunks/OSTQZD2E.cjs');
 require('../__chunks/R5A2WTWB.cjs');
 require('../__chunks/6ZZYUFPW.cjs');
 require('../__chunks/UZNYSPKP.cjs');
@@ -17,7 +17,7 @@ require('../__chunks/BZTDJIVT.cjs');
 require('../__chunks/UVBBMANL.cjs');
 require('../__chunks/F2A2ZQDB.cjs');
 require('../__chunks/S6UU7NA4.cjs');
-require('../__chunks/Z3GCTNW4.cjs');
+require('../__chunks/VUEWHLYH.cjs');
 require('../__chunks/75KXQZJX.cjs');
 
 
@@ -152,7 +152,7 @@ var useSelectItem = _RNZNGEL4cjs.createHook.call(void 0,
       autoFocus: (_a2 = props.autoFocus) != null ? _a2 : autoFocus,
       onClick
     });
-    props = _IO6J4PANcjs.useCompositeItem.call(void 0, _AV6KTKLEcjs.__spreadValues.call(void 0, {
+    props = _GSETTLOUcjs.useCompositeItem.call(void 0, _AV6KTKLEcjs.__spreadValues.call(void 0, {
       store,
       getItem,
       preventScrollOnKeyDown

package/cjs/select/select-item.d.cts

@@ -70,7 +70,7 @@ export interface SelectItemOptions<T extends As = "div"> extends CompositeItemOp
      * - [Form with Select](https://ariakit.org/examples/form-select)
      * - [Animated Select](https://ariakit.org/examples/select-animated)
      * - [Select with Combobox](https://ariakit.org/examples/select-combobox)
-     * - [Select grid](https://ariakit.org/examples/select-grid)
+     * - [Select Grid](https://ariakit.org/examples/select-grid)
      * - [SelectGroup](https://ariakit.org/examples/select-group)
      * - [Select with custom
      *   item](https://ariakit.org/examples/select-item-custom)
@@ -93,9 +93,5 @@ export interface SelectItemOptions<T extends As = "div"> extends CompositeItemOp
      * provided.
      */
     setValueOnClick?: BooleanOrCallback<MouseEvent<HTMLElement>>;
-    /**
-     * @default true
-     */
-    preventScrollOnKeyDown?: CompositeItemOptions["preventScrollOnKeyDown"];
 }
 export type SelectItemProps<T extends As = "div"> = Props<SelectItemOptions<T>>;

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

@@ -70,7 +70,7 @@ export interface SelectItemOptions<T extends As = "div"> extends CompositeItemOp
      * - [Form with Select](https://ariakit.org/examples/form-select)
      * - [Animated Select](https://ariakit.org/examples/select-animated)
      * - [Select with Combobox](https://ariakit.org/examples/select-combobox)
-     * - [Select grid](https://ariakit.org/examples/select-grid)
+     * - [Select Grid](https://ariakit.org/examples/select-grid)
      * - [SelectGroup](https://ariakit.org/examples/select-group)
      * - [Select with custom
      *   item](https://ariakit.org/examples/select-item-custom)
@@ -93,9 +93,5 @@ export interface SelectItemOptions<T extends As = "div"> extends CompositeItemOp
      * provided.
      */
     setValueOnClick?: BooleanOrCallback<MouseEvent<HTMLElement>>;
-    /**
-     * @default true
-     */
-    preventScrollOnKeyDown?: CompositeItemOptions["preventScrollOnKeyDown"];
 }
 export type SelectItemProps<T extends As = "div"> = Props<SelectItemOptions<T>>;

package/cjs/select/select-list.cjs

@@ -2,10 +2,10 @@
 
 
 
-var _XA62Y24Zcjs = require('../__chunks/XA62Y24Z.cjs');
+var _GGMSVQ4Gcjs = require('../__chunks/GGMSVQ4G.cjs');
 require('../__chunks/6PUZ4NWR.cjs');
 require('../__chunks/2WCJJQSK.cjs');
-require('../__chunks/H6OLBVHA.cjs');
+require('../__chunks/R7ERL264.cjs');
 require('../__chunks/6ZZYUFPW.cjs');
 require('../__chunks/UZNYSPKP.cjs');
 require('../__chunks/BZTDJIVT.cjs');
@@ -13,7 +13,7 @@ require('../__chunks/YPVQYY4J.cjs');
 require('../__chunks/UVBBMANL.cjs');
 require('../__chunks/F2A2ZQDB.cjs');
 require('../__chunks/S6UU7NA4.cjs');
-require('../__chunks/Z3GCTNW4.cjs');
+require('../__chunks/VUEWHLYH.cjs');
 require('../__chunks/75KXQZJX.cjs');
 require('../__chunks/RNZNGEL4.cjs');
 require('../__chunks/OLOZ5JT2.cjs');
@@ -23,4 +23,4 @@ require('../__chunks/AV6KTKLE.cjs');
 
 
 
-exports.SelectList = _XA62Y24Zcjs.SelectList; exports.useSelectList = _XA62Y24Zcjs.useSelectList;
+exports.SelectList = _GGMSVQ4Gcjs.SelectList; exports.useSelectList = _GGMSVQ4Gcjs.useSelectList;

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

@@ -20,11 +20,14 @@ import type { SelectStore } from "./select-store.js";
  */
 export declare const useSelectList: import("../utils/types.js").Hook<SelectListOptions<"div">>;
 /**
- * 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`).
+ * Renders a select list element. This is the primitive component used by the
+ * [`SelectPopover`](https://ariakit.org/reference/select-popover) component.
  *
- * The `aria-labelledby` attribute is set to the
+ * Unlike [`SelectPopover`](https://ariakit.org/reference/select-popover), this
+ * component doesn't render a popover and therefore doesn't automatically focus
+ * on items when opened.
+ *
+ * The `aria-labelledby` prop is set to the
  * [`Select`](https://ariakit.org/reference/select) element's `id` by default.
  * @see https://ariakit.org/components/select
  * @example

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

@@ -20,11 +20,14 @@ import type { SelectStore } from "./select-store.js";
  */
 export declare const useSelectList: import("../utils/types.js").Hook<SelectListOptions<"div">>;
 /**
- * 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`).
+ * Renders a select list element. This is the primitive component used by the
+ * [`SelectPopover`](https://ariakit.org/reference/select-popover) component.
  *
- * The `aria-labelledby` attribute is set to the
+ * Unlike [`SelectPopover`](https://ariakit.org/reference/select-popover), this
+ * component doesn't render a popover and therefore doesn't automatically focus
+ * on items when opened.
+ *
+ * The `aria-labelledby` prop is set to the
  * [`Select`](https://ariakit.org/reference/select) element's `id` by default.
  * @see https://ariakit.org/components/select
  * @example

package/cjs/select/select-popover.cjs

@@ -1,23 +1,23 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});"use client";
 
 
-var _XA62Y24Zcjs = require('../__chunks/XA62Y24Z.cjs');
+var _GGMSVQ4Gcjs = require('../__chunks/GGMSVQ4G.cjs');
 require('../__chunks/6PUZ4NWR.cjs');
 
 
 var _2WCJJQSKcjs = require('../__chunks/2WCJJQSK.cjs');
-require('../__chunks/H6OLBVHA.cjs');
+require('../__chunks/R7ERL264.cjs');
 require('../__chunks/6ZZYUFPW.cjs');
 require('../__chunks/UZNYSPKP.cjs');
 require('../__chunks/BZTDJIVT.cjs');
 
 
-var _KDG57VZVcjs = require('../__chunks/KDG57VZV.cjs');
+var _CIZTEPFOcjs = require('../__chunks/CIZTEPFO.cjs');
 
 
-var _EKB76T2Ucjs = require('../__chunks/EKB76T2U.cjs');
+var _FGHQW2WScjs = require('../__chunks/FGHQW2WS.cjs');
 require('../__chunks/WZ3DRKGP.cjs');
-require('../__chunks/NKR65BKC.cjs');
+require('../__chunks/KSPMHEYZ.cjs');
 require('../__chunks/PZL34OVO.cjs');
 require('../__chunks/344F3DYO.cjs');
 require('../__chunks/KREY6HXD.cjs');
@@ -25,11 +25,11 @@ require('../__chunks/5ZOCN23X.cjs');
 require('../__chunks/JVDUGICD.cjs');
 require('../__chunks/VV6WA3I6.cjs');
 require('../__chunks/7YLCVXZ7.cjs');
+require('../__chunks/5GTNIPQ6.cjs');
 require('../__chunks/7TN63K2T.cjs');
+require('../__chunks/V24PR4PW.cjs');
 require('../__chunks/6IUEXB4L.cjs');
 require('../__chunks/JF225FQ5.cjs');
-require('../__chunks/5GTNIPQ6.cjs');
-require('../__chunks/V24PR4PW.cjs');
 require('../__chunks/7566TIRW.cjs');
 require('../__chunks/J3OG6T3B.cjs');
 require('../__chunks/65LGW5LY.cjs');
@@ -41,7 +41,7 @@ require('../__chunks/YPVQYY4J.cjs');
 require('../__chunks/UVBBMANL.cjs');
 require('../__chunks/F2A2ZQDB.cjs');
 require('../__chunks/S6UU7NA4.cjs');
-require('../__chunks/Z3GCTNW4.cjs');
+require('../__chunks/VUEWHLYH.cjs');
 require('../__chunks/75KXQZJX.cjs');
 require('../__chunks/R66IWXK6.cjs');
 
@@ -65,12 +65,12 @@ var useSelectPopover = _RNZNGEL4cjs.createHook.call(void 0,
     var _b = _a, { store, alwaysVisible } = _b, props = _AV6KTKLEcjs.__objRest.call(void 0, _b, ["store", "alwaysVisible"]);
     const context = _2WCJJQSKcjs.useSelectProviderContext.call(void 0, );
     store = store || context;
-    props = _XA62Y24Zcjs.useSelectList.call(void 0, _AV6KTKLEcjs.__spreadValues.call(void 0, { store, alwaysVisible }, props));
-    props = _KDG57VZVcjs.usePopover.call(void 0, _AV6KTKLEcjs.__spreadValues.call(void 0, { store, alwaysVisible }, props));
+    props = _GGMSVQ4Gcjs.useSelectList.call(void 0, _AV6KTKLEcjs.__spreadValues.call(void 0, { store, alwaysVisible }, props));
+    props = _CIZTEPFOcjs.usePopover.call(void 0, _AV6KTKLEcjs.__spreadValues.call(void 0, { store, alwaysVisible }, props));
     return props;
   }
 );
-var SelectPopover = _EKB76T2Ucjs.createDialogComponent.call(void 0, 
+var SelectPopover = _FGHQW2WScjs.createDialogComponent.call(void 0, 
   _RNZNGEL4cjs.createComponent.call(void 0, (props) => {
     const htmlProps = useSelectPopover(props);
     return _RNZNGEL4cjs.createElement.call(void 0, "div", htmlProps);

package/cjs/select/select-provider.d.cts

@@ -3,7 +3,8 @@ import type { PickRequired } from "@ariakit/core/utils/types";
 import type { SelectStoreProps, SelectStoreValue } from "./select-store.js";
 type Value = SelectStoreValue;
 /**
- * Provides a select store to Select components.
+ * Provides a select store to [Select](https://ariakit.org/components/select)
+ * components.
  * @see https://ariakit.org/components/select
  * @example
  * ```jsx