@tanstack/form-core 0.42.1 → 0.43.0

package/dist/cjs/FieldApi.d.cts

@@ -1,58 +1,66 @@
 import { Derived } from '@tanstack/store';
-import { FieldInfo, FieldsErrorMapFromValidator, FormApi } from './FormApi.cjs';
-import { StandardSchemaV1 } from './standardSchemaValidator.cjs';
-import { UpdateMetaOptions, ValidationCause, ValidationError, ValidationErrorMap, ValidationSource, Validator } from './types.cjs';
-import { DeepKeys, DeepValue, NoInfer } from './util-types.cjs';
+import { DeepKeys, DeepValue, NoInfer, UnwrapOneLevelOfArray } from './util-types.cjs';
+import { StandardSchemaV1, StandardSchemaV1Issue, TStandardSchemaValidatorValue } from './standardSchemaValidator.cjs';
+import { FieldInfo, FormApi, FormAsyncValidateOrFn, FormValidateOrFn, UnwrapFormAsyncValidateOrFn, UnwrapFormValidateOrFn } from './FormApi.cjs';
+import { UpdateMetaOptions, ValidationCause, ValidationError, ValidationErrorMap } from './types.cjs';
 import { Updater } from './utils.cjs';
 /**
  * @private
  */
-export type FieldValidateFn<TParentData, TName extends DeepKeys<TParentData>, TFieldValidator extends Validator<DeepValue<TParentData, TName>, unknown> | undefined = undefined, TFormValidator extends Validator<TParentData, unknown> | undefined = undefined, TData extends DeepValue<TParentData, TName> = DeepValue<TParentData, TName>> = (props: {
+type FieldErrorMapFromValidator<TFormData, TName extends DeepKeys<TFormData>, TData extends DeepValue<TFormData, TName>, TOnMount extends undefined | FieldValidateOrFn<TFormData, TName, TData>, TOnChange extends undefined | FieldValidateOrFn<TFormData, TName, TData>, TOnChangeAsync extends undefined | FieldAsyncValidateOrFn<TFormData, TName, TData>, TOnBlur extends undefined | FieldValidateOrFn<TFormData, TName, TData>, TOnBlurAsync extends undefined | FieldAsyncValidateOrFn<TFormData, TName, TData>, TOnSubmit extends undefined | FieldValidateOrFn<TFormData, TName, TData>, TOnSubmitAsync extends undefined | FieldAsyncValidateOrFn<TFormData, TName, TData>> = Partial<Record<DeepKeys<TFormData>, ValidationErrorMap<TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync>>>;
+/**
+ * @private
+ */
+export type FieldValidateFn<TParentData, TName extends DeepKeys<TParentData>, TData extends DeepValue<TParentData, TName> = DeepValue<TParentData, TName>> = (props: {
     value: TData;
-    fieldApi: FieldApi<TParentData, TName, TFieldValidator, TFormValidator, TData>;
-}) => ValidationError;
+    fieldApi: FieldApi<TParentData, TName, TData, any, any, any, any, any, any, any, any, any, any, any, any, any, any, any>;
+}) => unknown;
 /**
  * @private
  */
-export type FieldValidateOrFn<TParentData, TName extends DeepKeys<TParentData>, TFieldValidator extends Validator<DeepValue<TParentData, TName>, unknown> | undefined = undefined, TFormValidator extends Validator<TParentData, unknown> | undefined = undefined, TData extends DeepValue<TParentData, TName> = DeepValue<TParentData, TName>> = (TFieldValidator extends Validator<TData, infer TFN> ? TFN : never) | (TFormValidator extends Validator<TParentData, infer FFN> ? FFN : never) | FieldValidateFn<TParentData, TName, TFieldValidator, TFormValidator, TData> | StandardSchemaV1<TData, unknown>;
+export type FieldValidateOrFn<TParentData, TName extends DeepKeys<TParentData>, TData extends DeepValue<TParentData, TName> = DeepValue<TParentData, TName>> = FieldValidateFn<TParentData, TName, TData> | StandardSchemaV1<TData, unknown>;
+export type UnwrapFieldValidateOrFn<TParentData, TName extends DeepKeys<TParentData>, TValidateOrFn extends undefined | FieldValidateOrFn<any, any, any>, TFormValidateOrFn extends undefined | FormValidateOrFn<any>> = ([TFormValidateOrFn] extends [StandardSchemaV1<any, infer TStandardOut>] ? TName extends keyof TStandardOut ? StandardSchemaV1Issue[] : undefined : undefined) | (UnwrapFormValidateOrFn<TFormValidateOrFn> extends infer TFormValidateVal ? TFormValidateVal extends {
+    fields: any;
+} ? TName extends keyof TFormValidateVal['fields'] ? TFormValidateVal['fields'][TName] : undefined : undefined : never) | ([TValidateOrFn] extends [FieldValidateFn<any, any, any>] ? ReturnType<TValidateOrFn> : [TValidateOrFn] extends [StandardSchemaV1<any, any>] ? StandardSchemaV1Issue[] : undefined);
 /**
  * @private
  */
-export type FieldValidateAsyncFn<TParentData, TName extends DeepKeys<TParentData>, TFieldValidator extends Validator<DeepValue<TParentData, TName>, unknown> | undefined = undefined, TFormValidator extends Validator<TParentData, unknown> | undefined = undefined, TData extends DeepValue<TParentData, TName> = DeepValue<TParentData, TName>> = (options: {
+export type FieldValidateAsyncFn<TParentData, TName extends DeepKeys<TParentData>, TData extends DeepValue<TParentData, TName> = DeepValue<TParentData, TName>> = (options: {
     value: TData;
-    fieldApi: FieldApi<TParentData, TName, TFieldValidator, TFormValidator, TData>;
+    fieldApi: FieldApi<TParentData, TName, TData, any, any, any, any, any, any, any, any, any, any, any, any, any, any, any>;
     signal: AbortSignal;
-}) => ValidationError | Promise<ValidationError>;
+}) => unknown | Promise<unknown>;
 /**
  * @private
  */
