@ariakit/react-core 0.3.11 → 0.3.13

package/esm/menu/menu-item-checkbox.js

@@ -1,38 +1,38 @@
 "use client";
+import {
+  useCheckboxStore
+} from "../__chunks/JIZ5C2JK.js";
 import {
   useCheckbox
-} from "../__chunks/6H3EJNCE.js";
+} from "../__chunks/H5L25YOA.js";
 import "../__chunks/VPR2WHQV.js";
-import {
-  useCheckboxStore
-} from "../__chunks/IIVLUKKG.js";
 import {
   useMenuItem
-} from "../__chunks/CVFC2LN3.js";
+} from "../__chunks/53AZXSRJ.js";
 import {
   useMenuScopedContext
 } from "../__chunks/YGMEBI3A.js";
 import "../__chunks/KA4GX64Z.js";
 import "../__chunks/G6ONQ5EH.js";
 import "../__chunks/6XBVQI3K.js";
-import "../__chunks/R2WNOXYG.js";
-import "../__chunks/NWCBQ4CV.js";
+import "../__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/TI7CMBHW.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 {
   useInitialValue
 } from "../__chunks/6O5OEQGF.js";

package/esm/menu/menu-item-radio.d.ts

@@ -19,18 +19,27 @@ import type { MenuStore } from "./menu-store.js";
  */
 export declare const useMenuItemRadio: import("../utils/types.js").Hook<MenuItemRadioOptions<"div">>;
 /**
- * Renders a menu item radio inside a menu.
+ * Renders a [`menuitemradio`](https://w3c.github.io/aria/#menuitemradio)
+ * element within a [`Menu`](https://ariakit.org/reference/menu) component. The
+ * [`name`](https://ariakit.org/reference/menu-item-radio#name) prop must be
+ * provided to identify the field in the
+ * [`values`](https://ariakit.org/reference/menu-provider#values) state.
+ *
+ * A [`MenuItemCheck`](https://ariakit.org/reference/menu-item-check) can be
+ * used to render a checkmark inside this component.
  * @see https://ariakit.org/components/menu
  * @example
- * ```jsx
- * <MenuProvider defaultValues={{ fruit: "apple" }}>
- *   <MenuButton>Fruit</MenuButton>
+ * ```jsx {4-11}
+ * <MenuProvider defaultValues={{ profile: "john" }}>
+ *   <MenuButton>Profiles</MenuButton>
  *   <Menu>
- *     <MenuItemRadio name="fruit" value="apple">
- *       Apple
+ *     <MenuItemRadio name="profile" value="john">
+ *       <MenuItemCheck />
+ *       John Doe
  *     </MenuItemRadio>
- *     <MenuItemRadio name="fruit" value="orange">
- *       Orange
+ *     <MenuItemRadio name="profile" value="jane">
+ *       <MenuItemCheck />
+ *       Jane Doe
  *     </MenuItemRadio>
  *   </Menu>
  * </MenuProvider>
@@ -47,8 +56,11 @@ export interface MenuItemRadioOptions<T extends As = "div"> extends MenuItemOpti
      */
     store?: MenuStore;
     /**
-     * MenuItemRadio's name as specified in the
+     * The name of the field in the
      * [`values`](https://ariakit.org/reference/menu-provider#values) state.
+     *
+     * Live examples:
+     * - [MenuItemRadio](https://ariakit.org/examples/menu-item-radio)
      */
     name: string;
     /**

package/esm/menu/menu-item-radio.js

@@ -1,7 +1,7 @@
 "use client";
 import {
   useMenuItem
-} from "../__chunks/CVFC2LN3.js";
+} from "../__chunks/53AZXSRJ.js";
 import {
   MenuItemCheckedContext,
   useMenuScopedContext
@@ -9,27 +9,27 @@ import {
 import "../__chunks/KA4GX64Z.js";
 import {
   useRadio
-} from "../__chunks/7SHHFY4P.js";
+} from "../__chunks/ZICNKKFD.js";
 import "../__chunks/XEV62JUQ.js";
 import "../__chunks/G6ONQ5EH.js";
-import "../__chunks/R2WNOXYG.js";
-import "../__chunks/NWCBQ4CV.js";
+import "../__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/TI7CMBHW.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 {
   useInitialValue,
   useWrapElement

package/esm/menu/menu-item.d.ts

@@ -22,10 +22,13 @@ import type { MenuStore } from "./menu-store.js";
  */
 export declare const useMenuItem: import("../utils/types.js").Hook<MenuItemOptions<"div">>;
 /**
- * Renders a menu item.
+ * Renders a menu item inside
+ * [`MenuList`](https://ariakit.org/reference/menu-list) or
+ * [`Menu`](https://ariakit.org/reference/menu)
+ * components.
  * @see https://ariakit.org/components/menu
  * @example
- * ```jsx
+ * ```jsx {4-5}
  * <MenuProvider>
  *   <MenuButton>Edit</MenuButton>
  *   <Menu>
@@ -50,20 +53,16 @@ export interface MenuItemOptions<T extends As = "div"> extends CompositeItemOpti
      */
     store?: MenubarStore | MenuStore;
     /**
-     * Whether to hide the menu when a menu item is clicked. This prop won't be
-     * invoked if the click is on a link and modifier keys are used to open the
-     * link in a new tab or download it.
+     * Determines if the menu should hide when this item is clicked.
+     *
+     * **Note**: This behavior isn't triggered if this menu item is rendered as a
+     * link and modifier keys are used to either open the link in a new tab or
+     * download it.
      *
      * Live examples:
-     * - [Submenu with
-     *   Combobox](https://ariakit.org/examples/menu-nested-combobox)
      * - [Sliding Menu](https://ariakit.org/examples/menu-slide)
      * @default true
      */
     hideOnClick?: BooleanOrCallback<MouseEvent<HTMLElement>>;
