@ariakit/core 0.3.6 → 0.3.8

package/esm/collection/collection-store.d.ts

@@ -1,15 +1,20 @@
 import type { Store, StoreOptions, StoreProps } from "../utils/store.js";
 import type { BivariantCallback } from "../utils/types.js";
-type Item = {
-    id: string;
-    element?: HTMLElement | null;
-};
 /**
  * Creates a collection store.
  */
-export declare function createCollectionStore<T extends Item = Item>(props?: CollectionStoreProps<T>): CollectionStore<T>;
-export type CollectionStoreItem = Item;
-export interface CollectionStoreState<T extends Item = Item> {
+export declare function createCollectionStore<T extends CollectionStoreItem = CollectionStoreItem>(props?: CollectionStoreProps<T>): CollectionStore<T>;
+export interface CollectionStoreItem {
+    /**
+     * The id of the item.
+     */
+    id: string;
+    /**
+     * The item HTML element. This is automatically set when the item is rendered.
+     */
+    element?: HTMLElement | null;
+}
+export interface CollectionStoreState<T extends CollectionStoreItem = CollectionStoreItem> {
     /**
      * Lists all the items with their meta data. This state is automatically
      * updated when an item is registered or unregistered with the `registerItem`
@@ -24,7 +29,7 @@ export interface CollectionStoreState<T extends Item = Item> {
      */
     renderedItems: T[];
 }
-export interface CollectionStoreFunctions<T extends Item = Item> {
+export interface CollectionStoreFunctions<T extends CollectionStoreItem = CollectionStoreItem> {
     /**
      * Registers an item in the collection. This function returns a cleanup
      * function that unregisters the item.
@@ -53,13 +58,14 @@ export interface CollectionStoreFunctions<T extends Item = Item> {
      */
     item: (id: string | null | undefined) => T | null;
 }
-export interface CollectionStoreOptions<T extends Item = Item> extends StoreOptions<CollectionStoreState<T>, "items"> {
+export interface CollectionStoreOptions<T extends CollectionStoreItem = CollectionStoreItem> extends StoreOptions<CollectionStoreState<T>, "items"> {
     /**
      * The defaut value for the `items` state.
      * @default []
      */
     defaultItems?: CollectionStoreState<T>["items"];
 }
-export type CollectionStoreProps<T extends Item = Item> = CollectionStoreOptions<T> & StoreProps<CollectionStoreState<T>>;
-export type CollectionStore<T extends Item = Item> = CollectionStoreFunctions<T> & Store<CollectionStoreState<T>>;
-export {};
+export interface CollectionStoreProps<T extends CollectionStoreItem = CollectionStoreItem> extends CollectionStoreOptions<T>, StoreProps<CollectionStoreState<T>> {
+}
+export interface CollectionStore<T extends CollectionStoreItem = CollectionStoreItem> extends CollectionStoreFunctions<T>, Store<CollectionStoreState<T>> {
+}

package/esm/collection/collection-store.js

@@ -1,8 +1,8 @@
 "use client";
 import {
   createCollectionStore
-} from "../__chunks/CCU5UHQ2.js";
-import "../__chunks/E7OQVGGY.js";
+} from "../__chunks/HMQYEBKF.js";
+import "../__chunks/A2J4XZ5T.js";
 import "../__chunks/I2VQ3XGR.js";
 import "../__chunks/DLOEKDPY.js";
 import "../__chunks/4R3V3JGP.js";

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

@@ -1,22 +1,24 @@
 import type { CompositeStoreFunctions, CompositeStoreItem, CompositeStoreOptions, CompositeStoreState } from "../composite/composite-store.js";
 import type { PopoverStoreFunctions, PopoverStoreOptions, PopoverStoreState } from "../popover/popover-store.js";
 import type { Store, StoreOptions, StoreProps } from "../utils/store.js";
-import type { SetState } from "../utils/types.js";
-type Item = CompositeStoreItem & {
-    value?: string;
-};
+import type { PickRequired, SetState } from "../utils/types.js";
+type MutableValue<T extends ComboboxStoreSelectedValue = ComboboxStoreSelectedValue> = T extends string ? string : T;
 /**
  * Creates a combobox store.
  */
+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 interface ComboboxStoreState 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
      */
     includesBaseElement: boolean;
     /**
-     * The input value.
+     * The combobox input value.
      *
      * Live examples:
      * - [Combobox with integrated
@@ -34,47 +36,88 @@ export interface ComboboxStoreState extends CompositeStoreState<Item>, PopoverSt
      */
     activeValue: string | undefined;
     /**
-     * Whether to reset the value when the combobox popover is hidden.
+     * The value(s) of the currently selected item(s). This can be a string or an
+     * array of strings. If it's an array, the combobox is considered
+     * [multi-selectable](https://ariakit.org/examples/combobox-multiple).
+     *
+     * Live examples:
+     * - [Multi-selectable
+     *   Combobox](https://ariakit.org/examples/combobox-multiple)
+     */
+    selectedValue: MutableValue<T>;
+    /**
+     * Whether to reset the value when the combobox popover closes. This prop is
+     * automatically set to `true` by default if the combobox supports multiple
+     * selections. In other words, if the
+     * [`selectedValue`](https://ariakit.org/reference/combobox-provider#selectedvalue)
+     * or
+     * [`defaultSelectedValue`](https://ariakit.org/reference/combobox-provider#defaultselectedvalue)
+     * props are arrays.
      *
      * Live examples:
      * - [Multi-selectable
      *   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)
-     * @default false
      */
     resetValueOnHide: boolean;
-}
-export interface ComboboxStoreFunctions extends CompositeStoreFunctions<Item>, PopoverStoreFunctions {
     /**
-     * Sets the `value` state.
+     * Whether to reset the value when an item is selected. This prop is
+     * automatically set to `true` by default if the combobox supports multiple
+     * selections. In other words, if the
+     * [`selectedValue`](https://ariakit.org/reference/combobox-provider#selectedvalue)
+     * or
+     * [`defaultSelectedValue`](https://ariakit.org/reference/combobox-provider#defaultselectedvalue)
+     * props are arrays.
      *
      * Live examples:
      * - [Multi-selectable
      *   Combobox](https://ariakit.org/examples/combobox-multiple)
+     */
+    resetValueOnSelect: boolean;
+}
+export interface ComboboxStoreFunctions<T extends ComboboxStoreSelectedValue = ComboboxStoreSelectedValue> extends CompositeStoreFunctions<ComboboxStoreItem>, PopoverStoreFunctions {
+    /**
+     * Sets the [`value`](https://ariakit.org/reference/combobox-provider#value)
+     * state.
+     *
+     * Live examples:
      * - [Textarea with inline
      *   Combobox](https://ariakit.org/examples/combobox-textarea)
      * @example
      * store.setValue("Hello world");
      * store.setValue((value) => value + "!");
      */
-    setValue: SetState<ComboboxStoreState["value"]>;
+    setValue: SetState<ComboboxStoreState<T>["value"]>;
+    /**
+     * Sets the
+     * [`selectedValue`](https://ariakit.org/reference/combobox-provider#selectedvalue)
+     * state.
+     */
+    setSelectedValue: SetState<ComboboxStoreState<T>["selectedValue"]>;
 }
-export interface ComboboxStoreOptions extends StoreOptions<ComboboxStoreState, "includesBaseElement" | "value" | "resetValueOnHide">, 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 combobox initial value.
-     *
-     * Live examples:
-     * - [Multi-selectable
-     *   Combobox](https://ariakit.org/examples/combobox-multiple)
+     * The initial value of the combobox input.
+     * @default ""
+     */
+    defaultValue?: ComboboxStoreState<T>["value"];
+    /**
+     * The initial value of the
+     * [`selectedValue`](https://ariakit.org/reference/combobox-provider#selectedvalue)
+     * state. This can be a string or an array of strings. If it's an array, the
+     * combobox is considered
+     * [multi-selectable](https://ariakit.org/examples/combobox-multiple).
      * @default ""
      */
-    defaultValue?: ComboboxStoreState["value"];
+    defaultSelectedValue?: ComboboxStoreState<T>["selectedValue"];
+}
+export interface ComboboxStoreProps<T extends ComboboxStoreSelectedValue = ComboboxStoreSelectedValue> extends ComboboxStoreOptions<T>, StoreProps<ComboboxStoreState<T>> {
+}
+export interface ComboboxStore<T extends ComboboxStoreSelectedValue = ComboboxStoreSelectedValue> extends ComboboxStoreFunctions<T>, Store<ComboboxStoreState<T>> {
 }
-export type ComboboxStoreProps = ComboboxStoreOptions & StoreProps<ComboboxStoreState>;
-export type ComboboxStore = ComboboxStoreFunctions & Store<ComboboxStoreState>;
 export {};

package/esm/combobox/combobox-store.js

@@ -1,20 +1,20 @@
 "use client";
 import {
   createPopoverStore
-} from "../__chunks/WY3EMTH6.js";
-import "../__chunks/CL47ZAPY.js";
-import "../__chunks/DYD4YNLE.js";
+} from "../__chunks/J6JIOWCS.js";
+import "../__chunks/LT2OYWRD.js";
+import "../__chunks/NKLTHWCR.js";
 import {
   createCompositeStore
-} from "../__chunks/OGMLJYDV.js";
-import "../__chunks/CCU5UHQ2.js";
+} from "../__chunks/CTZ2GQIZ.js";
+import "../__chunks/HMQYEBKF.js";
 import {
   batch,
   createStore,
   setup,
   sync,
   throwOnConflictingProps
-} from "../__chunks/E7OQVGGY.js";
+} from "../__chunks/A2J4XZ5T.js";
 import {
   defaultValue
 } from "../__chunks/I2VQ3XGR.js";