-export type FieldAsyncValidateOrFn<TParentData, TName extends DeepKeys<TParentData>, TFieldValidator extends Validator<DeepValue<TParentData, TName>, unknown> | undefined = undefined, TFormValidator extends Validator<TParentData, unknown> | undefined = undefined, TData extends DeepValue<TParentData, TName> = DeepValue<TParentData, TName>> = (TFieldValidator extends Validator<TData, infer TFN> ? TFN : never) | (TFormValidator extends Validator<TParentData, infer FFN> ? FFN : never) | FieldValidateAsyncFn<TParentData, TName, TFieldValidator, TFormValidator, TData> | StandardSchemaV1<TData, unknown>;
+export type FieldAsyncValidateOrFn<TParentData, TName extends DeepKeys<TParentData>, TData extends DeepValue<TParentData, TName> = DeepValue<TParentData, TName>> = FieldValidateAsyncFn<TParentData, TName, TData> | StandardSchemaV1<TData, unknown>;
+export type UnwrapFieldAsyncValidateOrFn<TParentData, TName extends DeepKeys<TParentData>, TValidateOrFn extends undefined | FieldAsyncValidateOrFn<any, any, any>, TFormValidateOrFn extends undefined | FormAsyncValidateOrFn<any>> = ([TFormValidateOrFn] extends [StandardSchemaV1<any, infer TStandardOut>] ? TName extends keyof TStandardOut ? StandardSchemaV1Issue[] : undefined : undefined) | (UnwrapFormAsyncValidateOrFn<TFormValidateOrFn> extends infer TFormValidateVal ? TFormValidateVal extends {
+    fields: any;
+} ? TName extends keyof TFormValidateVal['fields'] ? TFormValidateVal['fields'][TName] : undefined : undefined : never) | ([TValidateOrFn] extends [FieldValidateAsyncFn<any, any, any>] ? Awaited<ReturnType<TValidateOrFn>> : [TValidateOrFn] extends [StandardSchemaV1<any, any>] ? StandardSchemaV1Issue[] : undefined);
 /**
  * @private
  */
