@ariakit/core 0.3.7 → 0.3.9

package/cjs/combobox/combobox-store.cjs

@@ -1,20 +1,20 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});"use client";
 
 
-var _7ZUFMSXJcjs = require('../__chunks/7ZUFMSXJ.cjs');
-require('../__chunks/GZDVJEID.cjs');
-require('../__chunks/MEHGRTJ3.cjs');
+var _EFIT5L4Xcjs = require('../__chunks/EFIT5L4X.cjs');
+require('../__chunks/2LS4JJ4S.cjs');
+require('../__chunks/GJFZ5ZPP.cjs');
 
 
-var _6WBY3ZZMcjs = require('../__chunks/6WBY3ZZM.cjs');
-require('../__chunks/JLC5A6WF.cjs');
+var _JNFZSNOIcjs = require('../__chunks/JNFZSNOI.cjs');
+require('../__chunks/UCLKUBNP.cjs');
 
 
 
 
 
 
-var _46BH65MCcjs = require('../__chunks/46BH65MC.cjs');
+var _2UK5WUJXcjs = require('../__chunks/2UK5WUJX.cjs');
 
 
 var _3UT5FE6Kcjs = require('../__chunks/3UT5FE6K.cjs');
@@ -33,7 +33,7 @@ var _AV6KTKLEcjs = require('../__chunks/AV6KTKLE.cjs');
 var isSafariOnMobile = _YIUPKKEKcjs.isSafari.call(void 0, ) && _YIUPKKEKcjs.isTouchDevice.call(void 0, );
 function createComboboxStore(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 activeId = _3UT5FE6Kcjs.defaultValue.call(void 0, 
     props.activeId,
@@ -41,7 +41,7 @@ function createComboboxStore(props = {}) {
     props.defaultActiveId,
     null
   );
-  const composite = _6WBY3ZZMcjs.createCompositeStore.call(void 0, _AV6KTKLEcjs.__spreadProps.call(void 0, _AV6KTKLEcjs.__spreadValues.call(void 0, {}, props), {
+  const composite = _JNFZSNOIcjs.createCompositeStore.call(void 0, _AV6KTKLEcjs.__spreadProps.call(void 0, _AV6KTKLEcjs.__spreadValues.call(void 0, {}, props), {
     activeId,
     includesBaseElement: _3UT5FE6Kcjs.defaultValue.call(void 0, 
       props.includesBaseElement,
@@ -61,7 +61,7 @@ function createComboboxStore(props = {}) {
       !isSafariOnMobile
     )
   }));
-  const popover = _7ZUFMSXJcjs.createPopoverStore.call(void 0, _AV6KTKLEcjs.__spreadProps.call(void 0, _AV6KTKLEcjs.__spreadValues.call(void 0, {}, props), {
+  const popover = _EFIT5L4Xcjs.createPopoverStore.call(void 0, _AV6KTKLEcjs.__spreadProps.call(void 0, _AV6KTKLEcjs.__spreadValues.call(void 0, {}, props), {
     placement: _3UT5FE6Kcjs.defaultValue.call(void 0, 
       props.placement,
       syncState == null ? void 0 : syncState.placement,
@@ -96,10 +96,10 @@ function createComboboxStore(props = {}) {
     ),
     activeValue: syncState == null ? void 0 : syncState.activeValue
   });
-  const combobox = _46BH65MCcjs.createStore.call(void 0, initialState, composite, popover, props.store);
-  _46BH65MCcjs.setup.call(void 0, 
+  const combobox = _2UK5WUJXcjs.createStore.call(void 0, initialState, composite, popover, props.store);
+  _2UK5WUJXcjs.setup.call(void 0, 
     combobox,
-    () => _46BH65MCcjs.sync.call(void 0, combobox, ["resetValueOnHide", "mounted"], (state) => {
+    () => _2UK5WUJXcjs.sync.call(void 0, combobox, ["resetValueOnHide", "mounted"], (state) => {
       if (!state.resetValueOnHide)
         return;
       if (state.mounted)
@@ -107,34 +107,34 @@ function createComboboxStore(props = {}) {
       combobox.setState("value", value);
     })
   );
-  _46BH65MCcjs.setup.call(void 0, 
+  _2UK5WUJXcjs.setup.call(void 0, 
     combobox,
-    () => _46BH65MCcjs.sync.call(void 0, combobox, ["resetValueOnSelect", "selectedValue"], (state) => {
+    () => _2UK5WUJXcjs.sync.call(void 0, combobox, ["resetValueOnSelect", "selectedValue"], (state) => {
       if (!state.resetValueOnSelect)
         return;
       combobox.setState("value", value);
     })
   );
-  _46BH65MCcjs.setup.call(void 0, 
+  _2UK5WUJXcjs.setup.call(void 0, 
     combobox,
-    () => _46BH65MCcjs.batch.call(void 0, combobox, ["mounted"], (state) => {
+    () => _2UK5WUJXcjs.batch.call(void 0, combobox, ["mounted"], (state) => {
       if (state.mounted)
         return;
       combobox.setState("activeId", activeId);
       combobox.setState("moves", 0);
     })
   );
-  _46BH65MCcjs.setup.call(void 0, 
+  _2UK5WUJXcjs.setup.call(void 0, 
     combobox,
-    () => _46BH65MCcjs.sync.call(void 0, combobox, ["moves", "activeId"], (state, prevState) => {
+    () => _2UK5WUJXcjs.sync.call(void 0, combobox, ["moves", "activeId"], (state, prevState) => {
       if (state.moves === prevState.moves) {
         combobox.setState("activeValue", void 0);
       }
     })
   );
-  _46BH65MCcjs.setup.call(void 0, 
+  _2UK5WUJXcjs.setup.call(void 0, 
     combobox,
-    () => _46BH65MCcjs.batch.call(void 0, combobox, ["moves", "renderedItems"], (state, prev) => {
+    () => _2UK5WUJXcjs.batch.call(void 0, combobox, ["moves", "renderedItems"], (state, prev) => {
       if (state.moves === prev.moves)
         return;
       const { activeId: activeId2 } = combobox.getState();

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

@@ -2,19 +2,17 @@ import type { CompositeStoreFunctions, CompositeStoreItem, CompositeStoreOptions
 import type { PopoverStoreFunctions, PopoverStoreOptions, PopoverStoreState } from "../popover/popover-store.js";
 import type { Store, StoreOptions, StoreProps } from "../utils/store.js";
 import type { PickRequired, SetState } from "../utils/types.js";
-type Value = string | string[];
-type MutableValue<T extends Value = Value> = T extends string ? string : T;
-interface Item extends CompositeStoreItem {
-    value?: string;
-}
+type MutableValue<T extends ComboboxStoreSelectedValue = ComboboxStoreSelectedValue> = T extends string ? string : T;
 /**
  * Creates a combobox store.
  */
-export declare function createComboboxStore<T extends Value = Value>(props: PickRequired<ComboboxStoreProps<T>, "selectedValue" | "defaultSelectedValue">): ComboboxStore<T>;
+export declare function createComboboxStore<T extends ComboboxStoreSelectedValue = ComboboxStoreSelectedValue>(props: PickRequired<ComboboxStoreProps<T>, "selectedValue" | "defaultSelectedValue">): ComboboxStore<T>;
 export declare function createComboboxStore(props?: ComboboxStoreProps): ComboboxStore;
-export type ComboboxStoreItem = Item;
-export type ComboboxStoreSelectedValue = Value;
-export interface ComboboxStoreState<T extends Value = Value> extends CompositeStoreState<Item>, PopoverStoreState {
+export type ComboboxStoreSelectedValue = string | string[];
+export interface ComboboxStoreItem extends CompositeStoreItem {
+    value?: string;
+}
+export interface ComboboxStoreState<T extends ComboboxStoreSelectedValue = ComboboxStoreSelectedValue> extends CompositeStoreState<ComboboxStoreItem>, PopoverStoreState {
     /**
      * @default true
      */
@@ -61,6 +59,8 @@ export interface ComboboxStoreState<T extends Value = Value> extends CompositeSt
      *   Combobox](https://ariakit.org/examples/combobox-multiple)
      * - [Menu with Combobox](https://ariakit.org/examples/menu-combobox)
      * - [Select with Combobox](https://ariakit.org/examples/select-combobox)
+     * - [Submenu with
+     *   Combobox](https://ariakit.org/examples/menu-nested-combobox)
      */
     resetValueOnHide: boolean;
     /**
@@ -78,7 +78,7 @@ export interface ComboboxStoreState<T extends Value = Value> extends CompositeSt
      */
     resetValueOnSelect: boolean;
 }
-export interface ComboboxStoreFunctions<T extends Value = Value> extends CompositeStoreFunctions<Item>, PopoverStoreFunctions {
+export interface ComboboxStoreFunctions<T extends ComboboxStoreSelectedValue = ComboboxStoreSelectedValue> extends CompositeStoreFunctions<ComboboxStoreItem>, PopoverStoreFunctions {
     /**
      * Sets the [`value`](https://ariakit.org/reference/combobox-provider#value)
      * state.
@@ -98,11 +98,11 @@ export interface ComboboxStoreFunctions<T extends Value = Value> extends Composi
      */
     setSelectedValue: SetState<ComboboxStoreState<T>["selectedValue"]>;
 }
-export interface ComboboxStoreOptions<T extends Value = Value> extends StoreOptions<ComboboxStoreState<T>, "includesBaseElement" | "value" | "selectedValue" | "resetValueOnHide" | "resetValueOnSelect">, CompositeStoreOptions<Item>, PopoverStoreOptions {
+export interface ComboboxStoreOptions<T extends ComboboxStoreSelectedValue = ComboboxStoreSelectedValue> extends CompositeStoreOptions<ComboboxStoreItem>, PopoverStoreOptions, StoreOptions<ComboboxStoreState<T>, "includesBaseElement" | "value" | "selectedValue" | "resetValueOnHide" | "resetValueOnSelect"> {
     /**
      * @default null
      */
-    defaultActiveId?: CompositeStoreOptions<Item>["activeId"];
+    defaultActiveId?: CompositeStoreOptions<ComboboxStoreItem>["activeId"];
     /**
      * The initial value of the combobox input.
      * @default ""
@@ -118,8 +118,8 @@ export interface ComboboxStoreOptions<T extends Value = Value> extends StoreOpti
      */
     defaultSelectedValue?: ComboboxStoreState<T>["selectedValue"];
 }
-export interface ComboboxStoreProps<T extends Value = Value> extends ComboboxStoreOptions<T>, StoreProps<ComboboxStoreState<T>> {
+export interface ComboboxStoreProps<T extends ComboboxStoreSelectedValue = ComboboxStoreSelectedValue> extends ComboboxStoreOptions<T>, StoreProps<ComboboxStoreState<T>> {
 }
-export interface ComboboxStore<T extends Value = Value> extends ComboboxStoreFunctions<T>, Store<ComboboxStoreState<T>> {
+export interface ComboboxStore<T extends ComboboxStoreSelectedValue = ComboboxStoreSelectedValue> extends ComboboxStoreFunctions<T>, Store<ComboboxStoreState<T>> {
 }
 export {};

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

@@ -2,19 +2,17 @@ import type { CompositeStoreFunctions, CompositeStoreItem, CompositeStoreOptions
 import type { PopoverStoreFunctions, PopoverStoreOptions, PopoverStoreState } from "../popover/popover-store.js";
 import type { Store, StoreOptions, StoreProps } from "../utils/store.js";
 import type { PickRequired, SetState } from "../utils/types.js";
-type Value = string | string[];
-type MutableValue<T extends Value = Value> = T extends string ? string : T;
-interface Item extends CompositeStoreItem {
-    value?: string;
-}
+type MutableValue<T extends ComboboxStoreSelectedValue = ComboboxStoreSelectedValue> = T extends string ? string : T;
 /**
  * Creates a combobox store.
  */
-export declare function createComboboxStore<T extends Value = Value>(props: PickRequired<ComboboxStoreProps<T>, "selectedValue" | "defaultSelectedValue">): ComboboxStore<T>;
+export declare function createComboboxStore<T extends ComboboxStoreSelectedValue = ComboboxStoreSelectedValue>(props: PickRequired<ComboboxStoreProps<T>, "selectedValue" | "defaultSelectedValue">): ComboboxStore<T>;
 export declare function createComboboxStore(props?: ComboboxStoreProps): ComboboxStore;
-export type ComboboxStoreItem = Item;
-export type ComboboxStoreSelectedValue = Value;
-export interface ComboboxStoreState<T extends Value = Value> extends CompositeStoreState<Item>, PopoverStoreState {
+export type ComboboxStoreSelectedValue = string | string[];
+export interface ComboboxStoreItem extends CompositeStoreItem {
+    value?: string;
+}
+export interface ComboboxStoreState<T extends ComboboxStoreSelectedValue = ComboboxStoreSelectedValue> extends CompositeStoreState<ComboboxStoreItem>, PopoverStoreState {
     /**
      * @default true
      */
@@ -61,6 +59,8 @@ export interface ComboboxStoreState<T extends Value = Value> extends CompositeSt
      *   Combobox](https://ariakit.org/examples/combobox-multiple)
      * - [Menu with Combobox](https://ariakit.org/examples/menu-combobox)
      * - [Select with Combobox](https://ariakit.org/examples/select-combobox)
+     * - [Submenu with
+     *   Combobox](https://ariakit.org/examples/menu-nested-combobox)
      */
     resetValueOnHide: boolean;
     /**
@@ -78,7 +78,7 @@ export interface ComboboxStoreState<T extends Value = Value> extends CompositeSt
      */
     resetValueOnSelect: boolean;
 }
-export interface ComboboxStoreFunctions<T extends Value = Value> extends CompositeStoreFunctions<Item>, PopoverStoreFunctions {
+export interface ComboboxStoreFunctions<T extends ComboboxStoreSelectedValue = ComboboxStoreSelectedValue> extends CompositeStoreFunctions<ComboboxStoreItem>, PopoverStoreFunctions {
     /**
      * Sets the [`value`](https://ariakit.org/reference/combobox-provider#value)
      * state.
@@ -98,11 +98,11 @@ export interface ComboboxStoreFunctions<T extends Value = Value> extends Composi
      */
     setSelectedValue: SetState<ComboboxStoreState<T>["selectedValue"]>;
 }
-export interface ComboboxStoreOptions<T extends Value = Value> extends StoreOptions<ComboboxStoreState<T>, "includesBaseElement" | "value" | "selectedValue" | "resetValueOnHide" | "resetValueOnSelect">, CompositeStoreOptions<Item>, PopoverStoreOptions {
+export interface ComboboxStoreOptions<T extends ComboboxStoreSelectedValue = ComboboxStoreSelectedValue> extends CompositeStoreOptions<ComboboxStoreItem>, PopoverStoreOptions, StoreOptions<ComboboxStoreState<T>, "includesBaseElement" | "value" | "selectedValue" | "resetValueOnHide" | "resetValueOnSelect"> {
     /**
      * @default null
      */
-    defaultActiveId?: CompositeStoreOptions<Item>["activeId"];
+    defaultActiveId?: CompositeStoreOptions<ComboboxStoreItem>["activeId"];
     /**
      * The initial value of the combobox input.
      * @default ""
@@ -118,8 +118,8 @@ export interface ComboboxStoreOptions<T extends Value = Value> extends StoreOpti
      */
     defaultSelectedValue?: ComboboxStoreState<T>["selectedValue"];
 }
-export interface ComboboxStoreProps<T extends Value = Value> extends ComboboxStoreOptions<T>, StoreProps<ComboboxStoreState<T>> {
+export interface ComboboxStoreProps<T extends ComboboxStoreSelectedValue = ComboboxStoreSelectedValue> extends ComboboxStoreOptions<T>, StoreProps<ComboboxStoreState<T>> {
 }
-export interface ComboboxStore<T extends Value = Value> extends ComboboxStoreFunctions<T>, Store<ComboboxStoreState<T>> {
+export interface ComboboxStore<T extends ComboboxStoreSelectedValue = ComboboxStoreSelectedValue> extends ComboboxStoreFunctions<T>, Store<ComboboxStoreState<T>> {
 }
 export {};

package/cjs/composite/composite-overflow-store.cjs

@@ -1,16 +1,16 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});"use client";
 
 
-var _7ZUFMSXJcjs = require('../__chunks/7ZUFMSXJ.cjs');
-require('../__chunks/GZDVJEID.cjs');
-require('../__chunks/MEHGRTJ3.cjs');
-require('../__chunks/46BH65MC.cjs');
+var _EFIT5L4Xcjs = require('../__chunks/EFIT5L4X.cjs');
+require('../__chunks/2LS4JJ4S.cjs');
+require('../__chunks/GJFZ5ZPP.cjs');
+require('../__chunks/2UK5WUJX.cjs');
 require('../__chunks/3UT5FE6K.cjs');
 require('../__chunks/AV6KTKLE.cjs');
 
 // src/composite/composite-overflow-store.ts
 function createCompositeOverflowStore(props = {}) {
-  return _7ZUFMSXJcjs.createPopoverStore.call(void 0, props);
+  return _EFIT5L4Xcjs.createPopoverStore.call(void 0, props);
 }
 
 

package/cjs/composite/composite-overflow-store.d.cts

@@ -1,10 +1,16 @@
-import type { PopoverStore, PopoverStoreFunctions, PopoverStoreOptions, PopoverStoreProps, PopoverStoreState } from "../popover/popover-store.js";
+import type { PopoverStoreFunctions, PopoverStoreOptions, PopoverStoreState } from "../popover/popover-store.js";
+import type { Store, StoreProps } from "../utils/store.js";
 /**
- * Creates a composite overflow store.
+ * Creates a compositeOverflow store.
  */
 export declare function createCompositeOverflowStore(props?: CompositeOverflowStoreProps): CompositeOverflowStore;
-export type CompositeOverflowStoreState = PopoverStoreState;
-export type CompositeOverflowStoreFunctions = PopoverStoreFunctions;
-export type CompositeOverflowStoreOptions = PopoverStoreOptions;
-export type CompositeOverflowStoreProps = PopoverStoreProps;
-export type CompositeOverflowStore = PopoverStore;
+export interface CompositeOverflowStoreState extends PopoverStoreState {
+}
+export interface CompositeOverflowStoreFunctions extends PopoverStoreFunctions {
+}
+export interface CompositeOverflowStoreOptions extends PopoverStoreOptions {
+}
+export interface CompositeOverflowStoreProps extends CompositeOverflowStoreOptions, StoreProps<CompositeOverflowStoreState> {
+}
+export interface CompositeOverflowStore extends CompositeOverflowStoreFunctions, Store<CompositeOverflowStoreState> {
+}

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

@@ -1,10 +1,16 @@
-import type { PopoverStore, PopoverStoreFunctions, PopoverStoreOptions, PopoverStoreProps, PopoverStoreState } from "../popover/popover-store.js";
+import type { PopoverStoreFunctions, PopoverStoreOptions, PopoverStoreState } from "../popover/popover-store.js";
+import type { Store, StoreProps } from "../utils/store.js";
 /**
- * Creates a composite overflow store.
+ * Creates a compositeOverflow store.
  */
 export declare function createCompositeOverflowStore(props?: CompositeOverflowStoreProps): CompositeOverflowStore;
-export type CompositeOverflowStoreState = PopoverStoreState;
-export type CompositeOverflowStoreFunctions = PopoverStoreFunctions;
-export type CompositeOverflowStoreOptions = PopoverStoreOptions;
-export type CompositeOverflowStoreProps = PopoverStoreProps;
-export type CompositeOverflowStore = PopoverStore;
+export interface CompositeOverflowStoreState extends PopoverStoreState {
+}
+export interface CompositeOverflowStoreFunctions extends PopoverStoreFunctions {
+}
+export interface CompositeOverflowStoreOptions extends PopoverStoreOptions {
+}
+export interface CompositeOverflowStoreProps extends CompositeOverflowStoreOptions, StoreProps<CompositeOverflowStoreState> {
+}
+export interface CompositeOverflowStore extends CompositeOverflowStoreFunctions, Store<CompositeOverflowStoreState> {
+}

package/cjs/composite/composite-store.cjs

@@ -1,13 +1,13 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});"use client";
 
 
-var _6WBY3ZZMcjs = require('../__chunks/6WBY3ZZM.cjs');
-require('../__chunks/JLC5A6WF.cjs');
-require('../__chunks/46BH65MC.cjs');
+var _JNFZSNOIcjs = require('../__chunks/JNFZSNOI.cjs');
+require('../__chunks/UCLKUBNP.cjs');
+require('../__chunks/2UK5WUJX.cjs');
 require('../__chunks/3UT5FE6K.cjs');
 require('../__chunks/5F4DVUNS.cjs');
 require('../__chunks/ULSPM3Y3.cjs');
 require('../__chunks/AV6KTKLE.cjs');
 
 
-exports.createCompositeStore = _6WBY3ZZMcjs.createCompositeStore;
+exports.createCompositeStore = _JNFZSNOIcjs.createCompositeStore;

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

@@ -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";
-interface Item extends 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.
      */
@@ -101,8 +111,15 @@ export interface CompositeStoreState<T extends Item = Item> extends CollectionSt
      */
     moves: number;
     /**
-     * Indicates whether the composite element should be included in the focus
-     * order.
+     * Indicates if the composite element (such as `menu`, `combobox`, `listbox`,
+     * `toolbar`, etc.) should be part of the focus order. In other words, moving
+     * to the previous element when the first item is in focus will focus on the
+     * composite element itself. The same applies to the last item when moving to
+     * the next element.
+     *
+     * Live examples:
+     * - [Submenu with
+     *   Combobox](https://ariakit.org/examples/menu-nested-combobox)
      * @default false
      */
     includesBaseElement: boolean;
@@ -117,7 +134,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`.
      */
@@ -188,7 +205,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
@@ -197,8 +214,8 @@ export interface CompositeStoreOptions<T extends Item = Item> extends StoreOptio
      */
     defaultActiveId?: CompositeStoreState<T>["activeId"];
 }
-export interface CompositeStoreProps<T extends Item = Item> extends CompositeStoreOptions<T>, StoreProps<CompositeStoreState<T>> {
+export interface CompositeStoreProps<T extends CompositeStoreItem = CompositeStoreItem> extends CompositeStoreOptions<T>, StoreProps<CompositeStoreState<T>> {
 }
-export interface CompositeStore<T extends Item = Item> extends CompositeStoreFunctions<T>, Store<CompositeStoreState<T>> {
+export interface CompositeStore<T extends CompositeStoreItem = CompositeStoreItem> extends CompositeStoreFunctions<T>, Store<CompositeStoreState<T>> {
 }
 export {};

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";
-interface Item extends 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.
      */
@@ -101,8 +111,15 @@ export interface CompositeStoreState<T extends Item = Item> extends CollectionSt
      */
     moves: number;
     /**
-     * Indicates whether the composite element should be included in the focus
-     * order.
+     * Indicates if the composite element (such as `menu`, `combobox`, `listbox`,
+     * `toolbar`, etc.) should be part of the focus order. In other words, moving
+     * to the previous element when the first item is in focus will focus on the
+     * composite element itself. The same applies to the last item when moving to
+     * the next element.
+     *
+     * Live examples:
+     * - [Submenu with
+     *   Combobox](https://ariakit.org/examples/menu-nested-combobox)
      * @default false
      */
     includesBaseElement: boolean;
@@ -117,7 +134,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`.
      */
@@ -188,7 +205,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
@@ -197,8 +214,8 @@ export interface CompositeStoreOptions<T extends Item = Item> extends StoreOptio
      */
     defaultActiveId?: CompositeStoreState<T>["activeId"];
 }
-export interface CompositeStoreProps<T extends Item = Item> extends CompositeStoreOptions<T>, StoreProps<CompositeStoreState<T>> {
+export interface CompositeStoreProps<T extends CompositeStoreItem = CompositeStoreItem> extends CompositeStoreOptions<T>, StoreProps<CompositeStoreState<T>> {
 }
-export interface CompositeStore<T extends Item = Item> extends CompositeStoreFunctions<T>, Store<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

@@ -123,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

@@ -123,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> {
+}