@ariakit/react-core 0.3.11 → 0.3.13

package/cjs/hovercard/hovercard-store.d.ts

@@ -3,7 +3,8 @@ import type { PopoverStoreFunctions, PopoverStoreOptions, PopoverStoreState } fr
 import type { Store } from "../utils/store.js";
 export declare function useHovercardStoreProps<T extends Core.HovercardStore>(store: T, update: () => void, props: HovercardStoreProps): T;
 /**
- * Creates a hovercard store.
+ * Creates a hovercard store to control the state of
+ * [Hovercard](https://ariakit.org/reference/hovercard) components.
  * @see https://ariakit.org/components/hovercard
  * @example
  * ```jsx

package/cjs/hovercard/hovercard.cjs

@@ -2,12 +2,12 @@
 
 
 
-var _2GETDAIQcjs = require('../__chunks/2GETDAIQ.cjs');
+var _ITQETTAVcjs = require('../__chunks/ITQETTAV.cjs');
 require('../__chunks/KXQOQQ5B.cjs');
-require('../__chunks/NVHGMKAE.cjs');
-require('../__chunks/36QK2QLE.cjs');
-require('../__chunks/RTT4XR27.cjs');
-require('../__chunks/NKR65BKC.cjs');
+require('../__chunks/CIZTEPFO.cjs');
+require('../__chunks/FGHQW2WS.cjs');
+require('../__chunks/WZ3DRKGP.cjs');
+require('../__chunks/KSPMHEYZ.cjs');
 require('../__chunks/PZL34OVO.cjs');
 require('../__chunks/344F3DYO.cjs');
 require('../__chunks/KREY6HXD.cjs');
@@ -15,11 +15,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');
@@ -27,22 +27,22 @@ 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');
 require('../__chunks/RNZNGEL4.cjs');
-require('../__chunks/HRKRTCJC.cjs');
-require('../__chunks/EGAIDKB5.cjs');
-require('../__chunks/B233QVZE.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.Hovercard = _2GETDAIQcjs.Hovercard; exports.useHovercard = _2GETDAIQcjs.useHovercard;
+exports.Hovercard = _ITQETTAVcjs.Hovercard; exports.useHovercard = _ITQETTAVcjs.useHovercard;

package/cjs/hovercard/hovercard.d.cts

@@ -20,7 +20,7 @@ export declare const useHovercard: import("../utils/types.js").Hook<HovercardOpt
  * [`HovercardAnchor`](https://ariakit.org/reference/hovercard-anchor).
  * @see https://ariakit.org/components/hovercard
  * @example
- * ```jsx
+ * ```jsx {3}
  * <HovercardProvider>
  *   <HovercardAnchor>@username</HovercardAnchor>
  *   <Hovercard>Details</Hovercard>
@@ -38,17 +38,29 @@ export interface HovercardOptions<T extends As = "div"> extends PopoverOptions<T
      */
     store?: HovercardStore;
     /**
-     * Whether to hide the popover when the mouse cursor leaves any hovercard
-     * element, including the hovercard popover itself, but also the anchor
-     * element.
+     * Determines whether the popover should hide when the mouse leaves the
+     * popover or the anchor element and there's no _hover intent_, meaning, the
+     * mouse isn't moving toward the popover.
+     *
+     * This can be either a boolean or a callback receiving the mouse move event
+     * that initiated the behavior. The callback should return a boolean.
+     *
+     * **Note**: This behavior won't be triggered when the popover or any of its
+     * descendants are in focus.
      * @default true
      */
     hideOnHoverOutside?: BooleanOrCallback<MouseEvent>;
     /**
-     * Whether to disable the pointer events outside of the hovercard while the
-     * mouse is moving toward the hovercard. This is necessary because these
-     * events may trigger focus on other elements and close the hovercard while
-     * the user is moving the mouse toward it.
+     * Determines if the pointer events outside of the popover and its anchor
+     * element should be disabled during _hover intent_, that is, when the mouse
+     * is moving toward the popover.
+     *
+     * This is required as these external events may trigger focus on other
+     * elements and close the popover while the user is attempting to hover over
+     * it.
+     *
+     * This can be either a boolean or a callback receiving the mouse event
+     * happening during hover intent. The callback should return a boolean.
      * @default true
      */
     disablePointerEventsOnApproach?: BooleanOrCallback<MouseEvent>;

package/cjs/hovercard/hovercard.d.ts

