@ariakit/core 0.3.9 → 0.3.11

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

@@ -19,6 +19,10 @@ export interface FormStoreItem extends CollectionStoreItem {
 export interface FormStoreState<T extends FormStoreValues = FormStoreValues> extends CollectionStoreState<FormStoreItem> {
     /**
      * Form values.
+     *
+     * Live examples:
+     * - [FormRadio](https://ariakit.org/examples/form-radio)
+     * - [FormSelect](https://ariakit.org/examples/form-select)
      * @default {}
      */
     values: T;
@@ -43,18 +47,25 @@ export interface FormStoreState<T extends FormStoreValues = FormStoreValues> ext
      */
     submitting: boolean;
     /**
-     * The number of times `form.submit` has been called with a successful
-     * response.
+     * The number of times
+     * [`submit`](https://ariakit.org/reference/use-form-store#submit) has been
+     * called with a successful response.
      */
     submitSucceed: number;
     /**
-     * The number of times `form.submit` has been called with an error response.
+     * The number of times
+     * [`submit`](https://ariakit.org/reference/use-form-store#submit) has been
+     * called with an error response.
      */
     submitFailed: number;
 }
 export interface FormStoreFunctions<T extends FormStoreValues = FormStoreValues> extends CollectionStoreFunctions<FormStoreItem> {
     /**
-     * An object containing the names of the form fields for type-safety.
+     * An object containing the names of the form fields for type safety.
+     *
+     * Live examples:
+     * - [FormRadio](https://ariakit.org/examples/form-radio)
+     * - [FormSelect](https://ariakit.org/examples/form-select)
      * @example
      * store.names.name; // "name"
      * store.names.name.first; // "name.first"
@@ -62,7 +73,8 @@ export interface FormStoreFunctions<T extends FormStoreValues = FormStoreValues>
      */
     names: Names<T>;
     /**
-     * Sets the `values` state.
+     * Sets the [`values`](https://ariakit.org/reference/form-provider#values)
+     * state.
      * @example
      * store.setValues({ name: "John" });
      * store.setValues((values) => ({ ...values, name: "John" }));
@@ -70,7 +82,9 @@ export interface FormStoreFunctions<T extends FormStoreValues = FormStoreValues>
     setValues: SetState<FormStoreState<T>["values"]>;
     /**
      * Retrieves a field value.
-     * @param name The field name.
+     *
+     * Live examples:
+     * - [FormRadio](https://ariakit.org/examples/form-radio)
      * @example
      * const nameValue = store.getValue("name");
      * // Can also use store.names for type-safety.
@@ -79,8 +93,9 @@ export interface FormStoreFunctions<T extends FormStoreValues = FormStoreValues>
     getValue: <T = any>(name: StringLike) => T;
     /**
      * Sets a field value.
-     * @param name The field name.
-     * @param value The field value.
+     *
+     * Live examples:
+     * - [FormSelect](https://ariakit.org/examples/form-select)
      * @example
      * store.setValue("name", "John");
      * store.setValue("name", (value) => value + " Doe");
@@ -90,8 +105,6 @@ export interface FormStoreFunctions<T extends FormStoreValues = FormStoreValues>
     setValue: <T>(name: StringLike, value: SetStateAction<T>) => void;
     /**
      * Pushes a value to an array field.
-     * @param name The array field name.
-     * @param value The value to push.
      * @example
      * store.pushValue("tags", "new tag");
      * store.pushValue("tags", { id: 1, name: "new tag" });
@@ -101,8 +114,6 @@ export interface FormStoreFunctions<T extends FormStoreValues = FormStoreValues>
     pushValue: <T>(name: StringLike, value: T) => void;
     /**
      * Removes a value from an array field.
-     * @param name The array field name.
-     * @param index The index of the value to remove.
      * @example
      * store.removeValue("tags", 0);
      * store.removeValue("tags", 1);
@@ -111,7 +122,8 @@ export interface FormStoreFunctions<T extends FormStoreValues = FormStoreValues>
      */
     removeValue: (name: StringLike, index: number) => void;
     /**
-     * Sets the `errors` state.
+     * Sets the [`errors`](https://ariakit.org/reference/form-provider#errors)
+     * state.
      * @example
      * store.setErrors({ name: "Name is required" });
      * store.setErrors((errors) => ({ ...errors, name: "Name is required" }));
@@ -119,7 +131,6 @@ export interface FormStoreFunctions<T extends FormStoreValues = FormStoreValues>
     setErrors: SetState<FormStoreState<T>["errors"]>;
     /**
      * Retrieves a field error.
-     * @param name The field name.
      * @example
      * const nameError = store.getError("name");
      * // Can also use store.names for type-safety.
@@ -128,8 +139,9 @@ export interface FormStoreFunctions<T extends FormStoreValues = FormStoreValues>
     getError: (name: StringLike) => ErrorMessage;
     /**
      * Sets a field error.
-     * @param name The field name.
-     * @param error The field error.
+     *
+     * Live examples:
+     * - [FormRadio](https://ariakit.org/examples/form-radio)
      * @example
      * store.setError("name", "Name is required");
      * store.setError("name", (error) => error + "!");
@@ -138,7 +150,8 @@ export interface FormStoreFunctions<T extends FormStoreValues = FormStoreValues>
      */
     setError: (name: StringLike, error: SetStateAction<ErrorMessage>) => void;
     /**
-     * Sets the `touched` state.
+     * Sets the [`touched`](https://ariakit.org/reference/form-provider#touched)
+     * state.
      * @example
      * store.setTouched({ name: true });
      * store.setTouched((touched) => ({ ...touched, name: true }));
@@ -146,7 +159,6 @@ export interface FormStoreFunctions<T extends FormStoreValues = FormStoreValues>
     setTouched: SetState<FormStoreState<T>["touched"]>;
     /**
      * Retrieves a field touched state.
-     * @param name The field name.
      * @example
      * const nameTouched = store.getFieldTouched("name");
      * // Can also use store.names for type-safety.
@@ -155,8 +167,6 @@ export interface FormStoreFunctions<T extends FormStoreValues = FormStoreValues>
     getFieldTouched: (name: StringLike) => boolean;
     /**
      * Sets a field touched state.
-     * @param name The field name.
-     * @param value The field touched state.
      * @example
      * store.setFieldTouched("name", true);
      * store.setFieldTouched("name", (value) => !value);
@@ -166,9 +176,8 @@ export interface FormStoreFunctions<T extends FormStoreValues = FormStoreValues>
     setFieldTouched: (name: StringLike, value: SetStateAction<boolean>) => void;
     /**
      * Function that accepts a callback that will be used to validate the form
-     * when `validate` is called. It returns a cleanup function that will remove
-     * the callback.
-     * @param callback The callback function.
+     * when [`validate`](https://ariakit.org/reference/use-form-store#validate) is
+     * called. It returns a cleanup function that will remove the callback.
      * @example
      * const cleanup = store.onValidate(async (state) => {
      *   const errors = await api.validate(state.values);
@@ -179,9 +188,9 @@ export interface FormStoreFunctions<T extends FormStoreValues = FormStoreValues>
      */
     onValidate: (callback: FormStoreCallback<FormStoreState<T>>) => void;
     /**
-     * Function that accepts a callback that will be used to submit the form
-     * when `submit` is called. It returns a cleanup function that will remove
-     * the callback.
+     * Function that accepts a callback that will be used to submit the form when
+     * [`submit`](https://ariakit.org/reference/use-form-store#submit) is called.
+     * It returns a cleanup function that will remove the callback.
      * @param callback The callback function.
      * @example
      * const cleanup = store.onSubmit(async (state) => {

package/cjs/hovercard/hovercard-store.cjs

@@ -1,13 +1,13 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});"use client";
 
 
-var _5SIVMOIDcjs = require('../__chunks/5SIVMOID.cjs');
-require('../__chunks/EFIT5L4X.cjs');
-require('../__chunks/2LS4JJ4S.cjs');
-require('../__chunks/GJFZ5ZPP.cjs');
-require('../__chunks/2UK5WUJX.cjs');
-require('../__chunks/3UT5FE6K.cjs');
+var _TQTGWD5Kcjs = require('../__chunks/TQTGWD5K.cjs');
+require('../__chunks/E53JW5BD.cjs');
+require('../__chunks/I3Y4EXEF.cjs');
+require('../__chunks/OTVLDMN2.cjs');
+require('../__chunks/F6HPKLO2.cjs');
+require('../__chunks/KBNYGXWI.cjs');
 require('../__chunks/AV6KTKLE.cjs');
 
 
-exports.createHovercardStore = _5SIVMOIDcjs.createHovercardStore;
+exports.createHovercardStore = _TQTGWD5Kcjs.createHovercardStore;

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

@@ -12,14 +12,16 @@ export interface HovercardStoreState extends PopoverStoreState {
     placement: PopoverStoreState["placement"];
     /**
      * The amount of time in milliseconds to wait before showing and hiding the
-     * popover. To control the delay for showing and hiding separately, use
-     * `showTimeout` and `hideTimeout`.
+     * popup. To control the delay for showing and hiding separately, use
+     * [`showTimeout`](https://ariakit.org/reference/hovercard-provider#showtimeout)
+     * and
+     * [`hideTimeout`](https://ariakit.org/reference/hovercard-provider#hidetimeout).
      * @default 500
      */
     timeout: number;
     /**
-     * The amount of time in milliseconds to wait before **showing** the popover.
-     * It defaults to the value passed to
+     * The amount of time in milliseconds to wait before _showing_ the popup. It
+     * defaults to the value passed to
      * [`timeout`](https://ariakit.org/reference/hovercard-provider#timeout).
      *
      * Live examples:
@@ -29,16 +31,18 @@ export interface HovercardStoreState extends PopoverStoreState {
      */
     showTimeout?: number;
     /**
-     * The amount of time in milliseconds to wait before **hiding** the popover.
-     * It defaults to the value passed to
+     * The amount of time in milliseconds to wait before _hiding_ the popup. It
+     * defaults to the value passed to
      * [`timeout`](https://ariakit.org/reference/hovercard-provider#timeout).
      *
      * Live examples:
      * - [Navigation Menubar](https://ariakit.org/examples/menubar-navigation)
+     * - [Tooltip with Framer
+     *   Motion](https://ariakit.org/examples/tooltip-framer-motion)
      */
     hideTimeout?: number;
     /**
-     * Whether the popover or an element inside it should be focused when it is
+     * Whether the popup or an element inside it should be focused when it is
      * shown.
      * @default false
      */
@@ -47,6 +51,9 @@ export interface HovercardStoreState extends PopoverStoreState {
 export interface HovercardStoreFunctions extends PopoverStoreFunctions {
     /**
      * Sets the `autoFocusOnShow` state.
+     *
+     * Live examples:
+     * - [Sliding Menu](https://ariakit.org/examples/menu-slide)
      */
     setAutoFocusOnShow: SetState<HovercardStoreState["autoFocusOnShow"]>;
 }

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

@@ -12,14 +12,16 @@ export interface HovercardStoreState extends PopoverStoreState {
     placement: PopoverStoreState["placement"];
     /**
      * The amount of time in milliseconds to wait before showing and hiding the
-     * popover. To control the delay for showing and hiding separately, use
-     * `showTimeout` and `hideTimeout`.
+     * popup. To control the delay for showing and hiding separately, use
+     * [`showTimeout`](https://ariakit.org/reference/hovercard-provider#showtimeout)
+     * and
+     * [`hideTimeout`](https://ariakit.org/reference/hovercard-provider#hidetimeout).
      * @default 500
      */
     timeout: number;
     /**
-     * The amount of time in milliseconds to wait before **showing** the popover.
-     * It defaults to the value passed to
+     * The amount of time in milliseconds to wait before _showing_ the popup. It
+     * defaults to the value passed to
      * [`timeout`](https://ariakit.org/reference/hovercard-provider#timeout).
      *
      * Live examples:
@@ -29,16 +31,18 @@ export interface HovercardStoreState extends PopoverStoreState {
      */
     showTimeout?: number;
     /**
-     * The amount of time in milliseconds to wait before **hiding** the popover.
-     * It defaults to the value passed to
+     * The amount of time in milliseconds to wait before _hiding_ the popup. It
+     * defaults to the value passed to
      * [`timeout`](https://ariakit.org/reference/hovercard-provider#timeout).
      *
      * Live examples:
      * - [Navigation Menubar](https://ariakit.org/examples/menubar-navigation)
+     * - [Tooltip with Framer
+     *   Motion](https://ariakit.org/examples/tooltip-framer-motion)
      */
     hideTimeout?: number;
     /**
-     * Whether the popover or an element inside it should be focused when it is
+     * Whether the popup or an element inside it should be focused when it is
      * shown.
      * @default false
      */
@@ -47,6 +51,9 @@ export interface HovercardStoreState extends PopoverStoreState {
 export interface HovercardStoreFunctions extends PopoverStoreFunctions {
     /**
      * Sets the `autoFocusOnShow` state.
+     *
+     * Live examples:
+     * - [Sliding Menu](https://ariakit.org/examples/menu-slide)
      */
     setAutoFocusOnShow: SetState<HovercardStoreState["autoFocusOnShow"]>;
 }

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

@@ -1,18 +1,18 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});"use client";
 
 
-var _UTICNXSTcjs = require('../__chunks/UTICNXST.cjs');
-require('../__chunks/JNFZSNOI.cjs');
-require('../__chunks/UCLKUBNP.cjs');
-require('../__chunks/2UK5WUJX.cjs');
-require('../__chunks/3UT5FE6K.cjs');
+var _NOFH2BLBcjs = require('../__chunks/NOFH2BLB.cjs');
+require('../__chunks/BFE5R4EZ.cjs');
+require('../__chunks/MI6NUQYQ.cjs');
+require('../__chunks/F6HPKLO2.cjs');
+require('../__chunks/KBNYGXWI.cjs');
 require('../__chunks/5F4DVUNS.cjs');
 require('../__chunks/ULSPM3Y3.cjs');
 require('../__chunks/AV6KTKLE.cjs');
 
 // src/menu/menu-bar-store.ts
 function createMenuBarStore(props = {}) {
-  return _UTICNXSTcjs.createMenubarStore.call(void 0, props);
+  return _NOFH2BLBcjs.createMenubarStore.call(void 0, props);
 }
 
 

package/cjs/menu/menu-store.cjs

@@ -1,14 +1,14 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});"use client";
 
 
-var _5SIVMOIDcjs = require('../__chunks/5SIVMOID.cjs');
-require('../__chunks/EFIT5L4X.cjs');
-require('../__chunks/2LS4JJ4S.cjs');
-require('../__chunks/GJFZ5ZPP.cjs');
+var _TQTGWD5Kcjs = require('../__chunks/TQTGWD5K.cjs');
+require('../__chunks/E53JW5BD.cjs');
+require('../__chunks/I3Y4EXEF.cjs');
+require('../__chunks/OTVLDMN2.cjs');
 
 
-var _JNFZSNOIcjs = require('../__chunks/JNFZSNOI.cjs');
-require('../__chunks/UCLKUBNP.cjs');
+var _BFE5R4EZcjs = require('../__chunks/BFE5R4EZ.cjs');
+require('../__chunks/MI6NUQYQ.cjs');
 
 
 
@@ -17,11 +17,11 @@ require('../__chunks/UCLKUBNP.cjs');
 
 
 
-var _2UK5WUJXcjs = require('../__chunks/2UK5WUJX.cjs');
+var _F6HPKLO2cjs = require('../__chunks/F6HPKLO2.cjs');
 
 
 
-var _3UT5FE6Kcjs = require('../__chunks/3UT5FE6K.cjs');
+var _KBNYGXWIcjs = require('../__chunks/KBNYGXWI.cjs');
 require('../__chunks/5F4DVUNS.cjs');
 require('../__chunks/ULSPM3Y3.cjs');
 
@@ -42,10 +42,10 @@ function createMenuStore(_a = {}) {
     "menubar"
   ]);
   const parentIsMenubar = !!menubar && !parent;