@@ -68,18 +68,31 @@ function createComboboxStore(props = {}) {
       "bottom-start"
     )
   }));
-  const initialValue = defaultValue(
+  const value = defaultValue(
     props.value,
     syncState == null ? void 0 : syncState.value,
     props.defaultValue,
     ""
   );
+  const selectedValue = defaultValue(
+    props.selectedValue,
+    syncState == null ? void 0 : syncState.selectedValue,
+    props.defaultSelectedValue,
+    ""
+  );
+  const multiSelectable = Array.isArray(selectedValue);
   const initialState = __spreadProps(__spreadValues(__spreadValues({}, composite.getState()), popover.getState()), {
-    value: initialValue,
+    value,
+    selectedValue,
+    resetValueOnSelect: defaultValue(
+      props.resetValueOnSelect,
+      syncState == null ? void 0 : syncState.resetValueOnSelect,
+      multiSelectable
+    ),
     resetValueOnHide: defaultValue(
       props.resetValueOnHide,
       syncState == null ? void 0 : syncState.resetValueOnHide,
-      false
+      multiSelectable
     ),
     activeValue: syncState == null ? void 0 : syncState.activeValue
   });
@@ -91,7 +104,15 @@ function createComboboxStore(props = {}) {
         return;
       if (state.mounted)
         return;
-      combobox.setState("value", initialValue);
+      combobox.setState("value", value);
+    })
+  );
+  setup(
+    combobox,
+    () => sync(combobox, ["resetValueOnSelect", "selectedValue"], (state) => {
+      if (!state.resetValueOnSelect)
+        return;
+      combobox.setState("value", value);
     })
   );
   setup(
@@ -122,7 +143,8 @@ function createComboboxStore(props = {}) {
     })
   );
   return __spreadProps(__spreadValues(__spreadValues(__spreadValues({}, popover), composite), combobox), {
-    setValue: (value) => combobox.setState("value", value)
+    setValue: (value2) => combobox.setState("value", value2),
+    setSelectedValue: (selectedValue2) => combobox.setState("selectedValue", selectedValue2)
   });
 }
 export {

package/esm/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/esm/composite/composite-overflow-store.js

@@ -1,10 +1,10 @@
 "use client";
 import {
   createPopoverStore
-} from "../__chunks/WY3EMTH6.js";
-import "../__chunks/CL47ZAPY.js";
-import "../__chunks/DYD4YNLE.js";
-import "../__chunks/E7OQVGGY.js";
+} from "../__chunks/J6JIOWCS.js";
+import "../__chunks/LT2OYWRD.js";
+import "../__chunks/NKLTHWCR.js";
+import "../__chunks/A2J4XZ5T.js";
 import "../__chunks/I2VQ3XGR.js";
 import "../__chunks/4R3V3JGP.js";
 

