formstand 0.16.0 → 0.18.0

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-import { P as PathDepth, D as DefaultPathDepth, F as Form, C as CreateFormOptions, a as FieldValidationResult, b as FormState, c as FieldPath, d as FieldValue, E as ErrorMap } from './createForm-jlzK2lCG.cjs';
-export { B as BoolMap, e as FieldSnapshot, f as FieldsValidationResult, I as InvalidSubmitHandler, R as ReadonlyStoreApi, g as ResetOptions, S as SettledFieldValidationResult, h as SettledFieldsValidationResult, i as SettledValidationResult, j as SubmitHandler, k as SubmitOptions, l as SubmitResult, V as ValidationMode, m as ValidationResult, n as ValidationTrigger, o as createForm, p as emptyValueForSchema, q as flattenIssues, r as isAsyncRequiredError, s as shouldValidateOn, v as validateAsync, t as validateSync } from './createForm-jlzK2lCG.cjs';
+import { P as PathDepth, D as DefaultPathDepth, F as Form, C as CreateFormOptions, a as FieldValidationResult, S as SettledFieldValidationResult, b as FormState, c as FieldPath, d as FieldValue, E as ErrorMap } from './createForm-B73p1TgL.cjs';
+export { B as BoolMap, e as FieldSnapshot, f as FieldsValidationResult, I as InvalidSubmitHandler, R as ReadonlyStoreApi, g as ResetOptions, h as SettledFieldsValidationResult, i as SettledValidationResult, j as SubmitHandler, k as SubmitOptions, l as SubmitResult, V as ValidationMode, m as ValidationResult, n as ValidationTrigger, o as createForm, p as emptyValueForSchema, q as flattenIssues, r as isAsyncRequiredError, s as isClearableSchema, t as shouldValidateOn, v as validateAsync, u as validateSync } from './createForm-B73p1TgL.cjs';
 import { z } from 'zod';
 import * as react from 'react';
 import { ReactNode, ChangeEvent } from 'react';
@@ -23,12 +23,14 @@ type PersistOptions<TSchema extends z.ZodType> = Readonly<{
     apply?: "adopt" | "restore" | "manual";
 }>;
 type PersistHandle = Readonly<{
-    restore: () => boolean;
+    load: () => boolean;
     clear: () => void;
     dispose: () => void;
 }>;
 declare const persistForm: <TSchema extends z.ZodType, D extends PathDepth = DefaultPathDepth>(form: Form<TSchema, D>, options: PersistOptions<TSchema>) => PersistHandle;
 