@@ -20,7 +20,7 @@ export declare const useHovercard: import("../utils/types.js").Hook<HovercardOpt
  * [`HovercardAnchor`](https://ariakit.org/reference/hovercard-anchor).
  * @see https://ariakit.org/components/hovercard
  * @example
- * ```jsx
+ * ```jsx {3}
  * <HovercardProvider>
  *   <HovercardAnchor>@username</HovercardAnchor>
  *   <Hovercard>Details</Hovercard>
@@ -38,17 +38,29 @@ export interface HovercardOptions<T extends As = "div"> extends PopoverOptions<T
      */
     store?: HovercardStore;
     /**
-     * Whether to hide the popover when the mouse cursor leaves any hovercard
-     * element, including the hovercard popover itself, but also the anchor
-     * element.
+     * Determines whether the popover should hide when the mouse leaves the
+     * popover or the anchor element and there's no _hover intent_, meaning, the
+     * mouse isn't moving toward the popover.
+     *
+     * This can be either a boolean or a callback receiving the mouse move event
+     * that initiated the behavior. The callback should return a boolean.
+     *
+     * **Note**: This behavior won't be triggered when the popover or any of its
+     * descendants are in focus.
      * @default true
      */
     hideOnHoverOutside?: BooleanOrCallback<MouseEvent>;
     /**
-     * Whether to disable the pointer events outside of the hovercard while the
-     * mouse is moving toward the hovercard. This is necessary because these
-     * events may trigger focus on other elements and close the hovercard while
-     * the user is moving the mouse toward it.
+     * Determines if the pointer events outside of the popover and its anchor
+     * element should be disabled during _hover intent_, that is, when the mouse
+     * is moving toward the popover.
+     *
+     * This is required as these external events may trigger focus on other
+     * elements and close the popover while the user is attempting to hover over
+     * it.
+     *
+     * This can be either a boolean or a callback receiving the mouse event
+     * happening during hover intent. The callback should return a boolean.
      * @default true
      */
     disablePointerEventsOnApproach?: BooleanOrCallback<MouseEvent>;

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

@@ -16,10 +16,12 @@ import type { MenuStore } from "./menu-store.js";
  */
 export declare const useMenuArrow: import("../utils/types.js").Hook<MenuArrowOptions<"div">>;
 /**
- * Renders an arrow inside the menu element.
+ * Renders an arrow element inside a
+ * [`Menu`](https://ariakit.org/reference/menu) component that points to its
+ * [`MenuButton`](https://ariakit.org/reference/menu-button).
  * @see https://ariakit.org/components/menu
  * @example
- * ```jsx
+ * ```jsx {4}
  * <MenuProvider>
  *   <MenuButton>Menu</MenuButton>
  *   <Menu>

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

@@ -16,10 +16,12 @@ import type { MenuStore } from "./menu-store.js";
  */
 export declare const useMenuArrow: import("../utils/types.js").Hook<MenuArrowOptions<"div">>;
 /**
- * Renders an arrow inside the menu element.
+ * Renders an arrow element inside a
+ * [`Menu`](https://ariakit.org/reference/menu) component that points to its
+ * [`MenuButton`](https://ariakit.org/reference/menu-button).
  * @see https://ariakit.org/components/menu
  * @example
- * ```jsx
+ * ```jsx {4}
  * <MenuProvider>
  *   <MenuButton>Menu</MenuButton>
  *   <Menu>

package/cjs/menu/menu-bar-provider.cjs

@@ -1,15 +1,15 @@
 "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');
 
@@ -19,7 +19,7 @@ var _AV6KTKLEcjs = require('../__chunks/AV6KTKLE.cjs');
 // src/menu/menu-bar-provider.tsx
 var _jsxruntime = require('react/jsx-runtime');
 function MenuBarProvider(props = {}) {
-  return /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _VQHA56HBcjs.MenubarProvider, _AV6KTKLEcjs.__spreadValues.call(void 0, {}, props));
+  return /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _T7WLYFYVcjs.MenubarProvider, _AV6KTKLEcjs.__spreadValues.call(void 0, {}, props));
 }
 
 

package/cjs/menu/menu-bar-store.cjs

@@ -2,20 +2,20 @@
 
 
 
-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');
 
 // src/menu/menu-bar-store.ts
 function useMenuBarStoreProps(store, update, props) {
-  return _7KFYPSJOcjs.useMenubarStoreProps.call(void 0, store, update, props);
+  return _EUHOCOY2cjs.useMenubarStoreProps.call(void 0, store, update, props);
 }
 function useMenuBarStore(props = {}) {
-  return _7KFYPSJOcjs.useMenubarStore.call(void 0, props);
+  return _EUHOCOY2cjs.useMenubarStore.call(void 0, props);
 }
 
 

package/cjs/menu/menu-bar.cjs

@@ -1,30 +1,30 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});"use client";
 
 
-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');
 
 
 
 
 var _RNZNGEL4cjs = require('../__chunks/RNZNGEL4.cjs');
-require('../__chunks/B233QVZE.cjs');
+require('../__chunks/OLOZ5JT2.cjs');
 require('../__chunks/EO6LS72H.cjs');
 require('../__chunks/CJDHQUBR.cjs');
 require('../__chunks/AV6KTKLE.cjs');
 
 // src/menu/menu-bar.tsx
 var useMenuBar = _RNZNGEL4cjs.createHook.call(void 0, (props) => {
-  return _APFV5PTXcjs.useMenubar.call(void 0, props);
+  return _HQEKHRPPcjs.useMenubar.call(void 0, props);
 });
 var MenuBar = _RNZNGEL4cjs.createComponent.call(void 0, (props) => {
   const htmlProps = useMenuBar(props);

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

@@ -2,8 +2,7 @@ import type { MenubarOptions } from "../menubar/menubar.js";
 import type { As, Props } from "../utils/types.js";
 /**
  * Returns props to create a `MenuBar` component.
- * @deprecated
- * Use [`useMenubar`](https://ariakit.org/reference/use-menubar) instead.
+ * @deprecated Use `useMenubar` instead.
  * @example
  * ```jsx
  * const store = useMenuBarStore();

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

@@ -2,8 +2,7 @@ import type { MenubarOptions } from "../menubar/menubar.js";
 import type { As, Props } from "../utils/types.js";
 /**
  * Returns props to create a `MenuBar` component.
- * @deprecated
- * Use [`useMenubar`](https://ariakit.org/reference/use-menubar) instead.
+ * @deprecated Use `useMenubar` instead.
  * @example
  * ```jsx
  * const store = useMenuBarStore();

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

@@ -20,12 +20,17 @@ import type { MenuStore } from "./menu-store.js";
  */
 export declare const useMenuButtonArrow: import("../utils/types.js").Hook<MenuButtonArrowOptions<"span">>;
 /**
- * Renders an arrow pointing to the menu position, usually inside a
- * `MenuButton`.
+ * Displays an arrow within a
+ * [`MenuButton`](https://ariakit.org/reference/menu-button), pointing to the
+ * [`Menu`](https://ariakit.org/reference/menu) position. It's typically based
+ * on the [`placement`](https://ariakit.org/reference/menu-provider#placement)
+ * state from the menu store, but this can be overridden with the
+ * [`placement`](https://ariakit.org/reference/menu-button-arrow#placement)
+ * prop.
  * @see https://ariakit.org/components/menu
  * @example
- * ```jsx
- * <MenuProvider>
+ * ```jsx {4}
+ * <MenuProvider placement="bottom-start">
  *   <MenuButton>
  *     Edit
  *     <MenuButtonArrow />

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

@@ -20,12 +20,17 @@ import type { MenuStore } from "./menu-store.js";
  */
 export declare const useMenuButtonArrow: import("../utils/types.js").Hook<MenuButtonArrowOptions<"span">>;
 /**
- * Renders an arrow pointing to the menu position, usually inside a
- * `MenuButton`.
+ * Displays an arrow within a
+ * [`MenuButton`](https://ariakit.org/reference/menu-button), pointing to the
+ * [`Menu`](https://ariakit.org/reference/menu) position. It's typically based
+ * on the [`placement`](https://ariakit.org/reference/menu-provider#placement)
+ * state from the menu store, but this can be overridden with the
+ * [`placement`](https://ariakit.org/reference/menu-button-arrow#placement)
+ * prop.
  * @see https://ariakit.org/components/menu
  * @example
- * ```jsx
- * <MenuProvider>
+ * ```jsx {4}
+ * <MenuProvider placement="bottom-start">
  *   <MenuButton>
  *     Edit
  *     <MenuButtonArrow />

package/cjs/menu/menu-button.cjs

@@ -6,19 +6,19 @@ var _NGEKJJDHcjs = require('../__chunks/NGEKJJDH.cjs');
 require('../__chunks/7LBZXSLY.cjs');
 
 
-var _LICANQTIcjs = require('../__chunks/LICANQTI.cjs');
-require('../__chunks/QCG6J6X5.cjs');
-require('../__chunks/LFHNPG2L.cjs');
+var _25ZFPUHHcjs = require('../__chunks/25ZFPUHH.cjs');
+require('../__chunks/NLVGDNPE.cjs');
+require('../__chunks/2FTVUUOK.cjs');
 require('../__chunks/3QW6ELTG.cjs');
-require('../__chunks/5UTRYT6E.cjs');
+require('../__chunks/REJALU3P.cjs');
 
 
-var _FQZOOWMHcjs = require('../__chunks/FQZOOWMH.cjs');
-require('../__chunks/DAJUUBUI.cjs');
+var _6PUZ4NWRcjs = require('../__chunks/6PUZ4NWR.cjs');
+require('../__chunks/OSTQZD2E.cjs');
 
 
-var _TGTVGYEZcjs = require('../__chunks/TGTVGYEZ.cjs');
-require('../__chunks/RV3PHHWM.cjs');
+var _4KFTI2WWcjs = require('../__chunks/4KFTI2WW.cjs');
+require('../__chunks/6ZZYUFPW.cjs');
 require('../__chunks/UZNYSPKP.cjs');
 require('../__chunks/BZTDJIVT.cjs');
 
@@ -28,7 +28,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');
 
 
@@ -37,7 +37,7 @@ require('../__chunks/75KXQZJX.cjs');
 var _RNZNGEL4cjs = require('../__chunks/RNZNGEL4.cjs');
 
 
-var _B233QVZEcjs = require('../__chunks/B233QVZE.cjs');
+var _OLOZ5JT2cjs = require('../__chunks/OLOZ5JT2.cjs');
 
 
 
@@ -163,7 +163,7 @@ var useMenuButton = _RNZNGEL4cjs.createHook.call(void 0,
       });
     }
     const id = _EO6LS72Hcjs.useId.call(void 0, props.id);
-    const parentContentElement = _B233QVZEcjs.useStoreState.call(void 0, 
+    const parentContentElement = _OLOZ5JT2cjs.useStoreState.call(void 0, 
       (parentMenu == null ? void 0 : parentMenu.combobox) || parentMenu,
       "contentElement"
     );
@@ -179,7 +179,7 @@ var useMenuButton = _RNZNGEL4cjs.createHook.call(void 0,
       onKeyDown,
       onClick
     });
-    props = _TGTVGYEZcjs.useHovercardAnchor.call(void 0, _AV6KTKLEcjs.__spreadProps.call(void 0, _AV6KTKLEcjs.__spreadValues.call(void 0, {
+    props = _4KFTI2WWcjs.useHovercardAnchor.call(void 0, _AV6KTKLEcjs.__spreadProps.call(void 0, _AV6KTKLEcjs.__spreadValues.call(void 0, {
       store,
       focusable,
       accessibleWhenDisabled
@@ -207,13 +207,13 @@ var useMenuButton = _RNZNGEL4cjs.createHook.call(void 0,
         return true;
       }
     }));
-    props = _LICANQTIcjs.usePopoverDisclosure.call(void 0, _AV6KTKLEcjs.__spreadValues.call(void 0, {
+    props = _25ZFPUHHcjs.usePopoverDisclosure.call(void 0, _AV6KTKLEcjs.__spreadValues.call(void 0, {
       store,
       toggleOnClick: !hasParentMenu,
       focusable,
       accessibleWhenDisabled
     }, props));
-    props = _FQZOOWMHcjs.useCompositeTypeahead.call(void 0, _AV6KTKLEcjs.__spreadValues.call(void 0, {
+    props = _6PUZ4NWRcjs.useCompositeTypeahead.call(void 0, _AV6KTKLEcjs.__spreadValues.call(void 0, {
       store,
       typeahead: parentIsMenubar
     }, props));

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

@@ -19,13 +19,12 @@ import type { MenuStore } from "./menu-store.js";
  */
 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`.
+ * Renders a menu button that toggles the visibility of a
+ * [`Menu`](https://ariakit.org/reference/menu) component when clicked or when
+ * using arrow keys.
  * @see https://ariakit.org/components/menu
  * @example
- * ```jsx
+ * ```jsx {2}
  * <MenuProvider>
  *   <MenuButton>Edit</MenuButton>
  *   <Menu>
@@ -49,8 +48,10 @@ export interface MenuButtonOptions<T extends As = "button" | "div"> extends Hove
      * 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
+     * that character.
+     *
+     * By default, it's `true` for menu buttons in a
+     * [`Menubar`](https://ariakit.org/reference/menubar), but `false` for other
      * menu buttons.
      */
     typeahead?: boolean;

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

@@ -19,13 +19,12 @@ import type { MenuStore } from "./menu-store.js";
  */
 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`.
+ * Renders a menu button that toggles the visibility of a
+ * [`Menu`](https://ariakit.org/reference/menu) component when clicked or when
+ * using arrow keys.
  * @see https://ariakit.org/components/menu
  * @example
- * ```jsx
+ * ```jsx {2}
  * <MenuProvider>
  *   <MenuButton>Edit</MenuButton>
  *   <Menu>
@@ -49,8 +48,10 @@ export interface MenuButtonOptions<T extends As = "button" | "div"> extends Hove
      * 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
+     * that character.
+     *
+     * By default, it's `true` for menu buttons in a
+     * [`Menubar`](https://ariakit.org/reference/menubar), but `false` for other
      * menu buttons.
      */
     typeahead?: boolean;

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

@@ -15,12 +15,12 @@ import type { MenuStore } from "./menu-store.js";
  */
 export declare const useMenuDescription: import("../utils/types.js").Hook<MenuDescriptionOptions<"p">>;
 /**
- * Renders a description in a menu. This component must be wrapped with
+ * Renders a description in a menu. This component must be wrapped with a
  * [`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
+ * ```jsx {3}
  * <MenuProvider>
  *   <Menu>
  *     <MenuDescription>Description</MenuDescription>

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

@@ -15,12 +15,12 @@ import type { MenuStore } from "./menu-store.js";
  */
 export declare const useMenuDescription: import("../utils/types.js").Hook<MenuDescriptionOptions<"p">>;
 /**
- * Renders a description in a menu. This component must be wrapped with
+ * Renders a description in a menu. This component must be wrapped with a
  * [`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
+ * ```jsx {3}
  * <MenuProvider>
  *   <Menu>
  *     <MenuDescription>Description</MenuDescription>

package/cjs/menu/menu-dismiss.cjs

@@ -1,22 +1,22 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});"use client";
 
 
-var _NY3D6JQTcjs = require('../__chunks/NY3D6JQT.cjs');
+var _JFNPRZX3cjs = require('../__chunks/JFNPRZX3.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/ER5DEJFH.cjs');
+require('../__chunks/2IMEEJHG.cjs');
+require('../__chunks/REJALU3P.cjs');
+require('../__chunks/OSTQZD2E.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/VUEWHLYH.cjs');
 require('../__chunks/75KXQZJX.cjs');
 
 
@@ -36,7 +36,7 @@ var useMenuDismiss = _RNZNGEL4cjs.createHook.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 = _NY3D6JQTcjs.useHovercardDismiss.call(void 0, _AV6KTKLEcjs.__spreadValues.call(void 0, { store }, props));
+    props = _JFNPRZX3cjs.useHovercardDismiss.call(void 0, _AV6KTKLEcjs.__spreadValues.call(void 0, { store }, props));
     return props;
   }
 );

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

@@ -15,10 +15,11 @@ import type { MenuStore } from "./menu-store.js";
  */
 export declare const useMenuDismiss: import("../utils/types.js").Hook<MenuDismissOptions<"button">>;
 /**
- * Renders a button that hides a menu.
+ * Renders a button that hides a [`Menu`](https://ariakit.org/reference/menu)
+ * when clicked.
  * @see https://ariakit.org/components/menu
  * @example
- * ```jsx
+ * ```jsx {3}
  * <MenuProvider>
  *   <Menu>
  *     <MenuDismiss />

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

@@ -15,10 +15,11 @@ import type { MenuStore } from "./menu-store.js";
  */
 export declare const useMenuDismiss: import("../utils/types.js").Hook<MenuDismissOptions<"button">>;
 /**
- * Renders a button that hides a menu.
+ * Renders a button that hides a [`Menu`](https://ariakit.org/reference/menu)
+ * when clicked.
  * @see https://ariakit.org/components/menu
  * @example
- * ```jsx
+ * ```jsx {3}
  * <MenuProvider>
  *   <Menu>
  *     <MenuDismiss />

package/cjs/menu/menu-group-label.d.cts

@@ -15,12 +15,12 @@ import type { MenuStore } from "./menu-store.js";
  */
 export declare const useMenuGroupLabel: import("../utils/types.js").Hook<MenuGroupLabelOptions<"div">>;
 /**
- * Renders a label in a menu group. This component must be wrapped with
- * `MenuGroup` so the `aria-labelledby` prop is properly set on the menu group
- * element.
+ * Renders a label in a menu group. This component should be wrapped with
+ * [`MenuGroup`](https://ariakit.org/reference/menu-group) so the
+ * `aria-labelledby` is correctly set on the group element.
  * @see https://ariakit.org/components/menu
  * @example
- * ```jsx
+ * ```jsx {5}
  * <MenuProvider>
  *   <MenuButton>Recent Items</MenuButton>
  *   <Menu>