package/esm/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/esm/composite/composite-store.js

@@ -1,9 +1,9 @@
 "use client";
 import {
   createCompositeStore
-} from "../__chunks/OGMLJYDV.js";
-import "../__chunks/CCU5UHQ2.js";
-import "../__chunks/E7OQVGGY.js";
+} from "../__chunks/CTZ2GQIZ.js";
+import "../__chunks/HMQYEBKF.js";
+import "../__chunks/A2J4XZ5T.js";
 import "../__chunks/I2VQ3XGR.js";
 import "../__chunks/DLOEKDPY.js";
 import "../__chunks/7PRQYBBV.js";

package/esm/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/esm/dialog/dialog-store.js

@@ -1,9 +1,9 @@
 "use client";
 import {
   createDialogStore
-} from "../__chunks/CL47ZAPY.js";
-import "../__chunks/DYD4YNLE.js";
-import "../__chunks/E7OQVGGY.js";
+} from "../__chunks/LT2OYWRD.js";
+import "../__chunks/NKLTHWCR.js";
+import "../__chunks/A2J4XZ5T.js";
 import "../__chunks/I2VQ3XGR.js";
 import "../__chunks/4R3V3JGP.js";
 export {

package/esm/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/esm/disclosure/disclosure-store.js

@@ -1,8 +1,8 @@
 "use client";
 import {
   createDisclosureStore
-} from "../__chunks/DYD4YNLE.js";
-import "../__chunks/E7OQVGGY.js";
+} from "../__chunks/NKLTHWCR.js";
+import "../__chunks/A2J4XZ5T.js";
 import "../__chunks/I2VQ3XGR.js";
 import "../__chunks/4R3V3JGP.js";
 export {

package/esm/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/esm/form/form-store.js

@@ -1,13 +1,13 @@
 "use client";
 import {
   createCollectionStore
-} from "../__chunks/CCU5UHQ2.js";
+} from "../__chunks/HMQYEBKF.js";
 import {
   createStore,
   init,
   setup,
   throwOnConflictingProps
-} from "../__chunks/E7OQVGGY.js";
+} from "../__chunks/A2J4XZ5T.js";
 import {
   applyState,
   defaultValue,

package/esm/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/esm/hovercard/hovercard-store.js

@@ -1,11 +1,11 @@
 "use client";
 import {
   createHovercardStore
-} from "../__chunks/BXH3I7ML.js";
-import "../__chunks/WY3EMTH6.js";
-import "../__chunks/CL47ZAPY.js";
-import "../__chunks/DYD4YNLE.js";
-import "../__chunks/E7OQVGGY.js";
+} from "../__chunks/T3DVYGXI.js";
+import "../__chunks/J6JIOWCS.js";
+import "../__chunks/LT2OYWRD.js";
+import "../__chunks/NKLTHWCR.js";
+import "../__chunks/A2J4XZ5T.js";
 import "../__chunks/I2VQ3XGR.js";
 import "../__chunks/4R3V3JGP.js";
 export {