@ariakit/react-core 0.3.12 → 0.3.13

package/cjs/group/group.d.cts

@@ -10,7 +10,9 @@ import type { As, Options, Props } from "../utils/types.js";
  */
 export declare const useGroup: import("../utils/types.js").Hook<GroupOptions<"div">>;
 /**
- * Renders a group element.
+ * Renders a group element. Optionally, a
+ * [`GroupLabel`](https://ariakit.org/reference/group-label) can be rendered as
+ * a child to provide a label for the group.
  * @see https://ariakit.org/components/group
  * @example
  * ```jsx

package/cjs/group/group.d.ts

@@ -10,7 +10,9 @@ import type { As, Options, Props } from "../utils/types.js";
  */
 export declare const useGroup: import("../utils/types.js").Hook<GroupOptions<"div">>;
 /**
- * Renders a group element.
+ * Renders a group element. Optionally, a
+ * [`GroupLabel`](https://ariakit.org/reference/group-label) can be rendered as
+ * a child to provide a label for the group.
  * @see https://ariakit.org/components/group
  * @example
  * ```jsx

package/cjs/heading/heading-level.d.cts

@@ -1,8 +1,10 @@
 import type { ReactNode } from "react";
 import type { HeadingLevels } from "./utils.js";
 /**
- * A component that sets the heading level for the children. It doesn't render
- * any HTML element, just sets the `level` prop on the context.
+ * A component that sets the heading level for its children. It doesn't render
+ * any HTML element, just sets the
+ * [`level`](https://ariakit.org/reference/heading-level#level) prop on the
+ * context.
  * @see https://ariakit.org/components/heading
  * @example
  * ```jsx

package/cjs/heading/heading-level.d.ts

@@ -1,8 +1,10 @@
 import type { ReactNode } from "react";
 import type { HeadingLevels } from "./utils.js";
 /**
- * A component that sets the heading level for the children. It doesn't render
- * any HTML element, just sets the `level` prop on the context.
+ * A component that sets the heading level for its children. It doesn't render
+ * any HTML element, just sets the
+ * [`level`](https://ariakit.org/reference/heading-level#level) prop on the
+ * context.
  * @see https://ariakit.org/components/heading
  * @example
  * ```jsx

package/cjs/heading/heading.d.cts

@@ -14,9 +14,10 @@ type HeadingElements = `h${HeadingLevels}`;
  */
 export declare const useHeading: import("../utils/types.js").Hook<HeadingOptions<"h1" | "h2" | "h3" | "h4" | "h5" | "h6">>;
 /**
- * Renders a heading element. The element type (or the `aria-level` prop, if the
- * element type is not a native heading) is determined by the context level
- * provided by the parent `HeadingLevel` component.
+ * Renders a heading element. The element type (or the `aria-level` attribute,
+ * if the element type is not a native heading) is determined by the context
+ * level provided by the closest
+ * [`HeadingLevel`](https://ariakit.org/reference/heading-level) ancestor.
  * @see https://ariakit.org/components/heading
  * @example
  * ```jsx

package/cjs/heading/heading.d.ts

@@ -14,9 +14,10 @@ type HeadingElements = `h${HeadingLevels}`;
  */
 export declare const useHeading: import("../utils/types.js").Hook<HeadingOptions<"h1" | "h2" | "h3" | "h4" | "h5" | "h6">>;
 /**
- * Renders a heading element. The element type (or the `aria-level` prop, if the
- * element type is not a native heading) is determined by the context level
- * provided by the parent `HeadingLevel` component.
+ * Renders a heading element. The element type (or the `aria-level` attribute,
+ * if the element type is not a native heading) is determined by the context
+ * level provided by the closest
+ * [`HeadingLevel`](https://ariakit.org/reference/heading-level) ancestor.
  * @see https://ariakit.org/components/heading
  * @example
  * ```jsx

package/cjs/hovercard/hovercard-anchor.cjs

@@ -2,12 +2,12 @@
 
 
 
-var _TGTVGYEZcjs = require('../__chunks/TGTVGYEZ.cjs');
+var _4KFTI2WWcjs = require('../__chunks/4KFTI2WW.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/EO6LS72H.cjs');
@@ -16,4 +16,4 @@ require('../__chunks/AV6KTKLE.cjs');
 
 
 
-exports.HovercardAnchor = _TGTVGYEZcjs.HovercardAnchor; exports.useHovercardAnchor = _TGTVGYEZcjs.useHovercardAnchor;
+exports.HovercardAnchor = _4KFTI2WWcjs.HovercardAnchor; exports.useHovercardAnchor = _4KFTI2WWcjs.useHovercardAnchor;

package/cjs/hovercard/hovercard-anchor.d.cts

@@ -20,7 +20,7 @@ export declare const useHovercardAnchor: import("../utils/types.js").Hook<Hoverc
  * [`Hovercard`](https://ariakit.org/reference/hovercard) popup on hover.
  * @see https://ariakit.org/components/hovercard
  * @example
- * ```jsx
+ * ```jsx {2}
  * <HovercardProvider>
  *   <HovercardAnchor>@username</HovercardAnchor>
  *   <Hovercard>Details</Hovercard>
@@ -38,10 +38,13 @@ export interface HovercardAnchorOptions<T extends As = "a"> extends FocusableOpt
      */
     store?: HovercardStore;
     /**
-     * Whether to show the hovercard on mouse move.
+     * Shows the content element based on the user's _hover intent_ over the
+     * anchor element. This behavior purposely ignores mobile touch and
+     * unintentional mouse enter events, like those that happen during scrolling.
      *
      * Live examples:
      * - [Navigation Menubar](https://ariakit.org/examples/menubar-navigation)
+     * - [Sliding Menu](https://ariakit.org/examples/menu-slide)
      * @default true
      */
     showOnHover?: BooleanOrCallback<ReactMouseEvent<HTMLElement>>;

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

