@ariakit/components 0.1.0

package/dist/form/form-store.js

@@ -0,0 +1,211 @@
+import { createCollectionStore } from "../collection/collection-store.js";
+import { createStore, init, setup, sync, throwOnConflictingProps } from "@ariakit/store";
+import { applyState, defaultValue, isInteger, isObject } from "@ariakit/utils";
+//#region src/form/form-store.ts
+function nextFrame() {
+	return new Promise((resolve) => requestAnimationFrame(() => resolve()));
+}
+function hasMessages(object) {
+	return Object.keys(object).some((key) => {
+		if (isObject(object[key])) return hasMessages(object[key]);
+		return !!object[key];
+	});
+}
+function get(values, path, defaultValue) {
+	const [key, ...rest] = Array.isArray(path) ? path : String(path).split(".");
+	if (key == null || !values) return defaultValue;
+	if (!rest.length) return values[key] ?? defaultValue;
+	return get(values[key], rest, defaultValue);
+}
+function getOrCreateNested(nestedValues, nextKey) {
+	if (Array.isArray(nestedValues) || isObject(nestedValues)) return nestedValues;
+	return isInteger(nextKey) ? [] : {};
+}
+function set(values, path, value) {
+	const [k, ...rest] = Array.isArray(path) ? path : String(path).split(".");
+	if (k == null) return values;
+	const key = k;
+	const isIntegerKey = isInteger(key);
+	const nestedValues = (isIntegerKey ? values || [] : values || {})[key];
+	const nextKey = rest[0];
+	const result = rest.length && nextKey != null ? set(getOrCreateNested(nestedValues, nextKey), rest, value) : value;
+	if (isIntegerKey) {
+		const index = Number(key);
+		if (values && Array.isArray(values)) {
+			const copy = [...values];
+			copy[index] = result;
+			return copy;
+		}
+		const nextValues = [];
+		nextValues[index] = result;
+		return nextValues;
+	}
+	return Object.assign({}, values, { [key]: result });
+}
+function setAll(values, value) {
+	const result = {};
+	const keys = Object.keys(values);
+	for (const key of keys) {
+		const currentValue = values[key];
+		if (Array.isArray(currentValue)) result[key] = currentValue.map((v) => {
+			if (isObject(v)) return setAll(v, value);
+			return value;
+		});
+		else if (isObject(currentValue)) result[key] = setAll(currentValue, value);
+		else result[key] = value;
+	}
+	return result;
+}
+function getNameHandler(cache, prevKeys = []) {
+	return { get(target, key) {
+		if ([
+			"toString",
+			"valueOf",
+			Symbol.toPrimitive
+		].includes(key)) return () => prevKeys.join(".");
+		const nextKeys = [...prevKeys, key];
+		const nextKey = nextKeys.join(".");
+		if (cache[nextKey]) return cache[nextKey];
+		const nextProxy = new Proxy(target, getNameHandler(cache, nextKeys));
+		cache[nextKey] = nextProxy;
+		return nextProxy;
+	} };
+}
+function getStoreCallbacks(store) {
+	return store?.__unstableCallbacks;
+}
+function createNames() {
+	return new Proxy(Object.create(null), getNameHandler(Object.create(null)));
+}
+function createFormStore(props = {}) {
+	throwOnConflictingProps(props, props.store);
+	const syncState = props.store?.getState();
+	const collection = createCollectionStore(props);
+	const values = defaultValue(props.values, syncState?.values, props.defaultValues, {});
+	const errors = defaultValue(props.errors, syncState?.errors, props.defaultErrors, {});
+	const touched = defaultValue(props.touched, syncState?.touched, props.defaultTouched, {});
+	const form = createStore({
+		...collection.getState(),
+		values,
+		errors,
+		touched,
+		validating: defaultValue(syncState?.validating, false),
+		submitting: defaultValue(syncState?.submitting, false),
+		submitSucceed: defaultValue(syncState?.submitSucceed, 0),
+		submitFailed: defaultValue(syncState?.submitFailed, 0),
+		valid: !hasMessages(errors)
+	}, collection, props.store);
+	const syncCallbacks = getStoreCallbacks(props.store);
+	const syncCallbacksState = syncCallbacks?.getState();
+	const callbacks = createStore({
+		validate: syncCallbacksState?.validate || [],
+		submit: syncCallbacksState?.submit || []
+	}, syncCallbacks);
+	setup(form, () => init(callbacks));
+	setup(form, () => sync(form, ["validating", "errors"], (state) => {
+		if (state.validating) return;
+		form.setState("valid", !hasMessages(state.errors));
+	}));
+	const validate = async () => {
+		form.setState("validating", true);
+		form.setState("errors", {});
+		const validateCallbacks = callbacks.getState().validate;
+		try {
+			for (const callback of validateCallbacks) await callback(form.getState());
+			await nextFrame();
+			return !hasMessages(form.getState().errors);
+		} finally {
+			form.setState("validating", false);
+		}
+	};
+	return {
+		...collection,
+		...form,
+		names: createNames(),
+		setValues: (values) => form.setState("values", values),
+		getValue: (name) => get(form.getState().values, name),
+		setValue: (name, value) => form.setState("values", (values) => {
+			const prevValue = get(values, name);
+			const nextValue = applyState(value, prevValue);
+			if (nextValue === prevValue) return values;
+			return set(values, name, nextValue);
+		}),
+		pushValue: (name, value) => form.setState("values", (values) => {
+			return set(values, name, [...get(values, name, []), value]);
+		}),
+		removeValue: (name, index) => form.setState("values", (values) => {
+			const array = get(values, name, []);
+			return set(values, name, [
+				...array.slice(0, index),
+				null,
+				...array.slice(index + 1)
+			]);
+		}),
+		setErrors: (errors) => form.setState("errors", errors),
+		getError: (name) => get(form.getState().errors, name),
+		setError: (name, error) => form.setState("errors", (errors) => {
+			const prevError = get(errors, name);
+			const nextError = applyState(error, prevError);
+			if (nextError === prevError) return errors;
+			return set(errors, name, nextError);
+		}),
+		setTouched: (touched) => form.setState("touched", touched),
+		getFieldTouched: (name) => !!get(form.getState().touched, name),
+		setFieldTouched: (name, value) => form.setState("touched", (touched) => {
+			const prevValue = get(touched, name);
+			const nextValue = applyState(value, prevValue);
+			if (nextValue === prevValue) return touched;
+			return set(touched, name, nextValue);
+		}),
+		onValidate: (callback) => {
+			callbacks.setState("validate", (callbacks) => [...callbacks, callback]);
+			return () => {
+				callbacks.setState("validate", (callbacks) => callbacks.filter((c) => c !== callback));
+			};
+		},
+		validate,
+		onSubmit: (callback) => {
+			callbacks.setState("submit", (callbacks) => [...callbacks, callback]);
+			return () => {
+				callbacks.setState("submit", (callbacks) => callbacks.filter((c) => c !== callback));
+			};
+		},
+		submit: async () => {
+			form.setState("submitting", true);
+			form.setState("touched", setAll(form.getState().values, true));
+			try {
+				if (await validate()) {
+					const submitCallbacks = callbacks.getState().submit;
+					for (const callback of submitCallbacks) await callback(form.getState());
+					await nextFrame();
+					if (!hasMessages(form.getState().errors)) {
+						form.setState("submitSucceed", (count) => count + 1);
+						return true;
+					}
+				}
+				form.setState("submitFailed", (count) => count + 1);
+				return false;
+			} catch (error) {
+				form.setState("submitFailed", (count) => count + 1);
+				throw error;
+			} finally {
+				form.setState("submitting", false);
+			}
+		},
+		reset: () => {
+			form.setState("values", values);
+			form.setState("errors", errors);
+			form.setState("touched", touched);
+			form.setState("validating", false);
+			form.setState("submitting", false);
+			form.setState("submitSucceed", 0);
+			form.setState("submitFailed", 0);
+			form.setState("valid", !hasMessages(errors));
+		},
+		__unstableCallbacks: callbacks
+	};
+}
+//#endregion
+export { createFormStore, get, hasMessages };
+
+//# sourceMappingURL=form-store.js.map

