@ariakit/react-core 0.3.11 → 0.3.13

package/esm/select/select-item.js

@@ -8,23 +8,23 @@ import {
 } from "../__chunks/5HVNGX6D.js";
 import {
   useCompositeItem
-} from "../__chunks/R2WNOXYG.js";
-import "../__chunks/NWCBQ4CV.js";
+} from "../__chunks/W7TET3D7.js";
+import "../__chunks/BVNGIDQK.js";
 import "../__chunks/UH3I23HL.js";
-import "../__chunks/6QXBPV75.js";
+import "../__chunks/3IEDWLST.js";
 import "../__chunks/IB7YUKH5.js";
 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,
   createHook,
   createMemoComponent
 } from "../__chunks/3ORBWXWF.js";
-import "../__chunks/4OZYHFMH.js";
+import "../__chunks/EKQEJRUF.js";
 import {
   useBooleanEvent,
   useEvent,

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,21 +2,21 @@
 import {
   SelectList,
   useSelectList
-} from "../__chunks/7D63S66W.js";
-import "../__chunks/HBGJOTTX.js";
+} from "../__chunks/OYQPK2TA.js";
+import "../__chunks/346FK57L.js";
 import "../__chunks/5HVNGX6D.js";
-import "../__chunks/57KNUQTI.js";
-import "../__chunks/6QXBPV75.js";
+import "../__chunks/2P5JZHCE.js";
+import "../__chunks/3IEDWLST.js";
 import "../__chunks/IB7YUKH5.js";
 import "../__chunks/4UUKJZ4V.js";
-import "../__chunks/KOKHD3Z3.js";
+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/4OZYHFMH.js";
+import "../__chunks/EKQEJRUF.js";
 import "../__chunks/6O5OEQGF.js";
 import "../__chunks/XM66DUTO.js";
 import "../__chunks/4R3V3JGP.js";

package/esm/select/select-popover.js

@@ -1,23 +1,23 @@
 "use client";
 import {
   useSelectList
-} from "../__chunks/7D63S66W.js";
-import "../__chunks/HBGJOTTX.js";
+} from "../__chunks/OYQPK2TA.js";
+import "../__chunks/346FK57L.js";
 import {
   useSelectProviderContext
 } from "../__chunks/5HVNGX6D.js";
-import "../__chunks/57KNUQTI.js";
-import "../__chunks/6QXBPV75.js";
+import "../__chunks/2P5JZHCE.js";
+import "../__chunks/3IEDWLST.js";
 import "../__chunks/IB7YUKH5.js";
 import "../__chunks/4UUKJZ4V.js";
 import {
   usePopover
-} from "../__chunks/SXPADS2D.js";
+} from "../__chunks/A2OYJMGS.js";
 import {
   createDialogComponent
-} from "../__chunks/PDVJHECS.js";
-import "../__chunks/57VLL43X.js";
-import "../__chunks/CLF4PQ7T.js";
+} from "../__chunks/SNX6RSV7.js";
+import "../__chunks/LWHPHW7Q.js";
+import "../__chunks/TQYOGOE2.js";
 import "../__chunks/BULCTPRV.js";
 import "../__chunks/6BJGLK2C.js";
 import "../__chunks/CS347UVZ.js";
@@ -25,11 +25,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";
@@ -37,11 +37,11 @@ import "../__chunks/CHKJ74UC.js";
 import "../__chunks/7452U3HH.js";
 import "../__chunks/XPF5GU3Q.js";
 import "../__chunks/FSFPRQFR.js";