-    /**
-     * @default true
-     */
-    preventScrollOnKeyDown?: CompositeItemOptions<T>["preventScrollOnKeyDown"];
 }
 export type MenuItemProps<T extends As = "div"> = Props<MenuItemOptions<T>>;

package/esm/menu/menu-item.js

@@ -2,24 +2,24 @@
 import {
   MenuItem,
   useMenuItem
-} from "../__chunks/CVFC2LN3.js";
+} from "../__chunks/53AZXSRJ.js";
 import "../__chunks/YGMEBI3A.js";
 import "../__chunks/KA4GX64Z.js";
 import "../__chunks/G6ONQ5EH.js";
-import "../__chunks/R2WNOXYG.js";
-import "../__chunks/NWCBQ4CV.js";
+import "../__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/TI7CMBHW.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/menu/menu-list.d.ts

@@ -19,10 +19,15 @@ import type { MenuStore } from "./menu-store.js";
  */
 export declare const useMenuList: import("../utils/types.js").Hook<MenuListOptions<"div">>;
 /**
- * Renders a menu list element.
+ * Renders a menu list element. This is the primitive component used by the
+ * [`Menu`](https://ariakit.org/reference/menu) component.
+ *
+ * Unlike [`Menu`](https://ariakit.org/reference/menu), this component doesn't
+ * render a popover and therefore doesn't automatically focus on items when
+ * opened.
  * @see https://ariakit.org/components/menu
  * @example
- * ```jsx
+ * ```jsx {3-6}
  * <MenuProvider>
  *   <MenuButton>Edit</MenuButton>
  *   <MenuList>

package/esm/menu/menu-list.js

@@ -2,23 +2,23 @@
 import {
   MenuList,
   useMenuList
-} from "../__chunks/DENCHBDS.js";
+} from "../__chunks/WVGRWYXJ.js";
 import "../__chunks/YGMEBI3A.js";
 import "../__chunks/KA4GX64Z.js";
-import "../__chunks/HBGJOTTX.js";
-import "../__chunks/57KNUQTI.js";
-import "../__chunks/6QXBPV75.js";
+import "../__chunks/346FK57L.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/TI7CMBHW.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/menu/menu-provider.d.ts

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

package/esm/menu/menu-provider.js

@@ -1,14 +1,14 @@
 "use client";
 import {
   useMenuStore
-} from "../__chunks/NYD53BDE.js";
+} from "../__chunks/XJXP7ZSQ.js";
 import {
   MenuContextProvider
 } from "../__chunks/YGMEBI3A.js";
 import "../__chunks/KA4GX64Z.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/TI7CMBHW.js";
@@ -16,11 +16,11 @@ import "../__chunks/7H5KSHHF.js";
 import "../__chunks/G6BJYYBK.js";
 import "../__chunks/OAYFXAQ2.js";
 import "../__chunks/3ORBWXWF.js";
-import "../__chunks/A3PM2ZVJ.js";
-import "../__chunks/EENTNM7A.js";
-import "../__chunks/6SB7F42L.js";
-import "../__chunks/SMM5JVLC.js";
-import "../__chunks/4OZYHFMH.js";
+import "../__chunks/ZU7LQC5V.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/menu/menu-separator.d.ts

@@ -19,10 +19,13 @@ import type { MenuStore } from "./menu-store.js";
  */
 export declare const useMenuSeparator: import("../utils/types.js").Hook<MenuSeparatorOptions<"hr">>;
 /**
- * Renders a separator for menu items.
+ * Renders a divider between
+ * [`MenuItem`](https://ariakit.org/reference/menu-item),
+ * [`MenuItemCheckbox`](https://ariakit.org/reference/menu-item-checkbox), and
+ * [`MenuItemRadio`](https://ariakit.org/reference/menu-item-radio) elements.
  * @see https://ariakit.org/components/menu
  * @example
- * ```jsx
+ * ```jsx {6}
  * <MenuProvider>
  *   <MenuButton>Edit</MenuButton>
  *   <Menu>

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

@@ -11,11 +11,13 @@ export declare function useMenuStoreProps<T extends Core.MenuStore>(store: T, up
     menubar: MenubarStore | null | undefined;
 };
 /**
- * Creates a menu store.
+ * Creates a menu store to control the state of
+ * [Menu](https://ariakit.org/components/menu) components.
  * @see https://ariakit.org/components/menu
  * @example
  * ```jsx
  * const menu = useMenuStore({ placement: "top" });
+ *
  * <MenuButton store={menu}>Edit</MenuButton>
  * <Menu store={menu}>
  *   <MenuItem>Undo</MenuItem>
@@ -32,7 +34,9 @@ export interface MenuStoreFunctions<T extends MenuStoreValues = MenuStoreValues>
 }
 export interface MenuStoreOptions<T extends MenuStoreValues = MenuStoreValues> extends Core.MenuStoreOptions<T>, CompositeStoreOptions, HovercardStoreOptions {
     /**
-     * A callback that gets called when the `values` state changes.
+     * A callback that gets called when the
+     * [`values`](https://ariakit.org/reference/menu-provider#values) state
+     * changes.
      *
      * Live examples:
      * - [MenuItemCheckbox](https://ariakit.org/examples/menu-item-checkbox)
@@ -41,9 +45,10 @@ export interface MenuStoreOptions<T extends MenuStoreValues = MenuStoreValues> e
      */
     setValues?: BivariantCallback<(values: MenuStoreState<T>["values"]) => void>;
     /**
-     * A reference to a combobox store. This is used when combining the combobox
-     * with a menu (e.g., dropdown menu with a search input). The stores will
-     * share the same state.
+     * A reference to a [combobox
+     * store](https://ariakit.org/reference/use-combobox-store). It's
+     * automatically set when composing [Menu with
+     * Combobox](https://ariakit.org/examples/menu-combobox).
      */
     combobox?: ComboboxStore | null;
     /**
@@ -54,11 +59,17 @@ export interface MenuStoreOptions<T extends MenuStoreValues = MenuStoreValues> e
      * Live examples:
      * - [Menubar](https://ariakit.org/components/menubar)
      * - [Submenu](https://ariakit.org/examples/menu-nested)
+     * - [Navigation Menubar](https://ariakit.org/examples/menubar-navigation)
      */
     parent?: MenuStore | null;
     /**
-     * A reference to a menu bar store. It's automatically set when rendering
-     * menus inside a menu bar in the React tree.
+     * A reference to a [menubar
+     * store](https://ariakit.org/reference/use-menubar-store). It's automatically
+     * set when rendering menus inside a
+     * [`Menubar`](https://ariakit.org/reference/menubar) in the React tree.
+     *
+     * Live examples:
+     * - [Navigation Menubar](https://ariakit.org/examples/menubar-navigation)
      */
     menubar?: MenubarStore | null;
 }

