@ariakit/core 0.3.6 → 0.3.8

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

@@ -2,18 +2,28 @@ import type { CollectionStoreFunctions, CollectionStoreItem, CollectionStoreOpti
 import type { Store, StoreOptions, StoreProps } from "../utils/store.js";
 import type { SetState } from "../utils/types.js";
 type Orientation = "horizontal" | "vertical" | "both";
-type Item = CollectionStoreItem & {
-    rowId?: string;
-    disabled?: boolean;
-    children?: string;
-};
 /**
  * Creates a composite store.
  */
-export declare function createCompositeStore<T extends Item = Item>(props?: CompositeStoreProps<T>): CompositeStore<T>;
+export declare function createCompositeStore<T extends CompositeStoreItem = CompositeStoreItem>(props?: CompositeStoreProps<T>): CompositeStore<T>;
 export type CompositeStoreOrientation = Orientation;
-export type CompositeStoreItem = Item;
-export interface CompositeStoreState<T extends Item = Item> extends CollectionStoreState<T> {
+export interface CompositeStoreItem extends CollectionStoreItem {
+    /**
+     * The row id of the item. This is only used on two-dimensional composites
+     * (when using `CompositeRow`).
+     */
+    rowId?: string;
+    /**
+     * If enabled, the item will be disabled and users won't be able to focus it
+     * using arrow keys.
+     */
+    disabled?: boolean;
+    /**
+     * The item children. This can be used for typeahead purposes.
+     */
+    children?: string;
+}
+export interface CompositeStoreState<T extends CompositeStoreItem = CompositeStoreItem> extends CollectionStoreState<T> {
     /**
      * The composite element.
      */
@@ -25,10 +35,6 @@ export interface CompositeStoreState<T extends Item = Item> extends CollectionSt
      * tabindex](https://www.w3.org/WAI/ARIA/apg/practices/keyboard-interface/#kbd_roving_tabindex).
      * DOM focus will remain on the composite element while its items receive
      * virtual focus.
-     *
-     * Live examples:
-     * - [Multi-selectable
-     *   Combobox](https://ariakit.org/examples/combobox-multiple)
      * @default false
      */
     virtualFocus: boolean;
@@ -121,7 +127,7 @@ export interface CompositeStoreState<T extends Item = Item> extends CollectionSt
      */
     activeId: string | null | undefined;
 }
-export interface CompositeStoreFunctions<T extends Item = Item> extends CollectionStoreFunctions<T> {
+export interface CompositeStoreFunctions<T extends CompositeStoreItem = CompositeStoreItem> extends CollectionStoreFunctions<T> {
     /**
      * Sets the `baseElement`.
      */
@@ -192,7 +198,7 @@ export interface CompositeStoreFunctions<T extends Item = Item> extends Collecti
      */
     last: () => string | null | undefined;
 }
-export interface CompositeStoreOptions<T extends Item = Item> extends StoreOptions<CompositeStoreState<T>, "virtualFocus" | "orientation" | "rtl" | "focusLoop" | "focusWrap" | "focusShift" | "includesBaseElement" | "activeId">, CollectionStoreOptions<T> {
+export interface CompositeStoreOptions<T extends CompositeStoreItem = CompositeStoreItem> extends CollectionStoreOptions<T>, StoreOptions<CompositeStoreState<T>, "virtualFocus" | "orientation" | "rtl" | "focusLoop" | "focusWrap" | "focusShift" | "includesBaseElement" | "activeId"> {
     /**
      * The composite item id that should be active by default when the composite
      * widget is rendered. If `null`, the composite element itself will have focus
@@ -201,6 +207,8 @@ export interface CompositeStoreOptions<T extends Item = Item> extends StoreOptio
      */
     defaultActiveId?: CompositeStoreState<T>["activeId"];
 }
-export type CompositeStoreProps<T extends Item = Item> = CompositeStoreOptions<T> & StoreProps<CompositeStoreState<T>>;
-export type CompositeStore<T extends Item = Item> = CompositeStoreFunctions<T> & Store<CompositeStoreState<T>>;
+export interface CompositeStoreProps<T extends CompositeStoreItem = CompositeStoreItem> extends CompositeStoreOptions<T>, StoreProps<CompositeStoreState<T>> {
+}
+export interface CompositeStore<T extends CompositeStoreItem = CompositeStoreItem> extends CompositeStoreFunctions<T>, Store<CompositeStoreState<T>> {
+}
 export {};

package/cjs/dialog/dialog-store.cjs

@@ -1,11 +1,11 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});"use client";
 
 
-var _GZDVJEIDcjs = require('../__chunks/GZDVJEID.cjs');
-require('../__chunks/MEHGRTJ3.cjs');
-require('../__chunks/46BH65MC.cjs');
+var _2LS4JJ4Scjs = require('../__chunks/2LS4JJ4S.cjs');
+require('../__chunks/GJFZ5ZPP.cjs');
+require('../__chunks/2UK5WUJX.cjs');
 require('../__chunks/3UT5FE6K.cjs');
 require('../__chunks/AV6KTKLE.cjs');
 
 
-exports.createDialogStore = _GZDVJEIDcjs.createDialogStore;
+exports.createDialogStore = _2LS4JJ4Scjs.createDialogStore;

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

@@ -1,10 +1,16 @@
-import type { DisclosureStore, DisclosureStoreFunctions, DisclosureStoreOptions, DisclosureStoreProps, DisclosureStoreState } from "../disclosure/disclosure-store.js";
+import type { DisclosureStoreFunctions, DisclosureStoreOptions, DisclosureStoreState } from "../disclosure/disclosure-store.js";
+import type { Store, StoreProps } from "../utils/store.js";
 /**
  * Creates a dialog store.
  */
 export declare function createDialogStore(props?: DialogStoreProps): DialogStore;
-export type DialogStoreState = DisclosureStoreState;
-export type DialogStoreFunctions = DisclosureStoreFunctions;
-export type DialogStoreOptions = DisclosureStoreOptions;
-export type DialogStoreProps = DisclosureStoreProps;
-export type DialogStore = DisclosureStore;
+export interface DialogStoreState extends DisclosureStoreState {
+}
+export interface DialogStoreFunctions extends DisclosureStoreFunctions {
+}
+export interface DialogStoreOptions extends DisclosureStoreOptions {
+}
+export interface DialogStoreProps extends DialogStoreOptions, StoreProps<DialogStoreState> {
+}
+export interface DialogStore extends DialogStoreFunctions, Store<DialogStoreState> {
+}

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

@@ -1,10 +1,16 @@
-import type { DisclosureStore, DisclosureStoreFunctions, DisclosureStoreOptions, DisclosureStoreProps, DisclosureStoreState } from "../disclosure/disclosure-store.js";
+import type { DisclosureStoreFunctions, DisclosureStoreOptions, DisclosureStoreState } from "../disclosure/disclosure-store.js";
+import type { Store, StoreProps } from "../utils/store.js";
 /**
  * Creates a dialog store.
  */
 export declare function createDialogStore(props?: DialogStoreProps): DialogStore;
-export type DialogStoreState = DisclosureStoreState;
-export type DialogStoreFunctions = DisclosureStoreFunctions;
-export type DialogStoreOptions = DisclosureStoreOptions;
-export type DialogStoreProps = DisclosureStoreProps;
-export type DialogStore = DisclosureStore;
+export interface DialogStoreState extends DisclosureStoreState {
+}
+export interface DialogStoreFunctions extends DisclosureStoreFunctions {
+}
+export interface DialogStoreOptions extends DisclosureStoreOptions {
+}
+export interface DialogStoreProps extends DialogStoreOptions, StoreProps<DialogStoreState> {
+}
+export interface DialogStore extends DialogStoreFunctions, Store<DialogStoreState> {
+}

package/cjs/disclosure/disclosure-store.cjs

@@ -1,10 +1,10 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});"use client";
 
 
-var _MEHGRTJ3cjs = require('../__chunks/MEHGRTJ3.cjs');
-require('../__chunks/46BH65MC.cjs');
+var _GJFZ5ZPPcjs = require('../__chunks/GJFZ5ZPP.cjs');
+require('../__chunks/2UK5WUJX.cjs');
 require('../__chunks/3UT5FE6K.cjs');
 require('../__chunks/AV6KTKLE.cjs');
 
 
-exports.createDisclosureStore = _MEHGRTJ3cjs.createDisclosureStore;
+exports.createDisclosureStore = _GJFZ5ZPPcjs.createDisclosureStore;

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

@@ -36,6 +36,7 @@ export interface DisclosureStoreState {
      *   milliseconds to pass before becoming `false`.
      *
      * Live examples:
+     * - [Navigation Menubar](https://ariakit.org/examples/menubar-navigation)
      * - [Animated Combobox](https://ariakit.org/examples/combobox-animated)
      * - [Animated Dialog](https://ariakit.org/examples/dialog-animated)
      * - [Animated Select](https://ariakit.org/examples/select-animated)
@@ -73,6 +74,7 @@ export interface DisclosureStoreFunctions {
      * Sets the `open` state to `true`.
      *
      * Live examples:
+     * - [Navigation Menubar](https://ariakit.org/examples/menubar-navigation)
      * - [Textarea with inline
      *   Combobox](https://ariakit.org/examples/combobox-textarea)
      */
@@ -121,5 +123,7 @@ export interface DisclosureStoreOptions extends StoreOptions<DisclosureStoreStat
      */
     disclosure?: DisclosureStore | null;
 }
-export type DisclosureStoreProps = DisclosureStoreOptions & StoreProps<DisclosureStoreState>;
-export type DisclosureStore = DisclosureStoreFunctions & Store<DisclosureStoreState>;
+export interface DisclosureStoreProps extends DisclosureStoreOptions, StoreProps<DisclosureStoreState> {
+}
+export interface DisclosureStore extends DisclosureStoreFunctions, Store<DisclosureStoreState> {
+}

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

@@ -36,6 +36,7 @@ export interface DisclosureStoreState {
      *   milliseconds to pass before becoming `false`.
      *
      * Live examples:
+     * - [Navigation Menubar](https://ariakit.org/examples/menubar-navigation)
      * - [Animated Combobox](https://ariakit.org/examples/combobox-animated)
      * - [Animated Dialog](https://ariakit.org/examples/dialog-animated)
      * - [Animated Select](https://ariakit.org/examples/select-animated)
@@ -73,6 +74,7 @@ export interface DisclosureStoreFunctions {
      * Sets the `open` state to `true`.
      *
      * Live examples:
+     * - [Navigation Menubar](https://ariakit.org/examples/menubar-navigation)
      * - [Textarea with inline
      *   Combobox](https://ariakit.org/examples/combobox-textarea)
      */
@@ -121,5 +123,7 @@ export interface DisclosureStoreOptions extends StoreOptions<DisclosureStoreStat
      */
     disclosure?: DisclosureStore | null;
 }
-export type DisclosureStoreProps = DisclosureStoreOptions & StoreProps<DisclosureStoreState>;
-export type DisclosureStore = DisclosureStoreFunctions & Store<DisclosureStoreState>;
+export interface DisclosureStoreProps extends DisclosureStoreOptions, StoreProps<DisclosureStoreState> {
+}
+export interface DisclosureStore extends DisclosureStoreFunctions, Store<DisclosureStoreState> {
+}

package/cjs/form/form-store.cjs

@@ -1,13 +1,13 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});"use client";
 
 
-var _JLC5A6WFcjs = require('../__chunks/JLC5A6WF.cjs');
+var _ZQTYFYRScjs = require('../__chunks/ZQTYFYRS.cjs');
 
 
 
 
 
-var _46BH65MCcjs = require('../__chunks/46BH65MC.cjs');
+var _2UK5WUJXcjs = require('../__chunks/2UK5WUJX.cjs');
 
 
 
@@ -114,9 +114,9 @@ function createNames() {
 }
 function createFormStore(props = {}) {
   var _a;
-  _46BH65MCcjs.throwOnConflictingProps.call(void 0, props, props.store);
+  _2UK5WUJXcjs.throwOnConflictingProps.call(void 0, props, props.store);
   const syncState = (_a = props.store) == null ? void 0 : _a.getState();
-  const collection = _JLC5A6WFcjs.createCollectionStore.call(void 0, props);
+  const collection = _ZQTYFYRScjs.createCollectionStore.call(void 0, props);
   const values = _3UT5FE6Kcjs.defaultValue.call(void 0, 
     props.values,
     syncState == null ? void 0 : syncState.values,
@@ -145,15 +145,15 @@ function createFormStore(props = {}) {
     submitFailed: _3UT5FE6Kcjs.defaultValue.call(void 0, syncState == null ? void 0 : syncState.submitFailed, 0),
     valid: !hasMessages(errors)
   });
-  const form = _46BH65MCcjs.createStore.call(void 0, initialState, collection, props.store);
+  const form = _2UK5WUJXcjs.createStore.call(void 0, initialState, collection, props.store);
   const syncCallbacks = getStoreCallbacks(props.store);
   const syncCallbacksState = syncCallbacks == null ? void 0 : syncCallbacks.getState();
   const callbacksInitialState = {
     validate: (syncCallbacksState == null ? void 0 : syncCallbacksState.validate) || [],
     submit: (syncCallbacksState == null ? void 0 : syncCallbacksState.submit) || []
   };
-  const callbacks = _46BH65MCcjs.createStore.call(void 0, callbacksInitialState, syncCallbacks);
-  _46BH65MCcjs.setup.call(void 0, form, () => _46BH65MCcjs.init.call(void 0, callbacks));
+  const callbacks = _2UK5WUJXcjs.createStore.call(void 0, callbacksInitialState, syncCallbacks);
+  _2UK5WUJXcjs.setup.call(void 0, form, () => _2UK5WUJXcjs.init.call(void 0, callbacks));
   const validate = async () => {
     form.setState("validating", true);
     form.setState("errors", {});

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

@@ -2,23 +2,21 @@ import type { CollectionStoreFunctions, CollectionStoreItem, CollectionStoreOpti
 import type { Store, StoreOptions, StoreProps } from "../utils/store.js";
 import type { AnyObject, PickRequired, SetState, SetStateAction } from "../utils/types.js";
 import type { DeepMap, DeepPartial, Names, StringLike } from "./types.js";
-type Values = AnyObject;
 type ErrorMessage = string | undefined | null;
-type Item = CollectionStoreItem & {
-    type: "field" | "label" | "description" | "error" | "button";
-    name: string;
-};
-export declare function hasMessages(object: Values): boolean;
-export declare function get<T>(values: Values, path: StringLike | string[], defaultValue?: T): T;
+export declare function hasMessages(object: FormStoreValues): boolean;
+export declare function get<T>(values: FormStoreValues, path: StringLike | string[], defaultValue?: T): T;
 /**
  * Creates a form store.
  */
-export declare function createFormStore<T extends Values = Values>(props: PickRequired<FormStoreProps<T>, "values" | "defaultValues" | "errors" | "defaultErrors" | "touched" | "defaultTouched">): FormStore<T>;
+export declare function createFormStore<T extends FormStoreValues = FormStoreValues>(props: PickRequired<FormStoreProps<T>, "values" | "defaultValues" | "errors" | "defaultErrors" | "touched" | "defaultTouched">): FormStore<T>;
 export declare function createFormStore(props: FormStoreProps): FormStore;
 export type FormStoreCallback<T extends FormStoreState = FormStoreState> = (state: T) => void | Promise<void>;
-export type FormStoreValues = Values;
-export type FormStoreItem = Item;
-export interface FormStoreState<T extends Values = Values> extends CollectionStoreState<Item> {
+export type FormStoreValues = AnyObject;
+export interface FormStoreItem extends CollectionStoreItem {
+    type: "field" | "label" | "description" | "error" | "button";
+    name: string;
+}
+export interface FormStoreState<T extends FormStoreValues = FormStoreValues> extends CollectionStoreState<FormStoreItem> {
     /**
      * Form values.
      * @default {}
@@ -54,7 +52,7 @@ export interface FormStoreState<T extends Values = Values> extends CollectionSto
      */
     submitFailed: number;
 }
-export interface FormStoreFunctions<T extends Values = Values> extends CollectionStoreFunctions<Item> {
+export interface FormStoreFunctions<T extends FormStoreValues = FormStoreValues> extends CollectionStoreFunctions<FormStoreItem> {
     /**
      * An object containing the names of the form fields for type-safety.
      * @example
@@ -216,7 +214,7 @@ export interface FormStoreFunctions<T extends Values = Values> extends Collectio
      */
     reset: () => void;
 }
-export interface FormStoreOptions<T extends Values = Values> extends StoreOptions<FormStoreState<T>, "values" | "errors" | "touched">, CollectionStoreOptions<Item> {
+export interface FormStoreOptions<T extends FormStoreValues = FormStoreValues> extends CollectionStoreOptions<FormStoreItem>, StoreOptions<FormStoreState<T>, "values" | "errors" | "touched"> {
     /**
      * The default values of the form.
      * @default {}
@@ -231,6 +229,8 @@ export interface FormStoreOptions<T extends Values = Values> extends StoreOption
      */
     defaultTouched?: FormStoreState<T>["touched"];
 }
-export type FormStoreProps<T extends Values = Values> = FormStoreOptions<T> & StoreProps<FormStoreState<T>>;
-export type FormStore<T extends Values = Values> = FormStoreFunctions<T> & Store<FormStoreState<T>>;
+export interface FormStoreProps<T extends FormStoreValues = FormStoreValues> extends FormStoreOptions<T>, StoreProps<FormStoreState<T>> {
+}
+export interface FormStore<T extends FormStoreValues = FormStoreValues> extends FormStoreFunctions<T>, Store<FormStoreState<T>> {
+}
 export {};

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

@@ -2,23 +2,21 @@ import type { CollectionStoreFunctions, CollectionStoreItem, CollectionStoreOpti
 import type { Store, StoreOptions, StoreProps } from "../utils/store.js";
 import type { AnyObject, PickRequired, SetState, SetStateAction } from "../utils/types.js";
 import type { DeepMap, DeepPartial, Names, StringLike } from "./types.js";
-type Values = AnyObject;
 type ErrorMessage = string | undefined | null;
-type Item = CollectionStoreItem & {
-    type: "field" | "label" | "description" | "error" | "button";
-    name: string;
-};
-export declare function hasMessages(object: Values): boolean;
-export declare function get<T>(values: Values, path: StringLike | string[], defaultValue?: T): T;
+export declare function hasMessages(object: FormStoreValues): boolean;
+export declare function get<T>(values: FormStoreValues, path: StringLike | string[], defaultValue?: T): T;
 /**
  * Creates a form store.
  */
-export declare function createFormStore<T extends Values = Values>(props: PickRequired<FormStoreProps<T>, "values" | "defaultValues" | "errors" | "defaultErrors" | "touched" | "defaultTouched">): FormStore<T>;
+export declare function createFormStore<T extends FormStoreValues = FormStoreValues>(props: PickRequired<FormStoreProps<T>, "values" | "defaultValues" | "errors" | "defaultErrors" | "touched" | "defaultTouched">): FormStore<T>;
 export declare function createFormStore(props: FormStoreProps): FormStore;
 export type FormStoreCallback<T extends FormStoreState = FormStoreState> = (state: T) => void | Promise<void>;
-export type FormStoreValues = Values;
-export type FormStoreItem = Item;
-export interface FormStoreState<T extends Values = Values> extends CollectionStoreState<Item> {
+export type FormStoreValues = AnyObject;
+export interface FormStoreItem extends CollectionStoreItem {
+    type: "field" | "label" | "description" | "error" | "button";
+    name: string;
+}
+export interface FormStoreState<T extends FormStoreValues = FormStoreValues> extends CollectionStoreState<FormStoreItem> {
     /**
      * Form values.
      * @default {}
@@ -54,7 +52,7 @@ export interface FormStoreState<T extends Values = Values> extends CollectionSto
      */
     submitFailed: number;
 }
-export interface FormStoreFunctions<T extends Values = Values> extends CollectionStoreFunctions<Item> {
+export interface FormStoreFunctions<T extends FormStoreValues = FormStoreValues> extends CollectionStoreFunctions<FormStoreItem> {
     /**
      * An object containing the names of the form fields for type-safety.
      * @example
@@ -216,7 +214,7 @@ export interface FormStoreFunctions<T extends Values = Values> extends Collectio
      */
     reset: () => void;
 }
-export interface FormStoreOptions<T extends Values = Values> extends StoreOptions<FormStoreState<T>, "values" | "errors" | "touched">, CollectionStoreOptions<Item> {
+export interface FormStoreOptions<T extends FormStoreValues = FormStoreValues> extends CollectionStoreOptions<FormStoreItem>, StoreOptions<FormStoreState<T>, "values" | "errors" | "touched"> {
     /**
      * The default values of the form.
      * @default {}
@@ -231,6 +229,8 @@ export interface FormStoreOptions<T extends Values = Values> extends StoreOption
      */
     defaultTouched?: FormStoreState<T>["touched"];
 }
-export type FormStoreProps<T extends Values = Values> = FormStoreOptions<T> & StoreProps<FormStoreState<T>>;
-export type FormStore<T extends Values = Values> = FormStoreFunctions<T> & Store<FormStoreState<T>>;
+export interface FormStoreProps<T extends FormStoreValues = FormStoreValues> extends FormStoreOptions<T>, StoreProps<FormStoreState<T>> {
+}
+export interface FormStore<T extends FormStoreValues = FormStoreValues> extends FormStoreFunctions<T>, Store<FormStoreState<T>> {
+}
 export {};

package/cjs/hovercard/hovercard-store.cjs

@@ -1,13 +1,13 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});"use client";
 
 
-var _PD7XZBXCcjs = require('../__chunks/PD7XZBXC.cjs');
-require('../__chunks/7ZUFMSXJ.cjs');
-require('../__chunks/GZDVJEID.cjs');
-require('../__chunks/MEHGRTJ3.cjs');
-require('../__chunks/46BH65MC.cjs');
+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');
 require('../__chunks/AV6KTKLE.cjs');
 
 
-exports.createHovercardStore = _PD7XZBXCcjs.createHovercardStore;
+exports.createHovercardStore = _5SIVMOIDcjs.createHovercardStore;

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

@@ -20,11 +20,17 @@ export interface HovercardStoreState extends PopoverStoreState {
     /**
      * The amount of time in milliseconds to wait before **showing** the popover.
      * It defaults to the value passed to `timeout`.
+     *
+     * Live examples:
+     * - [Navigation Menubar](https://ariakit.org/examples/menubar-navigation)
      */
     showTimeout?: number;
     /**
      * The amount of time in milliseconds to wait before **hiding** the popover.
      * It defaults to the value passed to `timeout`.
+     *
+     * Live examples:
+     * - [Navigation Menubar](https://ariakit.org/examples/menubar-navigation)
      */
     hideTimeout?: number;
     /**
@@ -40,7 +46,9 @@ export interface HovercardStoreFunctions extends PopoverStoreFunctions {
      */
     setAutoFocusOnShow: SetState<HovercardStoreState["autoFocusOnShow"]>;
 }
-export interface HovercardStoreOptions extends StoreOptions<HovercardStoreState, "placement" | "timeout" | "showTimeout" | "hideTimeout">, PopoverStoreOptions {
+export interface HovercardStoreOptions extends PopoverStoreOptions, StoreOptions<HovercardStoreState, "placement" | "timeout" | "showTimeout" | "hideTimeout"> {
+}
+export interface HovercardStoreProps extends HovercardStoreOptions, StoreProps<HovercardStoreState> {
+}
+export interface HovercardStore extends HovercardStoreFunctions, Store<HovercardStoreState> {
 }
-export type HovercardStoreProps = HovercardStoreOptions & StoreProps<HovercardStoreState>;
-export type HovercardStore = HovercardStoreFunctions & Store<HovercardStoreState>;

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

@@ -20,11 +20,17 @@ export interface HovercardStoreState extends PopoverStoreState {
     /**
      * The amount of time in milliseconds to wait before **showing** the popover.
      * It defaults to the value passed to `timeout`.
+     *
+     * Live examples:
+     * - [Navigation Menubar](https://ariakit.org/examples/menubar-navigation)
      */
     showTimeout?: number;
     /**
      * The amount of time in milliseconds to wait before **hiding** the popover.
      * It defaults to the value passed to `timeout`.
+     *
+     * Live examples:
+     * - [Navigation Menubar](https://ariakit.org/examples/menubar-navigation)
      */
     hideTimeout?: number;
     /**
@@ -40,7 +46,9 @@ export interface HovercardStoreFunctions extends PopoverStoreFunctions {
      */
     setAutoFocusOnShow: SetState<HovercardStoreState["autoFocusOnShow"]>;
 }
-export interface HovercardStoreOptions extends StoreOptions<HovercardStoreState, "placement" | "timeout" | "showTimeout" | "hideTimeout">, PopoverStoreOptions {
+export interface HovercardStoreOptions extends PopoverStoreOptions, StoreOptions<HovercardStoreState, "placement" | "timeout" | "showTimeout" | "hideTimeout"> {
+}
+export interface HovercardStoreProps extends HovercardStoreOptions, StoreProps<HovercardStoreState> {
+}
+export interface HovercardStore extends HovercardStoreFunctions, Store<HovercardStoreState> {
 }
-export type HovercardStoreProps = HovercardStoreOptions & StoreProps<HovercardStoreState>;
-export type HovercardStore = HovercardStoreFunctions & Store<HovercardStoreState>;

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

@@ -1,10 +1,10 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});"use client";
 
 
-var _GXIZMD53cjs = require('../__chunks/GXIZMD53.cjs');
-require('../__chunks/6WBY3ZZM.cjs');
-require('../__chunks/JLC5A6WF.cjs');
-require('../__chunks/46BH65MC.cjs');
+var _3J44Z7YHcjs = require('../__chunks/3J44Z7YH.cjs');
+require('../__chunks/QAZ4PF7S.cjs');
+require('../__chunks/ZQTYFYRS.cjs');
+require('../__chunks/2UK5WUJX.cjs');
 require('../__chunks/3UT5FE6K.cjs');
 require('../__chunks/5F4DVUNS.cjs');
 require('../__chunks/ULSPM3Y3.cjs');
@@ -12,7 +12,7 @@ require('../__chunks/AV6KTKLE.cjs');
 
 // src/menu/menu-bar-store.ts
 function createMenuBarStore(props = {}) {
-  return _GXIZMD53cjs.createMenubarStore.call(void 0, props);
+  return _3J44Z7YHcjs.createMenubarStore.call(void 0, props);
 }
 
 

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

@@ -1,10 +1,16 @@
-import type { MenubarStore, MenubarStoreFunctions, MenubarStoreOptions, MenubarStoreProps, MenubarStoreState } from "../menubar/menubar-store.js";
+import type { MenubarStoreFunctions, MenubarStoreOptions, MenubarStoreState } from "../menubar/menubar-store.js";
+import type { Store, StoreProps } from "../utils/store.js";
 /**
  * Creates a menu bar store.
  */
 export declare function createMenuBarStore(props?: MenuBarStoreProps): MenuBarStore;
-export type MenuBarStoreState = MenubarStoreState;
-export type MenuBarStoreFunctions = MenubarStoreFunctions;
-export type MenuBarStoreOptions = MenubarStoreOptions;
-export type MenuBarStoreProps = MenubarStoreProps;
-export type MenuBarStore = MenubarStore;
+export interface MenuBarStoreState extends MenubarStoreState {
+}
+export interface MenuBarStoreFunctions extends MenubarStoreFunctions {
+}
+export interface MenuBarStoreOptions extends MenubarStoreOptions {
+}
+export interface MenuBarStoreProps extends MenuBarStoreOptions, StoreProps<MenuBarStoreState> {
+}
+export interface MenuBarStore extends MenuBarStoreFunctions, Store<MenuBarStoreState> {
+}

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

@@ -1,10 +1,16 @@
-import type { MenubarStore, MenubarStoreFunctions, MenubarStoreOptions, MenubarStoreProps, MenubarStoreState } from "../menubar/menubar-store.js";
+import type { MenubarStoreFunctions, MenubarStoreOptions, MenubarStoreState } from "../menubar/menubar-store.js";
+import type { Store, StoreProps } from "../utils/store.js";
 /**
  * Creates a menu bar store.
  */
 export declare function createMenuBarStore(props?: MenuBarStoreProps): MenuBarStore;
-export type MenuBarStoreState = MenubarStoreState;
-export type MenuBarStoreFunctions = MenubarStoreFunctions;
-export type MenuBarStoreOptions = MenubarStoreOptions;
-export type MenuBarStoreProps = MenubarStoreProps;
-export type MenuBarStore = MenubarStore;
+export interface MenuBarStoreState extends MenubarStoreState {
+}
+export interface MenuBarStoreFunctions extends MenubarStoreFunctions {
+}
+export interface MenuBarStoreOptions extends MenubarStoreOptions {
+}
+export interface MenuBarStoreProps extends MenuBarStoreOptions, StoreProps<MenuBarStoreState> {
+}
+export interface MenuBarStore extends MenuBarStoreFunctions, Store<MenuBarStoreState> {
+}

package/cjs/menu/menu-store.cjs

@@ -1,14 +1,14 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});"use client";
 
 
-var _PD7XZBXCcjs = require('../__chunks/PD7XZBXC.cjs');
-require('../__chunks/7ZUFMSXJ.cjs');
-require('../__chunks/GZDVJEID.cjs');
-require('../__chunks/MEHGRTJ3.cjs');
+var _5SIVMOIDcjs = require('../__chunks/5SIVMOID.cjs');
+require('../__chunks/EFIT5L4X.cjs');
+require('../__chunks/2LS4JJ4S.cjs');
+require('../__chunks/GJFZ5ZPP.cjs');
 
 
-var _6WBY3ZZMcjs = require('../__chunks/6WBY3ZZM.cjs');
-require('../__chunks/JLC5A6WF.cjs');
+var _QAZ4PF7Scjs = require('../__chunks/QAZ4PF7S.cjs');
+require('../__chunks/ZQTYFYRS.cjs');
 
 
 
@@ -17,7 +17,7 @@ require('../__chunks/JLC5A6WF.cjs');
 
 
 
-var _46BH65MCcjs = require('../__chunks/46BH65MC.cjs');
+var _2UK5WUJXcjs = require('../__chunks/2UK5WUJX.cjs');
 
 
 
@@ -42,10 +42,10 @@ function createMenuStore(_a = {}) {
     "menubar"
   ]);
   const parentIsMenubar = !!menubar && !parent;
-  const store = _46BH65MCcjs.mergeStore.call(void 0, 
+  const store = _2UK5WUJXcjs.mergeStore.call(void 0, 
     props.store,
-    _46BH65MCcjs.pick.call(void 0, parent, ["values"]),
-    _46BH65MCcjs.omit.call(void 0, combobox, [
+    _2UK5WUJXcjs.pick.call(void 0, parent, ["values"]),
+    _2UK5WUJXcjs.omit.call(void 0, combobox, [
       "arrowElement",
       "anchorElement",
       "contentElement",
@@ -53,9 +53,9 @@ function createMenuStore(_a = {}) {
       "disclosureElement"
     ])
   );
-  _46BH65MCcjs.throwOnConflictingProps.call(void 0, props, store);
+  _2UK5WUJXcjs.throwOnConflictingProps.call(void 0, props, store);
   const syncState = store.getState();
-  const composite = _6WBY3ZZMcjs.createCompositeStore.call(void 0, _AV6KTKLEcjs.__spreadProps.call(void 0, _AV6KTKLEcjs.__spreadValues.call(void 0, {}, props), {
+  const composite = _QAZ4PF7Scjs.createCompositeStore.call(void 0, _AV6KTKLEcjs.__spreadProps.call(void 0, _AV6KTKLEcjs.__spreadValues.call(void 0, {}, props), {
     store,
     orientation: _3UT5FE6Kcjs.defaultValue.call(void 0, 
       props.orientation,
@@ -63,7 +63,7 @@ function createMenuStore(_a = {}) {
       "vertical"
     )
   }));
-  const hovercard = _PD7XZBXCcjs.createHovercardStore.call(void 0, _AV6KTKLEcjs.__spreadProps.call(void 0, _AV6KTKLEcjs.__spreadValues.call(void 0, {}, props), {
+  const hovercard = _5SIVMOIDcjs.createHovercardStore.call(void 0, _AV6KTKLEcjs.__spreadProps.call(void 0, _AV6KTKLEcjs.__spreadValues.call(void 0, {}, props), {
     store,
     placement: _3UT5FE6Kcjs.defaultValue.call(void 0, 
       props.placement,
@@ -86,18 +86,18 @@ function createMenuStore(_a = {}) {
       {}
     )
   });
-  const menu = _46BH65MCcjs.createStore.call(void 0, initialState, composite, hovercard, store);
-  _46BH65MCcjs.setup.call(void 0, 
+  const menu = _2UK5WUJXcjs.createStore.call(void 0, initialState, composite, hovercard, store);
+  _2UK5WUJXcjs.setup.call(void 0, 
     menu,
-    () => _46BH65MCcjs.sync.call(void 0, menu, ["mounted"], (state) => {
+    () => _2UK5WUJXcjs.sync.call(void 0, menu, ["mounted"], (state) => {
       if (state.mounted)
         return;
       menu.setState("activeId", null);
     })
   );
-  _46BH65MCcjs.setup.call(void 0, 
+  _2UK5WUJXcjs.setup.call(void 0, 
     menu,
-    () => _46BH65MCcjs.sync.call(void 0, parent, ["orientation"], (state) => {
+    () => _2UK5WUJXcjs.sync.call(void 0, parent, ["orientation"], (state) => {
       menu.setState(
         "placement",
         state.orientation === "vertical" ? "right-start" : "bottom-start"