-import "../__chunks/KOKHD3Z3.js";
+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 {
@@ -49,9 +49,9 @@ import {
   createElement,
   createHook
 } from "../__chunks/3ORBWXWF.js";
-import "../__chunks/6SB7F42L.js";
-import "../__chunks/SMM5JVLC.js";
-import "../__chunks/4OZYHFMH.js";
+import "../__chunks/ZSELSBRM.js";
+import "../__chunks/SFCBA2JZ.js";
+import "../__chunks/EKQEJRUF.js";
 import "../__chunks/6O5OEQGF.js";
 import "../__chunks/XM66DUTO.js";
 import {

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

@@ -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

package/esm/select/select-provider.js

@@ -1,23 +1,23 @@
 "use client";
 import {
   useSelectStore
-} from "../__chunks/DYLO4TTE.js";
+} from "../__chunks/FMVHAVXA.js";
 import "../__chunks/W76OTZCC.js";
 import {
   SelectContextProvider
 } from "../__chunks/5HVNGX6D.js";
-import "../__chunks/A6ER4BO6.js";
-import "../__chunks/HDMIVTNE.js";
+import "../__chunks/7GBW5FLS.js";
+import "../__chunks/Y6GYTNQ2.js";
 import "../__chunks/IB7YUKH5.js";
 import "../__chunks/4UUKJZ4V.js";
 import "../__chunks/7H5KSHHF.js";
 import "../__chunks/G6BJYYBK.js";
 import "../__chunks/OAYFXAQ2.js";
 import "../__chunks/3ORBWXWF.js";
-import "../__chunks/EENTNM7A.js";
-import "../__chunks/6SB7F42L.js";
-import "../__chunks/SMM5JVLC.js";
-import "../__chunks/4OZYHFMH.js";
+import "../__chunks/MG4P3223.js";
+import "../__chunks/ZSELSBRM.js";
+import "../__chunks/SFCBA2JZ.js";
+import "../__chunks/EKQEJRUF.js";
 import "../__chunks/6O5OEQGF.js";
 import "../__chunks/XM66DUTO.js";
 import "../__chunks/4R3V3JGP.js";

package/esm/select/select-renderer.d.ts

@@ -18,7 +18,7 @@ export interface SelectRendererOptions<T extends Item = any> extends Omit<Compos
     /**
      * Object returned by the
      * [`useSelectStore`](https://ariakit.org/reference/use-select-store) hook. If
-     * not provided, the parent [Select](https://ariakit.org/components/select)
+     * not provided, the closest [Select](https://ariakit.org/components/select)
      * component's context will be used.
      *
      * The store [`items`](https://ariakit.org/reference/use-select-store#items)

package/esm/select/select-renderer.js

@@ -1,11 +1,11 @@
 "use client";
 import {
   useCompositeRenderer
-} from "../__chunks/6L5IUFNE.js";
+} from "../__chunks/KSKI4NLV.js";
 import {
   getCollectionRendererItem,
   getCollectionRendererItemId
-} from "../__chunks/GD2VG2KJ.js";
+} from "../__chunks/4HD64GHO.js";
 import {
   useSelectContext
 } from "../__chunks/5HVNGX6D.js";
@@ -20,7 +20,7 @@ import {
 } from "../__chunks/3ORBWXWF.js";
 import {
   useStoreState
-} from "../__chunks/4OZYHFMH.js";
+} from "../__chunks/EKQEJRUF.js";
 import "../__chunks/6O5OEQGF.js";
 import "../__chunks/XM66DUTO.js";
 import {

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

@@ -18,7 +18,10 @@ import type { SelectStore } from "./select-store.js";
  */
 export declare const useSelectRow: import("../utils/types.js").Hook<SelectRowOptions<"div">>;
 /**
- * Renders a select row.
+ * Renders a select row that allows two-dimensional arrow key navigation.
+ * [`SelectItem`](https://ariakit.org/reference/select-item) elements wrapped
+ * within this component will automatically receive a
+ * [`rowId`](https://ariakit.org/reference/select-item#rowid) prop.
  * @see https://ariakit.org/components/select
  * @example
  * ```jsx {4-11}

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

@@ -18,7 +18,8 @@ import type { SelectStore } from "./select-store.js";
  */
 export declare const useSelectSeparator: import("../utils/types.js").Hook<SelectSeparatorOptions<"hr">>;
 /**
- * Renders a separator element for select items.
+ * Renders a divider between
+ * [`SelectItem`](https://ariakit.org/reference/select-item) elements.
  * @see https://ariakit.org/components/select
  * @example
  * ```jsx {5}

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

@@ -8,11 +8,13 @@ export declare function useSelectStoreProps<T extends Core.SelectStore>(store: T
     combobox: ComboboxStore<import("@ariakit/core/combobox/combobox-store").ComboboxStoreSelectedValue> | null | undefined;
 };
 /**
- * Creates a select store.
+ * Creates a select store to control the state of
+ * [Select](https://ariakit.org/components/select) components.
  * @see https://ariakit.org/components/select
  * @example
  * ```jsx
  * const select = useSelectStore({ defaultValue: "Apple" });
+ *
  * <Select store={select} />
  * <SelectPopover store={select}>
  *   <SelectItem value="Apple" />
@@ -31,18 +33,23 @@ export interface SelectStoreFunctions<T extends SelectStoreValue = SelectStoreVa
 }
 export interface SelectStoreOptions<T extends SelectStoreValue = SelectStoreValue> extends Core.SelectStoreOptions<T>, CompositeStoreOptions<SelectStoreItem>, PopoverStoreOptions {
     /**
-     * Function that will be called when the `value` state changes.
-     * @param value The new value.
+     * Function that will be called when the
+     * [`value`](https://ariakit.org/reference/select-provider#value) state
+     * changes.
+     *
+     * Live examples:
+     * - [Form with Select](https://ariakit.org/examples/form-select)
+     * - [Select Grid](https://ariakit.org/examples/select-grid)
+     * - [Select with custom items](https://ariakit.org/examples/select-item-custom)
+     * - [Multi-Select](https://ariakit.org/examples/select-multiple)
+     * - [Toolbar with Select](https://ariakit.org/examples/toolbar-select)
      */
     setValue?: BivariantCallback<(value: SelectStoreState<T>["value"]) => void>;
     /**
-     * A reference to a combobox store. This is used when combining the combobox
-     * with a select (e.g., select with a search input). The stores will share the
-     * same state.
-     *
-     * Live examples:
-     * - [Multi-selectable
-     *   Combobox](https://ariakit.org/examples/combobox-multiple)
+     * A reference to a [combobox
+     * store](https://ariakit.org/reference/use-combobox-store). It's
+     * automatically set when composing [Select with
+     * Combobox](https://ariakit.org/examples/select-combobox).
      */
     combobox?: ComboboxStore | null;
 }