package/dist/form/form-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"form-store.js","names":[],"sources":["../../src/form/form-store.ts"],"sourcesContent":["import {\n  createStore,\n  init,\n  setup,\n  sync,\n  throwOnConflictingProps,\n} from \"@ariakit/store\";\nimport type { Store, StoreOptions, StoreProps } from \"@ariakit/store\";\nimport { applyState, defaultValue, isInteger, isObject } from \"@ariakit/utils\";\nimport type {\n  AnyObject,\n  PickRequired,\n  SetState,\n  SetStateAction,\n} from \"@ariakit/utils\";\nimport type {\n  CollectionStoreFunctions,\n  CollectionStoreItem,\n  CollectionStoreOptions,\n  CollectionStoreState,\n} from \"../collection/collection-store.ts\";\nimport { createCollectionStore } from \"../collection/collection-store.ts\";\nimport type { DeepMap, DeepPartial, Names, StringLike } from \"./types.ts\";\n\ntype ErrorMessage = string | undefined | null;\n\nfunction nextFrame() {\n  return new Promise<void>((resolve) => requestAnimationFrame(() => resolve()));\n}\n\nexport function hasMessages(object: FormStoreValues): boolean {\n  return Object.keys(object).some((key) => {\n    if (isObject(object[key])) {\n      return hasMessages(object[key]);\n    }\n    return !!object[key];\n  });\n}\n\nexport function get<T>(\n  values: FormStoreValues,\n  path: StringLike | string[],\n  defaultValue?: T,\n): T {\n  const [key, ...rest] = Array.isArray(path) ? path : String(path).split(\".\");\n  if (key == null || !values) {\n    return defaultValue as T;\n  }\n  if (!rest.length) {\n    return values[key] ?? defaultValue;\n  }\n  return get(values[key], rest, defaultValue);\n}\n\n// Returns the existing nested value if it is an array or object, otherwise\n// creates a new container based on whether the next key is an integer.\nfunction getOrCreateNested(nestedValues: unknown, nextKey: string) {\n  if (Array.isArray(nestedValues) || isObject(nestedValues)) {\n    return nestedValues;\n  }\n  return isInteger(nextKey) ? [] : {};\n}\n\nfunction set<T extends FormStoreValues | unknown[]>(\n  values: T,\n  path: StringLike | string[],\n  value: unknown,\n): T {\n  const [k, ...rest] = Array.isArray(path) ? path : String(path).split(\".\");\n  if (k == null) return values;\n  const key = k as keyof T;\n  const isIntegerKey = isInteger(key);\n  const nextValues = isIntegerKey ? values || [] : values || {};\n  const nestedValues = nextValues[key];\n  const nextKey = rest[0];\n  const result =\n    rest.length && nextKey != null\n      ? set(getOrCreateNested(nestedValues, nextKey), rest, value)\n      : value;\n  if (isIntegerKey) {\n    const index = Number(key);\n    if (values && Array.isArray(values)) {\n      const copy = [...values];\n      copy[index] = result;\n      return copy as T;\n    }\n    const nextValues = [] as unknown as T;\n    nextValues[index as keyof T] = result as T[keyof T];\n    return nextValues;\n  }\n  return Object.assign({}, values, { [key]: result });\n}\n\nfunction setAll<T extends FormStoreValues, V>(values: T, value: V) {\n  const result = {} as FormStoreValues;\n  const keys = Object.keys(values);\n  for (const key of keys) {\n    const currentValue = values[key];\n    if (Array.isArray(currentValue)) {\n      result[key] = currentValue.map((v) => {\n        if (isObject(v)) {\n          return setAll(v, value);\n        }\n        return value;\n      });\n    } else if (isObject(currentValue)) {\n      result[key] = setAll(currentValue, value);\n    } else {\n      result[key] = value;\n    }\n  }\n  return result as DeepMap<T, V>;\n}\n\nfunction getNameHandler(\n  cache: FormStoreValues,\n  prevKeys: Array<string | symbol> = [],\n) {\n  const handler: ProxyHandler<FormStoreValues> = {\n    get(target, key) {\n      if ([\"toString\", \"valueOf\", Symbol.toPrimitive].includes(key)) {\n        return () => prevKeys.join(\".\");\n      }\n      const nextKeys = [...prevKeys, key];\n      const nextKey = nextKeys.join(\".\");\n      if (cache[nextKey]) {\n        return cache[nextKey];\n      }\n      const nextProxy = new Proxy(target, getNameHandler(cache, nextKeys));\n      cache[nextKey] = nextProxy;\n      return nextProxy;\n    },\n  };\n  return handler;\n}\n\nfunction getStoreCallbacks(\n  store?: Store & {\n    __unstableCallbacks?: Store<{\n      validate: FormStoreCallback[];\n      submit: FormStoreCallback[];\n    }>;\n  },\n) {\n  return store?.__unstableCallbacks;\n}\n\nfunction createNames() {\n  const cache = Object.create(null);\n  return new Proxy(Object.create(null), getNameHandler(cache));\n}\n\n/**\n * Creates a form store.\n */\nexport function createFormStore<T extends FormStoreValues = FormStoreValues>(\n  props: PickRequired<\n    FormStoreProps<T>,\n    | \"values\"\n    | \"defaultValues\"\n    | \"errors\"\n    | \"defaultErrors\"\n    | \"touched\"\n    | \"defaultTouched\"\n  >,\n): FormStore<T>;\n\nexport function createFormStore(props: FormStoreProps): FormStore;\n\nexport function createFormStore(props: FormStoreProps = {}): FormStore {\n  throwOnConflictingProps(props, props.store);\n\n  const syncState = props.store?.getState();\n  const collection = createCollectionStore(props);\n\n  const values = defaultValue(\n    props.values,\n    syncState?.values,\n    props.defaultValues,\n    {},\n  );\n\n  const errors = defaultValue(\n    props.errors,\n    syncState?.errors,\n    props.defaultErrors,\n    {},\n  );\n\n  const touched = defaultValue(\n    props.touched,\n    syncState?.touched,\n    props.defaultTouched,\n    {},\n  );\n\n  const initialState: FormStoreState = {\n    ...collection.getState(),\n    values,\n    errors,\n    touched,\n    validating: defaultValue(syncState?.validating, false),\n    submitting: defaultValue(syncState?.submitting, false),\n    submitSucceed: defaultValue(syncState?.submitSucceed, 0),\n    submitFailed: defaultValue(syncState?.submitFailed, 0),\n    valid: !hasMessages(errors),\n  };\n  const form = createStore(initialState, collection, props.store);\n\n  const syncCallbacks = getStoreCallbacks(props.store);\n  const syncCallbacksState = syncCallbacks?.getState();\n\n  const callbacksInitialState = {\n    validate: syncCallbacksState?.validate || [],\n    submit: syncCallbacksState?.submit || [],\n  };\n\n  const callbacks = createStore(callbacksInitialState, syncCallbacks);\n\n  setup(form, () => init(callbacks));\n\n  setup(form, () =>\n    sync(form, [\"validating\", \"errors\"], (state) => {\n      if (state.validating) return;\n      form.setState(\"valid\", !hasMessages(state.errors));\n    }),\n  );\n\n  const validate = async () => {\n    form.setState(\"validating\", true);\n    form.setState(\"errors\", {});\n    const validateCallbacks = callbacks.getState().validate;\n    try {\n      // Run all the validation callbacks sequentially so they run in a\n      // predictable order. See https://github.com/ariakit/ariakit/issues/2282\n      for (const callback of validateCallbacks) {\n        await callback(form.getState());\n      }\n      // Wait for the next frame to allow the errors to be set on the state.\n      await nextFrame();\n      return !hasMessages(form.getState().errors);\n    } finally {\n      form.setState(\"validating\", false);\n    }\n  };\n\n  return {\n    ...collection,\n    ...form,\n    names: createNames(),\n\n    setValues: (values) => form.setState(\"values\", values),\n    getValue: (name) => get(form.getState().values, name),\n    setValue: (name, value) =>\n      form.setState(\"values\", (values) => {\n        const prevValue = get(values, name);\n        const nextValue = applyState(value, prevValue);\n        if (nextValue === prevValue) return values;\n        return set(values, name, nextValue);\n      }),\n    pushValue: (name, value) =>\n      form.setState(\"values\", (values) => {\n        const array = get(values, name, [] as unknown[]);\n        return set(values, name, [...array, value]);\n      }),\n    removeValue: (name, index) =>\n      form.setState(\"values\", (values) => {\n        const array = get(values, name, [] as unknown[]);\n        return set(values, name, [\n          ...array.slice(0, index),\n          null,\n          ...array.slice(index + 1),\n        ]);\n      }),\n\n    setErrors: (errors) => form.setState(\"errors\", errors),\n    getError: (name) => get(form.getState().errors, name),\n    setError: (name, error) =>\n      form.setState(\"errors\", (errors) => {\n        const prevError = get(errors, name);\n        const nextError = applyState(error, prevError);\n        if (nextError === prevError) return errors;\n        return set(errors, name, nextError);\n      }),\n\n    setTouched: (touched) => form.setState(\"touched\", touched),\n    getFieldTouched: (name) => !!get(form.getState().touched, name),\n    setFieldTouched: (name, value) =>\n      form.setState(\"touched\", (touched) => {\n        const prevValue = get(touched, name);\n        const nextValue = applyState(value, prevValue);\n        if (nextValue === prevValue) return touched;\n        return set(touched, name, nextValue);\n      }),\n\n    onValidate: (callback) => {\n      callbacks.setState(\"validate\", (callbacks) => [...callbacks, callback]);\n      return () => {\n        callbacks.setState(\"validate\", (callbacks) =>\n          callbacks.filter((c) => c !== callback),\n        );\n      };\n    },\n    validate,\n\n    onSubmit: (callback) => {\n      callbacks.setState(\"submit\", (callbacks) => [...callbacks, callback]);\n      return () => {\n        callbacks.setState(\"submit\", (callbacks) =>\n          callbacks.filter((c) => c !== callback),\n        );\n      };\n    },\n    submit: async () => {\n      form.setState(\"submitting\", true);\n      form.setState(\"touched\", setAll(form.getState().values, true));\n      try {\n        if (await validate()) {\n          const submitCallbacks = callbacks.getState().submit;\n          // Run all the submit callbacks sequentially so they run in a\n          // predictable order. See\n          // https://github.com/ariakit/ariakit/issues/2282\n          for (const callback of submitCallbacks) {\n            await callback(form.getState());\n          }\n          // Wait for the next frame to allow the errors to be set on the state.\n          await nextFrame();\n          if (!hasMessages(form.getState().errors)) {\n            form.setState(\"submitSucceed\", (count) => count + 1);\n            return true;\n          }\n        }\n        form.setState(\"submitFailed\", (count) => count + 1);\n        return false;\n      } catch (error) {\n        form.setState(\"submitFailed\", (count) => count + 1);\n        throw error;\n      } finally {\n        form.setState(\"submitting\", false);\n      }\n    },\n\n    reset: () => {\n      form.setState(\"values\", values);\n      form.setState(\"errors\", errors);\n      form.setState(\"touched\", touched);\n      form.setState(\"validating\", false);\n      form.setState(\"submitting\", false);\n      form.setState(\"submitSucceed\", 0);\n      form.setState(\"submitFailed\", 0);\n      form.setState(\"valid\", !hasMessages(errors));\n    },\n\n    // @ts-expect-error Internal\n    __unstableCallbacks: callbacks,\n  };\n}\n\nexport type FormStoreCallback<T extends FormStoreState = FormStoreState> = (\n  state: T,\n) => void | Promise<void>;\n\nexport type FormStoreValues = AnyObject;\n\nexport interface FormStoreItem extends CollectionStoreItem {\n  type: \"field\" | \"label\" | \"description\" | \"error\" | \"button\";\n  name: string;\n}\n\nexport interface FormStoreState<\n  T extends FormStoreValues = FormStoreValues,\n> extends CollectionStoreState<FormStoreItem> {\n  /**\n   * Form values.\n   *\n   * Live examples:\n   * - [FormRadio](https://ariakit.com/examples/form-radio)\n   * - [FormSelect](https://ariakit.com/examples/form-select)\n   * @default {}\n   */\n  values: T;\n  /**\n   * Form errors.\n   */\n  errors: DeepPartial<DeepMap<T, ErrorMessage>>;\n  /**\n   * The touched state of the form.\n   */\n  touched: DeepPartial<DeepMap<T, boolean>>;\n  /**\n   * Whether the form is valid.\n   */\n  valid: boolean;\n  /**\n   * Whether the form is validating.\n   */\n  validating: boolean;\n  /**\n   * Whether the form is submitting.\n   */\n  submitting: boolean;\n  /**\n   * The number of times\n   * [`submit`](https://ariakit.com/reference/use-form-store#submit) has been\n   * called with a successful response.\n   */\n  submitSucceed: number;\n  /**\n   * The number of times\n   * [`submit`](https://ariakit.com/reference/use-form-store#submit) has been\n   * called with an error response.\n   */\n  submitFailed: number;\n}\n\nexport interface FormStoreFunctions<\n  T extends FormStoreValues = FormStoreValues,\n> extends CollectionStoreFunctions<FormStoreItem> {\n  /**\n   * An object containing the names of the form fields for type safety.\n   *\n   * Live examples:\n   * - [FormRadio](https://ariakit.com/examples/form-radio)\n   * - [FormSelect](https://ariakit.com/examples/form-select)\n   * @example\n   * store.names.name; // \"name\"\n   * store.names.name.first; // \"name.first\"\n   * store.names.name.last; // \"name.last\"\n   */\n  names: Names<T>;\n  /**\n   * Sets the [`values`](https://ariakit.com/reference/form-provider#values)\n   * state.\n   * @example\n   * store.setValues({ name: \"John\" });\n   * store.setValues((values) => ({ ...values, name: \"John\" }));\n   */\n  setValues: SetState<FormStoreState<T>[\"values\"]>;\n  /**\n   * Retrieves a field value.\n   *\n   * Live examples:\n   * - [FormRadio](https://ariakit.com/examples/form-radio)\n   * @example\n   * const nameValue = store.getValue(\"name\");\n   * // Can also use store.names for type-safety.\n   * const emailValue = store.getValue(store.names.email);\n   */\n  // oxlint-disable-next-line no-unnecessary-type-parameters\n  getValue: <T = any>(name: StringLike) => T;\n  /**\n   * Sets a field value.\n   *\n   * Live examples:\n   * - [FormSelect](https://ariakit.com/examples/form-select)\n   * @example\n   * store.setValue(\"name\", \"John\");\n   * store.setValue(\"name\", (value) => value + \" Doe\");\n   * // Can also use store.names for type-safety.\n   * store.setValue(store.names.name, \"John\");\n   */\n  setValue: <T>(name: StringLike, value: SetStateAction<T>) => void;\n  /**\n   * Pushes a value to an array field.\n   * @example\n   * store.pushValue(\"tags\", \"new tag\");\n   * store.pushValue(\"tags\", { id: 1, name: \"new tag\" });\n   * // Can also use store.names for type-safety.\n   * store.pushValue(store.names.tags, \"new tag\");\n   */\n  // oxlint-disable-next-line no-unnecessary-type-parameters\n  pushValue: <T>(name: StringLike, value: T) => void;\n  /**\n   * Removes a value from an array field.\n   * @example\n   * store.removeValue(\"tags\", 0);\n   * store.removeValue(\"tags\", 1);\n   * // Can also use store.names for type-safety.\n   * store.removeValue(store.names.tags, 0);\n   */\n  removeValue: (name: StringLike, index: number) => void;\n  /**\n   * Sets the [`errors`](https://ariakit.com/reference/form-provider#errors)\n   * state.\n   * @example\n   * store.setErrors({ name: \"Name is required\" });\n   * store.setErrors((errors) => ({ ...errors, name: \"Name is required\" }));\n   */\n  setErrors: SetState<FormStoreState<T>[\"errors\"]>;\n  /**\n   * Retrieves a field error.\n   * @example\n   * const nameError = store.getError(\"name\");\n   * // Can also use store.names for type-safety.\n   * const emailError = store.getError(store.names.email);\n   */\n  getError: (name: StringLike) => ErrorMessage;\n  /**\n   * Sets a field error.\n   *\n   * Live examples:\n   * - [FormRadio](https://ariakit.com/examples/form-radio)\n   * @example\n   * store.setError(\"name\", \"Name is required\");\n   * store.setError(\"name\", (error) => error + \"!\");\n   * // Can also use store.names for type-safety.\n   * store.setError(store.names.name, \"Name is required\");\n   */\n  setError: (name: StringLike, error: SetStateAction<ErrorMessage>) => void;\n  /**\n   * Sets the [`touched`](https://ariakit.com/reference/form-provider#touched)\n   * state.\n   * @example\n   * store.setTouched({ name: true });\n   * store.setTouched((touched) => ({ ...touched, name: true }));\n   */\n  setTouched: SetState<FormStoreState<T>[\"touched\"]>;\n  /**\n   * Retrieves a field touched state.\n   * @example\n   * const nameTouched = store.getFieldTouched(\"name\");\n   * // Can also use store.names for type-safety.\n   * const emailTouched = store.getFieldTouched(store.names.email);\n   */\n  getFieldTouched: (name: StringLike) => boolean;\n  /**\n   * Sets a field touched state.\n   * @example\n   * store.setFieldTouched(\"name\", true);\n   * store.setFieldTouched(\"name\", (value) => !value);\n   * // Can also use store.names for type-safety.\n   * store.setFieldTouched(store.names.name, true);\n   */\n  setFieldTouched: (name: StringLike, value: SetStateAction<boolean>) => void;\n  /**\n   * Function that accepts a callback that will be used to validate the form\n   * when [`validate`](https://ariakit.com/reference/use-form-store#validate) is\n   * called. It returns a cleanup function that will remove the callback.\n   * @example\n   * const cleanup = store.onValidate(async (state) => {\n   *   const errors = await api.validate(state.values);\n   *   if (errors) {\n   *     store.setErrors(errors);\n   *   }\n   * });\n   */\n  onValidate: (callback: FormStoreCallback<FormStoreState<T>>) => () => void;\n  /**\n   * Function that accepts a callback that will be used to submit the form when\n   * [`submit`](https://ariakit.com/reference/use-form-store#submit) is called.\n   * It returns a cleanup function that will remove the callback.\n   * @param callback The callback function.\n   * @example\n   * const cleanup = store.onSubmit(async (state) => {\n   *   try {\n   *     await api.submit(state.values);\n   *   } catch (errors) {\n   *     store.setErrors(errors);\n   *   }\n   * });\n   */\n  onSubmit: (callback: FormStoreCallback<FormStoreState<T>>) => () => void;\n  /**\n   * Validates the form.\n   * @example\n   * if (await store.validate()) {\n   *  // Form is valid.\n   * }\n   */\n  validate: () => Promise<boolean>;\n  /**\n   * Submits the form. This also triggers validation.\n   * @example\n   * if (await form.submit()) {\n   *   // Form is submitted.\n   * }\n   */\n  submit: () => Promise<boolean>;\n  /**\n   * Resets the form to its default values.\n   */\n  reset: () => void;\n}\n\nexport interface FormStoreOptions<T extends FormStoreValues = FormStoreValues>\n  extends\n    CollectionStoreOptions<FormStoreItem>,\n    StoreOptions<FormStoreState<T>, \"values\" | \"errors\" | \"touched\"> {\n  /**\n   * The default values of the form.\n   * @default {}\n   */\n  defaultValues?: FormStoreState<T>[\"values\"];\n  /**\n   * The default errors of the form.\n   */\n  defaultErrors?: FormStoreState<T>[\"errors\"];\n  /**\n   * The default touched state of the form.\n   */\n  defaultTouched?: FormStoreState<T>[\"touched\"];\n}\n\nexport interface FormStoreProps<T extends FormStoreValues = FormStoreValues>\n  extends FormStoreOptions<T>, StoreProps<FormStoreState<T>> {}\n\nexport interface FormStore<T extends FormStoreValues = FormStoreValues>\n  extends FormStoreFunctions<T>, Store<FormStoreState<T>> {}\n"],"mappings":"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"}

