@tanstack/form-core 0.3.6 → 0.3.7

package/build/legacy/FieldApi.cjs

@@ -226,6 +226,9 @@ var _FieldApi = class _FieldApi {
     this.form = opts.form;
     this.uid = uid++;
     this.name = opts.name;
+    if (opts.defaultValue !== void 0) {
+      this.form.setFieldValue(this.name, opts.defaultValue);
+    }
     this.store = new import_store.Store(
       {
         value: this.getValue(),

package/build/legacy/FieldApi.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/FieldApi.ts"],"sourcesContent":["import { type DeepKeys, type DeepValue, type Updater } from './utils'\nimport type { FormApi, ValidationError, ValidationErrorMap } from './FormApi'\nimport { Store } from '@tanstack/store'\n\nexport type ValidationCause = 'change' | 'blur' | 'submit' | 'mount'\n\ntype ValidateFn<TParentData, TName extends DeepKeys<TParentData>, TData> = (\n  value: TData,\n  fieldApi: FieldApi<TParentData, TName>,\n) => ValidationError\n\ntype ValidateAsyncFn<\n  TParentData,\n  TName extends DeepKeys<TParentData>,\n  TData,\n> = (\n  value: TData,\n  fieldApi: FieldApi<TParentData, TName>,\n) => ValidationError | Promise<ValidationError>\n\nexport interface FieldOptions<\n  TParentData,\n  /**\n   * This allows us to restrict the name to only be a valid field name while\n   * also assigning it to a generic\n   */\n  TName extends DeepKeys<TParentData>,\n  /**\n   * If TData is unknown, we can use the TName generic to determine the type\n   */\n  TData = DeepValue<TParentData, TName>,\n> {\n  name: DeepKeys<TParentData>\n  index?: TData extends any[] ? number : never\n  defaultValue?: TData\n  asyncDebounceMs?: number\n  asyncAlways?: boolean\n  onMount?: (formApi: FieldApi<TParentData, TName>) => void\n  onChange?: ValidateFn<TParentData, TName, TData>\n  onChangeAsync?: ValidateAsyncFn<TParentData, TName, TData>\n  onChangeAsyncDebounceMs?: number\n  onBlur?: ValidateFn<TParentData, TName, TData>\n  onBlurAsync?: ValidateAsyncFn<TParentData, TName, TData>\n  onBlurAsyncDebounceMs?: number\n  onSubmitAsync?: ValidateAsyncFn<TParentData, TName, TData>\n  defaultMeta?: Partial<FieldMeta>\n}\n\nexport interface FieldApiOptions<\n  TParentData,\n  TName extends DeepKeys<TParentData>,\n  TData = DeepValue<TParentData, TName>,\n> extends FieldOptions<TParentData, TName, TData> {\n  form: FormApi<TParentData>\n}\n\nexport type FieldMeta = {\n  isTouched: boolean\n  touchedErrors: ValidationError[]\n  errors: ValidationError[]\n  errorMap: ValidationErrorMap\n  isValidating: boolean\n}\n\nlet uid = 0\n\nexport type FieldState<TData> = {\n  value: TData\n  meta: FieldMeta\n}\n\nexport type ResolveName<TParentData> = unknown extends TParentData\n  ? string\n  : DeepKeys<TParentData>\n\nexport class FieldApi<\n  TParentData,\n  TName extends DeepKeys<TParentData>,\n  TData = DeepValue<TParentData, TName>,\n> {\n  uid: number\n  form: FieldApiOptions<TParentData, TName, TData>['form']\n  name!: DeepKeys<TParentData>\n  options: FieldApiOptions<TParentData, TName> = {} as any\n  store!: Store<FieldState<TData>>\n  state!: FieldState<TData>\n  prevState!: FieldState<TData>\n\n  constructor(\n    opts: FieldApiOptions<TParentData, TName, TData> & {\n      form: FormApi<TParentData>\n    },\n  ) {\n    this.form = opts.form\n    this.uid = uid++\n    // Support field prefixing from FieldScope\n    // let fieldPrefix = ''\n    // if (this.form.fieldName) {\n    //   fieldPrefix = `${this.form.fieldName}.`\n    // }\n\n    this.name = opts.name as any\n\n    this.store = new Store<FieldState<TData>>(\n      {\n        value: this.getValue(),\n        // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition\n        meta: this._getMeta() ?? {\n          isValidating: false,\n          isTouched: false,\n          touchedErrors: [],\n          errors: [],\n          errorMap: {},\n          ...opts.defaultMeta,\n        },\n      },\n      {\n        onUpdate: () => {\n          const state = this.store.state\n\n          state.meta.errors = Object.values(state.meta.errorMap).filter(\n            (val: unknown) => val !== undefined,\n          )\n\n          state.meta.touchedErrors = state.meta.isTouched\n            ? state.meta.errors\n            : []\n\n          this.prevState = state\n          this.state = state\n        },\n      },\n    )\n\n    this.state = this.store.state\n    this.prevState = this.state\n    this.options = opts as never\n  }\n\n  mount = () => {\n    const info = this.getInfo()\n    info.instances[this.uid] = this as never\n\n    const unsubscribe = this.form.store.subscribe(() => {\n      this.store.batch(() => {\n        const nextValue = this.getValue()\n        const nextMeta = this.getMeta()\n\n        if (nextValue !== this.state.value) {\n          this.store.setState((prev) => ({ ...prev, value: nextValue }))\n        }\n\n        if (nextMeta !== this.state.meta) {\n          this.store.setState((prev) => ({ ...prev, meta: nextMeta }))\n        }\n      })\n    })\n\n    this.update(this.options as never)\n    this.options.onMount?.(this as never)\n\n    return () => {\n      unsubscribe()\n      delete info.instances[this.uid]\n      if (!Object.keys(info.instances).length) {\n        delete this.form.fieldInfo[this.name]\n      }\n    }\n  }\n\n  update = (opts: FieldApiOptions<TParentData, TName, TData>) => {\n    // Default Value\n    // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition\n    if (this.state.value === undefined) {\n      const formDefault =\n        opts.form.options.defaultValues?.[opts.name as keyof TParentData]\n\n      if (opts.defaultValue !== undefined) {\n        this.setValue(opts.defaultValue as never)\n      } else if (formDefault !== undefined) {\n        this.setValue(formDefault as never)\n      }\n    }\n\n    // Default Meta\n    if (this._getMeta() === undefined) {\n      this.setMeta(this.state.meta)\n    }\n\n    this.options = opts as never\n  }\n\n  getValue = (): TData => {\n    return this.form.getFieldValue(this.name) as any\n  }\n\n  setValue = (\n    updater: Updater<TData>,\n    options?: { touch?: boolean; notify?: boolean },\n  ) => {\n    this.form.setFieldValue(this.name, updater as never, options)\n    this.validate('change', this.state.value)\n  }\n\n  _getMeta = () => this.form.getFieldMeta(this.name)\n  getMeta = () =>\n    this._getMeta() ??\n    ({\n      isValidating: false,\n      isTouched: false,\n      touchedErrors: [],\n      errors: [],\n      errorMap: {},\n      ...this.options.defaultMeta,\n    } as FieldMeta)\n\n  setMeta = (updater: Updater<FieldMeta>) =>\n    this.form.setFieldMeta(this.name, updater)\n\n  getInfo = () => this.form.getFieldInfo(this.name)\n\n  pushValue = (value: TData extends any[] ? TData[number] : never) =>\n    this.form.pushFieldValue(this.name, value as any)\n\n  insertValue = (\n    index: number,\n    value: TData extends any[] ? TData[number] : never,\n  ) => this.form.insertFieldValue(this.name, index, value as any)\n\n  removeValue = (index: number) => this.form.removeFieldValue(this.name, index)\n\n  swapValues = (aIndex: number, bIndex: number) =>\n    this.form.swapFieldValues(this.name, aIndex, bIndex)\n\n  getSubField = <\n    TSubName extends DeepKeys<TData>,\n    TSubData = DeepValue<TData, TSubName>,\n  >(\n    name: TSubName,\n  ): FieldApi<TData, TSubName, TSubData> =>\n    new FieldApi({\n      name: `${this.name}.${name}` as never,\n      form: this.form,\n    }) as any\n\n  validateSync = (value = this.state.value, cause: ValidationCause) => {\n    const { onChange, onBlur } = this.options\n    const validate =\n      cause === 'submit' ? undefined : cause === 'change' ? onChange : onBlur\n    if (!validate) return\n\n    // Use the validationCount for all field instances to\n    // track freshness of the validation\n    const validationCount = (this.getInfo().validationCount || 0) + 1\n    this.getInfo().validationCount = validationCount\n    const error = normalizeError(validate(value as never, this as never))\n    const errorMapKey = getErrorMapKey(cause)\n    if (this.state.meta.errorMap[errorMapKey] !== error) {\n      this.setMeta((prev) => ({\n        ...prev,\n        errorMap: {\n          ...prev.errorMap,\n          [getErrorMapKey(cause)]: error,\n        },\n      }))\n    }\n\n    // If a sync error is encountered for the errorMapKey (eg. onChange), cancel any async validation\n    if (this.state.meta.errorMap[errorMapKey]) {\n      this.cancelValidateAsync()\n    }\n  }\n\n  #leaseValidateAsync = () => {\n    const count = (this.getInfo().validationAsyncCount || 0) + 1\n    this.getInfo().validationAsyncCount = count\n    return count\n  }\n\n  cancelValidateAsync = () => {\n    // Lease a new validation count to ignore any pending validations\n    this.#leaseValidateAsync()\n    // Cancel any pending validation state\n    this.setMeta((prev) => ({\n      ...prev,\n      isValidating: false,\n    }))\n  }\n\n  validateAsync = async (value = this.state.value, cause: ValidationCause) => {\n    const {\n      onChangeAsync,\n      onBlurAsync,\n      onSubmitAsync,\n      asyncDebounceMs,\n      onBlurAsyncDebounceMs,\n      onChangeAsyncDebounceMs,\n    } = this.options\n\n    const validate =\n      cause === 'change'\n        ? onChangeAsync\n        : cause === 'submit'\n        ? onSubmitAsync\n        : onBlurAsync\n    if (!validate) return []\n    const debounceMs =\n      cause === 'submit'\n        ? 0\n        : (cause === 'change'\n            ? onChangeAsyncDebounceMs\n            : onBlurAsyncDebounceMs) ??\n          asyncDebounceMs ??\n          0\n\n    if (this.state.meta.isValidating !== true)\n      this.setMeta((prev) => ({ ...prev, isValidating: true }))\n\n    // Use the validationCount for all field instances to\n    // track freshness of the validation\n    const validationAsyncCount = this.#leaseValidateAsync()\n\n    const checkLatest = () =>\n      validationAsyncCount === this.getInfo().validationAsyncCount\n\n    if (!this.getInfo().validationPromise) {\n      this.getInfo().validationPromise = new Promise((resolve, reject) => {\n        this.getInfo().validationResolve = resolve\n        this.getInfo().validationReject = reject\n      })\n    }\n\n    if (debounceMs > 0) {\n      await new Promise((r) => setTimeout(r, debounceMs))\n    }\n\n    // Only kick off validation if this validation is the latest attempt\n    if (checkLatest()) {\n      const prevErrors = this.getMeta().errors\n      try {\n        const rawError = await validate(value as never, this as never)\n        if (checkLatest()) {\n          const error = normalizeError(rawError)\n          this.setMeta((prev) => ({\n            ...prev,\n            isValidating: false,\n            errorMap: {\n              ...prev.errorMap,\n              [getErrorMapKey(cause)]: error,\n            },\n          }))\n          this.getInfo().validationResolve?.([...prevErrors, error])\n        }\n      } catch (error) {\n        if (checkLatest()) {\n          this.getInfo().validationReject?.([...prevErrors, error])\n          throw error\n        }\n      } finally {\n        if (checkLatest()) {\n          this.setMeta((prev) => ({ ...prev, isValidating: false }))\n          delete this.getInfo().validationPromise\n        }\n      }\n    }\n\n    // Always return the latest validation promise to the caller\n    return this.getInfo().validationPromise ?? []\n  }\n\n  validate = (\n    cause: ValidationCause,\n    value?: TData,\n  ): ValidationError[] | Promise<ValidationError[]> => {\n    // If the field is pristine and validatePristine is false, do not validate\n    if (!this.state.meta.isTouched) return []\n    // Attempt to sync validate first\n    this.validateSync(value, cause)\n\n    const errorMapKey = getErrorMapKey(cause)\n    // If there is an error mapped to the errorMapKey (eg. onChange, onBlur, onSubmit), return the errors array, do not attempt async validation\n    if (this.getMeta().errorMap[errorMapKey]) {\n      if (!this.options.asyncAlways) {\n        return this.state.meta.errors\n      }\n    }\n    // No error? Attempt async validation\n    return this.validateAsync(value, cause)\n  }\n\n  handleChange = (updater: Updater<TData>) => {\n    this.setValue(updater, { touch: true })\n  }\n\n  handleBlur = () => {\n    const prevTouched = this.state.meta.isTouched\n    if (!prevTouched) {\n      this.setMeta((prev) => ({ ...prev, isTouched: true }))\n      this.validate('change')\n    }\n    this.validate('blur')\n  }\n}\n\nfunction normalizeError(rawError?: ValidationError) {\n  if (rawError) {\n    if (typeof rawError !== 'string') {\n      return 'Invalid Form Values'\n    }\n\n    return rawError\n  }\n\n  return undefined\n}\n\nfunction getErrorMapKey(cause: ValidationCause) {\n  switch (cause) {\n    case 'submit':\n      return 'onSubmit'\n    case 'change':\n      return 'onChange'\n    case 'blur':\n      return 'onBlur'\n    case 'mount':\n      return 'onMount'\n  }\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/FieldApi.ts"],"sourcesContent":["import { type DeepKeys, type DeepValue, type Updater } from './utils'\nimport type { FormApi, ValidationError, ValidationErrorMap } from './FormApi'\nimport { Store } from '@tanstack/store'\n\nexport type ValidationCause = 'change' | 'blur' | 'submit' | 'mount'\n\ntype ValidateFn<TParentData, TName extends DeepKeys<TParentData>, TData> = (\n  value: TData,\n  fieldApi: FieldApi<TParentData, TName>,\n) => ValidationError\n\ntype ValidateAsyncFn<\n  TParentData,\n  TName extends DeepKeys<TParentData>,\n  TData,\n> = (\n  value: TData,\n  fieldApi: FieldApi<TParentData, TName>,\n) => ValidationError | Promise<ValidationError>\n\nexport interface FieldOptions<\n  TParentData,\n  /**\n   * This allows us to restrict the name to only be a valid field name while\n   * also assigning it to a generic\n   */\n  TName extends DeepKeys<TParentData>,\n  /**\n   * If TData is unknown, we can use the TName generic to determine the type\n   */\n  TData = DeepValue<TParentData, TName>,\n> {\n  name: DeepKeys<TParentData>\n  index?: TData extends any[] ? number : never\n  defaultValue?: TData\n  asyncDebounceMs?: number\n  asyncAlways?: boolean\n  onMount?: (formApi: FieldApi<TParentData, TName>) => void\n  onChange?: ValidateFn<TParentData, TName, TData>\n  onChangeAsync?: ValidateAsyncFn<TParentData, TName, TData>\n  onChangeAsyncDebounceMs?: number\n  onBlur?: ValidateFn<TParentData, TName, TData>\n  onBlurAsync?: ValidateAsyncFn<TParentData, TName, TData>\n  onBlurAsyncDebounceMs?: number\n  onSubmitAsync?: ValidateAsyncFn<TParentData, TName, TData>\n  defaultMeta?: Partial<FieldMeta>\n}\n\nexport interface FieldApiOptions<\n  TParentData,\n  TName extends DeepKeys<TParentData>,\n  TData = DeepValue<TParentData, TName>,\n> extends FieldOptions<TParentData, TName, TData> {\n  form: FormApi<TParentData>\n}\n\nexport type FieldMeta = {\n  isTouched: boolean\n  touchedErrors: ValidationError[]\n  errors: ValidationError[]\n  errorMap: ValidationErrorMap\n  isValidating: boolean\n}\n\nlet uid = 0\n\nexport type FieldState<TData> = {\n  value: TData\n  meta: FieldMeta\n}\n\nexport type ResolveName<TParentData> = unknown extends TParentData\n  ? string\n  : DeepKeys<TParentData>\n\nexport class FieldApi<\n  TParentData,\n  TName extends DeepKeys<TParentData>,\n  TData = DeepValue<TParentData, TName>,\n> {\n  uid: number\n  form: FieldApiOptions<TParentData, TName, TData>['form']\n  name!: DeepKeys<TParentData>\n  options: FieldApiOptions<TParentData, TName> = {} as any\n  store!: Store<FieldState<TData>>\n  state!: FieldState<TData>\n  prevState!: FieldState<TData>\n\n  constructor(\n    opts: FieldApiOptions<TParentData, TName, TData> & {\n      form: FormApi<TParentData>\n    },\n  ) {\n    this.form = opts.form\n    this.uid = uid++\n    // Support field prefixing from FieldScope\n    // let fieldPrefix = ''\n    // if (this.form.fieldName) {\n    //   fieldPrefix = `${this.form.fieldName}.`\n    // }\n\n    this.name = opts.name as any\n\n    if (opts.defaultValue !== undefined) {\n      this.form.setFieldValue(this.name, opts.defaultValue as never)\n    }\n\n    this.store = new Store<FieldState<TData>>(\n      {\n        value: this.getValue(),\n        // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition\n        meta: this._getMeta() ?? {\n          isValidating: false,\n          isTouched: false,\n          touchedErrors: [],\n          errors: [],\n          errorMap: {},\n          ...opts.defaultMeta,\n        },\n      },\n      {\n        onUpdate: () => {\n          const state = this.store.state\n\n          state.meta.errors = Object.values(state.meta.errorMap).filter(\n            (val: unknown) => val !== undefined,\n          )\n\n          state.meta.touchedErrors = state.meta.isTouched\n            ? state.meta.errors\n            : []\n\n          this.prevState = state\n          this.state = state\n        },\n      },\n    )\n\n    this.state = this.store.state\n    this.prevState = this.state\n    this.options = opts as never\n  }\n\n  mount = () => {\n    const info = this.getInfo()\n    info.instances[this.uid] = this as never\n\n    const unsubscribe = this.form.store.subscribe(() => {\n      this.store.batch(() => {\n        const nextValue = this.getValue()\n        const nextMeta = this.getMeta()\n\n        if (nextValue !== this.state.value) {\n          this.store.setState((prev) => ({ ...prev, value: nextValue }))\n        }\n\n        if (nextMeta !== this.state.meta) {\n          this.store.setState((prev) => ({ ...prev, meta: nextMeta }))\n        }\n      })\n    })\n\n    this.update(this.options as never)\n    this.options.onMount?.(this as never)\n\n    return () => {\n      unsubscribe()\n      delete info.instances[this.uid]\n      if (!Object.keys(info.instances).length) {\n        delete this.form.fieldInfo[this.name]\n      }\n    }\n  }\n\n  update = (opts: FieldApiOptions<TParentData, TName, TData>) => {\n    // Default Value\n    // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition\n    if (this.state.value === undefined) {\n      const formDefault =\n        opts.form.options.defaultValues?.[opts.name as keyof TParentData]\n\n      if (opts.defaultValue !== undefined) {\n        this.setValue(opts.defaultValue as never)\n      } else if (formDefault !== undefined) {\n        this.setValue(formDefault as never)\n      }\n    }\n\n    // Default Meta\n    if (this._getMeta() === undefined) {\n      this.setMeta(this.state.meta)\n    }\n\n    this.options = opts as never\n  }\n\n  getValue = (): TData => {\n    return this.form.getFieldValue(this.name) as any\n  }\n\n  setValue = (\n    updater: Updater<TData>,\n    options?: { touch?: boolean; notify?: boolean },\n  ) => {\n    this.form.setFieldValue(this.name, updater as never, options)\n    this.validate('change', this.state.value)\n  }\n\n  _getMeta = () => this.form.getFieldMeta(this.name)\n  getMeta = () =>\n    this._getMeta() ??\n    ({\n      isValidating: false,\n      isTouched: false,\n      touchedErrors: [],\n      errors: [],\n      errorMap: {},\n      ...this.options.defaultMeta,\n    } as FieldMeta)\n\n  setMeta = (updater: Updater<FieldMeta>) =>\n    this.form.setFieldMeta(this.name, updater)\n\n  getInfo = () => this.form.getFieldInfo(this.name)\n\n  pushValue = (value: TData extends any[] ? TData[number] : never) =>\n    this.form.pushFieldValue(this.name, value as any)\n\n  insertValue = (\n    index: number,\n    value: TData extends any[] ? TData[number] : never,\n  ) => this.form.insertFieldValue(this.name, index, value as any)\n\n  removeValue = (index: number) => this.form.removeFieldValue(this.name, index)\n\n  swapValues = (aIndex: number, bIndex: number) =>\n    this.form.swapFieldValues(this.name, aIndex, bIndex)\n\n  getSubField = <\n    TSubName extends DeepKeys<TData>,\n    TSubData = DeepValue<TData, TSubName>,\n  >(\n    name: TSubName,\n  ): FieldApi<TData, TSubName, TSubData> =>\n    new FieldApi({\n      name: `${this.name}.${name}` as never,\n      form: this.form,\n    }) as any\n\n  validateSync = (value = this.state.value, cause: ValidationCause) => {\n    const { onChange, onBlur } = this.options\n    const validate =\n      cause === 'submit' ? undefined : cause === 'change' ? onChange : onBlur\n    if (!validate) return\n\n    // Use the validationCount for all field instances to\n    // track freshness of the validation\n    const validationCount = (this.getInfo().validationCount || 0) + 1\n    this.getInfo().validationCount = validationCount\n    const error = normalizeError(validate(value as never, this as never))\n    const errorMapKey = getErrorMapKey(cause)\n    if (this.state.meta.errorMap[errorMapKey] !== error) {\n      this.setMeta((prev) => ({\n        ...prev,\n        errorMap: {\n          ...prev.errorMap,\n          [getErrorMapKey(cause)]: error,\n        },\n      }))\n    }\n\n    // If a sync error is encountered for the errorMapKey (eg. onChange), cancel any async validation\n    if (this.state.meta.errorMap[errorMapKey]) {\n      this.cancelValidateAsync()\n    }\n  }\n\n  #leaseValidateAsync = () => {\n    const count = (this.getInfo().validationAsyncCount || 0) + 1\n    this.getInfo().validationAsyncCount = count\n    return count\n  }\n\n  cancelValidateAsync = () => {\n    // Lease a new validation count to ignore any pending validations\n    this.#leaseValidateAsync()\n    // Cancel any pending validation state\n    this.setMeta((prev) => ({\n      ...prev,\n      isValidating: false,\n    }))\n  }\n\n  validateAsync = async (value = this.state.value, cause: ValidationCause) => {\n    const {\n      onChangeAsync,\n      onBlurAsync,\n      onSubmitAsync,\n      asyncDebounceMs,\n      onBlurAsyncDebounceMs,\n      onChangeAsyncDebounceMs,\n    } = this.options\n\n    const validate =\n      cause === 'change'\n        ? onChangeAsync\n        : cause === 'submit'\n        ? onSubmitAsync\n        : onBlurAsync\n    if (!validate) return []\n    const debounceMs =\n      cause === 'submit'\n        ? 0\n        : (cause === 'change'\n            ? onChangeAsyncDebounceMs\n            : onBlurAsyncDebounceMs) ??\n          asyncDebounceMs ??\n          0\n\n    if (this.state.meta.isValidating !== true)\n      this.setMeta((prev) => ({ ...prev, isValidating: true }))\n\n    // Use the validationCount for all field instances to\n    // track freshness of the validation\n    const validationAsyncCount = this.#leaseValidateAsync()\n\n    const checkLatest = () =>\n      validationAsyncCount === this.getInfo().validationAsyncCount\n\n    if (!this.getInfo().validationPromise) {\n      this.getInfo().validationPromise = new Promise((resolve, reject) => {\n        this.getInfo().validationResolve = resolve\n        this.getInfo().validationReject = reject\n      })\n    }\n\n    if (debounceMs > 0) {\n      await new Promise((r) => setTimeout(r, debounceMs))\n    }\n\n    // Only kick off validation if this validation is the latest attempt\n    if (checkLatest()) {\n      const prevErrors = this.getMeta().errors\n      try {\n        const rawError = await validate(value as never, this as never)\n        if (checkLatest()) {\n          const error = normalizeError(rawError)\n          this.setMeta((prev) => ({\n            ...prev,\n            isValidating: false,\n            errorMap: {\n              ...prev.errorMap,\n              [getErrorMapKey(cause)]: error,\n            },\n          }))\n          this.getInfo().validationResolve?.([...prevErrors, error])\n        }\n      } catch (error) {\n        if (checkLatest()) {\n          this.getInfo().validationReject?.([...prevErrors, error])\n          throw error\n        }\n      } finally {\n        if (checkLatest()) {\n          this.setMeta((prev) => ({ ...prev, isValidating: false }))\n          delete this.getInfo().validationPromise\n        }\n      }\n    }\n\n    // Always return the latest validation promise to the caller\n    return this.getInfo().validationPromise ?? []\n  }\n\n  validate = (\n    cause: ValidationCause,\n    value?: TData,\n  ): ValidationError[] | Promise<ValidationError[]> => {\n    // If the field is pristine and validatePristine is false, do not validate\n    if (!this.state.meta.isTouched) return []\n    // Attempt to sync validate first\n    this.validateSync(value, cause)\n\n    const errorMapKey = getErrorMapKey(cause)\n    // If there is an error mapped to the errorMapKey (eg. onChange, onBlur, onSubmit), return the errors array, do not attempt async validation\n    if (this.getMeta().errorMap[errorMapKey]) {\n      if (!this.options.asyncAlways) {\n        return this.state.meta.errors\n      }\n    }\n    // No error? Attempt async validation\n    return this.validateAsync(value, cause)\n  }\n\n  handleChange = (updater: Updater<TData>) => {\n    this.setValue(updater, { touch: true })\n  }\n\n  handleBlur = () => {\n    const prevTouched = this.state.meta.isTouched\n    if (!prevTouched) {\n      this.setMeta((prev) => ({ ...prev, isTouched: true }))\n      this.validate('change')\n    }\n    this.validate('blur')\n  }\n}\n\nfunction normalizeError(rawError?: ValidationError) {\n  if (rawError) {\n    if (typeof rawError !== 'string') {\n      return 'Invalid Form Values'\n    }\n\n    return rawError\n  }\n\n  return undefined\n}\n\nfunction getErrorMapKey(cause: ValidationCause) {\n  switch (cause) {\n    case 'submit':\n      return 'onSubmit'\n    case 'change':\n      return 'onChange'\n    case 'blur':\n      return 'onBlur'\n    case 'mount':\n      return 'onMount'\n  }\n}\n"],"mappings":"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","names":[]}

package/build/legacy/FieldApi.js

@@ -194,6 +194,9 @@ var _FieldApi = class _FieldApi {
     this.form = opts.form;
     this.uid = uid++;
     this.name = opts.name;
+    if (opts.defaultValue !== void 0) {
+      this.form.setFieldValue(this.name, opts.defaultValue);
+    }
     this.store = new Store(
       {
         value: this.getValue(),

package/build/legacy/FieldApi.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/FieldApi.ts"],"sourcesContent":["import { type DeepKeys, type DeepValue, type Updater } from './utils'\nimport type { FormApi, ValidationError, ValidationErrorMap } from './FormApi'\nimport { Store } from '@tanstack/store'\n\nexport type ValidationCause = 'change' | 'blur' | 'submit' | 'mount'\n\ntype ValidateFn<TParentData, TName extends DeepKeys<TParentData>, TData> = (\n  value: TData,\n  fieldApi: FieldApi<TParentData, TName>,\n) => ValidationError\n\ntype ValidateAsyncFn<\n  TParentData,\n  TName extends DeepKeys<TParentData>,\n  TData,\n> = (\n  value: TData,\n  fieldApi: FieldApi<TParentData, TName>,\n) => ValidationError | Promise<ValidationError>\n\nexport interface FieldOptions<\n  TParentData,\n  /**\n   * This allows us to restrict the name to only be a valid field name while\n   * also assigning it to a generic\n   */\n  TName extends DeepKeys<TParentData>,\n  /**\n   * If TData is unknown, we can use the TName generic to determine the type\n   */\n  TData = DeepValue<TParentData, TName>,\n> {\n  name: DeepKeys<TParentData>\n  index?: TData extends any[] ? number : never\n  defaultValue?: TData\n  asyncDebounceMs?: number\n  asyncAlways?: boolean\n  onMount?: (formApi: FieldApi<TParentData, TName>) => void\n  onChange?: ValidateFn<TParentData, TName, TData>\n  onChangeAsync?: ValidateAsyncFn<TParentData, TName, TData>\n  onChangeAsyncDebounceMs?: number\n  onBlur?: ValidateFn<TParentData, TName, TData>\n  onBlurAsync?: ValidateAsyncFn<TParentData, TName, TData>\n  onBlurAsyncDebounceMs?: number\n  onSubmitAsync?: ValidateAsyncFn<TParentData, TName, TData>\n  defaultMeta?: Partial<FieldMeta>\n}\n\nexport interface FieldApiOptions<\n  TParentData,\n  TName extends DeepKeys<TParentData>,\n  TData = DeepValue<TParentData, TName>,\n> extends FieldOptions<TParentData, TName, TData> {\n  form: FormApi<TParentData>\n}\n\nexport type FieldMeta = {\n  isTouched: boolean\n  touchedErrors: ValidationError[]\n  errors: ValidationError[]\n  errorMap: ValidationErrorMap\n  isValidating: boolean\n}\n\nlet uid = 0\n\nexport type FieldState<TData> = {\n  value: TData\n  meta: FieldMeta\n}\n\nexport type ResolveName<TParentData> = unknown extends TParentData\n  ? string\n  : DeepKeys<TParentData>\n\nexport class FieldApi<\n  TParentData,\n  TName extends DeepKeys<TParentData>,\n  TData = DeepValue<TParentData, TName>,\n> {\n  uid: number\n  form: FieldApiOptions<TParentData, TName, TData>['form']\n  name!: DeepKeys<TParentData>\n  options: FieldApiOptions<TParentData, TName> = {} as any\n  store!: Store<FieldState<TData>>\n  state!: FieldState<TData>\n  prevState!: FieldState<TData>\n\n  constructor(\n    opts: FieldApiOptions<TParentData, TName, TData> & {\n      form: FormApi<TParentData>\n    },\n  ) {\n    this.form = opts.form\n    this.uid = uid++\n    // Support field prefixing from FieldScope\n    // let fieldPrefix = ''\n    // if (this.form.fieldName) {\n    //   fieldPrefix = `${this.form.fieldName}.`\n    // }\n\n    this.name = opts.name as any\n\n    this.store = new Store<FieldState<TData>>(\n      {\n        value: this.getValue(),\n        // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition\n        meta: this._getMeta() ?? {\n          isValidating: false,\n          isTouched: false,\n          touchedErrors: [],\n          errors: [],\n          errorMap: {},\n          ...opts.defaultMeta,\n        },\n      },\n      {\n        onUpdate: () => {\n          const state = this.store.state\n\n          state.meta.errors = Object.values(state.meta.errorMap).filter(\n            (val: unknown) => val !== undefined,\n          )\n\n          state.meta.touchedErrors = state.meta.isTouched\n            ? state.meta.errors\n            : []\n\n          this.prevState = state\n          this.state = state\n        },\n      },\n    )\n\n    this.state = this.store.state\n    this.prevState = this.state\n    this.options = opts as never\n  }\n\n  mount = () => {\n    const info = this.getInfo()\n    info.instances[this.uid] = this as never\n\n    const unsubscribe = this.form.store.subscribe(() => {\n      this.store.batch(() => {\n        const nextValue = this.getValue()\n        const nextMeta = this.getMeta()\n\n        if (nextValue !== this.state.value) {\n          this.store.setState((prev) => ({ ...prev, value: nextValue }))\n        }\n\n        if (nextMeta !== this.state.meta) {\n          this.store.setState((prev) => ({ ...prev, meta: nextMeta }))\n        }\n      })\n    })\n\n    this.update(this.options as never)\n    this.options.onMount?.(this as never)\n\n    return () => {\n      unsubscribe()\n      delete info.instances[this.uid]\n      if (!Object.keys(info.instances).length) {\n        delete this.form.fieldInfo[this.name]\n      }\n    }\n  }\n\n  update = (opts: FieldApiOptions<TParentData, TName, TData>) => {\n    // Default Value\n    // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition\n    if (this.state.value === undefined) {\n      const formDefault =\n        opts.form.options.defaultValues?.[opts.name as keyof TParentData]\n\n      if (opts.defaultValue !== undefined) {\n        this.setValue(opts.defaultValue as never)\n      } else if (formDefault !== undefined) {\n        this.setValue(formDefault as never)\n      }\n    }\n\n    // Default Meta\n    if (this._getMeta() === undefined) {\n      this.setMeta(this.state.meta)\n    }\n\n    this.options = opts as never\n  }\n\n  getValue = (): TData => {\n    return this.form.getFieldValue(this.name) as any\n  }\n\n  setValue = (\n    updater: Updater<TData>,\n    options?: { touch?: boolean; notify?: boolean },\n  ) => {\n    this.form.setFieldValue(this.name, updater as never, options)\n    this.validate('change', this.state.value)\n  }\n\n  _getMeta = () => this.form.getFieldMeta(this.name)\n  getMeta = () =>\n    this._getMeta() ??\n    ({\n      isValidating: false,\n      isTouched: false,\n      touchedErrors: [],\n      errors: [],\n      errorMap: {},\n      ...this.options.defaultMeta,\n    } as FieldMeta)\n\n  setMeta = (updater: Updater<FieldMeta>) =>\n    this.form.setFieldMeta(this.name, updater)\n\n  getInfo = () => this.form.getFieldInfo(this.name)\n\n  pushValue = (value: TData extends any[] ? TData[number] : never) =>\n    this.form.pushFieldValue(this.name, value as any)\n\n  insertValue = (\n    index: number,\n    value: TData extends any[] ? TData[number] : never,\n  ) => this.form.insertFieldValue(this.name, index, value as any)\n\n  removeValue = (index: number) => this.form.removeFieldValue(this.name, index)\n\n  swapValues = (aIndex: number, bIndex: number) =>\n    this.form.swapFieldValues(this.name, aIndex, bIndex)\n\n  getSubField = <\n    TSubName extends DeepKeys<TData>,\n    TSubData = DeepValue<TData, TSubName>,\n  >(\n    name: TSubName,\n  ): FieldApi<TData, TSubName, TSubData> =>\n    new FieldApi({\n      name: `${this.name}.${name}` as never,\n      form: this.form,\n    }) as any\n\n  validateSync = (value = this.state.value, cause: ValidationCause) => {\n    const { onChange, onBlur } = this.options\n    const validate =\n      cause === 'submit' ? undefined : cause === 'change' ? onChange : onBlur\n    if (!validate) return\n\n    // Use the validationCount for all field instances to\n    // track freshness of the validation\n    const validationCount = (this.getInfo().validationCount || 0) + 1\n    this.getInfo().validationCount = validationCount\n    const error = normalizeError(validate(value as never, this as never))\n    const errorMapKey = getErrorMapKey(cause)\n    if (this.state.meta.errorMap[errorMapKey] !== error) {\n      this.setMeta((prev) => ({\n        ...prev,\n        errorMap: {\n          ...prev.errorMap,\n          [getErrorMapKey(cause)]: error,\n        },\n      }))\n    }\n\n    // If a sync error is encountered for the errorMapKey (eg. onChange), cancel any async validation\n    if (this.state.meta.errorMap[errorMapKey]) {\n      this.cancelValidateAsync()\n    }\n  }\n\n  #leaseValidateAsync = () => {\n    const count = (this.getInfo().validationAsyncCount || 0) + 1\n    this.getInfo().validationAsyncCount = count\n    return count\n  }\n\n  cancelValidateAsync = () => {\n    // Lease a new validation count to ignore any pending validations\n    this.#leaseValidateAsync()\n    // Cancel any pending validation state\n    this.setMeta((prev) => ({\n      ...prev,\n      isValidating: false,\n    }))\n  }\n\n  validateAsync = async (value = this.state.value, cause: ValidationCause) => {\n    const {\n      onChangeAsync,\n      onBlurAsync,\n      onSubmitAsync,\n      asyncDebounceMs,\n      onBlurAsyncDebounceMs,\n      onChangeAsyncDebounceMs,\n    } = this.options\n\n    const validate =\n      cause === 'change'\n        ? onChangeAsync\n        : cause === 'submit'\n        ? onSubmitAsync\n        : onBlurAsync\n    if (!validate) return []\n    const debounceMs =\n      cause === 'submit'\n        ? 0\n        : (cause === 'change'\n            ? onChangeAsyncDebounceMs\n            : onBlurAsyncDebounceMs) ??\n          asyncDebounceMs ??\n          0\n\n    if (this.state.meta.isValidating !== true)\n      this.setMeta((prev) => ({ ...prev, isValidating: true }))\n\n    // Use the validationCount for all field instances to\n    // track freshness of the validation\n    const validationAsyncCount = this.#leaseValidateAsync()\n\n    const checkLatest = () =>\n      validationAsyncCount === this.getInfo().validationAsyncCount\n\n    if (!this.getInfo().validationPromise) {\n      this.getInfo().validationPromise = new Promise((resolve, reject) => {\n        this.getInfo().validationResolve = resolve\n        this.getInfo().validationReject = reject\n      })\n    }\n\n    if (debounceMs > 0) {\n      await new Promise((r) => setTimeout(r, debounceMs))\n    }\n\n    // Only kick off validation if this validation is the latest attempt\n    if (checkLatest()) {\n      const prevErrors = this.getMeta().errors\n      try {\n        const rawError = await validate(value as never, this as never)\n        if (checkLatest()) {\n          const error = normalizeError(rawError)\n          this.setMeta((prev) => ({\n            ...prev,\n            isValidating: false,\n            errorMap: {\n              ...prev.errorMap,\n              [getErrorMapKey(cause)]: error,\n            },\n          }))\n          this.getInfo().validationResolve?.([...prevErrors, error])\n        }\n      } catch (error) {\n        if (checkLatest()) {\n          this.getInfo().validationReject?.([...prevErrors, error])\n          throw error\n        }\n      } finally {\n        if (checkLatest()) {\n          this.setMeta((prev) => ({ ...prev, isValidating: false }))\n          delete this.getInfo().validationPromise\n        }\n      }\n    }\n\n    // Always return the latest validation promise to the caller\n    return this.getInfo().validationPromise ?? []\n  }\n\n  validate = (\n    cause: ValidationCause,\n    value?: TData,\n  ): ValidationError[] | Promise<ValidationError[]> => {\n    // If the field is pristine and validatePristine is false, do not validate\n    if (!this.state.meta.isTouched) return []\n    // Attempt to sync validate first\n    this.validateSync(value, cause)\n\n    const errorMapKey = getErrorMapKey(cause)\n    // If there is an error mapped to the errorMapKey (eg. onChange, onBlur, onSubmit), return the errors array, do not attempt async validation\n    if (this.getMeta().errorMap[errorMapKey]) {\n      if (!this.options.asyncAlways) {\n        return this.state.meta.errors\n      }\n    }\n    // No error? Attempt async validation\n    return this.validateAsync(value, cause)\n  }\n\n  handleChange = (updater: Updater<TData>) => {\n    this.setValue(updater, { touch: true })\n  }\n\n  handleBlur = () => {\n    const prevTouched = this.state.meta.isTouched\n    if (!prevTouched) {\n      this.setMeta((prev) => ({ ...prev, isTouched: true }))\n      this.validate('change')\n    }\n    this.validate('blur')\n  }\n}\n\nfunction normalizeError(rawError?: ValidationError) {\n  if (rawError) {\n    if (typeof rawError !== 'string') {\n      return 'Invalid Form Values'\n    }\n\n    return rawError\n  }\n\n  return undefined\n}\n\nfunction getErrorMapKey(cause: ValidationCause) {\n  switch (cause) {\n    case 'submit':\n      return 'onSubmit'\n    case 'change':\n      return 'onChange'\n    case 'blur':\n      return 'onBlur'\n    case 'mount':\n      return 'onMount'\n  }\n}\n"],"mappings":";;;;;;AAEA,SAAS,aAAa;AA8DtB,IAAI,MAAM;AAhEV;AA2EO,IAAM,YAAN,MAAM,UAIX;AAAA,EASA,YACE,MAGA;AATF,mBAA+C,CAAC;AAwDhD,iBAAQ,MAAM;AA3IhB;AA4II,YAAM,OAAO,KAAK,QAAQ;AAC1B,WAAK,UAAU,KAAK,GAAG,IAAI;AAE3B,YAAM,cAAc,KAAK,KAAK,MAAM,UAAU,MAAM;AAClD,aAAK,MAAM,MAAM,MAAM;AACrB,gBAAM,YAAY,KAAK,SAAS;AAChC,gBAAM,WAAW,KAAK,QAAQ;AAE9B,cAAI,cAAc,KAAK,MAAM,OAAO;AAClC,iBAAK,MAAM,SAAS,CAAC,UAAU,EAAE,GAAG,MAAM,OAAO,UAAU,EAAE;AAAA,UAC/D;AAEA,cAAI,aAAa,KAAK,MAAM,MAAM;AAChC,iBAAK,MAAM,SAAS,CAAC,UAAU,EAAE,GAAG,MAAM,MAAM,SAAS,EAAE;AAAA,UAC7D;AAAA,QACF,CAAC;AAAA,MACH,CAAC;AAED,WAAK,OAAO,KAAK,OAAgB;AACjC,uBAAK,SAAQ,YAAb,4BAAuB;AAEvB,aAAO,MAAM;AACX,oBAAY;AACZ,eAAO,KAAK,UAAU,KAAK,GAAG;AAC9B,YAAI,CAAC,OAAO,KAAK,KAAK,SAAS,EAAE,QAAQ;AACvC,iBAAO,KAAK,KAAK,UAAU,KAAK,IAAI;AAAA,QACtC;AAAA,MACF;AAAA,IACF;AAEA,kBAAS,CAAC,SAAqD;AA1KjE;AA6KI,UAAI,KAAK,MAAM,UAAU,QAAW;AAClC,cAAM,eACJ,UAAK,KAAK,QAAQ,kBAAlB,mBAAkC,KAAK;AAEzC,YAAI,KAAK,iBAAiB,QAAW;AACnC,eAAK,SAAS,KAAK,YAAqB;AAAA,QAC1C,WAAW,gBAAgB,QAAW;AACpC,eAAK,SAAS,WAAoB;AAAA,QACpC;AAAA,MACF;AAGA,UAAI,KAAK,SAAS,MAAM,QAAW;AACjC,aAAK,QAAQ,KAAK,MAAM,IAAI;AAAA,MAC9B;AAEA,WAAK,UAAU;AAAA,IACjB;AAEA,oBAAW,MAAa;AACtB,aAAO,KAAK,KAAK,cAAc,KAAK,IAAI;AAAA,IAC1C;AAEA,oBAAW,CACT,SACA,YACG;AACH,WAAK,KAAK,cAAc,KAAK,MAAM,SAAkB,OAAO;AAC5D,WAAK,SAAS,UAAU,KAAK,MAAM,KAAK;AAAA,IAC1C;AAEA,oBAAW,MAAM,KAAK,KAAK,aAAa,KAAK,IAAI;AACjD,mBAAU,MACR,KAAK,SAAS,KACb;AAAA,MACC,cAAc;AAAA,MACd,WAAW;AAAA,MACX,eAAe,CAAC;AAAA,MAChB,QAAQ,CAAC;AAAA,MACT,UAAU,CAAC;AAAA,MACX,GAAG,KAAK,QAAQ;AAAA,IAClB;AAEF,mBAAU,CAAC,YACT,KAAK,KAAK,aAAa,KAAK,MAAM,OAAO;AAE3C,mBAAU,MAAM,KAAK,KAAK,aAAa,KAAK,IAAI;AAEhD,qBAAY,CAAC,UACX,KAAK,KAAK,eAAe,KAAK,MAAM,KAAY;AAElD,uBAAc,CACZ,OACA,UACG,KAAK,KAAK,iBAAiB,KAAK,MAAM,OAAO,KAAY;AAE9D,uBAAc,CAAC,UAAkB,KAAK,KAAK,iBAAiB,KAAK,MAAM,KAAK;AAE5E,sBAAa,CAAC,QAAgB,WAC5B,KAAK,KAAK,gBAAgB,KAAK,MAAM,QAAQ,MAAM;AAErD,uBAAc,CAIZ,SAEA,IAAI,UAAS;AAAA,MACX,MAAM,GAAG,KAAK,IAAI,IAAI,IAAI;AAAA,MAC1B,MAAM,KAAK;AAAA,IACb,CAAC;AAEH,wBAAe,CAAC,QAAQ,KAAK,MAAM,OAAO,UAA2B;AACnE,YAAM,EAAE,UAAU,OAAO,IAAI,KAAK;AAClC,YAAM,WACJ,UAAU,WAAW,SAAY,UAAU,WAAW,WAAW;AACnE,UAAI,CAAC;AAAU;AAIf,YAAM,mBAAmB,KAAK,QAAQ,EAAE,mBAAmB,KAAK;AAChE,WAAK,QAAQ,EAAE,kBAAkB;AACjC,YAAM,QAAQ,eAAe,SAAS,OAAgB,IAAa,CAAC;AACpE,YAAM,cAAc,eAAe,KAAK;AACxC,UAAI,KAAK,MAAM,KAAK,SAAS,WAAW,MAAM,OAAO;AACnD,aAAK,QAAQ,CAAC,UAAU;AAAA,UACtB,GAAG;AAAA,UACH,UAAU;AAAA,YACR,GAAG,KAAK;AAAA,YACR,CAAC,eAAe,KAAK,CAAC,GAAG;AAAA,UAC3B;AAAA,QACF,EAAE;AAAA,MACJ;AAGA,UAAI,KAAK,MAAM,KAAK,SAAS,WAAW,GAAG;AACzC,aAAK,oBAAoB;AAAA,MAC3B;AAAA,IACF;AAEA,4CAAsB,MAAM;AAC1B,YAAM,SAAS,KAAK,QAAQ,EAAE,wBAAwB,KAAK;AAC3D,WAAK,QAAQ,EAAE,uBAAuB;AACtC,aAAO;AAAA,IACT;AAEA,+BAAsB,MAAM;AAE1B,yBAAK,qBAAL;AAEA,WAAK,QAAQ,CAAC,UAAU;AAAA,QACtB,GAAG;AAAA,QACH,cAAc;AAAA,MAChB,EAAE;AAAA,IACJ;AAEA,yBAAgB,OAAO,QAAQ,KAAK,MAAM,OAAO,UAA2B;AAjS9E;AAkSI,YAAM;AAAA,QACJ;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,MACF,IAAI,KAAK;AAET,YAAM,WACJ,UAAU,WACN,gBACA,UAAU,WACV,gBACA;AACN,UAAI,CAAC;AAAU,eAAO,CAAC;AACvB,YAAM,aACJ,UAAU,WACN,KACC,UAAU,WACP,0BACA,0BACJ,mBACA;AAEN,UAAI,KAAK,MAAM,KAAK,iBAAiB;AACnC,aAAK,QAAQ,CAAC,UAAU,EAAE,GAAG,MAAM,cAAc,KAAK,EAAE;AAI1D,YAAM,uBAAuB,mBAAK,qBAAL;AAE7B,YAAM,cAAc,MAClB,yBAAyB,KAAK,QAAQ,EAAE;AAE1C,UAAI,CAAC,KAAK,QAAQ,EAAE,mBAAmB;AACrC,aAAK,QAAQ,EAAE,oBAAoB,IAAI,QAAQ,CAAC,SAAS,WAAW;AAClE,eAAK,QAAQ,EAAE,oBAAoB;AACnC,eAAK,QAAQ,EAAE,mBAAmB;AAAA,QACpC,CAAC;AAAA,MACH;AAEA,UAAI,aAAa,GAAG;AAClB,cAAM,IAAI,QAAQ,CAAC,MAAM,WAAW,GAAG,UAAU,CAAC;AAAA,MACpD;AAGA,UAAI,YAAY,GAAG;AACjB,cAAM,aAAa,KAAK,QAAQ,EAAE;AAClC,YAAI;AACF,gBAAM,WAAW,MAAM,SAAS,OAAgB,IAAa;AAC7D,cAAI,YAAY,GAAG;AACjB,kBAAM,QAAQ,eAAe,QAAQ;AACrC,iBAAK,QAAQ,CAAC,UAAU;AAAA,cACtB,GAAG;AAAA,cACH,cAAc;AAAA,cACd,UAAU;AAAA,gBACR,GAAG,KAAK;AAAA,gBACR,CAAC,eAAe,KAAK,CAAC,GAAG;AAAA,cAC3B;AAAA,YACF,EAAE;AACF,6BAAK,QAAQ,GAAE,sBAAf,4BAAmC,CAAC,GAAG,YAAY,KAAK;AAAA,UAC1D;AAAA,QACF,SAAS,OAAO;AACd,cAAI,YAAY,GAAG;AACjB,6BAAK,QAAQ,GAAE,qBAAf,4BAAkC,CAAC,GAAG,YAAY,KAAK;AACvD,kBAAM;AAAA,UACR;AAAA,QACF,UAAE;AACA,cAAI,YAAY,GAAG;AACjB,iBAAK,QAAQ,CAAC,UAAU,EAAE,GAAG,MAAM,cAAc,MAAM,EAAE;AACzD,mBAAO,KAAK,QAAQ,EAAE;AAAA,UACxB;AAAA,QACF;AAAA,MACF;AAGA,aAAO,KAAK,QAAQ,EAAE,qBAAqB,CAAC;AAAA,IAC9C;AAEA,oBAAW,CACT,OACA,UACmD;AAEnD,UAAI,CAAC,KAAK,MAAM,KAAK;AAAW,eAAO,CAAC;AAExC,WAAK,aAAa,OAAO,KAAK;AAE9B,YAAM,cAAc,eAAe,KAAK;AAExC,UAAI,KAAK,QAAQ,EAAE,SAAS,WAAW,GAAG;AACxC,YAAI,CAAC,KAAK,QAAQ,aAAa;AAC7B,iBAAO,KAAK,MAAM,KAAK;AAAA,QACzB;AAAA,MACF;AAEA,aAAO,KAAK,cAAc,OAAO,KAAK;AAAA,IACxC;AAEA,wBAAe,CAAC,YAA4B;AAC1C,WAAK,SAAS,SAAS,EAAE,OAAO,KAAK,CAAC;AAAA,IACxC;AAEA,sBAAa,MAAM;AACjB,YAAM,cAAc,KAAK,MAAM,KAAK;AACpC,UAAI,CAAC,aAAa;AAChB,aAAK,QAAQ,CAAC,UAAU,EAAE,GAAG,MAAM,WAAW,KAAK,EAAE;AACrD,aAAK,SAAS,QAAQ;AAAA,MACxB;AACA,WAAK,SAAS,MAAM;AAAA,IACtB;AApTE,SAAK,OAAO,KAAK;AACjB,SAAK,MAAM;AAOX,SAAK,OAAO,KAAK;AAEjB,SAAK,QAAQ,IAAI;AAAA,MACf;AAAA,QACE,OAAO,KAAK,SAAS;AAAA;AAAA,QAErB,MAAM,KAAK,SAAS,KAAK;AAAA,UACvB,cAAc;AAAA,UACd,WAAW;AAAA,UACX,eAAe,CAAC;AAAA,UAChB,QAAQ,CAAC;AAAA,UACT,UAAU,CAAC;AAAA,UACX,GAAG,KAAK;AAAA,QACV;AAAA,MACF;AAAA,MACA;AAAA,QACE,UAAU,MAAM;AACd,gBAAM,QAAQ,KAAK,MAAM;AAEzB,gBAAM,KAAK,SAAS,OAAO,OAAO,MAAM,KAAK,QAAQ,EAAE;AAAA,YACrD,CAAC,QAAiB,QAAQ;AAAA,UAC5B;AAEA,gBAAM,KAAK,gBAAgB,MAAM,KAAK,YAClC,MAAM,KAAK,SACX,CAAC;AAEL,eAAK,YAAY;AACjB,eAAK,QAAQ;AAAA,QACf;AAAA,MACF;AAAA,IACF;AAEA,SAAK,QAAQ,KAAK,MAAM;AACxB,SAAK,YAAY,KAAK;AACtB,SAAK,UAAU;AAAA,EACjB;AAyQF;AAjIE;AAtMK,IAAM,WAAN;AAyUP,SAAS,eAAe,UAA4B;AAClD,MAAI,UAAU;AACZ,QAAI,OAAO,aAAa,UAAU;AAChC,aAAO;AAAA,IACT;AAEA,WAAO;AAAA,EACT;AAEA,SAAO;AACT;AAEA,SAAS,eAAe,OAAwB;AAC9C,UAAQ,OAAO;AAAA,IACb,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,EACX;AACF;","names":[]}
+{"version":3,"sources":["../../src/FieldApi.ts"],"sourcesContent":["import { type DeepKeys, type DeepValue, type Updater } from './utils'\nimport type { FormApi, ValidationError, ValidationErrorMap } from './FormApi'\nimport { Store } from '@tanstack/store'\n\nexport type ValidationCause = 'change' | 'blur' | 'submit' | 'mount'\n\ntype ValidateFn<TParentData, TName extends DeepKeys<TParentData>, TData> = (\n  value: TData,\n  fieldApi: FieldApi<TParentData, TName>,\n) => ValidationError\n\ntype ValidateAsyncFn<\n  TParentData,\n  TName extends DeepKeys<TParentData>,\n  TData,\n> = (\n  value: TData,\n  fieldApi: FieldApi<TParentData, TName>,\n) => ValidationError | Promise<ValidationError>\n\nexport interface FieldOptions<\n  TParentData,\n  /**\n   * This allows us to restrict the name to only be a valid field name while\n   * also assigning it to a generic\n   */\n  TName extends DeepKeys<TParentData>,\n  /**\n   * If TData is unknown, we can use the TName generic to determine the type\n   */\n  TData = DeepValue<TParentData, TName>,\n> {\n  name: DeepKeys<TParentData>\n  index?: TData extends any[] ? number : never\n  defaultValue?: TData\n  asyncDebounceMs?: number\n  asyncAlways?: boolean\n  onMount?: (formApi: FieldApi<TParentData, TName>) => void\n  onChange?: ValidateFn<TParentData, TName, TData>\n  onChangeAsync?: ValidateAsyncFn<TParentData, TName, TData>\n  onChangeAsyncDebounceMs?: number\n  onBlur?: ValidateFn<TParentData, TName, TData>\n  onBlurAsync?: ValidateAsyncFn<TParentData, TName, TData>\n  onBlurAsyncDebounceMs?: number\n  onSubmitAsync?: ValidateAsyncFn<TParentData, TName, TData>\n  defaultMeta?: Partial<FieldMeta>\n}\n\nexport interface FieldApiOptions<\n  TParentData,\n  TName extends DeepKeys<TParentData>,\n  TData = DeepValue<TParentData, TName>,\n> extends FieldOptions<TParentData, TName, TData> {\n  form: FormApi<TParentData>\n}\n\nexport type FieldMeta = {\n  isTouched: boolean\n  touchedErrors: ValidationError[]\n  errors: ValidationError[]\n  errorMap: ValidationErrorMap\n  isValidating: boolean\n}\n\nlet uid = 0\n\nexport type FieldState<TData> = {\n  value: TData\n  meta: FieldMeta\n}\n\nexport type ResolveName<TParentData> = unknown extends TParentData\n  ? string\n  : DeepKeys<TParentData>\n\nexport class FieldApi<\n  TParentData,\n  TName extends DeepKeys<TParentData>,\n  TData = DeepValue<TParentData, TName>,\n> {\n  uid: number\n  form: FieldApiOptions<TParentData, TName, TData>['form']\n  name!: DeepKeys<TParentData>\n  options: FieldApiOptions<TParentData, TName> = {} as any\n  store!: Store<FieldState<TData>>\n  state!: FieldState<TData>\n  prevState!: FieldState<TData>\n\n  constructor(\n    opts: FieldApiOptions<TParentData, TName, TData> & {\n      form: FormApi<TParentData>\n    },\n  ) {\n    this.form = opts.form\n    this.uid = uid++\n    // Support field prefixing from FieldScope\n    // let fieldPrefix = ''\n    // if (this.form.fieldName) {\n    //   fieldPrefix = `${this.form.fieldName}.`\n    // }\n\n    this.name = opts.name as any\n\n    if (opts.defaultValue !== undefined) {\n      this.form.setFieldValue(this.name, opts.defaultValue as never)\n    }\n\n    this.store = new Store<FieldState<TData>>(\n      {\n        value: this.getValue(),\n        // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition\n        meta: this._getMeta() ?? {\n          isValidating: false,\n          isTouched: false,\n          touchedErrors: [],\n          errors: [],\n          errorMap: {},\n          ...opts.defaultMeta,\n        },\n      },\n      {\n        onUpdate: () => {\n          const state = this.store.state\n\n          state.meta.errors = Object.values(state.meta.errorMap).filter(\n            (val: unknown) => val !== undefined,\n          )\n\n          state.meta.touchedErrors = state.meta.isTouched\n            ? state.meta.errors\n            : []\n\n          this.prevState = state\n          this.state = state\n        },\n      },\n    )\n\n    this.state = this.store.state\n    this.prevState = this.state\n    this.options = opts as never\n  }\n\n  mount = () => {\n    const info = this.getInfo()\n    info.instances[this.uid] = this as never\n\n    const unsubscribe = this.form.store.subscribe(() => {\n      this.store.batch(() => {\n        const nextValue = this.getValue()\n        const nextMeta = this.getMeta()\n\n        if (nextValue !== this.state.value) {\n          this.store.setState((prev) => ({ ...prev, value: nextValue }))\n        }\n\n        if (nextMeta !== this.state.meta) {\n          this.store.setState((prev) => ({ ...prev, meta: nextMeta }))\n        }\n      })\n    })\n\n    this.update(this.options as never)\n    this.options.onMount?.(this as never)\n\n    return () => {\n      unsubscribe()\n      delete info.instances[this.uid]\n      if (!Object.keys(info.instances).length) {\n        delete this.form.fieldInfo[this.name]\n      }\n    }\n  }\n\n  update = (opts: FieldApiOptions<TParentData, TName, TData>) => {\n    // Default Value\n    // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition\n    if (this.state.value === undefined) {\n      const formDefault =\n        opts.form.options.defaultValues?.[opts.name as keyof TParentData]\n\n      if (opts.defaultValue !== undefined) {\n        this.setValue(opts.defaultValue as never)\n      } else if (formDefault !== undefined) {\n        this.setValue(formDefault as never)\n      }\n    }\n\n    // Default Meta\n    if (this._getMeta() === undefined) {\n      this.setMeta(this.state.meta)\n    }\n\n    this.options = opts as never\n  }\n\n  getValue = (): TData => {\n    return this.form.getFieldValue(this.name) as any\n  }\n\n  setValue = (\n    updater: Updater<TData>,\n    options?: { touch?: boolean; notify?: boolean },\n  ) => {\n    this.form.setFieldValue(this.name, updater as never, options)\n    this.validate('change', this.state.value)\n  }\n\n  _getMeta = () => this.form.getFieldMeta(this.name)\n  getMeta = () =>\n    this._getMeta() ??\n    ({\n      isValidating: false,\n      isTouched: false,\n      touchedErrors: [],\n      errors: [],\n      errorMap: {},\n      ...this.options.defaultMeta,\n    } as FieldMeta)\n\n  setMeta = (updater: Updater<FieldMeta>) =>\n    this.form.setFieldMeta(this.name, updater)\n\n  getInfo = () => this.form.getFieldInfo(this.name)\n\n  pushValue = (value: TData extends any[] ? TData[number] : never) =>\n    this.form.pushFieldValue(this.name, value as any)\n\n  insertValue = (\n    index: number,\n    value: TData extends any[] ? TData[number] : never,\n  ) => this.form.insertFieldValue(this.name, index, value as any)\n\n  removeValue = (index: number) => this.form.removeFieldValue(this.name, index)\n\n  swapValues = (aIndex: number, bIndex: number) =>\n    this.form.swapFieldValues(this.name, aIndex, bIndex)\n\n  getSubField = <\n    TSubName extends DeepKeys<TData>,\n    TSubData = DeepValue<TData, TSubName>,\n  >(\n    name: TSubName,\n  ): FieldApi<TData, TSubName, TSubData> =>\n    new FieldApi({\n      name: `${this.name}.${name}` as never,\n      form: this.form,\n    }) as any\n\n  validateSync = (value = this.state.value, cause: ValidationCause) => {\n    const { onChange, onBlur } = this.options\n    const validate =\n      cause === 'submit' ? undefined : cause === 'change' ? onChange : onBlur\n    if (!validate) return\n\n    // Use the validationCount for all field instances to\n    // track freshness of the validation\n    const validationCount = (this.getInfo().validationCount || 0) + 1\n    this.getInfo().validationCount = validationCount\n    const error = normalizeError(validate(value as never, this as never))\n    const errorMapKey = getErrorMapKey(cause)\n    if (this.state.meta.errorMap[errorMapKey] !== error) {\n      this.setMeta((prev) => ({\n        ...prev,\n        errorMap: {\n          ...prev.errorMap,\n          [getErrorMapKey(cause)]: error,\n        },\n      }))\n    }\n\n    // If a sync error is encountered for the errorMapKey (eg. onChange), cancel any async validation\n    if (this.state.meta.errorMap[errorMapKey]) {\n      this.cancelValidateAsync()\n    }\n  }\n\n  #leaseValidateAsync = () => {\n    const count = (this.getInfo().validationAsyncCount || 0) + 1\n    this.getInfo().validationAsyncCount = count\n    return count\n  }\n\n  cancelValidateAsync = () => {\n    // Lease a new validation count to ignore any pending validations\n    this.#leaseValidateAsync()\n    // Cancel any pending validation state\n    this.setMeta((prev) => ({\n      ...prev,\n      isValidating: false,\n    }))\n  }\n\n  validateAsync = async (value = this.state.value, cause: ValidationCause) => {\n    const {\n      onChangeAsync,\n      onBlurAsync,\n      onSubmitAsync,\n      asyncDebounceMs,\n      onBlurAsyncDebounceMs,\n      onChangeAsyncDebounceMs,\n    } = this.options\n\n    const validate =\n      cause === 'change'\n        ? onChangeAsync\n        : cause === 'submit'\n        ? onSubmitAsync\n        : onBlurAsync\n    if (!validate) return []\n    const debounceMs =\n      cause === 'submit'\n        ? 0\n        : (cause === 'change'\n            ? onChangeAsyncDebounceMs\n            : onBlurAsyncDebounceMs) ??\n          asyncDebounceMs ??\n          0\n\n    if (this.state.meta.isValidating !== true)\n      this.setMeta((prev) => ({ ...prev, isValidating: true }))\n\n    // Use the validationCount for all field instances to\n    // track freshness of the validation\n    const validationAsyncCount = this.#leaseValidateAsync()\n\n    const checkLatest = () =>\n      validationAsyncCount === this.getInfo().validationAsyncCount\n\n    if (!this.getInfo().validationPromise) {\n      this.getInfo().validationPromise = new Promise((resolve, reject) => {\n        this.getInfo().validationResolve = resolve\n        this.getInfo().validationReject = reject\n      })\n    }\n\n    if (debounceMs > 0) {\n      await new Promise((r) => setTimeout(r, debounceMs))\n    }\n\n    // Only kick off validation if this validation is the latest attempt\n    if (checkLatest()) {\n      const prevErrors = this.getMeta().errors\n      try {\n        const rawError = await validate(value as never, this as never)\n        if (checkLatest()) {\n          const error = normalizeError(rawError)\n          this.setMeta((prev) => ({\n            ...prev,\n            isValidating: false,\n            errorMap: {\n              ...prev.errorMap,\n              [getErrorMapKey(cause)]: error,\n            },\n          }))\n          this.getInfo().validationResolve?.([...prevErrors, error])\n        }\n      } catch (error) {\n        if (checkLatest()) {\n          this.getInfo().validationReject?.([...prevErrors, error])\n          throw error\n        }\n      } finally {\n        if (checkLatest()) {\n          this.setMeta((prev) => ({ ...prev, isValidating: false }))\n          delete this.getInfo().validationPromise\n        }\n      }\n    }\n\n    // Always return the latest validation promise to the caller\n    return this.getInfo().validationPromise ?? []\n  }\n\n  validate = (\n    cause: ValidationCause,\n    value?: TData,\n  ): ValidationError[] | Promise<ValidationError[]> => {\n    // If the field is pristine and validatePristine is false, do not validate\n    if (!this.state.meta.isTouched) return []\n    // Attempt to sync validate first\n    this.validateSync(value, cause)\n\n    const errorMapKey = getErrorMapKey(cause)\n    // If there is an error mapped to the errorMapKey (eg. onChange, onBlur, onSubmit), return the errors array, do not attempt async validation\n    if (this.getMeta().errorMap[errorMapKey]) {\n      if (!this.options.asyncAlways) {\n        return this.state.meta.errors\n      }\n    }\n    // No error? Attempt async validation\n    return this.validateAsync(value, cause)\n  }\n\n  handleChange = (updater: Updater<TData>) => {\n    this.setValue(updater, { touch: true })\n  }\n\n  handleBlur = () => {\n    const prevTouched = this.state.meta.isTouched\n    if (!prevTouched) {\n      this.setMeta((prev) => ({ ...prev, isTouched: true }))\n      this.validate('change')\n    }\n    this.validate('blur')\n  }\n}\n\nfunction normalizeError(rawError?: ValidationError) {\n  if (rawError) {\n    if (typeof rawError !== 'string') {\n      return 'Invalid Form Values'\n    }\n\n    return rawError\n  }\n\n  return undefined\n}\n\nfunction getErrorMapKey(cause: ValidationCause) {\n  switch (cause) {\n    case 'submit':\n      return 'onSubmit'\n    case 'change':\n      return 'onChange'\n    case 'blur':\n      return 'onBlur'\n    case 'mount':\n      return 'onMount'\n  }\n}\n"],"mappings":"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","names":[]}

package/build/modern/FieldApi.cjs

@@ -209,6 +209,9 @@ var FieldApi = class _FieldApi {
     this.form = opts.form;
     this.uid = uid++;
     this.name = opts.name;
+    if (opts.defaultValue !== void 0) {
+      this.form.setFieldValue(this.name, opts.defaultValue);
+    }
     this.store = new import_store.Store(
       {
         value: this.getValue(),

package/build/modern/FieldApi.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/FieldApi.ts"],"sourcesContent":["import { type DeepKeys, type DeepValue, type Updater } from './utils'\nimport type { FormApi, ValidationError, ValidationErrorMap } from './FormApi'\nimport { Store } from '@tanstack/store'\n\nexport type ValidationCause = 'change' | 'blur' | 'submit' | 'mount'\n\ntype ValidateFn<TParentData, TName extends DeepKeys<TParentData>, TData> = (\n  value: TData,\n  fieldApi: FieldApi<TParentData, TName>,\n) => ValidationError\n\ntype ValidateAsyncFn<\n  TParentData,\n  TName extends DeepKeys<TParentData>,\n  TData,\n> = (\n  value: TData,\n  fieldApi: FieldApi<TParentData, TName>,\n) => ValidationError | Promise<ValidationError>\n\nexport interface FieldOptions<\n  TParentData,\n  /**\n   * This allows us to restrict the name to only be a valid field name while\n   * also assigning it to a generic\n   */\n  TName extends DeepKeys<TParentData>,\n  /**\n   * If TData is unknown, we can use the TName generic to determine the type\n   */\n  TData = DeepValue<TParentData, TName>,\n> {\n  name: DeepKeys<TParentData>\n  index?: TData extends any[] ? number : never\n  defaultValue?: TData\n  asyncDebounceMs?: number\n  asyncAlways?: boolean\n  onMount?: (formApi: FieldApi<TParentData, TName>) => void\n  onChange?: ValidateFn<TParentData, TName, TData>\n  onChangeAsync?: ValidateAsyncFn<TParentData, TName, TData>\n  onChangeAsyncDebounceMs?: number\n  onBlur?: ValidateFn<TParentData, TName, TData>\n  onBlurAsync?: ValidateAsyncFn<TParentData, TName, TData>\n  onBlurAsyncDebounceMs?: number\n  onSubmitAsync?: ValidateAsyncFn<TParentData, TName, TData>\n  defaultMeta?: Partial<FieldMeta>\n}\n\nexport interface FieldApiOptions<\n  TParentData,\n  TName extends DeepKeys<TParentData>,\n  TData = DeepValue<TParentData, TName>,\n> extends FieldOptions<TParentData, TName, TData> {\n  form: FormApi<TParentData>\n}\n\nexport type FieldMeta = {\n  isTouched: boolean\n  touchedErrors: ValidationError[]\n  errors: ValidationError[]\n  errorMap: ValidationErrorMap\n  isValidating: boolean\n}\n\nlet uid = 0\n\nexport type FieldState<TData> = {\n  value: TData\n  meta: FieldMeta\n}\n\nexport type ResolveName<TParentData> = unknown extends TParentData\n  ? string\n  : DeepKeys<TParentData>\n\nexport class FieldApi<\n  TParentData,\n  TName extends DeepKeys<TParentData>,\n  TData = DeepValue<TParentData, TName>,\n> {\n  uid: number\n  form: FieldApiOptions<TParentData, TName, TData>['form']\n  name!: DeepKeys<TParentData>\n  options: FieldApiOptions<TParentData, TName> = {} as any\n  store!: Store<FieldState<TData>>\n  state!: FieldState<TData>\n  prevState!: FieldState<TData>\n\n  constructor(\n    opts: FieldApiOptions<TParentData, TName, TData> & {\n      form: FormApi<TParentData>\n    },\n  ) {\n    this.form = opts.form\n    this.uid = uid++\n    // Support field prefixing from FieldScope\n    // let fieldPrefix = ''\n    // if (this.form.fieldName) {\n    //   fieldPrefix = `${this.form.fieldName}.`\n    // }\n\n    this.name = opts.name as any\n\n    this.store = new Store<FieldState<TData>>(\n      {\n        value: this.getValue(),\n        // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition\n        meta: this._getMeta() ?? {\n          isValidating: false,\n          isTouched: false,\n          touchedErrors: [],\n          errors: [],\n          errorMap: {},\n          ...opts.defaultMeta,\n        },\n      },\n      {\n        onUpdate: () => {\n          const state = this.store.state\n\n          state.meta.errors = Object.values(state.meta.errorMap).filter(\n            (val: unknown) => val !== undefined,\n          )\n\n          state.meta.touchedErrors = state.meta.isTouched\n            ? state.meta.errors\n            : []\n\n          this.prevState = state\n          this.state = state\n        },\n      },\n    )\n\n    this.state = this.store.state\n    this.prevState = this.state\n    this.options = opts as never\n  }\n\n  mount = () => {\n    const info = this.getInfo()\n    info.instances[this.uid] = this as never\n\n    const unsubscribe = this.form.store.subscribe(() => {\n      this.store.batch(() => {\n        const nextValue = this.getValue()\n        const nextMeta = this.getMeta()\n\n        if (nextValue !== this.state.value) {\n          this.store.setState((prev) => ({ ...prev, value: nextValue }))\n        }\n\n        if (nextMeta !== this.state.meta) {\n          this.store.setState((prev) => ({ ...prev, meta: nextMeta }))\n        }\n      })\n    })\n\n    this.update(this.options as never)\n    this.options.onMount?.(this as never)\n\n    return () => {\n      unsubscribe()\n      delete info.instances[this.uid]\n      if (!Object.keys(info.instances).length) {\n        delete this.form.fieldInfo[this.name]\n      }\n    }\n  }\n\n  update = (opts: FieldApiOptions<TParentData, TName, TData>) => {\n    // Default Value\n    // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition\n    if (this.state.value === undefined) {\n      const formDefault =\n        opts.form.options.defaultValues?.[opts.name as keyof TParentData]\n\n      if (opts.defaultValue !== undefined) {\n        this.setValue(opts.defaultValue as never)\n      } else if (formDefault !== undefined) {\n        this.setValue(formDefault as never)\n      }\n    }\n\n    // Default Meta\n    if (this._getMeta() === undefined) {\n      this.setMeta(this.state.meta)\n    }\n\n    this.options = opts as never\n  }\n\n  getValue = (): TData => {\n    return this.form.getFieldValue(this.name) as any\n  }\n\n  setValue = (\n    updater: Updater<TData>,\n    options?: { touch?: boolean; notify?: boolean },\n  ) => {\n    this.form.setFieldValue(this.name, updater as never, options)\n    this.validate('change', this.state.value)\n  }\n\n  _getMeta = () => this.form.getFieldMeta(this.name)\n  getMeta = () =>\n    this._getMeta() ??\n    ({\n      isValidating: false,\n      isTouched: false,\n      touchedErrors: [],\n      errors: [],\n      errorMap: {},\n      ...this.options.defaultMeta,\n    } as FieldMeta)\n\n  setMeta = (updater: Updater<FieldMeta>) =>\n    this.form.setFieldMeta(this.name, updater)\n\n  getInfo = () => this.form.getFieldInfo(this.name)\n\n  pushValue = (value: TData extends any[] ? TData[number] : never) =>\n    this.form.pushFieldValue(this.name, value as any)\n\n  insertValue = (\n    index: number,\n    value: TData extends any[] ? TData[number] : never,\n  ) => this.form.insertFieldValue(this.name, index, value as any)\n\n  removeValue = (index: number) => this.form.removeFieldValue(this.name, index)\n\n  swapValues = (aIndex: number, bIndex: number) =>\n    this.form.swapFieldValues(this.name, aIndex, bIndex)\n\n  getSubField = <\n    TSubName extends DeepKeys<TData>,\n    TSubData = DeepValue<TData, TSubName>,\n  >(\n    name: TSubName,\n  ): FieldApi<TData, TSubName, TSubData> =>\n    new FieldApi({\n      name: `${this.name}.${name}` as never,\n      form: this.form,\n    }) as any\n\n  validateSync = (value = this.state.value, cause: ValidationCause) => {\n    const { onChange, onBlur } = this.options\n    const validate =\n      cause === 'submit' ? undefined : cause === 'change' ? onChange : onBlur\n    if (!validate) return\n\n    // Use the validationCount for all field instances to\n    // track freshness of the validation\n    const validationCount = (this.getInfo().validationCount || 0) + 1\n    this.getInfo().validationCount = validationCount\n    const error = normalizeError(validate(value as never, this as never))\n    const errorMapKey = getErrorMapKey(cause)\n    if (this.state.meta.errorMap[errorMapKey] !== error) {\n      this.setMeta((prev) => ({\n        ...prev,\n        errorMap: {\n          ...prev.errorMap,\n          [getErrorMapKey(cause)]: error,\n        },\n      }))\n    }\n\n    // If a sync error is encountered for the errorMapKey (eg. onChange), cancel any async validation\n    if (this.state.meta.errorMap[errorMapKey]) {\n      this.cancelValidateAsync()\n    }\n  }\n\n  #leaseValidateAsync = () => {\n    const count = (this.getInfo().validationAsyncCount || 0) + 1\n    this.getInfo().validationAsyncCount = count\n    return count\n  }\n\n  cancelValidateAsync = () => {\n    // Lease a new validation count to ignore any pending validations\n    this.#leaseValidateAsync()\n    // Cancel any pending validation state\n    this.setMeta((prev) => ({\n      ...prev,\n      isValidating: false,\n    }))\n  }\n\n  validateAsync = async (value = this.state.value, cause: ValidationCause) => {\n    const {\n      onChangeAsync,\n      onBlurAsync,\n      onSubmitAsync,\n      asyncDebounceMs,\n      onBlurAsyncDebounceMs,\n      onChangeAsyncDebounceMs,\n    } = this.options\n\n    const validate =\n      cause === 'change'\n        ? onChangeAsync\n        : cause === 'submit'\n        ? onSubmitAsync\n        : onBlurAsync\n    if (!validate) return []\n    const debounceMs =\n      cause === 'submit'\n        ? 0\n        : (cause === 'change'\n            ? onChangeAsyncDebounceMs\n            : onBlurAsyncDebounceMs) ??\n          asyncDebounceMs ??\n          0\n\n    if (this.state.meta.isValidating !== true)\n      this.setMeta((prev) => ({ ...prev, isValidating: true }))\n\n    // Use the validationCount for all field instances to\n    // track freshness of the validation\n    const validationAsyncCount = this.#leaseValidateAsync()\n\n    const checkLatest = () =>\n      validationAsyncCount === this.getInfo().validationAsyncCount\n\n    if (!this.getInfo().validationPromise) {\n      this.getInfo().validationPromise = new Promise((resolve, reject) => {\n        this.getInfo().validationResolve = resolve\n        this.getInfo().validationReject = reject\n      })\n    }\n\n    if (debounceMs > 0) {\n      await new Promise((r) => setTimeout(r, debounceMs))\n    }\n\n    // Only kick off validation if this validation is the latest attempt\n    if (checkLatest()) {\n      const prevErrors = this.getMeta().errors\n      try {\n        const rawError = await validate(value as never, this as never)\n        if (checkLatest()) {\n          const error = normalizeError(rawError)\n          this.setMeta((prev) => ({\n            ...prev,\n            isValidating: false,\n            errorMap: {\n              ...prev.errorMap,\n              [getErrorMapKey(cause)]: error,\n            },\n          }))\n          this.getInfo().validationResolve?.([...prevErrors, error])\n        }\n      } catch (error) {\n        if (checkLatest()) {\n          this.getInfo().validationReject?.([...prevErrors, error])\n          throw error\n        }\n      } finally {\n        if (checkLatest()) {\n          this.setMeta((prev) => ({ ...prev, isValidating: false }))\n          delete this.getInfo().validationPromise\n        }\n      }\n    }\n\n    // Always return the latest validation promise to the caller\n    return this.getInfo().validationPromise ?? []\n  }\n\n  validate = (\n    cause: ValidationCause,\n    value?: TData,\n  ): ValidationError[] | Promise<ValidationError[]> => {\n    // If the field is pristine and validatePristine is false, do not validate\n    if (!this.state.meta.isTouched) return []\n    // Attempt to sync validate first\n    this.validateSync(value, cause)\n\n    const errorMapKey = getErrorMapKey(cause)\n    // If there is an error mapped to the errorMapKey (eg. onChange, onBlur, onSubmit), return the errors array, do not attempt async validation\n    if (this.getMeta().errorMap[errorMapKey]) {\n      if (!this.options.asyncAlways) {\n        return this.state.meta.errors\n      }\n    }\n    // No error? Attempt async validation\n    return this.validateAsync(value, cause)\n  }\n\n  handleChange = (updater: Updater<TData>) => {\n    this.setValue(updater, { touch: true })\n  }\n\n  handleBlur = () => {\n    const prevTouched = this.state.meta.isTouched\n    if (!prevTouched) {\n      this.setMeta((prev) => ({ ...prev, isTouched: true }))\n      this.validate('change')\n    }\n    this.validate('blur')\n  }\n}\n\nfunction normalizeError(rawError?: ValidationError) {\n  if (rawError) {\n    if (typeof rawError !== 'string') {\n      return 'Invalid Form Values'\n    }\n\n    return rawError\n  }\n\n  return undefined\n}\n\nfunction getErrorMapKey(cause: ValidationCause) {\n  switch (cause) {\n    case 'submit':\n      return 'onSubmit'\n    case 'change':\n      return 'onChange'\n    case 'blur':\n      return 'onBlur'\n    case 'mount':\n      return 'onMount'\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAEA,mBAAsB;AA8DtB,IAAI,MAAM;AAWH,IAAM,WAAN,MAAM,UAIX;AAAA,EASA,YACE,MAGA;AATF,mBAA+C,CAAC;AAwDhD,iBAAQ,MAAM;AACZ,YAAM,OAAO,KAAK,QAAQ;AAC1B,WAAK,UAAU,KAAK,GAAG,IAAI;AAE3B,YAAM,cAAc,KAAK,KAAK,MAAM,UAAU,MAAM;AAClD,aAAK,MAAM,MAAM,MAAM;AACrB,gBAAM,YAAY,KAAK,SAAS;AAChC,gBAAM,WAAW,KAAK,QAAQ;AAE9B,cAAI,cAAc,KAAK,MAAM,OAAO;AAClC,iBAAK,MAAM,SAAS,CAAC,UAAU,EAAE,GAAG,MAAM,OAAO,UAAU,EAAE;AAAA,UAC/D;AAEA,cAAI,aAAa,KAAK,MAAM,MAAM;AAChC,iBAAK,MAAM,SAAS,CAAC,UAAU,EAAE,GAAG,MAAM,MAAM,SAAS,EAAE;AAAA,UAC7D;AAAA,QACF,CAAC;AAAA,MACH,CAAC;AAED,WAAK,OAAO,KAAK,OAAgB;AACjC,WAAK,QAAQ,UAAU,IAAa;AAEpC,aAAO,MAAM;AACX,oBAAY;AACZ,eAAO,KAAK,UAAU,KAAK,GAAG;AAC9B,YAAI,CAAC,OAAO,KAAK,KAAK,SAAS,EAAE,QAAQ;AACvC,iBAAO,KAAK,KAAK,UAAU,KAAK,IAAI;AAAA,QACtC;AAAA,MACF;AAAA,IACF;AAEA,kBAAS,CAAC,SAAqD;AAG7D,UAAI,KAAK,MAAM,UAAU,QAAW;AAClC,cAAM,cACJ,KAAK,KAAK,QAAQ,gBAAgB,KAAK,IAAyB;AAElE,YAAI,KAAK,iBAAiB,QAAW;AACnC,eAAK,SAAS,KAAK,YAAqB;AAAA,QAC1C,WAAW,gBAAgB,QAAW;AACpC,eAAK,SAAS,WAAoB;AAAA,QACpC;AAAA,MACF;AAGA,UAAI,KAAK,SAAS,MAAM,QAAW;AACjC,aAAK,QAAQ,KAAK,MAAM,IAAI;AAAA,MAC9B;AAEA,WAAK,UAAU;AAAA,IACjB;AAEA,oBAAW,MAAa;AACtB,aAAO,KAAK,KAAK,cAAc,KAAK,IAAI;AAAA,IAC1C;AAEA,oBAAW,CACT,SACA,YACG;AACH,WAAK,KAAK,cAAc,KAAK,MAAM,SAAkB,OAAO;AAC5D,WAAK,SAAS,UAAU,KAAK,MAAM,KAAK;AAAA,IAC1C;AAEA,oBAAW,MAAM,KAAK,KAAK,aAAa,KAAK,IAAI;AACjD,mBAAU,MACR,KAAK,SAAS,KACb;AAAA,MACC,cAAc;AAAA,MACd,WAAW;AAAA,MACX,eAAe,CAAC;AAAA,MAChB,QAAQ,CAAC;AAAA,MACT,UAAU,CAAC;AAAA,MACX,GAAG,KAAK,QAAQ;AAAA,IAClB;AAEF,mBAAU,CAAC,YACT,KAAK,KAAK,aAAa,KAAK,MAAM,OAAO;AAE3C,mBAAU,MAAM,KAAK,KAAK,aAAa,KAAK,IAAI;AAEhD,qBAAY,CAAC,UACX,KAAK,KAAK,eAAe,KAAK,MAAM,KAAY;AAElD,uBAAc,CACZ,OACA,UACG,KAAK,KAAK,iBAAiB,KAAK,MAAM,OAAO,KAAY;AAE9D,uBAAc,CAAC,UAAkB,KAAK,KAAK,iBAAiB,KAAK,MAAM,KAAK;AAE5E,sBAAa,CAAC,QAAgB,WAC5B,KAAK,KAAK,gBAAgB,KAAK,MAAM,QAAQ,MAAM;AAErD,uBAAc,CAIZ,SAEA,IAAI,UAAS;AAAA,MACX,MAAM,GAAG,KAAK,IAAI,IAAI,IAAI;AAAA,MAC1B,MAAM,KAAK;AAAA,IACb,CAAC;AAEH,wBAAe,CAAC,QAAQ,KAAK,MAAM,OAAO,UAA2B;AACnE,YAAM,EAAE,UAAU,OAAO,IAAI,KAAK;AAClC,YAAM,WACJ,UAAU,WAAW,SAAY,UAAU,WAAW,WAAW;AACnE,UAAI,CAAC;AAAU;AAIf,YAAM,mBAAmB,KAAK,QAAQ,EAAE,mBAAmB,KAAK;AAChE,WAAK,QAAQ,EAAE,kBAAkB;AACjC,YAAM,QAAQ,eAAe,SAAS,OAAgB,IAAa,CAAC;AACpE,YAAM,cAAc,eAAe,KAAK;AACxC,UAAI,KAAK,MAAM,KAAK,SAAS,WAAW,MAAM,OAAO;AACnD,aAAK,QAAQ,CAAC,UAAU;AAAA,UACtB,GAAG;AAAA,UACH,UAAU;AAAA,YACR,GAAG,KAAK;AAAA,YACR,CAAC,eAAe,KAAK,CAAC,GAAG;AAAA,UAC3B;AAAA,QACF,EAAE;AAAA,MACJ;AAGA,UAAI,KAAK,MAAM,KAAK,SAAS,WAAW,GAAG;AACzC,aAAK,oBAAoB;AAAA,MAC3B;AAAA,IACF;AAEA,+BAAsB,MAAM;AAC1B,YAAM,SAAS,KAAK,QAAQ,EAAE,wBAAwB,KAAK;AAC3D,WAAK,QAAQ,EAAE,uBAAuB;AACtC,aAAO;AAAA,IACT;AAEA,+BAAsB,MAAM;AAE1B,WAAK,oBAAoB;AAEzB,WAAK,QAAQ,CAAC,UAAU;AAAA,QACtB,GAAG;AAAA,QACH,cAAc;AAAA,MAChB,EAAE;AAAA,IACJ;AAEA,yBAAgB,OAAO,QAAQ,KAAK,MAAM,OAAO,UAA2B;AAC1E,YAAM;AAAA,QACJ;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,MACF,IAAI,KAAK;AAET,YAAM,WACJ,UAAU,WACN,gBACA,UAAU,WACV,gBACA;AACN,UAAI,CAAC;AAAU,eAAO,CAAC;AACvB,YAAM,aACJ,UAAU,WACN,KACC,UAAU,WACP,0BACA,0BACJ,mBACA;AAEN,UAAI,KAAK,MAAM,KAAK,iBAAiB;AACnC,aAAK,QAAQ,CAAC,UAAU,EAAE,GAAG,MAAM,cAAc,KAAK,EAAE;AAI1D,YAAM,uBAAuB,KAAK,oBAAoB;AAEtD,YAAM,cAAc,MAClB,yBAAyB,KAAK,QAAQ,EAAE;AAE1C,UAAI,CAAC,KAAK,QAAQ,EAAE,mBAAmB;AACrC,aAAK,QAAQ,EAAE,oBAAoB,IAAI,QAAQ,CAAC,SAAS,WAAW;AAClE,eAAK,QAAQ,EAAE,oBAAoB;AACnC,eAAK,QAAQ,EAAE,mBAAmB;AAAA,QACpC,CAAC;AAAA,MACH;AAEA,UAAI,aAAa,GAAG;AAClB,cAAM,IAAI,QAAQ,CAAC,MAAM,WAAW,GAAG,UAAU,CAAC;AAAA,MACpD;AAGA,UAAI,YAAY,GAAG;AACjB,cAAM,aAAa,KAAK,QAAQ,EAAE;AAClC,YAAI;AACF,gBAAM,WAAW,MAAM,SAAS,OAAgB,IAAa;AAC7D,cAAI,YAAY,GAAG;AACjB,kBAAM,QAAQ,eAAe,QAAQ;AACrC,iBAAK,QAAQ,CAAC,UAAU;AAAA,cACtB,GAAG;AAAA,cACH,cAAc;AAAA,cACd,UAAU;AAAA,gBACR,GAAG,KAAK;AAAA,gBACR,CAAC,eAAe,KAAK,CAAC,GAAG;AAAA,cAC3B;AAAA,YACF,EAAE;AACF,iBAAK,QAAQ,EAAE,oBAAoB,CAAC,GAAG,YAAY,KAAK,CAAC;AAAA,UAC3D;AAAA,QACF,SAAS,OAAO;AACd,cAAI,YAAY,GAAG;AACjB,iBAAK,QAAQ,EAAE,mBAAmB,CAAC,GAAG,YAAY,KAAK,CAAC;AACxD,kBAAM;AAAA,UACR;AAAA,QACF,UAAE;AACA,cAAI,YAAY,GAAG;AACjB,iBAAK,QAAQ,CAAC,UAAU,EAAE,GAAG,MAAM,cAAc,MAAM,EAAE;AACzD,mBAAO,KAAK,QAAQ,EAAE;AAAA,UACxB;AAAA,QACF;AAAA,MACF;AAGA,aAAO,KAAK,QAAQ,EAAE,qBAAqB,CAAC;AAAA,IAC9C;AAEA,oBAAW,CACT,OACA,UACmD;AAEnD,UAAI,CAAC,KAAK,MAAM,KAAK;AAAW,eAAO,CAAC;AAExC,WAAK,aAAa,OAAO,KAAK;AAE9B,YAAM,cAAc,eAAe,KAAK;AAExC,UAAI,KAAK,QAAQ,EAAE,SAAS,WAAW,GAAG;AACxC,YAAI,CAAC,KAAK,QAAQ,aAAa;AAC7B,iBAAO,KAAK,MAAM,KAAK;AAAA,QACzB;AAAA,MACF;AAEA,aAAO,KAAK,cAAc,OAAO,KAAK;AAAA,IACxC;AAEA,wBAAe,CAAC,YAA4B;AAC1C,WAAK,SAAS,SAAS,EAAE,OAAO,KAAK,CAAC;AAAA,IACxC;AAEA,sBAAa,MAAM;AACjB,YAAM,cAAc,KAAK,MAAM,KAAK;AACpC,UAAI,CAAC,aAAa;AAChB,aAAK,QAAQ,CAAC,UAAU,EAAE,GAAG,MAAM,WAAW,KAAK,EAAE;AACrD,aAAK,SAAS,QAAQ;AAAA,MACxB;AACA,WAAK,SAAS,MAAM;AAAA,IACtB;AApTE,SAAK,OAAO,KAAK;AACjB,SAAK,MAAM;AAOX,SAAK,OAAO,KAAK;AAEjB,SAAK,QAAQ,IAAI;AAAA,MACf;AAAA,QACE,OAAO,KAAK,SAAS;AAAA;AAAA,QAErB,MAAM,KAAK,SAAS,KAAK;AAAA,UACvB,cAAc;AAAA,UACd,WAAW;AAAA,UACX,eAAe,CAAC;AAAA,UAChB,QAAQ,CAAC;AAAA,UACT,UAAU,CAAC;AAAA,UACX,GAAG,KAAK;AAAA,QACV;AAAA,MACF;AAAA,MACA;AAAA,QACE,UAAU,MAAM;AACd,gBAAM,QAAQ,KAAK,MAAM;AAEzB,gBAAM,KAAK,SAAS,OAAO,OAAO,MAAM,KAAK,QAAQ,EAAE;AAAA,YACrD,CAAC,QAAiB,QAAQ;AAAA,UAC5B;AAEA,gBAAM,KAAK,gBAAgB,MAAM,KAAK,YAClC,MAAM,KAAK,SACX,CAAC;AAEL,eAAK,YAAY;AACjB,eAAK,QAAQ;AAAA,QACf;AAAA,MACF;AAAA,IACF;AAEA,SAAK,QAAQ,KAAK,MAAM;AACxB,SAAK,YAAY,KAAK;AACtB,SAAK,UAAU;AAAA,EACjB;AAAA,EAwIA;AAiIF;AAEA,SAAS,eAAe,UAA4B;AAClD,MAAI,UAAU;AACZ,QAAI,OAAO,aAAa,UAAU;AAChC,aAAO;AAAA,IACT;AAEA,WAAO;AAAA,EACT;AAEA,SAAO;AACT;AAEA,SAAS,eAAe,OAAwB;AAC9C,UAAQ,OAAO;AAAA,IACb,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,EACX;AACF;","names":[]}
+{"version":3,"sources":["../../src/FieldApi.ts"],"sourcesContent":["import { type DeepKeys, type DeepValue, type Updater } from './utils'\nimport type { FormApi, ValidationError, ValidationErrorMap } from './FormApi'\nimport { Store } from '@tanstack/store'\n\nexport type ValidationCause = 'change' | 'blur' | 'submit' | 'mount'\n\ntype ValidateFn<TParentData, TName extends DeepKeys<TParentData>, TData> = (\n  value: TData,\n  fieldApi: FieldApi<TParentData, TName>,\n) => ValidationError\n\ntype ValidateAsyncFn<\n  TParentData,\n  TName extends DeepKeys<TParentData>,\n  TData,\n> = (\n  value: TData,\n  fieldApi: FieldApi<TParentData, TName>,\n) => ValidationError | Promise<ValidationError>\n\nexport interface FieldOptions<\n  TParentData,\n  /**\n   * This allows us to restrict the name to only be a valid field name while\n   * also assigning it to a generic\n   */\n  TName extends DeepKeys<TParentData>,\n  /**\n   * If TData is unknown, we can use the TName generic to determine the type\n   */\n  TData = DeepValue<TParentData, TName>,\n> {\n  name: DeepKeys<TParentData>\n  index?: TData extends any[] ? number : never\n  defaultValue?: TData\n  asyncDebounceMs?: number\n  asyncAlways?: boolean\n  onMount?: (formApi: FieldApi<TParentData, TName>) => void\n  onChange?: ValidateFn<TParentData, TName, TData>\n  onChangeAsync?: ValidateAsyncFn<TParentData, TName, TData>\n  onChangeAsyncDebounceMs?: number\n  onBlur?: ValidateFn<TParentData, TName, TData>\n  onBlurAsync?: ValidateAsyncFn<TParentData, TName, TData>\n  onBlurAsyncDebounceMs?: number\n  onSubmitAsync?: ValidateAsyncFn<TParentData, TName, TData>\n  defaultMeta?: Partial<FieldMeta>\n}\n\nexport interface FieldApiOptions<\n  TParentData,\n  TName extends DeepKeys<TParentData>,\n  TData = DeepValue<TParentData, TName>,\n> extends FieldOptions<TParentData, TName, TData> {\n  form: FormApi<TParentData>\n}\n\nexport type FieldMeta = {\n  isTouched: boolean\n  touchedErrors: ValidationError[]\n  errors: ValidationError[]\n  errorMap: ValidationErrorMap\n  isValidating: boolean\n}\n\nlet uid = 0\n\nexport type FieldState<TData> = {\n  value: TData\n  meta: FieldMeta\n}\n\nexport type ResolveName<TParentData> = unknown extends TParentData\n  ? string\n  : DeepKeys<TParentData>\n\nexport class FieldApi<\n  TParentData,\n  TName extends DeepKeys<TParentData>,\n  TData = DeepValue<TParentData, TName>,\n> {\n  uid: number\n  form: FieldApiOptions<TParentData, TName, TData>['form']\n  name!: DeepKeys<TParentData>\n  options: FieldApiOptions<TParentData, TName> = {} as any\n  store!: Store<FieldState<TData>>\n  state!: FieldState<TData>\n  prevState!: FieldState<TData>\n\n  constructor(\n    opts: FieldApiOptions<TParentData, TName, TData> & {\n      form: FormApi<TParentData>\n    },\n  ) {\n    this.form = opts.form\n    this.uid = uid++\n    // Support field prefixing from FieldScope\n    // let fieldPrefix = ''\n    // if (this.form.fieldName) {\n    //   fieldPrefix = `${this.form.fieldName}.`\n    // }\n\n    this.name = opts.name as any\n\n    if (opts.defaultValue !== undefined) {\n      this.form.setFieldValue(this.name, opts.defaultValue as never)\n    }\n\n    this.store = new Store<FieldState<TData>>(\n      {\n        value: this.getValue(),\n        // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition\n        meta: this._getMeta() ?? {\n          isValidating: false,\n          isTouched: false,\n          touchedErrors: [],\n          errors: [],\n          errorMap: {},\n          ...opts.defaultMeta,\n        },\n      },\n      {\n        onUpdate: () => {\n          const state = this.store.state\n\n          state.meta.errors = Object.values(state.meta.errorMap).filter(\n            (val: unknown) => val !== undefined,\n          )\n\n          state.meta.touchedErrors = state.meta.isTouched\n            ? state.meta.errors\n            : []\n\n          this.prevState = state\n          this.state = state\n        },\n      },\n    )\n\n    this.state = this.store.state\n    this.prevState = this.state\n    this.options = opts as never\n  }\n\n  mount = () => {\n    const info = this.getInfo()\n    info.instances[this.uid] = this as never\n\n    const unsubscribe = this.form.store.subscribe(() => {\n      this.store.batch(() => {\n        const nextValue = this.getValue()\n        const nextMeta = this.getMeta()\n\n        if (nextValue !== this.state.value) {\n          this.store.setState((prev) => ({ ...prev, value: nextValue }))\n        }\n\n        if (nextMeta !== this.state.meta) {\n          this.store.setState((prev) => ({ ...prev, meta: nextMeta }))\n        }\n      })\n    })\n\n    this.update(this.options as never)\n    this.options.onMount?.(this as never)\n\n    return () => {\n      unsubscribe()\n      delete info.instances[this.uid]\n      if (!Object.keys(info.instances).length) {\n        delete this.form.fieldInfo[this.name]\n      }\n    }\n  }\n\n  update = (opts: FieldApiOptions<TParentData, TName, TData>) => {\n    // Default Value\n    // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition\n    if (this.state.value === undefined) {\n      const formDefault =\n        opts.form.options.defaultValues?.[opts.name as keyof TParentData]\n\n      if (opts.defaultValue !== undefined) {\n        this.setValue(opts.defaultValue as never)\n      } else if (formDefault !== undefined) {\n        this.setValue(formDefault as never)\n      }\n    }\n\n    // Default Meta\n    if (this._getMeta() === undefined) {\n      this.setMeta(this.state.meta)\n    }\n\n    this.options = opts as never\n  }\n\n  getValue = (): TData => {\n    return this.form.getFieldValue(this.name) as any\n  }\n\n  setValue = (\n    updater: Updater<TData>,\n    options?: { touch?: boolean; notify?: boolean },\n  ) => {\n    this.form.setFieldValue(this.name, updater as never, options)\n    this.validate('change', this.state.value)\n  }\n\n  _getMeta = () => this.form.getFieldMeta(this.name)\n  getMeta = () =>\n    this._getMeta() ??\n    ({\n      isValidating: false,\n      isTouched: false,\n      touchedErrors: [],\n      errors: [],\n      errorMap: {},\n      ...this.options.defaultMeta,\n    } as FieldMeta)\n\n  setMeta = (updater: Updater<FieldMeta>) =>\n    this.form.setFieldMeta(this.name, updater)\n\n  getInfo = () => this.form.getFieldInfo(this.name)\n\n  pushValue = (value: TData extends any[] ? TData[number] : never) =>\n    this.form.pushFieldValue(this.name, value as any)\n\n  insertValue = (\n    index: number,\n    value: TData extends any[] ? TData[number] : never,\n  ) => this.form.insertFieldValue(this.name, index, value as any)\n\n  removeValue = (index: number) => this.form.removeFieldValue(this.name, index)\n\n  swapValues = (aIndex: number, bIndex: number) =>\n    this.form.swapFieldValues(this.name, aIndex, bIndex)\n\n  getSubField = <\n    TSubName extends DeepKeys<TData>,\n    TSubData = DeepValue<TData, TSubName>,\n  >(\n    name: TSubName,\n  ): FieldApi<TData, TSubName, TSubData> =>\n    new FieldApi({\n      name: `${this.name}.${name}` as never,\n      form: this.form,\n    }) as any\n\n  validateSync = (value = this.state.value, cause: ValidationCause) => {\n    const { onChange, onBlur } = this.options\n    const validate =\n      cause === 'submit' ? undefined : cause === 'change' ? onChange : onBlur\n    if (!validate) return\n\n    // Use the validationCount for all field instances to\n    // track freshness of the validation\n    const validationCount = (this.getInfo().validationCount || 0) + 1\n    this.getInfo().validationCount = validationCount\n    const error = normalizeError(validate(value as never, this as never))\n    const errorMapKey = getErrorMapKey(cause)\n    if (this.state.meta.errorMap[errorMapKey] !== error) {\n      this.setMeta((prev) => ({\n        ...prev,\n        errorMap: {\n          ...prev.errorMap,\n          [getErrorMapKey(cause)]: error,\n        },\n      }))\n    }\n\n    // If a sync error is encountered for the errorMapKey (eg. onChange), cancel any async validation\n    if (this.state.meta.errorMap[errorMapKey]) {\n      this.cancelValidateAsync()\n    }\n  }\n\n  #leaseValidateAsync = () => {\n    const count = (this.getInfo().validationAsyncCount || 0) + 1\n    this.getInfo().validationAsyncCount = count\n    return count\n  }\n\n  cancelValidateAsync = () => {\n    // Lease a new validation count to ignore any pending validations\n    this.#leaseValidateAsync()\n    // Cancel any pending validation state\n    this.setMeta((prev) => ({\n      ...prev,\n      isValidating: false,\n    }))\n  }\n\n  validateAsync = async (value = this.state.value, cause: ValidationCause) => {\n    const {\n      onChangeAsync,\n      onBlurAsync,\n      onSubmitAsync,\n      asyncDebounceMs,\n      onBlurAsyncDebounceMs,\n      onChangeAsyncDebounceMs,\n    } = this.options\n\n    const validate =\n      cause === 'change'\n        ? onChangeAsync\n        : cause === 'submit'\n        ? onSubmitAsync\n        : onBlurAsync\n    if (!validate) return []\n    const debounceMs =\n      cause === 'submit'\n        ? 0\n        : (cause === 'change'\n            ? onChangeAsyncDebounceMs\n            : onBlurAsyncDebounceMs) ??\n          asyncDebounceMs ??\n          0\n\n    if (this.state.meta.isValidating !== true)\n      this.setMeta((prev) => ({ ...prev, isValidating: true }))\n\n    // Use the validationCount for all field instances to\n    // track freshness of the validation\n    const validationAsyncCount = this.#leaseValidateAsync()\n\n    const checkLatest = () =>\n      validationAsyncCount === this.getInfo().validationAsyncCount\n\n    if (!this.getInfo().validationPromise) {\n      this.getInfo().validationPromise = new Promise((resolve, reject) => {\n        this.getInfo().validationResolve = resolve\n        this.getInfo().validationReject = reject\n      })\n    }\n\n    if (debounceMs > 0) {\n      await new Promise((r) => setTimeout(r, debounceMs))\n    }\n\n    // Only kick off validation if this validation is the latest attempt\n    if (checkLatest()) {\n      const prevErrors = this.getMeta().errors\n      try {\n        const rawError = await validate(value as never, this as never)\n        if (checkLatest()) {\n          const error = normalizeError(rawError)\n          this.setMeta((prev) => ({\n            ...prev,\n            isValidating: false,\n            errorMap: {\n              ...prev.errorMap,\n              [getErrorMapKey(cause)]: error,\n            },\n          }))\n          this.getInfo().validationResolve?.([...prevErrors, error])\n        }\n      } catch (error) {\n        if (checkLatest()) {\n          this.getInfo().validationReject?.([...prevErrors, error])\n          throw error\n        }\n      } finally {\n        if (checkLatest()) {\n          this.setMeta((prev) => ({ ...prev, isValidating: false }))\n          delete this.getInfo().validationPromise\n        }\n      }\n    }\n\n    // Always return the latest validation promise to the caller\n    return this.getInfo().validationPromise ?? []\n  }\n\n  validate = (\n    cause: ValidationCause,\n    value?: TData,\n  ): ValidationError[] | Promise<ValidationError[]> => {\n    // If the field is pristine and validatePristine is false, do not validate\n    if (!this.state.meta.isTouched) return []\n    // Attempt to sync validate first\n    this.validateSync(value, cause)\n\n    const errorMapKey = getErrorMapKey(cause)\n    // If there is an error mapped to the errorMapKey (eg. onChange, onBlur, onSubmit), return the errors array, do not attempt async validation\n    if (this.getMeta().errorMap[errorMapKey]) {\n      if (!this.options.asyncAlways) {\n        return this.state.meta.errors\n      }\n    }\n    // No error? Attempt async validation\n    return this.validateAsync(value, cause)\n  }\n\n  handleChange = (updater: Updater<TData>) => {\n    this.setValue(updater, { touch: true })\n  }\n\n  handleBlur = () => {\n    const prevTouched = this.state.meta.isTouched\n    if (!prevTouched) {\n      this.setMeta((prev) => ({ ...prev, isTouched: true }))\n      this.validate('change')\n    }\n    this.validate('blur')\n  }\n}\n\nfunction normalizeError(rawError?: ValidationError) {\n  if (rawError) {\n    if (typeof rawError !== 'string') {\n      return 'Invalid Form Values'\n    }\n\n    return rawError\n  }\n\n  return undefined\n}\n\nfunction getErrorMapKey(cause: ValidationCause) {\n  switch (cause) {\n    case 'submit':\n      return 'onSubmit'\n    case 'change':\n      return 'onChange'\n    case 'blur':\n      return 'onBlur'\n    case 'mount':\n      return 'onMount'\n  }\n}\n"],"mappings":"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","names":[]}

package/build/modern/FieldApi.js

@@ -185,6 +185,9 @@ var FieldApi = class _FieldApi {
     this.form = opts.form;
     this.uid = uid++;
     this.name = opts.name;
+    if (opts.defaultValue !== void 0) {
+      this.form.setFieldValue(this.name, opts.defaultValue);
+    }
     this.store = new Store(
       {
         value: this.getValue(),

package/build/modern/FieldApi.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/FieldApi.ts"],"sourcesContent":["import { type DeepKeys, type DeepValue, type Updater } from './utils'\nimport type { FormApi, ValidationError, ValidationErrorMap } from './FormApi'\nimport { Store } from '@tanstack/store'\n\nexport type ValidationCause = 'change' | 'blur' | 'submit' | 'mount'\n\ntype ValidateFn<TParentData, TName extends DeepKeys<TParentData>, TData> = (\n  value: TData,\n  fieldApi: FieldApi<TParentData, TName>,\n) => ValidationError\n\ntype ValidateAsyncFn<\n  TParentData,\n  TName extends DeepKeys<TParentData>,\n  TData,\n> = (\n  value: TData,\n  fieldApi: FieldApi<TParentData, TName>,\n) => ValidationError | Promise<ValidationError>\n\nexport interface FieldOptions<\n  TParentData,\n  /**\n   * This allows us to restrict the name to only be a valid field name while\n   * also assigning it to a generic\n   */\n  TName extends DeepKeys<TParentData>,\n  /**\n   * If TData is unknown, we can use the TName generic to determine the type\n   */\n  TData = DeepValue<TParentData, TName>,\n> {\n  name: DeepKeys<TParentData>\n  index?: TData extends any[] ? number : never\n  defaultValue?: TData\n  asyncDebounceMs?: number\n  asyncAlways?: boolean\n  onMount?: (formApi: FieldApi<TParentData, TName>) => void\n  onChange?: ValidateFn<TParentData, TName, TData>\n  onChangeAsync?: ValidateAsyncFn<TParentData, TName, TData>\n  onChangeAsyncDebounceMs?: number\n  onBlur?: ValidateFn<TParentData, TName, TData>\n  onBlurAsync?: ValidateAsyncFn<TParentData, TName, TData>\n  onBlurAsyncDebounceMs?: number\n  onSubmitAsync?: ValidateAsyncFn<TParentData, TName, TData>\n  defaultMeta?: Partial<FieldMeta>\n}\n\nexport interface FieldApiOptions<\n  TParentData,\n  TName extends DeepKeys<TParentData>,\n  TData = DeepValue<TParentData, TName>,\n> extends FieldOptions<TParentData, TName, TData> {\n  form: FormApi<TParentData>\n}\n\nexport type FieldMeta = {\n  isTouched: boolean\n  touchedErrors: ValidationError[]\n  errors: ValidationError[]\n  errorMap: ValidationErrorMap\n  isValidating: boolean\n}\n\nlet uid = 0\n\nexport type FieldState<TData> = {\n  value: TData\n  meta: FieldMeta\n}\n\nexport type ResolveName<TParentData> = unknown extends TParentData\n  ? string\n  : DeepKeys<TParentData>\n\nexport class FieldApi<\n  TParentData,\n  TName extends DeepKeys<TParentData>,\n  TData = DeepValue<TParentData, TName>,\n> {\n  uid: number\n  form: FieldApiOptions<TParentData, TName, TData>['form']\n  name!: DeepKeys<TParentData>\n  options: FieldApiOptions<TParentData, TName> = {} as any\n  store!: Store<FieldState<TData>>\n  state!: FieldState<TData>\n  prevState!: FieldState<TData>\n\n  constructor(\n    opts: FieldApiOptions<TParentData, TName, TData> & {\n      form: FormApi<TParentData>\n    },\n  ) {\n    this.form = opts.form\n    this.uid = uid++\n    // Support field prefixing from FieldScope\n    // let fieldPrefix = ''\n    // if (this.form.fieldName) {\n    //   fieldPrefix = `${this.form.fieldName}.`\n    // }\n\n    this.name = opts.name as any\n\n    this.store = new Store<FieldState<TData>>(\n      {\n        value: this.getValue(),\n        // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition\n        meta: this._getMeta() ?? {\n          isValidating: false,\n          isTouched: false,\n          touchedErrors: [],\n          errors: [],\n          errorMap: {},\n          ...opts.defaultMeta,\n        },\n      },\n      {\n        onUpdate: () => {\n          const state = this.store.state\n\n          state.meta.errors = Object.values(state.meta.errorMap).filter(\n            (val: unknown) => val !== undefined,\n          )\n\n          state.meta.touchedErrors = state.meta.isTouched\n            ? state.meta.errors\n            : []\n\n          this.prevState = state\n          this.state = state\n        },\n      },\n    )\n\n    this.state = this.store.state\n    this.prevState = this.state\n    this.options = opts as never\n  }\n\n  mount = () => {\n    const info = this.getInfo()\n    info.instances[this.uid] = this as never\n\n    const unsubscribe = this.form.store.subscribe(() => {\n      this.store.batch(() => {\n        const nextValue = this.getValue()\n        const nextMeta = this.getMeta()\n\n        if (nextValue !== this.state.value) {\n          this.store.setState((prev) => ({ ...prev, value: nextValue }))\n        }\n\n        if (nextMeta !== this.state.meta) {\n          this.store.setState((prev) => ({ ...prev, meta: nextMeta }))\n        }\n      })\n    })\n\n    this.update(this.options as never)\n    this.options.onMount?.(this as never)\n\n    return () => {\n      unsubscribe()\n      delete info.instances[this.uid]\n      if (!Object.keys(info.instances).length) {\n        delete this.form.fieldInfo[this.name]\n      }\n    }\n  }\n\n  update = (opts: FieldApiOptions<TParentData, TName, TData>) => {\n    // Default Value\n    // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition\n    if (this.state.value === undefined) {\n      const formDefault =\n        opts.form.options.defaultValues?.[opts.name as keyof TParentData]\n\n      if (opts.defaultValue !== undefined) {\n        this.setValue(opts.defaultValue as never)\n      } else if (formDefault !== undefined) {\n        this.setValue(formDefault as never)\n      }\n    }\n\n    // Default Meta\n    if (this._getMeta() === undefined) {\n      this.setMeta(this.state.meta)\n    }\n\n    this.options = opts as never\n  }\n\n  getValue = (): TData => {\n    return this.form.getFieldValue(this.name) as any\n  }\n\n  setValue = (\n    updater: Updater<TData>,\n    options?: { touch?: boolean; notify?: boolean },\n  ) => {\n    this.form.setFieldValue(this.name, updater as never, options)\n    this.validate('change', this.state.value)\n  }\n\n  _getMeta = () => this.form.getFieldMeta(this.name)\n  getMeta = () =>\n    this._getMeta() ??\n    ({\n      isValidating: false,\n      isTouched: false,\n      touchedErrors: [],\n      errors: [],\n      errorMap: {},\n      ...this.options.defaultMeta,\n    } as FieldMeta)\n\n  setMeta = (updater: Updater<FieldMeta>) =>\n    this.form.setFieldMeta(this.name, updater)\n\n  getInfo = () => this.form.getFieldInfo(this.name)\n\n  pushValue = (value: TData extends any[] ? TData[number] : never) =>\n    this.form.pushFieldValue(this.name, value as any)\n\n  insertValue = (\n    index: number,\n    value: TData extends any[] ? TData[number] : never,\n  ) => this.form.insertFieldValue(this.name, index, value as any)\n\n  removeValue = (index: number) => this.form.removeFieldValue(this.name, index)\n\n  swapValues = (aIndex: number, bIndex: number) =>\n    this.form.swapFieldValues(this.name, aIndex, bIndex)\n\n  getSubField = <\n    TSubName extends DeepKeys<TData>,\n    TSubData = DeepValue<TData, TSubName>,\n  >(\n    name: TSubName,\n  ): FieldApi<TData, TSubName, TSubData> =>\n    new FieldApi({\n      name: `${this.name}.${name}` as never,\n      form: this.form,\n    }) as any\n\n  validateSync = (value = this.state.value, cause: ValidationCause) => {\n    const { onChange, onBlur } = this.options\n    const validate =\n      cause === 'submit' ? undefined : cause === 'change' ? onChange : onBlur\n    if (!validate) return\n\n    // Use the validationCount for all field instances to\n    // track freshness of the validation\n    const validationCount = (this.getInfo().validationCount || 0) + 1\n    this.getInfo().validationCount = validationCount\n    const error = normalizeError(validate(value as never, this as never))\n    const errorMapKey = getErrorMapKey(cause)\n    if (this.state.meta.errorMap[errorMapKey] !== error) {\n      this.setMeta((prev) => ({\n        ...prev,\n        errorMap: {\n          ...prev.errorMap,\n          [getErrorMapKey(cause)]: error,\n        },\n      }))\n    }\n\n    // If a sync error is encountered for the errorMapKey (eg. onChange), cancel any async validation\n    if (this.state.meta.errorMap[errorMapKey]) {\n      this.cancelValidateAsync()\n    }\n  }\n\n  #leaseValidateAsync = () => {\n    const count = (this.getInfo().validationAsyncCount || 0) + 1\n    this.getInfo().validationAsyncCount = count\n    return count\n  }\n\n  cancelValidateAsync = () => {\n    // Lease a new validation count to ignore any pending validations\n    this.#leaseValidateAsync()\n    // Cancel any pending validation state\n    this.setMeta((prev) => ({\n      ...prev,\n      isValidating: false,\n    }))\n  }\n\n  validateAsync = async (value = this.state.value, cause: ValidationCause) => {\n    const {\n      onChangeAsync,\n      onBlurAsync,\n      onSubmitAsync,\n      asyncDebounceMs,\n      onBlurAsyncDebounceMs,\n      onChangeAsyncDebounceMs,\n    } = this.options\n\n    const validate =\n      cause === 'change'\n        ? onChangeAsync\n        : cause === 'submit'\n        ? onSubmitAsync\n        : onBlurAsync\n    if (!validate) return []\n    const debounceMs =\n      cause === 'submit'\n        ? 0\n        : (cause === 'change'\n            ? onChangeAsyncDebounceMs\n            : onBlurAsyncDebounceMs) ??\n          asyncDebounceMs ??\n          0\n\n    if (this.state.meta.isValidating !== true)\n      this.setMeta((prev) => ({ ...prev, isValidating: true }))\n\n    // Use the validationCount for all field instances to\n    // track freshness of the validation\n    const validationAsyncCount = this.#leaseValidateAsync()\n\n    const checkLatest = () =>\n      validationAsyncCount === this.getInfo().validationAsyncCount\n\n    if (!this.getInfo().validationPromise) {\n      this.getInfo().validationPromise = new Promise((resolve, reject) => {\n        this.getInfo().validationResolve = resolve\n        this.getInfo().validationReject = reject\n      })\n    }\n\n    if (debounceMs > 0) {\n      await new Promise((r) => setTimeout(r, debounceMs))\n    }\n\n    // Only kick off validation if this validation is the latest attempt\n    if (checkLatest()) {\n      const prevErrors = this.getMeta().errors\n      try {\n        const rawError = await validate(value as never, this as never)\n        if (checkLatest()) {\n          const error = normalizeError(rawError)\n          this.setMeta((prev) => ({\n            ...prev,\n            isValidating: false,\n            errorMap: {\n              ...prev.errorMap,\n              [getErrorMapKey(cause)]: error,\n            },\n          }))\n          this.getInfo().validationResolve?.([...prevErrors, error])\n        }\n      } catch (error) {\n        if (checkLatest()) {\n          this.getInfo().validationReject?.([...prevErrors, error])\n          throw error\n        }\n      } finally {\n        if (checkLatest()) {\n          this.setMeta((prev) => ({ ...prev, isValidating: false }))\n          delete this.getInfo().validationPromise\n        }\n      }\n    }\n\n    // Always return the latest validation promise to the caller\n    return this.getInfo().validationPromise ?? []\n  }\n\n  validate = (\n    cause: ValidationCause,\n    value?: TData,\n  ): ValidationError[] | Promise<ValidationError[]> => {\n    // If the field is pristine and validatePristine is false, do not validate\n    if (!this.state.meta.isTouched) return []\n    // Attempt to sync validate first\n    this.validateSync(value, cause)\n\n    const errorMapKey = getErrorMapKey(cause)\n    // If there is an error mapped to the errorMapKey (eg. onChange, onBlur, onSubmit), return the errors array, do not attempt async validation\n    if (this.getMeta().errorMap[errorMapKey]) {\n      if (!this.options.asyncAlways) {\n        return this.state.meta.errors\n      }\n    }\n    // No error? Attempt async validation\n    return this.validateAsync(value, cause)\n  }\n\n  handleChange = (updater: Updater<TData>) => {\n    this.setValue(updater, { touch: true })\n  }\n\n  handleBlur = () => {\n    const prevTouched = this.state.meta.isTouched\n    if (!prevTouched) {\n      this.setMeta((prev) => ({ ...prev, isTouched: true }))\n      this.validate('change')\n    }\n    this.validate('blur')\n  }\n}\n\nfunction normalizeError(rawError?: ValidationError) {\n  if (rawError) {\n    if (typeof rawError !== 'string') {\n      return 'Invalid Form Values'\n    }\n\n    return rawError\n  }\n\n  return undefined\n}\n\nfunction getErrorMapKey(cause: ValidationCause) {\n  switch (cause) {\n    case 'submit':\n      return 'onSubmit'\n    case 'change':\n      return 'onChange'\n    case 'blur':\n      return 'onBlur'\n    case 'mount':\n      return 'onMount'\n  }\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/FieldApi.ts"],"sourcesContent":["import { type DeepKeys, type DeepValue, type Updater } from './utils'\nimport type { FormApi, ValidationError, ValidationErrorMap } from './FormApi'\nimport { Store } from '@tanstack/store'\n\nexport type ValidationCause = 'change' | 'blur' | 'submit' | 'mount'\n\ntype ValidateFn<TParentData, TName extends DeepKeys<TParentData>, TData> = (\n  value: TData,\n  fieldApi: FieldApi<TParentData, TName>,\n) => ValidationError\n\ntype ValidateAsyncFn<\n  TParentData,\n  TName extends DeepKeys<TParentData>,\n  TData,\n> = (\n  value: TData,\n  fieldApi: FieldApi<TParentData, TName>,\n) => ValidationError | Promise<ValidationError>\n\nexport interface FieldOptions<\n  TParentData,\n  /**\n   * This allows us to restrict the name to only be a valid field name while\n   * also assigning it to a generic\n   */\n  TName extends DeepKeys<TParentData>,\n  /**\n   * If TData is unknown, we can use the TName generic to determine the type\n   */\n  TData = DeepValue<TParentData, TName>,\n> {\n  name: DeepKeys<TParentData>\n  index?: TData extends any[] ? number : never\n  defaultValue?: TData\n  asyncDebounceMs?: number\n  asyncAlways?: boolean\n  onMount?: (formApi: FieldApi<TParentData, TName>) => void\n  onChange?: ValidateFn<TParentData, TName, TData>\n  onChangeAsync?: ValidateAsyncFn<TParentData, TName, TData>\n  onChangeAsyncDebounceMs?: number\n  onBlur?: ValidateFn<TParentData, TName, TData>\n  onBlurAsync?: ValidateAsyncFn<TParentData, TName, TData>\n  onBlurAsyncDebounceMs?: number\n  onSubmitAsync?: ValidateAsyncFn<TParentData, TName, TData>\n  defaultMeta?: Partial<FieldMeta>\n}\n\nexport interface FieldApiOptions<\n  TParentData,\n  TName extends DeepKeys<TParentData>,\n  TData = DeepValue<TParentData, TName>,\n> extends FieldOptions<TParentData, TName, TData> {\n  form: FormApi<TParentData>\n}\n\nexport type FieldMeta = {\n  isTouched: boolean\n  touchedErrors: ValidationError[]\n  errors: ValidationError[]\n  errorMap: ValidationErrorMap\n  isValidating: boolean\n}\n\nlet uid = 0\n\nexport type FieldState<TData> = {\n  value: TData\n  meta: FieldMeta\n}\n\nexport type ResolveName<TParentData> = unknown extends TParentData\n  ? string\n  : DeepKeys<TParentData>\n\nexport class FieldApi<\n  TParentData,\n  TName extends DeepKeys<TParentData>,\n  TData = DeepValue<TParentData, TName>,\n> {\n  uid: number\n  form: FieldApiOptions<TParentData, TName, TData>['form']\n  name!: DeepKeys<TParentData>\n  options: FieldApiOptions<TParentData, TName> = {} as any\n  store!: Store<FieldState<TData>>\n  state!: FieldState<TData>\n  prevState!: FieldState<TData>\n\n  constructor(\n    opts: FieldApiOptions<TParentData, TName, TData> & {\n      form: FormApi<TParentData>\n    },\n  ) {\n    this.form = opts.form\n    this.uid = uid++\n    // Support field prefixing from FieldScope\n    // let fieldPrefix = ''\n    // if (this.form.fieldName) {\n    //   fieldPrefix = `${this.form.fieldName}.`\n    // }\n\n    this.name = opts.name as any\n\n    if (opts.defaultValue !== undefined) {\n      this.form.setFieldValue(this.name, opts.defaultValue as never)\n    }\n\n    this.store = new Store<FieldState<TData>>(\n      {\n        value: this.getValue(),\n        // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition\n        meta: this._getMeta() ?? {\n          isValidating: false,\n          isTouched: false,\n          touchedErrors: [],\n          errors: [],\n          errorMap: {},\n          ...opts.defaultMeta,\n        },\n      },\n      {\n        onUpdate: () => {\n          const state = this.store.state\n\n          state.meta.errors = Object.values(state.meta.errorMap).filter(\n            (val: unknown) => val !== undefined,\n          )\n\n          state.meta.touchedErrors = state.meta.isTouched\n            ? state.meta.errors\n            : []\n\n          this.prevState = state\n          this.state = state\n        },\n      },\n    )\n\n    this.state = this.store.state\n    this.prevState = this.state\n    this.options = opts as never\n  }\n\n  mount = () => {\n    const info = this.getInfo()\n    info.instances[this.uid] = this as never\n\n    const unsubscribe = this.form.store.subscribe(() => {\n      this.store.batch(() => {\n        const nextValue = this.getValue()\n        const nextMeta = this.getMeta()\n\n        if (nextValue !== this.state.value) {\n          this.store.setState((prev) => ({ ...prev, value: nextValue }))\n        }\n\n        if (nextMeta !== this.state.meta) {\n          this.store.setState((prev) => ({ ...prev, meta: nextMeta }))\n        }\n      })\n    })\n\n    this.update(this.options as never)\n    this.options.onMount?.(this as never)\n\n    return () => {\n      unsubscribe()\n      delete info.instances[this.uid]\n      if (!Object.keys(info.instances).length) {\n        delete this.form.fieldInfo[this.name]\n      }\n    }\n  }\n\n  update = (opts: FieldApiOptions<TParentData, TName, TData>) => {\n    // Default Value\n    // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition\n    if (this.state.value === undefined) {\n      const formDefault =\n        opts.form.options.defaultValues?.[opts.name as keyof TParentData]\n\n      if (opts.defaultValue !== undefined) {\n        this.setValue(opts.defaultValue as never)\n      } else if (formDefault !== undefined) {\n        this.setValue(formDefault as never)\n      }\n    }\n\n    // Default Meta\n    if (this._getMeta() === undefined) {\n      this.setMeta(this.state.meta)\n    }\n\n    this.options = opts as never\n  }\n\n  getValue = (): TData => {\n    return this.form.getFieldValue(this.name) as any\n  }\n\n  setValue = (\n    updater: Updater<TData>,\n    options?: { touch?: boolean; notify?: boolean },\n  ) => {\n    this.form.setFieldValue(this.name, updater as never, options)\n    this.validate('change', this.state.value)\n  }\n\n  _getMeta = () => this.form.getFieldMeta(this.name)\n  getMeta = () =>\n    this._getMeta() ??\n    ({\n      isValidating: false,\n      isTouched: false,\n      touchedErrors: [],\n      errors: [],\n      errorMap: {},\n      ...this.options.defaultMeta,\n    } as FieldMeta)\n\n  setMeta = (updater: Updater<FieldMeta>) =>\n    this.form.setFieldMeta(this.name, updater)\n\n  getInfo = () => this.form.getFieldInfo(this.name)\n\n  pushValue = (value: TData extends any[] ? TData[number] : never) =>\n    this.form.pushFieldValue(this.name, value as any)\n\n  insertValue = (\n    index: number,\n    value: TData extends any[] ? TData[number] : never,\n  ) => this.form.insertFieldValue(this.name, index, value as any)\n\n  removeValue = (index: number) => this.form.removeFieldValue(this.name, index)\n\n  swapValues = (aIndex: number, bIndex: number) =>\n    this.form.swapFieldValues(this.name, aIndex, bIndex)\n\n  getSubField = <\n    TSubName extends DeepKeys<TData>,\n    TSubData = DeepValue<TData, TSubName>,\n  >(\n    name: TSubName,\n  ): FieldApi<TData, TSubName, TSubData> =>\n    new FieldApi({\n      name: `${this.name}.${name}` as never,\n      form: this.form,\n    }) as any\n\n  validateSync = (value = this.state.value, cause: ValidationCause) => {\n    const { onChange, onBlur } = this.options\n    const validate =\n      cause === 'submit' ? undefined : cause === 'change' ? onChange : onBlur\n    if (!validate) return\n\n    // Use the validationCount for all field instances to\n    // track freshness of the validation\n    const validationCount = (this.getInfo().validationCount || 0) + 1\n    this.getInfo().validationCount = validationCount\n    const error = normalizeError(validate(value as never, this as never))\n    const errorMapKey = getErrorMapKey(cause)\n    if (this.state.meta.errorMap[errorMapKey] !== error) {\n      this.setMeta((prev) => ({\n        ...prev,\n        errorMap: {\n          ...prev.errorMap,\n          [getErrorMapKey(cause)]: error,\n        },\n      }))\n    }\n\n    // If a sync error is encountered for the errorMapKey (eg. onChange), cancel any async validation\n    if (this.state.meta.errorMap[errorMapKey]) {\n      this.cancelValidateAsync()\n    }\n  }\n\n  #leaseValidateAsync = () => {\n    const count = (this.getInfo().validationAsyncCount || 0) + 1\n    this.getInfo().validationAsyncCount = count\n    return count\n  }\n\n  cancelValidateAsync = () => {\n    // Lease a new validation count to ignore any pending validations\n    this.#leaseValidateAsync()\n    // Cancel any pending validation state\n    this.setMeta((prev) => ({\n      ...prev,\n      isValidating: false,\n    }))\n  }\n\n  validateAsync = async (value = this.state.value, cause: ValidationCause) => {\n    const {\n      onChangeAsync,\n      onBlurAsync,\n      onSubmitAsync,\n      asyncDebounceMs,\n      onBlurAsyncDebounceMs,\n      onChangeAsyncDebounceMs,\n    } = this.options\n\n    const validate =\n      cause === 'change'\n        ? onChangeAsync\n        : cause === 'submit'\n        ? onSubmitAsync\n        : onBlurAsync\n    if (!validate) return []\n    const debounceMs =\n      cause === 'submit'\n        ? 0\n        : (cause === 'change'\n            ? onChangeAsyncDebounceMs\n            : onBlurAsyncDebounceMs) ??\n          asyncDebounceMs ??\n          0\n\n    if (this.state.meta.isValidating !== true)\n      this.setMeta((prev) => ({ ...prev, isValidating: true }))\n\n    // Use the validationCount for all field instances to\n    // track freshness of the validation\n    const validationAsyncCount = this.#leaseValidateAsync()\n\n    const checkLatest = () =>\n      validationAsyncCount === this.getInfo().validationAsyncCount\n\n    if (!this.getInfo().validationPromise) {\n      this.getInfo().validationPromise = new Promise((resolve, reject) => {\n        this.getInfo().validationResolve = resolve\n        this.getInfo().validationReject = reject\n      })\n    }\n\n    if (debounceMs > 0) {\n      await new Promise((r) => setTimeout(r, debounceMs))\n    }\n\n    // Only kick off validation if this validation is the latest attempt\n    if (checkLatest()) {\n      const prevErrors = this.getMeta().errors\n      try {\n        const rawError = await validate(value as never, this as never)\n        if (checkLatest()) {\n          const error = normalizeError(rawError)\n          this.setMeta((prev) => ({\n            ...prev,\n            isValidating: false,\n            errorMap: {\n              ...prev.errorMap,\n              [getErrorMapKey(cause)]: error,\n            },\n          }))\n          this.getInfo().validationResolve?.([...prevErrors, error])\n        }\n      } catch (error) {\n        if (checkLatest()) {\n          this.getInfo().validationReject?.([...prevErrors, error])\n          throw error\n        }\n      } finally {\n        if (checkLatest()) {\n          this.setMeta((prev) => ({ ...prev, isValidating: false }))\n          delete this.getInfo().validationPromise\n        }\n      }\n    }\n\n    // Always return the latest validation promise to the caller\n    return this.getInfo().validationPromise ?? []\n  }\n\n  validate = (\n    cause: ValidationCause,\n    value?: TData,\n  ): ValidationError[] | Promise<ValidationError[]> => {\n    // If the field is pristine and validatePristine is false, do not validate\n    if (!this.state.meta.isTouched) return []\n    // Attempt to sync validate first\n    this.validateSync(value, cause)\n\n    const errorMapKey = getErrorMapKey(cause)\n    // If there is an error mapped to the errorMapKey (eg. onChange, onBlur, onSubmit), return the errors array, do not attempt async validation\n    if (this.getMeta().errorMap[errorMapKey]) {\n      if (!this.options.asyncAlways) {\n        return this.state.meta.errors\n      }\n    }\n    // No error? Attempt async validation\n    return this.validateAsync(value, cause)\n  }\n\n  handleChange = (updater: Updater<TData>) => {\n    this.setValue(updater, { touch: true })\n  }\n\n  handleBlur = () => {\n    const prevTouched = this.state.meta.isTouched\n    if (!prevTouched) {\n      this.setMeta((prev) => ({ ...prev, isTouched: true }))\n      this.validate('change')\n    }\n    this.validate('blur')\n  }\n}\n\nfunction normalizeError(rawError?: ValidationError) {\n  if (rawError) {\n    if (typeof rawError !== 'string') {\n      return 'Invalid Form Values'\n    }\n\n    return rawError\n  }\n\n  return undefined\n}\n\nfunction getErrorMapKey(cause: ValidationCause) {\n  switch (cause) {\n    case 'submit':\n      return 'onSubmit'\n    case 'change':\n      return 'onChange'\n    case 'blur':\n      return 'onBlur'\n    case 'mount':\n      return 'onMount'\n  }\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/form-core",
-  "version": "0.3.6",
+  "version": "0.3.7",
   "description": "Powerful, type-safe, framework agnostic forms.",
   "author": "tannerlinsley",
   "license": "MIT",

package/src/FieldApi.ts

@@ -101,6 +101,10 @@ export class FieldApi<
 
     this.name = opts.name as any
 
+    if (opts.defaultValue !== undefined) {
+      this.form.setFieldValue(this.name, opts.defaultValue as never)
+    }
+
     this.store = new Store<FieldState<TData>>(
       {
         value: this.getValue(),

package/src/tests/FieldApi.spec.ts

@@ -20,6 +20,22 @@ describe('field api', () => {
     expect(field.getValue()).toBe('test')
   })
 
+  it('should use field default value first', () => {
+    const form = new FormApi({
+      defaultValues: {
+        name: 'test',
+      },
+    })
+
+    const field = new FieldApi({
+      form,
+      defaultValue: 'other',
+      name: 'name',
+    })
+
+    expect(field.getValue()).toBe('other')
+  })
+
   it('should get default meta', () => {
     const form = new FormApi()
     const field = new FieldApi({