+declare const usePersistForm: <TSchema extends z.ZodType, D extends PathDepth = DefaultPathDepth>(form: Form<TSchema, D>, options: PersistOptions<TSchema>) => PersistHandle;
+
 declare const useForm: <TSchema extends z.ZodType, D extends PathDepth = DefaultPathDepth>(schema: TSchema, options: CreateFormOptions<TSchema, D>) => Form<TSchema, D>;
 
 type FormProviderProps<TSchema extends z.ZodType, D extends PathDepth = DefaultPathDepth> = Readonly<{
@@ -49,7 +51,7 @@ type FieldFormApi = Readonly<{
     setError(path: string, errors: string | readonly string[]): void;
     clearErrors(path?: string): void;
     validateField(path: string): FieldValidationResult;
-    validateFieldAsync(path: string): Promise<FieldValidationResult>;
+    validateFieldAsync(path: string): Promise<SettledFieldValidationResult>;
 }>;
 type FieldPathArg<TValues> = string | ((state: FormState<TValues>) => string);
 type UseFieldOptions = Readonly<{
@@ -60,6 +62,7 @@ type UseFieldReturn<TValue> = Readonly<{
     value: TValue;
     initialValue: TValue;
     emptyValue: null | undefined;
+    clearable: boolean;
     error: readonly string[] | undefined;
     firstError: string | undefined;
     touched: boolean;
@@ -70,7 +73,7 @@ type UseFieldReturn<TValue> = Readonly<{
     setError: (errors: string | readonly string[]) => void;
     clearError: () => void;
     validate: () => FieldValidationResult;
-    validateAsync: () => Promise<FieldValidationResult>;
+    validateAsync: () => Promise<SettledFieldValidationResult>;
     onBlur: () => void;
 }>;
 declare const inferredCallsOnly$2: unique symbol;
@@ -93,7 +96,7 @@ type VariantFieldValue<V, TField extends string> = V extends unknown ? TField ex
 type CommonKeys<V> = keyof V;
 type AllKeys<V> = V extends unknown ? keyof V : never;
 type VariantKeys<V> = Exclude<AllKeys<V>, CommonKeys<V>> & string;
-type UnionValueAt<TValues, P extends string> = P extends keyof TValues ? NonNullable<TValues[P]> : TValues extends readonly (infer Item)[] ? P extends `${number}` ? NonNullable<Item> : P extends `${infer Head}.${infer Tail}` ? Head extends `${number}` ? UnionValueAt<NonNullable<Item>, Tail> : never : never : P extends `${infer Head}.${infer Tail}` ? Head extends keyof TValues ? UnionValueAt<NonNullable<TValues[Head]>, Tail> : never : never;
+type UnionValueAt<TValues, P extends string> = P extends keyof TValues ? NonNullable<TValues[P]> : TValues extends readonly (infer Item)[] ? P extends `${number}` ? NonNullable<Item> : P extends `${infer Head}.${infer Tail}` ? Head extends keyof TValues ? UnionValueAt<NonNullable<TValues[Head]>, Tail> : Head extends `${number}` ? UnionValueAt<NonNullable<Item>, Tail> : never : never : P extends `${infer Head}.${infer Tail}` ? Head extends keyof TValues ? UnionValueAt<NonNullable<TValues[Head]>, Tail> : never : never;
 declare const inferredCallsOnly$1: unique symbol;
 interface InferredTypeArg$1 {
     readonly [inferredCallsOnly$1]: typeof inferredCallsOnly$1;
@@ -115,16 +118,22 @@ type FieldArrayFormApi = Readonly<{
     arrayMove(path: string, from: number, to: number): void;
     arraySwap(path: string, a: number, b: number): void;
     validateField?(path: string): FieldValidationResult;
+    setError?(path: string, errors: string | readonly string[]): void;
+    clearErrors?(path?: string): void;
 }>;
 type FieldArrayEntry<TItem> = Readonly<{
     id: string;
     value: TItem;
 }>;
 type UseFieldArrayReturn<TItem> = Readonly<{
+    path: string;
     fields: readonly FieldArrayEntry<TItem>[];
     items: readonly TItem[];
     length: number;
     error: readonly string[] | undefined;
+    firstError: string | undefined;
+    setError: (errors: string | readonly string[]) => void;
+    clearError: () => void;
     push: (item: TItem) => void;
     remove: (index: number) => void;
     insert: (index: number, item: TItem) => void;
@@ -148,6 +157,22 @@ declare function useFieldArray<TItem = unknown>(form: FieldArrayFormApi & {
 }, path: FieldPathArg<unknown>): UseFieldArrayReturn<TItem>;
 declare function useFieldArray<TSchema extends z.ZodType, P extends FieldPath<z.input<TSchema>, D>, D extends PathDepth = DefaultPathDepth>(form: Form<TSchema, D>, path: P): UseFieldArrayReturn<ArrayItemOf<FieldValue<z.input<TSchema>, P>>>;
 
+type UseFieldsReturn<TFields extends readonly unknown[]> = Readonly<{
+    fields: TFields;
+    error: readonly string[] | undefined;
+    firstError: string | undefined;
+    touched: boolean;
+    dirty: boolean;
+    isValidating: boolean;
+    onBlur: () => void;
+}>;
+declare function useFields(form: FieldFormApi & {
+    readonly schema?: undefined;
+}, paths: readonly string[]): UseFieldsReturn<readonly UseFieldReturn<unknown>[]>;
+declare function useFields<TSchema extends z.ZodType, const P extends readonly FieldPath<z.input<TSchema>, D>[], D extends PathDepth = DefaultPathDepth>(form: Form<TSchema, D>, paths: P): UseFieldsReturn<{
+    readonly [K in keyof P]: UseFieldReturn<FieldValue<z.input<TSchema>, P[K] & string>>;
+}>;
+
 type BoundUseField<TSchema extends z.ZodType, D extends PathDepth = DefaultPathDepth> = {
     (pathSelector: (state: FormState<z.input<TSchema>>) => string, options?: UseFieldOptions): UseFieldReturn<unknown>;
     <P extends FieldPath<z.input<TSchema>, D>>(path: P, options?: UseFieldOptions): UseFieldReturn<FieldValue<z.input<TSchema>, P>>;
@@ -175,10 +200,19 @@ type FormHooks<TSchema extends z.ZodType, N extends string, D extends PathDepth
     [K in `use${Capitalize<N>}IsDirty`]: BoundUseFlag<TSchema, D>;
 } & {
     [K in `use${Capitalize<N>}IsValid`]: BoundUseFlag<TSchema, D>;
+} & {
+    [K in `use${Capitalize<N>}IsValidating`]: BoundUseFlag<TSchema, D>;
 } & {
     [K in `use${Capitalize<N>}IsSubmitting`]: () => boolean;
 } & {
     [K in `use${Capitalize<N>}SubmitCount`]: () => number;
+} & {
+    [K in `use${Capitalize<N>}Values`]: () => z.input<TSchema>;
+} & {
+    [K in `use${Capitalize<N>}Fields`]: BoundUseFields<TSchema, D>;
+}>;
+type BoundUseFields<TSchema extends z.ZodType, D extends PathDepth = DefaultPathDepth> = <const P extends readonly FieldPath<z.input<TSchema>, D>[]>(paths: P) => UseFieldsReturn<{
+    readonly [K in keyof P]: UseFieldReturn<FieldValue<z.input<TSchema>, P[K] & string>>;
 }>;
 declare const createFormHooks: <TSchema extends z.ZodType, N extends string = "", D extends PathDepth = DefaultPathDepth>(form: Form<TSchema, D>, name?: N) => FormHooks<TSchema, N, D>;
 
@@ -210,25 +244,13 @@ declare function useIsValid(form: FormStateApi & {
     readonly schema?: undefined;
 }, path?: string): boolean;
 declare function useIsValid<TSchema extends z.ZodType, P extends FieldPath<z.input<TSchema>, D>, D extends PathDepth = DefaultPathDepth>(form: Form<TSchema, D>, path?: P): boolean;
+declare function useIsValidating(form: FormStateApi & {
+    readonly schema?: undefined;
+}, path?: string): boolean;
+declare function useIsValidating<TSchema extends z.ZodType, P extends FieldPath<z.input<TSchema>, D>, D extends PathDepth = DefaultPathDepth>(form: Form<TSchema, D>, path?: P): boolean;
 declare const useIsSubmitting: (form: FormStateApi) => boolean;
 declare const useSubmitCount: (form: FormStateApi) => number;
 
-type UseFieldsReturn<TFields extends readonly unknown[]> = Readonly<{
-    fields: TFields;
-    error: readonly string[] | undefined;
-    firstError: string | undefined;
-    touched: boolean;
-    dirty: boolean;
-    isValidating: boolean;
-    onBlur: () => void;
-}>;
-declare function useFields(form: FieldFormApi & {
-    readonly schema?: undefined;
-}, paths: readonly string[]): UseFieldsReturn<readonly UseFieldReturn<unknown>[]>;
-declare function useFields<TSchema extends z.ZodType, const P extends readonly FieldPath<z.input<TSchema>, D>[], D extends PathDepth = DefaultPathDepth>(form: Form<TSchema, D>, paths: P): UseFieldsReturn<{
-    readonly [K in keyof P]: UseFieldReturn<FieldValue<z.input<TSchema>, P[K] & string>>;
-}>;
-
 type PathsOf<F extends FieldFormApi> = F extends Form<infer TSchema extends z.ZodType, infer D extends PathDepth> ? FieldPath<z.input<TSchema>, D> : string;
 type FieldRef<T> = ((instance: T | null) => void) | Readonly<{
     current: T | null;
@@ -358,4 +380,4 @@ declare const dateInputProps: <T extends Date | null | undefined>(field: UseFiel
 declare const checkboxProps: <T extends boolean | null | undefined>(field: UseFieldReturn<T>) => CheckboxProps;
 declare const selectProps: <T extends string | null | undefined>(field: UseFieldReturn<T>) => SelectProps;
 
-export { type BoundUseField, type BoundUseFieldArray, type BoundUseFlag, type BoundUseSelector, CheckboxField, type CheckboxFieldProps, type CheckboxProps, CreateFormOptions, DateField, type DateFieldProps, type DateInputProps, DefaultPathDepth, ErrorMap, type FieldArrayEntry, type FieldArrayFormApi, type FieldFormApi, FieldPath, type FieldPathArg, type FieldRef, FieldValidationResult, FieldValue, Form, type FormContextApi, type FormHooks, type FormProviderProps, FormState, type FormStateApi, NumberField, type NumberFieldProps, type NumberInputBinding, type NumberInputProps, type ParsedDateText, type ParsedNumberText, PathDepth, type PathSegment, type PathsOf, type PersistHandle, type PersistOptions, type PersistStorage, SelectField, type SelectFieldOption, type SelectFieldProps, type SelectProps, TextField, type TextFieldProps, type TextInputProps, type UseFieldArrayReturn, type UseFieldOptions, type UseFieldReturn, type UseFieldsReturn, checkboxProps, createFormContext, createFormHooks, dateInputProps, dateToInputText, focusField, focusFirstError, getAtPath, hasFieldError, numberInputProps, numberToInputText, parseDateText, parseNumberText, parsePath, persistForm, selectProps, setAtPath, textInputProps, useField, useFieldArray, useFields, useForm, useFormError, useFormSelector, useFormSelectorShallow, useFormValues, useIsDirty, useIsSubmitting, useIsValid, useNumberInput, useSubmitCount, useVariantField };
+export { type BoundUseField, type BoundUseFieldArray, type BoundUseFlag, type BoundUseSelector, CheckboxField, type CheckboxFieldProps, type CheckboxProps, CreateFormOptions, DateField, type DateFieldProps, type DateInputProps, DefaultPathDepth, ErrorMap, type FieldArrayEntry, type FieldArrayFormApi, type FieldFormApi, FieldPath, type FieldPathArg, type FieldRef, FieldValidationResult, FieldValue, Form, type FormContextApi, type FormHooks, type FormProviderProps, FormState, type FormStateApi, NumberField, type NumberFieldProps, type NumberInputBinding, type NumberInputProps, type ParsedDateText, type ParsedNumberText, PathDepth, type PathSegment, type PathsOf, type PersistHandle, type PersistOptions, type PersistStorage, SelectField, type SelectFieldOption, type SelectFieldProps, type SelectProps, SettledFieldValidationResult, TextField, type TextFieldProps, type TextInputProps, type UseFieldArrayReturn, type UseFieldOptions, type UseFieldReturn, type UseFieldsReturn, checkboxProps, createFormContext, createFormHooks, dateInputProps, dateToInputText, focusField, focusFirstError, getAtPath, hasFieldError, numberInputProps, numberToInputText, parseDateText, parseNumberText, parsePath, persistForm, selectProps, setAtPath, textInputProps, useField, useFieldArray, useFields, useForm, useFormError, useFormSelector, useFormSelectorShallow, useFormValues, useIsDirty, useIsSubmitting, useIsValid, useIsValidating, useNumberInput, usePersistForm, useSubmitCount, useVariantField };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { P as PathDepth, D as DefaultPathDepth, F as Form, C as CreateFormOptions, a as FieldValidationResult, b as FormState, c as FieldPath, d as FieldValue, E as ErrorMap } from './createForm-jlzK2lCG.js';
-export { B as BoolMap, e as FieldSnapshot, f as FieldsValidationResult, I as InvalidSubmitHandler, R as ReadonlyStoreApi, g as ResetOptions, S as SettledFieldValidationResult, h as SettledFieldsValidationResult, i as SettledValidationResult, j as SubmitHandler, k as SubmitOptions, l as SubmitResult, V as ValidationMode, m as ValidationResult, n as ValidationTrigger, o as createForm, p as emptyValueForSchema, q as flattenIssues, r as isAsyncRequiredError, s as shouldValidateOn, v as validateAsync, t as validateSync } from './createForm-jlzK2lCG.js';
+import { P as PathDepth, D as DefaultPathDepth, F as Form, C as CreateFormOptions, a as FieldValidationResult, S as SettledFieldValidationResult, b as FormState, c as FieldPath, d as FieldValue, E as ErrorMap } from './createForm-B73p1TgL.js';
+export { B as BoolMap, e as FieldSnapshot, f as FieldsValidationResult, I as InvalidSubmitHandler, R as ReadonlyStoreApi, g as ResetOptions, h as SettledFieldsValidationResult, i as SettledValidationResult, j as SubmitHandler, k as SubmitOptions, l as SubmitResult, V as ValidationMode, m as ValidationResult, n as ValidationTrigger, o as createForm, p as emptyValueForSchema, q as flattenIssues, r as isAsyncRequiredError, s as isClearableSchema, t as shouldValidateOn, v as validateAsync, u as validateSync } from './createForm-B73p1TgL.js';
 import { z } from 'zod';
 import * as react from 'react';
 import { ReactNode, ChangeEvent } from 'react';
@@ -23,12 +23,14 @@ type PersistOptions<TSchema extends z.ZodType> = Readonly<{
     apply?: "adopt" | "restore" | "manual";
 }>;
 type PersistHandle = Readonly<{
-    restore: () => boolean;
+    load: () => boolean;
     clear: () => void;
     dispose: () => void;
 }>;
 declare const persistForm: <TSchema extends z.ZodType, D extends PathDepth = DefaultPathDepth>(form: Form<TSchema, D>, options: PersistOptions<TSchema>) => PersistHandle;
 
+declare const usePersistForm: <TSchema extends z.ZodType, D extends PathDepth = DefaultPathDepth>(form: Form<TSchema, D>, options: PersistOptions<TSchema>) => PersistHandle;
+
 declare const useForm: <TSchema extends z.ZodType, D extends PathDepth = DefaultPathDepth>(schema: TSchema, options: CreateFormOptions<TSchema, D>) => Form<TSchema, D>;
 
 type FormProviderProps<TSchema extends z.ZodType, D extends PathDepth = DefaultPathDepth> = Readonly<{
@@ -49,7 +51,7 @@ type FieldFormApi = Readonly<{
     setError(path: string, errors: string | readonly string[]): void;
     clearErrors(path?: string): void;
     validateField(path: string): FieldValidationResult;
-    validateFieldAsync(path: string): Promise<FieldValidationResult>;
+    validateFieldAsync(path: string): Promise<SettledFieldValidationResult>;
 }>;
 type FieldPathArg<TValues> = string | ((state: FormState<TValues>) => string);
 type UseFieldOptions = Readonly<{
@@ -60,6 +62,7 @@ type UseFieldReturn<TValue> = Readonly<{
     value: TValue;
     initialValue: TValue;
     emptyValue: null | undefined;
+    clearable: boolean;
     error: readonly string[] | undefined;
     firstError: string | undefined;
     touched: boolean;
@@ -70,7 +73,7 @@ type UseFieldReturn<TValue> = Readonly<{
     setError: (errors: string | readonly string[]) => void;
     clearError: () => void;
     validate: () => FieldValidationResult;
-    validateAsync: () => Promise<FieldValidationResult>;
+    validateAsync: () => Promise<SettledFieldValidationResult>;
     onBlur: () => void;
 }>;
 declare const inferredCallsOnly$2: unique symbol;
@@ -93,7 +96,7 @@ type VariantFieldValue<V, TField extends string> = V extends unknown ? TField ex
 type CommonKeys<V> = keyof V;
 type AllKeys<V> = V extends unknown ? keyof V : never;
 type VariantKeys<V> = Exclude<AllKeys<V>, CommonKeys<V>> & string;
-type UnionValueAt<TValues, P extends string> = P extends keyof TValues ? NonNullable<TValues[P]> : TValues extends readonly (infer Item)[] ? P extends `${number}` ? NonNullable<Item> : P extends `${infer Head}.${infer Tail}` ? Head extends `${number}` ? UnionValueAt<NonNullable<Item>, Tail> : never : never : P extends `${infer Head}.${infer Tail}` ? Head extends keyof TValues ? UnionValueAt<NonNullable<TValues[Head]>, Tail> : never : never;
+type UnionValueAt<TValues, P extends string> = P extends keyof TValues ? NonNullable<TValues[P]> : TValues extends readonly (infer Item)[] ? P extends `${number}` ? NonNullable<Item> : P extends `${infer Head}.${infer Tail}` ? Head extends keyof TValues ? UnionValueAt<NonNullable<TValues[Head]>, Tail> : Head extends `${number}` ? UnionValueAt<NonNullable<Item>, Tail> : never : never : P extends `${infer Head}.${infer Tail}` ? Head extends keyof TValues ? UnionValueAt<NonNullable<TValues[Head]>, Tail> : never : never;
 declare const inferredCallsOnly$1: unique symbol;
 interface InferredTypeArg$1 {
     readonly [inferredCallsOnly$1]: typeof inferredCallsOnly$1;
@@ -115,16 +118,22 @@ type FieldArrayFormApi = Readonly<{
     arrayMove(path: string, from: number, to: number): void;
     arraySwap(path: string, a: number, b: number): void;
     validateField?(path: string): FieldValidationResult;
+    setError?(path: string, errors: string | readonly string[]): void;
+    clearErrors?(path?: string): void;
 }>;
 type FieldArrayEntry<TItem> = Readonly<{
     id: string;
     value: TItem;
 }>;
 type UseFieldArrayReturn<TItem> = Readonly<{
+    path: string;
     fields: readonly FieldArrayEntry<TItem>[];
     items: readonly TItem[];
     length: number;
     error: readonly string[] | undefined;
+    firstError: string | undefined;
+    setError: (errors: string | readonly string[]) => void;
+    clearError: () => void;
     push: (item: TItem) => void;
     remove: (index: number) => void;
     insert: (index: number, item: TItem) => void;
@@ -148,6 +157,22 @@ declare function useFieldArray<TItem = unknown>(form: FieldArrayFormApi & {
 }, path: FieldPathArg<unknown>): UseFieldArrayReturn<TItem>;
 declare function useFieldArray<TSchema extends z.ZodType, P extends FieldPath<z.input<TSchema>, D>, D extends PathDepth = DefaultPathDepth>(form: Form<TSchema, D>, path: P): UseFieldArrayReturn<ArrayItemOf<FieldValue<z.input<TSchema>, P>>>;
 
+type UseFieldsReturn<TFields extends readonly unknown[]> = Readonly<{
+    fields: TFields;
+    error: readonly string[] | undefined;
+    firstError: string | undefined;
+    touched: boolean;
+    dirty: boolean;
+    isValidating: boolean;
+    onBlur: () => void;
+}>;
+declare function useFields(form: FieldFormApi & {
+    readonly schema?: undefined;
+}, paths: readonly string[]): UseFieldsReturn<readonly UseFieldReturn<unknown>[]>;
+declare function useFields<TSchema extends z.ZodType, const P extends readonly FieldPath<z.input<TSchema>, D>[], D extends PathDepth = DefaultPathDepth>(form: Form<TSchema, D>, paths: P): UseFieldsReturn<{
+    readonly [K in keyof P]: UseFieldReturn<FieldValue<z.input<TSchema>, P[K] & string>>;
+}>;
+
 type BoundUseField<TSchema extends z.ZodType, D extends PathDepth = DefaultPathDepth> = {
     (pathSelector: (state: FormState<z.input<TSchema>>) => string, options?: UseFieldOptions): UseFieldReturn<unknown>;
     <P extends FieldPath<z.input<TSchema>, D>>(path: P, options?: UseFieldOptions): UseFieldReturn<FieldValue<z.input<TSchema>, P>>;
@@ -175,10 +200,19 @@ type FormHooks<TSchema extends z.ZodType, N extends string, D extends PathDepth
     [K in `use${Capitalize<N>}IsDirty`]: BoundUseFlag<TSchema, D>;
 } & {
     [K in `use${Capitalize<N>}IsValid`]: BoundUseFlag<TSchema, D>;
+} & {
+    [K in `use${Capitalize<N>}IsValidating`]: BoundUseFlag<TSchema, D>;
 } & {
     [K in `use${Capitalize<N>}IsSubmitting`]: () => boolean;
 } & {
     [K in `use${Capitalize<N>}SubmitCount`]: () => number;
+} & {
+    [K in `use${Capitalize<N>}Values`]: () => z.input<TSchema>;
+} & {
+    [K in `use${Capitalize<N>}Fields`]: BoundUseFields<TSchema, D>;
+}>;
+type BoundUseFields<TSchema extends z.ZodType, D extends PathDepth = DefaultPathDepth> = <const P extends readonly FieldPath<z.input<TSchema>, D>[]>(paths: P) => UseFieldsReturn<{
+    readonly [K in keyof P]: UseFieldReturn<FieldValue<z.input<TSchema>, P[K] & string>>;
 }>;
 declare const createFormHooks: <TSchema extends z.ZodType, N extends string = "", D extends PathDepth = DefaultPathDepth>(form: Form<TSchema, D>, name?: N) => FormHooks<TSchema, N, D>;
 
@@ -210,25 +244,13 @@ declare function useIsValid(form: FormStateApi & {
     readonly schema?: undefined;
 }, path?: string): boolean;
 declare function useIsValid<TSchema extends z.ZodType, P extends FieldPath<z.input<TSchema>, D>, D extends PathDepth = DefaultPathDepth>(form: Form<TSchema, D>, path?: P): boolean;
+declare function useIsValidating(form: FormStateApi & {
+    readonly schema?: undefined;
+}, path?: string): boolean;
+declare function useIsValidating<TSchema extends z.ZodType, P extends FieldPath<z.input<TSchema>, D>, D extends PathDepth = DefaultPathDepth>(form: Form<TSchema, D>, path?: P): boolean;
 declare const useIsSubmitting: (form: FormStateApi) => boolean;
 declare const useSubmitCount: (form: FormStateApi) => number;
 
-type UseFieldsReturn<TFields extends readonly unknown[]> = Readonly<{
-    fields: TFields;
-    error: readonly string[] | undefined;
-    firstError: string | undefined;
-    touched: boolean;
-    dirty: boolean;
-    isValidating: boolean;
-    onBlur: () => void;
-}>;
-declare function useFields(form: FieldFormApi & {
-    readonly schema?: undefined;
-}, paths: readonly string[]): UseFieldsReturn<readonly UseFieldReturn<unknown>[]>;
-declare function useFields<TSchema extends z.ZodType, const P extends readonly FieldPath<z.input<TSchema>, D>[], D extends PathDepth = DefaultPathDepth>(form: Form<TSchema, D>, paths: P): UseFieldsReturn<{
-    readonly [K in keyof P]: UseFieldReturn<FieldValue<z.input<TSchema>, P[K] & string>>;
-}>;
-
 type PathsOf<F extends FieldFormApi> = F extends Form<infer TSchema extends z.ZodType, infer D extends PathDepth> ? FieldPath<z.input<TSchema>, D> : string;
 type FieldRef<T> = ((instance: T | null) => void) | Readonly<{
     current: T | null;
@@ -358,4 +380,4 @@ declare const dateInputProps: <T extends Date | null | undefined>(field: UseFiel
 declare const checkboxProps: <T extends boolean | null | undefined>(field: UseFieldReturn<T>) => CheckboxProps;
 declare const selectProps: <T extends string | null | undefined>(field: UseFieldReturn<T>) => SelectProps;
 
-export { type BoundUseField, type BoundUseFieldArray, type BoundUseFlag, type BoundUseSelector, CheckboxField, type CheckboxFieldProps, type CheckboxProps, CreateFormOptions, DateField, type DateFieldProps, type DateInputProps, DefaultPathDepth, ErrorMap, type FieldArrayEntry, type FieldArrayFormApi, type FieldFormApi, FieldPath, type FieldPathArg, type FieldRef, FieldValidationResult, FieldValue, Form, type FormContextApi, type FormHooks, type FormProviderProps, FormState, type FormStateApi, NumberField, type NumberFieldProps, type NumberInputBinding, type NumberInputProps, type ParsedDateText, type ParsedNumberText, PathDepth, type PathSegment, type PathsOf, type PersistHandle, type PersistOptions, type PersistStorage, SelectField, type SelectFieldOption, type SelectFieldProps, type SelectProps, TextField, type TextFieldProps, type TextInputProps, type UseFieldArrayReturn, type UseFieldOptions, type UseFieldReturn, type UseFieldsReturn, checkboxProps, createFormContext, createFormHooks, dateInputProps, dateToInputText, focusField, focusFirstError, getAtPath, hasFieldError, numberInputProps, numberToInputText, parseDateText, parseNumberText, parsePath, persistForm, selectProps, setAtPath, textInputProps, useField, useFieldArray, useFields, useForm, useFormError, useFormSelector, useFormSelectorShallow, useFormValues, useIsDirty, useIsSubmitting, useIsValid, useNumberInput, useSubmitCount, useVariantField };
+export { type BoundUseField, type BoundUseFieldArray, type BoundUseFlag, type BoundUseSelector, CheckboxField, type CheckboxFieldProps, type CheckboxProps, CreateFormOptions, DateField, type DateFieldProps, type DateInputProps, DefaultPathDepth, ErrorMap, type FieldArrayEntry, type FieldArrayFormApi, type FieldFormApi, FieldPath, type FieldPathArg, type FieldRef, FieldValidationResult, FieldValue, Form, type FormContextApi, type FormHooks, type FormProviderProps, FormState, type FormStateApi, NumberField, type NumberFieldProps, type NumberInputBinding, type NumberInputProps, type ParsedDateText, type ParsedNumberText, PathDepth, type PathSegment, type PathsOf, type PersistHandle, type PersistOptions, type PersistStorage, SelectField, type SelectFieldOption, type SelectFieldProps, type SelectProps, SettledFieldValidationResult, TextField, type TextFieldProps, type TextInputProps, type UseFieldArrayReturn, type UseFieldOptions, type UseFieldReturn, type UseFieldsReturn, checkboxProps, createFormContext, createFormHooks, dateInputProps, dateToInputText, focusField, focusFirstError, getAtPath, hasFieldError, numberInputProps, numberToInputText, parseDateText, parseNumberText, parsePath, persistForm, selectProps, setAtPath, textInputProps, useField, useFieldArray, useFields, useForm, useFormError, useFormSelector, useFormSelectorShallow, useFormValues, useIsDirty, useIsSubmitting, useIsValid, useIsValidating, useNumberInput, usePersistForm, useSubmitCount, useVariantField };