package/dist/form/types.d.ts

@@ -0,0 +1,37 @@
+import { AnyObject } from "@ariakit/utils";
+
+//#region src/form/types.d.ts
+/**
+ * An object or primitive value that can be converted to a string.
+ */
+interface StringLike {
+  toString: () => string;
+  valueOf: () => string;
+}
+/**
+ * Maps through an object `T` or array and defines the leaf values to the given
+ * type `V`.
+ * @template T Object
+ * @template V Value
+ */
+type DeepMap<T, V> = { [K in keyof T]: T[K] extends AnyObject ? DeepMap<T[K], V> : V };
+/**
+ * Similar to `Partial<T>`, but recursively maps through the object and makes
+ * nested object properties optional.
+ * @template T Object
+ */
+type DeepPartial<T> = { [K in keyof T]?: T[K] extends AnyObject ? DeepPartial<T[K]> : T[K] };
+/**
+ * Maps through the values object `T` and defines all properties into a string
+ * like type. That is, a type that is an object that can contain other
+ * properties but can also be converted into a string with the path name.
+ * @template T Values object
+ */
+type Names<T> = { [K in keyof T]: T[K] extends Array<infer U> ? U extends AnyObject ? {
+  [key: number]: Names<U>;
+} & StringLike : {
+  [key: number]: U & StringLike;
+} & StringLike : T[K] extends AnyObject ? Names<T[K]> : StringLike };
+//#endregion
+export { DeepMap, DeepPartial, Names, StringLike };
+//# sourceMappingURL=types.d.ts.map

