@ariakit/react-core 0.3.12 → 0.3.13

package/cjs/menu/menu-item-radio.cjs

@@ -1,7 +1,7 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});"use client";
 
 
-var _NNINKJTTcjs = require('../__chunks/NNINKJTT.cjs');
+var _QSU3WKMWcjs = require('../__chunks/QSU3WKMW.cjs');
 
 
 
@@ -9,11 +9,11 @@ var _NGEKJJDHcjs = require('../__chunks/NGEKJJDH.cjs');
 require('../__chunks/7LBZXSLY.cjs');
 
 
-var _G2ZXRZ2Rcjs = require('../__chunks/G2ZXRZ2R.cjs');
+var _MMRX6FNScjs = require('../__chunks/MMRX6FNS.cjs');
 require('../__chunks/HEEQY4DZ.cjs');
 require('../__chunks/IPYAEPOT.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');
@@ -22,7 +22,7 @@ require('../__chunks/3W6FH6JK.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');
 
 
@@ -96,7 +96,7 @@ var useMenuItemRadio = _RNZNGEL4cjs.createHook.call(void 0,
     props = _AV6KTKLEcjs.__spreadValues.call(void 0, {
       role: "menuitemradio"
     }, props);
-    props = _G2ZXRZ2Rcjs.useRadio.call(void 0, _AV6KTKLEcjs.__spreadValues.call(void 0, {
+    props = _MMRX6FNScjs.useRadio.call(void 0, _AV6KTKLEcjs.__spreadValues.call(void 0, {
       name,
       value,
       checked: isChecked,
@@ -110,7 +110,7 @@ var useMenuItemRadio = _RNZNGEL4cjs.createHook.call(void 0,
         });
       }
     }, props));
-    props = _NNINKJTTcjs.useMenuItem.call(void 0, _AV6KTKLEcjs.__spreadValues.call(void 0, { store, hideOnClick }, props));
+    props = _QSU3WKMWcjs.useMenuItem.call(void 0, _AV6KTKLEcjs.__spreadValues.call(void 0, { store, hideOnClick }, props));
     return props;
   }
 );

package/cjs/menu/menu-item-radio.d.cts

@@ -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/cjs/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/cjs/menu/menu-item.cjs

@@ -2,12 +2,12 @@
 
 
 
-var _NNINKJTTcjs = require('../__chunks/NNINKJTT.cjs');
+var _QSU3WKMWcjs = require('../__chunks/QSU3WKMW.cjs');
 require('../__chunks/NGEKJJDH.cjs');
 require('../__chunks/7LBZXSLY.cjs');
 require('../__chunks/IPYAEPOT.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');
@@ -16,7 +16,7 @@ require('../__chunks/3W6FH6JK.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');
@@ -26,4 +26,4 @@ require('../__chunks/AV6KTKLE.cjs');
 
 
 
-exports.MenuItem = _NNINKJTTcjs.MenuItem; exports.useMenuItem = _NNINKJTTcjs.useMenuItem;
+exports.MenuItem = _QSU3WKMWcjs.MenuItem; exports.useMenuItem = _QSU3WKMWcjs.useMenuItem;

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

@@ -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/cjs/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/cjs/menu/menu-list.cjs

@@ -2,11 +2,11 @@
 
 
 
-var _ZWICHV7Ocjs = require('../__chunks/ZWICHV7O.cjs');
+var _PJ646MI7cjs = require('../__chunks/PJ646MI7.cjs');
 require('../__chunks/NGEKJJDH.cjs');
 require('../__chunks/7LBZXSLY.cjs');
 require('../__chunks/6PUZ4NWR.cjs');
-require('../__chunks/H6OLBVHA.cjs');
+require('../__chunks/R7ERL264.cjs');
 require('../__chunks/6ZZYUFPW.cjs');
 require('../__chunks/UZNYSPKP.cjs');
 require('../__chunks/BZTDJIVT.cjs');
@@ -15,7 +15,7 @@ require('../__chunks/3W6FH6JK.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');
@@ -25,4 +25,4 @@ require('../__chunks/AV6KTKLE.cjs');
 
 
 
