@ariakit/react-core 0.3.11 → 0.3.13

package/cjs/menu/menu-list.cjs

@@ -2,27 +2,27 @@
 
 
 
-var _63WKH5OPcjs = require('../__chunks/63WKH5OP.cjs');
+var _PJ646MI7cjs = require('../__chunks/PJ646MI7.cjs');
 require('../__chunks/NGEKJJDH.cjs');
 require('../__chunks/7LBZXSLY.cjs');
-require('../__chunks/FQZOOWMH.cjs');
-require('../__chunks/RM2WCNSU.cjs');
-require('../__chunks/RV3PHHWM.cjs');
+require('../__chunks/6PUZ4NWR.cjs');
+require('../__chunks/R7ERL264.cjs');
+require('../__chunks/6ZZYUFPW.cjs');
 require('../__chunks/UZNYSPKP.cjs');
 require('../__chunks/BZTDJIVT.cjs');
-require('../__chunks/TD5MOASJ.cjs');
+require('../__chunks/YPVQYY4J.cjs');
 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/B233QVZE.cjs');
+require('../__chunks/OLOZ5JT2.cjs');
 require('../__chunks/EO6LS72H.cjs');
 require('../__chunks/CJDHQUBR.cjs');
 require('../__chunks/AV6KTKLE.cjs');
 
 
 
-exports.MenuList = _63WKH5OPcjs.MenuList; exports.useMenuList = _63WKH5OPcjs.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.cjs

@@ -1,14 +1,14 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});"use client";
 
 
-var _V6LYK7WKcjs = require('../__chunks/V6LYK7WK.cjs');
+var _CGIHR7QScjs = require('../__chunks/CGIHR7QS.cjs');
 
 
 var _NGEKJJDHcjs = require('../__chunks/NGEKJJDH.cjs');
 require('../__chunks/7LBZXSLY.cjs');
 require('../__chunks/3WCBE6SU.cjs');
-require('../__chunks/N6CR2VNN.cjs');
-require('../__chunks/DKOWT2IJ.cjs');
+require('../__chunks/LUL2YWZ3.cjs');
+require('../__chunks/CDNJPIEG.cjs');
 require('../__chunks/UZNYSPKP.cjs');
 require('../__chunks/BZTDJIVT.cjs');
 require('../__chunks/3W6FH6JK.cjs');
@@ -16,11 +16,11 @@ require('../__chunks/UVBBMANL.cjs');
 require('../__chunks/F2A2ZQDB.cjs');
 require('../__chunks/S6UU7NA4.cjs');
 require('../__chunks/RNZNGEL4.cjs');
-require('../__chunks/XDTEICF5.cjs');
-require('../__chunks/7BPAESN3.cjs');
-require('../__chunks/HRKRTCJC.cjs');
-require('../__chunks/EGAIDKB5.cjs');
-require('../__chunks/B233QVZE.cjs');
+require('../__chunks/OZ4FTKEH.cjs');
+require('../__chunks/NRGWVSB5.cjs');
+require('../__chunks/W5LJEMLB.cjs');
+require('../__chunks/JAQJG42R.cjs');
+require('../__chunks/OLOZ5JT2.cjs');
 require('../__chunks/EO6LS72H.cjs');
 require('../__chunks/CJDHQUBR.cjs');
 require('../__chunks/AV6KTKLE.cjs');
@@ -28,7 +28,7 @@ require('../__chunks/AV6KTKLE.cjs');
 // src/menu/menu-provider.tsx
 var _jsxruntime = require('react/jsx-runtime');
 function MenuProvider(props = {}) {
-  const store = _V6LYK7WKcjs.useMenuStore.call(void 0, props);
+  const store = _CGIHR7QScjs.useMenuStore.call(void 0, props);
   return /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _NGEKJJDHcjs.MenuContextProvider, { value: store, children: props.children });
 }
 

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.cjs

@@ -2,12 +2,12 @@
 
 
 
-var _V6LYK7WKcjs = require('../__chunks/V6LYK7WK.cjs');
+var _CGIHR7QScjs = require('../__chunks/CGIHR7QS.cjs');
 require('../__chunks/NGEKJJDH.cjs');
 require('../__chunks/7LBZXSLY.cjs');
 require('../__chunks/3WCBE6SU.cjs');
-require('../__chunks/N6CR2VNN.cjs');
-require('../__chunks/DKOWT2IJ.cjs');
+require('../__chunks/LUL2YWZ3.cjs');
+require('../__chunks/CDNJPIEG.cjs');
 require('../__chunks/UZNYSPKP.cjs');
 require('../__chunks/BZTDJIVT.cjs');
 require('../__chunks/3W6FH6JK.cjs');