package/esm/menu/menu-store.js

@@ -2,12 +2,12 @@
 import {
   useMenuStore,
   useMenuStoreProps
-} from "../__chunks/NYD53BDE.js";
+} from "../__chunks/XJXP7ZSQ.js";
 import "../__chunks/YGMEBI3A.js";
 import "../__chunks/KA4GX64Z.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/TI7CMBHW.js";
@@ -15,11 +15,11 @@ import "../__chunks/7H5KSHHF.js";
 import "../__chunks/G6BJYYBK.js";
 import "../__chunks/OAYFXAQ2.js";
 import "../__chunks/3ORBWXWF.js";
-import "../__chunks/A3PM2ZVJ.js";
-import "../__chunks/EENTNM7A.js";
-import "../__chunks/6SB7F42L.js";
-import "../__chunks/SMM5JVLC.js";
-import "../__chunks/4OZYHFMH.js";
+import "../__chunks/ZU7LQC5V.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/menu/menu.d.ts

@@ -17,10 +17,16 @@ import type { MenuListOptions } from "./menu-list.jsx";
  */
 export declare const useMenu: import("../utils/types.js").Hook<MenuOptions<"div">>;
 /**
- * Renders a dropdown menu element.
+ * Renders a dropdown menu element that's controlled by a
+ * [`MenuButton`](https://ariakit.org/reference/menu-button) component.
+ *
+ * This component uses the primitive
+ * [`MenuList`](https://ariakit.org/reference/menu-list) component under the
+ * hood. It renders a popover and automatically focuses on items when the menu
+ * is shown.
  * @see https://ariakit.org/components/menu
  * @example
- * ```jsx
+ * ```jsx {3-6}
  * <MenuProvider>
  *   <MenuButton>Edit</MenuButton>
  *   <Menu>

package/esm/menu/menu.js

@@ -1,26 +1,26 @@
 "use client";
 import {
   useMenuList
-} from "../__chunks/DENCHBDS.js";
+} from "../__chunks/WVGRWYXJ.js";
 import {
   useMenuProviderContext
 } from "../__chunks/YGMEBI3A.js";
 import "../__chunks/KA4GX64Z.js";
-import "../__chunks/HBGJOTTX.js";
-import "../__chunks/57KNUQTI.js";
-import "../__chunks/6QXBPV75.js";
+import "../__chunks/346FK57L.js";
+import "../__chunks/2P5JZHCE.js";
+import "../__chunks/3IEDWLST.js";
 import "../__chunks/IB7YUKH5.js";
 import "../__chunks/4UUKJZ4V.js";
 import {
   useHovercard
-} from "../__chunks/WEU2EOWJ.js";
+} from "../__chunks/EWG7ZSIX.js";
 import "../__chunks/YMV43K4F.js";
-import "../__chunks/SXPADS2D.js";
+import "../__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";
@@ -28,11 +28,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";
@@ -40,12 +40,12 @@ 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/TI7CMBHW.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 {
@@ -53,11 +53,11 @@ import {
   createElement,
   createHook
 } from "../__chunks/3ORBWXWF.js";
-import "../__chunks/6SB7F42L.js";
-import "../__chunks/SMM5JVLC.js";
+import "../__chunks/ZSELSBRM.js";
+import "../__chunks/SFCBA2JZ.js";
 import {
   useStoreState
-} from "../__chunks/4OZYHFMH.js";
+} from "../__chunks/EKQEJRUF.js";
 import {
   useMergeRefs
 } from "../__chunks/6O5OEQGF.js";

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

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

package/esm/menubar/menubar-provider.js

@@ -1,15 +1,15 @@
 "use client";
 import {
   MenubarProvider
-} from "../__chunks/XCRWZKAW.js";
+} from "../__chunks/RIL2SEAH.js";
 import "../__chunks/KA4GX64Z.js";
-import "../__chunks/FWQLUQ4T.js";
-import "../__chunks/A6ER4BO6.js";
-import "../__chunks/HDMIVTNE.js";
+import "../__chunks/HVBNG5AF.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/menubar/menubar-store.d.ts

@@ -3,11 +3,13 @@ import type { CompositeStoreFunctions, CompositeStoreOptions, CompositeStoreStat
 import type { Store } from "../utils/store.js";
 export declare function useMenubarStoreProps<T extends Core.MenubarStore>(store: T, update: () => void, props: MenubarStoreProps): T;
 /**
- * Creates a menubar store.
+ * Creates a menubar store to control the state of
+ * [Menubar](https://ariakit.org/components/menubar) components.
  * @see https://ariakit.org/components/menubar
  * @example
  * ```jsx
  * const menu = useMenubarStore();
+ *
  * <Menubar store={menu} />
  * ```
  */

