@ariakit/react-core 0.3.1 → 0.3.3

package/esm/form/form-store.js

@@ -1,9 +1,9 @@
 import {
   useFormStore,
   useFormStoreProps
-} from "../__chunks/FBTQUSIH.js";
-import "../__chunks/NWDF5QDV.js";
-import "../__chunks/XXO3VVQU.js";
+} from "../__chunks/3T4UFIWO.js";
+import "../__chunks/C6MBVGZ2.js";
+import "../__chunks/4LP74VAP.js";
 import "../__chunks/J7Q2EO23.js";
 import "../__chunks/CP3U4HPL.js";
 import "../__chunks/PNRLI7OV.js";

package/esm/form/form-submit.d.ts

@@ -28,8 +28,11 @@ export declare const useFormSubmit: import("../utils/types.js").Hook<FormSubmitO
 export declare const FormSubmit: import("../utils/types.js").Component<FormSubmitOptions<"button">>;
 export interface FormSubmitOptions<T extends As = "button"> extends ButtonOptions<T> {
     /**
-     * Object returned by the `useFormStore` hook. If not provided, the parent
-     * `Form` component's context will be used.
+     * Object returned by the
+     * [`useFormStore`](https://ariakit.org/reference/use-form-store) hook. If not
+     * provided, the closest [`Form`](https://ariakit.org/reference/form) or
+     * [`FormProvider`](https://ariakit.org/reference/form-provider) components'
+     * context will be used.
      */
     store?: FormStore;
     /**

package/esm/form/form-submit.js

@@ -3,10 +3,10 @@ import {
 } from "../__chunks/NJS632IW.js";
 import {
   useButton
-} from "../__chunks/QPWEKAWF.js";
-import "../__chunks/LND6SMHN.js";
+} from "../__chunks/D2BRO4YW.js";
+import "../__chunks/XBIFFFUN.js";
 import "../__chunks/74KKBFVP.js";
-import "../__chunks/M4OAD5XF.js";
+import "../__chunks/YTHH33BK.js";
 import "../__chunks/BMLNRUFQ.js";
 import {
   createComponent,

package/esm/form/form.d.ts

@@ -26,7 +26,11 @@ export declare const useForm: import("../utils/types.js").Hook<FormOptions<"form
 export declare const Form: import("../utils/types.js").Component<FormOptions<"form">>;
 export interface FormOptions<T extends As = "form"> extends Options<T> {
     /**
-     * Object returned by the `useFormStore` hook.
+     * Object returned by the
+     * [`useFormStore`](https://ariakit.org/reference/use-form-store) hook. If not
+     * provided, the closest
+     * [`FormProvider`](https://ariakit.org/reference/form-provider) component's
+     * context will be used.
      */
     store?: FormStore;
     /**

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

@@ -16,19 +16,25 @@ import type { HovercardStore } from "./hovercard-store.js";
  */
 export declare const useHovercardAnchor: import("../utils/types.js").Hook<HovercardAnchorOptions<"a">>;
 /**
- * Renders an anchor element that will open a popover (`Hovercard`) on hover.
+ * Renders an anchor element that will open a
+ * [`Hovercard`](https://ariakit.org/reference/hovercard) popup on hover.
  * @see https://ariakit.org/components/hovercard
  * @example
  * ```jsx
- * const hovercard = useHovercardStore();
- * <HovercardAnchor store={hovercard}>@username</HovercardAnchor>
- * <Hovercard store={hovercard}>Details</Hovercard>
+ * <HovercardProvider>
+ *   <HovercardAnchor>@username</HovercardAnchor>
+ *   <Hovercard>Details</Hovercard>
+ * </HovercardProvider>
  * ```
  */
 export declare const HovercardAnchor: import("../utils/types.js").Component<HovercardAnchorOptions<"a">>;
 export interface HovercardAnchorOptions<T extends As = "a"> extends FocusableOptions<T> {
     /**
-     * Object returned by the `useHovercardStore` hook.
+     * Object returned by the
+     * [`useHovercardStore`](https://ariakit.org/reference/use-hovercard-store)
+     * hook. If not provided, the closest
+     * [`HovercardProvider`](https://ariakit.org/reference/hovercard-provider)
+     * component's context will be used.
      */
     store?: HovercardStore;
     /**

package/esm/hovercard/hovercard-anchor.js

@@ -1,12 +1,12 @@
 import {
   HovercardAnchor,
   useHovercardAnchor
-} from "../__chunks/54DCICBS.js";
+} from "../__chunks/KXTLHNBI.js";
 import "../__chunks/5DA3HK6G.js";
 import "../__chunks/547DFODS.js";
 import "../__chunks/5YYGDU4E.js";
 import "../__chunks/56KWVYDN.js";
-import "../__chunks/M4OAD5XF.js";
+import "../__chunks/YTHH33BK.js";
 import "../__chunks/BMLNRUFQ.js";
 import "../__chunks/CFEUKV6C.js";
 import "../__chunks/J7Q2EO23.js";

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

@@ -20,19 +20,24 @@ export declare const useHovercardArrow: import("../utils/types.js").Hook<Hoverca
  * @see https://ariakit.org/components/hovercard
  * @example
  * ```jsx
- * const hovercard = useHovercardStore();
- * <HovercardAnchor store={hovercard}>@username</HovercardAnchor>
- * <Hovercard store={hovercard}>
- *   <HovercardArrow />
- *   Details
- * </Hovercard>
+ * <HovercardProvider>
+ *   <HovercardAnchor>@username</HovercardAnchor>
+ *   <Hovercard>
+ *     <HovercardArrow />
+ *     Details
+ *   </Hovercard>
+ * </HovercardProvider>
  * ```
  */
 export declare const HovercardArrow: import("../utils/types.js").Component<HovercardArrowOptions<"div">>;
 export interface HovercardArrowOptions<T extends As = "div"> extends PopoverArrowOptions<T> {
     /**
-     * Object returned by the `useHovercardStore` hook. If not provided, the
-     * parent `Hovercard` component's context will be used.
+     * Object returned by the
+     * [`useHovercardStore`](https://ariakit.org/reference/use-hovercard-store)
+     * hook. If not provided, the closest
+     * [`Hovercard`](https://ariakit.org/reference/hovercard) or
+     * [`HovercardProvider`](https://ariakit.org/reference/hovercard-provider)
+     * components' context will be used.
      */
     store?: HovercardStore;
 }

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

@@ -15,23 +15,28 @@ import type { HovercardStore } from "./hovercard-store.js";
  */
 export declare const useHovercardDescription: import("../utils/types.js").Hook<HovercardDescriptionOptions<"p">>;
 /**
- * Renders a description in a hovercard. This component must be wrapped with
- * `Hovercard` so the `aria-describedby` prop is properly set on the hovercard
- * element.
+ * 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.
  * @see https://ariakit.org/components/hovercard
  * @example
  * ```jsx
- * const hovercard = useHovercardStore();
- * <Hovercard store={hovercard}>
- *   <HovercardDescription>Description</HovercardDescription>
- * </Hovercard>
+ * <HovercardProvider>
+ *   <Hovercard>
+ *     <HovercardDescription>Description</HovercardDescription>
+ *   </Hovercard>
+ * </HovercardProvider>
  * ```
  */
 export declare const HovercardDescription: import("../utils/types.js").Component<HovercardDescriptionOptions<"p">>;
 export interface HovercardDescriptionOptions<T extends As = "p"> extends PopoverDescriptionOptions<T> {
     /**
-     * Object returned by the `useHovercardStore` hook. If not provided, the
-     * parent `Hovercard` component's context will be used.
+     * Object returned by the
+     * [`useHovercardStore`](https://ariakit.org/reference/use-hovercard-store)
+     * hook. If not provided, the closest
+     * [`Hovercard`](https://ariakit.org/reference/hovercard) or
+     * [`HovercardProvider`](https://ariakit.org/reference/hovercard-provider)
+     * components' context will be used.
      */
     store?: HovercardStore;
 }

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

@@ -15,22 +15,28 @@ import type { HovercardStore } from "./hovercard-store.js";
  */
 export declare const useHovercardDisclosure: import("../utils/types.js").Hook<HovercardDisclosureOptions<"button">>;
 /**
- * Renders a hidden disclosure button that will be visible when the hovercard
- * anchor element (`HovercardAnchor`) receives keyboard focus. The user can then
- * navigate to the button to open the hovercard when using the keyboard.
+ * Renders a hidden disclosure button that will be visible when the
+ * [`HovercardAnchor`](https://ariakit.org/reference/hovercard-anchor) receives
+ * keyboard focus. The user can then navigate to the button to open the
+ * hovercard when using the keyboard.
  * @see https://ariakit.org/components/hovercard
  * @example
  * ```jsx
- * const hovercard = useHovercardStore();
- * <HovercardAnchor store={hovercard}>@username</HovercardAnchor>
- * <HovercardDisclosure store={hovercard} />
- * <Hovercard store={hovercard}>Details</Hovercard>
+ * <HovercardProvider>
+ *   <HovercardAnchor>@username</HovercardAnchor>
+ *   <HovercardDisclosure />
+ *   <Hovercard>Details</Hovercard>
+ * </HovercardProvider>
  * ```
  */
 export declare const HovercardDisclosure: import("../utils/types.js").Component<HovercardDisclosureOptions<"button">>;
 export interface HovercardDisclosureOptions<T extends As = "button"> extends DialogDisclosureOptions<T> {
     /**
-     * Object returned by the `useHovercardStore` hook.
+     * Object returned by the
+     * [`useHovercardStore`](https://ariakit.org/reference/use-hovercard-store)
+     * hook. If not provided, the closest
+     * [`HovercardProvider`](https://ariakit.org/reference/hovercard-provider)
+     * component's context will be used.
      */
     store?: HovercardStore;
 }

package/esm/hovercard/hovercard-disclosure.js

@@ -1,16 +1,16 @@
 import {
   useDialogDisclosure
-} from "../__chunks/TQ2YQL6O.js";
-import "../__chunks/7AFOF5E7.js";
-import "../__chunks/QPWEKAWF.js";
-import "../__chunks/LND6SMHN.js";
+} from "../__chunks/3HY5ZQT3.js";
+import "../__chunks/R6PKH666.js";
+import "../__chunks/D2BRO4YW.js";
+import "../__chunks/XBIFFFUN.js";
 import {
   useHovercardProviderContext
 } from "../__chunks/5DA3HK6G.js";
 import "../__chunks/547DFODS.js";
 import "../__chunks/5YYGDU4E.js";
 import "../__chunks/56KWVYDN.js";
-import "../__chunks/M4OAD5XF.js";
+import "../__chunks/YTHH33BK.js";
 import "../__chunks/BMLNRUFQ.js";
 import {
   useVisuallyHidden

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

@@ -19,17 +19,22 @@ export declare const useHovercardDismiss: import("../utils/types.js").Hook<Hover
  * @see https://ariakit.org/components/hovercard
  * @example
  * ```jsx
- * const hovercard = useHovercardStore();
- * <Hovercard store={hovercard}>
- *   <HovercardDismiss />
- * </Hovercard>
+ * <HovercardProvider>
+ *   <Hovercard>
+ *     <HovercardDismiss />
+ *   </Hovercard>
+ * </HovercardProvider>
  * ```
  */
 export declare const HovercardDismiss: import("../utils/types.js").Component<HovercardDismissOptions<"button">>;
 export interface HovercardDismissOptions<T extends As = "button"> extends PopoverDismissOptions<T> {
     /**
-     * Object returned by the `useHovercardStore` hook. If not provided, the
-     * parent `Hovercard` component's context will be used.
+     * Object returned by the
+     * [`useHovercardStore`](https://ariakit.org/reference/use-hovercard-store)
+     * hook. If not provided, the closest
+     * [`Hovercard`](https://ariakit.org/reference/hovercard) or
+     * [`HovercardProvider`](https://ariakit.org/reference/hovercard-provider)
+     * components' context will be used.
      */
     store?: HovercardStore;
 }

package/esm/hovercard/hovercard-dismiss.js

@@ -1,16 +1,16 @@
 import {
   HovercardDismiss,
   useHovercardDismiss
-} from "../__chunks/AYWP3ZW6.js";
-import "../__chunks/4JNX5L5C.js";
-import "../__chunks/HMYMEP6U.js";
-import "../__chunks/QPWEKAWF.js";
-import "../__chunks/LND6SMHN.js";
+} from "../__chunks/5QIDAYL3.js";
+import "../__chunks/T5VBGHBO.js";
+import "../__chunks/W5ZMSHVN.js";
+import "../__chunks/D2BRO4YW.js";
+import "../__chunks/XBIFFFUN.js";
 import "../__chunks/5DA3HK6G.js";
 import "../__chunks/547DFODS.js";
 import "../__chunks/5YYGDU4E.js";
 import "../__chunks/56KWVYDN.js";
-import "../__chunks/M4OAD5XF.js";
+import "../__chunks/YTHH33BK.js";
 import "../__chunks/BMLNRUFQ.js";
 import "../__chunks/CFEUKV6C.js";
 import "../__chunks/J7Q2EO23.js";

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

@@ -15,23 +15,28 @@ import type { HovercardStore } from "./hovercard-store.js";
  */
 export declare const useHovercardHeading: import("../utils/types.js").Hook<HovercardHeadingOptions<"h1">>;
 /**
- * Renders a heading in a hovercard. This component must be wrapped with
- * `Hovercard` so the `aria-labelledby` prop is properly set on the hovercard
- * element.
+ * 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.
  * @see https://ariakit.org/components/hovercard
  * @example
  * ```jsx
- * const hovercard = useHovercardStore();
- * <Hovercard store={hovercard}>
- *   <HovercardHeading>Heading</HovercardHeading>
- * </Hovercard>
+ * <HovercardProvider>
+ *   <Hovercard>
+ *     <HovercardHeading>Heading</HovercardHeading>
+ *   </Hovercard>
+ * </HovercardProvider>
  * ```
  */
 export declare const HovercardHeading: import("../utils/types.js").Component<HovercardHeadingOptions<"h1">>;
 export interface HovercardHeadingOptions<T extends As = "h1"> extends PopoverHeadingOptions<T> {
     /**
-     * Object returned by the `useHovercardStore` hook. If not provided, the
-     * parent `Hovercard` component's context will be used.
+     * Object returned by the
+     * [`useHovercardStore`](https://ariakit.org/reference/use-hovercard-store)
+     * hook. If not provided, the closest
+     * [`Hovercard`](https://ariakit.org/reference/hovercard) or
+     * [`HovercardProvider`](https://ariakit.org/reference/hovercard-provider)
+     * components' context will be used.
      */
     store?: HovercardStore;
 }

package/esm/hovercard/hovercard-provider.js

@@ -7,11 +7,11 @@ import "../__chunks/56KWVYDN.js";
 import "../__chunks/CFEUKV6C.js";
 import {
   useHovercardStore
-} from "../__chunks/MA5WD4CD.js";
-import "../__chunks/XEZV3AK4.js";
-import "../__chunks/HCTAKPNS.js";
-import "../__chunks/E6GADH6Y.js";
-import "../__chunks/XXO3VVQU.js";
+} from "../__chunks/JE342XIS.js";
+import "../__chunks/DO6GQUCF.js";
+import "../__chunks/DJUMA466.js";
+import "../__chunks/BWOZSOC7.js";
+import "../__chunks/4LP74VAP.js";
 import "../__chunks/J7Q2EO23.js";
 import "../__chunks/CP3U4HPL.js";
 import "../__chunks/PNRLI7OV.js";

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