package/dist/form/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","names":["AnyObject","StringLike","toString","valueOf","DeepMap","T","V","K","DeepPartial","Names","Array","U","key"],"sources":["../../src/form/types.d.ts"],"mappings":";;;;;AAIA;UAAiBC,UAAAA;EACbC,QAAAA;EACAC,OAAO;AAAA;AAQX;;;;;;AAAA,KAAYC,OAAAA,uBACIC,CAAAA,GAAIA,CAAAA,CAAEE,CAAAA,UAAWP,SAAAA,GAAYI,OAAAA,CAAQC,CAAAA,CAAEE,CAAAA,GAAID,CAAAA,IAAKA,CAAAA;;;;;;KAOpDE,WAAAA,oBACIH,CAAAA,IAAKA,CAAAA,CAAEE,CAAAA,UAAWP,SAAAA,GAAYQ,WAAAA,CAAYH,CAAAA,CAAEE,CAAAA,KAAMF,CAAAA,CAAEE,CAAAA;;;;;;;KAQxDE,KAAAA,oBACIJ,CAAAA,GAAIA,CAAAA,CAAEE,CAAAA,UAAWG,KAAAA,YAAiBC,CAAAA,SAAUX,SAAAA;EAAAA,CACnDY,GAAAA,WAAcH,KAAAA,CAAME,CAAAA;AAAAA,IACrBV,UAAAA;EAAAA,CACCW,GAAAA,WAAcD,CAAAA,GAAIV,UAAAA;AAAAA,IACnBA,UAAAA,GAAaI,CAAAA,CAAEE,CAAAA,UAAWP,SAAAA,GAAYS,KAAAA,CAAMJ,CAAAA,CAAEE,CAAAA,KAAMN,UAAAA"}

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