@@ -15,15 +15,15 @@ require('../__chunks/UVBBMANL.cjs');
 require('../__chunks/F2A2ZQDB.cjs');
 require('../__chunks/S6UU7NA4.cjs');
 require('../__chunks/RNZNGEL4.cjs');
-require('../__chunks/XDTEICF5.cjs');
-require('../__chunks/7BPAESN3.cjs');
-require('../__chunks/HRKRTCJC.cjs');
-require('../__chunks/EGAIDKB5.cjs');
-require('../__chunks/B233QVZE.cjs');
+require('../__chunks/OZ4FTKEH.cjs');
+require('../__chunks/NRGWVSB5.cjs');
+require('../__chunks/W5LJEMLB.cjs');
+require('../__chunks/JAQJG42R.cjs');
+require('../__chunks/OLOZ5JT2.cjs');
 require('../__chunks/EO6LS72H.cjs');
 require('../__chunks/CJDHQUBR.cjs');
 require('../__chunks/AV6KTKLE.cjs');
 
 
 
-exports.useMenuStore = _V6LYK7WKcjs.useMenuStore; exports.useMenuStoreProps = _V6LYK7WKcjs.useMenuStoreProps;
+exports.useMenuStore = _CGIHR7QScjs.useMenuStore; exports.useMenuStoreProps = _CGIHR7QScjs.useMenuStoreProps;

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 _63WKH5OPcjs = require('../__chunks/63WKH5OP.cjs');
+var _PJ646MI7cjs = require('../__chunks/PJ646MI7.cjs');
 
 
 var _NGEKJJDHcjs = require('../__chunks/NGEKJJDH.cjs');
 require('../__chunks/7LBZXSLY.cjs');
-require('../__chunks/FQZOOWMH.cjs');
-require('../__chunks/RM2WCNSU.cjs');
-require('../__chunks/RV3PHHWM.cjs');
+require('../__chunks/6PUZ4NWR.cjs');
+require('../__chunks/R7ERL264.cjs');
+require('../__chunks/6ZZYUFPW.cjs');
 require('../__chunks/UZNYSPKP.cjs');
 require('../__chunks/BZTDJIVT.cjs');
 
 
-var _2GETDAIQcjs = require('../__chunks/2GETDAIQ.cjs');
+var _ITQETTAVcjs = require('../__chunks/ITQETTAV.cjs');
 require('../__chunks/KXQOQQ5B.cjs');
-require('../__chunks/NVHGMKAE.cjs');
+require('../__chunks/CIZTEPFO.cjs');
 
 
-var _36QK2QLEcjs = require('../__chunks/36QK2QLE.cjs');
-require('../__chunks/RTT4XR27.cjs');
-require('../__chunks/NKR65BKC.cjs');
+var _FGHQW2WScjs = require('../__chunks/FGHQW2WS.cjs');
+require('../__chunks/WZ3DRKGP.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');
@@ -40,12 +40,12 @@ require('../__chunks/XB3G2EO2.cjs');
 require('../__chunks/CVD2AZE2.cjs');
 require('../__chunks/2BIO7R5N.cjs');
 require('../__chunks/LAUATD5O.cjs');
-require('../__chunks/TD5MOASJ.cjs');
+require('../__chunks/YPVQYY4J.cjs');
 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');
 
@@ -53,11 +53,11 @@ require('../__chunks/R66IWXK6.cjs');
 
 
 var _RNZNGEL4cjs = require('../__chunks/RNZNGEL4.cjs');
-require('../__chunks/HRKRTCJC.cjs');
-require('../__chunks/EGAIDKB5.cjs');
+require('../__chunks/W5LJEMLB.cjs');
+require('../__chunks/JAQJG42R.cjs');
 
 
-var _B233QVZEcjs = require('../__chunks/B233QVZE.cjs');
+var _OLOZ5JT2cjs = require('../__chunks/OLOZ5JT2.cjs');
 
 
 var _EO6LS72Hcjs = require('../__chunks/EO6LS72H.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 = _63WKH5OPcjs.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;
@@ -145,11 +145,11 @@ var useMenu = _RNZNGEL4cjs.createHook.call(void 0,
     const modal = hasParentMenu ? false : modalProp;
     const mayAutoFocusOnShow = !!autoFocusOnShow;
     const canAutoFocusOnShow = !!initialFocusRef || !!props.initialFocus || !!modal;
-    const contentElement = _B233QVZEcjs.useStoreState.call(void 0, 
+    const contentElement = _OLOZ5JT2cjs.useStoreState.call(void 0, 
       store.combobox || store,
       "contentElement"
     );
-    const parentContentElement = _B233QVZEcjs.useStoreState.call(void 0, 
+    const parentContentElement = _OLOZ5JT2cjs.useStoreState.call(void 0, 
       (parentMenu == null ? void 0 : parentMenu.combobox) || parentMenu,
       "contentElement"
     );
@@ -170,7 +170,7 @@ var useMenu = _RNZNGEL4cjs.createHook.call(void 0,
         preserveTabOrderAnchor
       }, props);
     }
-    props = _2GETDAIQcjs.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 = _36QK2QLEcjs.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.cjs

@@ -1,18 +1,18 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});"use client";
 
 
-var _VQHA56HBcjs = require('../__chunks/VQHA56HB.cjs');
+var _T7WLYFYVcjs = require('../__chunks/T7WLYFYV.cjs');
 require('../__chunks/7LBZXSLY.cjs');
