@ariakit/react-core 0.3.4 → 0.3.6

package/cjs/menu/menu-button.cjs

@@ -1,62 +1,60 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});"use client";
 
-var _KFXK3MNIcjs = require('../__chunks/KFXK3MNI.cjs');
 
 
+var _NGEKJJDHcjs = require('../__chunks/NGEKJJDH.cjs');
+require('../__chunks/7LBZXSLY.cjs');
 
-var _6RYSMHQYcjs = require('../__chunks/6RYSMHQY.cjs');
 
+var _LICANQTIcjs = require('../__chunks/LICANQTI.cjs');
+require('../__chunks/QCG6J6X5.cjs');
+require('../__chunks/LFHNPG2L.cjs');
+require('../__chunks/3QW6ELTG.cjs');
+require('../__chunks/5UTRYT6E.cjs');
 
-var _YLOTLD6Scjs = require('../__chunks/YLOTLD6S.cjs');
-require('../__chunks/35G5ZXPH.cjs');
-require('../__chunks/VGU6RMHO.cjs');
-require('../__chunks/XH2CZ7VF.cjs');
-require('../__chunks/EZKYHQVF.cjs');
 
+var _FQZOOWMHcjs = require('../__chunks/FQZOOWMH.cjs');
+require('../__chunks/DAJUUBUI.cjs');
 
-var _DC66R2NYcjs = require('../__chunks/DC66R2NY.cjs');
-require('../__chunks/HWZH54NB.cjs');
 
+var _35LC5W3Mcjs = require('../__chunks/35LC5W3M.cjs');
+require('../__chunks/RV3PHHWM.cjs');
+require('../__chunks/UZNYSPKP.cjs');
+require('../__chunks/BZTDJIVT.cjs');
 
-var _BSOHJE7Rcjs = require('../__chunks/BSOHJE7R.cjs');
-require('../__chunks/KLZID3QO.cjs');
-require('../__chunks/H7R5D2FR.cjs');
-require('../__chunks/NHZBX2RS.cjs');
 
+var _LAUATD5Ocjs = require('../__chunks/LAUATD5O.cjs');
+require('../__chunks/3W6FH6JK.cjs');
+require('../__chunks/UVBBMANL.cjs');
+require('../__chunks/F2A2ZQDB.cjs');
+require('../__chunks/S6UU7NA4.cjs');
+require('../__chunks/Z3GCTNW4.cjs');
+require('../__chunks/75KXQZJX.cjs');
 
-var _OAEUR56Wcjs = require('../__chunks/OAEUR56W.cjs');
-require('../__chunks/Q6W7IWNJ.cjs');
-require('../__chunks/AKOG5S2T.cjs');
-require('../__chunks/W6ZRSMO5.cjs');
-require('../__chunks/A2NMYLCG.cjs');
-require('../__chunks/GQAB4M3B.cjs');
-require('../__chunks/LHHW5ZQP.cjs');
 
 
 
+var _RNZNGEL4cjs = require('../__chunks/RNZNGEL4.cjs');
 
-var _Z5PUIG6Acjs = require('../__chunks/Z5PUIG6A.cjs');
 
+var _OALXXRFMcjs = require('../__chunks/OALXXRFM.cjs');
 
-var _EVNF7KMTcjs = require('../__chunks/EVNF7KMT.cjs');
 
 
 
 
+var _EO6LS72Hcjs = require('../__chunks/EO6LS72H.cjs');
+require('../__chunks/CJDHQUBR.cjs');
 
-var _5WLTMVVQcjs = require('../__chunks/5WLTMVVQ.cjs');
-require('../__chunks/7WUTS26Y.cjs');
 
 
 
-
-var _72I2GWXFcjs = require('../__chunks/72I2GWXF.cjs');
+var _AV6KTKLEcjs = require('../__chunks/AV6KTKLE.cjs');
 
 // src/menu/menu-button.tsx
 var _react = require('react');
 var _dom = require('@ariakit/core/utils/dom');
 var _misc = require('@ariakit/core/utils/misc');