package/esm/menubar/menubar-store.js

@@ -2,10 +2,10 @@
 import {
   useMenubarStore,
   useMenubarStoreProps
-} from "../__chunks/FWQLUQ4T.js";
-import "../__chunks/A6ER4BO6.js";
-import "../__chunks/HDMIVTNE.js";
-import "../__chunks/4OZYHFMH.js";
+} from "../__chunks/HVBNG5AF.js";
+import "../__chunks/7GBW5FLS.js";
+import "../__chunks/Y6GYTNQ2.js";
+import "../__chunks/EKQEJRUF.js";
 import "../__chunks/6O5OEQGF.js";
 import "../__chunks/XM66DUTO.js";
 import "../__chunks/4R3V3JGP.js";

package/esm/menubar/menubar.d.ts

@@ -23,8 +23,9 @@ import type { MenubarStore, MenubarStoreProps } from "./menubar-store.js";
  */
 export declare const useMenubar: import("../utils/types.js").Hook<MenubarOptions<"div">>;
 /**
- * Renders a menu bar that may contain a group of menu items that control other
- * submenus.
+ * Renders a menubar that may contain a group of
+ * [`MenuItem`](https://ariakit.org/reference/menu-item) elements that control
+ * other submenus.
  * @see https://ariakit.org/components/menubar
  * @example
  * ```jsx

package/esm/menubar/menubar.js

@@ -2,19 +2,19 @@
 import {
   Menubar,
   useMenubar
-} from "../__chunks/7R5VX7DV.js";
+} from "../__chunks/VR7H4JAI.js";
 import "../__chunks/KA4GX64Z.js";
-import "../__chunks/FWQLUQ4T.js";
-import "../__chunks/57KNUQTI.js";
-import "../__chunks/6QXBPV75.js";
-import "../__chunks/A6ER4BO6.js";
-import "../__chunks/HDMIVTNE.js";
+import "../__chunks/HVBNG5AF.js";
+import "../__chunks/2P5JZHCE.js";
+import "../__chunks/3IEDWLST.js";
+import "../__chunks/7GBW5FLS.js";
+import "../__chunks/Y6GYTNQ2.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/4OZYHFMH.js";
+import "../__chunks/EKQEJRUF.js";
 import "../__chunks/6O5OEQGF.js";
 import "../__chunks/XM66DUTO.js";
 import "../__chunks/4R3V3JGP.js";

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

@@ -13,11 +13,12 @@ import type { PopoverStore } from "./popover-store.js";
  */
 export declare const usePopoverAnchor: import("../utils/types.js").Hook<PopoverAnchorOptions<"div">>;
 /**
- * Renders an element that will serve as the popover's anchor. The popover will
- * be positioned relative to this element.
+ * Renders an element that acts as the anchor for the popover. The
+ * [`Popover`](https://ariakit.org/reference/popover) component will be
+ * positioned in relation to this element.
  * @see https://ariakit.org/components/popover
  * @example
- * ```jsx
+ * ```jsx {2}
  * <PopoverProvider>
  *   <PopoverAnchor>Anchor</PopoverAnchor>
  *   <Popover>Popover</Popover>