@tanstack/form-core 0.1.3 → 0.2.0

package/build/modern/FieldApi.cjs

@@ -0,0 +1,238 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/FieldApi.ts
+var FieldApi_exports = {};
+__export(FieldApi_exports, {
+  FieldApi: () => FieldApi
+});
+module.exports = __toCommonJS(FieldApi_exports);
+var import_store = require("@tanstack/store");
+var uid = 0;
+var FieldApi = class _FieldApi {
+  constructor(opts) {
+    this.options = {};
+    this.mount = () => {
+      const info = this.getInfo();
+      info.instances[this.uid] = this;
+      const unsubscribe = this.form.store.subscribe(() => {
+        this.store.batch(() => {
+          const nextValue = this.getValue();
+          const nextMeta = this.getMeta();
+          if (nextValue !== this.state.value) {
+            this.store.setState((prev) => ({ ...prev, value: nextValue }));
+          }
+          if (nextMeta !== this.state.meta) {
+            this.store.setState((prev) => ({ ...prev, meta: nextMeta }));
+          }
+        });
+      });
+      this.update(this.options);
+      this.options.onMount?.(this);
+      return () => {
+        unsubscribe();
+        delete info.instances[this.uid];
+        if (!Object.keys(info.instances).length) {
+          delete this.form.fieldInfo[this.name];
+        }
+      };
+    };
+    this.update = (opts) => {
+      if (this.state.value === void 0) {
+        const formDefault = opts.form.options.defaultValues?.[opts.name];
+        if (opts.defaultValue !== void 0) {
+          this.setValue(opts.defaultValue);
+        } else if (formDefault !== void 0) {
+          this.setValue(formDefault);
+        }
+      }
+      if (this._getMeta() === void 0) {
+        this.setMeta(this.state.meta);
+      }
+      this.options = opts;
+    };
+    this.getValue = () => {
+      return this.form.getFieldValue(this.name);
+    };
+    this.setValue = (updater, options) => {
+      this.form.setFieldValue(this.name, updater, options);
+      this.validate("change", this.state.value);
+    };
+    this._getMeta = () => this.form.getFieldMeta(this.name);
+    this.getMeta = () => this._getMeta() ?? {
+      isValidating: false,
+      isTouched: false,
+      ...this.options.defaultMeta
+    };
+    this.setMeta = (updater) => this.form.setFieldMeta(this.name, updater);
+    this.getInfo = () => this.form.getFieldInfo(this.name);
+    this.pushValue = (value) => this.form.pushFieldValue(this.name, value);
+    this.insertValue = (index, value) => this.form.insertFieldValue(this.name, index, value);
+    this.removeValue = (index) => this.form.removeFieldValue(this.name, index);
+    this.swapValues = (aIndex, bIndex) => this.form.swapFieldValues(this.name, aIndex, bIndex);
+    this.getSubField = (name) => new _FieldApi({
+      name: `${this.name}.${name}`,
+      form: this.form
+    });
+    this.validateSync = (value = this.state.value, cause) => {
+      const { onChange, onBlur } = this.options;
+      const validate = cause === "submit" ? void 0 : cause === "change" ? onChange : onBlur;
+      if (!validate)
+        return;
+      const validationCount = (this.getInfo().validationCount || 0) + 1;
+      this.getInfo().validationCount = validationCount;
+      const error = normalizeError(validate(value, this));
+      if (this.state.meta.error !== error) {
+        this.setMeta((prev) => ({
+          ...prev,
+          error
+        }));
+      }
+      if (this.state.meta.error) {
+        this.cancelValidateAsync();
+      }
+    };
+    this.#leaseValidateAsync = () => {
+      const count = (this.getInfo().validationAsyncCount || 0) + 1;
+      this.getInfo().validationAsyncCount = count;
+      return count;
+    };
+    this.cancelValidateAsync = () => {
+      this.#leaseValidateAsync();
+      this.setMeta((prev) => ({
+        ...prev,
+        isValidating: false
+      }));
+    };
+    this.validateAsync = async (value = this.state.value, cause) => {
+      const {
+        onChangeAsync,
+        onBlurAsync,
+        onSubmitAsync,
+        asyncDebounceMs,
+        onBlurAsyncDebounceMs,
+        onChangeAsyncDebounceMs
+      } = this.options;
+      const validate = cause === "change" ? onChangeAsync : cause === "submit" ? onSubmitAsync : onBlurAsync;
+      if (!validate)
+        return;
+      const debounceMs = cause === "submit" ? 0 : (cause === "change" ? onChangeAsyncDebounceMs : onBlurAsyncDebounceMs) ?? asyncDebounceMs ?? 0;
+      if (this.state.meta.isValidating !== true)
+        this.setMeta((prev) => ({ ...prev, isValidating: true }));
+      const validationAsyncCount = this.#leaseValidateAsync();
+      const checkLatest = () => validationAsyncCount === this.getInfo().validationAsyncCount;
+      if (!this.getInfo().validationPromise) {
+        this.getInfo().validationPromise = new Promise((resolve, reject) => {
+          this.getInfo().validationResolve = resolve;
+          this.getInfo().validationReject = reject;
+        });
+      }
+      if (debounceMs > 0) {
+        await new Promise((r) => setTimeout(r, debounceMs));
+      }
+      if (checkLatest()) {
+        try {
+          const rawError = await validate(value, this);
+          if (checkLatest()) {
+            const error = normalizeError(rawError);
+            this.setMeta((prev) => ({
+              ...prev,
+              isValidating: false,
+              error
+            }));
+            this.getInfo().validationResolve?.(error);
+          }
+        } catch (error) {
+          if (checkLatest()) {
+            this.getInfo().validationReject?.(error);
+            throw error;
+          }
+        } finally {
+          if (checkLatest()) {
+            this.setMeta((prev) => ({ ...prev, isValidating: false }));
+            delete this.getInfo().validationPromise;
+          }
+        }
+      }
+      return this.getInfo().validationPromise;
+    };
+    this.validate = (cause, value) => {
+      if (!this.state.meta.isTouched)
+        return;
+      this.validateSync(value, cause);
+      if (this.state.meta.error) {
+        if (!this.options.asyncAlways) {
+          return this.state.meta.error;
+        }
+      }
+      return this.validateAsync(value, cause);
+    };
+    this.handleChange = (updater) => {
+      this.setValue(updater, { touch: true });
+    };
+    this.handleBlur = () => {
+      const prevTouched = this.state.meta.isTouched;
+      if (!prevTouched) {
+        this.setMeta((prev) => ({ ...prev, isTouched: true }));
+        this.validate("change");
+      }
+      this.validate("blur");
+    };
+    this.form = opts.form;
+    this.uid = uid++;
+    this.name = opts.name;
+    this.store = new import_store.Store(
+      {
+        value: this.getValue(),
+        // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
+        meta: this._getMeta() ?? {
+          isValidating: false,
+          isTouched: false,
+          ...opts.defaultMeta
+        }
+      },
+      {
+        onUpdate: () => {
+          const state = this.store.state;
+          state.meta.touchedError = state.meta.isTouched ? state.meta.error : void 0;
+          this.prevState = state;
+          this.state = state;
+        }
+      }
+    );
+    this.state = this.store.state;
+    this.prevState = this.state;
+    this.options = opts;
+  }
+  #leaseValidateAsync;
+};
+function normalizeError(rawError) {
+  if (rawError) {
+    if (typeof rawError !== "string") {
+      return "Invalid Form Values";
+    }
+    return rawError;
+  }
+  return void 0;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  FieldApi
+});
+//# sourceMappingURL=FieldApi.cjs.map

