@ariakit/react-core 0.3.12 → 0.3.13

package/esm/popover/popover-arrow.d.ts

@@ -16,11 +16,12 @@ import type { PopoverStore } from "./popover-store.js";
 export declare const usePopoverArrow: import("../utils/types.js").Hook<PopoverArrowOptions<"div">>;
 /**
  * Renders an arrow inside a [`Popover`](https://ariakit.org/reference/popover)
- * component.
+ * component pointing to the anchor element.
  * @see https://ariakit.org/components/popover
  * @example
- * ```jsx
+ * ```jsx {4}
  * <PopoverProvider>
+ *   <PopoverAnchor />
  *   <Popover>
  *     <PopoverArrow />
  *     Popover
@@ -41,6 +42,9 @@ export interface PopoverArrowOptions<T extends As = "div"> extends Options<T> {
     store?: PopoverStore;
     /**
      * The size of the arrow.
+     *
+     * Live examples:
+     * - [Selection Popover](https://ariakit.org/examples/popover-selection)
      * @default 30
      */
     size?: number;

package/esm/popover/popover-description.d.ts

@@ -20,7 +20,7 @@ export declare const usePopoverDescription: import("../utils/types.js").Hook<Pop
  * prop is properly set on the popover element.
  * @see https://ariakit.org/components/popover
  * @example
- * ```jsx
+ * ```jsx {3}
  * <PopoverProvider>
  *   <Popover>
  *     <PopoverDescription>Description</PopoverDescription>

package/esm/popover/popover-disclosure-arrow.d.ts

@@ -21,7 +21,7 @@ export declare const usePopoverDisclosureArrow: import("../utils/types.js").Hook
  * component.
  * @see https://ariakit.org/components/popover
  * @example
- * ```jsx
+ * ```jsx {4}
  * <PopoverProvider>
  *   <PopoverDisclosure>
  *     Disclosure
@@ -43,9 +43,11 @@ export interface PopoverDisclosureArrowOptions<T extends As = "span"> extends Op
      */
     store?: PopoverStore;
     /**
-     * Placement to which the arrow should point. If not provided, the parent
-     * [`PopoverDisclosure`](https://ariakit.org/reference/popover-disclosure)
-     * component's context will be used.
+     * Arrow's placement direction. If not provided, it will be inferred from the
+     * context.
+     *
+     * Live examples:
+     * - [Sliding Menu](https://ariakit.org/examples/menu-slide)
      */
     placement?: PopoverStoreState["placement"];
 }

package/esm/popover/popover-disclosure.d.ts