-var _store = require('@ariakit/core/utils/store');
 var _jsxruntime = require('react/jsx-runtime');
 function getInitialFocus(event, dir) {
   const keyMap = {
@@ -67,10 +65,21 @@ function getInitialFocus(event, dir) {
   };
   return keyMap[event.key];
 }
-var useMenuButton = _Z5PUIG6Acjs.createHook.call(void 0, 
+function hasActiveItem(items, currentTarget, relatedTarget) {
+  return !!(items == null ? void 0 : items.some((item) => {
+    if (!item.element)
+      return false;
+    if (item.element === currentTarget)
+      return false;
+    if (item.element === relatedTarget)
+      return true;
+    return item.element.getAttribute("aria-expanded") === "true";
+  }));
+}
+var useMenuButton = _RNZNGEL4cjs.createHook.call(void 0, 
   (_a) => {
-    var _b = _a, { store, focusable, accessibleWhenDisabled, showOnHover } = _b, props = _72I2GWXFcjs.__objRest.call(void 0, _b, ["store", "focusable", "accessibleWhenDisabled", "showOnHover"]);
-    const context = _6RYSMHQYcjs.useMenuProviderContext.call(void 0, );
+    var _b = _a, { store, focusable, accessibleWhenDisabled, showOnHover } = _b, props = _AV6KTKLEcjs.__objRest.call(void 0, _b, ["store", "focusable", "accessibleWhenDisabled", "showOnHover"]);
+    const context = _NGEKJJDHcjs.useMenuProviderContext.call(void 0, );
     store = store || context;
     _misc.invariant.call(void 0, 
       store,
@@ -78,19 +87,12 @@ var useMenuButton = _Z5PUIG6Acjs.createHook.call(void 0,
     );
     const ref = _react.useRef.call(void 0, null);
     const parentMenu = store.parent;
-    const parentMenuBar = store.menubar;
+    const parentMenubar = store.menubar;
     const hasParentMenu = !!parentMenu;
-    const parentIsMenuBar = !!parentMenuBar && !hasParentMenu;
-    const disabled = props.disabled || props["aria-disabled"] === true || props["aria-disabled"] === "true";
-    _react.useEffect.call(void 0, () => {
-      return _store.sync.call(void 0, store, ["disclosureElement"], (state) => {
-        if (!state.disclosureElement)
-          return;
-        store == null ? void 0 : store.setState("disclosureElement", ref.current);
-      });
-    }, [store]);
+    const parentIsMenubar = !!parentMenubar && !hasParentMenu;
+    const disabled = _misc.disabledFromProps.call(void 0, props);
     const onFocusProp = props.onFocus;
-    const onFocus = _5WLTMVVQcjs.useEvent.call(void 0, (event) => {
+    const onFocus = _EO6LS72Hcjs.useEvent.call(void 0, (event) => {
       onFocusProp == null ? void 0 : onFocusProp(event);
       if (disabled)
         return;
@@ -98,12 +100,14 @@ var useMenuButton = _Z5PUIG6Acjs.createHook.call(void 0,
         return;
       store == null ? void 0 : store.setAutoFocusOnShow(false);
       store == null ? void 0 : store.setActiveId(null);
-      if (!parentMenuBar)
+      if (!parentMenubar)
         return;
-      if (!parentIsMenuBar)
+      if (!parentIsMenubar)
         return;
-      const { items } = parentMenuBar.getState();
-      if (_KFXK3MNIcjs.hasExpandedMenuButton.call(void 0, items, event.currentTarget)) {
+      const { items } = parentMenubar.getState();
+      if (hasActiveItem(items, event.currentTarget, event.relatedTarget)) {
+        store == null ? void 0 : store.setDisclosureElement(event.currentTarget);
+        store == null ? void 0 : store.setAnchorElement(event.currentTarget);
         store == null ? void 0 : store.show();
       }
     });
@@ -111,7 +115,7 @@ var useMenuButton = _Z5PUIG6Acjs.createHook.call(void 0,
       (state) => state.placement.split("-")[0]
     );
     const onKeyDownProp = props.onKeyDown;
-    const onKeyDown = _5WLTMVVQcjs.useEvent.call(void 0, (event) => {
+    const onKeyDown = _EO6LS72Hcjs.useEvent.call(void 0, (event) => {
       onKeyDownProp == null ? void 0 : onKeyDownProp(event);
       if (disabled)
         return;
@@ -120,13 +124,15 @@ var useMenuButton = _Z5PUIG6Acjs.createHook.call(void 0,
       const initialFocus = getInitialFocus(event, dir);
       if (initialFocus) {
         event.preventDefault();
+        store == null ? void 0 : store.setAnchorElement(event.currentTarget);
+        store == null ? void 0 : store.setDisclosureElement(event.currentTarget);
         store == null ? void 0 : store.show();
         store == null ? void 0 : store.setAutoFocusOnShow(true);
         store == null ? void 0 : store.setInitialFocus(initialFocus);
       }
     });
     const onClickProp = props.onClick;
-    const onClick = _5WLTMVVQcjs.useEvent.call(void 0, (event) => {
+    const onClick = _EO6LS72Hcjs.useEvent.call(void 0, (event) => {
       onClickProp == null ? void 0 : onClickProp(event);
       if (event.defaultPrevented)
         return;
@@ -144,31 +150,31 @@ var useMenuButton = _Z5PUIG6Acjs.createHook.call(void 0,
         store.show();
       }
     });
-    props = _5WLTMVVQcjs.useWrapElement.call(void 0, 
+    props = _EO6LS72Hcjs.useWrapElement.call(void 0, 
       props,
-      (element) => /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _6RYSMHQYcjs.MenuContextProvider, { value: store, children: element }),
+      (element) => /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _NGEKJJDHcjs.MenuContextProvider, { value: store, children: element }),
       [store]
     );
     if (hasParentMenu) {
-      props = _72I2GWXFcjs.__spreadProps.call(void 0, _72I2GWXFcjs.__spreadValues.call(void 0, {}, props), {
-        render: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _OAEUR56Wcjs.Role.div, { render: props.render })
+      props = _AV6KTKLEcjs.__spreadProps.call(void 0, _AV6KTKLEcjs.__spreadValues.call(void 0, {}, props), {
+        render: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _LAUATD5Ocjs.Role.div, { render: props.render })
       });
     }
-    const id = _5WLTMVVQcjs.useId.call(void 0, props.id);
-    const parentContentElement = _EVNF7KMTcjs.useStoreState.call(void 0, parentMenu, "contentElement");
-    const role = hasParentMenu || parentIsMenuBar ? _dom.getPopupItemRole.call(void 0, parentContentElement, "menuitem") : void 0;
+    const id = _EO6LS72Hcjs.useId.call(void 0, props.id);
+    const parentContentElement = _OALXXRFMcjs.useStoreState.call(void 0, parentMenu, "contentElement");
+    const role = hasParentMenu || parentIsMenubar ? _dom.getPopupItemRole.call(void 0, parentContentElement, "menuitem") : void 0;
     const contentElement = store.useState("contentElement");
-    props = _72I2GWXFcjs.__spreadProps.call(void 0, _72I2GWXFcjs.__spreadValues.call(void 0, {
+    props = _AV6KTKLEcjs.__spreadProps.call(void 0, _AV6KTKLEcjs.__spreadValues.call(void 0, {
       id,
       role,
       "aria-haspopup": _dom.getPopupRole.call(void 0, contentElement, "menu")
     }, props), {
-      ref: _5WLTMVVQcjs.useMergeRefs.call(void 0, ref, props.ref),
+      ref: _EO6LS72Hcjs.useMergeRefs.call(void 0, ref, props.ref),
       onFocus,
       onKeyDown,
       onClick
     });
-    props = _BSOHJE7Rcjs.useHovercardAnchor.call(void 0, _72I2GWXFcjs.__spreadProps.call(void 0, _72I2GWXFcjs.__spreadValues.call(void 0, {
+    props = _35LC5W3Mcjs.useHovercardAnchor.call(void 0, _AV6KTKLEcjs.__spreadProps.call(void 0, _AV6KTKLEcjs.__spreadValues.call(void 0, {
       store,
       focusable,
       accessibleWhenDisabled
@@ -180,28 +186,28 @@ var useMenuButton = _Z5PUIG6Acjs.createHook.call(void 0,
           return showOnHover;
         if (hasParentMenu)
           return true;
-        if (!parentMenuBar)
+        if (!parentMenubar)
           return false;
-        const { items } = parentMenuBar.getState();
-        return parentIsMenuBar && _KFXK3MNIcjs.hasExpandedMenuButton.call(void 0, items);
+        const { items } = parentMenubar.getState();
+        return parentIsMenubar && hasActiveItem(items);
       }
     }));
-    props = _YLOTLD6Scjs.usePopoverDisclosure.call(void 0, _72I2GWXFcjs.__spreadValues.call(void 0, {
+    props = _LICANQTIcjs.usePopoverDisclosure.call(void 0, _AV6KTKLEcjs.__spreadValues.call(void 0, {
       store,
       toggleOnClick: !hasParentMenu,
       focusable,
       accessibleWhenDisabled
     }, props));
-    props = _DC66R2NYcjs.useCompositeTypeahead.call(void 0, _72I2GWXFcjs.__spreadValues.call(void 0, {
+    props = _FQZOOWMHcjs.useCompositeTypeahead.call(void 0, _AV6KTKLEcjs.__spreadValues.call(void 0, {
       store,
-      typeahead: parentIsMenuBar
+      typeahead: parentIsMenubar
     }, props));
     return props;
   }
 );
-var MenuButton = _Z5PUIG6Acjs.createComponent.call(void 0, (props) => {
+var MenuButton = _RNZNGEL4cjs.createComponent.call(void 0, (props) => {
   const htmlProps = useMenuButton(props);
-  return _Z5PUIG6Acjs.createElement.call(void 0, "button", htmlProps);
+  return _RNZNGEL4cjs.createElement.call(void 0, "button", htmlProps);
 });
 if (process.env.NODE_ENV !== "production") {
   MenuButton.displayName = "MenuButton";

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

@@ -0,0 +1,58 @@
+import type { CompositeTypeaheadOptions } from "../composite/composite-typeahead.js";
+import type { HovercardAnchorOptions } from "../hovercard/hovercard-anchor.js";
+import type { PopoverDisclosureOptions } from "../popover/popover-disclosure.js";
+import type { As, Props } from "../utils/types.js";
+import type { MenuStore } from "./menu-store.js";
+/**
+ * Returns props to create a `MenuButton` component.
+ * @see https://ariakit.org/components/menu
+ * @example
+ * ```jsx
+ * const store = useMenuStore();
+ * const props = useMenuButton({ store });
+ * <Role {...props}>Edit</Role>
+ * <Menu store={store}>
+ *   <MenuItem>Undo</MenuItem>
+ *   <MenuItem>Redo</MenuItem>
+ * </Menu>
+ * ```
+ */
+export declare const useMenuButton: import("../utils/types.js").Hook<MenuButtonOptions<"button" | "div">>;
+/**
+ * Renders a menu button that triggers a
+ * [`Menu`](https://ariakit.org/reference/menu) component. Usually, this is
+ * rendered as a native `button` element, but if it's a submenu button rendered
+ * as a menu item inside another menu, it'll be rendered as a `div`.
+ * @see https://ariakit.org/components/menu
+ * @example
+ * ```jsx
+ * <MenuProvider>
+ *   <MenuButton>Edit</MenuButton>
+ *   <Menu>
+ *     <MenuItem>Undo</MenuItem>
+ *     <MenuItem>Redo</MenuItem>
+ *   </Menu>
+ * </MenuProvider>
+ * ```
+ */
+export declare const MenuButton: import("../utils/types.js").Component<MenuButtonOptions<"button" | "div">>;
+export interface MenuButtonOptions<T extends As = "button" | "div"> extends HovercardAnchorOptions<T>, PopoverDisclosureOptions<T>, CompositeTypeaheadOptions<T> {
+    /**
+     * Object returned by the
+     * [`useMenuStore`](https://ariakit.org/reference/use-menu-store) hook. If not
+     * provided, the closest
+     * [`MenuProvider`](https://ariakit.org/reference/menu-provider) component's
+     * context will be used.
+     */
+    store?: MenuStore;
+    /**
+     * Determines whether pressing a character key while focusing on the
+     * [`MenuButton`](https://ariakit.org/reference/menu-button) should move focus
+     * to the [`MenuItem`](https://ariakit.org/reference/menu-item) starting with
+     * that character. By default, it's `true` for menu buttons in a
+     * [Menubar](https://ariakit.org/components/menubar), but `false` for other
+     * menu buttons.
+     */
+    typeahead?: boolean;
+}
+export type MenuButtonProps<T extends As = "button" | "div"> = Props<MenuButtonOptions<T>>;

package/cjs/menu/menu-button.d.ts

@@ -50,7 +50,7 @@ export interface MenuButtonOptions<T extends As = "button" | "div"> extends Hove
      * [`MenuButton`](https://ariakit.org/reference/menu-button) should move focus
      * to the [`MenuItem`](https://ariakit.org/reference/menu-item) starting with
      * that character. By default, it's `true` for menu buttons in a
-     * [`MenuBar`](https://ariakit.org/reference/menu-bar), but `false` for other
+     * [Menubar](https://ariakit.org/components/menubar), but `false` for other
      * menu buttons.
      */
     typeahead?: boolean;

package/cjs/menu/menu-context.cjs

@@ -1,4 +1,4 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});"use client";
 
 
 
@@ -10,18 +10,19 @@
 
 
 
-var _6RYSMHQYcjs = require('../__chunks/6RYSMHQY.cjs');
-require('../__chunks/H7R5D2FR.cjs');
-require('../__chunks/NHZBX2RS.cjs');
-require('../__chunks/Q6W7IWNJ.cjs');
-require('../__chunks/AKOG5S2T.cjs');
-require('../__chunks/W6ZRSMO5.cjs');
-require('../__chunks/A2NMYLCG.cjs');
-require('../__chunks/Z5PUIG6A.cjs');
-require('../__chunks/5WLTMVVQ.cjs');
-require('../__chunks/7WUTS26Y.cjs');
-require('../__chunks/72I2GWXF.cjs');
 
+var _NGEKJJDHcjs = require('../__chunks/NGEKJJDH.cjs');
+require('../__chunks/7LBZXSLY.cjs');
+require('../__chunks/UZNYSPKP.cjs');
+require('../__chunks/BZTDJIVT.cjs');
+require('../__chunks/3W6FH6JK.cjs');
+require('../__chunks/UVBBMANL.cjs');
+require('../__chunks/F2A2ZQDB.cjs');
+require('../__chunks/S6UU7NA4.cjs');
+require('../__chunks/RNZNGEL4.cjs');
+require('../__chunks/EO6LS72H.cjs');
+require('../__chunks/CJDHQUBR.cjs');
+require('../__chunks/AV6KTKLE.cjs');
 
 
 
@@ -33,4 +34,5 @@ require('../__chunks/72I2GWXF.cjs');
 
 
 
-exports.MenuBarContextProvider = _6RYSMHQYcjs.MenuBarContextProvider; exports.MenuBarScopedContextProvider = _6RYSMHQYcjs.MenuBarScopedContextProvider; exports.MenuContextProvider = _6RYSMHQYcjs.MenuContextProvider; exports.MenuItemCheckedContext = _6RYSMHQYcjs.MenuItemCheckedContext; exports.MenuScopedContextProvider = _6RYSMHQYcjs.MenuScopedContextProvider; exports.useMenuBarContext = _6RYSMHQYcjs.useMenuBarContext; exports.useMenuBarProviderContext = _6RYSMHQYcjs.useMenuBarProviderContext; exports.useMenuBarScopedContext = _6RYSMHQYcjs.useMenuBarScopedContext; exports.useMenuContext = _6RYSMHQYcjs.useMenuContext; exports.useMenuProviderContext = _6RYSMHQYcjs.useMenuProviderContext; exports.useMenuScopedContext = _6RYSMHQYcjs.useMenuScopedContext;
+
+exports.MenuBarContextProvider = _NGEKJJDHcjs.MenuBarContextProvider; exports.MenuBarScopedContextProvider = _NGEKJJDHcjs.MenuBarScopedContextProvider; exports.MenuContextProvider = _NGEKJJDHcjs.MenuContextProvider; exports.MenuItemCheckedContext = _NGEKJJDHcjs.MenuItemCheckedContext; exports.MenuScopedContextProvider = _NGEKJJDHcjs.MenuScopedContextProvider; exports.useMenuBarContext = _NGEKJJDHcjs.useMenuBarContext; exports.useMenuBarProviderContext = _NGEKJJDHcjs.useMenuBarProviderContext; exports.useMenuBarScopedContext = _NGEKJJDHcjs.useMenuBarScopedContext; exports.useMenuContext = _NGEKJJDHcjs.useMenuContext; exports.useMenuProviderContext = _NGEKJJDHcjs.useMenuProviderContext; exports.useMenuScopedContext = _NGEKJJDHcjs.useMenuScopedContext;

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

@@ -0,0 +1,41 @@
+import type { MenuStore } from "./menu-store.js";
+/**
+ * Returns the menu store from the nearest menu container.
+ * @example
+ * function Menu() {
+ *   const store = useMenuContext();
+ *
+ *   if (!store) {
+ *     throw new Error("Menu must be wrapped in MenuProvider");
+ *   }
+ *
+ *   // Use the store...
+ * }
+ */
+export declare const useMenuContext: () => MenuStore | undefined;
+export declare const useMenuScopedContext: (onlyScoped?: boolean) => MenuStore | undefined;
+export declare const useMenuProviderContext: () => MenuStore | undefined;
+export declare const MenuContextProvider: (props: import("react").ProviderProps<MenuStore | undefined>) => import("react/jsx-runtime").JSX.Element;
+export declare const MenuScopedContextProvider: (props: import("react").ProviderProps<MenuStore | undefined>) => import("react/jsx-runtime").JSX.Element;
+/**
+ * Returns the menuBar store from the nearest menuBar container.
+ * @deprecated
+ * Use [`useMenubarContext`](https://ariakit.org/reference/use-menubar-context)
+ * instead.
+ * @example
+ * function MenuBar() {
+ *   const store = useMenuBarContext();
+ *
+ *   if (!store) {
+ *     throw new Error("MenuBar must be wrapped in MenuBarProvider");
+ *   }
+ *
+ *   // Use the store...
+ * }
+ */
+export declare const useMenuBarContext: () => import("../menubar/menubar-store.js").MenubarStore | undefined;
+export declare const useMenuBarScopedContext: (onlyScoped?: boolean) => import("../menubar/menubar-store.js").MenubarStore | undefined;
+export declare const useMenuBarProviderContext: () => import("../menubar/menubar-store.js").MenubarStore | undefined;
+export declare const MenuBarContextProvider: (props: import("react").ProviderProps<import("../menubar/menubar-store.js").MenubarStore | undefined>) => import("react/jsx-runtime").JSX.Element;
+export declare const MenuBarScopedContextProvider: (props: import("react").ProviderProps<import("../menubar/menubar-store.js").MenubarStore | undefined>) => import("react/jsx-runtime").JSX.Element;
+export declare const MenuItemCheckedContext: import("react").Context<boolean | undefined>;

package/cjs/menu/menu-context.d.ts

@@ -1,4 +1,3 @@
-import type { MenuBarStore } from "./menu-bar-store.js";
 import type { MenuStore } from "./menu-store.js";
 /**
  * Returns the menu store from the nearest menu container.
@@ -20,6 +19,9 @@ export declare const MenuContextProvider: (props: import("react").ProviderProps<
 export declare const MenuScopedContextProvider: (props: import("react").ProviderProps<MenuStore | undefined>) => import("react/jsx-runtime").JSX.Element;
 /**
  * Returns the menuBar store from the nearest menuBar container.
+ * @deprecated
+ * Use [`useMenubarContext`](https://ariakit.org/reference/use-menubar-context)
+ * instead.
  * @example
  * function MenuBar() {
  *   const store = useMenuBarContext();
@@ -31,9 +33,9 @@ export declare const MenuScopedContextProvider: (props: import("react").Provider
  *   // Use the store...
  * }
  */
-export declare const useMenuBarContext: () => MenuBarStore | undefined;
-export declare const useMenuBarScopedContext: (onlyScoped?: boolean) => MenuBarStore | undefined;
-export declare const useMenuBarProviderContext: () => MenuBarStore | undefined;
-export declare const MenuBarContextProvider: (props: import("react").ProviderProps<MenuBarStore | undefined>) => import("react/jsx-runtime").JSX.Element;
-export declare const MenuBarScopedContextProvider: (props: import("react").ProviderProps<MenuBarStore | undefined>) => import("react/jsx-runtime").JSX.Element;
+export declare const useMenuBarContext: () => import("../menubar/menubar-store.js").MenubarStore | undefined;
+export declare const useMenuBarScopedContext: (onlyScoped?: boolean) => import("../menubar/menubar-store.js").MenubarStore | undefined;
+export declare const useMenuBarProviderContext: () => import("../menubar/menubar-store.js").MenubarStore | undefined;
+export declare const MenuBarContextProvider: (props: import("react").ProviderProps<import("../menubar/menubar-store.js").MenubarStore | undefined>) => import("react/jsx-runtime").JSX.Element;
+export declare const MenuBarScopedContextProvider: (props: import("react").ProviderProps<import("../menubar/menubar-store.js").MenubarStore | undefined>) => import("react/jsx-runtime").JSX.Element;
 export declare const MenuItemCheckedContext: import("react").Context<boolean | undefined>;

package/cjs/menu/menu-description.cjs

@@ -1,30 +1,31 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});"use client";
 
-var _SQPRIHDRcjs = require('../__chunks/SQPRIHDR.cjs');
-require('../__chunks/TFIVWWWL.cjs');
-require('../__chunks/OQROAZRY.cjs');
-require('../__chunks/W6ZRSMO5.cjs');
-require('../__chunks/A2NMYLCG.cjs');
 
+var _ACTXAOA6cjs = require('../__chunks/ACTXAOA6.cjs');
+require('../__chunks/KRB7URW5.cjs');
+require('../__chunks/62JWM3VQ.cjs');
+require('../__chunks/F2A2ZQDB.cjs');
+require('../__chunks/S6UU7NA4.cjs');
 
 
 
-var _Z5PUIG6Acjs = require('../__chunks/Z5PUIG6A.cjs');
-require('../__chunks/5WLTMVVQ.cjs');
-require('../__chunks/7WUTS26Y.cjs');
-require('../__chunks/72I2GWXF.cjs');
+
+var _RNZNGEL4cjs = require('../__chunks/RNZNGEL4.cjs');
+require('../__chunks/EO6LS72H.cjs');
+require('../__chunks/CJDHQUBR.cjs');
+require('../__chunks/AV6KTKLE.cjs');
 
 // src/menu/menu-description.ts
-var useMenuDescription = _Z5PUIG6Acjs.createHook.call(void 0, 
+var useMenuDescription = _RNZNGEL4cjs.createHook.call(void 0, 
   (props) => {
-    props = _SQPRIHDRcjs.useHovercardDescription.call(void 0, props);
+    props = _ACTXAOA6cjs.useHovercardDescription.call(void 0, props);
     return props;
   }
 );
-var MenuDescription = _Z5PUIG6Acjs.createComponent.call(void 0, 
+var MenuDescription = _RNZNGEL4cjs.createComponent.call(void 0, 
   (props) => {
     const htmlProps = useMenuDescription(props);
-    return _Z5PUIG6Acjs.createElement.call(void 0, "p", htmlProps);
+    return _RNZNGEL4cjs.createElement.call(void 0, "p", htmlProps);
   }
 );
 if (process.env.NODE_ENV !== "production") {

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

@@ -0,0 +1,42 @@
+import type { HovercardDescriptionOptions } from "../hovercard/hovercard-description.js";
+import type { As, Props } from "../utils/types.js";
+import type { MenuStore } from "./menu-store.js";
+/**
+ * Returns props to create a `MenuDescription` component. This hook must be used
+ * in a component that's wrapped with `Menu` so the `aria-describedby` prop is
+ * properly set on the menu element.
+ * @see https://ariakit.org/components/menu
+ * @example
+ * ```jsx
+ * // This component must be wrapped with Menu
+ * const props = useMenuDescription();
+ * <Role {...props}>Description</Role>
+ * ```
+ */
+export declare const useMenuDescription: import("../utils/types.js").Hook<MenuDescriptionOptions<"p">>;
+/**
+ * Renders a description in a menu. This component must be wrapped with
+ * [`Menu`](https://ariakit.org/reference/menu) component so the
+ * `aria-describedby` prop is properly set on the menu element.
+ * @see https://ariakit.org/components/menu
+ * @example
+ * ```jsx
+ * <MenuProvider>
+ *   <Menu>
+ *     <MenuDescription>Description</MenuDescription>
+ *   </Menu>
+ * </MenuProvider>
+ * ```
+ */
+export declare const MenuDescription: import("../utils/types.js").Component<MenuDescriptionOptions<"p">>;
+export interface MenuDescriptionOptions<T extends As = "p"> extends HovercardDescriptionOptions<T> {
+    /**
+     * Object returned by the
+     * [`useMenuStore`](https://ariakit.org/reference/use-menu-store) hook. If not
+     * provided, the closest [`Menu`](https://ariakit.org/reference/menu) or
+     * [`MenuProvider`](https://ariakit.org/reference/menu-provider) components'
+     * context will be used.
+     */
+    store?: MenuStore;
+}
+export type MenuDescriptionProps<T extends As = "p"> = Props<MenuDescriptionOptions<T>>;

package/cjs/menu/menu-dismiss.cjs

@@ -1,46 +1,48 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});"use client";
 
-var _OOFSNUBVcjs = require('../__chunks/OOFSNUBV.cjs');
 
+var _NY3D6JQTcjs = require('../__chunks/NY3D6JQT.cjs');
 
-var _6RYSMHQYcjs = require('../__chunks/6RYSMHQY.cjs');
-require('../__chunks/GZMKQINI.cjs');
-require('../__chunks/EMNY7J2W.cjs');
-require('../__chunks/EZKYHQVF.cjs');
-require('../__chunks/HWZH54NB.cjs');
-require('../__chunks/H7R5D2FR.cjs');
-require('../__chunks/NHZBX2RS.cjs');
-require('../__chunks/Q6W7IWNJ.cjs');
-require('../__chunks/AKOG5S2T.cjs');
-require('../__chunks/W6ZRSMO5.cjs');
-require('../__chunks/A2NMYLCG.cjs');
-require('../__chunks/GQAB4M3B.cjs');
-require('../__chunks/LHHW5ZQP.cjs');
 
+var _NGEKJJDHcjs = require('../__chunks/NGEKJJDH.cjs');
+require('../__chunks/7LBZXSLY.cjs');
+require('../__chunks/UXFBTIBY.cjs');
+require('../__chunks/7ZVTEFD7.cjs');
+require('../__chunks/5UTRYT6E.cjs');
+require('../__chunks/DAJUUBUI.cjs');
+require('../__chunks/UZNYSPKP.cjs');
+require('../__chunks/BZTDJIVT.cjs');
+require('../__chunks/3W6FH6JK.cjs');
+require('../__chunks/UVBBMANL.cjs');
+require('../__chunks/F2A2ZQDB.cjs');
+require('../__chunks/S6UU7NA4.cjs');
+require('../__chunks/Z3GCTNW4.cjs');
+require('../__chunks/75KXQZJX.cjs');
 
 
 
-var _Z5PUIG6Acjs = require('../__chunks/Z5PUIG6A.cjs');
-require('../__chunks/5WLTMVVQ.cjs');
-require('../__chunks/7WUTS26Y.cjs');
 
+var _RNZNGEL4cjs = require('../__chunks/RNZNGEL4.cjs');
+require('../__chunks/EO6LS72H.cjs');
+require('../__chunks/CJDHQUBR.cjs');
 
 
-var _72I2GWXFcjs = require('../__chunks/72I2GWXF.cjs');
+
+var _AV6KTKLEcjs = require('../__chunks/AV6KTKLE.cjs');
 
 // src/menu/menu-dismiss.ts
-var useMenuDismiss = _Z5PUIG6Acjs.createHook.call(void 0, 
+var useMenuDismiss = _RNZNGEL4cjs.createHook.call(void 0, 
   (_a) => {
-    var _b = _a, { store } = _b, props = _72I2GWXFcjs.__objRest.call(void 0, _b, ["store"]);
-    const context = _6RYSMHQYcjs.useMenuScopedContext.call(void 0, );
+    var _b = _a, { store } = _b, props = _AV6KTKLEcjs.__objRest.call(void 0, _b, ["store"]);
+    const context = _NGEKJJDHcjs.useMenuScopedContext.call(void 0, );
     store = store || context;
-    props = _OOFSNUBVcjs.useHovercardDismiss.call(void 0, _72I2GWXFcjs.__spreadValues.call(void 0, { store }, props));
+    props = _NY3D6JQTcjs.useHovercardDismiss.call(void 0, _AV6KTKLEcjs.__spreadValues.call(void 0, { store }, props));
     return props;
   }
 );
-var MenuDismiss = _Z5PUIG6Acjs.createComponent.call(void 0, (props) => {
+var MenuDismiss = _RNZNGEL4cjs.createComponent.call(void 0, (props) => {
   const htmlProps = useMenuDismiss(props);
-  return _Z5PUIG6Acjs.createElement.call(void 0, "button", htmlProps);
+  return _RNZNGEL4cjs.createElement.call(void 0, "button", htmlProps);
 });
 if (process.env.NODE_ENV !== "production") {
   MenuDismiss.displayName = "MenuDismiss";

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

@@ -0,0 +1,40 @@
+import type { HovercardDismissOptions } from "../hovercard/hovercard-dismiss.js";
+import type { As, Props } from "../utils/types.js";
+import type { MenuStore } from "./menu-store.js";
+/**
+ * Returns props to create a `MenuDismiss` component.
+ * @see https://ariakit.org/components/menu
+ * @example
+ * ```jsx
+ * const store = useMenuStore();
+ * const props = useMenuDismiss({ store });
+ * <Menu store={store}>
+ *   <Role {...props} />
+ * </Menu>
+ * ```
+ */
+export declare const useMenuDismiss: import("../utils/types.js").Hook<MenuDismissOptions<"button">>;
+/**
+ * Renders a button that hides a menu.
+ * @see https://ariakit.org/components/menu
+ * @example
+ * ```jsx
+ * <MenuProvider>
+ *   <Menu>
+ *     <MenuDismiss />
+ *   </Menu>
+ * </MenuProvider>
+ * ```
+ */
+export declare const MenuDismiss: import("../utils/types.js").Component<MenuDismissOptions<"button">>;
+export interface MenuDismissOptions<T extends As = "button"> extends HovercardDismissOptions<T> {
+    /**
+     * Object returned by the
+     * [`useMenuStore`](https://ariakit.org/reference/use-menu-store) hook. If not
+     * provided, the closest [`Menu`](https://ariakit.org/reference/menu) or
+     * [`MenuProvider`](https://ariakit.org/reference/menu-provider) components'
+     * context will be used.
+     */
+    store?: MenuStore;
+}
+export type MenuDismissProps<T extends As = "button"> = Props<MenuDismissOptions<T>>;