@@ -0,0 +1,65 @@
+import { a as PopoverStoreState, n as PopoverStoreFunctions, r as PopoverStoreOptions } from "../popover-store-DoCiTmUQ.js";
+import { Store, StoreOptions, StoreProps } from "@ariakit/store";
+import { SetState } from "@ariakit/utils";
+
+//#region src/hovercard/hovercard-store.d.ts
+/**
+ * Creates a hovercard store.
+ */
+declare function createHovercardStore(props?: HovercardStoreProps): HovercardStore;
+interface HovercardStoreState extends PopoverStoreState {
+  /** @default "bottom" */
+  placement: PopoverStoreState["placement"];
+  /**
+   * The amount of time in milliseconds to wait before showing and hiding the
+   * popup. To control the delay for showing and hiding separately, use
+   * [`showTimeout`](https://ariakit.com/reference/hovercard-provider#showtimeout)
+   * and
+   * [`hideTimeout`](https://ariakit.com/reference/hovercard-provider#hidetimeout).
+   * @default 500
+   */
+  timeout: number;
+  /**
+   * The amount of time in milliseconds to wait before _showing_ the popup. It
+   * defaults to the value passed to
+   * [`timeout`](https://ariakit.com/reference/hovercard-provider#timeout).
+   *
+   * Live examples:
+   * - [Navigation Menubar](https://ariakit.com/examples/menubar-navigation)
+   * - [Submenu with
+   *   Combobox](https://ariakit.com/examples/menu-nested-combobox)
+   */
+  showTimeout?: number;
+  /**
+   * The amount of time in milliseconds to wait before _hiding_ the popup. It
+   * defaults to the value passed to
+   * [`timeout`](https://ariakit.com/reference/hovercard-provider#timeout).
+   *
+   * Live examples:
+   * - [Navigation Menubar](https://ariakit.com/examples/menubar-navigation)
+   * - [Tooltip with
+   *   Motion](https://ariakit.com/examples/tooltip-framer-motion)
+   */
+  hideTimeout?: number;
+  /**
+   * Whether the popup or an element inside it should be focused when it is
+   * shown.
+   * @default false
+   */
+  autoFocusOnShow: boolean;
+}
+interface HovercardStoreFunctions extends PopoverStoreFunctions {
+  /**
+   * Sets the `autoFocusOnShow` state.
+   *
+   * Live examples:
+   * - [Sliding Menu](https://ariakit.com/examples/menu-slide)
+   */
+  setAutoFocusOnShow: SetState<HovercardStoreState["autoFocusOnShow"]>;
+}
+interface HovercardStoreOptions extends StoreOptions<HovercardStoreState, "placement" | "timeout" | "showTimeout" | "hideTimeout">, PopoverStoreOptions {}
+interface HovercardStoreProps extends HovercardStoreOptions, StoreProps<HovercardStoreState> {}
+interface HovercardStore extends HovercardStoreFunctions, Store<HovercardStoreState> {}
+//#endregion
+export { HovercardStore, HovercardStoreFunctions, HovercardStoreOptions, HovercardStoreProps, HovercardStoreState, createHovercardStore };
+//# sourceMappingURL=hovercard-store.d.ts.map