package/esm/select/select-store.js

@@ -2,20 +2,20 @@
 import {
   useSelectStore,
   useSelectStoreProps
-} from "../__chunks/DYLO4TTE.js";
+} from "../__chunks/FMVHAVXA.js";
 import "../__chunks/W76OTZCC.js";
-import "../__chunks/A6ER4BO6.js";
-import "../__chunks/HDMIVTNE.js";
+import "../__chunks/7GBW5FLS.js";
+import "../__chunks/Y6GYTNQ2.js";
 import "../__chunks/IB7YUKH5.js";
 import "../__chunks/4UUKJZ4V.js";
 import "../__chunks/7H5KSHHF.js";
 import "../__chunks/G6BJYYBK.js";
 import "../__chunks/OAYFXAQ2.js";
 import "../__chunks/3ORBWXWF.js";
-import "../__chunks/EENTNM7A.js";
-import "../__chunks/6SB7F42L.js";
-import "../__chunks/SMM5JVLC.js";
-import "../__chunks/4OZYHFMH.js";
+import "../__chunks/MG4P3223.js";
+import "../__chunks/ZSELSBRM.js";
+import "../__chunks/SFCBA2JZ.js";
+import "../__chunks/EKQEJRUF.js";
 import "../__chunks/6O5OEQGF.js";
 import "../__chunks/XM66DUTO.js";
 import "../__chunks/4R3V3JGP.js";

package/esm/select/select.d.ts

@@ -16,7 +16,15 @@ import type { SelectStore } from "./select-store.js";
  */
 export declare const useSelect: import("../utils/types.js").Hook<SelectOptions<"button">>;
 /**
- * Renders a select button.
+ * Renders a custom select element that controls the visibility of either a
+ * [`SelectList`](https://ariakit.org/reference/select-list) or a
+ * [`SelectPopover`](https://ariakit.org/reference/select-popover) component.
+ *
+ * By default, the
+ * [`value`](https://ariakit.org/reference/select-provider#value) state is
+ * rendered as the children, followed by a
+ * [`SelectArrow`](https://ariakit.org/reference/select-arrow) component. This
+ * can be customized by passing different children to the component.
  * @see https://ariakit.org/components/select
  * @example
  * ```jsx {2}
@@ -40,14 +48,14 @@ export interface SelectOptions<T extends As = "button"> extends PopoverDisclosur
      */
     store?: SelectStore;
     /**
-     * Determines whether the
+     * Determines if 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.
+     * will appear when the user uses arrow keys while the select element is
+     * in focus.
      *
      * Live examples:
-     * - [Select grid](https://ariakit.org/examples/select-grid)
+     * - [Select Grid](https://ariakit.org/examples/select-grid)
      * @default true
      */
     showOnKeyDown?: BooleanOrCallback<KeyboardEvent<HTMLElement>>;
@@ -55,28 +63,30 @@ export interface SelectOptions<T extends As = "button"> extends PopoverDisclosur
      * 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.
