@ariakit/react-core 0.3.2 → 0.3.4

package/cjs/menu/menu-item-checkbox.cjs

@@ -1,21 +1,21 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});
 
-var _GBOZYA5Ccjs = require('../__chunks/GBOZYA5C.cjs');
+var _2H4Y2NEYcjs = require('../__chunks/2H4Y2NEY.cjs');
 
 
-var _HDYD5S2Pcjs = require('../__chunks/HDYD5S2P.cjs');
+var _ZIEW4CQOcjs = require('../__chunks/ZIEW4CQO.cjs');
 require('../__chunks/NER6RNCQ.cjs');
 
 
-var _V37GXOUJcjs = require('../__chunks/V37GXOUJ.cjs');
+var _TYMYFAUIcjs = require('../__chunks/TYMYFAUI.cjs');
 require('../__chunks/KFXK3MNI.cjs');
 
 
 var _6RYSMHQYcjs = require('../__chunks/6RYSMHQY.cjs');
 require('../__chunks/LPFT4ZFH.cjs');
 require('../__chunks/FO6MB5HF.cjs');
-require('../__chunks/G33PRHOG.cjs');
-require('../__chunks/NPDPNCSD.cjs');
+require('../__chunks/GUWJ7VTO.cjs');
+require('../__chunks/HWZH54NB.cjs');
 require('../__chunks/FMI5QF7N.cjs');
 require('../__chunks/KLZID3QO.cjs');
 require('../__chunks/H7R5D2FR.cjs');
@@ -24,14 +24,14 @@ require('../__chunks/Q6W7IWNJ.cjs');
 require('../__chunks/AKOG5S2T.cjs');
 require('../__chunks/W6ZRSMO5.cjs');
 require('../__chunks/A2NMYLCG.cjs');
-require('../__chunks/BFLDQF3L.cjs');
+require('../__chunks/GQAB4M3B.cjs');
 require('../__chunks/LHHW5ZQP.cjs');
 
 
 
 
 var _Z5PUIG6Acjs = require('../__chunks/Z5PUIG6A.cjs');
-require('../__chunks/I63PYP2U.cjs');
+require('../__chunks/EVNF7KMT.cjs');
 require('../__chunks/5WLTMVVQ.cjs');
 require('../__chunks/7WUTS26Y.cjs');
 
@@ -50,15 +50,15 @@ var useMenuItemCheckbox = _Z5PUIG6Acjs.createHook.call(void 0,
       store,
       process.env.NODE_ENV !== "production" && "MenuItemCheckbox must be wrapped in a MenuList or Menu component"
     );
-    const checkboxStore = _HDYD5S2Pcjs.useCheckboxStore.call(void 0, {
+    const checkboxStore = _ZIEW4CQOcjs.useCheckboxStore.call(void 0, {
       value: store.useState((state) => state.values[name]),
       setValue: (value) => store == null ? void 0 : store.setValue(name, value)
     });
     props = _72I2GWXFcjs.__spreadValues.call(void 0, {
       role: "menuitemcheckbox"
     }, props);
-    props = _GBOZYA5Ccjs.useCheckbox.call(void 0, _72I2GWXFcjs.__spreadValues.call(void 0, { store: checkboxStore, checked }, props));
-    props = _V37GXOUJcjs.useMenuItem.call(void 0, _72I2GWXFcjs.__spreadValues.call(void 0, { store, hideOnClick }, props));
+    props = _2H4Y2NEYcjs.useCheckbox.call(void 0, _72I2GWXFcjs.__spreadValues.call(void 0, { store: checkboxStore, checked }, props));
+    props = _TYMYFAUIcjs.useMenuItem.call(void 0, _72I2GWXFcjs.__spreadValues.call(void 0, { store, hideOnClick }, props));
     return props;
   }
 );

package/cjs/menu/menu-item-checkbox.d.ts