package/dist/hovercard/hovercard-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hovercard-store.d.ts","names":["Store","StoreOptions","StoreProps","SetState","PopoverStoreFunctions","PopoverStoreOptions","PopoverStoreState","createHovercardStore","HovercardStoreProps","HovercardStore","props","HovercardStoreState","placement","timeout","showTimeout","hideTimeout","autoFocusOnShow","HovercardStoreFunctions","setAutoFocusOnShow","HovercardStoreOptions"],"sources":["../../src/hovercard/hovercard-store.d.ts"],"mappings":";;;;;;;AAMA;iBAAwBO,oBAAAA,CAAqBG,KAAAA,GAAQF,mBAAAA,GAAsBC,cAAc;AAAA,UACxEE,mBAAAA,SAA4BL,iBAAiB;EAD2B;EAGrFM,SAAAA,EAAWN,iBAAAA;EAH8BI;;;AAA4C;AACzF;;;;EAWIG,OAAAA;EATAD;;;;;;;AAqCe;AAEnB;;EAnBIE,WAAAA;EA0B6BH;;;;;;;;;;EAf7BI,WAAAA;EAiBaI;;;;;EAXbH,eAAAA;AAAAA;AAAAA,UAEaC,uBAAAA,SAAgCb,qBAAAA;EASFH;;;;AAA+G;AAE9J;EAJIiB,kBAAAA,EAAoBf,QAAAA,CAASQ,mBAAAA;AAAAA;AAAAA,UAEhBQ,qBAAAA,SAA8BlB,YAAAA,CAAaU,mBAAAA,4DAA+EN,mBAAAA;AAAAA,UAE1HG,mBAAAA,SAA4BW,qBAAAA,EAAuBjB,UAAAA,CAAWS,mBAAAA;AAAAA,UAE9DF,cAAAA,SAAuBQ,uBAAAA,EAAyBjB,KAAAA,CAAMW,mBAAAA"}

package/dist/hovercard/hovercard-store.js

@@ -0,0 +1,31 @@
+import { createPopoverStore } from "../popover/popover-store.js";
+import { createStore } from "@ariakit/store";
+import { defaultValue } from "@ariakit/utils";
+//#region src/hovercard/hovercard-store.ts
+/**
+* Creates a hovercard store.
+*/
+function createHovercardStore(props = {}) {
+	const syncState = props.store?.getState();
+	const popover = createPopoverStore({
+		...props,
+		placement: defaultValue(props.placement, syncState?.placement, "bottom")
+	});
+	const timeout = defaultValue(props.timeout, syncState?.timeout, 500);
+	const hovercard = createStore({
+		...popover.getState(),
+		timeout,
+		showTimeout: defaultValue(props.showTimeout, syncState?.showTimeout),
+		hideTimeout: defaultValue(props.hideTimeout, syncState?.hideTimeout),
+		autoFocusOnShow: defaultValue(syncState?.autoFocusOnShow, false)
+	}, popover, props.store);
+	return {
+		...popover,
+		...hovercard,
+		setAutoFocusOnShow: (value) => hovercard.setState("autoFocusOnShow", value)
+	};
+}
+//#endregion
+export { createHovercardStore };
+
+//# sourceMappingURL=hovercard-store.js.map

package/dist/hovercard/hovercard-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hovercard-store.js","names":[],"sources":["../../src/hovercard/hovercard-store.ts"],"sourcesContent":["import { createStore } from \"@ariakit/store\";\nimport type { Store, StoreOptions, StoreProps } from \"@ariakit/store\";\nimport { defaultValue } from \"@ariakit/utils\";\nimport type { SetState } from \"@ariakit/utils\";\nimport type {\n  PopoverStoreFunctions,\n  PopoverStoreOptions,\n  PopoverStoreState,\n} from \"../popover/popover-store.ts\";\nimport { createPopoverStore } from \"../popover/popover-store.ts\";\n\n/**\n * Creates a hovercard store.\n */\nexport function createHovercardStore(\n  props: HovercardStoreProps = {},\n): HovercardStore {\n  const syncState = props.store?.getState();\n\n  const popover = createPopoverStore({\n    ...props,\n    placement: defaultValue(\n      props.placement,\n      syncState?.placement,\n      \"bottom\" as const,\n    ),\n  });\n\n  const timeout = defaultValue(props.timeout, syncState?.timeout, 500);\n\n  const initialState: HovercardStoreState = {\n    ...popover.getState(),\n    timeout,\n    showTimeout: defaultValue(props.showTimeout, syncState?.showTimeout),\n    hideTimeout: defaultValue(props.hideTimeout, syncState?.hideTimeout),\n    autoFocusOnShow: defaultValue(syncState?.autoFocusOnShow, false),\n  };\n\n  const hovercard = createStore(initialState, popover, props.store);\n\n  return {\n    ...popover,\n    ...hovercard,\n    setAutoFocusOnShow: (value) => hovercard.setState(\"autoFocusOnShow\", value),\n  };\n}\n\nexport interface HovercardStoreState extends PopoverStoreState {\n  /** @default \"bottom\" */\n  placement: PopoverStoreState[\"placement\"];\n  /**\n   * The amount of time in milliseconds to wait before showing and hiding the\n   * popup. To control the delay for showing and hiding separately, use\n   * [`showTimeout`](https://ariakit.com/reference/hovercard-provider#showtimeout)\n   * and\n   * [`hideTimeout`](https://ariakit.com/reference/hovercard-provider#hidetimeout).\n   * @default 500\n   */\n  timeout: number;\n  /**\n   * The amount of time in milliseconds to wait before _showing_ the popup. It\n   * defaults to the value passed to\n   * [`timeout`](https://ariakit.com/reference/hovercard-provider#timeout).\n   *\n   * Live examples:\n   * - [Navigation Menubar](https://ariakit.com/examples/menubar-navigation)\n   * - [Submenu with\n   *   Combobox](https://ariakit.com/examples/menu-nested-combobox)\n   */\n  showTimeout?: number;\n  /**\n   * The amount of time in milliseconds to wait before _hiding_ the popup. It\n   * defaults to the value passed to\n   * [`timeout`](https://ariakit.com/reference/hovercard-provider#timeout).\n   *\n   * Live examples:\n   * - [Navigation Menubar](https://ariakit.com/examples/menubar-navigation)\n   * - [Tooltip with\n   *   Motion](https://ariakit.com/examples/tooltip-framer-motion)\n   */\n  hideTimeout?: number;\n  /**\n   * Whether the popup or an element inside it should be focused when it is\n   * shown.\n   * @default false\n   */\n  autoFocusOnShow: boolean;\n}\n\nexport interface HovercardStoreFunctions extends PopoverStoreFunctions {\n  /**\n   * Sets the `autoFocusOnShow` state.\n   *\n   * Live examples:\n   * - [Sliding Menu](https://ariakit.com/examples/menu-slide)\n   */\n  setAutoFocusOnShow: SetState<HovercardStoreState[\"autoFocusOnShow\"]>;\n}\n\nexport interface HovercardStoreOptions\n  extends\n    StoreOptions<\n      HovercardStoreState,\n      \"placement\" | \"timeout\" | \"showTimeout\" | \"hideTimeout\"\n    >,\n    PopoverStoreOptions {}\n\nexport interface HovercardStoreProps\n  extends HovercardStoreOptions, StoreProps<HovercardStoreState> {}\n\nexport interface HovercardStore\n  extends HovercardStoreFunctions, Store<HovercardStoreState> {}\n"],"mappings":";;;;;;;AAcA,SAAgB,qBACd,QAA6B,CAAC,GACd;CAChB,MAAM,YAAY,MAAM,OAAO,SAAS;CAExC,MAAM,UAAU,mBAAmB;EACjC,GAAG;EACH,WAAW,aACT,MAAM,WACN,WAAW,WACX,QACF;CACF,CAAC;CAED,MAAM,UAAU,aAAa,MAAM,SAAS,WAAW,SAAS,GAAG;CAUnE,MAAM,YAAY,YAAY;EAP5B,GAAG,QAAQ,SAAS;EACpB;EACA,aAAa,aAAa,MAAM,aAAa,WAAW,WAAW;EACnE,aAAa,aAAa,MAAM,aAAa,WAAW,WAAW;EACnE,iBAAiB,aAAa,WAAW,iBAAiB,KAAK;CAGxB,GAAG,SAAS,MAAM,KAAK;CAEhE,OAAO;EACL,GAAG;EACH,GAAG;EACH,qBAAqB,UAAU,UAAU,SAAS,mBAAmB,KAAK;CAC5E;AACF"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+//#region src/index.d.ts
+declare const _default: {};
+//#endregion
+export { _default as default };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":["_default","default"],"sources":["../src/index.d.ts"],"mappings":";cAAcA,QAAAA"}