@@ -20,7 +20,7 @@ export declare const useHovercardAnchor: import("../utils/types.js").Hook<Hoverc
  * [`Hovercard`](https://ariakit.org/reference/hovercard) popup on hover.
  * @see https://ariakit.org/components/hovercard
  * @example
- * ```jsx
+ * ```jsx {2}
  * <HovercardProvider>
  *   <HovercardAnchor>@username</HovercardAnchor>
  *   <Hovercard>Details</Hovercard>
@@ -38,10 +38,13 @@ export interface HovercardAnchorOptions<T extends As = "a"> extends FocusableOpt
      */
     store?: HovercardStore;
     /**
-     * Whether to show the hovercard on mouse move.
+     * Shows the content element based on the user's _hover intent_ over the
+     * anchor element. This behavior purposely ignores mobile touch and
+     * unintentional mouse enter events, like those that happen during scrolling.
      *
      * Live examples:
      * - [Navigation Menubar](https://ariakit.org/examples/menubar-navigation)
+     * - [Sliding Menu](https://ariakit.org/examples/menu-slide)
      * @default true
      */
     showOnHover?: BooleanOrCallback<ReactMouseEvent<HTMLElement>>;

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

@@ -16,10 +16,12 @@ import type { HovercardStore } from "./hovercard-store.js";
  */
 export declare const useHovercardArrow: import("../utils/types.js").Hook<HovercardArrowOptions<"div">>;
 /**
- * Renders an arrow element in a hovercard.
+ * Renders an arrow element inside a
+ * [`Hovercard`](https://ariakit.org/reference/hovercard) component that points
+ * to the anchor element.
  * @see https://ariakit.org/components/hovercard
  * @example
- * ```jsx
+ * ```jsx {4}
  * <HovercardProvider>
  *   <HovercardAnchor>@username</HovercardAnchor>
  *   <Hovercard>

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

@@ -16,10 +16,12 @@ import type { HovercardStore } from "./hovercard-store.js";
  */
 export declare const useHovercardArrow: import("../utils/types.js").Hook<HovercardArrowOptions<"div">>;
 /**
- * Renders an arrow element in a hovercard.
+ * Renders an arrow element inside a
+ * [`Hovercard`](https://ariakit.org/reference/hovercard) component that points
+ * to the anchor element.
  * @see https://ariakit.org/components/hovercard
  * @example
- * ```jsx
+ * ```jsx {4}
  * <HovercardProvider>
  *   <HovercardAnchor>@username</HovercardAnchor>
  *   <Hovercard>

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

@@ -17,10 +17,10 @@ export declare const useHovercardDescription: import("../utils/types.js").Hook<H
 /**
  * Renders a description in a hovercard. This component must be wrapped within
  * [`Hovercard`](https://ariakit.org/reference/hovercard) so the
- * `aria-describedby` prop is properly set on the hovercard element.
+ * `aria-describedby` prop is properly set on the content element.
  * @see https://ariakit.org/components/hovercard
  * @example
- * ```jsx
+ * ```jsx {3}
  * <HovercardProvider>
  *   <Hovercard>
  *     <HovercardDescription>Description</HovercardDescription>

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

@@ -17,10 +17,10 @@ export declare const useHovercardDescription: import("../utils/types.js").Hook<H
 /**
  * Renders a description in a hovercard. This component must be wrapped within
  * [`Hovercard`](https://ariakit.org/reference/hovercard) so the
- * `aria-describedby` prop is properly set on the hovercard element.
+ * `aria-describedby` prop is properly set on the content element.
  * @see https://ariakit.org/components/hovercard
  * @example
- * ```jsx
+ * ```jsx {3}
  * <HovercardProvider>
  *   <Hovercard>
  *     <HovercardDescription>Description</HovercardDescription>

package/cjs/hovercard/hovercard-disclosure.cjs

@@ -1,17 +1,17 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});"use client";
 
 
-var _QCG6J6X5cjs = require('../__chunks/QCG6J6X5.cjs');
-require('../__chunks/LFHNPG2L.cjs');
-require('../__chunks/5UTRYT6E.cjs');
-require('../__chunks/DAJUUBUI.cjs');
+var _NLVGDNPEcjs = require('../__chunks/NLVGDNPE.cjs');
+require('../__chunks/2FTVUUOK.cjs');
+require('../__chunks/REJALU3P.cjs');
+require('../__chunks/OSTQZD2E.cjs');
 
 
 var _3W6FH6JKcjs = 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');
 
 
@@ -131,7 +131,7 @@ var useHovercardDisclosure = _RNZNGEL4cjs.createHook.call(void 0,
       onClick,
       onFocus
     });
-    props = _QCG6J6X5cjs.useDialogDisclosure.call(void 0, _AV6KTKLEcjs.__spreadValues.call(void 0, { store }, props));
+    props = _NLVGDNPEcjs.useDialogDisclosure.call(void 0, _AV6KTKLEcjs.__spreadValues.call(void 0, { store }, props));
     return props;
   }
 );

package/cjs/hovercard/hovercard-disclosure.d.cts

@@ -21,7 +21,7 @@ export declare const useHovercardDisclosure: import("../utils/types.js").Hook<Ho
  * hovercard when using the keyboard.
  * @see https://ariakit.org/components/hovercard
  * @example
- * ```jsx
+ * ```jsx {3}
  * <HovercardProvider>
  *   <HovercardAnchor>@username</HovercardAnchor>
  *   <HovercardDisclosure />

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

@@ -21,7 +21,7 @@ export declare const useHovercardDisclosure: import("../utils/types.js").Hook<Ho
  * hovercard when using the keyboard.
  * @see https://ariakit.org/components/hovercard
  * @example
- * ```jsx
+ * ```jsx {3}
  * <HovercardProvider>
  *   <HovercardAnchor>@username</HovercardAnchor>
  *   <HovercardDisclosure />

package/cjs/hovercard/hovercard-dismiss.cjs

@@ -2,16 +2,16 @@
 
 
 
-var _NY3D6JQTcjs = require('../__chunks/NY3D6JQT.cjs');
-require('../__chunks/UXFBTIBY.cjs');
-require('../__chunks/7ZVTEFD7.cjs');
-require('../__chunks/5UTRYT6E.cjs');
-require('../__chunks/DAJUUBUI.cjs');
+var _JFNPRZX3cjs = require('../__chunks/JFNPRZX3.cjs');
+require('../__chunks/ER5DEJFH.cjs');
+require('../__chunks/2IMEEJHG.cjs');
+require('../__chunks/REJALU3P.cjs');
+require('../__chunks/OSTQZD2E.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/EO6LS72H.cjs');
@@ -20,4 +20,4 @@ require('../__chunks/AV6KTKLE.cjs');
 
 
 
-exports.HovercardDismiss = _NY3D6JQTcjs.HovercardDismiss; exports.useHovercardDismiss = _NY3D6JQTcjs.useHovercardDismiss;
+exports.HovercardDismiss = _JFNPRZX3cjs.HovercardDismiss; exports.useHovercardDismiss = _JFNPRZX3cjs.useHovercardDismiss;

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

@@ -15,10 +15,11 @@ import type { HovercardStore } from "./hovercard-store.js";
  */
 export declare const useHovercardDismiss: import("../utils/types.js").Hook<HovercardDismissOptions<"button">>;
 /**
- * Renders a button that hides a hovercard.
+ * Renders a button that hides a
+ * [`Hovercard`](https://ariakit.org/reference/hovercard) when clicked.
  * @see https://ariakit.org/components/hovercard
  * @example
- * ```jsx
+ * ```jsx {3}
  * <HovercardProvider>
  *   <Hovercard>
  *     <HovercardDismiss />

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

@@ -15,10 +15,11 @@ import type { HovercardStore } from "./hovercard-store.js";
  */
 export declare const useHovercardDismiss: import("../utils/types.js").Hook<HovercardDismissOptions<"button">>;
 /**
- * Renders a button that hides a hovercard.
+ * Renders a button that hides a
+ * [`Hovercard`](https://ariakit.org/reference/hovercard) when clicked.
  * @see https://ariakit.org/components/hovercard
  * @example
- * ```jsx
+ * ```jsx {3}
  * <HovercardProvider>
  *   <Hovercard>
  *     <HovercardDismiss />

package/cjs/hovercard/hovercard-heading.d.cts

@@ -17,10 +17,10 @@ export declare const useHovercardHeading: import("../utils/types.js").Hook<Hover
 /**
  * Renders a heading in a hovercard. This component must be wrapped within
  * [`Hovercard`](https://ariakit.org/reference/hovercard) so the
- * `aria-labelledby` prop is properly set on the hovercard element.
+ * `aria-labelledby` prop is properly set on the content element.
  * @see https://ariakit.org/components/hovercard
  * @example
- * ```jsx
+ * ```jsx {3}
  * <HovercardProvider>
  *   <Hovercard>
  *     <HovercardHeading>Heading</HovercardHeading>

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

@@ -17,10 +17,10 @@ export declare const useHovercardHeading: import("../utils/types.js").Hook<Hover
 /**
  * Renders a heading in a hovercard. This component must be wrapped within
  * [`Hovercard`](https://ariakit.org/reference/hovercard) so the
- * `aria-labelledby` prop is properly set on the hovercard element.
+ * `aria-labelledby` prop is properly set on the content element.
  * @see https://ariakit.org/components/hovercard
  * @example
- * ```jsx
+ * ```jsx {3}
  * <HovercardProvider>
  *   <Hovercard>
  *     <HovercardHeading>Heading</HovercardHeading>

package/cjs/hovercard/hovercard-provider.d.cts

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

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

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

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

@@ -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-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 _7HJPL3H2cjs = require('../__chunks/7HJPL3H2.cjs');
+var _ITQETTAVcjs = require('../__chunks/ITQETTAV.cjs');
 require('../__chunks/KXQOQQ5B.cjs');
-require('../__chunks/KDG57VZV.cjs');
-require('../__chunks/EKB76T2U.cjs');
+require('../__chunks/CIZTEPFO.cjs');
+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');
@@ -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');
@@ -32,7 +32,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');
 require('../__chunks/RNZNGEL4.cjs');
@@ -45,4 +45,4 @@ require('../__chunks/AV6KTKLE.cjs');
 
 
 
-exports.Hovercard = _7HJPL3H2cjs.Hovercard; exports.useHovercard = _7HJPL3H2cjs.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.cjs

@@ -1,16 +1,16 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});"use client";
 
 
-var _RNGIWUQWcjs = require('../__chunks/RNGIWUQW.cjs');
+var _HQEKHRPPcjs = require('../__chunks/HQEKHRPP.cjs');
 require('../__chunks/7LBZXSLY.cjs');
 require('../__chunks/EUHOCOY2.cjs');
-require('../__chunks/H6OLBVHA.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');
 
 
@@ -24,7 +24,7 @@ require('../__chunks/AV6KTKLE.cjs');
 
 // src/menu/menu-bar.tsx
 var useMenuBar = _RNZNGEL4cjs.createHook.call(void 0, (props) => {
-  return _RNGIWUQWcjs.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();