package/build/modern/FieldApi.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/FieldApi.ts"],"sourcesContent":["import type { DeepKeys, DeepValue, Updater } from './utils'\nimport type { FormApi, ValidationError } from './FormApi'\nimport { Store } from '@tanstack/store'\n\nexport type ValidationCause = 'change' | 'blur' | 'submit'\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  touchedError?: ValidationError\n  error?: ValidationError\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          ...opts.defaultMeta,\n        },\n      },\n      {\n        onUpdate: () => {\n          const state = this.store.state\n\n          state.meta.touchedError = state.meta.isTouched\n            ? state.meta.error\n            : undefined\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      ...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\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\n    if (this.state.meta.error !== error) {\n      this.setMeta((prev) => ({\n        ...prev,\n        error,\n      }))\n    }\n\n    // If a sync error is encountered, cancel any async validation\n    if (this.state.meta.error) {\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\n    if (!validate) return\n\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      try {\n        const rawError = await validate(value as never, this as never)\n\n        if (checkLatest()) {\n          const error = normalizeError(rawError)\n          this.setMeta((prev) => ({\n            ...prev,\n            isValidating: false,\n            error,\n          }))\n          this.getInfo().validationResolve?.(error)\n        }\n      } catch (error) {\n        if (checkLatest()) {\n          this.getInfo().validationReject?.(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\n    // Attempt to sync validate first\n    this.validateSync(value, cause)\n\n    // If there is an error, return it, do not attempt async validation\n    if (this.state.meta.error) {\n      if (!this.options.asyncAlways) {\n        return this.state.meta.error\n      }\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"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAEA,mBAAsB;AAyDtB,IAAI,MAAM;AAkBH,IAAM,WAAN,MAAM,UAA2B;AAAA,EAiBtC,YAAY,MAAyC;AAFrD,mBAAuD,CAAC;AA0CxD,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,SAAyD;AAGjE,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,MAA0B;AACnC,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,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,CACV,UAGG,KAAK,KAAK,eAAe,KAAK,MAAM,KAAY;AAErD,uBAAc,CACZ,OACA,UAGG,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,CAA6C,SACzD,IAAI,UAA0D;AAAA,MAC5D,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;AAEnE,UAAI,CAAC;AAAU;AAIf,YAAM,mBAAmB,KAAK,QAAQ,EAAE,mBAAmB,KAAK;AAChE,WAAK,QAAQ,EAAE,kBAAkB;AACjC,YAAM,QAAQ,eAAe,SAAS,OAAgB,IAAa,CAAC;AAEpE,UAAI,KAAK,MAAM,KAAK,UAAU,OAAO;AACnC,aAAK,QAAQ,CAAC,UAAU;AAAA,UACtB,GAAG;AAAA,UACH;AAAA,QACF,EAAE;AAAA,MACJ;AAGA,UAAI,KAAK,MAAM,KAAK,OAAO;AACzB,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;AAEN,UAAI,CAAC;AAAU;AAEf,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,YAAI;AACF,gBAAM,WAAW,MAAM,SAAS,OAAgB,IAAa;AAE7D,cAAI,YAAY,GAAG;AACjB,kBAAM,QAAQ,eAAe,QAAQ;AACrC,iBAAK,QAAQ,CAAC,UAAU;AAAA,cACtB,GAAG;AAAA,cACH,cAAc;AAAA,cACd;AAAA,YACF,EAAE;AACF,iBAAK,QAAQ,EAAE,oBAAoB,KAAK;AAAA,UAC1C;AAAA,QACF,SAAS,OAAO;AACd,cAAI,YAAY,GAAG;AACjB,iBAAK,QAAQ,EAAE,mBAAmB,KAAK;AACvC,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;AAAA,IACxB;AAEA,oBAAW,CACT,OACA,UAC+C;AAE/C,UAAI,CAAC,KAAK,MAAM,KAAK;AAAW;AAGhC,WAAK,aAAa,OAAO,KAAK;AAG9B,UAAI,KAAK,MAAM,KAAK,OAAO;AACzB,YAAI,CAAC,KAAK,QAAQ,aAAa;AAC7B,iBAAO,KAAK,MAAM,KAAK;AAAA,QACzB;AAAA,MACF;AAGA,aAAO,KAAK,cAAc,OAAO,KAAK;AAAA,IACxC;AAEA,wBAAe,CAAC,YAAyC;AACvD,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;AAxSE,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,GAAG,KAAK;AAAA,QACV;AAAA,MACF;AAAA,MACA;AAAA,QACE,UAAU,MAAM;AACd,gBAAM,QAAQ,KAAK,MAAM;AAEzB,gBAAM,KAAK,eAAe,MAAM,KAAK,YACjC,MAAM,KAAK,QACX;AAEJ,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,EAmIA;AAiIF;AAEA,SAAS,eAAe,UAA4B;AAClD,MAAI,UAAU;AACZ,QAAI,OAAO,aAAa,UAAU;AAChC,aAAO;AAAA,IACT;AAEA,WAAO;AAAA,EACT;AAEA,SAAO;AACT;","names":[]}

package/build/modern/FieldApi.d.cts

@@ -0,0 +1,3 @@
+export { FieldApi, FieldApiOptions, FieldMeta, FieldOptions, FieldState, ValidationCause } from './index.cjs';
+import './utils.cjs';
+import '@tanstack/store';

package/build/modern/FieldApi.d.ts

@@ -0,0 +1,3 @@
+export { FieldApi, FieldApiOptions, FieldMeta, FieldOptions, FieldState, ValidationCause } from './index.js';
+import './utils.js';
+import '@tanstack/store';

package/build/modern/FieldApi.js

@@ -0,0 +1,213 @@
+// src/FieldApi.ts
+import { Store } from "@tanstack/store";
+var uid = 0;
+var FieldApi = class _FieldApi {
+  constructor(opts) {
+    this.options = {};
+    this.mount = () => {
+      const info = this.getInfo();
+      info.instances[this.uid] = this;
+      const unsubscribe = this.form.store.subscribe(() => {
+        this.store.batch(() => {
+          const nextValue = this.getValue();
+          const nextMeta = this.getMeta();
+          if (nextValue !== this.state.value) {
+            this.store.setState((prev) => ({ ...prev, value: nextValue }));
+          }
+          if (nextMeta !== this.state.meta) {
+            this.store.setState((prev) => ({ ...prev, meta: nextMeta }));
+          }
+        });
+      });
+      this.update(this.options);
+      this.options.onMount?.(this);
+      return () => {
+        unsubscribe();
+        delete info.instances[this.uid];
+        if (!Object.keys(info.instances).length) {
+          delete this.form.fieldInfo[this.name];
+        }
+      };
+    };
+    this.update = (opts) => {
+      if (this.state.value === void 0) {
+        const formDefault = opts.form.options.defaultValues?.[opts.name];
+        if (opts.defaultValue !== void 0) {
+          this.setValue(opts.defaultValue);
+        } else if (formDefault !== void 0) {
+          this.setValue(formDefault);
+        }
+      }
+      if (this._getMeta() === void 0) {
+        this.setMeta(this.state.meta);
+      }
+      this.options = opts;
+    };
+    this.getValue = () => {
+      return this.form.getFieldValue(this.name);
+    };
+    this.setValue = (updater, options) => {
+      this.form.setFieldValue(this.name, updater, options);
+      this.validate("change", this.state.value);
+    };
+    this._getMeta = () => this.form.getFieldMeta(this.name);
+    this.getMeta = () => this._getMeta() ?? {
+      isValidating: false,
+      isTouched: false,
+      ...this.options.defaultMeta
+    };
+    this.setMeta = (updater) => this.form.setFieldMeta(this.name, updater);
+    this.getInfo = () => this.form.getFieldInfo(this.name);
+    this.pushValue = (value) => this.form.pushFieldValue(this.name, value);
+    this.insertValue = (index, value) => this.form.insertFieldValue(this.name, index, value);
+    this.removeValue = (index) => this.form.removeFieldValue(this.name, index);
+    this.swapValues = (aIndex, bIndex) => this.form.swapFieldValues(this.name, aIndex, bIndex);
+    this.getSubField = (name) => new _FieldApi({
+      name: `${this.name}.${name}`,
+      form: this.form
+    });
+    this.validateSync = (value = this.state.value, cause) => {
+      const { onChange, onBlur } = this.options;
+      const validate = cause === "submit" ? void 0 : cause === "change" ? onChange : onBlur;
+      if (!validate)
+        return;
+      const validationCount = (this.getInfo().validationCount || 0) + 1;
+      this.getInfo().validationCount = validationCount;
+      const error = normalizeError(validate(value, this));
+      if (this.state.meta.error !== error) {
+        this.setMeta((prev) => ({
+          ...prev,
+          error
+        }));
+      }
+      if (this.state.meta.error) {
+        this.cancelValidateAsync();
+      }
+    };
+    this.#leaseValidateAsync = () => {
+      const count = (this.getInfo().validationAsyncCount || 0) + 1;
+      this.getInfo().validationAsyncCount = count;
+      return count;
+    };
+    this.cancelValidateAsync = () => {
+      this.#leaseValidateAsync();
+      this.setMeta((prev) => ({
+        ...prev,
+        isValidating: false
+      }));
+    };
+    this.validateAsync = async (value = this.state.value, cause) => {
+      const {
+        onChangeAsync,
+        onBlurAsync,
+        onSubmitAsync,
+        asyncDebounceMs,
+        onBlurAsyncDebounceMs,
+        onChangeAsyncDebounceMs
+      } = this.options;
+      const validate = cause === "change" ? onChangeAsync : cause === "submit" ? onSubmitAsync : onBlurAsync;
+      if (!validate)
+        return;
+      const debounceMs = cause === "submit" ? 0 : (cause === "change" ? onChangeAsyncDebounceMs : onBlurAsyncDebounceMs) ?? asyncDebounceMs ?? 0;
+      if (this.state.meta.isValidating !== true)
+        this.setMeta((prev) => ({ ...prev, isValidating: true }));
+      const validationAsyncCount = this.#leaseValidateAsync();
+      const checkLatest = () => validationAsyncCount === this.getInfo().validationAsyncCount;
+      if (!this.getInfo().validationPromise) {
+        this.getInfo().validationPromise = new Promise((resolve, reject) => {
+          this.getInfo().validationResolve = resolve;
+          this.getInfo().validationReject = reject;
+        });
+      }
+      if (debounceMs > 0) {
+        await new Promise((r) => setTimeout(r, debounceMs));
+      }
+      if (checkLatest()) {
+        try {
+          const rawError = await validate(value, this);
+          if (checkLatest()) {
+            const error = normalizeError(rawError);
+            this.setMeta((prev) => ({
+              ...prev,
+              isValidating: false,
+              error
+            }));
+            this.getInfo().validationResolve?.(error);
+          }
+        } catch (error) {
+          if (checkLatest()) {
+            this.getInfo().validationReject?.(error);
+            throw error;
+          }
+        } finally {
+          if (checkLatest()) {
+            this.setMeta((prev) => ({ ...prev, isValidating: false }));
+            delete this.getInfo().validationPromise;
+          }
+        }
+      }
+      return this.getInfo().validationPromise;
+    };
+    this.validate = (cause, value) => {
+      if (!this.state.meta.isTouched)
+        return;
+      this.validateSync(value, cause);
+      if (this.state.meta.error) {
+        if (!this.options.asyncAlways) {
+          return this.state.meta.error;
+        }
+      }
+      return this.validateAsync(value, cause);
+    };
+    this.handleChange = (updater) => {
+      this.setValue(updater, { touch: true });
+    };
+    this.handleBlur = () => {
+      const prevTouched = this.state.meta.isTouched;
+      if (!prevTouched) {
+        this.setMeta((prev) => ({ ...prev, isTouched: true }));
+        this.validate("change");
+      }
+      this.validate("blur");
+    };
+    this.form = opts.form;
+    this.uid = uid++;
+    this.name = opts.name;
+    this.store = new Store(
+      {
+        value: this.getValue(),
+        // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
+        meta: this._getMeta() ?? {
+          isValidating: false,
+          isTouched: false,
+          ...opts.defaultMeta
+        }
+      },
+      {
+        onUpdate: () => {
+          const state = this.store.state;
+          state.meta.touchedError = state.meta.isTouched ? state.meta.error : void 0;
+          this.prevState = state;
+          this.state = state;
+        }
+      }
+    );
+    this.state = this.store.state;
+    this.prevState = this.state;
+    this.options = opts;
+  }
+  #leaseValidateAsync;
+};
+function normalizeError(rawError) {
+  if (rawError) {
+    if (typeof rawError !== "string") {
+      return "Invalid Form Values";
+    }
+    return rawError;
+  }
+  return void 0;
+}
+export {
+  FieldApi
+};
+//# sourceMappingURL=FieldApi.js.map

package/build/modern/FieldApi.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/FieldApi.ts"],"sourcesContent":["import type { DeepKeys, DeepValue, Updater } from './utils'\nimport type { FormApi, ValidationError } from './FormApi'\nimport { Store } from '@tanstack/store'\n\nexport type ValidationCause = 'change' | 'blur' | 'submit'\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  touchedError?: ValidationError\n  error?: ValidationError\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          ...opts.defaultMeta,\n        },\n      },\n      {\n        onUpdate: () => {\n          const state = this.store.state\n\n          state.meta.touchedError = state.meta.isTouched\n            ? state.meta.error\n            : undefined\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      ...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\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\n    if (this.state.meta.error !== error) {\n      this.setMeta((prev) => ({\n        ...prev,\n        error,\n      }))\n    }\n\n    // If a sync error is encountered, cancel any async validation\n    if (this.state.meta.error) {\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\n    if (!validate) return\n\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      try {\n        const rawError = await validate(value as never, this as never)\n\n        if (checkLatest()) {\n          const error = normalizeError(rawError)\n          this.setMeta((prev) => ({\n            ...prev,\n            isValidating: false,\n            error,\n          }))\n          this.getInfo().validationResolve?.(error)\n        }\n      } catch (error) {\n        if (checkLatest()) {\n          this.getInfo().validationReject?.(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\n    // Attempt to sync validate first\n    this.validateSync(value, cause)\n\n    // If there is an error, return it, do not attempt async validation\n    if (this.state.meta.error) {\n      if (!this.options.asyncAlways) {\n        return this.state.meta.error\n      }\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"],"mappings":"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","names":[]}