package/dist/index.js

@@ -0,0 +1,6 @@
+//#region src/index.ts
+var src_default = {};
+//#endregion
+export { src_default as default };
+
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["export default {};\n"],"mappings":";AAAA,IAAA,cAAe,CAAC"}

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

@@ -0,0 +1,16 @@
+import { a as MenubarStoreState, n as MenubarStoreFunctions, r as MenubarStoreOptions } from "../menubar-store-CD3YDYfW.js";
+import { Store, StoreProps } from "@ariakit/store";
+
+//#region src/menu/menu-bar-store.d.ts
+/**
+ * Creates a menu bar store.
+ */
+declare function createMenuBarStore(props?: MenuBarStoreProps): MenuBarStore;
+interface MenuBarStoreState extends MenubarStoreState {}
+interface MenuBarStoreFunctions extends MenubarStoreFunctions {}
+interface MenuBarStoreOptions extends MenubarStoreOptions {}
+interface MenuBarStoreProps extends MenuBarStoreOptions, StoreProps<MenuBarStoreState> {}
+interface MenuBarStore extends MenuBarStoreFunctions, Store<MenuBarStoreState> {}
+//#endregion
+export { MenuBarStore, MenuBarStoreFunctions, MenuBarStoreOptions, MenuBarStoreProps, MenuBarStoreState, createMenuBarStore };
+//# sourceMappingURL=menu-bar-store.d.ts.map

package/dist/menu/menu-bar-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"menu-bar-store.d.ts","names":["Store","StoreProps","MenubarStoreFunctions","MenubarStoreOptions","MenubarStoreState","createMenuBarStore","MenuBarStoreProps","MenuBarStore","props","MenuBarStoreState","MenuBarStoreFunctions","MenuBarStoreOptions"],"sources":["../../src/menu/menu-bar-store.d.ts"],"mappings":";;;;;;AAKA;iBAAwBK,kBAAAA,CAAmBG,KAAAA,GAAQF,iBAAAA,GAAoBC,YAAY;AAAA,UAClEE,iBAAAA,SAA0BL,iBAAiB;AAAA,UAE3CM,qBAAAA,SAA8BR,qBAAqB;AAAA,UAEnDS,mBAAAA,SAA4BR,mBAAmB;AAAA,UAE/CG,iBAAAA,SAA0BK,mBAAAA,EAAqBV,UAAAA,CAAWQ,iBAAAA;AAAAA,UAE1DF,YAAAA,SAAqBG,qBAAAA,EAAuBV,KAAAA,CAAMS,iBAAAA"}

package/dist/menu/menu-bar-store.js

@@ -0,0 +1,12 @@
+import { createMenubarStore } from "../menubar/menubar-store.js";
+//#region src/menu/menu-bar-store.ts
+/**
+* Creates a menu bar store.
+*/
+function createMenuBarStore(props = {}) {
+	return createMenubarStore(props);
+}
+//#endregion
+export { createMenuBarStore };
+
+//# sourceMappingURL=menu-bar-store.js.map

package/dist/menu/menu-bar-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"menu-bar-store.js","names":[],"sources":["../../src/menu/menu-bar-store.ts"],"sourcesContent":["import type { Store, StoreProps } from \"@ariakit/store\";\nimport type {\n  MenubarStoreFunctions,\n  MenubarStoreOptions,\n  MenubarStoreState,\n} from \"../menubar/menubar-store.ts\";\nimport { createMenubarStore } from \"../menubar/menubar-store.ts\";\n\n/**\n * Creates a menu bar store.\n */\nexport function createMenuBarStore(\n  props: MenuBarStoreProps = {},\n): MenuBarStore {\n  return createMenubarStore(props);\n}\n\nexport interface MenuBarStoreState extends MenubarStoreState {}\n\nexport interface MenuBarStoreFunctions extends MenubarStoreFunctions {}\n\nexport interface MenuBarStoreOptions extends MenubarStoreOptions {}\n\nexport interface MenuBarStoreProps\n  extends MenuBarStoreOptions, StoreProps<MenuBarStoreState> {}\n\nexport interface MenuBarStore\n  extends MenuBarStoreFunctions, Store<MenuBarStoreState> {}\n"],"mappings":";;;;;AAWA,SAAgB,mBACd,QAA2B,CAAC,GACd;CACd,OAAO,mBAAmB,KAAK;AACjC"}

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