-require('../__chunks/7KFYPSJO.cjs');
-require('../__chunks/N6CR2VNN.cjs');
-require('../__chunks/DKOWT2IJ.cjs');
+require('../__chunks/EUHOCOY2.cjs');
+require('../__chunks/LUL2YWZ3.cjs');
+require('../__chunks/CDNJPIEG.cjs');
 require('../__chunks/UZNYSPKP.cjs');
 require('../__chunks/BZTDJIVT.cjs');
 require('../__chunks/RNZNGEL4.cjs');
-require('../__chunks/B233QVZE.cjs');
+require('../__chunks/OLOZ5JT2.cjs');
 require('../__chunks/EO6LS72H.cjs');
 require('../__chunks/CJDHQUBR.cjs');
 require('../__chunks/AV6KTKLE.cjs');
 
 
-exports.MenubarProvider = _VQHA56HBcjs.MenubarProvider;
+exports.MenubarProvider = _T7WLYFYVcjs.MenubarProvider;

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

package/cjs/menubar/menubar-store.cjs

@@ -2,14 +2,14 @@
 
 
 
-var _7KFYPSJOcjs = require('../__chunks/7KFYPSJO.cjs');
-require('../__chunks/N6CR2VNN.cjs');
-require('../__chunks/DKOWT2IJ.cjs');
-require('../__chunks/B233QVZE.cjs');
+var _EUHOCOY2cjs = require('../__chunks/EUHOCOY2.cjs');
+require('../__chunks/LUL2YWZ3.cjs');
+require('../__chunks/CDNJPIEG.cjs');
+require('../__chunks/OLOZ5JT2.cjs');
 require('../__chunks/EO6LS72H.cjs');
 require('../__chunks/CJDHQUBR.cjs');
 require('../__chunks/AV6KTKLE.cjs');
 
 
 
-exports.useMenubarStore = _7KFYPSJOcjs.useMenubarStore; exports.useMenubarStoreProps = _7KFYPSJOcjs.useMenubarStoreProps;
+exports.useMenubarStore = _EUHOCOY2cjs.useMenubarStore; exports.useMenubarStoreProps = _EUHOCOY2cjs.useMenubarStoreProps;

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

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

@@ -2,23 +2,23 @@
 
 
 
-var _APFV5PTXcjs = require('../__chunks/APFV5PTX.cjs');
+var _HQEKHRPPcjs = require('../__chunks/HQEKHRPP.cjs');
 require('../__chunks/7LBZXSLY.cjs');
-require('../__chunks/7KFYPSJO.cjs');
-require('../__chunks/RM2WCNSU.cjs');
-require('../__chunks/RV3PHHWM.cjs');
-require('../__chunks/N6CR2VNN.cjs');
-require('../__chunks/DKOWT2IJ.cjs');
+require('../__chunks/EUHOCOY2.cjs');
+require('../__chunks/R7ERL264.cjs');
+require('../__chunks/6ZZYUFPW.cjs');
+require('../__chunks/LUL2YWZ3.cjs');
+require('../__chunks/CDNJPIEG.cjs');
 require('../__chunks/UZNYSPKP.cjs');
 require('../__chunks/BZTDJIVT.cjs');
-require('../__chunks/Z3GCTNW4.cjs');
+require('../__chunks/VUEWHLYH.cjs');
 require('../__chunks/75KXQZJX.cjs');
 require('../__chunks/RNZNGEL4.cjs');
-require('../__chunks/B233QVZE.cjs');
+require('../__chunks/OLOZ5JT2.cjs');
 require('../__chunks/EO6LS72H.cjs');
 require('../__chunks/CJDHQUBR.cjs');
 require('../__chunks/AV6KTKLE.cjs');
 
 
 
-exports.Menubar = _APFV5PTXcjs.Menubar; exports.useMenubar = _APFV5PTXcjs.useMenubar;
+exports.Menubar = _HQEKHRPPcjs.Menubar; exports.useMenubar = _HQEKHRPPcjs.useMenubar;

package/cjs/menubar/menubar.d.cts

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