@@ -8,6 +8,7 @@ export declare function useHovercardStoreProps<T extends Core.HovercardStore>(st
  * @example
  * ```jsx
  * const hovercard = useHovercardStore({ placement: "top" });
+ *
  * <HovercardAnchor store={hovercard}>@username</HovercardAnchor>
  * <Hovercard store={hovercard}>Details</Hovercard>
  * ```

package/esm/hovercard/hovercard-store.js

@@ -1,11 +1,11 @@
 import {
   useHovercardStore,
   useHovercardStoreProps
-} from "../__chunks/MA5WD4CD.js";
-import "../__chunks/XEZV3AK4.js";
-import "../__chunks/HCTAKPNS.js";
-import "../__chunks/E6GADH6Y.js";
-import "../__chunks/XXO3VVQU.js";
+} from "../__chunks/JE342XIS.js";
+import "../__chunks/DO6GQUCF.js";
+import "../__chunks/DJUMA466.js";
+import "../__chunks/BWOZSOC7.js";
+import "../__chunks/4LP74VAP.js";
 import "../__chunks/J7Q2EO23.js";
 import "../__chunks/CP3U4HPL.js";
 import "../__chunks/PNRLI7OV.js";

package/esm/hovercard/hovercard.d.ts

@@ -16,19 +16,25 @@ import type { HovercardStore } from "./hovercard-store.js";
 export declare const useHovercard: import("../utils/types.js").Hook<HovercardOptions<"div">>;
 /**
  * Renders a hovercard element, which is a popover that's usually made visible
- * by hovering the mouse cursor over an anchor element (`HovercardAnchor`).
+ * by hovering the mouse cursor over a
+ * [`HovercardAnchor`](https://ariakit.org/reference/hovercard-anchor).
  * @see https://ariakit.org/components/hovercard
  * @example
  * ```jsx
- * const hovercard = useHovercardStore();
- * <HovercardAnchor store={hovercard}>@username</HovercardAnchor>
- * <Hovercard store={hovercard}>Details</Hovercard>
+ * <HovercardProvider>
+ *   <HovercardAnchor>@username</HovercardAnchor>
+ *   <Hovercard>Details</Hovercard>
+ * </HovercardProvider>
  * ```
  */
 export declare const Hovercard: import("../utils/types.js").Component<HovercardOptions<"div">>;
 export interface HovercardOptions<T extends As = "div"> extends PopoverOptions<T> {
     /**
-     * Object returned by the `useHovercardStore` hook.
+     * Object returned by the
+     * [`useHovercardStore`](https://ariakit.org/reference/use-hovercard-store)
+     * hook. If not provided, the closest
+     * [`HovercardProvider`](https://ariakit.org/reference/hovercard-provider)
+     * component's context will be used.
      */
     store?: HovercardStore;
     /**

package/esm/hovercard/hovercard.js

@@ -1,20 +1,20 @@
 import {
   Hovercard,
   useHovercard
-} from "../__chunks/YJPXO6F5.js";
+} from "../__chunks/4VQSZLZX.js";
 import "../__chunks/X7FKJQME.js";
-import "../__chunks/RVGVDX6B.js";
-import "../__chunks/CJPLAYFB.js";
-import "../__chunks/NRLOAE2I.js";
-import "../__chunks/PLOINBVB.js";
-import "../__chunks/HAVCR65N.js";
+import "../__chunks/MNVQ65E5.js";
+import "../__chunks/YGEFENKI.js";
+import "../__chunks/IAA7Y45N.js";
+import "../__chunks/HWJ7DGMR.js";
+import "../__chunks/7LB47D2O.js";
 import "../__chunks/62DFK33R.js";
-import "../__chunks/KGDYSCOM.js";
-import "../__chunks/XASENZA4.js";
-import "../__chunks/X5VV5CBA.js";
+import "../__chunks/FRKOFFMT.js";
+import "../__chunks/EGOOWJGN.js";
+import "../__chunks/7VWXICM7.js";
 import "../__chunks/KOVUJERF.js";
 import "../__chunks/IXXFVVA2.js";
-import "../__chunks/5M4ITSXL.js";
+import "../__chunks/VRCYQ6JX.js";
 import "../__chunks/7JNF6I52.js";
 import "../__chunks/3LGVTTHD.js";
 import "../__chunks/FW6QFGFT.js";
@@ -31,12 +31,12 @@ import "../__chunks/5DA3HK6G.js";
 import "../__chunks/547DFODS.js";
 import "../__chunks/5YYGDU4E.js";
 import "../__chunks/56KWVYDN.js";
-import "../__chunks/M4OAD5XF.js";
+import "../__chunks/YTHH33BK.js";
 import "../__chunks/BMLNRUFQ.js";
 import "../__chunks/6XXSNRNX.js";
 import "../__chunks/CFEUKV6C.js";
-import "../__chunks/E6GADH6Y.js";
-import "../__chunks/XXO3VVQU.js";
+import "../__chunks/BWOZSOC7.js";
+import "../__chunks/4LP74VAP.js";
 import "../__chunks/J7Q2EO23.js";
 import "../__chunks/CP3U4HPL.js";
 import "../__chunks/PNRLI7OV.js";

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

@@ -20,18 +20,22 @@ export declare const useMenuArrow: import("../utils/types.js").Hook<MenuArrowOpt
  * @see https://ariakit.org/components/menu
  * @example
  * ```jsx
- * const menu = useMenuStore();
- * <MenuButton store={menu}>Menu</MenuButton>
- * <Menu store={menu}>
- *   <MenuArrow />
- * </Menu>
+ * <MenuProvider>
+ *   <MenuButton>Menu</MenuButton>
+ *   <Menu>
+ *     <MenuArrow />
+ *   </Menu>
+ * </MenuProvider>
  * ```
  */
 export declare const MenuArrow: import("../utils/types.js").Component<MenuArrowOptions<"div">>;
 export interface MenuArrowOptions<T extends As = "div"> extends PopoverArrowOptions<T> {
     /**
-     * Object returned by the `useMenuStore` hook. If not provided, the parent
-     * `Menu` component's context will be used.
+     * 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;
 }

package/esm/menu/menu-bar-provider.js

@@ -1,11 +1,11 @@
 import {
   useMenuBarStore
-} from "../__chunks/K6BB6DTS.js";
+} from "../__chunks/YI522MHJ.js";
 import {
   MenuBarContextProvider
 } from "../__chunks/2GC3IEM7.js";
-import "../__chunks/WGAKICTY.js";
-import "../__chunks/NWDF5QDV.js";
+import "../__chunks/EZ23JQKA.js";
+import "../__chunks/C6MBVGZ2.js";
 import "../__chunks/5C7J4IAS.js";
 import "../__chunks/74KKBFVP.js";
 import "../__chunks/5DA3HK6G.js";
@@ -13,7 +13,7 @@ import "../__chunks/547DFODS.js";
 import "../__chunks/5YYGDU4E.js";
 import "../__chunks/56KWVYDN.js";
 import "../__chunks/CFEUKV6C.js";
-import "../__chunks/XXO3VVQU.js";
+import "../__chunks/4LP74VAP.js";
 import "../__chunks/J7Q2EO23.js";
 import "../__chunks/CP3U4HPL.js";
 import "../__chunks/PNRLI7OV.js";

package/esm/menu/menu-bar-store.js

@@ -1,10 +1,10 @@
 import {
   useMenuBarStore,
   useMenuBarStoreProps
-} from "../__chunks/K6BB6DTS.js";
-import "../__chunks/WGAKICTY.js";
-import "../__chunks/NWDF5QDV.js";
-import "../__chunks/XXO3VVQU.js";
+} from "../__chunks/YI522MHJ.js";
+import "../__chunks/EZ23JQKA.js";
+import "../__chunks/C6MBVGZ2.js";
+import "../__chunks/4LP74VAP.js";
 import "../__chunks/J7Q2EO23.js";
 import "../__chunks/CP3U4HPL.js";
 import "../__chunks/PNRLI7OV.js";

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

@@ -28,33 +28,34 @@ export declare const useMenuBar: import("../utils/types.js").Hook<MenuBarOptions
  * @see https://ariakit.org/components/menu
  * @example
  * ```jsx
- * const store = useMenuBarStore();
- * const fileProps = useMenuItem({ store });
- * const editProps = useMenuItem({ store });
- * const fileMenu = useMenuStore();
- * const editMenu = useMenuStore();
- * <MenuBar store={store}>
- *   <MenuButton {...fileProps} store={fileMenu}>
- *     File
- *   </MenuButton>
- *   <Menu store={fileMenu}>
- *     <MenuItem>New File</MenuItem>
- *     <MenuItem>New Window</MenuItem>
- *   </Menu>
- *   <MenuButton {...editProps} store={editMenu}>
- *     Edit
- *   </MenuButton>
- *   <Menu store={editMenu}>
- *     <MenuItem>Undo</MenuItem>
- *     <MenuItem>Redo</MenuItem>
- *   </Menu>
- * </MenuBar>
+ * <MenuBarProvider>
+ *   <MenuBar>
+ *     <MenuProvider>
+ *       <MenuItem render={<MenuButton />}>File</MenuItem>
+ *       <Menu>
+ *         <MenuItem>New File</MenuItem>
+ *         <MenuItem>New Window</MenuItem>
+ *       </Menu>
+ *     </MenuProvider>
+ *     <MenuProvider>
+ *       <MenuItem render={<MenuButton />}>Edit</MenuItem>
+ *       <Menu>
+ *         <MenuItem>Undo</MenuItem>
+ *         <MenuItem>Redo</MenuItem>
+ *       </Menu>
+ *     </MenuProvider>
+ *   </MenuBar>
+ * </MenuBarProvider>
  * ```
  */
 export declare const MenuBar: import("../utils/types.js").Component<MenuBarOptions<"div">>;
 export interface MenuBarOptions<T extends As = "div"> extends CompositeOptions<T> {
     /**
-     * Object returned by the `useMenuBarStore` hook.
+     * Object returned by the
+     * [`useMenuBarStore`](https://ariakit.org/reference/use-menu-bar-store) hook.
+     * If not provided, the closest
+     * [`MenuBarProvider`](https://ariakit.org/reference/menu-bar-provider)
+     * component's context will be used.
      */
     store?: MenuBarStore;
 }

package/esm/menu/menu-bar.js

@@ -4,7 +4,7 @@ import {
 } from "../__chunks/2GC3IEM7.js";
 import {
   useComposite
-} from "../__chunks/HYNMOU7J.js";
+} from "../__chunks/56TAEBRJ.js";
 import "../__chunks/OXPV2NBK.js";
 import "../__chunks/5C7J4IAS.js";
 import "../__chunks/74KKBFVP.js";
@@ -12,7 +12,7 @@ import "../__chunks/5DA3HK6G.js";
 import "../__chunks/547DFODS.js";
 import "../__chunks/5YYGDU4E.js";
 import "../__chunks/56KWVYDN.js";
-import "../__chunks/M4OAD5XF.js";
+import "../__chunks/YTHH33BK.js";
 import "../__chunks/BMLNRUFQ.js";
 import {
   createComponent,