-export type FieldListenerFn<TParentData, TName extends DeepKeys<TParentData>, TFieldValidator extends Validator<DeepValue<TParentData, TName>, unknown> | undefined = undefined, TFormValidator extends Validator<TParentData, unknown> | undefined = undefined, TData extends DeepValue<TParentData, TName> = DeepValue<TParentData, TName>> = (props: {
+export type FieldListenerFn<TParentData, TName extends DeepKeys<TParentData>, TData extends DeepValue<TParentData, TName> = DeepValue<TParentData, TName>> = (props: {
     value: TData;
-    fieldApi: FieldApi<TParentData, TName, TFieldValidator, TFormValidator, TData>;
+    fieldApi: FieldApi<TParentData, TName, TData, any, any, any, any, any, any, any, any, any, any, any, any, any, any, any>;
 }) => void;
-export interface FieldValidators<TParentData, TName extends DeepKeys<TParentData>, TFieldValidator extends Validator<DeepValue<TParentData, TName>, unknown> | undefined = undefined, TFormValidator extends Validator<TParentData, unknown> | undefined = undefined, TData extends DeepValue<TParentData, TName> = DeepValue<TParentData, TName>> {
+export interface FieldValidators<TParentData, TName extends DeepKeys<TParentData>, TData extends DeepValue<TParentData, TName>, TOnMount extends undefined | FieldValidateOrFn<TParentData, TName, TData>, TOnChange extends undefined | FieldValidateOrFn<TParentData, TName, TData>, TOnChangeAsync extends undefined | FieldAsyncValidateOrFn<TParentData, TName, TData>, TOnBlur extends undefined | FieldValidateOrFn<TParentData, TName, TData>, TOnBlurAsync extends undefined | FieldAsyncValidateOrFn<TParentData, TName, TData>, TOnSubmit extends undefined | FieldValidateOrFn<TParentData, TName, TData>, TOnSubmitAsync extends undefined | FieldAsyncValidateOrFn<TParentData, TName, TData>> {
     /**
-     * An optional function that takes a param of `formApi` which is a generic type of `TData` and `TParentData`
+     * An optional function, that runs on the mount event of input.
      */
-    onMount?: FieldValidateOrFn<TParentData, TName, TFieldValidator, TFormValidator, TData>;
+    onMount?: TOnMount;
     /**
-     * An optional property that takes a `ValidateFn` which is a generic of `TData` and `TParentData`.
-     * If `validatorAdapter` is passed, this may also accept a property from the respective adapter
+     * An optional function, that runs on the change event of input.
      *
-     * @example z.string().min(1) // if `zodAdapter` is passed
+     * @example z.string().min(1)
      */
-    onChange?: FieldValidateOrFn<TParentData, TName, TFieldValidator, TFormValidator, TData>;
+    onChange?: TOnChange;
     /**
-     * An optional property similar to `onChange` but async validation. If `validatorAdapter`
-     * is passed, this may also accept a property from the respective adapter
+     * An optional property similar to `onChange` but async validation
      *
-     * @example z.string().refine(async (val) => val.length > 3, { message: 'Testing 123' }) // if `zodAdapter` is passed
+     * @example z.string().refine(async (val) => val.length > 3, { message: 'Testing 123' })
      */
-    onChangeAsync?: FieldAsyncValidateOrFn<TParentData, TName, TFieldValidator, TFormValidator, TData>;
+    onChangeAsync?: TOnChangeAsync;
     /**
      * An optional number to represent how long the `onChangeAsync` should wait before running
      *
@@ -65,18 +73,16 @@ export interface FieldValidators<TParentData, TName extends DeepKeys<TParentData
     onChangeListenTo?: DeepKeys<TParentData>[];
     /**
      * An optional function, that runs on the blur event of input.
-     * If `validatorAdapter` is passed, this may also accept a property from the respective adapter
      *
-     * @example z.string().min(1) // if `zodAdapter` is passed
+     * @example z.string().min(1)
      */
-    onBlur?: FieldValidateOrFn<TParentData, TName, TFieldValidator, TFormValidator, TData>;
+    onBlur?: TOnBlur;
     /**
-     * An optional property similar to `onBlur` but async validation. If `validatorAdapter`
-     * is passed, this may also accept a property from the respective adapter
+     * An optional property similar to `onBlur` but async validation.
      *
-     * @example z.string().refine(async (val) => val.length > 3, { message: 'Testing 123' }) // if `zodAdapter` is passed
+     * @example z.string().refine(async (val) => val.length > 3, { message: 'Testing 123' })
      */
-    onBlurAsync?: FieldAsyncValidateOrFn<TParentData, TName, TFieldValidator, TFormValidator, TData>;
+    onBlurAsync?: TOnBlurAsync;
     /**
      * An optional number to represent how long the `onBlurAsync` should wait before running
      *
@@ -89,29 +95,27 @@ export interface FieldValidators<TParentData, TName extends DeepKeys<TParentData
     onBlurListenTo?: DeepKeys<TParentData>[];
     /**
      * An optional function, that runs on the submit event of form.
-     * If `validatorAdapter` is passed, this may also accept a property from the respective adapter
      *
-     * @example z.string().min(1) // if `zodAdapter` is passed
+     * @example z.string().min(1)
      */
-    onSubmit?: FieldValidateOrFn<TParentData, TName, TFieldValidator, TFormValidator, TData>;
+    onSubmit?: TOnSubmit;
     /**
-     * An optional property similar to `onSubmit` but async validation. If `validatorAdapter`
-     * is passed, this may also accept a property from the respective adapter
+     * An optional property similar to `onSubmit` but async validation.
      *
-     * @example z.string().refine(async (val) => val.length > 3, { message: 'Testing 123' }) // if `zodAdapter` is passed
+     * @example z.string().refine(async (val) => val.length > 3, { message: 'Testing 123' })
      */
-    onSubmitAsync?: FieldAsyncValidateOrFn<TParentData, TName, TFieldValidator, TFormValidator, TData>;
+    onSubmitAsync?: TOnSubmitAsync;
 }
-export interface FieldListeners<TParentData, TName extends DeepKeys<TParentData>, TFieldValidator extends Validator<DeepValue<TParentData, TName>, unknown> | undefined = undefined, TFormValidator extends Validator<TParentData, unknown> | undefined = undefined, TData extends DeepValue<TParentData, TName> = DeepValue<TParentData, TName>> {
-    onChange?: FieldListenerFn<TParentData, TName, TFieldValidator, TFormValidator, TData>;
-    onBlur?: FieldListenerFn<TParentData, TName, TFieldValidator, TFormValidator, TData>;
-    onMount?: FieldListenerFn<TParentData, TName, TFieldValidator, TFormValidator, TData>;
-    onSubmit?: FieldListenerFn<TParentData, TName, TFieldValidator, TFormValidator, TData>;
+export interface FieldListeners<TParentData, TName extends DeepKeys<TParentData>, TData extends DeepValue<TParentData, TName> = DeepValue<TParentData, TName>> {
+    onChange?: FieldListenerFn<TParentData, TName, TData>;
+    onBlur?: FieldListenerFn<TParentData, TName, TData>;
+    onMount?: FieldListenerFn<TParentData, TName, TData>;
+    onSubmit?: FieldListenerFn<TParentData, TName, TData>;
 }
 /**
  * An object type representing the options for a field in a form.
  */
-export interface FieldOptions<TParentData, TName extends DeepKeys<TParentData>, TFieldValidator extends Validator<DeepValue<TParentData, TName>, unknown> | undefined = undefined, TFormValidator extends Validator<TParentData, unknown> | undefined = undefined, TData extends DeepValue<TParentData, TName> = DeepValue<TParentData, TName>> {
+export interface FieldOptions<TParentData, TName extends DeepKeys<TParentData>, TData extends DeepValue<TParentData, TName>, TOnMount extends undefined | FieldValidateOrFn<TParentData, TName, TData>, TOnChange extends undefined | FieldValidateOrFn<TParentData, TName, TData>, TOnChangeAsync extends undefined | FieldAsyncValidateOrFn<TParentData, TName, TData>, TOnBlur extends undefined | FieldValidateOrFn<TParentData, TName, TData>, TOnBlurAsync extends undefined | FieldAsyncValidateOrFn<TParentData, TName, TData>, TOnSubmit extends undefined | FieldValidateOrFn<TParentData, TName, TData>, TOnSubmitAsync extends undefined | FieldAsyncValidateOrFn<TParentData, TName, TData>> {
     /**
      * The field name. The type will be `DeepKeys<TParentData>` to ensure your name is a deep key of the parent dataset.
      */
@@ -128,30 +132,30 @@ export interface FieldOptions<TParentData, TName extends DeepKeys<TParentData>,
      * If `true`, always run async validation, even if there are errors emitted during synchronous validation.
      */
     asyncAlways?: boolean;
-    /**
-     * A validator provided by an extension, like `yupValidator` from `@tanstack/yup-form-adapter`
-     */
-    validatorAdapter?: TFieldValidator;
     /**
      * A list of validators to pass to the field
      */
-    validators?: FieldValidators<TParentData, TName, TFieldValidator, TFormValidator, TData>;
+    validators?: FieldValidators<TParentData, TName, TData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync>;
     /**
      * An optional object with default metadata for the field.
      */
-    defaultMeta?: Partial<FieldMeta>;
+    defaultMeta?: Partial<FieldMeta<TParentData, TName, TData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, any, any, any, any, any, any, any>>;
     /**
      * A list of listeners which attach to the corresponding events
      */
-    listeners?: FieldListeners<TParentData, TName, TFieldValidator, TFormValidator, TData>;
+    listeners?: FieldListeners<TParentData, TName, TData>;
+    /**
+     * Disable the `flat(1)` operation on `field.errors`. This is useful if you want to keep the error structure as is. Not suggested for most use-cases.
+     */
+    disableErrorFlat?: boolean;
 }
 /**
  * An object type representing the required options for the FieldApi class.
  */
-export interface FieldApiOptions<TParentData, TName extends DeepKeys<TParentData>, TFieldValidator extends Validator<DeepValue<TParentData, TName>, unknown> | undefined = undefined, TFormValidator extends Validator<TParentData, unknown> | undefined = undefined, TData extends DeepValue<TParentData, TName> = DeepValue<TParentData, TName>> extends FieldOptions<TParentData, TName, TFieldValidator, TFormValidator, TData> {
-    form: FormApi<TParentData, TFormValidator>;
+export interface FieldApiOptions<TParentData, TName extends DeepKeys<TParentData>, TData extends DeepValue<TParentData, TName>, TOnMount extends undefined | FieldValidateOrFn<TParentData, TName, TData>, TOnChange extends undefined | FieldValidateOrFn<TParentData, TName, TData>, TOnChangeAsync extends undefined | FieldAsyncValidateOrFn<TParentData, TName, TData>, TOnBlur extends undefined | FieldValidateOrFn<TParentData, TName, TData>, TOnBlurAsync extends undefined | FieldAsyncValidateOrFn<TParentData, TName, TData>, TOnSubmit extends undefined | FieldValidateOrFn<TParentData, TName, TData>, TOnSubmitAsync extends undefined | FieldAsyncValidateOrFn<TParentData, TName, TData>, TFormOnMount extends undefined | FormValidateOrFn<TParentData>, TFormOnChange extends undefined | FormValidateOrFn<TParentData>, TFormOnChangeAsync extends undefined | FormAsyncValidateOrFn<TParentData>, TFormOnBlur extends undefined | FormValidateOrFn<TParentData>, TFormOnBlurAsync extends undefined | FormAsyncValidateOrFn<TParentData>, TFormOnSubmit extends undefined | FormValidateOrFn<TParentData>, TFormOnSubmitAsync extends undefined | FormAsyncValidateOrFn<TParentData>, TFormOnServer extends undefined | FormAsyncValidateOrFn<TParentData>> extends FieldOptions<TParentData, TName, TData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync> {
+    form: FormApi<TParentData, TFormOnMount, TFormOnChange, TFormOnChangeAsync, TFormOnBlur, TFormOnBlurAsync, TFormOnSubmit, TFormOnSubmitAsync, TFormOnServer>;
 }
-export type FieldMetaBase = {
+export type FieldMetaBase<TParentData, TName extends DeepKeys<TParentData>, TData extends DeepValue<TParentData, TName>, TOnMount extends undefined | FieldValidateOrFn<TParentData, TName, TData>, TOnChange extends undefined | FieldValidateOrFn<TParentData, TName, TData>, TOnChangeAsync extends undefined | FieldAsyncValidateOrFn<TParentData, TName, TData>, TOnBlur extends undefined | FieldValidateOrFn<TParentData, TName, TData>, TOnBlurAsync extends undefined | FieldAsyncValidateOrFn<TParentData, TName, TData>, TOnSubmit extends undefined | FieldValidateOrFn<TParentData, TName, TData>, TOnSubmitAsync extends undefined | FieldAsyncValidateOrFn<TParentData, TName, TData>, TFormOnMount extends undefined | FormValidateOrFn<TParentData>, TFormOnChange extends undefined | FormValidateOrFn<TParentData>, TFormOnChangeAsync extends undefined | FormAsyncValidateOrFn<TParentData>, TFormOnBlur extends undefined | FormValidateOrFn<TParentData>, TFormOnBlurAsync extends undefined | FormAsyncValidateOrFn<TParentData>, TFormOnSubmit extends undefined | FormValidateOrFn<TParentData>, TFormOnSubmitAsync extends undefined | FormAsyncValidateOrFn<TParentData>> = {
     /**
      * A flag indicating whether the field has been touched.
      */
@@ -167,30 +171,33 @@ export type FieldMetaBase = {
     /**
      * A map of errors related to the field value.
      */
-    errorMap: ValidationErrorMap;
+    errorMap: ValidationErrorMap<UnwrapFieldValidateOrFn<TParentData, TName, TOnMount, TFormOnMount>, UnwrapFieldValidateOrFn<TParentData, TName, TOnChange, TFormOnChange>, UnwrapFieldAsyncValidateOrFn<TParentData, TName, TOnChangeAsync, TFormOnChangeAsync>, UnwrapFieldValidateOrFn<TParentData, TName, TOnBlur, TFormOnBlur>, UnwrapFieldAsyncValidateOrFn<TParentData, TName, TOnBlurAsync, TFormOnBlurAsync>, UnwrapFieldValidateOrFn<TParentData, TName, TOnSubmit, TFormOnSubmit>, UnwrapFieldAsyncValidateOrFn<TParentData, TName, TOnSubmitAsync, TFormOnSubmitAsync>>;
     /**
      * A flag indicating whether the field is currently being validated.
      */
     isValidating: boolean;
 };
-export type FieldMetaDerived = {
+export type AnyFieldMetaBase = FieldMetaBase<any, any, any, any, any, any, any, any, any, any, any, any, any, any, any, any, any>;
+export type FieldMetaDerived<TParentData, TName extends DeepKeys<TParentData>, TData extends DeepValue<TParentData, TName>, TOnMount extends undefined | FieldValidateOrFn<TParentData, TName, TData>, TOnChange extends undefined | FieldValidateOrFn<TParentData, TName, TData>, TOnChangeAsync extends undefined | FieldAsyncValidateOrFn<TParentData, TName, TData>, TOnBlur extends undefined | FieldValidateOrFn<TParentData, TName, TData>, TOnBlurAsync extends undefined | FieldAsyncValidateOrFn<TParentData, TName, TData>, TOnSubmit extends undefined | FieldValidateOrFn<TParentData, TName, TData>, TOnSubmitAsync extends undefined | FieldAsyncValidateOrFn<TParentData, TName, TData>, TFormOnMount extends undefined | FormValidateOrFn<TParentData>, TFormOnChange extends undefined | FormValidateOrFn<TParentData>, TFormOnChangeAsync extends undefined | FormAsyncValidateOrFn<TParentData>, TFormOnBlur extends undefined | FormValidateOrFn<TParentData>, TFormOnBlurAsync extends undefined | FormAsyncValidateOrFn<TParentData>, TFormOnSubmit extends undefined | FormValidateOrFn<TParentData>, TFormOnSubmitAsync extends undefined | FormAsyncValidateOrFn<TParentData>> = {
     /**
      * An array of errors related to the field value.
      */
-    errors: ValidationError[];
+    errors: Array<UnwrapOneLevelOfArray<UnwrapFieldValidateOrFn<TParentData, TName, TOnMount, TFormOnMount>> | UnwrapOneLevelOfArray<UnwrapFieldValidateOrFn<TParentData, TName, TOnChange, TFormOnChange>> | UnwrapOneLevelOfArray<UnwrapFieldAsyncValidateOrFn<TParentData, TName, TOnChangeAsync, TFormOnChangeAsync>> | UnwrapOneLevelOfArray<UnwrapFieldValidateOrFn<TParentData, TName, TOnBlur, TFormOnBlur>> | UnwrapOneLevelOfArray<UnwrapFieldAsyncValidateOrFn<TParentData, TName, TOnBlurAsync, TFormOnBlurAsync>> | UnwrapOneLevelOfArray<UnwrapFieldValidateOrFn<TParentData, TName, TOnSubmit, TFormOnSubmit>> | UnwrapOneLevelOfArray<UnwrapFieldAsyncValidateOrFn<TParentData, TName, TOnSubmitAsync, TFormOnSubmitAsync>>>;
     /**
      * A flag that is `true` if the field's value has not been modified by the user. Opposite of `isDirty`.
      */
     isPristine: boolean;
 };
+export type AnyFieldMetaDerived = FieldMetaDerived<any, any, any, any, any, any, any, any, any, any, any, any, any, any, any, any, any>;
 /**
  * An object type representing the metadata of a field in a form.
  */
-export type FieldMeta = FieldMetaBase & FieldMetaDerived;
+export type FieldMeta<TParentData, TName extends DeepKeys<TParentData>, TData extends DeepValue<TParentData, TName>, TOnMount extends undefined | FieldValidateOrFn<TParentData, TName, TData>, TOnChange extends undefined | FieldValidateOrFn<TParentData, TName, TData>, TOnChangeAsync extends undefined | FieldAsyncValidateOrFn<TParentData, TName, TData>, TOnBlur extends undefined | FieldValidateOrFn<TParentData, TName, TData>, TOnBlurAsync extends undefined | FieldAsyncValidateOrFn<TParentData, TName, TData>, TOnSubmit extends undefined | FieldValidateOrFn<TParentData, TName, TData>, TOnSubmitAsync extends undefined | FieldAsyncValidateOrFn<TParentData, TName, TData>, TFormOnMount extends undefined | FormValidateOrFn<TParentData>, TFormOnChange extends undefined | FormValidateOrFn<TParentData>, TFormOnChangeAsync extends undefined | FormAsyncValidateOrFn<TParentData>, TFormOnBlur extends undefined | FormValidateOrFn<TParentData>, TFormOnBlurAsync extends undefined | FormAsyncValidateOrFn<TParentData>, TFormOnSubmit extends undefined | FormValidateOrFn<TParentData>, TFormOnSubmitAsync extends undefined | FormAsyncValidateOrFn<TParentData>> = FieldMetaBase<TParentData, TName, TData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TFormOnMount, TFormOnChange, TFormOnChangeAsync, TFormOnBlur, TFormOnBlurAsync, TFormOnSubmit, TFormOnSubmitAsync> & FieldMetaDerived<TParentData, TName, TData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TFormOnMount, TFormOnChange, TFormOnChangeAsync, TFormOnBlur, TFormOnBlurAsync, TFormOnSubmit, TFormOnSubmitAsync>;
+export type AnyFieldMeta = FieldMeta<any, any, any, any, any, any, any, any, any, any, any, any, any, any, any, any, any>;
 /**
  * An object type representing the state of a field.
  */
-export type FieldState<TData> = {
+export type FieldState<TParentData, TName extends DeepKeys<TParentData>, TData extends DeepValue<TParentData, TName>, TOnMount extends undefined | FieldValidateOrFn<TParentData, TName, TData>, TOnChange extends undefined | FieldValidateOrFn<TParentData, TName, TData>, TOnChangeAsync extends undefined | FieldAsyncValidateOrFn<TParentData, TName, TData>, TOnBlur extends undefined | FieldValidateOrFn<TParentData, TName, TData>, TOnBlurAsync extends undefined | FieldAsyncValidateOrFn<TParentData, TName, TData>, TOnSubmit extends undefined | FieldValidateOrFn<TParentData, TName, TData>, TOnSubmitAsync extends undefined | FieldAsyncValidateOrFn<TParentData, TName, TData>, TFormOnMount extends undefined | FormValidateOrFn<TParentData>, TFormOnChange extends undefined | FormValidateOrFn<TParentData>, TFormOnChangeAsync extends undefined | FormAsyncValidateOrFn<TParentData>, TFormOnBlur extends undefined | FormValidateOrFn<TParentData>, TFormOnBlurAsync extends undefined | FormAsyncValidateOrFn<TParentData>, TFormOnSubmit extends undefined | FormValidateOrFn<TParentData>, TFormOnSubmitAsync extends undefined | FormAsyncValidateOrFn<TParentData>> = {
     /**
      * The current value of the field.
      */
@@ -198,8 +205,14 @@ export type FieldState<TData> = {
     /**
      * The current metadata of the field.
      */
-    meta: FieldMeta;
+    meta: FieldMeta<TParentData, TName, TData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TFormOnMount, TFormOnChange, TFormOnChangeAsync, TFormOnBlur, TFormOnBlurAsync, TFormOnSubmit, TFormOnSubmitAsync>;
 };
+/**
+ * @public
+ *
+ * A type representing the Field API with all generics set to `any` for convenience.
+ */
+export type AnyFieldApi = FieldApi<any, any, any, any, any, any, any, any, any, any, any, any, any, any, any, any, any, any>;
 /**
  * A class representing the API for managing a form field.
  *
@@ -209,11 +222,11 @@ export type FieldState<TData> = {
  * However, if you need to create a new instance manually, you can do so by calling
  * the `new FieldApi` constructor.
  */
-export declare class FieldApi<TParentData, TName extends DeepKeys<TParentData>, TFieldValidator extends Validator<DeepValue<TParentData, TName>, unknown> | undefined = undefined, TFormValidator extends Validator<TParentData, unknown> | undefined = undefined, TData extends DeepValue<TParentData, TName> = DeepValue<TParentData, TName>> {
+export declare class FieldApi<TParentData, TName extends DeepKeys<TParentData>, TData extends DeepValue<TParentData, TName>, TOnMount extends undefined | FieldValidateOrFn<TParentData, TName, TData>, TOnChange extends undefined | FieldValidateOrFn<TParentData, TName, TData>, TOnChangeAsync extends undefined | FieldAsyncValidateOrFn<TParentData, TName, TData>, TOnBlur extends undefined | FieldValidateOrFn<TParentData, TName, TData>, TOnBlurAsync extends undefined | FieldAsyncValidateOrFn<TParentData, TName, TData>, TOnSubmit extends undefined | FieldValidateOrFn<TParentData, TName, TData>, TOnSubmitAsync extends undefined | FieldAsyncValidateOrFn<TParentData, TName, TData>, TFormOnMount extends undefined | FormValidateOrFn<TParentData>, TFormOnChange extends undefined | FormValidateOrFn<TParentData>, TFormOnChangeAsync extends undefined | FormAsyncValidateOrFn<TParentData>, TFormOnBlur extends undefined | FormValidateOrFn<TParentData>, TFormOnBlurAsync extends undefined | FormAsyncValidateOrFn<TParentData>, TFormOnSubmit extends undefined | FormValidateOrFn<TParentData>, TFormOnSubmitAsync extends undefined | FormAsyncValidateOrFn<TParentData>, TFormOnServer extends undefined | FormAsyncValidateOrFn<TParentData>> {
     /**
      * A reference to the form API instance.
      */
-    form: FieldApiOptions<TParentData, TName, TFieldValidator, TFormValidator, TData>['form'];
+    form: FieldApiOptions<TParentData, TName, TData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TFormOnMount, TFormOnChange, TFormOnChangeAsync, TFormOnBlur, TFormOnBlurAsync, TFormOnSubmit, TFormOnSubmitAsync, TFormOnServer>['form'];
     /**
      * The field name.
      */
@@ -221,32 +234,30 @@ export declare class FieldApi<TParentData, TName extends DeepKeys<TParentData>,
     /**
      * The field options.
      */
-    options: FieldApiOptions<TParentData, TName, TFieldValidator, TFormValidator, TData>;
+    options: FieldApiOptions<TParentData, TName, TData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TFormOnMount, TFormOnChange, TFormOnChangeAsync, TFormOnBlur, TFormOnBlurAsync, TFormOnSubmit, TFormOnSubmitAsync, TFormOnServer>;
     /**
      * The field state store.
      */
-    store: Derived<FieldState<TData>>;
+    store: Derived<FieldState<TParentData, TName, TData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TFormOnMount, TFormOnChange, TFormOnChangeAsync, TFormOnBlur, TFormOnBlurAsync, TFormOnSubmit, TFormOnSubmitAsync>>;
     /**
      * The current field state.
      */
-    get state(): FieldState<TData>;
+    get state(): FieldState<TParentData, TName, TData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TFormOnMount, TFormOnChange, TFormOnChangeAsync, TFormOnBlur, TFormOnBlurAsync, TFormOnSubmit, TFormOnSubmitAsync>;
     timeoutIds: Record<ValidationCause, ReturnType<typeof setTimeout> | null>;
     /**
      * Initializes a new `FieldApi` instance.
      */
-    constructor(opts: FieldApiOptions<TParentData, TName, TFieldValidator, TFormValidator, TData>);
+    constructor(opts: FieldApiOptions<TParentData, TName, TData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TFormOnMount, TFormOnChange, TFormOnChangeAsync, TFormOnBlur, TFormOnBlurAsync, TFormOnSubmit, TFormOnSubmitAsync, TFormOnServer>);
     /**
      * @private
      */
-    runValidator<TValue extends {
-        value: TData;
-        fieldApi: FieldApi<any, any, any, any>;
-        validationSource: ValidationSource;
+    runValidator<TValue extends TStandardSchemaValidatorValue<TData> & {
+        fieldApi: AnyFieldApi;
     }, TType extends 'validate' | 'validateAsync'>(props: {
-        validate: TType extends 'validate' ? FieldValidateOrFn<any, any, any, any> : FieldAsyncValidateOrFn<any, any, any, any>;
+        validate: TType extends 'validate' ? FieldValidateOrFn<any, any, any> : FieldAsyncValidateOrFn<any, any, any>;
         value: TValue;
         type: TType;
-    }): TType extends 'validate' ? ValidationError : Promise<ValidationError>;
+    }): unknown;
     /**
      * Mounts the field instance to the form.
      */
@@ -254,7 +265,7 @@ export declare class FieldApi<TParentData, TName extends DeepKeys<TParentData>,
     /**
      * Updates the field instance with new options.
      */
-    update: (opts: FieldApiOptions<TParentData, TName, TFieldValidator, TFormValidator, TData>) => void;
+    update: (opts: FieldApiOptions<TParentData, TName, TData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TFormOnMount, TFormOnChange, TFormOnChangeAsync, TFormOnBlur, TFormOnBlurAsync, TFormOnSubmit, TFormOnSubmitAsync, TFormOnServer>) => void;
     /**
      * Gets the current field value.
      * @deprecated Use `field.state.value` instead.
@@ -264,15 +275,15 @@ export declare class FieldApi<TParentData, TName extends DeepKeys<TParentData>,
      * Sets the field value and run the `change` validator.
      */
     setValue: (updater: Updater<TData>, options?: UpdateMetaOptions) => void;
-    getMeta: () => FieldMeta;
+    getMeta: () => FieldMeta<TParentData, TName, TData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TFormOnMount, TFormOnChange, TFormOnChangeAsync, TFormOnBlur, TFormOnBlurAsync, TFormOnSubmit, TFormOnSubmitAsync>;
     /**
      * Sets the field metadata.
      */
-    setMeta: (updater: Updater<FieldMeta>) => void;
+    setMeta: (updater: Updater<FieldMeta<TParentData, TName, TData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TFormOnMount, TFormOnChange, TFormOnChangeAsync, TFormOnBlur, TFormOnBlurAsync, TFormOnSubmit, TFormOnSubmitAsync>>) => void;
     /**
      * Gets the field information object.
      */
-    getInfo: () => FieldInfo<TParentData, TFormValidator>;
+    getInfo: () => FieldInfo<TParentData>;
     /**
      * Pushes a new value to the field.
      */
@@ -300,7 +311,7 @@ export declare class FieldApi<TParentData, TName extends DeepKeys<TParentData>,
     /**
      * @private
      */
-    getLinkedFields: (cause: ValidationCause) => FieldApi<any, any, any, any, any>[];
+    getLinkedFields: (cause: ValidationCause) => AnyFieldApi[];
     /**
      * @private
      */
@@ -310,7 +321,7 @@ export declare class FieldApi<TParentData, TName extends DeepKeys<TParentData>,
     /**
      * @private
      */
-    validateAsync: (cause: ValidationCause, formValidationResultPromise: Promise<FieldsErrorMapFromValidator<TParentData>>) => Promise<ValidationError[]>;
+    validateAsync: (cause: ValidationCause, formValidationResultPromise: Promise<FieldErrorMapFromValidator<TParentData, TName, TData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync>>) => Promise<unknown[]>;
     /**
      * Validates the field value.
      */
@@ -330,3 +341,4 @@ export declare class FieldApi<TParentData, TName extends DeepKeys<TParentData>,
      */
     setErrorMap(errorMap: ValidationErrorMap): void;
 }
+export {};

package/dist/cjs/FormApi.cjs

@@ -22,9 +22,6 @@ function getDefaultFormState(defaultState) {
     }
   };
 }
-const isFormValidationError = (error) => {
-  return typeof error === "object";
-};
 class FormApi {
   /**
    * Constructs a new `FormApi` instance with the given form options.
@@ -91,19 +88,21 @@ class FormApi {
     this.validateAllFields = async (cause) => {
       const fieldValidationPromises = [];
       store.batch(() => {
-        void Object.values(this.fieldInfo).forEach((field) => {
-          if (!field.instance) return;
-          const fieldInstance = field.instance;
-          fieldValidationPromises.push(
-            // Remember, `validate` is either a sync operation or a promise
-            Promise.resolve().then(
-              () => fieldInstance.validate(cause, { skipFormValidation: true })
-            )
-          );
-          if (!field.instance.state.meta.isTouched) {
-            field.instance.setMeta((prev) => ({ ...prev, isTouched: true }));
+        void Object.values(this.fieldInfo).forEach(
+          (field) => {
+            if (!field.instance) return;
+            const fieldInstance = field.instance;
+            fieldValidationPromises.push(
+              // Remember, `validate` is either a sync operation or a promise
+              Promise.resolve().then(
+                () => fieldInstance.validate(cause, { skipFormValidation: true })
+              )
+            );
+            if (!field.instance.state.meta.isTouched) {
+              field.instance.setMeta((prev) => ({ ...prev, isTouched: true }));
+            }
           }
-        });
+        );
       });
       const fieldErrorMapMap = await Promise.all(fieldValidationPromises);
       return fieldErrorMapMap.flat();
@@ -342,13 +341,15 @@ class FormApi {
         return;
       }
       store.batch(() => {
-        void Object.values(this.fieldInfo).forEach((field) => {
-          var _a3, _b2, _c2;
-          (_c2 = (_b2 = (_a3 = field.instance) == null ? void 0 : _a3.options.listeners) == null ? void 0 : _b2.onSubmit) == null ? void 0 : _c2.call(_b2, {
-            value: field.instance.state.value,
-            fieldApi: field.instance
-          });
-        });
+        void Object.values(this.fieldInfo).forEach(
+          (field) => {
+            var _a3, _b2, _c2;
+            (_c2 = (_b2 = (_a3 = field.instance) == null ? void 0 : _a3.options.listeners) == null ? void 0 : _b2.onSubmit) == null ? void 0 : _c2.call(_b2, {
+              value: field.instance.state.value,
+              fieldApi: field.instance
+            });
+          }
+        );
       });
       try {
         await ((_f = (_e = this.options).onSubmit) == null ? void 0 : _f.call(_e, { value: this.state.values, formApi: this }));
@@ -534,13 +535,13 @@ class FormApi {
     this.baseStore = new store.Store(
       getDefaultFormState({
         ...opts == null ? void 0 : opts.defaultState,
-        values: (opts == null ? void 0 : opts.defaultValues) ?? ((_a = opts == null ? void 0 : opts.defaultState) == null ? void 0 : _a.values),
-        isFormValid: true
+        values: (opts == null ? void 0 : opts.defaultValues) ?? ((_a = opts == null ? void 0 : opts.defaultState) == null ? void 0 : _a.values)
       })
     );
     this.fieldMetaDerived = new store.Derived({
       deps: [this.baseStore],
       fn: ({ prevDepVals, currDepVals, prevVal: _prevVal }) => {
+        var _a2;
         const prevVal = _prevVal;
         const prevBaseStore = prevDepVals == null ? void 0 : prevDepVals[0];
         const currBaseStore = currDepVals[0];
@@ -557,6 +558,12 @@ class FormApi {
             fieldErrors = Object.values(currBaseVal.errorMap ?? {}).filter(
               (val) => val !== void 0
             );
+            const fieldInstance = (_a2 = this.getFieldInfo(fieldName)) == null ? void 0 : _a2.instance;
+            if (fieldInstance && !fieldInstance.options.disableErrorFlat) {
+              fieldErrors = fieldErrors == null ? void 0 : fieldErrors.flat(
+                1
+              );
+            }
           }
           const isFieldPristine = !currBaseVal.isDirty;
           if (prevFieldInfo && prevFieldInfo.isPristine === isFieldPristine && prevFieldInfo.errors === fieldErrors && currBaseVal === prevBaseVal) {
@@ -609,20 +616,15 @@ class FormApi {
         const isValidating = !!isFieldsValidating;
         let errors = (prevVal == null ? void 0 : prevVal.errors) ?? [];
         if (!prevBaseStore || currBaseStore.errorMap !== prevBaseStore.errorMap) {
-          errors = Object.values(currBaseStore.errorMap).reduce(
-            (prev, curr) => {
-              if (curr === void 0) return prev;
-              if (typeof curr === "string") {
-                prev.push(curr);
-                return prev;
-              } else if (curr && isFormValidationError(curr)) {
-                prev.push(curr.form);
-                return prev;
-              }
+          errors = Object.values(currBaseStore.errorMap).reduce((prev, curr) => {
+            if (curr === void 0) return prev;
+            if (curr && utils.isGlobalFormValidationError(curr)) {
+              prev.push(curr.form);
               return prev;
-            },
-            []
-          );
+            }
+            prev.push(curr);
+            return prev;
+          }, []);
         }
         const isFormValid = errors.length === 0;
         const isValid = isFieldsValid && isFormValid;
@@ -672,12 +674,8 @@ class FormApi {
    * @private
    */
   runValidator(props) {
-    const adapter = this.options.validatorAdapter;
-    if (adapter && (typeof props.validate !== "function" || "~standard" in props.validate)) {
-      return adapter()[props.type](props.value, props.validate);
-    }
     if (standardSchemaValidator.isStandardSchemaValidator(props.validate)) {
-      return standardSchemaValidator.standardSchemaValidator()()[props.type](
+      return standardSchemaValidator.standardSchemaValidators[props.type](
         props.value,
         props.validate
       );
@@ -688,25 +686,24 @@ class FormApi {
    * Updates the form's errorMap
    */
   setErrorMap(errorMap) {
-    this.baseStore.setState((prev) => ({
-      ...prev,
-      errorMap: {
-        ...prev.errorMap,
-        ...errorMap
-      }
-    }));
+    this.baseStore.setState(
+      (prev) => ({
+        ...prev,
+        errorMap: {
+          ...prev.errorMap,
+          ...errorMap
+        }
+      })
+    );
   }
 }
 function normalizeError(rawError) {
   if (rawError) {
-    if (typeof rawError === "object") {
+    if (utils.isGlobalFormValidationError(rawError)) {
       const formError = normalizeError(rawError.form).formError;
       const fieldErrors = rawError.fields;
       return { formError, fieldErrors };
     }
-    if (typeof rawError !== "string") {
-      return { formError: "Invalid Form Values" };
-    }
     return { formError: rawError };
   }
   return { formError: void 0 };