@@ -0,0 +1,100 @@
+import { i as CompositeStoreOptions, n as CompositeStoreFunctions, s as CompositeStoreState } from "../composite-store-B-iDEtZZ.js";
+import { ComboboxStore } from "../combobox/combobox-store.js";
+import { HovercardStoreFunctions, HovercardStoreOptions, HovercardStoreState } from "../hovercard/hovercard-store.js";
+import { MenuBarStore } from "./menu-bar-store.js";
+import { Store, StoreOptions, StoreProps } from "@ariakit/store";
+import { BivariantCallback, PickRequired, SetState, SetStateAction } from "@ariakit/utils";
+
+//#region src/menu/menu-store.d.ts
+declare function createMenuStore<T extends MenuStoreValues = MenuStoreValues>(props: PickRequired<MenuStoreProps<T>, "values" | "defaultValues">): MenuStore<T>;
+declare function createMenuStore(props?: MenuStoreProps): MenuStore;
+type MenuStoreValues = Record<string, string | boolean | number | ReadonlyArray<string | number>>;
+interface MenuStoreState<T extends MenuStoreValues = MenuStoreValues> extends CompositeStoreState, HovercardStoreState {
+  /** @default "vertical" */
+  orientation: CompositeStoreState["orientation"];
+  /** @default "bottom-start" */
+  placement: HovercardStoreState["placement"];
+  /** @default 0 */
+  hideTimeout?: HovercardStoreState["hideTimeout"];
+  /**
+   * Determines the element that should be focused when the menu is opened.
+   */
+  initialFocus: "container" | "first" | "last";
+  /**
+   * A map of names and values that will be used by the
+   * [`MenuItemCheckbox`](https://ariakit.com/reference/menu-item-checkbox) and
+   * [`MenuItemRadio`](https://ariakit.com/reference/menu-item-radio)
+   * components.
+   *
+   * Live examples:
+   * - [MenuItemCheckbox](https://ariakit.com/examples/menu-item-checkbox)
+   * - [Submenu with
+   *   Combobox](https://ariakit.com/examples/menu-nested-combobox)
+   */
+  values: T;
+}
+interface MenuStoreFunctions<T extends MenuStoreValues = MenuStoreValues> extends CompositeStoreFunctions, HovercardStoreFunctions, Pick<MenuStoreOptions, "combobox" | "parent" | "menubar"> {
+  /**
+   * Hides the menu and all its parent menus.
+   *
+   * Live examples:
+   * - [Submenu with
+   *   Combobox](https://ariakit.com/examples/menu-nested-combobox)
+   */
+  hideAll: () => void;
+  /**
+   * Sets the `initialFocus` state.
+   */
+  setInitialFocus: SetState<MenuStoreState<T>["initialFocus"]>;
+  /**
+   * Sets the [`values`](https://ariakit.com/reference/menu-provider#values)
+   * state.
+   * @example
+   * store.setValues({ watching: ["issues"] });
+   * store.setValues((values) => ({ ...values, watching: ["issues"] }));
+   */
+  setValues: SetState<MenuStoreState<T>["values"]>;
+  /**
+   * Sets a specific menu value.
+   *
+   * Live examples:
+   * - [Submenu with
+   *   Combobox](https://ariakit.com/examples/menu-nested-combobox)
+   * @example
+   * store.setValue("watching", ["issues"]);
+   * store.setValue("watching", (value) => [...value, "issues"]);
+   */
+  setValue: BivariantCallback<(name: string, value: SetStateAction<MenuStoreState<T>["values"][string]>) => void>;
+}
+interface MenuStoreOptions<T extends MenuStoreValues = MenuStoreValues> extends StoreOptions<MenuStoreState<T>, "orientation" | "placement" | "hideTimeout" | "values">, CompositeStoreOptions, HovercardStoreOptions {
+  /**
+   * 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
+   * share the same state.
+   */
+  combobox?: ComboboxStore | null;
+  /**
+   * A reference to a parent menu store. This is used on nested menus.
+   */
+  parent?: MenuStore | null;
+  /**
+   * A reference to a menubar store. This is used when rendering menus inside a
+   * menubar.
+   */
+  menubar?: MenuBarStore | null;
+  /**
+   * The default values for the
+   * [`values`](https://ariakit.com/reference/menu-provider#values) state.
+   *
+   * Live examples:
+   * - [MenuItemCheckbox](https://ariakit.com/examples/menu-item-checkbox)
+   * - [MenuItemRadio](https://ariakit.com/examples/menu-item-radio)
+   * @default {}
+   */
+  defaultValues?: MenuStoreState<T>["values"];
+}
+interface MenuStoreProps<T extends MenuStoreValues = MenuStoreValues> extends MenuStoreOptions<T>, StoreProps<MenuStoreState<T>> {}
+interface MenuStore<T extends MenuStoreValues = MenuStoreValues> extends MenuStoreFunctions<T>, Store<MenuStoreState<T>> {}
+//#endregion
+export { MenuStore, MenuStoreFunctions, MenuStoreOptions, MenuStoreProps, MenuStoreState, MenuStoreValues, createMenuStore };
+//# sourceMappingURL=menu-store.d.ts.map

package/dist/menu/menu-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"menu-store.d.ts","names":["Store","StoreOptions","StoreProps","BivariantCallback","PickRequired","SetState","SetStateAction","ComboboxStore","CompositeStoreFunctions","CompositeStoreOptions","CompositeStoreState","HovercardStoreFunctions","HovercardStoreOptions","HovercardStoreState","MenuBarStore","createMenuStore","T","MenuStoreValues","MenuStoreProps","MenuStore","props","ReadonlyArray","Record","MenuStoreState","orientation","placement","hideTimeout","initialFocus","values","MenuStoreFunctions","MenuStoreOptions","Pick","hideAll","setInitialFocus","setValues","setValue","name","value","combobox","parent","menubar","defaultValues"],"sources":["../../src/menu/menu-store.d.ts"],"mappings":";;;;;;;;iBAMwBe,eAAAA,WAA0BE,eAAAA,GAAkBA,eAAAA,CAAAA,CAAiBG,KAAAA,EAAOhB,YAAAA,CAAac,cAAAA,CAAeF,CAAAA,iCAAkCG,SAAAA,CAAUH,CAAAA;AAAAA,iBAC5ID,eAAAA,CAAgBK,KAAAA,GAAQF,cAAAA,GAAiBC,SAAS;AAAA,KAC9DF,eAAAA,GAAkBK,MAAM,qCAAqCD,aAAAA;AAAAA,UACxDE,cAAAA,WAAyBN,eAAAA,GAAkBA,eAAAA,UAAyBP,mBAAAA,EAAqBG,mBAAAA;EAHnEG;EAKnCQ,WAAAA,EAAad,mBAAAA;EALmDO;EAOhEQ,SAAAA,EAAWZ,mBAAAA;EAP0FK;EASrGQ,WAAAA,GAAcb,mBAAAA;EATkJG;;;EAahKW,YAAAA;EAboCX;;;;;;;;;;AAA6H;EAyBjKY,MAAAA,EAAQZ,CAAAA;AAAAA;AAAAA,UAEKa,kBAAAA,WAA6BZ,eAAAA,GAAkBA,eAAAA,UAAyBT,uBAAAA,EAAyBG,uBAAAA,EAAyBoB,IAAAA,CAAKD,gBAAAA;EA1BtE;;;;;AAAA;AAC1E;EAiCIE,OAAAA;;;AAjCkF;EAqClFC,eAAAA,EAAiB5B,QAAAA,CAASkB,cAAAA,CAAeP,CAAAA;EApCd;;;;;;;EA4C3BkB,SAAAA,EAAW7B,QAAAA,CAASkB,cAAAA,CAAeP,CAAAA;EA5C8CN;;;;;;;;;;EAuDjFyB,QAAAA,EAAUhC,iBAAAA,EAAmBiC,IAAAA,UAAcC,KAAAA,EAAO/B,cAAAA,CAAeiB,cAAAA,CAAeP,CAAAA;AAAAA;AAAAA,UAEnEc,gBAAAA,WAA2Bb,eAAAA,GAAkBA,eAAAA,UAAyBhB,YAAAA,CAAasB,cAAAA,CAAeP,CAAAA,4DAA6DP,qBAAAA,EAAuBG,qBAAAA;EAnDnMc;;;;;EAyDAY,QAAAA,GAAW/B,aAAAA;EAzCF;AAEb;;EA2CIgC,MAAAA,GAASpB,SAAAA;EA3CiCF;;;;EAgD1CuB,OAAAA,GAAU1B,YAAAA;EApCOT;;;;;;;;;EA8CjBoC,aAAAA,GAAgBlB,cAAAA,CAAeP,CAAAA;AAAAA;AAAAA,UAElBE,cAAAA,WAAyBD,eAAAA,GAAkBA,eAAAA,UAAyBa,gBAAAA,CAAiBd,CAAAA,GAAId,UAAAA,CAAWqB,cAAAA,CAAeP,CAAAA;AAAAA,UAEnHG,SAAAA,WAAoBF,eAAAA,GAAkBA,eAAAA,UAAyBY,kBAAAA,CAAmBb,CAAAA,GAAIhB,KAAAA,CAAMuB,cAAAA,CAAeP,CAAAA"}