react-hook-form 8.0.0-beta.2 → 8.0.0-beta.4

package/dist/types/errors.d.ts

@@ -1,5 +1,6 @@
 import type { FieldValues, InternalFieldName, Ref } from './fields';
-import type { BrowserNativeObject, IsAny, LiteralUnion, Merge } from './utils';
+import type { FieldPath, FieldPathValue } from './path';
+import type { BrowserNativeObject, IsAny, LiteralUnion, Merge, OpaqueType } from './utils';
 import type { RegisterOptions, ValidateResult } from './validator';
 export type Message = string;
 export type MultipleFieldErrors = {
@@ -19,19 +20,23 @@ export type ErrorOption = {
     type?: LiteralUnion<keyof RegisterOptions, string>;
     types?: MultipleFieldErrors;
 };
-export type DeepRequired<T> = T extends BrowserNativeObject | Blob ? T : {
+export type DeepRequired<T> = T extends BrowserNativeObject | Blob | OpaqueType ? T : {
     [K in keyof T]-?: NonNullable<DeepRequired<T[K]>>;
 };
 export type FieldErrorsImpl<T extends FieldValues = FieldValues> = {
-    [K in keyof T]?: T[K] extends BrowserNativeObject | Blob ? FieldError : K extends 'root' | `root.${string}` ? GlobalError : T[K] extends object ? Merge<FieldError, FieldErrorsImpl<T[K]>> : FieldError;
+    [K in keyof T]?: T[K] extends BrowserNativeObject | Blob | OpaqueType ? FieldError : K extends 'root' | `root.${string}` ? GlobalError : T[K] extends object ? Merge<FieldError, FieldErrorsImpl<T[K]>> : FieldError;
 };
 export type GlobalError = Partial<{
     type: string | number;
     message: Message;
 }>;
-export type FieldErrors<T extends FieldValues = FieldValues> = Partial<FieldValues extends IsAny<FieldValues> ? any : FieldErrorsImpl<DeepRequired<T>>> & {
+export type FieldErrors<T extends FieldValues = FieldValues> = Partial<FieldErrorsImpl<DeepRequired<T>>> & {
     root?: Record<string, GlobalError> & GlobalError;
     form?: GlobalError;
 };
+/** Resolves the error type stored by {@link FieldErrors} for a field path. */
+export type FieldPathError<TFieldValues extends FieldValues, TFieldPath extends FieldPath<TFieldValues>> = TFieldPath extends FieldPath<TFieldValues> ? TFieldPath extends `${string}.root` ? GlobalError : DeepRequired<NonNullable<FieldPathValue<TFieldValues, TFieldPath>>> extends infer TFieldValue ? IsAny<TFieldValue> extends true ? FieldError : NonNullable<FieldErrorsImpl<{
+    value: TFieldValue;
+}>['value']> : never : never;
 export type InternalFieldErrors = Partial<Record<InternalFieldName, FieldError>>;
 //# sourceMappingURL=errors.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/types/errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AACpE,OAAO,KAAK,EAAE,mBAAmB,EAAE,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAC/E,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAEnE,MAAM,MAAM,OAAO,GAAG,MAAM,CAAC;AAE7B,MAAM,MAAM,mBAAmB,GAAG;KAC/B,CAAC,IAAI,MAAM,eAAe,CAAC,CAAC,EAAE,cAAc;CAC9C,GAAG;IACF,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,CAAC;CAC/B,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,IAAI,EAAE,YAAY,CAAC,MAAM,eAAe,EAAE,MAAM,CAAC,CAAC;IAClD,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,GAAG,CAAC,EAAE,GAAG,CAAC;IACV,KAAK,CAAC,EAAE,mBAAmB,CAAC;IAC5B,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,YAAY,CAAC,MAAM,eAAe,EAAE,MAAM,CAAC,CAAC;IACnD,KAAK,CAAC,EAAE,mBAAmB,CAAC;CAC7B,CAAC;AAEF,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI,CAAC,SAAS,mBAAmB,GAAG,IAAI,GAC9D,CAAC,GACD;KACG,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAClD,CAAC;AAEN,MAAM,MAAM,eAAe,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW,IAAI;KAChE,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,mBAAmB,GAAG,IAAI,GACpD,UAAU,GACV,CAAC,SAAS,MAAM,GAAG,QAAQ,MAAM,EAAE,GACjC,WAAW,GACX,CAAC,CAAC,CAAC,CAAC,SAAS,MAAM,GACjB,KAAK,CAAC,UAAU,EAAE,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GACxC,UAAU;CACnB,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG,OAAO,CAAC;IAChC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IACtB,OAAO,EAAE,OAAO,CAAC;CAClB,CAAC,CAAC;AAEH,MAAM,MAAM,WAAW,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW,IAAI,OAAO,CACpE,WAAW,SAAS,KAAK,CAAC,WAAW,CAAC,GAClC,GAAG,GACH,eAAe,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CACrC,GAAG;IACF,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,GAAG,WAAW,CAAC;IACjD,IAAI,CAAC,EAAE,WAAW,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG,OAAO,CACvC,MAAM,CAAC,iBAAiB,EAAE,UAAU,CAAC,CACtC,CAAC"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/types/errors.ts"],"names":[],"mappings":"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"}

package/dist/types/fieldArray.d.ts

@@ -9,6 +9,7 @@ export type UseFieldArrayProps<TFieldValues extends FieldValues = FieldValues, T
         validate?: Validate<FieldArray<TFieldValues, TFieldArrayName>[], TFieldValues> | Record<string, Validate<FieldArray<TFieldValues, TFieldArrayName>[], TFieldValues>>;
     } & Pick<RegisterOptions<TFieldValues>, 'maxLength' | 'minLength' | 'required'>;
     shouldUnregister?: boolean;
+    disabled?: boolean;
 };
 /**
  * `useFieldArray` returned `fields` with unique id
@@ -189,6 +190,29 @@ export type UseFieldArrayReturn<TFieldValues extends FieldValues = FieldValues,
     insert: UseFieldArrayInsert<TFieldValues, TFieldArrayName>;
     update: UseFieldArrayUpdate<TFieldValues, TFieldArrayName>;
     replace: UseFieldArrayReplace<TFieldValues, TFieldArrayName>;
-    fields: FieldArrayWithId<TFieldValues, TFieldArrayName, TKeyName>[];
+    fields: (FieldArrayWithId<TFieldValues, TFieldArrayName, TKeyName> & {
+        disabled?: boolean;
+    })[];
 };
+/**
+
+ *
+ * @example
+ * ```tsx
+ * const { fields } = useFieldArray({
+ *   name: 'test',
+ * });
+ *
+ * <FieldArray
+ *   render={({ fields }) =>
+ *     fields.map((field, index) => (
+ *       <input key={field.id} {...register(`test.${index}.value`)} />
+ *     ))
+ *   }
+ * />
+ * ```
+ */
+export type FieldArrayProps<TFieldValues extends FieldValues = FieldValues, TFieldArrayName extends FieldArrayPath<TFieldValues> = FieldArrayPath<TFieldValues>> = {
+    render: (fieldArray: UseFieldArrayReturn<TFieldValues, TFieldArrayName>) => React.ReactElement;
+} & UseFieldArrayProps<TFieldValues, TFieldArrayName>;
 //# sourceMappingURL=fieldArray.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"fieldArray.d.ts","sourceRoot":"","sources":["../../src/types/fieldArray.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"fieldArray.d.ts","sourceRoot":"","sources":["../../src/types/fieldArray.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,KAAK,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,QAAQ,CAAC;AAClE,OAAO,KAAK,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE7D,MAAM,MAAM,kBAAkB,CAC5B,YAAY,SAAS,WAAW,GAAG,WAAW,EAC9C,eAAe,SAAS,cAAc,CAAC,YAAY,CAAC,GAClD,cAAc,CAAC,YAAY,CAAC,EAC9B,kBAAkB,GAAG,YAAY,IAC/B;IACF,IAAI,EAAE,eAAe,CAAC;IACtB,OAAO,CAAC,EAAE,OAAO,CAAC,YAAY,EAAE,GAAG,EAAE,kBAAkB,CAAC,CAAC;IACzD,KAAK,CAAC,EAAE;QACN,QAAQ,CAAC,EACL,QAAQ,CAAC,UAAU,CAAC,YAAY,EAAE,eAAe,CAAC,EAAE,EAAE,YAAY,CAAC,GACnE,MAAM,CACJ,MAAM,EACN,QAAQ,CAAC,UAAU,CAAC,YAAY,EAAE,eAAe,CAAC,EAAE,EAAE,YAAY,CAAC,CACpE,CAAC;KACP,GAAG,IAAI,CACN,eAAe,CAAC,YAAY,CAAC,EAC7B,WAAW,GAAG,WAAW,GAAG,UAAU,CACvC,CAAC;IACF,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,gBAAgB,CAC1B,YAAY,SAAS,WAAW,GAAG,WAAW,EAC9C,eAAe,SAAS,cAAc,CAAC,YAAY,CAAC,GAClD,cAAc,CAAC,YAAY,CAAC,EAC9B,QAAQ,SAAS,MAAM,GAAG,KAAK,IAC7B,UAAU,CAAC,YAAY,EAAE,eAAe,CAAC,GAAG,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;AAEzE,MAAM,MAAM,UAAU,CACpB,YAAY,SAAS,WAAW,GAAG,WAAW,EAC9C,eAAe,SAAS,cAAc,CAAC,YAAY,CAAC,GAClD,cAAc,CAAC,YAAY,CAAC,IAE9B,mBAAmB,CAAC,YAAY,EAAE,eAAe,CAAC,SAC9C,aAAa,CAAC,MAAM,CAAC,CAAC,GACtB,IAAI,GACJ,SAAS,GACT,CAAC,GACD,KAAK,CAAC;AAEZ;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAClC,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;AAEzE;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;AAEzE;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,MAAM,oBAAoB,CAC9B,YAAY,SAAS,WAAW,EAChC,eAAe,SAAS,cAAc,CAAC,YAAY,CAAC,GAClD,cAAc,CAAC,YAAY,CAAC,IAC5B,CACF,KAAK,EACD,UAAU,CAAC,YAAY,EAAE,eAAe,CAAC,GACzC,UAAU,CAAC,YAAY,EAAE,eAAe,CAAC,EAAE,EAC/C,OAAO,CAAC,EAAE,qBAAqB,KAC5B,IAAI,CAAC;AAEV;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,MAAM,mBAAmB,CAC7B,YAAY,SAAS,WAAW,EAChC,eAAe,SAAS,cAAc,CAAC,YAAY,CAAC,GAClD,cAAc,CAAC,YAAY,CAAC,IAC5B,CACF,KAAK,EACD,UAAU,CAAC,YAAY,EAAE,eAAe,CAAC,GACzC,UAAU,CAAC,YAAY,EAAE,eAAe,CAAC,EAAE,EAC/C,OAAO,CAAC,EAAE,qBAAqB,KAC5B,IAAI,CAAC;AAEV;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,KAAK,IAAI,CAAC;AAEtE;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,MAAM,mBAAmB,CAC7B,YAAY,SAAS,WAAW,EAChC,eAAe,SAAS,cAAc,CAAC,YAAY,CAAC,GAClD,cAAc,CAAC,YAAY,CAAC,IAC5B,CACF,KAAK,EAAE,MAAM,EACb,KAAK,EACD,UAAU,CAAC,YAAY,EAAE,eAAe,CAAC,GACzC,UAAU,CAAC,YAAY,EAAE,eAAe,CAAC,EAAE,EAC/C,OAAO,CAAC,EAAE,qBAAqB,KAC5B,IAAI,CAAC;AAEV;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,MAAM,mBAAmB,CAC7B,YAAY,SAAS,WAAW,EAChC,eAAe,SAAS,cAAc,CAAC,YAAY,CAAC,GAClD,cAAc,CAAC,YAAY,CAAC,IAC5B,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,CAAC,YAAY,EAAE,eAAe,CAAC,KAAK,IAAI,CAAC;AAE9E;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,MAAM,oBAAoB,CAC9B,YAAY,SAAS,WAAW,EAChC,eAAe,SAAS,cAAc,CAAC,YAAY,CAAC,GAClD,cAAc,CAAC,YAAY,CAAC,IAC5B,CACF,KAAK,EACD,UAAU,CAAC,YAAY,EAAE,eAAe,CAAC,GACzC,UAAU,CAAC,YAAY,EAAE,eAAe,CAAC,EAAE,KAC5C,IAAI,CAAC;AAEV,MAAM,MAAM,mBAAmB,CAC7B,YAAY,SAAS,WAAW,GAAG,WAAW,EAC9C,eAAe,SAAS,cAAc,CAAC,YAAY,CAAC,GAClD,cAAc,CAAC,YAAY,CAAC,EAC9B,QAAQ,SAAS,MAAM,GAAG,KAAK,IAC7B;IACF,IAAI,EAAE,iBAAiB,CAAC;IACxB,IAAI,EAAE,iBAAiB,CAAC;IACxB,OAAO,EAAE,oBAAoB,CAAC,YAAY,EAAE,eAAe,CAAC,CAAC;IAC7D,MAAM,EAAE,mBAAmB,CAAC,YAAY,EAAE,eAAe,CAAC,CAAC;IAC3D,MAAM,EAAE,mBAAmB,CAAC;IAC5B,MAAM,EAAE,mBAAmB,CAAC,YAAY,EAAE,eAAe,CAAC,CAAC;IAC3D,MAAM,EAAE,mBAAmB,CAAC,YAAY,EAAE,eAAe,CAAC,CAAC;IAC3D,OAAO,EAAE,oBAAoB,CAAC,YAAY,EAAE,eAAe,CAAC,CAAC;IAC7D,MAAM,EAAE,CAAC,gBAAgB,CAAC,YAAY,EAAE,eAAe,EAAE,QAAQ,CAAC,GAAG;QACnE,QAAQ,CAAC,EAAE,OAAO,CAAC;KACpB,CAAC,EAAE,CAAC;CACN,CAAC;AAEF;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,MAAM,eAAe,CACzB,YAAY,SAAS,WAAW,GAAG,WAAW,EAC9C,eAAe,SAAS,cAAc,CAAC,YAAY,CAAC,GAClD,cAAc,CAAC,YAAY,CAAC,IAC5B;IACF,MAAM,EAAE,CACN,UAAU,EAAE,mBAAmB,CAAC,YAAY,EAAE,eAAe,CAAC,KAC3D,KAAK,CAAC,YAAY,CAAC;CACzB,GAAG,kBAAkB,CAAC,YAAY,EAAE,eAAe,CAAC,CAAC"}

package/dist/types/fields.d.ts

@@ -23,6 +23,7 @@ export type Field = {
         name: InternalFieldName;
         refs?: HTMLInputElement[];
         mount?: boolean;
+        _c?: boolean;
     } & RegisterOptions;
 };
 export type FieldRefs = Partial<{

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

@@ -1 +1 @@
-{"version":3,"file":"fields.d.ts","sourceRoot":"","sources":["../../src/types/fields.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAClD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD,MAAM,MAAM,iBAAiB,GAAG,MAAM,CAAC;AAEvC,MAAM,MAAM,SAAS,CAAC,YAAY,SAAS,WAAW,IACpD,YAAY,CAAC,YAAY,CAAC,SAAS,IAAI,GACnC,OAAO,CAAC,MAAM,YAAY,EAAE,MAAM,CAAC,GACnC,MAAM,CAAC;AAEb,MAAM,MAAM,aAAa,CAAC,YAAY,SAAS,WAAW,IACxD,OAAO,CAAC,WAAW,CAAC,GAAG;IACrB,IAAI,EAAE,SAAS,CAAC,YAAY,CAAC,CAAC;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,GAAG,CAAC;IACZ,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,qBAAqB,CAAC;IAChC,KAAK,CAAC,EAAE,QAAQ,GAAG,IAAI,CAAC;IACxB,KAAK,CAAC,EAAE,IAAI,CAAC;CACd,CAAC;AAEJ,MAAM,MAAM,UAAU,CAAC,YAAY,SAAS,WAAW,IACrD,YAAY,CAAC,iBAAiB,CAAC,CAAC;AAElC,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AAE9C,MAAM,MAAM,gBAAgB,GACxB,MAAM,GACN,MAAM,GACN,OAAO,GACP,IAAI,GACJ,SAAS,GACT,OAAO,EAAE,CAAC;AAEd,MAAM,MAAM,YAAY,CAAC,YAAY,SAAS,WAAW,GAAG,WAAW,IACnE,gBAAgB,GAChB,iBAAiB,GACjB,mBAAmB,GACnB,aAAa,CAAC,YAAY,CAAC,CAAC;AAEhC,MAAM,MAAM,GAAG,GAAG,YAAY,CAAC;AAE/B,MAAM,MAAM,KAAK,GAAG;IAClB,EAAE,EAAE;QACF,GAAG,EAAE,GAAG,CAAC;QACT,IAAI,EAAE,iBAAiB,CAAC;QACxB,IAAI,CAAC,EAAE,gBAAgB,EAAE,CAAC;QAC1B,KAAK,CAAC,EAAE,OAAO,CAAC;KACjB,GAAG,eAAe,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG,OAAO,CAAC;IAC9B,CAAC,GAAG,EAAE,iBAAiB,GAAG,KAAK,GAAG,SAAS,CAAC;CAC7C,CAAC,CAAC"}
+{"version":3,"file":"fields.d.ts","sourceRoot":"","sources":["../../src/types/fields.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAClD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD,MAAM,MAAM,iBAAiB,GAAG,MAAM,CAAC;AAEvC,MAAM,MAAM,SAAS,CAAC,YAAY,SAAS,WAAW,IACpD,YAAY,CAAC,YAAY,CAAC,SAAS,IAAI,GACnC,OAAO,CAAC,MAAM,YAAY,EAAE,MAAM,CAAC,GACnC,MAAM,CAAC;AAEb,MAAM,MAAM,aAAa,CAAC,YAAY,SAAS,WAAW,IACxD,OAAO,CAAC,WAAW,CAAC,GAAG;IACrB,IAAI,EAAE,SAAS,CAAC,YAAY,CAAC,CAAC;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,GAAG,CAAC;IACZ,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,qBAAqB,CAAC;IAChC,KAAK,CAAC,EAAE,QAAQ,GAAG,IAAI,CAAC;IACxB,KAAK,CAAC,EAAE,IAAI,CAAC;CACd,CAAC;AAEJ,MAAM,MAAM,UAAU,CAAC,YAAY,SAAS,WAAW,IACrD,YAAY,CAAC,iBAAiB,CAAC,CAAC;AAElC,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AAE9C,MAAM,MAAM,gBAAgB,GACxB,MAAM,GACN,MAAM,GACN,OAAO,GACP,IAAI,GACJ,SAAS,GACT,OAAO,EAAE,CAAC;AAEd,MAAM,MAAM,YAAY,CAAC,YAAY,SAAS,WAAW,GAAG,WAAW,IACnE,gBAAgB,GAChB,iBAAiB,GACjB,mBAAmB,GACnB,aAAa,CAAC,YAAY,CAAC,CAAC;AAEhC,MAAM,MAAM,GAAG,GAAG,YAAY,CAAC;AAE/B,MAAM,MAAM,KAAK,GAAG;IAClB,EAAE,EAAE;QACF,GAAG,EAAE,GAAG,CAAC;QACT,IAAI,EAAE,iBAAiB,CAAC;QACxB,IAAI,CAAC,EAAE,gBAAgB,EAAE,CAAC;QAC1B,KAAK,CAAC,EAAE,OAAO,CAAC;QAChB,EAAE,CAAC,EAAE,OAAO,CAAC;KACd,GAAG,eAAe,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG,OAAO,CAAC;IAC9B,CAAC,GAAG,EAAE,iBAAiB,GAAG,KAAK,GAAG,SAAS,CAAC;CAC7C,CAAC,CAAC"}

package/dist/types/form.d.ts

@@ -1,7 +1,7 @@
 import type React from 'react';
 import type { VALIDATION_MODE } from '../constants';
 import type { Subject } from '../utils/createSubject';
-import type { ErrorOption, FieldError, FieldErrors } from './errors';
+import type { ErrorOption, FieldErrors, FieldPathError, GlobalError } from './errors';
 import type { EventType } from './events';
 import type { FieldArray } from './fieldArray';
 import type { FieldName, FieldRefs, FieldValue, FieldValues, InternalFieldName } from './fields';
@@ -28,7 +28,7 @@ export type ValidationModeFlags = {
     isOnTouch: boolean;
 };
 export type CriteriaMode = 'firstError' | 'all';
-export type SubmitHandler<T> = (data: T, event?: React.BaseSyntheticEvent) => unknown | Promise<unknown>;
+export type SubmitHandler<T, TResult = unknown> = (data: T, event?: React.BaseSyntheticEvent) => TResult;
 export type FormSubmitHandler<TTransformedValues> = (payload: {
     data: TTransformedValues;
     event?: React.BaseSyntheticEvent;
@@ -41,9 +41,11 @@ export type SetValueConfig = Partial<{
     shouldValidate: boolean;
     shouldDirty: boolean;
     shouldTouch: boolean;
+    delayError: boolean;
 }>;
 export type TriggerConfig = Partial<{
     shouldFocus: boolean;
+    shouldTouch: boolean;
 }>;
 export type ResetFieldConfig<TFieldValues extends FieldValues, TFieldName extends FieldPath<TFieldValues> = FieldPath<TFieldValues>> = Partial<{
     keepDirty: boolean;
@@ -141,13 +143,13 @@ export type UseFormRegisterReturn<TFieldName extends InternalFieldName = Interna
     disabled?: boolean;
 };
 /**
- * Register field into hook form with or without the actual DOM ref. You can invoke register anywhere in the component including at `useEffect`.
+ * Registers a field into hook form with or without the actual DOM ref. You can invoke register anywhere in the component including in `useEffect`.
  *
  * @remarks
  * [API](https://react-hook-form.com/docs/useform/register) • [Demo](https://codesandbox.io/s/react-hook-form-register-ts-ip2j3) • [Video](https://www.youtube.com/watch?v=JFIpCoajYkA)
  *
- * @param name - the path name to the form field value, name is required and unique
- * @param options - register options include validation, disabled, unregister, value as and dependent validation
+ * @param name - The path name to the form field value; name is required and unique.
+ * @param options - Register options including validation, disabled, unregister, value as, and dependent validation.
  *
  * @returns onChange, onBlur, name, ref, and native HTML validation attributes if browser validation is enabled.
  *
@@ -178,13 +180,13 @@ export type SetFocusOptions = Partial<{
     shouldSelect: boolean;
 }>;
 /**
- * Set focus on a registered field. You can start to invoke this method after all fields are mounted to the DOM.
+ * Sets focus on a registered field. You can start to invoke this method after all fields are mounted to the DOM.
  *
  * @remarks
  * [API](https://react-hook-form.com/docs/useform/setfocus) • [Demo](https://codesandbox.io/s/setfocus-rolus)
  *
- * @param name - the path name to the form field value.
- * @param options - input focus behavior options
+ * @param name - The path name to the form field value.
+ * @param options - Input focus behavior options.
  *
  * @example
  * ```tsx
@@ -212,7 +214,7 @@ export type UseFormGetValues<TFieldValues extends FieldValues> = {
      * @remarks
      * [API](https://react-hook-form.com/docs/useform/getvalues) • [Demo](https://codesandbox.io/s/react-hook-form-v7-ts-getvalues-txsfg)
      *
-     * @returns form values
+     * @returns Form values.
      *
      * @example
      * ```tsx
@@ -230,8 +232,8 @@ export type UseFormGetValues<TFieldValues extends FieldValues> = {
      * @remarks
      * [API](https://react-hook-form.com/docs/useform/getvalues) • [Demo](https://codesandbox.io/s/react-hook-form-v7-ts-getvalues-txsfg)
      *
-     * @param name - the path name to the form field value.
-     * @param config - return touched or dirty fields
+     * @param name - The path name to the form field value.
+     * @param config - Return touched or dirty fields.
      *
      * @returns the single field value
      *
@@ -267,15 +269,60 @@ export type UseFormGetValues<TFieldValues extends FieldValues> = {
      */
     <TFieldNames extends FieldPath<TFieldValues>[]>(names: readonly [...TFieldNames], config?: GetValuesConfig): [...FieldPathValues<TFieldValues, TFieldNames>];
 };
+export type ErrorNamespacePath = 'root' | `root.${string}` | 'form' | `form.${string}`;
+/** Resolves the error type returned for a single `getErrors` path. */
+export type GetErrorsResult<TFieldValues extends FieldValues, TName extends FieldPath<TFieldValues> | ErrorNamespacePath> = TName extends 'root' ? (Record<string, GlobalError> & GlobalError) | undefined : TName extends ErrorNamespacePath ? GlobalError | undefined : TName extends FieldPath<TFieldValues> ? FieldPathError<TFieldValues, TName> | undefined : never;
+/** Gets currently stored form errors without subscribing or running validation. */
+export type UseFormGetErrors<TFieldValues extends FieldValues> = {
+    /**
+     * Get all currently stored form errors without subscribing or running validation.
+     *
+     * @returns Form errors.
+     *
+     * @example
+     * ```tsx
+     * const errors = getErrors();
+     * ```
+     */
+    (name?: undefined): FieldErrors<TFieldValues>;
+    /**
+     * Get a currently stored field or global error without subscribing or running validation.
+     *
+     * @param name - The path to the error.
+     *
+     * @returns The error at the given path.
+     *
+     * @example
+     * ```tsx
+     * const emailError = getErrors("email");
+     * ```
+     */
+    <TName extends FieldPath<TFieldValues> | ErrorNamespacePath>(name: TName): GetErrorsResult<TFieldValues, TName>;
+    /**
+     * Get currently stored errors for multiple paths without subscribing or running validation.
+     *
+     * @param names - An array of error paths.
+     *
+     * @returns Errors for the given paths in the same order.
+     *
+     * @example
+     * ```tsx
+     * const [emailError, nameError] = getErrors(["email", "name"]);
+     * ```
+     */
+    <TNames extends (FieldPath<TFieldValues> | ErrorNamespacePath)[]>(names: readonly [...TNames]): {
+        [K in keyof TNames]: GetErrorsResult<TFieldValues, TNames[K]>;
+    };
+};
 /**
- * This method will return individual field states. It will be useful when you are trying to retrieve the nested value field state in a typesafe approach.
+ * This method will return individual field states. It will be useful when you are trying to retrieve the nested value field state in a type-safe approach.
  *
  * @remarks
  * [API](https://react-hook-form.com/docs/useform/getfieldstate) • [Demo](https://codesandbox.io/s/getfieldstate-jvekk)
  *
- * @param name - the path name to the form field value.
+ * @param name - The path name to the form field value.
  *
- * @returns invalid, isDirty, isTouched, isValidating, and error object
+ * @returns invalid, isDirty, isTouched, isValidating, and error object.
  *
  * @example
  * ```tsx
@@ -296,15 +343,15 @@ export type UseFormGetFieldState<TFieldValues extends FieldValues> = <TFieldName
     isDirty: boolean;
     isTouched: boolean;
     isValidating: boolean;
-    error?: FieldError;
+    error?: FieldPathError<TFieldValues, TFieldName>;
 };
 /**
- * This method will allow you to subscribe to formState without component render
+ * This method will allow you to subscribe to formState without a component re-rendering.
  *
  * @remarks
  * [API](https://react-hook-form.com/docs/useform/subscribe) • [Demo](https://codesandbox.io/s/subscribe)
  *
- * @param options - subscription options on which formState subscribe to
+ * @param options - Subscription options to which formState subscribes.
  *
  * @example
  * ```tsx
@@ -330,12 +377,12 @@ export type UseFormSubscribe<TFieldValues extends FieldValues> = <TFieldNames ex
 }) => () => void;
 export type UseFormWatch<TFieldValues extends FieldValues> = {
     /**
-     * Watch and subscribe to the entire form update/change based on onChange and re-render at the useForm.
+     * Watch and subscribe to all form updates and changes based on onChange, and trigger re-renders at the useForm level.
      *
      * @remarks
      * [API](https://react-hook-form.com/docs/useform/watch) • [Demo](https://codesandbox.io/s/react-hook-form-watch-v7-ts-8et1d) • [Video](https://www.youtube.com/watch?v=3qLd69WMqKk)
      *
-     * @returns return the entire form values
+     * @returns The entire form values.
      *
      * @example
      * ```tsx
@@ -344,15 +391,41 @@ export type UseFormWatch<TFieldValues extends FieldValues> = {
      */
     (): TFieldValues;
     /**
-     * Watch and subscribe to an array of fields used outside of render.
+     * Watch and subscribe to the entire form update/change via callback, outside of render.
      *
      * @remarks
      * [API](https://react-hook-form.com/docs/useform/watch) • [Demo](https://codesandbox.io/s/react-hook-form-watch-v7-ts-8et1d) • [Video](https://www.youtube.com/watch?v=3qLd69WMqKk)
      *
-     * @param names - an array of field names
+     * @param callback - invoked with the latest form values whenever a relevant update occurs
      * @param defaultValue - defaultValues for the entire form
      *
-     * @returns return an array of field values
+     * @returns a subscription object; call `unsubscribe` to stop watching
+     *
+     * @example
+     * ```tsx
+     * useEffect(() => {
+     *   const { unsubscribe } = watch((value, { name, type }) => console.log(value, name, type));
+     *   return () => unsubscribe();
+     * }, [watch]);
+     * ```
+     */
+    (callback: (value: TFieldValues, info: {
+        name?: FieldPath<TFieldValues>;
+        type?: EventType;
+        value?: unknown;
+    }) => void, defaultValue?: DeepPartial<TFieldValues>): {
+        unsubscribe: () => void;
+    };
+    /**
+     * Watch and subscribe to an array of fields used outside of render.
+     *
+     * @remarks
+     * [API](https://react-hook-form.com/docs/useform/watch) • [Demo](https://codesandbox.io/s/react-hook-form-watch-v7-ts-8et1d) • [Video](https://www.youtube.com/watch?v=3qLd69WMqKk)
+     *
+     * @param names - An array of field names.
+     * @param defaultValue - DefaultValues for the entire form.
+     *
+     * @returns An array of field values.
      *
      * @example
      * ```tsx
@@ -369,7 +442,7 @@ export type UseFormWatch<TFieldValues extends FieldValues> = {
      * @param name - the path name to the form field value.
      * @param defaultValue - defaultValues for the entire form
      *
-     * @returns return the single field value
+     * @returns the single field value
      *
      * @example
      * ```tsx
@@ -379,15 +452,15 @@ export type UseFormWatch<TFieldValues extends FieldValues> = {
     <TFieldName extends FieldPath<TFieldValues>>(name: TFieldName, defaultValue?: FieldPathValue<TFieldValues, TFieldName>): FieldPathValue<TFieldValues, TFieldName>;
 };
 /**
- * Trigger field or form validation
+ * Triggers field or form validation.
  *
  * @remarks
  * [API](https://react-hook-form.com/docs/useform/trigger) • [Demo](https://codesandbox.io/s/react-hook-form-v7-ts-triggervalidation-forked-xs7hl) • [Video](https://www.youtube.com/watch?v=-bcyJCDjksE)
  *
- * @param name - provide empty argument will trigger the entire form validation, an array of field names will validate an array of fields, and a single field name will only trigger that field's validation.
- * @param options - should focus on the error field
+ * @param name - Providing no argument will trigger the entire form validation; an array of field names will validate those fields, and a single field name will only trigger that field's validation.
+ * @param options - Should focus on the error field, and/or mark the triggered field(s) as touched.
  *
- * @returns validation result
+ * @returns Validation result.
  *
  * @example
  * ```tsx
@@ -404,12 +477,12 @@ export type UseFormWatch<TFieldValues extends FieldValues> = {
  */
 export type UseFormTrigger<TFieldValues extends FieldValues> = (name?: FieldPath<TFieldValues> | FieldPath<TFieldValues>[] | readonly FieldPath<TFieldValues>[], options?: TriggerConfig) => Promise<boolean>;
 /**
- * Clear the entire form errors.
+ * Clears all form errors.
  *
  * @remarks
  * [API](https://react-hook-form.com/docs/useform/clearerrors) • [Demo](https://codesandbox.io/s/react-hook-form-v7-ts-clearerrors-w3ymx)
  *
- * @param name - the path name to the form field value.
+ * @param name - The path name to the form field value.
  *
  * @example
  * Clear all errors
@@ -419,16 +492,16 @@ export type UseFormTrigger<TFieldValues extends FieldValues> = (name?: FieldPath
  * clearErrors("name2"); // clear a single field error
  * ```
  */
-export type UseFormClearErrors<TFieldValues extends FieldValues> = (name?: FieldPath<TFieldValues> | FieldPath<TFieldValues>[] | readonly FieldPath<TFieldValues>[] | `root.${string}` | 'root' | 'form' | `form.${string}`) => void;
+export type UseFormClearErrors<TFieldValues extends FieldValues> = (name?: FieldPath<TFieldValues> | FieldPath<TFieldValues>[] | readonly FieldPath<TFieldValues>[] | ErrorNamespacePath) => void;
 /**
- * Set a single field value, or a group of fields value.
+ * Sets a single field value, or a group of field values.
  *
  * @remarks
  * [API](https://react-hook-form.com/docs/useform/setvalue) • [Demo](https://codesandbox.io/s/react-hook-form-v7-ts-setvalue-8z9hx) • [Video](https://www.youtube.com/watch?v=qpv51sCH3fI)
  *
- * @param name - the path name to the form field value.
- * @param value - field value
- * @param options - should validate or update form state
+ * @param name - The path name to the form field value.
+ * @param value - Field value.
+ * @param options - Should validate or update form state.
  *
  * @example
  * ```tsx
@@ -439,7 +512,7 @@ export type UseFormClearErrors<TFieldValues extends FieldValues> = (name?: Field
  *   shouldDirty: true, // update dirty and dirty fields form state
  * });
  *
- * // Update a group fields
+ * // Update a group of fields
  * setValue('root', {
  *   a: 'test', // setValue('root.a', 'data')
  *   b: 'test1', // setValue('root.b', 'data')
@@ -452,18 +525,18 @@ export type UseFormClearErrors<TFieldValues extends FieldValues> = (name?: Field
 export type UseFormSetValue<TFieldValues extends FieldValues> = <TFieldName extends FieldPath<TFieldValues> = FieldPath<TFieldValues>>(name: TFieldName, value: FieldPathValue<TFieldValues, TFieldName>, options?: SetValueConfig) => void;
 export type UseFormSetValues<TFieldValues extends FieldValues> = (value: Partial<TFieldValues> | ResetAction<TFieldValues>, options?: SetValueConfig) => void;
 /**
- * Set an error for the field. When set an error which is not associated to a field then manual `clearErrors` invoke is required.
+ * Sets an error for a field. When setting an error that is not associated with a field, a manual `clearErrors` call is required.
  *
  * @remarks
  * [API](https://react-hook-form.com/docs/useform/seterror) • [Demo](https://codesandbox.io/s/react-hook-form-v7-ts-seterror-nfxxu) • [Video](https://www.youtube.com/watch?v=raMqvE0YyIY)
  *
- * @param name - the path name to the form field value.
- * @param error - an error object which contains type and optional message
- * @param options - whether or not to focus on the field
+ * @param name - The path name to the form field value.
+ * @param error - An error object containing the type and an optional message.
+ * @param options - Whether or not to focus on the field.
  *
  * @example
  * ```tsx
- * // when the error is not associated with any fields, `clearError` will need to invoke to clear the error
+ * // When the error is not associated with any fields, `clearErrors` will need to be invoked to clear the error.
  * const onSubmit = () => setError("serverError", { type: "server", message: "Error occurred"})
  *
  * <button onClick={() => setError("name", { type: "min" })} />
@@ -472,17 +545,17 @@ export type UseFormSetValues<TFieldValues extends FieldValues> = (value: Partial
  * <button onClick={() => setError("name", { type: "max" }, { shouldFocus: true })} />
  * ```
  */
-export type UseFormSetError<TFieldValues extends FieldValues> = (name: FieldPath<TFieldValues> | `root.${string}` | 'root' | 'form' | `form.${string}`, error: ErrorOption, options?: {
+export type UseFormSetError<TFieldValues extends FieldValues> = (name: FieldPath<TFieldValues> | ErrorNamespacePath, error: ErrorOption, options?: {
     shouldFocus: boolean;
 }) => void;
 /**
- * Unregister a field reference and remove its value.
+ * Unregisters a field reference and removes its value.
  *
  * @remarks
  * [API](https://react-hook-form.com/docs/useform/unregister) • [Demo](https://codesandbox.io/s/react-hook-form-unregister-4k2ey) • [Video](https://www.youtube.com/watch?v=TM99g_NW5Gk&feature=emb_imp_woyt)
  *
- * @param name - the path name to the form field value.
- * @param options - keep form state options
+ * @param name - The path name to the form field value.
+ * @param options - Keep form state options.
  *
  * @example
  * ```tsx
@@ -499,15 +572,15 @@ export type UseFormUnregister<TFieldValues extends FieldValues> = (name?: FieldP
     keepError?: boolean;
 }) => void;
 /**
- * Validate the entire form. Handle submit and error callback.
+ * Validates the entire form. Handles the submit and error callbacks.
  *
  * @remarks
  * [API](https://react-hook-form.com/docs/useform/handlesubmit) • [Demo](https://codesandbox.io/s/react-hook-form-handlesubmit-ts-v7-lcrtu) • [Video](https://www.youtube.com/watch?v=KzcPKB9SOEk)
  *
- * @param onValid - callback function invoked after form pass validation
- * @param onInvalid - callback function invoked when form failed validation
+ * @param onValid - Callback function invoked after the form passes validation.
+ * @param onInvalid - Callback function invoked when the form fails validation.
  *
- * @returns callback - return callback function
+ * @returns Callback function.
  *
  * @example
  * ```tsx
@@ -517,15 +590,15 @@ export type UseFormUnregister<TFieldValues extends FieldValues> = (name?: FieldP
  * <form onSubmit={handleSubmit(onSubmit, onError)} />
  * ```
  */
-export type UseFormHandleSubmit<TFieldValues extends FieldValues, TTransformedValues = TFieldValues> = (onValid: SubmitHandler<TTransformedValues>, onInvalid?: SubmitErrorHandler<TFieldValues>) => (e?: React.BaseSyntheticEvent) => Promise<void>;
+export type UseFormHandleSubmit<TFieldValues extends FieldValues, TTransformedValues = TFieldValues> = <TResult>(onValid: SubmitHandler<TTransformedValues, TResult>, onInvalid?: SubmitErrorHandler<TFieldValues>) => (e?: React.BaseSyntheticEvent) => Promise<Awaited<TResult> | undefined>;
 /**
- * Reset a field state and reference.
+ * Resets a field's state and reference.
  *
  * @remarks
  * [API](https://react-hook-form.com/docs/useform/resetfield) • [Demo](https://codesandbox.io/s/priceless-firefly-d0kuv) • [Video](https://www.youtube.com/watch?v=IdLFcNaEFEo)
  *
- * @param name - the path name to the form field value.
- * @param options - keep form state options
+ * @param name - The path name to the form field value.
+ * @param options - Keep form state options.
  *
  * @example
  * ```tsx
@@ -536,25 +609,25 @@ export type UseFormHandleSubmit<TFieldValues extends FieldValues, TTransformedVa
 export type UseFormResetField<TFieldValues extends FieldValues> = <TFieldName extends FieldPath<TFieldValues> = FieldPath<TFieldValues>>(name: TFieldName, options?: ResetFieldConfig<TFieldValues, TFieldName>) => void;
 type ResetAction<TFieldValues> = (formValues: TFieldValues) => TFieldValues;
 /**
- * Reset at the entire form state.
+ * Resets the entire form state.
  *
  * @remarks
  * [API](https://react-hook-form.com/docs/useform/reset) • [Demo](https://codesandbox.io/s/react-hook-form-reset-v7-ts-pu901) • [Video](https://www.youtube.com/watch?v=qmCLBjyPwVk)
  *
- * @param values - the entire form values to be reset
- * @param keepStateOptions - keep form state options
+ * @param values - The entire form values to be reset.
+ * @param keepStateOptions - Keep form state options.
  *
  * @example
  * ```tsx
  * useEffect(() => {
- *   // reset the entire form after component mount or form defaultValues is ready
+ *   // reset the entire form after component mount or form defaultValues are ready
  *   reset({
  *     fieldA: "test"
  *     fieldB: "test"
  *   });
  * }, [reset])
  *
- * // reset by combine with existing form values
+ * // Reset by combining with existing form values
  * reset({
  *   ...getValues(),
  *  fieldB: "test"
@@ -570,6 +643,25 @@ type ResetAction<TFieldValues> = (formValues: TFieldValues) => TFieldValues;
  * ```
  */
 export type UseFormReset<TFieldValues extends FieldValues> = (values?: DefaultValues<TFieldValues> | TFieldValues | ResetAction<TFieldValues>, keepStateOptions?: KeepStateOptions) => void;
+/**
+ * Resets the default values of the form and recomputes `dirtyFields`/`isDirty` without changing user values.
+ *
+ * @remarks
+ * [API](https://react-hook-form.com/docs/useform/resetdefaultvalues)
+ *
+ * @param values - The new default values.
+ * @param options - Options to keep dirty or isValid state.
+ *
+ * @example
+ * ```tsx
+ * // After a successful submission, update defaults to the submitted values
+ * // so that dirtyFields/isDirty reflect changes made after that point.
+ * const onSuccess = () => {
+ *   resetDefaultValues(submittedValues);
+ * };
+ * ```
+ */
+export type UseFormResetDefaultValues<TFieldValues extends FieldValues> = (values: DefaultValues<TFieldValues> | TFieldValues, options?: Partial<Pick<KeepStateOptions, 'keepDirty' | 'keepIsValid'>>) => void;
 export type WatchInternal<TFieldValues> = (fieldNames?: InternalFieldName | InternalFieldName[], defaultValue?: DeepPartial<TFieldValues>, isMounted?: boolean, isGlobal?: boolean) => FieldPathValue<FieldValues, InternalFieldName> | FieldPathValues<FieldValues, InternalFieldName[]>;
 export type GetIsDirty = <TName extends InternalFieldName, TData>(name?: TName, data?: TData) => boolean;
 export type FormStateSubjectRef<TFieldValues extends FieldValues> = Subject<Partial<FormState<TFieldValues>> & {
@@ -615,6 +707,7 @@ export type Control<TFieldValues extends FieldValues = FieldValues, TContext = a
     _state: {
         mount: boolean;
         action: boolean;
+        actionArrayLengths: Map<InternalFieldName, number>;
         watch: boolean;
     };
     _reset: UseFormReset<TFieldValues>;
@@ -651,6 +744,7 @@ export type Control<TFieldValues extends FieldValues = FieldValues, TContext = a
 export type UseFormReturn<TFieldValues extends FieldValues = FieldValues, TContext = any, TTransformedValues = TFieldValues> = {
     watch: UseFormWatch<TFieldValues>;
     getValues: UseFormGetValues<TFieldValues>;
+    getErrors: UseFormGetErrors<TFieldValues>;
     getFieldState: UseFormGetFieldState<TFieldValues>;
     setError: UseFormSetError<TFieldValues>;
     clearErrors: UseFormClearErrors<TFieldValues>;
@@ -660,6 +754,7 @@ export type UseFormReturn<TFieldValues extends FieldValues = FieldValues, TConte
     formState: FormState<TFieldValues>;
     resetField: UseFormResetField<TFieldValues>;
     reset: UseFormReset<TFieldValues>;
+    resetDefaultValues: UseFormResetDefaultValues<TFieldValues>;
     handleSubmit: UseFormHandleSubmit<TFieldValues, TTransformedValues>;
     unregister: UseFormUnregister<TFieldValues>;
     control: Control<TFieldValues, TContext, TTransformedValues>;