@@ -14,10 +14,11 @@ import type { PopoverAnchorOptions } from "./popover-anchor.js";
  */
 export declare const usePopoverDisclosure: import("../utils/types.js").Hook<PopoverDisclosureOptions<"button">>;
 /**
- * Renders a button that controls the visibility of the popover when clicked.
+ * Renders a button that controls the visibility of the
+ * [`Popover`](https://ariakit.org/reference/popover) component when clicked.
  * @see https://ariakit.org/components/popover
  * @example
- * ```jsx
+ * ```jsx {2}
  * <PopoverProvider>
  *   <PopoverDisclosure>Disclosure</PopoverDisclosure>
  *   <Popover>Popover</Popover>

package/esm/popover/popover-disclosure.js

@@ -2,16 +2,16 @@
 import {
   PopoverDisclosure,
   usePopoverDisclosure
-} from "../__chunks/4ZEZYKUR.js";
-import "../__chunks/H3TG2CZP.js";
-import "../__chunks/BHEJ6NUH.js";
+} from "../__chunks/PHR7QED4.js";
+import "../__chunks/PUBUTPR6.js";
+import "../__chunks/CM2MGWJJ.js";
 import "../__chunks/JCH6MLL2.js";
-import "../__chunks/VDNZBO4W.js";
-import "../__chunks/NWCBQ4CV.js";
+import "../__chunks/JH4A3V7P.js";
+import "../__chunks/BVNGIDQK.js";
 import "../__chunks/7H5KSHHF.js";
 import "../__chunks/G6BJYYBK.js";
 import "../__chunks/OAYFXAQ2.js";
-import "../__chunks/KK7H3W2B.js";
+import "../__chunks/54DTKZT5.js";
 import "../__chunks/SHA3WOPI.js";
 import "../__chunks/3ORBWXWF.js";
 import "../__chunks/6O5OEQGF.js";

package/esm/popover/popover-dismiss.d.ts

@@ -19,7 +19,7 @@ export declare const usePopoverDismiss: import("../utils/types.js").Hook<Popover
  * [`Popover`](https://ariakit.org/reference/popover) component when clicked.
  * @see https://ariakit.org/components/popover
  * @example
- * ```jsx
+ * ```jsx {3}
  * <PopoverProvider>
  *   <Popover>
  *     <PopoverDismiss />

package/esm/popover/popover-dismiss.js

@@ -2,14 +2,14 @@
 import {
   PopoverDismiss,
   usePopoverDismiss
-} from "../__chunks/F6PRXTDU.js";
-import "../__chunks/NKXUN25E.js";
-import "../__chunks/VDNZBO4W.js";
-import "../__chunks/NWCBQ4CV.js";
+} from "../__chunks/O4GQD6D6.js";
+import "../__chunks/H67RUTIW.js";
+import "../__chunks/JH4A3V7P.js";
+import "../__chunks/BVNGIDQK.js";
 import "../__chunks/7H5KSHHF.js";
 import "../__chunks/G6BJYYBK.js";
 import "../__chunks/OAYFXAQ2.js";
-import "../__chunks/KK7H3W2B.js";
+import "../__chunks/54DTKZT5.js";
 import "../__chunks/SHA3WOPI.js";
 import "../__chunks/3ORBWXWF.js";
 import "../__chunks/6O5OEQGF.js";

package/esm/popover/popover-heading.d.ts

@@ -20,7 +20,7 @@ export declare const usePopoverHeading: import("../utils/types.js").Hook<Popover
  * prop is properly set on the popover element.
  * @see https://ariakit.org/components/popover
  * @example
- * ```jsx
+ * ```jsx {3}
  * <PopoverProvider>
  *   <Popover>
  *     <PopoverHeading>Heading</PopoverHeading>

package/esm/popover/popover-provider.d.ts

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

package/esm/popover/popover-store.d.ts

@@ -3,7 +3,8 @@ import type { DialogStoreFunctions, DialogStoreOptions, DialogStoreState } from
 import type { Store } from "../utils/store.js";
 export declare function usePopoverStoreProps<T extends Core.PopoverStore>(store: T, update: () => void, props: PopoverStoreProps): T;
 /**
- * Creates a popover store.
+ * Creates a popover store to control the state of
+ * [Popover](https://ariakit.org/components/popover) components.
  * @see https://ariakit.org/components/popover
  * @example
  * ```jsx

package/esm/popover/popover.d.ts

@@ -20,10 +20,11 @@ type AnchorRect = {
  */
 export declare const usePopover: import("../utils/types.js").Hook<PopoverOptions<"div">>;
 /**
- * Renders a popover element.
+ * Renders a popover element that's automatically positioned relative to an
+ * anchor element.
  * @see https://ariakit.org/components/popover
  * @example
- * ```jsx
+ * ```jsx {3}
  * <PopoverProvider>
  *   <PopoverDisclosure>Disclosure</PopoverDisclosure>
  *   <Popover>Popover</Popover>
@@ -46,6 +47,7 @@ export interface PopoverOptions<T extends As = "div"> extends DialogOptions<T> {
      *
      * Live examples:
      * - [Navigation Menubar](https://ariakit.org/examples/menubar-navigation)
+     * - [Sliding Menu](https://ariakit.org/examples/menu-slide)
      */
     wrapperProps?: HTMLAttributes<HTMLDivElement>;
     /**
@@ -71,6 +73,7 @@ export interface PopoverOptions<T extends As = "div"> extends DialogOptions<T> {
      * negative values to make the popover shift to the opposite side.
      *
      * Live examples:
+     * - [Combobox with tabs](https://ariakit.org/examples/combobox-tabs)
      * - [Navigation Menubar](https://ariakit.org/examples/menubar-navigation)
      * - [Submenu](https://ariakit.org/examples/menu-nested)
      * - [Menubar](https://ariakit.org/components/menubar)
@@ -136,6 +139,9 @@ export interface PopoverOptions<T extends As = "div"> extends DialogOptions<T> {
      * The minimum padding between the popover and the viewport edge. This will be
      * exposed to CSS as
      * [`--popover-overflow-padding`](https://ariakit.org/guide/styling#--popover-overflow-padding).
+     *
+     * Live examples:
+     * - [Sliding Menu](https://ariakit.org/examples/menu-slide)
      * @default 8
      */
     overflowPadding?: number;