-exports.MenuList = _ZWICHV7Ocjs.MenuList; exports.useMenuList = _ZWICHV7Ocjs.useMenuList;
+exports.MenuList = _PJ646MI7cjs.MenuList; exports.useMenuList = _PJ646MI7cjs.useMenuList;

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

@@ -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/cjs/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/cjs/menu/menu-provider.d.cts

@@ -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/cjs/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/cjs/menu/menu-separator.d.cts

@@ -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/cjs/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/cjs/menu/menu-store.d.cts

@@ -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/cjs/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/cjs/menu/menu.cjs

@@ -1,26 +1,26 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});"use client";
 
 
-var _ZWICHV7Ocjs = require('../__chunks/ZWICHV7O.cjs');
+var _PJ646MI7cjs = require('../__chunks/PJ646MI7.cjs');
 
 
 var _NGEKJJDHcjs = require('../__chunks/NGEKJJDH.cjs');
 require('../__chunks/7LBZXSLY.cjs');
 require('../__chunks/6PUZ4NWR.cjs');
-require('../__chunks/H6OLBVHA.cjs');
+require('../__chunks/R7ERL264.cjs');
 require('../__chunks/6ZZYUFPW.cjs');
 require('../__chunks/UZNYSPKP.cjs');
 require('../__chunks/BZTDJIVT.cjs');
 
 
-var _7HJPL3H2cjs = require('../__chunks/7HJPL3H2.cjs');
+var _ITQETTAVcjs = require('../__chunks/ITQETTAV.cjs');
 require('../__chunks/KXQOQQ5B.cjs');
-require('../__chunks/KDG57VZV.cjs');
+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');
@@ -28,11 +28,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');
@@ -45,7 +45,7 @@ require('../__chunks/3W6FH6JK.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');
 
@@ -106,7 +106,7 @@ var useMenu = _RNZNGEL4cjs.createHook.call(void 0,
     props = _AV6KTKLEcjs.__spreadProps.call(void 0, _AV6KTKLEcjs.__spreadValues.call(void 0, {}, props), {
       ref: _EO6LS72Hcjs.useMergeRefs.call(void 0, ref, props.ref)
     });
-    const _a2 = _ZWICHV7Ocjs.useMenuList.call(void 0, 
+    const _a2 = _PJ646MI7cjs.useMenuList.call(void 0, 
       _AV6KTKLEcjs.__spreadValues.call(void 0, { store, alwaysVisible }, props)
     ), { "aria-labelledby": ariaLabelledBy } = _a2, menuListProps = _AV6KTKLEcjs.__objRest.call(void 0, _a2, ["aria-labelledby"]);
     props = menuListProps;
@@ -170,7 +170,7 @@ var useMenu = _RNZNGEL4cjs.createHook.call(void 0,
         preserveTabOrderAnchor
       }, props);
     }
-    props = _7HJPL3H2cjs.useHovercard.call(void 0, _AV6KTKLEcjs.__spreadProps.call(void 0, _AV6KTKLEcjs.__spreadValues.call(void 0, {
+    props = _ITQETTAVcjs.useHovercard.call(void 0, _AV6KTKLEcjs.__spreadProps.call(void 0, _AV6KTKLEcjs.__spreadValues.call(void 0, {
       store,
       alwaysVisible,
       initialFocus: initialFocusRef,
@@ -228,7 +228,7 @@ var useMenu = _RNZNGEL4cjs.createHook.call(void 0,
     return props;
   }
 );
-var Menu = _EKB76T2Ucjs.createDialogComponent.call(void 0, 
+var Menu = _FGHQW2WScjs.createDialogComponent.call(void 0, 
   _RNZNGEL4cjs.createComponent.call(void 0, (props) => {
     const htmlProps = useMenu(props);
     return _RNZNGEL4cjs.createElement.call(void 0, "div", htmlProps);

package/cjs/menu/menu.d.cts

@@ -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/cjs/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/cjs/menubar/menubar-provider.d.cts

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