@tanstack/form-core 0.3.2 → 0.3.3

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<TData, TFormData> = (\n  value: TData,\n  fieldApi: FieldApi<TData, TFormData>,\n) => ValidationError\n\ntype ValidateAsyncFn<TData, TFormData> = (\n  value: TData,\n  fieldApi: FieldApi<TData, TFormData>,\n) => ValidationError | Promise<ValidationError>\n\nexport interface FieldOptions<\n  _TData,\n  TFormData,\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 = unknown extends TFormData ? string : DeepKeys<TFormData>,\n  /**\n   * If TData is unknown, we can use the TName generic to determine the type\n   */\n  TData = unknown extends _TData ? DeepValue<TFormData, TName> : _TData,\n> {\n  name: TName\n  index?: TData extends any[] ? number : never\n  defaultValue?: TData\n  asyncDebounceMs?: number\n  asyncAlways?: boolean\n  onMount?: (formApi: FieldApi<TData, TFormData>) => void\n  onChange?: ValidateFn<TData, TFormData>\n  onChangeAsync?: ValidateAsyncFn<TData, TFormData>\n  onChangeAsyncDebounceMs?: number\n  onBlur?: ValidateFn<TData, TFormData>\n  onBlurAsync?: ValidateAsyncFn<TData, TFormData>\n  onBlurAsyncDebounceMs?: number\n  onSubmitAsync?: ValidateAsyncFn<TData, TFormData>\n  defaultMeta?: Partial<FieldMeta>\n}\n\nexport type FieldApiOptions<TData, TFormData> = FieldOptions<\n  TData,\n  TFormData\n> & {\n  form: FormApi<TFormData>\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\n/**\n * TData may not be known at the time of FieldApi construction, so we need to\n * use a conditional type to determine if TData is known or not.\n *\n * If TData is not known, we use the TFormData type to determine the type of\n * the field value based on the field name.\n */\ntype GetTData<Name, TData, TFormData> = unknown extends TData\n  ? DeepValue<TFormData, Name>\n  : TData\n\nexport class FieldApi<TData, TFormData> {\n  uid: number\n  form: FormApi<TFormData>\n  name!: DeepKeys<TFormData>\n  /**\n   * This is a hack that allows us to use `GetTData` without calling it everywhere\n   *\n   * Unfortunately this hack appears to be needed alongside the `TName` hack\n   * further up in this file. This properly types all of the internal methods,\n   * while the `TName` hack types the options properly\n   */\n  _tdata!: GetTData<typeof this.name, TData, TFormData>\n  store!: Store<FieldState<typeof this._tdata>>\n  state!: FieldState<typeof this._tdata>\n  prevState!: FieldState<typeof this._tdata>\n  options: FieldOptions<typeof this._tdata, TFormData> = {} as any\n\n  constructor(opts: FieldApiOptions<TData, TFormData>) {\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<typeof this._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.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\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<typeof this._tdata, TFormData>) => {\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 TFormData]\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 = (): typeof this._tdata => {\n    return this.form.getFieldValue(this.name)\n  }\n\n  setValue = (\n    updater: Updater<typeof this._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 = (\n    value: typeof this._tdata extends any[]\n      ? (typeof this._tdata)[number]\n      : never,\n  ) => this.form.pushFieldValue(this.name, value as any)\n\n  insertValue = (\n    index: number,\n    value: typeof this._tdata extends any[]\n      ? (typeof this._tdata)[number]\n      : 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 = <TName extends DeepKeys<typeof this._tdata>>(name: TName) =>\n    new FieldApi<DeepValue<typeof this._tdata, TName>, TFormData>({\n      name: `${this.name}.${name}` as never,\n      form: this.form,\n    })\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 (error && this.state.meta.errorMap[errorMapKey] !== error) {\n      this.setMeta((prev) => ({\n        ...prev,\n        errors: [...prev.errors, error],\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            errors: [...prev.errors, error],\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?: typeof this._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<typeof this._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<TData, TFormData> = (\n  value: TData,\n  fieldApi: FieldApi<TData, TFormData>,\n) => ValidationError\n\ntype ValidateAsyncFn<TData, TFormData> = (\n  value: TData,\n  fieldApi: FieldApi<TData, TFormData>,\n) => ValidationError | Promise<ValidationError>\n\nexport interface FieldOptions<\n  _TData,\n  TFormData,\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 = unknown extends TFormData ? string : DeepKeys<TFormData>,\n  /**\n   * If TData is unknown, we can use the TName generic to determine the type\n   */\n  TData = unknown extends _TData ? DeepValue<TFormData, TName> : _TData,\n> {\n  name: TName\n  index?: TData extends any[] ? number : never\n  defaultValue?: TData\n  asyncDebounceMs?: number\n  asyncAlways?: boolean\n  onMount?: (formApi: FieldApi<TData, TFormData>) => void\n  onChange?: ValidateFn<TData, TFormData>\n  onChangeAsync?: ValidateAsyncFn<TData, TFormData>\n  onChangeAsyncDebounceMs?: number\n  onBlur?: ValidateFn<TData, TFormData>\n  onBlurAsync?: ValidateAsyncFn<TData, TFormData>\n  onBlurAsyncDebounceMs?: number\n  onSubmitAsync?: ValidateAsyncFn<TData, TFormData>\n  defaultMeta?: Partial<FieldMeta>\n}\n\nexport interface FieldApiOptions<\n  _TData,\n  TFormData,\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 = unknown extends TFormData ? string : DeepKeys<TFormData>,\n  /**\n   * If TData is unknown, we can use the TName generic to determine the type\n   */\n  TData = unknown extends _TData ? DeepValue<TFormData, TName> : _TData,\n> extends FieldOptions<_TData, TFormData, TName, TData> {\n  form: FormApi<TFormData>\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\ntype GetTData<\n  TData,\n  TFormData,\n  Opts extends FieldApiOptions<TData, TFormData>,\n> = Opts extends FieldApiOptions<\n  infer _TData,\n  infer _TFormData,\n  infer _TName,\n  infer RealTData\n>\n  ? RealTData\n  : never\n\nexport class FieldApi<\n  _TData,\n  TFormData,\n  Opts extends FieldApiOptions<_TData, TFormData> = FieldApiOptions<\n    _TData,\n    TFormData\n  >,\n  TData extends GetTData<_TData, TFormData, Opts> = GetTData<\n    _TData,\n    TFormData,\n    Opts\n  >,\n> {\n  uid: number\n  form: Opts['form']\n  name!: DeepKeys<TFormData>\n  options: Opts = {} as any\n  store!: Store<FieldState<TData>>\n  state!: FieldState<TData>\n  prevState!: FieldState<TData>\n\n  constructor(\n    opts: Opts & {\n      form: FormApi<TFormData>\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.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<TData, TFormData>) => {\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 TFormData]\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)\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 = <TName extends DeepKeys<TData>>(name: TName) =>\n    new FieldApi<DeepValue<TData, TName>, TFormData>({\n      name: `${this.name}.${name}` as never,\n      form: this.form,\n    })\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 (error && this.state.meta.errorMap[errorMapKey] !== error) {\n      this.setMeta((prev) => ({\n        ...prev,\n        errors: [...prev.errors, error],\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            errors: [...prev.errors, error],\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.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<TData, TFormData> = (\n  value: TData,\n  fieldApi: FieldApi<TData, TFormData>,\n) => ValidationError\n\ntype ValidateAsyncFn<TData, TFormData> = (\n  value: TData,\n  fieldApi: FieldApi<TData, TFormData>,\n) => ValidationError | Promise<ValidationError>\n\nexport interface FieldOptions<\n  _TData,\n  TFormData,\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 = unknown extends TFormData ? string : DeepKeys<TFormData>,\n  /**\n   * If TData is unknown, we can use the TName generic to determine the type\n   */\n  TData = unknown extends _TData ? DeepValue<TFormData, TName> : _TData,\n> {\n  name: TName\n  index?: TData extends any[] ? number : never\n  defaultValue?: TData\n  asyncDebounceMs?: number\n  asyncAlways?: boolean\n  onMount?: (formApi: FieldApi<TData, TFormData>) => void\n  onChange?: ValidateFn<TData, TFormData>\n  onChangeAsync?: ValidateAsyncFn<TData, TFormData>\n  onChangeAsyncDebounceMs?: number\n  onBlur?: ValidateFn<TData, TFormData>\n  onBlurAsync?: ValidateAsyncFn<TData, TFormData>\n  onBlurAsyncDebounceMs?: number\n  onSubmitAsync?: ValidateAsyncFn<TData, TFormData>\n  defaultMeta?: Partial<FieldMeta>\n}\n\nexport type FieldApiOptions<TData, TFormData> = FieldOptions<\n  TData,\n  TFormData\n> & {\n  form: FormApi<TFormData>\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\n/**\n * TData may not be known at the time of FieldApi construction, so we need to\n * use a conditional type to determine if TData is known or not.\n *\n * If TData is not known, we use the TFormData type to determine the type of\n * the field value based on the field name.\n */\ntype GetTData<Name, TData, TFormData> = unknown extends TData\n  ? DeepValue<TFormData, Name>\n  : TData\n\nexport class FieldApi<TData, TFormData> {\n  uid: number\n  form: FormApi<TFormData>\n  name!: DeepKeys<TFormData>\n  /**\n   * This is a hack that allows us to use `GetTData` without calling it everywhere\n   *\n   * Unfortunately this hack appears to be needed alongside the `TName` hack\n   * further up in this file. This properly types all of the internal methods,\n   * while the `TName` hack types the options properly\n   */\n  _tdata!: GetTData<typeof this.name, TData, TFormData>\n  store!: Store<FieldState<typeof this._tdata>>\n  state!: FieldState<typeof this._tdata>\n  prevState!: FieldState<typeof this._tdata>\n  options: FieldOptions<typeof this._tdata, TFormData> = {} as any\n\n  constructor(opts: FieldApiOptions<TData, TFormData>) {\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<typeof this._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.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\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<typeof this._tdata, TFormData>) => {\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 TFormData]\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 = (): typeof this._tdata => {\n    return this.form.getFieldValue(this.name)\n  }\n\n  setValue = (\n    updater: Updater<typeof this._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 = (\n    value: typeof this._tdata extends any[]\n      ? (typeof this._tdata)[number]\n      : never,\n  ) => this.form.pushFieldValue(this.name, value as any)\n\n  insertValue = (\n    index: number,\n    value: typeof this._tdata extends any[]\n      ? (typeof this._tdata)[number]\n      : 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 = <TName extends DeepKeys<typeof this._tdata>>(name: TName) =>\n    new FieldApi<DeepValue<typeof this._tdata, TName>, TFormData>({\n      name: `${this.name}.${name}` as never,\n      form: this.form,\n    })\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 (error && this.state.meta.errorMap[errorMapKey] !== error) {\n      this.setMeta((prev) => ({\n        ...prev,\n        errors: [...prev.errors, error],\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            errors: [...prev.errors, error],\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?: typeof this._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<typeof this._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<TData, TFormData> = (\n  value: TData,\n  fieldApi: FieldApi<TData, TFormData>,\n) => ValidationError\n\ntype ValidateAsyncFn<TData, TFormData> = (\n  value: TData,\n  fieldApi: FieldApi<TData, TFormData>,\n) => ValidationError | Promise<ValidationError>\n\nexport interface FieldOptions<\n  _TData,\n  TFormData,\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 = unknown extends TFormData ? string : DeepKeys<TFormData>,\n  /**\n   * If TData is unknown, we can use the TName generic to determine the type\n   */\n  TData = unknown extends _TData ? DeepValue<TFormData, TName> : _TData,\n> {\n  name: TName\n  index?: TData extends any[] ? number : never\n  defaultValue?: TData\n  asyncDebounceMs?: number\n  asyncAlways?: boolean\n  onMount?: (formApi: FieldApi<TData, TFormData>) => void\n  onChange?: ValidateFn<TData, TFormData>\n  onChangeAsync?: ValidateAsyncFn<TData, TFormData>\n  onChangeAsyncDebounceMs?: number\n  onBlur?: ValidateFn<TData, TFormData>\n  onBlurAsync?: ValidateAsyncFn<TData, TFormData>\n  onBlurAsyncDebounceMs?: number\n  onSubmitAsync?: ValidateAsyncFn<TData, TFormData>\n  defaultMeta?: Partial<FieldMeta>\n}\n\nexport interface FieldApiOptions<\n  _TData,\n  TFormData,\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 = unknown extends TFormData ? string : DeepKeys<TFormData>,\n  /**\n   * If TData is unknown, we can use the TName generic to determine the type\n   */\n  TData = unknown extends _TData ? DeepValue<TFormData, TName> : _TData,\n> extends FieldOptions<_TData, TFormData, TName, TData> {\n  form: FormApi<TFormData>\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\ntype GetTData<\n  TData,\n  TFormData,\n  Opts extends FieldApiOptions<TData, TFormData>,\n> = Opts extends FieldApiOptions<\n  infer _TData,\n  infer _TFormData,\n  infer _TName,\n  infer RealTData\n>\n  ? RealTData\n  : never\n\nexport class FieldApi<\n  _TData,\n  TFormData,\n  Opts extends FieldApiOptions<_TData, TFormData> = FieldApiOptions<\n    _TData,\n    TFormData\n  >,\n  TData extends GetTData<_TData, TFormData, Opts> = GetTData<\n    _TData,\n    TFormData,\n    Opts\n  >,\n> {\n  uid: number\n  form: Opts['form']\n  name!: DeepKeys<TFormData>\n  options: Opts = {} as any\n  store!: Store<FieldState<TData>>\n  state!: FieldState<TData>\n  prevState!: FieldState<TData>\n\n  constructor(\n    opts: Opts & {\n      form: FormApi<TFormData>\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.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<TData, TFormData>) => {\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 TFormData]\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)\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 = <TName extends DeepKeys<TData>>(name: TName) =>\n    new FieldApi<DeepValue<TData, TName>, TFormData>({\n      name: `${this.name}.${name}` as never,\n      form: this.form,\n    })\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 (error && this.state.meta.errorMap[errorMapKey] !== error) {\n      this.setMeta((prev) => ({\n        ...prev,\n        errors: [...prev.errors, error],\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            errors: [...prev.errors, error],\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/index.d.cts

@@ -109,9 +109,18 @@ TData = unknown extends _TData ? DeepValue<TFormData, TName> : _TData> {
     onSubmitAsync?: ValidateAsyncFn<TData, TFormData>;
     defaultMeta?: Partial<FieldMeta>;
 }
-type FieldApiOptions<TData, TFormData> = FieldOptions<TData, TFormData> & {
+interface FieldApiOptions<_TData, TFormData, 
+/**
+ * This allows us to restrict the name to only be a valid field name while
+ * also assigning it to a generic
+ */
+TName = unknown extends TFormData ? string : DeepKeys<TFormData>, 
+/**
+ * If TData is unknown, we can use the TName generic to determine the type
+ */
+TData = unknown extends _TData ? DeepValue<TFormData, TName> : _TData> extends FieldOptions<_TData, TFormData, TName, TData> {
     form: FormApi<TFormData>;
-};
+}
 type FieldMeta = {
     isTouched: boolean;
     touchedErrors: ValidationError[];
@@ -123,36 +132,23 @@ type FieldState<TData> = {
     value: TData;
     meta: FieldMeta;
 };
-/**
- * TData may not be known at the time of FieldApi construction, so we need to
- * use a conditional type to determine if TData is known or not.
- *
- * If TData is not known, we use the TFormData type to determine the type of
- * the field value based on the field name.
- */
-type GetTData<Name, TData, TFormData> = unknown extends TData ? DeepValue<TFormData, Name> : TData;
-declare class FieldApi<TData, TFormData> {
+type GetTData<TData, TFormData, Opts extends FieldApiOptions<TData, TFormData>> = Opts extends FieldApiOptions<infer _TData, infer _TFormData, infer _TName, infer RealTData> ? RealTData : never;
+declare class FieldApi<_TData, TFormData, Opts extends FieldApiOptions<_TData, TFormData> = FieldApiOptions<_TData, TFormData>, TData extends GetTData<_TData, TFormData, Opts> = GetTData<_TData, TFormData, Opts>> {
     #private;
     uid: number;
-    form: FormApi<TFormData>;
+    form: Opts['form'];
     name: DeepKeys<TFormData>;
-    /**
-     * This is a hack that allows us to use `GetTData` without calling it everywhere
-     *
-     * Unfortunately this hack appears to be needed alongside the `TName` hack
-     * further up in this file. This properly types all of the internal methods,
-     * while the `TName` hack types the options properly
-     */
-    _tdata: GetTData<typeof this$1.name, TData, TFormData>;
-    store: Store<FieldState<typeof this$1._tdata>>;
-    state: FieldState<typeof this$1._tdata>;
-    prevState: FieldState<typeof this$1._tdata>;
-    options: FieldOptions<typeof this$1._tdata, TFormData>;
-    constructor(opts: FieldApiOptions<TData, TFormData>);
+    options: Opts;
+    store: Store<FieldState<TData>>;
+    state: FieldState<TData>;
+    prevState: FieldState<TData>;
+    constructor(opts: Opts & {
+        form: FormApi<TFormData>;
+    });
     mount: () => () => void;
-    update: (opts: FieldApiOptions<typeof this$1._tdata, TFormData>) => void;
-    getValue: () => typeof this$1._tdata;
-    setValue: (updater: Updater<typeof this$1._tdata>, options?: {
+    update: (opts: FieldApiOptions<TData, TFormData>) => void;
+    getValue: () => TData;
+    setValue: (updater: Updater<TData>, options?: {
         touch?: boolean;
         notify?: boolean;
     }) => void;
@@ -160,16 +156,16 @@ declare class FieldApi<TData, TFormData> {
     getMeta: () => FieldMeta;
     setMeta: (updater: Updater<FieldMeta>) => void;
     getInfo: () => Record<DeepKeys<TFormData>, FieldInfo<TFormData>>[DeepKeys<TFormData>];
-    pushValue: (value: typeof this$1._tdata extends any[] ? (typeof this$1._tdata)[number] : never) => void;
-    insertValue: (index: number, value: typeof this$1._tdata extends any[] ? (typeof this$1._tdata)[number] : never) => void;
+    pushValue: (value: TData extends any[] ? TData[number] : never) => void;
+    insertValue: (index: number, value: TData extends any[] ? TData[number] : never) => void;
     removeValue: (index: number) => void;
     swapValues: (aIndex: number, bIndex: number) => void;
-    getSubField: <TName extends DeepKeys<GetTData<DeepKeys<TFormData>, TData, TFormData>>>(name: TName) => FieldApi<DeepValue<GetTData<DeepKeys<TFormData>, TData, TFormData>, TName>, TFormData>;
-    validateSync: (value: GetTData<DeepKeys<TFormData>, TData, TFormData> | undefined, cause: ValidationCause) => void;
+    getSubField: <TName extends DeepKeys<TData>>(name: TName) => FieldApi<DeepValue<TData, TName>, TFormData, FieldApiOptions<DeepValue<TData, TName>, TFormData, unknown extends TFormData ? string : DeepKeys<TFormData>, unknown extends DeepValue<TData, TName> ? DeepValue<TFormData, unknown extends TFormData ? string : DeepKeys<TFormData>> : DeepValue<TData, TName>>, unknown extends DeepValue<TData, TName> ? DeepValue<TFormData, unknown extends TFormData ? string : DeepKeys<TFormData>> : DeepValue<TData, TName>>;
+    validateSync: (value: TData | undefined, cause: ValidationCause) => void;
     cancelValidateAsync: () => void;
-    validateAsync: (value: GetTData<DeepKeys<TFormData>, TData, TFormData> | undefined, cause: ValidationCause) => Promise<ValidationError[]>;
-    validate: (cause: ValidationCause, value?: typeof this$1._tdata) => ValidationError[] | Promise<ValidationError[]>;
-    handleChange: (updater: Updater<typeof this$1._tdata>) => void;
+    validateAsync: (value: TData | undefined, cause: ValidationCause) => Promise<ValidationError[]>;
+    validate: (cause: ValidationCause, value?: TData) => ValidationError[] | Promise<ValidationError[]>;
+    handleChange: (updater: Updater<TData>) => void;
     handleBlur: () => void;
 }
 

package/build/legacy/index.d.ts

@@ -109,9 +109,18 @@ TData = unknown extends _TData ? DeepValue<TFormData, TName> : _TData> {
     onSubmitAsync?: ValidateAsyncFn<TData, TFormData>;
     defaultMeta?: Partial<FieldMeta>;
 }
-type FieldApiOptions<TData, TFormData> = FieldOptions<TData, TFormData> & {
+interface FieldApiOptions<_TData, TFormData, 
+/**
+ * This allows us to restrict the name to only be a valid field name while
+ * also assigning it to a generic
+ */
+TName = unknown extends TFormData ? string : DeepKeys<TFormData>, 
+/**
+ * If TData is unknown, we can use the TName generic to determine the type
+ */
+TData = unknown extends _TData ? DeepValue<TFormData, TName> : _TData> extends FieldOptions<_TData, TFormData, TName, TData> {
     form: FormApi<TFormData>;
-};
+}
 type FieldMeta = {
     isTouched: boolean;
     touchedErrors: ValidationError[];
@@ -123,36 +132,23 @@ type FieldState<TData> = {
     value: TData;
     meta: FieldMeta;
 };
-/**
- * TData may not be known at the time of FieldApi construction, so we need to
- * use a conditional type to determine if TData is known or not.
- *
- * If TData is not known, we use the TFormData type to determine the type of
- * the field value based on the field name.
- */
-type GetTData<Name, TData, TFormData> = unknown extends TData ? DeepValue<TFormData, Name> : TData;
-declare class FieldApi<TData, TFormData> {
+type GetTData<TData, TFormData, Opts extends FieldApiOptions<TData, TFormData>> = Opts extends FieldApiOptions<infer _TData, infer _TFormData, infer _TName, infer RealTData> ? RealTData : never;
+declare class FieldApi<_TData, TFormData, Opts extends FieldApiOptions<_TData, TFormData> = FieldApiOptions<_TData, TFormData>, TData extends GetTData<_TData, TFormData, Opts> = GetTData<_TData, TFormData, Opts>> {
     #private;
     uid: number;
-    form: FormApi<TFormData>;
+    form: Opts['form'];
     name: DeepKeys<TFormData>;
-    /**
-     * This is a hack that allows us to use `GetTData` without calling it everywhere
-     *
-     * Unfortunately this hack appears to be needed alongside the `TName` hack
-     * further up in this file. This properly types all of the internal methods,
-     * while the `TName` hack types the options properly
-     */
-    _tdata: GetTData<typeof this$1.name, TData, TFormData>;
-    store: Store<FieldState<typeof this$1._tdata>>;
-    state: FieldState<typeof this$1._tdata>;
-    prevState: FieldState<typeof this$1._tdata>;
-    options: FieldOptions<typeof this$1._tdata, TFormData>;
-    constructor(opts: FieldApiOptions<TData, TFormData>);
+    options: Opts;
+    store: Store<FieldState<TData>>;
+    state: FieldState<TData>;
+    prevState: FieldState<TData>;
+    constructor(opts: Opts & {
+        form: FormApi<TFormData>;
+    });
     mount: () => () => void;
-    update: (opts: FieldApiOptions<typeof this$1._tdata, TFormData>) => void;
-    getValue: () => typeof this$1._tdata;
-    setValue: (updater: Updater<typeof this$1._tdata>, options?: {
+    update: (opts: FieldApiOptions<TData, TFormData>) => void;
+    getValue: () => TData;
+    setValue: (updater: Updater<TData>, options?: {
         touch?: boolean;
         notify?: boolean;
     }) => void;
@@ -160,16 +156,16 @@ declare class FieldApi<TData, TFormData> {
     getMeta: () => FieldMeta;
     setMeta: (updater: Updater<FieldMeta>) => void;
     getInfo: () => Record<DeepKeys<TFormData>, FieldInfo<TFormData>>[DeepKeys<TFormData>];
-    pushValue: (value: typeof this$1._tdata extends any[] ? (typeof this$1._tdata)[number] : never) => void;
-    insertValue: (index: number, value: typeof this$1._tdata extends any[] ? (typeof this$1._tdata)[number] : never) => void;
+    pushValue: (value: TData extends any[] ? TData[number] : never) => void;
+    insertValue: (index: number, value: TData extends any[] ? TData[number] : never) => void;
     removeValue: (index: number) => void;
     swapValues: (aIndex: number, bIndex: number) => void;
-    getSubField: <TName extends DeepKeys<GetTData<DeepKeys<TFormData>, TData, TFormData>>>(name: TName) => FieldApi<DeepValue<GetTData<DeepKeys<TFormData>, TData, TFormData>, TName>, TFormData>;
-    validateSync: (value: GetTData<DeepKeys<TFormData>, TData, TFormData> | undefined, cause: ValidationCause) => void;
+    getSubField: <TName extends DeepKeys<TData>>(name: TName) => FieldApi<DeepValue<TData, TName>, TFormData, FieldApiOptions<DeepValue<TData, TName>, TFormData, unknown extends TFormData ? string : DeepKeys<TFormData>, unknown extends DeepValue<TData, TName> ? DeepValue<TFormData, unknown extends TFormData ? string : DeepKeys<TFormData>> : DeepValue<TData, TName>>, unknown extends DeepValue<TData, TName> ? DeepValue<TFormData, unknown extends TFormData ? string : DeepKeys<TFormData>> : DeepValue<TData, TName>>;
+    validateSync: (value: TData | undefined, cause: ValidationCause) => void;
     cancelValidateAsync: () => void;
-    validateAsync: (value: GetTData<DeepKeys<TFormData>, TData, TFormData> | undefined, cause: ValidationCause) => Promise<ValidationError[]>;
-    validate: (cause: ValidationCause, value?: typeof this$1._tdata) => ValidationError[] | Promise<ValidationError[]>;
-    handleChange: (updater: Updater<typeof this$1._tdata>) => void;
+    validateAsync: (value: TData | undefined, cause: ValidationCause) => Promise<ValidationError[]>;
+    validate: (cause: ValidationCause, value?: TData) => ValidationError[] | Promise<ValidationError[]>;
+    handleChange: (updater: Updater<TData>) => void;
     handleBlur: () => void;
 }
 

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<TData, TFormData> = (\n  value: TData,\n  fieldApi: FieldApi<TData, TFormData>,\n) => ValidationError\n\ntype ValidateAsyncFn<TData, TFormData> = (\n  value: TData,\n  fieldApi: FieldApi<TData, TFormData>,\n) => ValidationError | Promise<ValidationError>\n\nexport interface FieldOptions<\n  _TData,\n  TFormData,\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 = unknown extends TFormData ? string : DeepKeys<TFormData>,\n  /**\n   * If TData is unknown, we can use the TName generic to determine the type\n   */\n  TData = unknown extends _TData ? DeepValue<TFormData, TName> : _TData,\n> {\n  name: TName\n  index?: TData extends any[] ? number : never\n  defaultValue?: TData\n  asyncDebounceMs?: number\n  asyncAlways?: boolean\n  onMount?: (formApi: FieldApi<TData, TFormData>) => void\n  onChange?: ValidateFn<TData, TFormData>\n  onChangeAsync?: ValidateAsyncFn<TData, TFormData>\n  onChangeAsyncDebounceMs?: number\n  onBlur?: ValidateFn<TData, TFormData>\n  onBlurAsync?: ValidateAsyncFn<TData, TFormData>\n  onBlurAsyncDebounceMs?: number\n  onSubmitAsync?: ValidateAsyncFn<TData, TFormData>\n  defaultMeta?: Partial<FieldMeta>\n}\n\nexport type FieldApiOptions<TData, TFormData> = FieldOptions<\n  TData,\n  TFormData\n> & {\n  form: FormApi<TFormData>\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\n/**\n * TData may not be known at the time of FieldApi construction, so we need to\n * use a conditional type to determine if TData is known or not.\n *\n * If TData is not known, we use the TFormData type to determine the type of\n * the field value based on the field name.\n */\ntype GetTData<Name, TData, TFormData> = unknown extends TData\n  ? DeepValue<TFormData, Name>\n  : TData\n\nexport class FieldApi<TData, TFormData> {\n  uid: number\n  form: FormApi<TFormData>\n  name!: DeepKeys<TFormData>\n  /**\n   * This is a hack that allows us to use `GetTData` without calling it everywhere\n   *\n   * Unfortunately this hack appears to be needed alongside the `TName` hack\n   * further up in this file. This properly types all of the internal methods,\n   * while the `TName` hack types the options properly\n   */\n  _tdata!: GetTData<typeof this.name, TData, TFormData>\n  store!: Store<FieldState<typeof this._tdata>>\n  state!: FieldState<typeof this._tdata>\n  prevState!: FieldState<typeof this._tdata>\n  options: FieldOptions<typeof this._tdata, TFormData> = {} as any\n\n  constructor(opts: FieldApiOptions<TData, TFormData>) {\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<typeof this._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.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\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<typeof this._tdata, TFormData>) => {\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 TFormData]\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 = (): typeof this._tdata => {\n    return this.form.getFieldValue(this.name)\n  }\n\n  setValue = (\n    updater: Updater<typeof this._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 = (\n    value: typeof this._tdata extends any[]\n      ? (typeof this._tdata)[number]\n      : never,\n  ) => this.form.pushFieldValue(this.name, value as any)\n\n  insertValue = (\n    index: number,\n    value: typeof this._tdata extends any[]\n      ? (typeof this._tdata)[number]\n      : 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 = <TName extends DeepKeys<typeof this._tdata>>(name: TName) =>\n    new FieldApi<DeepValue<typeof this._tdata, TName>, TFormData>({\n      name: `${this.name}.${name}` as never,\n      form: this.form,\n    })\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 (error && this.state.meta.errorMap[errorMapKey] !== error) {\n      this.setMeta((prev) => ({\n        ...prev,\n        errors: [...prev.errors, error],\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            errors: [...prev.errors, error],\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?: typeof this._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<typeof this._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<TData, TFormData> = (\n  value: TData,\n  fieldApi: FieldApi<TData, TFormData>,\n) => ValidationError\n\ntype ValidateAsyncFn<TData, TFormData> = (\n  value: TData,\n  fieldApi: FieldApi<TData, TFormData>,\n) => ValidationError | Promise<ValidationError>\n\nexport interface FieldOptions<\n  _TData,\n  TFormData,\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 = unknown extends TFormData ? string : DeepKeys<TFormData>,\n  /**\n   * If TData is unknown, we can use the TName generic to determine the type\n   */\n  TData = unknown extends _TData ? DeepValue<TFormData, TName> : _TData,\n> {\n  name: TName\n  index?: TData extends any[] ? number : never\n  defaultValue?: TData\n  asyncDebounceMs?: number\n  asyncAlways?: boolean\n  onMount?: (formApi: FieldApi<TData, TFormData>) => void\n  onChange?: ValidateFn<TData, TFormData>\n  onChangeAsync?: ValidateAsyncFn<TData, TFormData>\n  onChangeAsyncDebounceMs?: number\n  onBlur?: ValidateFn<TData, TFormData>\n  onBlurAsync?: ValidateAsyncFn<TData, TFormData>\n  onBlurAsyncDebounceMs?: number\n  onSubmitAsync?: ValidateAsyncFn<TData, TFormData>\n  defaultMeta?: Partial<FieldMeta>\n}\n\nexport interface FieldApiOptions<\n  _TData,\n  TFormData,\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 = unknown extends TFormData ? string : DeepKeys<TFormData>,\n  /**\n   * If TData is unknown, we can use the TName generic to determine the type\n   */\n  TData = unknown extends _TData ? DeepValue<TFormData, TName> : _TData,\n> extends FieldOptions<_TData, TFormData, TName, TData> {\n  form: FormApi<TFormData>\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\ntype GetTData<\n  TData,\n  TFormData,\n  Opts extends FieldApiOptions<TData, TFormData>,\n> = Opts extends FieldApiOptions<\n  infer _TData,\n  infer _TFormData,\n  infer _TName,\n  infer RealTData\n>\n  ? RealTData\n  : never\n\nexport class FieldApi<\n  _TData,\n  TFormData,\n  Opts extends FieldApiOptions<_TData, TFormData> = FieldApiOptions<\n    _TData,\n    TFormData\n  >,\n  TData extends GetTData<_TData, TFormData, Opts> = GetTData<\n    _TData,\n    TFormData,\n    Opts\n  >,\n> {\n  uid: number\n  form: Opts['form']\n  name!: DeepKeys<TFormData>\n  options: Opts = {} as any\n  store!: Store<FieldState<TData>>\n  state!: FieldState<TData>\n  prevState!: FieldState<TData>\n\n  constructor(\n    opts: Opts & {\n      form: FormApi<TFormData>\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.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<TData, TFormData>) => {\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 TFormData]\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)\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 = <TName extends DeepKeys<TData>>(name: TName) =>\n    new FieldApi<DeepValue<TData, TName>, TFormData>({\n      name: `${this.name}.${name}` as never,\n      form: this.form,\n    })\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 (error && this.state.meta.errorMap[errorMapKey] !== error) {\n      this.setMeta((prev) => ({\n        ...prev,\n        errors: [...prev.errors, error],\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            errors: [...prev.errors, error],\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.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<TData, TFormData> = (\n  value: TData,\n  fieldApi: FieldApi<TData, TFormData>,\n) => ValidationError\n\ntype ValidateAsyncFn<TData, TFormData> = (\n  value: TData,\n  fieldApi: FieldApi<TData, TFormData>,\n) => ValidationError | Promise<ValidationError>\n\nexport interface FieldOptions<\n  _TData,\n  TFormData,\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 = unknown extends TFormData ? string : DeepKeys<TFormData>,\n  /**\n   * If TData is unknown, we can use the TName generic to determine the type\n   */\n  TData = unknown extends _TData ? DeepValue<TFormData, TName> : _TData,\n> {\n  name: TName\n  index?: TData extends any[] ? number : never\n  defaultValue?: TData\n  asyncDebounceMs?: number\n  asyncAlways?: boolean\n  onMount?: (formApi: FieldApi<TData, TFormData>) => void\n  onChange?: ValidateFn<TData, TFormData>\n  onChangeAsync?: ValidateAsyncFn<TData, TFormData>\n  onChangeAsyncDebounceMs?: number\n  onBlur?: ValidateFn<TData, TFormData>\n  onBlurAsync?: ValidateAsyncFn<TData, TFormData>\n  onBlurAsyncDebounceMs?: number\n  onSubmitAsync?: ValidateAsyncFn<TData, TFormData>\n  defaultMeta?: Partial<FieldMeta>\n}\n\nexport type FieldApiOptions<TData, TFormData> = FieldOptions<\n  TData,\n  TFormData\n> & {\n  form: FormApi<TFormData>\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\n/**\n * TData may not be known at the time of FieldApi construction, so we need to\n * use a conditional type to determine if TData is known or not.\n *\n * If TData is not known, we use the TFormData type to determine the type of\n * the field value based on the field name.\n */\ntype GetTData<Name, TData, TFormData> = unknown extends TData\n  ? DeepValue<TFormData, Name>\n  : TData\n\nexport class FieldApi<TData, TFormData> {\n  uid: number\n  form: FormApi<TFormData>\n  name!: DeepKeys<TFormData>\n  /**\n   * This is a hack that allows us to use `GetTData` without calling it everywhere\n   *\n   * Unfortunately this hack appears to be needed alongside the `TName` hack\n   * further up in this file. This properly types all of the internal methods,\n   * while the `TName` hack types the options properly\n   */\n  _tdata!: GetTData<typeof this.name, TData, TFormData>\n  store!: Store<FieldState<typeof this._tdata>>\n  state!: FieldState<typeof this._tdata>\n  prevState!: FieldState<typeof this._tdata>\n  options: FieldOptions<typeof this._tdata, TFormData> = {} as any\n\n  constructor(opts: FieldApiOptions<TData, TFormData>) {\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<typeof this._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.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\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<typeof this._tdata, TFormData>) => {\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 TFormData]\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 = (): typeof this._tdata => {\n    return this.form.getFieldValue(this.name)\n  }\n\n  setValue = (\n    updater: Updater<typeof this._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 = (\n    value: typeof this._tdata extends any[]\n      ? (typeof this._tdata)[number]\n      : never,\n  ) => this.form.pushFieldValue(this.name, value as any)\n\n  insertValue = (\n    index: number,\n    value: typeof this._tdata extends any[]\n      ? (typeof this._tdata)[number]\n      : 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 = <TName extends DeepKeys<typeof this._tdata>>(name: TName) =>\n    new FieldApi<DeepValue<typeof this._tdata, TName>, TFormData>({\n      name: `${this.name}.${name}` as never,\n      form: this.form,\n    })\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 (error && this.state.meta.errorMap[errorMapKey] !== error) {\n      this.setMeta((prev) => ({\n        ...prev,\n        errors: [...prev.errors, error],\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            errors: [...prev.errors, error],\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?: typeof this._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<typeof this._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<TData, TFormData> = (\n  value: TData,\n  fieldApi: FieldApi<TData, TFormData>,\n) => ValidationError\n\ntype ValidateAsyncFn<TData, TFormData> = (\n  value: TData,\n  fieldApi: FieldApi<TData, TFormData>,\n) => ValidationError | Promise<ValidationError>\n\nexport interface FieldOptions<\n  _TData,\n  TFormData,\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 = unknown extends TFormData ? string : DeepKeys<TFormData>,\n  /**\n   * If TData is unknown, we can use the TName generic to determine the type\n   */\n  TData = unknown extends _TData ? DeepValue<TFormData, TName> : _TData,\n> {\n  name: TName\n  index?: TData extends any[] ? number : never\n  defaultValue?: TData\n  asyncDebounceMs?: number\n  asyncAlways?: boolean\n  onMount?: (formApi: FieldApi<TData, TFormData>) => void\n  onChange?: ValidateFn<TData, TFormData>\n  onChangeAsync?: ValidateAsyncFn<TData, TFormData>\n  onChangeAsyncDebounceMs?: number\n  onBlur?: ValidateFn<TData, TFormData>\n  onBlurAsync?: ValidateAsyncFn<TData, TFormData>\n  onBlurAsyncDebounceMs?: number\n  onSubmitAsync?: ValidateAsyncFn<TData, TFormData>\n  defaultMeta?: Partial<FieldMeta>\n}\n\nexport interface FieldApiOptions<\n  _TData,\n  TFormData,\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 = unknown extends TFormData ? string : DeepKeys<TFormData>,\n  /**\n   * If TData is unknown, we can use the TName generic to determine the type\n   */\n  TData = unknown extends _TData ? DeepValue<TFormData, TName> : _TData,\n> extends FieldOptions<_TData, TFormData, TName, TData> {\n  form: FormApi<TFormData>\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\ntype GetTData<\n  TData,\n  TFormData,\n  Opts extends FieldApiOptions<TData, TFormData>,\n> = Opts extends FieldApiOptions<\n  infer _TData,\n  infer _TFormData,\n  infer _TName,\n  infer RealTData\n>\n  ? RealTData\n  : never\n\nexport class FieldApi<\n  _TData,\n  TFormData,\n  Opts extends FieldApiOptions<_TData, TFormData> = FieldApiOptions<\n    _TData,\n    TFormData\n  >,\n  TData extends GetTData<_TData, TFormData, Opts> = GetTData<\n    _TData,\n    TFormData,\n    Opts\n  >,\n> {\n  uid: number\n  form: Opts['form']\n  name!: DeepKeys<TFormData>\n  options: Opts = {} as any\n  store!: Store<FieldState<TData>>\n  state!: FieldState<TData>\n  prevState!: FieldState<TData>\n\n  constructor(\n    opts: Opts & {\n      form: FormApi<TFormData>\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.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<TData, TFormData>) => {\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 TFormData]\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)\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 = <TName extends DeepKeys<TData>>(name: TName) =>\n    new FieldApi<DeepValue<TData, TName>, TFormData>({\n      name: `${this.name}.${name}` as never,\n      form: this.form,\n    })\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 (error && this.state.meta.errorMap[errorMapKey] !== error) {\n      this.setMeta((prev) => ({\n        ...prev,\n        errors: [...prev.errors, error],\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            errors: [...prev.errors, error],\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;AAmEtB,IAAI,MAAM;AAoBH,IAAM,WAAN,MAAM,UAYX;AAAA,EASA,YACE,MAGA;AATF,mBAAgB,CAAC;AAoDjB,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,SAA4C;AAGpD,UAAI,KAAK,MAAM,UAAU,QAAW;AAClC,cAAM,cACJ,KAAK,KAAK,QAAQ,gBAAgB,KAAK,IAAuB;AAEhE,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,CAAgC,SAC5C,IAAI,UAA6C;AAAA,MAC/C,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,SAAS,KAAK,MAAM,KAAK,SAAS,WAAW,MAAM,OAAO;AAC5D,aAAK,QAAQ,CAAC,UAAU;AAAA,UACtB,GAAG;AAAA,UACH,QAAQ,CAAC,GAAG,KAAK,QAAQ,KAAK;AAAA,UAC9B,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,QAAQ,CAAC,GAAG,KAAK,QAAQ,KAAK;AAAA,cAC9B,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;AA7SE,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,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,EAoIA;AAkIF;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":[]}

package/build/modern/index.d.cts

@@ -109,9 +109,18 @@ TData = unknown extends _TData ? DeepValue<TFormData, TName> : _TData> {
     onSubmitAsync?: ValidateAsyncFn<TData, TFormData>;
     defaultMeta?: Partial<FieldMeta>;
 }
-type FieldApiOptions<TData, TFormData> = FieldOptions<TData, TFormData> & {
+interface FieldApiOptions<_TData, TFormData, 
+/**
+ * This allows us to restrict the name to only be a valid field name while
+ * also assigning it to a generic
+ */
+TName = unknown extends TFormData ? string : DeepKeys<TFormData>, 
+/**
+ * If TData is unknown, we can use the TName generic to determine the type
+ */
+TData = unknown extends _TData ? DeepValue<TFormData, TName> : _TData> extends FieldOptions<_TData, TFormData, TName, TData> {
     form: FormApi<TFormData>;
-};
+}
 type FieldMeta = {
     isTouched: boolean;
     touchedErrors: ValidationError[];
@@ -123,36 +132,23 @@ type FieldState<TData> = {
     value: TData;
     meta: FieldMeta;
 };
-/**
- * TData may not be known at the time of FieldApi construction, so we need to
- * use a conditional type to determine if TData is known or not.
- *
- * If TData is not known, we use the TFormData type to determine the type of
- * the field value based on the field name.
- */
-type GetTData<Name, TData, TFormData> = unknown extends TData ? DeepValue<TFormData, Name> : TData;
-declare class FieldApi<TData, TFormData> {
+type GetTData<TData, TFormData, Opts extends FieldApiOptions<TData, TFormData>> = Opts extends FieldApiOptions<infer _TData, infer _TFormData, infer _TName, infer RealTData> ? RealTData : never;
+declare class FieldApi<_TData, TFormData, Opts extends FieldApiOptions<_TData, TFormData> = FieldApiOptions<_TData, TFormData>, TData extends GetTData<_TData, TFormData, Opts> = GetTData<_TData, TFormData, Opts>> {
     #private;
     uid: number;
-    form: FormApi<TFormData>;
+    form: Opts['form'];
     name: DeepKeys<TFormData>;
-    /**
-     * This is a hack that allows us to use `GetTData` without calling it everywhere
-     *
-     * Unfortunately this hack appears to be needed alongside the `TName` hack
-     * further up in this file. This properly types all of the internal methods,
-     * while the `TName` hack types the options properly
-     */
-    _tdata: GetTData<typeof this$1.name, TData, TFormData>;
-    store: Store<FieldState<typeof this$1._tdata>>;
-    state: FieldState<typeof this$1._tdata>;
-    prevState: FieldState<typeof this$1._tdata>;
-    options: FieldOptions<typeof this$1._tdata, TFormData>;
-    constructor(opts: FieldApiOptions<TData, TFormData>);
+    options: Opts;
+    store: Store<FieldState<TData>>;
+    state: FieldState<TData>;
+    prevState: FieldState<TData>;
+    constructor(opts: Opts & {
+        form: FormApi<TFormData>;
+    });
     mount: () => () => void;
-    update: (opts: FieldApiOptions<typeof this$1._tdata, TFormData>) => void;
-    getValue: () => typeof this$1._tdata;
-    setValue: (updater: Updater<typeof this$1._tdata>, options?: {
+    update: (opts: FieldApiOptions<TData, TFormData>) => void;
+    getValue: () => TData;
+    setValue: (updater: Updater<TData>, options?: {
         touch?: boolean;
         notify?: boolean;
     }) => void;
@@ -160,16 +156,16 @@ declare class FieldApi<TData, TFormData> {
     getMeta: () => FieldMeta;
     setMeta: (updater: Updater<FieldMeta>) => void;
     getInfo: () => Record<DeepKeys<TFormData>, FieldInfo<TFormData>>[DeepKeys<TFormData>];
-    pushValue: (value: typeof this$1._tdata extends any[] ? (typeof this$1._tdata)[number] : never) => void;
-    insertValue: (index: number, value: typeof this$1._tdata extends any[] ? (typeof this$1._tdata)[number] : never) => void;
+    pushValue: (value: TData extends any[] ? TData[number] : never) => void;
+    insertValue: (index: number, value: TData extends any[] ? TData[number] : never) => void;
     removeValue: (index: number) => void;
     swapValues: (aIndex: number, bIndex: number) => void;
-    getSubField: <TName extends DeepKeys<GetTData<DeepKeys<TFormData>, TData, TFormData>>>(name: TName) => FieldApi<DeepValue<GetTData<DeepKeys<TFormData>, TData, TFormData>, TName>, TFormData>;
-    validateSync: (value: GetTData<DeepKeys<TFormData>, TData, TFormData> | undefined, cause: ValidationCause) => void;
+    getSubField: <TName extends DeepKeys<TData>>(name: TName) => FieldApi<DeepValue<TData, TName>, TFormData, FieldApiOptions<DeepValue<TData, TName>, TFormData, unknown extends TFormData ? string : DeepKeys<TFormData>, unknown extends DeepValue<TData, TName> ? DeepValue<TFormData, unknown extends TFormData ? string : DeepKeys<TFormData>> : DeepValue<TData, TName>>, unknown extends DeepValue<TData, TName> ? DeepValue<TFormData, unknown extends TFormData ? string : DeepKeys<TFormData>> : DeepValue<TData, TName>>;
+    validateSync: (value: TData | undefined, cause: ValidationCause) => void;
     cancelValidateAsync: () => void;
-    validateAsync: (value: GetTData<DeepKeys<TFormData>, TData, TFormData> | undefined, cause: ValidationCause) => Promise<ValidationError[]>;
-    validate: (cause: ValidationCause, value?: typeof this$1._tdata) => ValidationError[] | Promise<ValidationError[]>;
-    handleChange: (updater: Updater<typeof this$1._tdata>) => void;
+    validateAsync: (value: TData | undefined, cause: ValidationCause) => Promise<ValidationError[]>;
+    validate: (cause: ValidationCause, value?: TData) => ValidationError[] | Promise<ValidationError[]>;
+    handleChange: (updater: Updater<TData>) => void;
     handleBlur: () => void;
 }
 

package/build/modern/index.d.ts

@@ -109,9 +109,18 @@ TData = unknown extends _TData ? DeepValue<TFormData, TName> : _TData> {
     onSubmitAsync?: ValidateAsyncFn<TData, TFormData>;
     defaultMeta?: Partial<FieldMeta>;
 }
-type FieldApiOptions<TData, TFormData> = FieldOptions<TData, TFormData> & {
+interface FieldApiOptions<_TData, TFormData, 
+/**
+ * This allows us to restrict the name to only be a valid field name while
+ * also assigning it to a generic
+ */
+TName = unknown extends TFormData ? string : DeepKeys<TFormData>, 
+/**
+ * If TData is unknown, we can use the TName generic to determine the type
+ */
+TData = unknown extends _TData ? DeepValue<TFormData, TName> : _TData> extends FieldOptions<_TData, TFormData, TName, TData> {
     form: FormApi<TFormData>;
-};
+}
 type FieldMeta = {
     isTouched: boolean;
     touchedErrors: ValidationError[];
@@ -123,36 +132,23 @@ type FieldState<TData> = {
     value: TData;
     meta: FieldMeta;
 };
-/**
- * TData may not be known at the time of FieldApi construction, so we need to
- * use a conditional type to determine if TData is known or not.
- *
- * If TData is not known, we use the TFormData type to determine the type of
- * the field value based on the field name.
- */
-type GetTData<Name, TData, TFormData> = unknown extends TData ? DeepValue<TFormData, Name> : TData;
-declare class FieldApi<TData, TFormData> {
+type GetTData<TData, TFormData, Opts extends FieldApiOptions<TData, TFormData>> = Opts extends FieldApiOptions<infer _TData, infer _TFormData, infer _TName, infer RealTData> ? RealTData : never;
+declare class FieldApi<_TData, TFormData, Opts extends FieldApiOptions<_TData, TFormData> = FieldApiOptions<_TData, TFormData>, TData extends GetTData<_TData, TFormData, Opts> = GetTData<_TData, TFormData, Opts>> {
     #private;
     uid: number;
-    form: FormApi<TFormData>;
+    form: Opts['form'];
     name: DeepKeys<TFormData>;
-    /**
-     * This is a hack that allows us to use `GetTData` without calling it everywhere
-     *
-     * Unfortunately this hack appears to be needed alongside the `TName` hack
-     * further up in this file. This properly types all of the internal methods,
-     * while the `TName` hack types the options properly
-     */
-    _tdata: GetTData<typeof this$1.name, TData, TFormData>;
-    store: Store<FieldState<typeof this$1._tdata>>;
-    state: FieldState<typeof this$1._tdata>;
-    prevState: FieldState<typeof this$1._tdata>;
-    options: FieldOptions<typeof this$1._tdata, TFormData>;
-    constructor(opts: FieldApiOptions<TData, TFormData>);
+    options: Opts;
+    store: Store<FieldState<TData>>;
+    state: FieldState<TData>;
+    prevState: FieldState<TData>;
+    constructor(opts: Opts & {
+        form: FormApi<TFormData>;
+    });
     mount: () => () => void;
-    update: (opts: FieldApiOptions<typeof this$1._tdata, TFormData>) => void;
-    getValue: () => typeof this$1._tdata;
-    setValue: (updater: Updater<typeof this$1._tdata>, options?: {
+    update: (opts: FieldApiOptions<TData, TFormData>) => void;
+    getValue: () => TData;
+    setValue: (updater: Updater<TData>, options?: {
         touch?: boolean;
         notify?: boolean;
     }) => void;
@@ -160,16 +156,16 @@ declare class FieldApi<TData, TFormData> {
     getMeta: () => FieldMeta;
     setMeta: (updater: Updater<FieldMeta>) => void;
     getInfo: () => Record<DeepKeys<TFormData>, FieldInfo<TFormData>>[DeepKeys<TFormData>];
-    pushValue: (value: typeof this$1._tdata extends any[] ? (typeof this$1._tdata)[number] : never) => void;
-    insertValue: (index: number, value: typeof this$1._tdata extends any[] ? (typeof this$1._tdata)[number] : never) => void;
+    pushValue: (value: TData extends any[] ? TData[number] : never) => void;
+    insertValue: (index: number, value: TData extends any[] ? TData[number] : never) => void;
     removeValue: (index: number) => void;
     swapValues: (aIndex: number, bIndex: number) => void;
-    getSubField: <TName extends DeepKeys<GetTData<DeepKeys<TFormData>, TData, TFormData>>>(name: TName) => FieldApi<DeepValue<GetTData<DeepKeys<TFormData>, TData, TFormData>, TName>, TFormData>;
-    validateSync: (value: GetTData<DeepKeys<TFormData>, TData, TFormData> | undefined, cause: ValidationCause) => void;
+    getSubField: <TName extends DeepKeys<TData>>(name: TName) => FieldApi<DeepValue<TData, TName>, TFormData, FieldApiOptions<DeepValue<TData, TName>, TFormData, unknown extends TFormData ? string : DeepKeys<TFormData>, unknown extends DeepValue<TData, TName> ? DeepValue<TFormData, unknown extends TFormData ? string : DeepKeys<TFormData>> : DeepValue<TData, TName>>, unknown extends DeepValue<TData, TName> ? DeepValue<TFormData, unknown extends TFormData ? string : DeepKeys<TFormData>> : DeepValue<TData, TName>>;
+    validateSync: (value: TData | undefined, cause: ValidationCause) => void;
     cancelValidateAsync: () => void;
-    validateAsync: (value: GetTData<DeepKeys<TFormData>, TData, TFormData> | undefined, cause: ValidationCause) => Promise<ValidationError[]>;
-    validate: (cause: ValidationCause, value?: typeof this$1._tdata) => ValidationError[] | Promise<ValidationError[]>;
-    handleChange: (updater: Updater<typeof this$1._tdata>) => void;
+    validateAsync: (value: TData | undefined, cause: ValidationCause) => Promise<ValidationError[]>;
+    validate: (cause: ValidationCause, value?: TData) => ValidationError[] | Promise<ValidationError[]>;
+    handleChange: (updater: Updater<TData>) => void;
     handleBlur: () => void;
 }
 

package/package.json

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

package/src/FieldApi.ts

@@ -43,10 +43,19 @@ export interface FieldOptions<
   defaultMeta?: Partial<FieldMeta>
 }
 
-export type FieldApiOptions<TData, TFormData> = FieldOptions<
-  TData,
-  TFormData
-> & {
+export interface FieldApiOptions<
+  _TData,
+  TFormData,
+  /**
+   * This allows us to restrict the name to only be a valid field name while
+   * also assigning it to a generic
+   */
+  TName = unknown extends TFormData ? string : DeepKeys<TFormData>,
+  /**
+   * If TData is unknown, we can use the TName generic to determine the type
+   */
+  TData = unknown extends _TData ? DeepValue<TFormData, TName> : _TData,
+> extends FieldOptions<_TData, TFormData, TName, TData> {
   form: FormApi<TFormData>
 }
 
@@ -65,35 +74,45 @@ export type FieldState<TData> = {
   meta: FieldMeta
 }
 
-/**
- * TData may not be known at the time of FieldApi construction, so we need to
- * use a conditional type to determine if TData is known or not.
- *
- * If TData is not known, we use the TFormData type to determine the type of
- * the field value based on the field name.
- */
-type GetTData<Name, TData, TFormData> = unknown extends TData
-  ? DeepValue<TFormData, Name>
-  : TData
-
-export class FieldApi<TData, TFormData> {
+type GetTData<
+  TData,
+  TFormData,
+  Opts extends FieldApiOptions<TData, TFormData>,
+> = Opts extends FieldApiOptions<
+  infer _TData,
+  infer _TFormData,
+  infer _TName,
+  infer RealTData
+>
+  ? RealTData
+  : never
+
+export class FieldApi<
+  _TData,
+  TFormData,
+  Opts extends FieldApiOptions<_TData, TFormData> = FieldApiOptions<
+    _TData,
+    TFormData
+  >,
+  TData extends GetTData<_TData, TFormData, Opts> = GetTData<
+    _TData,
+    TFormData,
+    Opts
+  >,
+> {
   uid: number
-  form: FormApi<TFormData>
+  form: Opts['form']
   name!: DeepKeys<TFormData>
-  /**
-   * This is a hack that allows us to use `GetTData` without calling it everywhere
-   *
-   * Unfortunately this hack appears to be needed alongside the `TName` hack
-   * further up in this file. This properly types all of the internal methods,
-   * while the `TName` hack types the options properly
-   */
-  _tdata!: GetTData<typeof this.name, TData, TFormData>
-  store!: Store<FieldState<typeof this._tdata>>
-  state!: FieldState<typeof this._tdata>
-  prevState!: FieldState<typeof this._tdata>
-  options: FieldOptions<typeof this._tdata, TFormData> = {} as any
-
-  constructor(opts: FieldApiOptions<TData, TFormData>) {
+  options: Opts = {} as any
+  store!: Store<FieldState<TData>>
+  state!: FieldState<TData>
+  prevState!: FieldState<TData>
+
+  constructor(
+    opts: Opts & {
+      form: FormApi<TFormData>
+    },
+  ) {
     this.form = opts.form
     this.uid = uid++
     // Support field prefixing from FieldScope
@@ -104,7 +123,7 @@ export class FieldApi<TData, TFormData> {
 
     this.name = opts.name as any
 
-    this.store = new Store<FieldState<typeof this._tdata>>(
+    this.store = new Store<FieldState<TData>>(
       {
         value: this.getValue(),
         // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
@@ -138,7 +157,7 @@ export class FieldApi<TData, TFormData> {
 
   mount = () => {
     const info = this.getInfo()
-    info.instances[this.uid] = this
+    info.instances[this.uid] = this as never
 
     const unsubscribe = this.form.store.subscribe(() => {
       this.store.batch(() => {
@@ -167,7 +186,7 @@ export class FieldApi<TData, TFormData> {
     }
   }
 
-  update = (opts: FieldApiOptions<typeof this._tdata, TFormData>) => {
+  update = (opts: FieldApiOptions<TData, TFormData>) => {
     // Default Value
     // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
     if (this.state.value === undefined) {
@@ -189,12 +208,12 @@ export class FieldApi<TData, TFormData> {
     this.options = opts as never
   }
 
-  getValue = (): typeof this._tdata => {
+  getValue = (): TData => {
     return this.form.getFieldValue(this.name)
   }
 
   setValue = (
-    updater: Updater<typeof this._tdata>,
+    updater: Updater<TData>,
     options?: { touch?: boolean; notify?: boolean },
   ) => {
     this.form.setFieldValue(this.name, updater as never, options)
@@ -218,17 +237,12 @@ export class FieldApi<TData, TFormData> {
 
   getInfo = () => this.form.getFieldInfo(this.name)
 
-  pushValue = (
-    value: typeof this._tdata extends any[]
-      ? (typeof this._tdata)[number]
-      : never,
-  ) => this.form.pushFieldValue(this.name, value as any)
+  pushValue = (value: TData extends any[] ? TData[number] : never) =>
+    this.form.pushFieldValue(this.name, value as any)
 
   insertValue = (
     index: number,
-    value: typeof this._tdata extends any[]
-      ? (typeof this._tdata)[number]
-      : never,
+    value: TData extends any[] ? TData[number] : never,
   ) => this.form.insertFieldValue(this.name, index, value as any)
 
   removeValue = (index: number) => this.form.removeFieldValue(this.name, index)
@@ -236,8 +250,8 @@ export class FieldApi<TData, TFormData> {
   swapValues = (aIndex: number, bIndex: number) =>
     this.form.swapFieldValues(this.name, aIndex, bIndex)
 
-  getSubField = <TName extends DeepKeys<typeof this._tdata>>(name: TName) =>
-    new FieldApi<DeepValue<typeof this._tdata, TName>, TFormData>({
+  getSubField = <TName extends DeepKeys<TData>>(name: TName) =>
+    new FieldApi<DeepValue<TData, TName>, TFormData>({
       name: `${this.name}.${name}` as never,
       form: this.form,
     })
@@ -371,7 +385,7 @@ export class FieldApi<TData, TFormData> {
 
   validate = (
     cause: ValidationCause,
-    value?: typeof this._tdata,
+    value?: TData,
   ): ValidationError[] | Promise<ValidationError[]> => {
     // If the field is pristine and validatePristine is false, do not validate
     if (!this.state.meta.isTouched) return []
@@ -389,7 +403,7 @@ export class FieldApi<TData, TFormData> {
     return this.validateAsync(value, cause)
   }
 
-  handleChange = (updater: Updater<typeof this._tdata>) => {
+  handleChange = (updater: Updater<TData>) => {
     this.setValue(updater, { touch: true })
   }