-  const store = _2UK5WUJXcjs.mergeStore.call(void 0, 
+  const store = _F6HPKLO2cjs.mergeStore.call(void 0, 
     props.store,
-    _2UK5WUJXcjs.pick.call(void 0, parent, ["values"]),
-    _2UK5WUJXcjs.omit.call(void 0, combobox, [
+    _F6HPKLO2cjs.pick.call(void 0, parent, ["values"]),
+    _F6HPKLO2cjs.omit.call(void 0, combobox, [
       "arrowElement",
       "anchorElement",
       "contentElement",
@@ -53,51 +53,51 @@ function createMenuStore(_a = {}) {
       "disclosureElement"
     ])
   );
-  _2UK5WUJXcjs.throwOnConflictingProps.call(void 0, props, store);
+  _F6HPKLO2cjs.throwOnConflictingProps.call(void 0, props, store);
   const syncState = store.getState();
-  const composite = _JNFZSNOIcjs.createCompositeStore.call(void 0, _AV6KTKLEcjs.__spreadProps.call(void 0, _AV6KTKLEcjs.__spreadValues.call(void 0, {}, props), {
+  const composite = _BFE5R4EZcjs.createCompositeStore.call(void 0, _AV6KTKLEcjs.__spreadProps.call(void 0, _AV6KTKLEcjs.__spreadValues.call(void 0, {}, props), {
     store,
-    orientation: _3UT5FE6Kcjs.defaultValue.call(void 0, 
+    orientation: _KBNYGXWIcjs.defaultValue.call(void 0, 
       props.orientation,
       syncState.orientation,
       "vertical"
     )
   }));
-  const hovercard = _5SIVMOIDcjs.createHovercardStore.call(void 0, _AV6KTKLEcjs.__spreadProps.call(void 0, _AV6KTKLEcjs.__spreadValues.call(void 0, {}, props), {
+  const hovercard = _TQTGWD5Kcjs.createHovercardStore.call(void 0, _AV6KTKLEcjs.__spreadProps.call(void 0, _AV6KTKLEcjs.__spreadValues.call(void 0, {}, props), {
     store,
-    placement: _3UT5FE6Kcjs.defaultValue.call(void 0, 
+    placement: _KBNYGXWIcjs.defaultValue.call(void 0, 
       props.placement,
       syncState.placement,
       "bottom-start"
     ),
-    timeout: _3UT5FE6Kcjs.defaultValue.call(void 0, 
+    timeout: _KBNYGXWIcjs.defaultValue.call(void 0, 
       props.timeout,
       syncState.timeout,
       parentIsMenubar ? 0 : 150
     ),
-    hideTimeout: _3UT5FE6Kcjs.defaultValue.call(void 0, props.hideTimeout, syncState.hideTimeout, 0)
+    hideTimeout: _KBNYGXWIcjs.defaultValue.call(void 0, props.hideTimeout, syncState.hideTimeout, 0)
   }));
   const initialState = _AV6KTKLEcjs.__spreadProps.call(void 0, _AV6KTKLEcjs.__spreadValues.call(void 0, _AV6KTKLEcjs.__spreadValues.call(void 0, {}, composite.getState()), hovercard.getState()), {
-    initialFocus: _3UT5FE6Kcjs.defaultValue.call(void 0, syncState.initialFocus, "container"),
-    values: _3UT5FE6Kcjs.defaultValue.call(void 0, 
+    initialFocus: _KBNYGXWIcjs.defaultValue.call(void 0, syncState.initialFocus, "container"),
+    values: _KBNYGXWIcjs.defaultValue.call(void 0, 
       props.values,
       syncState.values,
       props.defaultValues,
       {}
     )
   });
-  const menu = _2UK5WUJXcjs.createStore.call(void 0, initialState, composite, hovercard, store);
-  _2UK5WUJXcjs.setup.call(void 0, 
+  const menu = _F6HPKLO2cjs.createStore.call(void 0, initialState, composite, hovercard, store);
+  _F6HPKLO2cjs.setup.call(void 0, 
     menu,
-    () => _2UK5WUJXcjs.sync.call(void 0, menu, ["mounted"], (state) => {
+    () => _F6HPKLO2cjs.sync.call(void 0, menu, ["mounted"], (state) => {
       if (state.mounted)
         return;
       menu.setState("activeId", null);
     })
   );
-  _2UK5WUJXcjs.setup.call(void 0, 
+  _F6HPKLO2cjs.setup.call(void 0, 
     menu,
-    () => _2UK5WUJXcjs.sync.call(void 0, parent, ["orientation"], (state) => {
+    () => _F6HPKLO2cjs.sync.call(void 0, parent, ["orientation"], (state) => {
       menu.setState(
         "placement",
         state.orientation === "vertical" ? "right-start" : "bottom-start"
@@ -123,7 +123,7 @@ function createMenuStore(_a = {}) {
         return;
       menu.setState("values", (values) => {
         const prevValue = values[name];
-        const nextValue = _3UT5FE6Kcjs.applyState.call(void 0, value, prevValue);
+        const nextValue = _KBNYGXWIcjs.applyState.call(void 0, value, prevValue);
         if (nextValue === prevValue)
           return values;
         return _AV6KTKLEcjs.__spreadProps.call(void 0, _AV6KTKLEcjs.__spreadValues.call(void 0, {}, values), {

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

@@ -13,10 +13,13 @@ export interface MenuStoreState<T extends MenuStoreValues = MenuStoreValues> ext
      */
     initialFocus: "container" | "first" | "last";
     /**
-     * A map of names and values that will be used by the `MenuItemCheckbox` and
-     * `MenuItemRadio` components.
+     * A map of names and values that will be used by the
+     * [`MenuItemCheckbox`](https://ariakit.org/reference/menu-item-checkbox) and
+     * [`MenuItemRadio`](https://ariakit.org/reference/menu-item-radio)
+     * components.
      *
      * Live examples:
+     * - [MenuItemCheckbox](https://ariakit.org/examples/menu-item-checkbox)
      * - [Submenu with
      *   Combobox](https://ariakit.org/examples/menu-nested-combobox)
      */
@@ -42,7 +45,8 @@ export interface MenuStoreFunctions<T extends MenuStoreValues = MenuStoreValues>
      */
     setInitialFocus: SetState<MenuStoreState<T>["initialFocus"]>;
     /**
-     * Sets the `values` state.
+     * Sets the [`values`](https://ariakit.org/reference/menu-provider#values)
+     * state.
      * @example
      * store.setValues({ watching: ["issues"] });
      * store.setValues((values) => ({ ...values, watching: ["issues"] }));
@@ -68,16 +72,21 @@ export interface MenuStoreOptions<T extends MenuStoreValues = MenuStoreValues> e
      */
     combobox?: ComboboxStore | null;
     /**
-     * A reference to a parent menu store. This should be used on nested menus.
+     * A reference to a parent menu store. This is used on nested menus.
      */
     parent?: MenuStore | null;
     /**
-     * A reference to a menu bar store. This should be used when rendering menus
-     * inside a menu bar.
+     * A reference to a menubar store. This is used when rendering menus inside a
+     * menubar.
      */
     menubar?: MenuBarStore | null;
     /**
-     * The default values for the `values` state.
+     * The default values for the
+     * [`values`](https://ariakit.org/reference/menu-provider#values) state.
+     *
+     * Live examples:
+     * - [MenuItemCheckbox](https://ariakit.org/examples/menu-item-checkbox)
+     * - [MenuItemRadio](https://ariakit.org/examples/menu-item-radio)
      * @default {}
      */
     defaultValues?: MenuStoreState<T>["values"];

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

@@ -13,10 +13,13 @@ export interface MenuStoreState<T extends MenuStoreValues = MenuStoreValues> ext
      */
     initialFocus: "container" | "first" | "last";
     /**
-     * A map of names and values that will be used by the `MenuItemCheckbox` and
-     * `MenuItemRadio` components.
+     * A map of names and values that will be used by the
+     * [`MenuItemCheckbox`](https://ariakit.org/reference/menu-item-checkbox) and
+     * [`MenuItemRadio`](https://ariakit.org/reference/menu-item-radio)
+     * components.
      *
      * Live examples:
+     * - [MenuItemCheckbox](https://ariakit.org/examples/menu-item-checkbox)
      * - [Submenu with
      *   Combobox](https://ariakit.org/examples/menu-nested-combobox)
      */
@@ -42,7 +45,8 @@ export interface MenuStoreFunctions<T extends MenuStoreValues = MenuStoreValues>
      */
     setInitialFocus: SetState<MenuStoreState<T>["initialFocus"]>;
     /**
-     * Sets the `values` state.
+     * Sets the [`values`](https://ariakit.org/reference/menu-provider#values)
+     * state.
      * @example
      * store.setValues({ watching: ["issues"] });
      * store.setValues((values) => ({ ...values, watching: ["issues"] }));
@@ -68,16 +72,21 @@ export interface MenuStoreOptions<T extends MenuStoreValues = MenuStoreValues> e
      */
     combobox?: ComboboxStore | null;
     /**
-     * A reference to a parent menu store. This should be used on nested menus.
+     * A reference to a parent menu store. This is used on nested menus.
      */
     parent?: MenuStore | null;
     /**
-     * A reference to a menu bar store. This should be used when rendering menus
-     * inside a menu bar.
+     * A reference to a menubar store. This is used when rendering menus inside a
+     * menubar.
      */
     menubar?: MenuBarStore | null;
     /**
-     * The default values for the `values` state.
+     * The default values for the
+     * [`values`](https://ariakit.org/reference/menu-provider#values) state.
+     *
+     * Live examples:
+     * - [MenuItemCheckbox](https://ariakit.org/examples/menu-item-checkbox)
+     * - [MenuItemRadio](https://ariakit.org/examples/menu-item-radio)
      * @default {}
      */
     defaultValues?: MenuStoreState<T>["values"];

package/cjs/menubar/menubar-store.cjs

@@ -1,14 +1,14 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});"use client";
 
 
-var _UTICNXSTcjs = require('../__chunks/UTICNXST.cjs');
-require('../__chunks/JNFZSNOI.cjs');
-require('../__chunks/UCLKUBNP.cjs');
-require('../__chunks/2UK5WUJX.cjs');
-require('../__chunks/3UT5FE6K.cjs');
+var _NOFH2BLBcjs = require('../__chunks/NOFH2BLB.cjs');
+require('../__chunks/BFE5R4EZ.cjs');
+require('../__chunks/MI6NUQYQ.cjs');
+require('../__chunks/F6HPKLO2.cjs');
+require('../__chunks/KBNYGXWI.cjs');
 require('../__chunks/5F4DVUNS.cjs');
 require('../__chunks/ULSPM3Y3.cjs');
 require('../__chunks/AV6KTKLE.cjs');
 
 
-exports.createMenubarStore = _UTICNXSTcjs.createMenubarStore;
+exports.createMenubarStore = _NOFH2BLBcjs.createMenubarStore;

package/cjs/popover/popover-store.cjs

@@ -1,12 +1,12 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});"use client";
 
 
-var _EFIT5L4Xcjs = require('../__chunks/EFIT5L4X.cjs');
-require('../__chunks/2LS4JJ4S.cjs');
-require('../__chunks/GJFZ5ZPP.cjs');
-require('../__chunks/2UK5WUJX.cjs');
-require('../__chunks/3UT5FE6K.cjs');
+var _E53JW5BDcjs = require('../__chunks/E53JW5BD.cjs');
+require('../__chunks/I3Y4EXEF.cjs');
+require('../__chunks/OTVLDMN2.cjs');
+require('../__chunks/F6HPKLO2.cjs');
+require('../__chunks/KBNYGXWI.cjs');
 require('../__chunks/AV6KTKLE.cjs');
 
 
-exports.createPopoverStore = _EFIT5L4Xcjs.createPopoverStore;
+exports.createPopoverStore = _E53JW5BDcjs.createPopoverStore;