@tanstack/form-core 1.0.3 → 1.1.0

package/src/FieldApi.ts

@@ -3,6 +3,7 @@ import {
   isStandardSchemaValidator,
   standardSchemaValidators,
 } from './standardSchemaValidator'
+import { defaultFieldMeta } from './metaHelper'
 import { getAsyncValidatorArray, getBy, getSyncValidatorArray } from './utils'
 import type { DeepKeys, DeepValue, UnwrapOneLevelOfArray } from './util-types'
 import type {
@@ -1007,13 +1008,7 @@ export class FieldApi<
       fn: () => {
         const value = this.form.getFieldValue(this.name)
         const meta = this.form.getFieldMeta(this.name) ?? {
-          isValidating: false,
-          isTouched: false,
-          isBlurred: false,
-          isDirty: false,
-          isPristine: true,
-          errors: [],
-          errorMap: {},
+          ...defaultFieldMeta,
           ...opts.defaultMeta,
         }
 
@@ -1226,7 +1221,14 @@ export class FieldApi<
   pushValue = (
     value: TData extends any[] ? TData[number] : never,
     opts?: UpdateMetaOptions,
-  ) => this.form.pushFieldValue(this.name, value as any, opts)
+  ) => {
+    this.form.pushFieldValue(this.name, value as any, opts)
+
+    this.options.listeners?.onChange?.({
+      value: this.state.value,
+      fieldApi: this,
+    })
+  }
 
   /**
    * Inserts a value at the specified index, shifting the subsequent values to the right.
@@ -1235,7 +1237,14 @@ export class FieldApi<
     index: number,
     value: TData extends any[] ? TData[number] : never,
     opts?: UpdateMetaOptions,
-  ) => this.form.insertFieldValue(this.name, index, value as any, opts)
+  ) => {
+    this.form.insertFieldValue(this.name, index, value as any, opts)
+
+    this.options.listeners?.onChange?.({
+      value: this.state.value,
+      fieldApi: this,
+    })
+  }
 
   /**
    * Replaces a value at the specified index.
@@ -1244,26 +1253,51 @@ export class FieldApi<
     index: number,
     value: TData extends any[] ? TData[number] : never,
     opts?: UpdateMetaOptions,
-  ) => this.form.replaceFieldValue(this.name, index, value as any, opts)
+  ) => {
+    this.form.replaceFieldValue(this.name, index, value as any, opts)
+
+    this.options.listeners?.onChange?.({
+      value: this.state.value,
+      fieldApi: this,
+    })
+  }
 
   /**
    * Removes a value at the specified index.
    */
-  removeValue = (index: number, opts?: UpdateMetaOptions) =>
+  removeValue = (index: number, opts?: UpdateMetaOptions) => {
     this.form.removeFieldValue(this.name, index, opts)
 
+    this.options.listeners?.onChange?.({
+      value: this.state.value,
+      fieldApi: this,
+    })
+  }
+
   /**
    * Swaps the values at the specified indices.
    */
-  swapValues = (aIndex: number, bIndex: number, opts?: UpdateMetaOptions) =>
+  swapValues = (aIndex: number, bIndex: number, opts?: UpdateMetaOptions) => {
     this.form.swapFieldValues(this.name, aIndex, bIndex, opts)
 
+    this.options.listeners?.onChange?.({
+      value: this.state.value,
+      fieldApi: this,
+    })
+  }
+
   /**
    * Moves the value at the first specified index to the second specified index.
    */
-  moveValue = (aIndex: number, bIndex: number, opts?: UpdateMetaOptions) =>
+  moveValue = (aIndex: number, bIndex: number, opts?: UpdateMetaOptions) => {
     this.form.moveFieldValues(this.name, aIndex, bIndex, opts)
 
+    this.options.listeners?.onChange?.({
+      value: this.state.value,
+      fieldApi: this,
+    })
+  }
+
   /**
    * @private
    */

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