@tanstack/form-core 1.8.0 → 1.9.1

package/src/FieldApi.ts

@@ -652,6 +652,10 @@ export type FieldMetaDerived<
    * A flag that is `true` if the field's value has not been modified by the user. Opposite of `isDirty`.
    */
   isPristine: boolean
+  /**
+   * A boolean indicating if the field is valid. Evaluates `true` if there are no field errors.
+   */
+  isValid: boolean
 }
 
 export type AnyFieldMetaDerived = FieldMetaDerived<
@@ -1213,7 +1217,7 @@ export class FieldApi<
    */
   setMeta = (
     updater: Updater<
-      FieldMeta<
+      FieldMetaBase<
         TParentData,
         TName,
         TData,
@@ -1667,17 +1671,24 @@ export class FieldApi<
   /**
    * Updates the field's errorMap
    */
-  setErrorMap(errorMap: ValidationErrorMap) {
-    this.setMeta(
-      (prev) =>
-        ({
-          ...prev,
-          errorMap: {
-            ...prev.errorMap,
-            ...errorMap,
-          },
-        }) as never,
-    )
+  setErrorMap(
+    errorMap: ValidationErrorMap<
+      UnwrapFieldValidateOrFn<TName, TOnMount, TFormOnMount>,
+      UnwrapFieldValidateOrFn<TName, TOnChange, TFormOnChange>,
+      UnwrapFieldAsyncValidateOrFn<TName, TOnChangeAsync, TFormOnChangeAsync>,
+      UnwrapFieldValidateOrFn<TName, TOnBlur, TFormOnBlur>,
+      UnwrapFieldAsyncValidateOrFn<TName, TOnBlurAsync, TFormOnBlurAsync>,
+      UnwrapFieldValidateOrFn<TName, TOnSubmit, TFormOnSubmit>,
+      UnwrapFieldAsyncValidateOrFn<TName, TOnSubmitAsync, TFormOnSubmitAsync>
+    >,
+  ) {
+    this.setMeta((prev) => ({
+      ...prev,
+      errorMap: {
+        ...prev.errorMap,
+        ...errorMap,
+      },
+    }))
   }
 
   /**

package/src/FormApi.ts

@@ -607,7 +607,7 @@ export type DerivedFormState<
    */
   isFieldsValidating: boolean
   /**
-   * A boolean indicating if all the form fields are valid.
+   * A boolean indicating if all the form fields are valid. Evaluates `true` if there are no field errors.
    */
   isFieldsValid: boolean
   /**
@@ -619,15 +619,15 @@ export type DerivedFormState<
    */
   isBlurred: boolean
   /**
-   * A boolean indicating if any of the form's fields' values have been modified by the user. `True` if the user have modified at least one of the fields. Opposite of `isPristine`.
+   * A boolean indicating if any of the form's fields' values have been modified by the user. Evaluates `true` if the user have modified at least one of the fields. Opposite of `isPristine`.
    */
   isDirty: boolean
   /**
-   * A boolean indicating if none of the form's fields' values have been modified by the user. `True` if the user have not modified any of the fields. Opposite of `isDirty`.
+   * A boolean indicating if none of the form's fields' values have been modified by the user. Evaluates `true` if the user have not modified any of the fields. Opposite of `isDirty`.
    */
   isPristine: boolean
   /**
-   * A boolean indicating if the form and all its fields are valid.
+   * A boolean indicating if the form and all its fields are valid. Evaluates `true` if there are no errors.
    */
   isValid: boolean
   /**
@@ -911,12 +911,14 @@ export class FormApi<
             }
           }
 
-          // As a primitive, we don't need to aggressively persist the same referential value for performance reasons
+          // As primitives, we don't need to aggressively persist the same referential value for performance reasons
           const isFieldPristine = !currBaseVal.isDirty
+          const isFieldValid = !isNonEmptyArray(fieldErrors ?? [])
 
           if (
             prevFieldInfo &&
             prevFieldInfo.isPristine === isFieldPristine &&
+            prevFieldInfo.isValid === isFieldValid &&
             prevFieldInfo.errors === fieldErrors &&
             currBaseVal === prevBaseVal
           ) {
@@ -929,6 +931,7 @@ export class FormApi<
             ...currBaseVal,
             errors: fieldErrors,
             isPristine: isFieldPristine,
+            isValid: isFieldValid,
           } as AnyFieldMeta
         }
 
@@ -963,31 +966,27 @@ export class FormApi<
           | undefined
         const prevBaseStore = prevDepVals?.[0]
         const currBaseStore = currDepVals[0]
+        const currFieldMeta = currDepVals[1]
 
         // Computed state
-        const fieldMetaValues = Object.values(currBaseStore.fieldMetaBase) as (
-          | AnyFieldMeta
-          | undefined
-        )[]
+        const fieldMetaValues = Object.values(currFieldMeta).filter(
+          Boolean,
+        ) as AnyFieldMeta[]
 
         const isFieldsValidating = fieldMetaValues.some(
-          (field) => field?.isValidating,
+          (field) => field.isValidating,
         )
 
-        const isFieldsValid = !fieldMetaValues.some(
-          (field) =>
-            field?.errorMap &&
-            isNonEmptyArray(Object.values(field.errorMap).filter(Boolean)),
-        )
+        const isFieldsValid = fieldMetaValues.every((field) => field.isValid)
 
-        const isTouched = fieldMetaValues.some((field) => field?.isTouched)
-        const isBlurred = fieldMetaValues.some((field) => field?.isBlurred)
+        const isTouched = fieldMetaValues.some((field) => field.isTouched)
+        const isBlurred = fieldMetaValues.some((field) => field.isBlurred)
 
         const shouldInvalidateOnMount =
           // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
-          isTouched && currBaseStore?.errorMap?.onMount
+          isTouched && currBaseStore.errorMap?.onMount
 
-        const isDirty = fieldMetaValues.some((field) => field?.isDirty)
+        const isDirty = fieldMetaValues.some((field) => field.isDirty)
         const isPristine = !isDirty
 
         const hasOnMountError = Boolean(
@@ -1845,7 +1844,7 @@ export class FormApi<
    */
   setFieldMeta = <TField extends DeepKeys<TFormData>>(
     field: TField,
-    updater: Updater<AnyFieldMeta>,
+    updater: Updater<AnyFieldMetaBase>,
   ) => {
     this.baseStore.setState((prev) => {
       return {
@@ -2124,25 +2123,23 @@ export class FormApi<
    */
   setErrorMap(
     errorMap: ValidationErrorMap<
-      TOnMount,
-      TOnChange,
-      TOnChangeAsync,
-      TOnBlur,
-      TOnBlurAsync,
-      TOnSubmit,
-      TOnSubmitAsync
+      UnwrapFormValidateOrFn<TOnMount>,
+      UnwrapFormValidateOrFn<TOnChange>,
+      UnwrapFormAsyncValidateOrFn<TOnChangeAsync>,
+      UnwrapFormValidateOrFn<TOnBlur>,
+      UnwrapFormAsyncValidateOrFn<TOnBlurAsync>,
+      UnwrapFormValidateOrFn<TOnSubmit>,
+      UnwrapFormAsyncValidateOrFn<TOnSubmitAsync>,
+      UnwrapFormAsyncValidateOrFn<TOnServer>
     >,
   ) {
-    this.baseStore.setState(
-      (prev) =>
-        ({
-          ...prev,
-          errorMap: {
-            ...prev.errorMap,
-            ...errorMap,
-          },
-        }) as never,
-    )
+    this.baseStore.setState((prev) => ({
+      ...prev,
+      errorMap: {
+        ...prev.errorMap,
+        ...errorMap,
+      },
+    }))
   }
 
   /**

package/src/metaHelper.ts

@@ -14,6 +14,7 @@ export const defaultFieldMeta: AnyFieldMeta = {
   isBlurred: false,
   isDirty: false,
   isPristine: true,
+  isValid: true,
   errors: [],
   errorMap: {},
   errorSourceMap: {},

package/src/utils.ts

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