@ariakit/core 0.3.6 → 0.3.8

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

@@ -4,11 +4,10 @@ import type { HovercardStoreFunctions, HovercardStoreOptions, HovercardStoreStat
 import type { Store, StoreOptions, StoreProps } from "../utils/store.js";
 import type { BivariantCallback, PickRequired, SetState, SetStateAction } from "../utils/types.js";
 import type { MenuBarStore } from "./menu-bar-store.js";
-type Values = Record<string, string | boolean | number | Array<string | number>>;
-export declare function createMenuStore<T extends Values = Values>(props: PickRequired<MenuStoreProps<T>, "values" | "defaultValues">): MenuStore<T>;
+export declare function createMenuStore<T extends MenuStoreValues = MenuStoreValues>(props: PickRequired<MenuStoreProps<T>, "values" | "defaultValues">): MenuStore<T>;
 export declare function createMenuStore(props?: MenuStoreProps): MenuStore;
 export type MenuStoreValues = Record<string, string | boolean | number | Array<string | number>>;
-export interface MenuStoreState<T extends Values = Values> extends CompositeStoreState, HovercardStoreState {
+export interface MenuStoreState<T extends MenuStoreValues = MenuStoreValues> extends CompositeStoreState, HovercardStoreState {
     /**
      * Determines the element that should be focused when the menu is opened.
      */
@@ -25,7 +24,7 @@ export interface MenuStoreState<T extends Values = Values> extends CompositeStor
     /** @default 0 */
     hideTimeout?: HovercardStoreState["hideTimeout"];
 }
-export interface MenuStoreFunctions<T extends Values = Values> extends Pick<MenuStoreOptions, "combobox" | "parent" | "menubar">, CompositeStoreFunctions, HovercardStoreFunctions {
+export interface MenuStoreFunctions<T extends MenuStoreValues = MenuStoreValues> extends CompositeStoreFunctions, HovercardStoreFunctions, Pick<MenuStoreOptions, "combobox" | "parent" | "menubar"> {
     /**
      * Hides the menu and all its parent menus.
      */
@@ -51,7 +50,7 @@ export interface MenuStoreFunctions<T extends Values = Values> extends Pick<Menu
      */
     setValue: BivariantCallback<(name: string, value: SetStateAction<MenuStoreState<T>["values"][string]>) => void>;
 }
-export interface MenuStoreOptions<T extends Values = Values> extends StoreOptions<MenuStoreState<T>, "orientation" | "placement" | "hideTimeout" | "values">, CompositeStoreOptions, HovercardStoreOptions {
+export interface MenuStoreOptions<T extends MenuStoreValues = MenuStoreValues> extends CompositeStoreOptions, HovercardStoreOptions, StoreOptions<MenuStoreState<T>, "orientation" | "placement" | "hideTimeout" | "values"> {
     /**
      * 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
@@ -73,6 +72,7 @@ export interface MenuStoreOptions<T extends Values = Values> extends StoreOption
      */
     defaultValues?: MenuStoreState<T>["values"];
 }
-export type MenuStoreProps<T extends Values = Values> = MenuStoreOptions<T> & StoreProps<MenuStoreState<T>>;
-export type MenuStore<T extends Values = Values> = MenuStoreFunctions<T> & Store<MenuStoreState<T>>;
-export {};
+export interface MenuStoreProps<T extends MenuStoreValues = MenuStoreValues> extends MenuStoreOptions<T>, StoreProps<MenuStoreState<T>> {
+}
+export interface MenuStore<T extends MenuStoreValues = MenuStoreValues> extends MenuStoreFunctions<T>, Store<MenuStoreState<T>> {
+}

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

@@ -4,11 +4,10 @@ import type { HovercardStoreFunctions, HovercardStoreOptions, HovercardStoreStat
 import type { Store, StoreOptions, StoreProps } from "../utils/store.js";
 import type { BivariantCallback, PickRequired, SetState, SetStateAction } from "../utils/types.js";
 import type { MenuBarStore } from "./menu-bar-store.js";
-type Values = Record<string, string | boolean | number | Array<string | number>>;
-export declare function createMenuStore<T extends Values = Values>(props: PickRequired<MenuStoreProps<T>, "values" | "defaultValues">): MenuStore<T>;
+export declare function createMenuStore<T extends MenuStoreValues = MenuStoreValues>(props: PickRequired<MenuStoreProps<T>, "values" | "defaultValues">): MenuStore<T>;
 export declare function createMenuStore(props?: MenuStoreProps): MenuStore;
 export type MenuStoreValues = Record<string, string | boolean | number | Array<string | number>>;
-export interface MenuStoreState<T extends Values = Values> extends CompositeStoreState, HovercardStoreState {
+export interface MenuStoreState<T extends MenuStoreValues = MenuStoreValues> extends CompositeStoreState, HovercardStoreState {
     /**
      * Determines the element that should be focused when the menu is opened.
      */
@@ -25,7 +24,7 @@ export interface MenuStoreState<T extends Values = Values> extends CompositeStor
     /** @default 0 */
     hideTimeout?: HovercardStoreState["hideTimeout"];
 }
-export interface MenuStoreFunctions<T extends Values = Values> extends Pick<MenuStoreOptions, "combobox" | "parent" | "menubar">, CompositeStoreFunctions, HovercardStoreFunctions {
+export interface MenuStoreFunctions<T extends MenuStoreValues = MenuStoreValues> extends CompositeStoreFunctions, HovercardStoreFunctions, Pick<MenuStoreOptions, "combobox" | "parent" | "menubar"> {
     /**
      * Hides the menu and all its parent menus.
      */
@@ -51,7 +50,7 @@ export interface MenuStoreFunctions<T extends Values = Values> extends Pick<Menu
      */
     setValue: BivariantCallback<(name: string, value: SetStateAction<MenuStoreState<T>["values"][string]>) => void>;
 }
-export interface MenuStoreOptions<T extends Values = Values> extends StoreOptions<MenuStoreState<T>, "orientation" | "placement" | "hideTimeout" | "values">, CompositeStoreOptions, HovercardStoreOptions {
+export interface MenuStoreOptions<T extends MenuStoreValues = MenuStoreValues> extends CompositeStoreOptions, HovercardStoreOptions, StoreOptions<MenuStoreState<T>, "orientation" | "placement" | "hideTimeout" | "values"> {
     /**
      * 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
@@ -73,6 +72,7 @@ export interface MenuStoreOptions<T extends Values = Values> extends StoreOption
      */
     defaultValues?: MenuStoreState<T>["values"];
 }
-export type MenuStoreProps<T extends Values = Values> = MenuStoreOptions<T> & StoreProps<MenuStoreState<T>>;
-export type MenuStore<T extends Values = Values> = MenuStoreFunctions<T> & Store<MenuStoreState<T>>;
-export {};
+export interface MenuStoreProps<T extends MenuStoreValues = MenuStoreValues> extends MenuStoreOptions<T>, StoreProps<MenuStoreState<T>> {
+}
+export interface MenuStore<T extends MenuStoreValues = MenuStoreValues> extends MenuStoreFunctions<T>, Store<MenuStoreState<T>> {
+}

package/cjs/menubar/menubar-store.cjs

@@ -1,14 +1,14 @@
 "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');
 require('../__chunks/AV6KTKLE.cjs');
 
 
-exports.createMenubarStore = _GXIZMD53cjs.createMenubarStore;
+exports.createMenubarStore = _3J44Z7YHcjs.createMenubarStore;

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

@@ -1,7 +1,7 @@
 import type { CompositeStoreFunctions, CompositeStoreOptions, CompositeStoreState } from "../composite/composite-store.js";
 import type { Store, StoreProps } from "../utils/store.js";
 /**
- * Creates a menu bar store.
+ * Creates a menubar store.
  */
 export declare function createMenubarStore(props?: MenubarStoreProps): MenubarStore;
 export interface MenubarStoreState extends CompositeStoreState {

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

@@ -1,7 +1,7 @@
 import type { CompositeStoreFunctions, CompositeStoreOptions, CompositeStoreState } from "../composite/composite-store.js";
 import type { Store, StoreProps } from "../utils/store.js";
 /**
- * Creates a menu bar store.
+ * Creates a menubar store.
  */
 export declare function createMenubarStore(props?: MenubarStoreProps): MenubarStore;
 export interface MenubarStoreState extends CompositeStoreState {

package/cjs/popover/popover-store.cjs

@@ -1,12 +1,12 @@
 "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');
 
 
-exports.createPopoverStore = _7ZUFMSXJcjs.createPopoverStore;
+exports.createPopoverStore = _EFIT5L4Xcjs.createPopoverStore;

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

@@ -28,6 +28,9 @@ export interface PopoverStoreState extends DialogStoreState {
     currentPlacement: Placement;
     /**
      * The placement of the popover.
+     *
+     * Live examples:
+     * - [Navigation Menubar](https://ariakit.org/examples/menubar-navigation)
      * @default "bottom"
      */
     placement: Placement;
@@ -57,13 +60,15 @@ export interface PopoverStoreFunctions extends DialogStoreFunctions {
      */
     render: () => void;
 }
-export interface PopoverStoreOptions extends StoreOptions<PopoverStoreState, "placement">, DialogStoreOptions {
+export interface PopoverStoreOptions extends DialogStoreOptions, StoreOptions<PopoverStoreState, "placement"> {
     /**
      * A reference to another popover store that's controlling another popover to
      * keep them in sync.
      */
     popover?: PopoverStore | null;
 }
-export type PopoverStoreProps = PopoverStoreOptions & StoreProps<PopoverStoreState>;
-export type PopoverStore = PopoverStoreFunctions & Store<PopoverStoreState>;
+export interface PopoverStoreProps extends PopoverStoreOptions, StoreProps<PopoverStoreState> {
+}
+export interface PopoverStore extends PopoverStoreFunctions, Store<PopoverStoreState> {
+}
 export {};

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

@@ -28,6 +28,9 @@ export interface PopoverStoreState extends DialogStoreState {
     currentPlacement: Placement;
     /**
      * The placement of the popover.
+     *
+     * Live examples:
+     * - [Navigation Menubar](https://ariakit.org/examples/menubar-navigation)
      * @default "bottom"
      */
     placement: Placement;
@@ -57,13 +60,15 @@ export interface PopoverStoreFunctions extends DialogStoreFunctions {
      */
     render: () => void;
 }
-export interface PopoverStoreOptions extends StoreOptions<PopoverStoreState, "placement">, DialogStoreOptions {
+export interface PopoverStoreOptions extends DialogStoreOptions, StoreOptions<PopoverStoreState, "placement"> {
     /**
      * A reference to another popover store that's controlling another popover to
      * keep them in sync.
      */
     popover?: PopoverStore | null;
 }
-export type PopoverStoreProps = PopoverStoreOptions & StoreProps<PopoverStoreState>;
-export type PopoverStore = PopoverStoreFunctions & Store<PopoverStoreState>;
+export interface PopoverStoreProps extends PopoverStoreOptions, StoreProps<PopoverStoreState> {
+}
+export interface PopoverStore extends PopoverStoreFunctions, Store<PopoverStoreState> {
+}
 export {};

package/cjs/radio/radio-store.cjs

@@ -1,11 +1,11 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});"use client";
 
 
-var _6WBY3ZZMcjs = require('../__chunks/6WBY3ZZM.cjs');
-require('../__chunks/JLC5A6WF.cjs');
+var _QAZ4PF7Scjs = require('../__chunks/QAZ4PF7S.cjs');
+require('../__chunks/ZQTYFYRS.cjs');
 
 
-var _46BH65MCcjs = require('../__chunks/46BH65MC.cjs');
+var _2UK5WUJXcjs = require('../__chunks/2UK5WUJX.cjs');
 
 
 var _3UT5FE6Kcjs = require('../__chunks/3UT5FE6K.cjs');
@@ -22,7 +22,7 @@ function createRadioStore(_a = {}) {
   var props = _AV6KTKLEcjs.__objRest.call(void 0, _a, []);
   var _a2;
   const syncState = (_a2 = props.store) == null ? void 0 : _a2.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), {
     focusLoop: _3UT5FE6Kcjs.defaultValue.call(void 0, props.focusLoop, syncState == null ? void 0 : syncState.focusLoop, true)
   }));
   const initialState = _AV6KTKLEcjs.__spreadProps.call(void 0, _AV6KTKLEcjs.__spreadValues.call(void 0, {}, composite.getState()), {
@@ -33,7 +33,7 @@ function createRadioStore(_a = {}) {
       null
     )
   });
-  const radio = _46BH65MCcjs.createStore.call(void 0, initialState, composite, props.store);
+  const radio = _2UK5WUJXcjs.createStore.call(void 0, initialState, composite, props.store);
   return _AV6KTKLEcjs.__spreadProps.call(void 0, _AV6KTKLEcjs.__spreadValues.call(void 0, _AV6KTKLEcjs.__spreadValues.call(void 0, {}, composite), radio), {
     setValue: (value) => radio.setState("value", value)
   });

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

@@ -25,12 +25,14 @@ export interface RadioStoreFunctions extends CompositeStoreFunctions {
      */
     setValue: SetState<RadioStoreState["value"]>;
 }
-export interface RadioStoreOptions extends StoreOptions<RadioStoreState, "focusLoop" | "value">, CompositeStoreOptions {
+export interface RadioStoreOptions extends CompositeStoreOptions, StoreOptions<RadioStoreState, "focusLoop" | "value"> {
     /**
      * The default value of the radio group.
      * @default null
      */
     defaultValue?: RadioStoreState["value"];
 }
-export type RadioStoreProps = RadioStoreOptions & StoreProps<RadioStoreState>;
-export type RadioStore = RadioStoreFunctions & Store<RadioStoreState>;
+export interface RadioStoreProps extends RadioStoreOptions, StoreProps<RadioStoreState> {
+}
+export interface RadioStore extends RadioStoreFunctions, Store<RadioStoreState> {
+}

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

@@ -25,12 +25,14 @@ export interface RadioStoreFunctions extends CompositeStoreFunctions {
      */
     setValue: SetState<RadioStoreState["value"]>;
 }
-export interface RadioStoreOptions extends StoreOptions<RadioStoreState, "focusLoop" | "value">, CompositeStoreOptions {
+export interface RadioStoreOptions extends CompositeStoreOptions, StoreOptions<RadioStoreState, "focusLoop" | "value"> {
     /**
      * The default value of the radio group.
      * @default null
      */
     defaultValue?: RadioStoreState["value"];
 }
-export type RadioStoreProps = RadioStoreOptions & StoreProps<RadioStoreState>;
-export type RadioStore = RadioStoreFunctions & Store<RadioStoreState>;
+export interface RadioStoreProps extends RadioStoreOptions, StoreProps<RadioStoreState> {
+}
+export interface RadioStore extends RadioStoreFunctions, Store<RadioStoreState> {
+}

package/cjs/select/select-store.cjs

@@ -1,13 +1,13 @@
 "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 _QAZ4PF7Scjs = require('../__chunks/QAZ4PF7S.cjs');
+require('../__chunks/ZQTYFYRS.cjs');
 
 
 
@@ -16,7 +16,7 @@ require('../__chunks/JLC5A6WF.cjs');
 
 
 
-var _46BH65MCcjs = require('../__chunks/46BH65MC.cjs');
+var _2UK5WUJXcjs = require('../__chunks/2UK5WUJX.cjs');
 
 
 var _3UT5FE6Kcjs = require('../__chunks/3UT5FE6K.cjs');
@@ -37,9 +37,9 @@ function createSelectStore(_a = {}) {
   } = _b, props = _AV6KTKLEcjs.__objRest.call(void 0, _b, [
     "combobox"
   ]);
-  const store = _46BH65MCcjs.mergeStore.call(void 0, 
+  const store = _2UK5WUJXcjs.mergeStore.call(void 0, 
     props.store,
-    _46BH65MCcjs.omit.call(void 0, combobox, [
+    _2UK5WUJXcjs.omit.call(void 0, combobox, [
       "value",
       "items",
       "renderedItems",
@@ -51,9 +51,9 @@ function createSelectStore(_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,
     virtualFocus: _3UT5FE6Kcjs.defaultValue.call(void 0, 
       props.virtualFocus,
@@ -77,7 +77,7 @@ function createSelectStore(_a = {}) {
       "vertical"
     )
   }));
-  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), {
     store,
     placement: _3UT5FE6Kcjs.defaultValue.call(void 0, 
       props.placement,
@@ -101,10 +101,10 @@ function createSelectStore(_a = {}) {
     selectElement: _3UT5FE6Kcjs.defaultValue.call(void 0, syncState.selectElement, null),
     labelElement: _3UT5FE6Kcjs.defaultValue.call(void 0, syncState.labelElement, null)
   });
-  const select = _46BH65MCcjs.createStore.call(void 0, initialState, composite, popover, store);
-  _46BH65MCcjs.setup.call(void 0, 
+  const select = _2UK5WUJXcjs.createStore.call(void 0, initialState, composite, popover, store);
+  _2UK5WUJXcjs.setup.call(void 0, 
     select,
-    () => _46BH65MCcjs.sync.call(void 0, select, ["value", "items"], (state) => {
+    () => _2UK5WUJXcjs.sync.call(void 0, select, ["value", "items"], (state) => {
       if (state.value !== initialValue)
         return;
       if (!state.items.length)
@@ -117,9 +117,9 @@ function createSelectStore(_a = {}) {
       select.setState("value", item.value);
     })
   );
-  _46BH65MCcjs.setup.call(void 0, 
+  _2UK5WUJXcjs.setup.call(void 0, 
     select,
-    () => _46BH65MCcjs.sync.call(void 0, select, ["mounted", "items", "value"], (state) => {
+    () => _2UK5WUJXcjs.sync.call(void 0, select, ["mounted", "items", "value"], (state) => {
       if (combobox)
         return;
       if (state.mounted)
@@ -136,9 +136,9 @@ function createSelectStore(_a = {}) {
       select.setState("activeId", item.id);
     })
   );
-  _46BH65MCcjs.setup.call(void 0, 
+  _2UK5WUJXcjs.setup.call(void 0, 
     select,
-    () => _46BH65MCcjs.batch.call(void 0, select, ["setValueOnMove", "moves"], (state) => {
+    () => _2UK5WUJXcjs.batch.call(void 0, select, ["setValueOnMove", "moves"], (state) => {
       const { mounted, value, activeId } = select.getState();
       if (!state.setValueOnMove && mounted)
         return;

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

@@ -3,42 +3,54 @@ 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;
-type Item = CompositeStoreItem & {
-    value?: string;
-};
-export declare function createSelectStore<T extends Value = Value>(props: PickRequired<SelectStoreProps<T>, "value" | "defaultValue">): SelectStore<T>;
+type MutableValue<T extends SelectStoreValue = SelectStoreValue> = T extends string ? string : T;
+export declare function createSelectStore<T extends SelectStoreValue = SelectStoreValue>(props: PickRequired<SelectStoreProps<T>, "value" | "defaultValue">): SelectStore<T>;
 export declare function createSelectStore(props?: SelectStoreProps): SelectStore;
-export type SelectStoreItem = Item;
-export type SelectStoreValue = Value;
-export interface SelectStoreState<T extends Value = Value> extends CompositeStoreState<Item>, PopoverStoreState {
+export type SelectStoreValue = string | string[];
+export interface SelectStoreItem extends CompositeStoreItem {
+    value?: string;
+}
+export interface SelectStoreState<T extends SelectStoreValue = SelectStoreValue> extends CompositeStoreState<SelectStoreItem>, PopoverStoreState {
     /** @default true */
-    virtualFocus: CompositeStoreState<Item>["virtualFocus"];
+    virtualFocus: CompositeStoreState<SelectStoreItem>["virtualFocus"];
     /** @default false */
-    includesBaseElement: CompositeStoreState<Item>["includesBaseElement"];
+    includesBaseElement: CompositeStoreState<SelectStoreItem>["includesBaseElement"];
     /** @default null */
-    activeId: CompositeStoreState<Item>["activeId"];
+    activeId: CompositeStoreState<SelectStoreItem>["activeId"];
     /** @default "vertical" */
-    orientation: CompositeStoreState<Item>["orientation"];
+    orientation: CompositeStoreState<SelectStoreItem>["orientation"];
     /** @default "bottom-start" */
     placement: PopoverStoreState["placement"];
     /**
      * The select value.
      *
      * Live examples:
-     * - [Multi-selectable
-     *   Combobox](https://ariakit.org/examples/combobox-multiple)
+     * - [Form with Select](https://ariakit.org/examples/form-select)
+     * - [Select Grid](https://ariakit.org/examples/select-grid)
+     * - [Select with custom
+     *   items](https://ariakit.org/examples/select-item-custom)
+     * - [Multi-Select](https://ariakit.org/examples/select-multiple)
+     * - [Toolbar with Select](https://ariakit.org/examples/toolbar-select)
      */
     value: MutableValue<T>;
     /**
-     * Whether the select value should be set when the active item changes by
-     * moving (which usually happens when moving to an item using the keyboard).
+     * Whether the select
+     * [`value`](https://ariakit.org/reference/select-provider#value) should be
+     * set when the active item changes by moving (which usually happens when
+     * moving to an item using the keyboard).
+     *
+     * Live examples:
+     * - [Select Grid](https://ariakit.org/examples/select-grid)
+     * - [Select with custom
+     *   items](https://ariakit.org/examples/select-item-custom)
      * @default false
      */
     setValueOnMove: boolean;
     /**
      * The select button element.
+     *
+     * Live examples:
+     * - [Form with Select](https://ariakit.org/examples/form-select)
      */
     selectElement: HTMLElement | null;
     /**
@@ -46,13 +58,9 @@ export interface SelectStoreState<T extends Value = Value> extends CompositeStor
      */
     labelElement: HTMLElement | null;
 }
-export interface SelectStoreFunctions<T extends Value = Value> extends Pick<SelectStoreOptions<T>, "combobox">, CompositeStoreFunctions<Item>, PopoverStoreFunctions {
+export interface SelectStoreFunctions<T extends SelectStoreValue = SelectStoreValue> extends Pick<SelectStoreOptions<T>, "combobox">, CompositeStoreFunctions<SelectStoreItem>, PopoverStoreFunctions {
     /**
      * Sets the `value` state.
-     *
-     * Live examples:
-     * - [Multi-selectable
-     *   Combobox](https://ariakit.org/examples/combobox-multiple)
      * @example
      * store.setValue("Apple");
      * store.setValue(["Apple", "Banana"]);
@@ -68,26 +76,26 @@ export interface SelectStoreFunctions<T extends Value = Value> extends Pick<Sele
      */
     setLabelElement: SetState<SelectStoreState<T>["labelElement"]>;
 }
-export interface SelectStoreOptions<T extends Value = Value> extends StoreOptions<SelectStoreState<T>, "virtualFocus" | "includesBaseElement" | "activeId" | "orientation" | "placement" | "value" | "setValueOnMove">, CompositeStoreOptions<Item>, PopoverStoreOptions {
+export interface SelectStoreOptions<T extends SelectStoreValue = SelectStoreValue> extends CompositeStoreOptions<SelectStoreItem>, PopoverStoreOptions, StoreOptions<SelectStoreState<T>, "virtualFocus" | "includesBaseElement" | "activeId" | "orientation" | "placement" | "value" | "setValueOnMove"> {
     /**
      * A reference to a combobox store. This is used when combining the combobox
      * with a select (e.g., select with a search input). The stores will share the
      * same state.
-     *
-     * Live examples:
-     * - [Multi-selectable
-     *   Combobox](https://ariakit.org/examples/combobox-multiple)
      */
     combobox?: ComboboxStore | null;
     /**
      * The default value. If not set, the first non-disabled item will be used.
      *
      * Live examples:
-     * - [Multi-selectable
-     *   Combobox](https://ariakit.org/examples/combobox-multiple)
+     * - [Form with Select](https://ariakit.org/examples/form-select)
+     * - [Animated Select](https://ariakit.org/examples/select-animated)
+     * - [Select with Combobox](https://ariakit.org/examples/select-combobox)
+     * - [SelectGroup](https://ariakit.org/examples/select-group)
      */
     defaultValue?: SelectStoreState<T>["value"];
 }
-export type SelectStoreProps<T extends Value = Value> = SelectStoreOptions<T> & StoreProps<SelectStoreState<T>>;
-export type SelectStore<T extends Value = Value> = SelectStoreFunctions<T> & Store<SelectStoreState<T>>;
+export interface SelectStoreProps<T extends SelectStoreValue = SelectStoreValue> extends SelectStoreOptions<T>, StoreProps<SelectStoreState<T>> {
+}
+export interface SelectStore<T extends SelectStoreValue = SelectStoreValue> extends SelectStoreFunctions<T>, Store<SelectStoreState<T>> {
+}
 export {};

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

@@ -3,42 +3,54 @@ 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;
-type Item = CompositeStoreItem & {
-    value?: string;
-};
-export declare function createSelectStore<T extends Value = Value>(props: PickRequired<SelectStoreProps<T>, "value" | "defaultValue">): SelectStore<T>;
+type MutableValue<T extends SelectStoreValue = SelectStoreValue> = T extends string ? string : T;
+export declare function createSelectStore<T extends SelectStoreValue = SelectStoreValue>(props: PickRequired<SelectStoreProps<T>, "value" | "defaultValue">): SelectStore<T>;
 export declare function createSelectStore(props?: SelectStoreProps): SelectStore;
-export type SelectStoreItem = Item;
-export type SelectStoreValue = Value;
-export interface SelectStoreState<T extends Value = Value> extends CompositeStoreState<Item>, PopoverStoreState {
+export type SelectStoreValue = string | string[];
+export interface SelectStoreItem extends CompositeStoreItem {
+    value?: string;
+}
+export interface SelectStoreState<T extends SelectStoreValue = SelectStoreValue> extends CompositeStoreState<SelectStoreItem>, PopoverStoreState {
     /** @default true */
-    virtualFocus: CompositeStoreState<Item>["virtualFocus"];
+    virtualFocus: CompositeStoreState<SelectStoreItem>["virtualFocus"];
     /** @default false */
-    includesBaseElement: CompositeStoreState<Item>["includesBaseElement"];
+    includesBaseElement: CompositeStoreState<SelectStoreItem>["includesBaseElement"];
     /** @default null */
-    activeId: CompositeStoreState<Item>["activeId"];
+    activeId: CompositeStoreState<SelectStoreItem>["activeId"];
     /** @default "vertical" */
-    orientation: CompositeStoreState<Item>["orientation"];
+    orientation: CompositeStoreState<SelectStoreItem>["orientation"];
     /** @default "bottom-start" */
     placement: PopoverStoreState["placement"];
     /**
      * The select value.
      *
      * Live examples:
-     * - [Multi-selectable
-     *   Combobox](https://ariakit.org/examples/combobox-multiple)
+     * - [Form with Select](https://ariakit.org/examples/form-select)
+     * - [Select Grid](https://ariakit.org/examples/select-grid)
+     * - [Select with custom
+     *   items](https://ariakit.org/examples/select-item-custom)
+     * - [Multi-Select](https://ariakit.org/examples/select-multiple)
+     * - [Toolbar with Select](https://ariakit.org/examples/toolbar-select)
      */
     value: MutableValue<T>;
     /**
-     * Whether the select value should be set when the active item changes by
-     * moving (which usually happens when moving to an item using the keyboard).
+     * Whether the select
+     * [`value`](https://ariakit.org/reference/select-provider#value) should be
+     * set when the active item changes by moving (which usually happens when
+     * moving to an item using the keyboard).
+     *
+     * Live examples:
+     * - [Select Grid](https://ariakit.org/examples/select-grid)
+     * - [Select with custom
+     *   items](https://ariakit.org/examples/select-item-custom)
      * @default false
      */
     setValueOnMove: boolean;
     /**
      * The select button element.
+     *
+     * Live examples:
+     * - [Form with Select](https://ariakit.org/examples/form-select)
      */
     selectElement: HTMLElement | null;
     /**
@@ -46,13 +58,9 @@ export interface SelectStoreState<T extends Value = Value> extends CompositeStor
      */
     labelElement: HTMLElement | null;
 }
-export interface SelectStoreFunctions<T extends Value = Value> extends Pick<SelectStoreOptions<T>, "combobox">, CompositeStoreFunctions<Item>, PopoverStoreFunctions {
+export interface SelectStoreFunctions<T extends SelectStoreValue = SelectStoreValue> extends Pick<SelectStoreOptions<T>, "combobox">, CompositeStoreFunctions<SelectStoreItem>, PopoverStoreFunctions {
     /**
      * Sets the `value` state.
-     *
-     * Live examples:
-     * - [Multi-selectable
-     *   Combobox](https://ariakit.org/examples/combobox-multiple)
      * @example
      * store.setValue("Apple");
      * store.setValue(["Apple", "Banana"]);
@@ -68,26 +76,26 @@ export interface SelectStoreFunctions<T extends Value = Value> extends Pick<Sele
      */
     setLabelElement: SetState<SelectStoreState<T>["labelElement"]>;
 }
-export interface SelectStoreOptions<T extends Value = Value> extends StoreOptions<SelectStoreState<T>, "virtualFocus" | "includesBaseElement" | "activeId" | "orientation" | "placement" | "value" | "setValueOnMove">, CompositeStoreOptions<Item>, PopoverStoreOptions {
+export interface SelectStoreOptions<T extends SelectStoreValue = SelectStoreValue> extends CompositeStoreOptions<SelectStoreItem>, PopoverStoreOptions, StoreOptions<SelectStoreState<T>, "virtualFocus" | "includesBaseElement" | "activeId" | "orientation" | "placement" | "value" | "setValueOnMove"> {
     /**
      * A reference to a combobox store. This is used when combining the combobox
      * with a select (e.g., select with a search input). The stores will share the
      * same state.
-     *
-     * Live examples:
-     * - [Multi-selectable
-     *   Combobox](https://ariakit.org/examples/combobox-multiple)
      */
     combobox?: ComboboxStore | null;
     /**
      * The default value. If not set, the first non-disabled item will be used.
      *
      * Live examples:
-     * - [Multi-selectable
-     *   Combobox](https://ariakit.org/examples/combobox-multiple)
+     * - [Form with Select](https://ariakit.org/examples/form-select)
+     * - [Animated Select](https://ariakit.org/examples/select-animated)
+     * - [Select with Combobox](https://ariakit.org/examples/select-combobox)
+     * - [SelectGroup](https://ariakit.org/examples/select-group)
      */
     defaultValue?: SelectStoreState<T>["value"];
 }
-export type SelectStoreProps<T extends Value = Value> = SelectStoreOptions<T> & StoreProps<SelectStoreState<T>>;
-export type SelectStore<T extends Value = Value> = SelectStoreFunctions<T> & Store<SelectStoreState<T>>;
+export interface SelectStoreProps<T extends SelectStoreValue = SelectStoreValue> extends SelectStoreOptions<T>, StoreProps<SelectStoreState<T>> {
+}
+export interface SelectStore<T extends SelectStoreValue = SelectStoreValue> extends SelectStoreFunctions<T>, Store<SelectStoreState<T>> {
+}
 export {};