@@ -148,7 +154,6 @@ export interface PopoverOptions<T extends As = "div"> extends DialogOptions<T> {
      *  - [Standalone Popover](https://ariakit.org/examples/popover-standalone)
      *  - [Context menu](https://ariakit.org/examples/menu-context-menu)
      *  - [Selection Popover](https://ariakit.org/examples/popover-selection)
-     * @param anchor The anchor element.
      */
     getAnchorRect?: (anchor: HTMLElement | null) => AnchorRect | null;
     /**

package/esm/popover/popover.js

@@ -2,10 +2,10 @@
 import {
   Popover,
   usePopover
-} from "../__chunks/A6XC27R5.js";
-import "../__chunks/PGAEII2Q.js";
+} from "../__chunks/A2OYJMGS.js";
+import "../__chunks/SNX6RSV7.js";
 import "../__chunks/LWHPHW7Q.js";
-import "../__chunks/CLF4PQ7T.js";
+import "../__chunks/TQYOGOE2.js";
 import "../__chunks/BULCTPRV.js";
 import "../__chunks/6BJGLK2C.js";
 import "../__chunks/CS347UVZ.js";
@@ -13,11 +13,11 @@ import "../__chunks/IUB2BTEK.js";
 import "../__chunks/XHJGS6Z5.js";
 import "../__chunks/TL67WVI6.js";
 import "../__chunks/MKDDWKFK.js";
+import "../__chunks/72E5EPFF.js";
 import "../__chunks/OOBDFMJL.js";
+import "../__chunks/X6WIMZJE.js";
 import "../__chunks/677M2CI3.js";
 import "../__chunks/6GXEOXGT.js";
-import "../__chunks/72E5EPFF.js";
-import "../__chunks/X6WIMZJE.js";
 import "../__chunks/HPP6CWMY.js";
 import "../__chunks/UYRJLDVS.js";
 import "../__chunks/JPXNJYSO.js";
@@ -29,7 +29,7 @@ import "../__chunks/CLE7NTOY.js";
 import "../__chunks/7H5KSHHF.js";
 import "../__chunks/G6BJYYBK.js";
 import "../__chunks/OAYFXAQ2.js";
-import "../__chunks/KK7H3W2B.js";
+import "../__chunks/54DTKZT5.js";
 import "../__chunks/SHA3WOPI.js";
 import "../__chunks/BG6HZDS7.js";
 import "../__chunks/3ORBWXWF.js";

package/esm/portal/portal.d.ts

@@ -11,7 +11,21 @@ import type { As, Options, Props } from "../utils/types.js";
  */
 export declare const usePortal: import("../utils/types.js").Hook<PortalOptions<"div">>;
 /**
- * Renders an element using `ReactDOM.createPortal`.
+ * Renders an element using [React
+ * Portal](https://react.dev/reference/react-dom/createPortal).
+ *
+ * By default, the portal element is a `div` element appended to the
+ * `document.body` element. You can customize this with the
+ * [`portalElement`](https://ariakit.org/reference/portal#portalelement) prop.
+ *
+ * The
+ * [`preserveTabOrder`](https://ariakit.org/reference/portal#preservetaborder)
+ * prop allows this component to manage the tab order of the elements. It
+ * ensures the tab order remains consistent with the original location where the
+ * portal was rendered in the React tree, instead of the final location in the
+ * DOM. The
+ * [`preserveTabOrderAnchor`](https://ariakit.org/reference/portal#preservetaborderanchor)
+ * prop can specify a different location from which the tab order is preserved.
  * @see https://ariakit.org/components/portal
  * @example
  * ```jsx
@@ -71,6 +85,9 @@ export interface PortalOptions<T extends As = "div"> extends Options<T> {
      * `portalRef` is similar to `ref` but is scoped to the portal node. It's
      * useful when you need to be informed when the portal element is appended to
      * the DOM or removed from the DOM.
+     *
+     * Live examples:
+     * - [Form with Select](https://ariakit.org/examples/form-select)
      * @example
      * ```jsx
      * const [portalElement, setPortalElement] = useState(null);

package/esm/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/esm/radio/radio-group.js

@@ -5,11 +5,11 @@ import {
 } from "../__chunks/XEV62JUQ.js";
 import {
   useComposite
-} from "../__chunks/7QTPYGNZ.js";
+} from "../__chunks/2P5JZHCE.js";
 import "../__chunks/3IEDWLST.js";
 import "../__chunks/IB7YUKH5.js";
 import "../__chunks/4UUKJZ4V.js";
-import "../__chunks/KK7H3W2B.js";
+import "../__chunks/54DTKZT5.js";
 import "../__chunks/SHA3WOPI.js";
 import {
   createComponent,

package/esm/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/esm/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/esm/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/esm/radio/radio.js

@@ -2,15 +2,15 @@
 import {
   Radio,
   useRadio
-} from "../__chunks/JL6IRDFK.js";
+} from "../__chunks/ZICNKKFD.js";
 import "../__chunks/XEV62JUQ.js";
-import "../__chunks/QZLXIDNP.js";
-import "../__chunks/NWCBQ4CV.js";
+import "../__chunks/W7TET3D7.js";
+import "../__chunks/BVNGIDQK.js";
 import "../__chunks/UH3I23HL.js";
 import "../__chunks/3IEDWLST.js";
 import "../__chunks/IB7YUKH5.js";
 import "../__chunks/4UUKJZ4V.js";
-import "../__chunks/KK7H3W2B.js";
+import "../__chunks/54DTKZT5.js";
 import "../__chunks/SHA3WOPI.js";
 import "../__chunks/3ORBWXWF.js";
 import "../__chunks/EKQEJRUF.js";

package/esm/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/esm/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/esm/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/esm/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/esm/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/esm/select/select-item.js

@@ -8,8 +8,8 @@ import {
 } from "../__chunks/5HVNGX6D.js";
 import {
   useCompositeItem
-} from "../__chunks/QZLXIDNP.js";
-import "../__chunks/NWCBQ4CV.js";
+} from "../__chunks/W7TET3D7.js";
+import "../__chunks/BVNGIDQK.js";
 import "../__chunks/UH3I23HL.js";
 import "../__chunks/3IEDWLST.js";
 import "../__chunks/IB7YUKH5.js";
@@ -17,7 +17,7 @@ import "../__chunks/4UUKJZ4V.js";
 import "../__chunks/7H5KSHHF.js";
 import "../__chunks/G6BJYYBK.js";
 import "../__chunks/OAYFXAQ2.js";
-import "../__chunks/KK7H3W2B.js";
+import "../__chunks/54DTKZT5.js";
 import "../__chunks/SHA3WOPI.js";
 import {
   createElement,

package/esm/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/esm/select/select-list.js

@@ -2,10 +2,10 @@
 import {
   SelectList,
   useSelectList
-} from "../__chunks/SU2GU5JB.js";
+} from "../__chunks/OYQPK2TA.js";
 import "../__chunks/346FK57L.js";
 import "../__chunks/5HVNGX6D.js";
-import "../__chunks/7QTPYGNZ.js";
+import "../__chunks/2P5JZHCE.js";
 import "../__chunks/3IEDWLST.js";
 import "../__chunks/IB7YUKH5.js";
 import "../__chunks/4UUKJZ4V.js";
@@ -13,7 +13,7 @@ import "../__chunks/CLE7NTOY.js";
 import "../__chunks/7H5KSHHF.js";
 import "../__chunks/G6BJYYBK.js";
 import "../__chunks/OAYFXAQ2.js";
-import "../__chunks/KK7H3W2B.js";
+import "../__chunks/54DTKZT5.js";
 import "../__chunks/SHA3WOPI.js";
 import "../__chunks/3ORBWXWF.js";
 import "../__chunks/EKQEJRUF.js";