@tanstack/form-core 1.0.5 → 1.1.0

package/src/FormApi.ts

@@ -10,11 +10,12 @@ import {
   setBy,
   shallow,
 } from './utils'
+
 import {
   isStandardSchemaValidator,
   standardSchemaValidators,
 } from './standardSchemaValidator'
-import { metaHelper } from './metaHelper'
+import { defaultFieldMeta, metaHelper } from './metaHelper'
 import type {
   StandardSchemaV1,
   StandardSchemaV1Issue,
@@ -1715,21 +1716,16 @@ export class FormApi<
     })
   }
 
+  /**
+   * resets every field's meta
+   */
   resetFieldMeta = <TField extends DeepKeys<TFormData>>(
     fieldMeta: Record<TField, AnyFieldMeta>,
   ): Record<TField, AnyFieldMeta> => {
     return Object.keys(fieldMeta).reduce(
       (acc: Record<TField, AnyFieldMeta>, key) => {
         const fieldKey = key as TField
-        acc[fieldKey] = {
-          isValidating: false,
-          isTouched: false,
-          isBlurred: false,
-          isDirty: false,
-          isPristine: true,
-          errors: [],
-          errorMap: {},
-        }
+        acc[fieldKey] = defaultFieldMeta
         return acc
       },
       {} as Record<TField, AnyFieldMeta>,
@@ -1956,6 +1952,28 @@ export class FormApi<
     this.validateField(`${field}[${index1}]` as DeepKeys<TFormData>, 'change')
     this.validateField(`${field}[${index2}]` as DeepKeys<TFormData>, 'change')
   }
+
+  /**
+   * Resets the field value and meta to default state
+   */
+  resetField = <TField extends DeepKeys<TFormData>>(field: TField) => {
+    this.baseStore.setState((prev) => {
+      return {
+        ...prev,
+        fieldMetaBase: {
+          ...prev.fieldMetaBase,
+          [field]: defaultFieldMeta,
+        },
+        values: {
+          ...prev.values,
+          [field]:
+            this.options.defaultValues &&
+            this.options.defaultValues[field as keyof TFormData],
+        },
+      }
+    })
+  }
+
   /**
    * Updates the form's errorMap
    */

package/src/metaHelper.ts

@@ -8,6 +8,16 @@ import type { DeepKeys } from './util-types'
 
 type ArrayFieldMode = 'insert' | 'remove' | 'swap' | 'move'
 
+export const defaultFieldMeta: AnyFieldMeta = {
+  isValidating: false,
+  isTouched: false,
+  isBlurred: false,
+  isDirty: false,
+  isPristine: true,
+  errors: [],
+  errorMap: {},
+}
+
 export function metaHelper<
   TFormData,
   TOnMount extends undefined | FormValidateOrFn<TFormData>,
@@ -116,15 +126,7 @@ export function metaHelper<
     })
   }
 
-  const getEmptyFieldMeta = (): AnyFieldMeta => ({
-    isValidating: false,
-    isTouched: false,
-    isBlurred: false,
-    isDirty: false,
-    isPristine: true,
-    errors: [],
-    errorMap: {},
-  })
+  const getEmptyFieldMeta = (): AnyFieldMeta => defaultFieldMeta
 
   const handleInsertMode = (
     fields: DeepKeys<TFormData>[],

package/src/utils.ts

@@ -1,6 +1,6 @@
 import type { GlobalFormValidationError, ValidationCause } from './types'
 import type { FormValidators } from './FormApi'
-import type { FieldValidators } from './FieldApi'
+import type { AnyFieldMeta, FieldValidators } from './FieldApi'
 
 export type UpdaterFn<TInput, TOutput = TInput> = (input: TInput) => TOutput