+     * are hidden.
      * @default false
      */
     moveOnKeyDown?: BooleanOrCallback<KeyboardEvent<HTMLElement>>;
     /**
-     * Determines whether
-     * [`toggle`](https://ariakit.org/reference/use-select-store#toggle) will be
-     * called on click. By default, the
+     * Determines if
+     * [`toggle`](https://ariakit.org/reference/use-select-store#toggle) should be
+     * invoked 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.
+     * are displayed on press (on mouse/key down).
+     *
+     * **Note**: When set to `true`, this prop supersedes the
+     * [`toggleOnPress`](https://ariakit.org/reference/select#toggleonpress) prop.
      * @default false
      */
     toggleOnClick?: BooleanOrCallback<MouseEvent<HTMLElement>>;
     /**
-     * Determines whether pressing space, enter or mouse down will toggle the
+     * Determines whether pressing Space, Enter, or a mouse down event will
+     * [`toggle`](https://ariakit.org/reference/use-select-store#toggle) the
      * [`SelectList`](https://ariakit.org/reference/select-list) or
      * [`SelectPopover`](https://ariakit.org/reference/select-popover) components.
-     * This prop will be ignored if
+     *
+     * **Note**: This prop is disregarded if
      * [`toggleOnClick`](https://ariakit.org/reference/select#toggleonclick) is
      * set to `true`.
      * @default true

package/esm/select/select.js

@@ -1,30 +1,30 @@
 "use client";
 import {
   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/JH4A3V7P.js";
 import {
   SelectArrow
 } from "../__chunks/NUNVG4IK.js";
 import "../__chunks/JHO32H4J.js";
 import {
   useCompositeTypeahead
-} from "../__chunks/HBGJOTTX.js";
+} from "../__chunks/346FK57L.js";
 import {
   SelectScopedContextProvider,
   useSelectProviderContext
 } from "../__chunks/5HVNGX6D.js";
-import "../__chunks/NWCBQ4CV.js";
-import "../__chunks/6QXBPV75.js";
+import "../__chunks/BVNGIDQK.js";
+import "../__chunks/3IEDWLST.js";
 import "../__chunks/IB7YUKH5.js";
 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 {
   createComponent,
@@ -151,8 +151,8 @@ var useSelect = createHook(
       const canShow = canShowKeyMap[event.key];
       if (canShow && showOnKeyDownProp(event)) {
         event.preventDefault();
-        store.show();
         store.move(activeId);
+        queueBeforeEvent(event.currentTarget, "keyup", store.show);
       }
     });
     const onMouseDownProp = props.onMouseDown;
@@ -192,12 +192,14 @@ var useSelect = createHook(
     });
     const label = props["aria-label"];
     const labelledBy = props["aria-labelledby"] || labelId;
-    const items = store.useState("items");
-    const values = useMemo(
-      // Filter out items without value and duplicate values.
-      () => [...new Set(items.map((i) => i.value).filter((v) => v != null))],
-      [items]
-    );
+    const items = store.useState((state) => {
+      if (!name)
+        return;
+      return state.items;
+    });
+    const values = useMemo(() => {
+      return [...new Set(items == null ? void 0 : items.map((i) => i.value).filter((v) => v != null))];
+    }, [items]);
     props = useWrapElement(
       props,
       (element) => {

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

@@ -18,7 +18,8 @@ import type { TabStore } from "./tab-store.js";
  */
 export declare const useTabList: import("../utils/types.js").Hook<TabListOptions<"div">>;
 /**
- * Renders a tab list element.
+ * Renders a composite tab list wrapper for
+ * [`Tab`](https://ariakit.org/reference/tab) elements.
  * @see https://ariakit.org/components/tab
  * @example
  * ```jsx {2-5}

package/esm/tab/tab-list.js

@@ -5,11 +5,11 @@ import {
 } from "../__chunks/4B73HROV.js";
 import {
   useComposite
-} from "../__chunks/57KNUQTI.js";
-import "../__chunks/6QXBPV75.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/tab/tab-panel.d.ts

@@ -18,7 +18,15 @@ import type { TabStore } from "./tab-store.js";
  */
 export declare const useTabPanel: import("../utils/types.js").Hook<TabPanelOptions<"div">>;
 /**
- * Renders a tab panel element.
+ * Renders a tab panel element that's controlled by a
+ * [`Tab`](https://ariakit.org/reference/tab) component.
+ *
+ * If the [`tabId`](https://ariakit.org/reference/tab-panel#tabid) prop isn't
+ * provided, the tab panel will automatically associate with a
+ * [`Tab`](https://ariakit.org/reference/tab) based on its position in the DOM.
+ * Alternatively, you can render a single tab panel with a dynamic
+ * [`tabId`](https://ariakit.org/reference/tab-panel#tabid) value pointing to
+ * the selected tab.
  * @see https://ariakit.org/components/tab
  * @example
  * ```jsx {6,7}
@@ -43,10 +51,19 @@ export interface TabPanelOptions<T extends As = "div"> extends FocusableOptions<
      */
     store?: TabStore;
     /**
-     * The id of the tab that controls this panel. By default, this value will
-     * be inferred based on the order of the tabs and the panels.
+     * The [`id`](https://ariakit.org/reference/tab#id) of the tab controlling
+     * this panel. This connection is used to assign the `aria-labelledby`
+     * attribute to the tab panel and to determine if the tab panel should be
+     * visible.
+     *
+     * This link is automatically established by matching the order of
+     * [`Tab`](https://ariakit.org/reference/tab) and
+     * [`TabPanel`](https://ariakit.org/reference/tab-panel) elements in the DOM.
+     * If you're rendering a single tab panel, this can be set to a dynamic value
+     * that refers to the selected tab.
      *
      * Live examples:
+     * - [Combobox with tabs](https://ariakit.org/examples/combobox-tabs)
      * - [Tab with React Router](https://ariakit.org/examples/tab-react-router)
      */
     tabId?: string | null;