@@ -21,22 +21,27 @@ export declare const useMenuItemCheckbox: import("../utils/types.js").Hook<MenuI
  * @see https://ariakit.org/components/menu
  * @example
  * ```jsx
- * const menu = useMenuStore({ defaultValues: { apple: false } });
- * <MenuButton store={menu}>Fruits</MenuButton>
- * <Menu store={menu}>
- *   <MenuItemCheckbox name="apple">Apple</MenuItemCheckbox>
- * </Menu>
+ * <MenuProvider defaultValues={{ apple: false }}>
+ *   <MenuButton>Fruits</MenuButton>
+ *   <Menu>
+ *     <MenuItemCheckbox name="apple">Apple</MenuItemCheckbox>
+ *   </Menu>
+ * </MenuProvider>
  * ```
  */
 export declare const MenuItemCheckbox: import("../utils/types.js").Component<MenuItemCheckboxOptions<"div">>;
 export interface MenuItemCheckboxOptions<T extends As = "div"> extends MenuItemOptions<T>, Omit<CheckboxOptions<T>, "store"> {
     /**
-     * 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;
     /**
-     * MenuItemCheckbox's name as in `menu.values`.
+     * MenuItemCheckbox's name as specified in the
+     * [`values`](https://ariakit.org/reference/menu-provider#values) state.
      */
     name: string;
     /**

package/cjs/menu/menu-item-radio.cjs

@@ -1,6 +1,6 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});
 
-var _V37GXOUJcjs = require('../__chunks/V37GXOUJ.cjs');
+var _TYMYFAUIcjs = require('../__chunks/TYMYFAUI.cjs');
 require('../__chunks/KFXK3MNI.cjs');
 
 
@@ -8,11 +8,11 @@ require('../__chunks/KFXK3MNI.cjs');
 var _6RYSMHQYcjs = require('../__chunks/6RYSMHQY.cjs');
 
 
-var _ZJ4ICN62cjs = require('../__chunks/ZJ4ICN62.cjs');
+var _5ZP4D2SQcjs = require('../__chunks/5ZP4D2SQ.cjs');
 require('../__chunks/FPNO6JL5.cjs');
 require('../__chunks/LPFT4ZFH.cjs');
-require('../__chunks/G33PRHOG.cjs');
-require('../__chunks/NPDPNCSD.cjs');
+require('../__chunks/GUWJ7VTO.cjs');
+require('../__chunks/HWZH54NB.cjs');
 require('../__chunks/FMI5QF7N.cjs');
 require('../__chunks/KLZID3QO.cjs');
 require('../__chunks/H7R5D2FR.cjs');
@@ -21,14 +21,14 @@ require('../__chunks/Q6W7IWNJ.cjs');
 require('../__chunks/AKOG5S2T.cjs');
 require('../__chunks/W6ZRSMO5.cjs');
 require('../__chunks/A2NMYLCG.cjs');
-require('../__chunks/BFLDQF3L.cjs');
+require('../__chunks/GQAB4M3B.cjs');
 require('../__chunks/LHHW5ZQP.cjs');
 
 
 
 
 var _Z5PUIG6Acjs = require('../__chunks/Z5PUIG6A.cjs');
-require('../__chunks/I63PYP2U.cjs');
+require('../__chunks/EVNF7KMT.cjs');
 
 
 var _5WLTMVVQcjs = require('../__chunks/5WLTMVVQ.cjs');
@@ -75,7 +75,7 @@ var useMenuItemRadio = _Z5PUIG6Acjs.createHook.call(void 0,
     props = _72I2GWXFcjs.__spreadValues.call(void 0, {
       role: "menuitemradio"
     }, props);
-    props = _ZJ4ICN62cjs.useRadio.call(void 0, _72I2GWXFcjs.__spreadValues.call(void 0, {
+    props = _5ZP4D2SQcjs.useRadio.call(void 0, _72I2GWXFcjs.__spreadValues.call(void 0, {
       value,
       checked: isChecked,
       onChange: (event) => {
@@ -85,7 +85,7 @@ var useMenuItemRadio = _Z5PUIG6Acjs.createHook.call(void 0,
         store == null ? void 0 : store.setValue(name, value);
       }
     }, props));
-    props = _V37GXOUJcjs.useMenuItem.call(void 0, _72I2GWXFcjs.__spreadValues.call(void 0, { store, hideOnClick }, props));
+    props = _TYMYFAUIcjs.useMenuItem.call(void 0, _72I2GWXFcjs.__spreadValues.call(void 0, { store, hideOnClick }, props));
     return props;
   }
 );

package/cjs/menu/menu-item-radio.d.ts

@@ -23,27 +23,32 @@ export declare const useMenuItemRadio: import("../utils/types.js").Hook<MenuItem
  * @see https://ariakit.org/components/menu
  * @example
  * ```jsx
- * const menu = useMenuStore({ defaultValues: { fruit: "apple" } });
- * <MenuButton store={menu}>Fruit</MenuButton>
- * <Menu store={menu}>
- *   <MenuItemRadio name="fruit" value="apple">
- *     Apple
- *   </MenuItemRadio>
- *   <MenuItemRadio name="fruit" value="orange">
- *     Orange
- *   </MenuItemRadio>
- * </Menu>
+ * <MenuProvider defaultValues={{ fruit: "apple" }}>
+ *   <MenuButton>Fruit</MenuButton>
+ *   <Menu>
+ *     <MenuItemRadio name="fruit" value="apple">
+ *       Apple
+ *     </MenuItemRadio>
+ *     <MenuItemRadio name="fruit" value="orange">
+ *       Orange
+ *     </MenuItemRadio>
+ *   </Menu>
+ * </MenuProvider>
  * ```
  */
 export declare const MenuItemRadio: import("../utils/types.js").Component<MenuItemRadioOptions<"div">>;
 export interface MenuItemRadioOptions<T extends As = "div"> extends MenuItemOptions<T>, Omit<RadioOptions<T>, "store"> {
     /**
-     * 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;
     /**
-     * MenuItemRadio's name as in `menu.values`.
+     * MenuItemRadio's name as specified in the
+     * [`values`](https://ariakit.org/reference/menu-provider#values) state.
      */
     name: string;
     /**

package/cjs/menu/menu-item.cjs

@@ -1,12 +1,12 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});
 
 
-var _V37GXOUJcjs = require('../__chunks/V37GXOUJ.cjs');
+var _TYMYFAUIcjs = require('../__chunks/TYMYFAUI.cjs');
 require('../__chunks/KFXK3MNI.cjs');
 require('../__chunks/6RYSMHQY.cjs');
 require('../__chunks/LPFT4ZFH.cjs');
-require('../__chunks/G33PRHOG.cjs');
-require('../__chunks/NPDPNCSD.cjs');
+require('../__chunks/GUWJ7VTO.cjs');
+require('../__chunks/HWZH54NB.cjs');
 require('../__chunks/FMI5QF7N.cjs');
 require('../__chunks/KLZID3QO.cjs');
 require('../__chunks/H7R5D2FR.cjs');
@@ -15,14 +15,14 @@ require('../__chunks/Q6W7IWNJ.cjs');
 require('../__chunks/AKOG5S2T.cjs');
 require('../__chunks/W6ZRSMO5.cjs');
 require('../__chunks/A2NMYLCG.cjs');
-require('../__chunks/BFLDQF3L.cjs');
+require('../__chunks/GQAB4M3B.cjs');
 require('../__chunks/LHHW5ZQP.cjs');
 require('../__chunks/Z5PUIG6A.cjs');
-require('../__chunks/I63PYP2U.cjs');
+require('../__chunks/EVNF7KMT.cjs');
 require('../__chunks/5WLTMVVQ.cjs');
 require('../__chunks/7WUTS26Y.cjs');
 require('../__chunks/72I2GWXF.cjs');
 
 
 
-exports.MenuItem = _V37GXOUJcjs.MenuItem; exports.useMenuItem = _V37GXOUJcjs.useMenuItem;
+exports.MenuItem = _TYMYFAUIcjs.MenuItem; exports.useMenuItem = _TYMYFAUIcjs.useMenuItem;

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

@@ -26,20 +26,27 @@ export declare const useMenuItem: import("../utils/types.js").Hook<MenuItemOptio
  * @see https://ariakit.org/components/menu
  * @example
  * ```jsx
- * const menu = useMenuStore();
- * <MenuButton store={menu}>Edit</MenuButton>
- * <Menu store={menu}>
- *   <MenuItem>Undo</MenuItem>
- *   <MenuItem>Redo</MenuItem>
- * </Menu>
+ * <MenuProvider>
+ *   <MenuButton>Edit</MenuButton>
+ *   <Menu>
+ *     <MenuItem>Undo</MenuItem>
+ *     <MenuItem>Redo</MenuItem>
+ *   </Menu>
+ * </MenuProvider>
  * ```
  */
 export declare const MenuItem: import("../utils/types.js").Component<MenuItemOptions<"div">>;
 export interface MenuItemOptions<T extends As = "div"> extends CompositeItemOptions<T>, CompositeHoverOptions<T> {
     /**
-     * Object returned by the `useMenuBarStore` or `useMenuStore` hooks. If not
-     * provided, the parent `Menu` or `MenuBar` components' context will be
-     * used.
+     * Object returned by the
+     * [`useMenuStore`](https://ariakit.org/reference/use-menu-store) or
+     * [`useMenuBarStore`](https://ariakit.org/reference/use-menu-bar-store)
+     * hooks. If not provided, the closest
+     * [`Menu`](https://ariakit.org/reference/menu),
+     * [`MenuProvider`](https://ariakit.org/reference/menu-provider),
+     * [`MenuBar`](https://ariakit.org/reference/menu-bar), or
+     * [`MenuBarProvider`](https://ariakit.org/reference/menu-bar-provider)
+     * components' context will be used.
      */
     store?: MenuBarStore | MenuStore;
     /**

package/cjs/menu/menu-list.cjs

@@ -1,26 +1,26 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});
 
 
-var _4HKELPDAcjs = require('../__chunks/4HKELPDA.cjs');
+var _GWFSX7RQcjs = require('../__chunks/GWFSX7RQ.cjs');
 require('../__chunks/6RYSMHQY.cjs');
 require('../__chunks/DC66R2NY.cjs');
-require('../__chunks/6G5GJF5Q.cjs');
+require('../__chunks/SELCJFCB.cjs');
 require('../__chunks/KLZID3QO.cjs');
 require('../__chunks/H7R5D2FR.cjs');
 require('../__chunks/NHZBX2RS.cjs');
-require('../__chunks/5E5FKYEO.cjs');
+require('../__chunks/L2VQ4YLN.cjs');
 require('../__chunks/Q6W7IWNJ.cjs');
 require('../__chunks/AKOG5S2T.cjs');
 require('../__chunks/W6ZRSMO5.cjs');
 require('../__chunks/A2NMYLCG.cjs');
-require('../__chunks/BFLDQF3L.cjs');
+require('../__chunks/GQAB4M3B.cjs');
 require('../__chunks/LHHW5ZQP.cjs');
 require('../__chunks/Z5PUIG6A.cjs');
-require('../__chunks/I63PYP2U.cjs');
+require('../__chunks/EVNF7KMT.cjs');
 require('../__chunks/5WLTMVVQ.cjs');
 require('../__chunks/7WUTS26Y.cjs');
 require('../__chunks/72I2GWXF.cjs');
 
 
 
-exports.MenuList = _4HKELPDAcjs.MenuList; exports.useMenuList = _4HKELPDAcjs.useMenuList;
+exports.MenuList = _GWFSX7RQcjs.MenuList; exports.useMenuList = _GWFSX7RQcjs.useMenuList;

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

@@ -23,18 +23,23 @@ export declare const useMenuList: import("../utils/types.js").Hook<MenuListOptio
  * @see https://ariakit.org/components/menu
  * @example
  * ```jsx
- * const menu = useMenuStore();
- * <MenuButton store={menu}>Edit</MenuButton>
- * <MenuList store={menu}>
- *   <MenuItem>Undo</MenuItem>
- *   <MenuItem>Redo</MenuItem>
- * </MenuList>
+ * <MenuProvider>
+ *   <MenuButton>Edit</MenuButton>
+ *   <MenuList>
+ *     <MenuItem>Undo</MenuItem>
+ *     <MenuItem>Redo</MenuItem>
+ *   </MenuList>
+ * </MenuProvider>
  * ```
  */
 export declare const MenuList: import("../utils/types.js").Component<MenuListOptions<"div">>;
 export interface MenuListOptions<T extends As = "div"> extends CompositeOptions<T>, CompositeTypeaheadOptions<T>, Pick<DisclosureContentOptions, "alwaysVisible"> {
     /**
-     * Object returned by the `useMenuStore` hook.
+     * 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;
 }

package/cjs/menu/menu-provider.cjs

@@ -1,12 +1,12 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});
 
-var _HFISYIKEcjs = require('../__chunks/HFISYIKE.cjs');
+var _DYNIQRKIcjs = require('../__chunks/DYNIQRKI.cjs');
 
 
 var _6RYSMHQYcjs = require('../__chunks/6RYSMHQY.cjs');
 require('../__chunks/ZBG4TGVL.cjs');
-require('../__chunks/FWCQCCG3.cjs');
-require('../__chunks/GCTYF2Y6.cjs');
+require('../__chunks/232HWSNY.cjs');
+require('../__chunks/76UBACFC.cjs');
 require('../__chunks/H7R5D2FR.cjs');
 require('../__chunks/NHZBX2RS.cjs');
 require('../__chunks/Q6W7IWNJ.cjs');
@@ -14,11 +14,11 @@ require('../__chunks/AKOG5S2T.cjs');
 require('../__chunks/W6ZRSMO5.cjs');
 require('../__chunks/A2NMYLCG.cjs');
 require('../__chunks/Z5PUIG6A.cjs');
-require('../__chunks/6UXB6PRK.cjs');
-require('../__chunks/E4C2KZA5.cjs');
-require('../__chunks/NATUYKIW.cjs');
-require('../__chunks/3ULNMLN7.cjs');
-require('../__chunks/I63PYP2U.cjs');
+require('../__chunks/RU4K4ZH6.cjs');
+require('../__chunks/O6SYRTZH.cjs');
+require('../__chunks/ZZZ5MQHA.cjs');
+require('../__chunks/HSOKUBYY.cjs');
+require('../__chunks/EVNF7KMT.cjs');
 require('../__chunks/5WLTMVVQ.cjs');
 require('../__chunks/7WUTS26Y.cjs');
 require('../__chunks/72I2GWXF.cjs');
@@ -26,7 +26,7 @@ require('../__chunks/72I2GWXF.cjs');
 // src/menu/menu-provider.tsx
 var _jsxruntime = require('react/jsx-runtime');
 function MenuProvider(props = {}) {
-  const store = _HFISYIKEcjs.useMenuStore.call(void 0, props);
+  const store = _DYNIQRKIcjs.useMenuStore.call(void 0, props);
   return /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _6RYSMHQYcjs.MenuContextProvider, { value: store, children: props.children });
 }
 

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

@@ -23,21 +23,25 @@ export declare const useMenuSeparator: import("../utils/types.js").Hook<MenuSepa
  * @see https://ariakit.org/components/menu
  * @example
  * ```jsx
- * const menu = useMenuStore();
- * <MenuButton store={menu}>Edit</MenuButton>
- * <Menu store={menu}>
- *   <MenuItem>Undo</MenuItem>
- *   <MenuItem>Redo</MenuItem>
- *   <MenuSeparator />
- *   <MenuItem>Cut</MenuItem>
- * </Menu>
+ * <MenuProvider>
+ *   <MenuButton>Edit</MenuButton>
+ *   <Menu>
+ *     <MenuItem>Undo</MenuItem>
+ *     <MenuItem>Redo</MenuItem>
+ *     <MenuSeparator />
+ *     <MenuItem>Cut</MenuItem>
+ *   </Menu>
+ * </MenuProvider>
  * ```
  */
 export declare const MenuSeparator: import("../utils/types.js").Component<MenuSeparatorOptions<"hr">>;
 export interface MenuSeparatorOptions<T extends As = "hr"> extends CompositeSeparatorOptions<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/cjs/menu/menu-store.cjs

@@ -1,11 +1,11 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});
 
 
-var _HFISYIKEcjs = require('../__chunks/HFISYIKE.cjs');
+var _DYNIQRKIcjs = require('../__chunks/DYNIQRKI.cjs');
 require('../__chunks/6RYSMHQY.cjs');
 require('../__chunks/ZBG4TGVL.cjs');
-require('../__chunks/FWCQCCG3.cjs');
-require('../__chunks/GCTYF2Y6.cjs');
+require('../__chunks/232HWSNY.cjs');
+require('../__chunks/76UBACFC.cjs');
 require('../__chunks/H7R5D2FR.cjs');
 require('../__chunks/NHZBX2RS.cjs');
 require('../__chunks/Q6W7IWNJ.cjs');
@@ -13,15 +13,15 @@ require('../__chunks/AKOG5S2T.cjs');
 require('../__chunks/W6ZRSMO5.cjs');
 require('../__chunks/A2NMYLCG.cjs');
 require('../__chunks/Z5PUIG6A.cjs');
-require('../__chunks/6UXB6PRK.cjs');
-require('../__chunks/E4C2KZA5.cjs');
-require('../__chunks/NATUYKIW.cjs');
-require('../__chunks/3ULNMLN7.cjs');
-require('../__chunks/I63PYP2U.cjs');
+require('../__chunks/RU4K4ZH6.cjs');
+require('../__chunks/O6SYRTZH.cjs');
+require('../__chunks/ZZZ5MQHA.cjs');
+require('../__chunks/HSOKUBYY.cjs');
+require('../__chunks/EVNF7KMT.cjs');
 require('../__chunks/5WLTMVVQ.cjs');
 require('../__chunks/7WUTS26Y.cjs');
 require('../__chunks/72I2GWXF.cjs');
 
 
 
-exports.useMenuStore = _HFISYIKEcjs.useMenuStore; exports.useMenuStoreProps = _HFISYIKEcjs.useMenuStoreProps;
+exports.useMenuStore = _DYNIQRKIcjs.useMenuStore; exports.useMenuStoreProps = _DYNIQRKIcjs.useMenuStoreProps;

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

@@ -98,25 +98,25 @@ export interface MenuStoreFunctions<T extends Values = Values> extends Pick<Menu
 export interface MenuStoreOptions<T extends Values = Values> extends Core.MenuStoreOptions<T>, CompositeStoreOptions, HovercardStoreOptions {
     /**
      * A callback that gets called when the `values` state changes.
-     * @param values The new values.
-     * @example
-     * const [values, setValues] = useState({});
-     * const menu = useMenuStore({ values, setValues });
+     *
+     * Live examples:
+     * - [MenuItemCheckbox](https://ariakit.org/examples/menu-item-checkbox)
      */
     setValues?: BivariantCallback<(values: MenuStoreState<T>["values"]) => void>;
     /**
      * A reference to a combobox store. This is used when combining the combobox
      * with a menu (e.g., dropdown menu with a search input). The stores will
      * share the same state.
-     *
-     * Live examples:
-     * - [Menu with Combobox](https://ariakit.org/examples/menu-combobox)
      */
     combobox?: ComboboxStore | null;
     /**
      * A reference to a parent menu store. It's automatically set when nesting
-     * menus in the React tree. You should manually set this if menus aren't nested
-     * in the React tree.
+     * menus in the React tree. You should manually set this if menus aren't
+     * nested in the React tree.
+     *
+     * Live examples:
+     * - [MenuBar](https://ariakit.org/examples/menu-bar)
+     * - [Submenu](https://ariakit.org/examples/menu-nested)
      */
     parent?: MenuStore | null;
     /**