package/esm/tab/tab-panel.js

@@ -10,12 +10,12 @@ import "../__chunks/IB7YUKH5.js";
 import "../__chunks/4UUKJZ4V.js";
 import {
   useDisclosureContent
-} from "../__chunks/KOKHD3Z3.js";
+} from "../__chunks/CLE7NTOY.js";
 import "../__chunks/G6BJYYBK.js";
 import "../__chunks/OAYFXAQ2.js";
 import {
   useFocusable
-} from "../__chunks/KK7H3W2B.js";
+} from "../__chunks/54DTKZT5.js";
 import "../__chunks/SHA3WOPI.js";
 import {
   createComponent,
@@ -24,8 +24,8 @@ import {
 } from "../__chunks/3ORBWXWF.js";
 import {
   useDisclosureStore
-} from "../__chunks/SMM5JVLC.js";
-import "../__chunks/4OZYHFMH.js";
+} from "../__chunks/SFCBA2JZ.js";
+import "../__chunks/EKQEJRUF.js";
 import {
   useId,
   useMergeRefs,

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

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

package/esm/tab/tab-provider.js

@@ -1,16 +1,16 @@
 "use client";
 import {
   useTabStore
-} from "../__chunks/LZUSNDXA.js";
+} from "../__chunks/CQMDBRG5.js";
 import {
   TabContextProvider
 } from "../__chunks/4B73HROV.js";
-import "../__chunks/A6ER4BO6.js";
-import "../__chunks/HDMIVTNE.js";
+import "../__chunks/7GBW5FLS.js";
+import "../__chunks/Y6GYTNQ2.js";
 import "../__chunks/IB7YUKH5.js";
 import "../__chunks/4UUKJZ4V.js";
 import "../__chunks/3ORBWXWF.js";
-import "../__chunks/4OZYHFMH.js";
+import "../__chunks/EKQEJRUF.js";
 import "../__chunks/6O5OEQGF.js";
 import "../__chunks/XM66DUTO.js";
 import "../__chunks/4R3V3JGP.js";

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

@@ -11,11 +11,13 @@ export declare function useTabStoreProps<T extends Core.TabStore>(store: T, upda
     };
 };
 /**
- * Creates a tab store.
+ * Creates a tab store to control the state of
+ * [Tab](https://ariakit.org/components/tab) components.
  * @see https://ariakit.org/components/tab
  * @example
  * ```jsx
  * const tab = useTabStore();
+ *
  * <TabList store={tab}>
  *   <Tab>Tab 1</Tab>
  *   <Tab>Tab 2</Tab>
@@ -34,8 +36,12 @@ export interface TabStoreFunctions extends Core.TabStoreFunctions, CompositeStor
 }
 export interface TabStoreOptions extends Core.TabStoreOptions, CompositeStoreOptions<TabStoreItem> {
     /**
-     * Function that will be called when the `selectedId` state changes.
-     * @param selectedId The new selected id.
+     * Function that will be called when the
+     * [`selectedId`](https://ariakit.org/reference/tab-provider#selectedid) state
+     * changes.
+     *
+     * Live examples:
+     * - [Combobox with tabs](https://ariakit.org/examples/combobox-tabs)
      */
     setSelectedId?: (selectedId: TabStoreState["selectedId"]) => void;
 }