oxform-core 0.1.0 → 0.1.1

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":["array: any[]","Store","Derived","validate","related: string[]","field","context: FormContextApi<Values>","updated: FormIssue[]","Derived"],"sources":["../src/field-api.constants.ts","../src/utils/get.ts","../src/utils/update.ts","../src/form-array-field-api.ts","../src/utils/validate.ts","../src/form-context-api.ts","../src/form-field-api.ts","../src/form-api.ts","../src/field-api.ts","../src/array-field-api.ts"],"sourcesContent":["import type { PersistedFieldMeta, PersistedFormStatus } from '#form-api.types';\n\nexport const defaultMeta = {\n  blurred: false,\n  touched: false,\n  dirty: false,\n} satisfies PersistedFieldMeta;\n\nexport const defaultStatus = {\n  submits: 0,\n  submitting: false,\n  validating: false,\n  successful: false,\n  dirty: false,\n} satisfies PersistedFormStatus;\n","export const get = (data: unknown, path: (string | number)[]) => {\n  return path.reduce((acc, key) => {\n    if (acc === undefined) return undefined;\n    if (acc === null) return null;\n\n    return (acc as any)[key];\n  }, data);\n};\n","export type UpdaterFn<TInput, TOutput = TInput> = (input: TInput) => TOutput;\nexport type Updater<TInput, TOutput = TInput> = TOutput | UpdaterFn<TInput, TOutput>;\n\nexport function update<TInput, TOutput = TInput>(updater: Updater<TInput, TOutput>, input: TInput): TOutput {\n  return typeof updater === 'function' ? (updater as UpdaterFn<TInput, TOutput>)(input) : updater;\n}\n","import { defaultMeta } from '#field-api.constants';\nimport type { FormApi, FormArrayFields } from '#form-api';\nimport type { FieldChangeOptions } from '#form-api.types';\nimport type { FormContextApi } from '#form-context-api';\nimport type { FormFieldApi } from '#form-field-api';\nimport type { DeepValue, UnwrapOneLevelOfArray } from '#more-types';\nimport { get } from '#utils/get';\nimport { update, type Updater } from '#utils/update';\nimport { stringToPath } from 'remeda';\n\nexport class FormArrayFieldApi<Values> {\n  private context: FormContextApi<Values>;\n  private field: FormFieldApi<Values>;\n\n  constructor({ field, context }: { field: FormFieldApi<Values>; context: FormContextApi<Values> }) {\n    this.context = context;\n    this.field = field;\n  }\n\n  public insert = <const Name extends FormArrayFields<FormApi<Values>>>(\n    name: Name,\n    index: number,\n    value: Updater<UnwrapOneLevelOfArray<DeepValue<Values, Name>>>,\n    options?: FieldChangeOptions,\n  ) => {\n    if (index < 0) index = 0;\n\n    this.field.change(\n      name,\n      current => {\n        const array = (current as any[]) ?? [];\n\n        return [\n          ...array.slice(0, index),\n          ...(Array.from({ length: index - array.length }, () => undefined) as any[]),\n          update(value, current as never),\n          ...array.slice(index),\n        ] as never;\n      },\n      options,\n    );\n\n    this.context.persisted.setState(current => {\n      const fields = { ...current.fields };\n      const value = get(current.values as never, stringToPath(name)) as any[] | undefined;\n      const length = value?.length;\n\n      if (length === undefined) return current;\n\n      for (let i = index; i < length; i++) {\n        const moving = current.fields[`${name}.${i}`];\n        fields[`${name}.${i + 1}`] = moving ?? defaultMeta;\n      }\n\n      fields[`${name}.${index}`] = defaultMeta;\n\n      return {\n        ...current,\n        fields,\n      };\n    });\n  };\n\n  public append = <const Name extends FormArrayFields<FormApi<Values>>>(\n    name: Name,\n    value: UnwrapOneLevelOfArray<DeepValue<Values, Name>>,\n    options?: FieldChangeOptions,\n  ) => {\n    const current = this.field.get(name) as any[];\n    return this.insert(name, current?.length ?? 0, value, options);\n  };\n\n  public prepend = <const Name extends FormArrayFields<FormApi<Values>>>(\n    name: Name,\n    value: UnwrapOneLevelOfArray<DeepValue<Values, Name>>,\n    options?: FieldChangeOptions,\n  ) => {\n    return this.insert(name, 0, value, options);\n  };\n\n  public swap = <const Name extends FormArrayFields<FormApi<Values>>>(\n    name: Name,\n    from: number,\n    to: number,\n    options?: FieldChangeOptions,\n  ) => {\n    const start = from >= 0 ? from : 0;\n    const end = to >= 0 ? to : 0;\n\n    this.field.change(\n      name,\n      current => {\n        const array = (current as any[]) ?? [];\n\n        if (start === end) return array as never; // no-op\n\n        const a = array[start];\n        const b = array[end];\n\n        return [...array.slice(0, start), b, ...array.slice(start + 1, end), a, ...array.slice(end + 1)] as never;\n      },\n      options,\n    );\n\n    this.context.persisted.setState(current => {\n      const fields = { ...current.fields };\n\n      fields[`${name}.${start}`] = current.fields[`${name}.${end}`] ?? defaultMeta;\n      fields[`${name}.${end}`] = current.fields[`${name}.${start}`] ?? defaultMeta;\n\n      return {\n        ...current,\n        fields,\n      };\n    });\n  };\n\n  public move<const Name extends FormArrayFields<FormApi<Values>>>(\n    name: Name,\n    _from: number,\n    _to: number,\n    options?: FieldChangeOptions,\n  ) {\n    const from = Math.max(_from, 0);\n    const to = Math.max(_to, 0);\n    const backwards = from > to;\n\n    this.field.change(\n      name,\n      current => {\n        const array: any[] = current ? [...(current as any[])] : [];\n\n        if (from === to) return array as never;\n\n        const moved = array[from];\n        return array.toSpliced(backwards ? to : to + 1, 0, moved).toSpliced(backwards ? from + 1 : from, 1) as never;\n      },\n      options,\n    );\n\n    this.context.persisted.setState(current => {\n      const fields = { ...current.fields };\n      const value = get(current.values as never, stringToPath(name)) as any[] | undefined;\n      const length = value?.length;\n\n      const start = Math.min(from, to);\n      const end = Math.max(from, to);\n\n      if (length === undefined) return current;\n\n      if (!backwards) {\n        fields[`${name}.${to}`] = current.fields[`${name}.${from}`] ?? defaultMeta;\n      }\n\n      for (let i = backwards ? start + 1 : start; i < end; i++) {\n        const shift = backwards ? -1 : 1;\n        const moving = current.fields[`${name}.${i + shift}`];\n        fields[`${name}.${i}`] = moving ?? defaultMeta;\n      }\n\n      return {\n        ...current,\n        fields,\n      };\n    });\n  }\n\n  public update = <const Name extends FormArrayFields<FormApi<Values>>>(\n    name: Name,\n    index: number,\n    value: Updater<UnwrapOneLevelOfArray<DeepValue<Values, Name>>>,\n    options?: FieldChangeOptions,\n  ) => {\n    this.field.change(\n      name,\n      current => {\n        const array = (current as any[]) ?? [];\n        const position = Math.max(Math.min(index, array.length - 1), 0);\n\n        return [...array.slice(0, position), update(value, current as never), ...array.slice(position + 1)] as never;\n      },\n      options,\n    );\n\n    this.context.resetFieldMeta(`${name}.${index}`);\n    this.context.setFieldMeta(`${name}.${index}`, {\n      dirty: options?.should?.dirty !== false,\n      touched: options?.should?.touch !== false,\n    });\n  };\n\n  public remove<const Name extends FormArrayFields<FormApi<Values>>>(\n    name: Name,\n    index: number,\n    options?: FieldChangeOptions,\n  ) {\n    let position = index;\n\n    this.field.change(\n      name,\n      current => {\n        const array = (current as any[]) ?? [];\n        position = Math.max(Math.min(index, array.length - 1), 0);\n\n        return [...array.slice(0, position), ...array.slice(position + 1)] as never;\n      },\n      { ...options, should: { ...options?.should, validate: false } },\n    );\n\n    this.context.persisted.setState(current => {\n      const fields = { ...current.fields };\n      const value = get(current.values as never, stringToPath(name)) as any[] | undefined;\n      const length = value?.length ?? 0;\n\n      for (let i = position; i < length; i++) {\n        const moving = current.fields[`${name}.${i + 1}`];\n        fields[`${name}.${i}`] = moving ?? defaultMeta;\n      }\n\n      delete fields[`${name}.${length}`];\n\n      return {\n        ...current,\n        fields,\n      };\n    });\n\n    const shouldValidate = options?.should?.validate !== false;\n    if (shouldValidate) void this.context.validate(name, { type: 'change' });\n  }\n\n  public replace<const Name extends FormArrayFields<FormApi<Values>>>(\n    name: Name,\n    value: Updater<DeepValue<Values, Name>>,\n    options?: FieldChangeOptions,\n  ) {\n    this.context.resetFieldMeta(name);\n    this.field.change(name, value as never, options);\n  }\n}\n","import type { StandardSchema } from '#types';\n\nexport const validate = async <Schema extends StandardSchema>(schema: Schema, input: unknown) => {\n  let result = schema['~standard'].validate(input);\n  if (result instanceof Promise) result = await result;\n\n  return result as StandardSchema.Result<StandardSchema.InferOutput<Schema>>;\n};\n","import { defaultMeta, defaultStatus } from '#field-api.constants';\nimport type { FormApi, FormFields } from '#form-api';\nimport type {\n  FieldMeta,\n  FormBaseStore,\n  FormIssue,\n  FormOptions,\n  FormStore,\n  PersistedFieldMeta,\n  PersistedFormStatus,\n  ValidateOptions,\n} from '#form-api.types';\nimport { get } from '#utils/get';\nimport { validate } from '#utils/validate';\nimport { Derived, Store } from '@tanstack/store';\nimport { isDeepEqual, isFunction, mergeDeep, stringToPath } from 'remeda';\n\nexport class FormContextApi<Values> {\n  public options!: FormOptions<Values>;\n  public persisted: Store<FormBaseStore<Values>>;\n  public store!: Derived<FormStore<Values>>;\n\n  constructor(options: FormOptions<Values>) {\n    const values = mergeDeep(options.defaultValues as never, options.values ?? {}) as Values;\n\n    this.options = options;\n\n    this.persisted = new Store<FormBaseStore<Values>>({\n      values,\n      fields: {},\n      refs: {},\n      status: defaultStatus,\n      errors: {},\n    });\n\n    this.store = new Derived<FormStore<Values>>({\n      deps: [this.persisted],\n      fn: ({ currDepVals }) => {\n        const persisted = currDepVals[0] as FormBaseStore<Values>;\n\n        const invalid = Object.values(persisted.errors).some(issues => issues.length > 0);\n        const dirty = Object.values(persisted.fields).some(meta => meta.dirty);\n        const fields = Object.fromEntries(\n          Object.entries(persisted.fields).map(([key, meta]) => {\n            return [key, this.buildFieldMeta(key, meta, persisted.values as Values, persisted.errors)];\n          }),\n        );\n\n        return {\n          ...persisted,\n          fields,\n          status: {\n            ...persisted.status,\n            submitted: persisted.status.submits > 0,\n            valid: !invalid,\n            dirty: persisted.status.dirty || dirty,\n          },\n        };\n      },\n    });\n  }\n\n  public get status() {\n    return this.store.state.status;\n  }\n\n  public get values() {\n    return this.store.state.values;\n  }\n\n  private get validator() {\n    const store = this.store.state;\n    const validate = this.options.validate;\n\n    return {\n      change: isFunction(validate?.change) ? validate.change(store) : validate?.change,\n      submit: isFunction(validate?.submit) ? validate.submit(store) : (validate?.submit ?? this.options.schema),\n      blur: isFunction(validate?.blur) ? validate.blur(store) : validate?.blur,\n      focus: isFunction(validate?.focus) ? validate.focus(store) : validate?.focus,\n    };\n  }\n\n  public buildFieldMeta = (\n    fieldName: string,\n    persistedMeta: PersistedFieldMeta | undefined,\n    values: Values,\n    errors: Record<string, FormIssue[]>,\n  ): FieldMeta => {\n    const path = stringToPath(fieldName);\n    const value = get(values as never, path);\n    const defaultValue = get(this.options.defaultValues, path);\n    const invalid = errors[fieldName]?.length > 0;\n    const baseMeta = persistedMeta ?? defaultMeta;\n\n    return {\n      ...baseMeta,\n      default: isDeepEqual(value, defaultValue),\n      pristine: !baseMeta.dirty,\n      valid: !invalid,\n    } satisfies FieldMeta;\n  };\n\n  public setFieldMeta = (name: string, meta: Partial<PersistedFieldMeta>) => {\n    this.persisted.setState(current => {\n      return {\n        ...current,\n        fields: {\n          ...current.fields,\n          [name]: {\n            ...defaultMeta,\n            ...this.persisted.state.fields[name],\n            ...meta,\n          },\n        },\n      };\n    });\n  };\n\n  public resetFieldMeta = (name: string) => {\n    this.persisted.setState(current => {\n      const fields = { ...current.fields };\n      const all = Object.keys(current.fields);\n      const affected = all.filter(key => key.startsWith(name));\n\n      for (const key of affected) {\n        delete fields[key];\n      }\n\n      return {\n        ...current,\n        fields,\n      };\n    });\n  };\n\n  public recomputeFieldMeta = (name: string) => {\n    this.persisted.setState(current => {\n      const related: string[] = this.options.related?.[name as never] ?? [];\n      const all = Object.keys(current.fields);\n      const affected = all.filter(key => key.startsWith(name) || related.includes(key));\n      const updated = affected.reduce(\n        (acc, key) => {\n          return {\n            ...acc,\n            [key]: this.buildFieldMeta(key, current.fields[key], current.values as Values, current.errors),\n          };\n        },\n        {} as Record<string, FieldMeta>,\n      );\n\n      return {\n        ...current,\n        fields: {\n          ...current.fields,\n          ...updated,\n        },\n      };\n    });\n  };\n\n  public setStatus = (status: Partial<PersistedFormStatus>) => {\n    this.persisted.setState(current => {\n      return {\n        ...current,\n        status: {\n          ...current.status,\n          ...status,\n        },\n      };\n    });\n  };\n\n  public validate = async (\n    field?: FormFields<FormApi<Values>> | FormFields<FormApi<Values>>[],\n    options?: ValidateOptions,\n  ) => {\n    const validator = options?.type ? this.validator[options.type] : this.options.schema;\n\n    if (!validator) return [];\n\n    this.setStatus({ validating: true });\n\n    const { issues: allIssues } = await validate(validator, this.store.state.values);\n\n    if (!allIssues) {\n      this.persisted.setState(current => {\n        return { ...current, errors: {}, status: { ...current.status, validating: false } };\n      });\n\n      return [];\n    }\n\n    const fields = field ? (Array.isArray(field) ? field : [field]) : undefined;\n    const related: string[] = fields?.flatMap(field => this.options.related?.[field as never] ?? []) ?? [];\n    const affected = [...(fields ?? []), ...related];\n\n    const issues = allIssues.filter(issue => {\n      const path = issue.path?.join('.') ?? 'root';\n      return !fields || affected.some(key => path.startsWith(key));\n    });\n\n    const errors = issues.reduce((acc, issue) => {\n      const path = issue.path?.join('.') ?? 'root';\n      return {\n        ...acc,\n        [path]: [...(acc[path] ?? []), issue],\n      };\n    }, {} as any);\n\n    this.persisted.setState(current => {\n      const existing = { ...current.errors };\n\n      for (const key of affected) {\n        delete existing[key];\n      }\n\n      return {\n        ...current,\n        errors: {\n          ...(fields ? existing : {}), // when validating a specific set of fields, keep the existing errors\n          ...errors,\n        },\n      };\n    });\n\n    this.setStatus({ validating: false });\n\n    return issues;\n  };\n}\n","import { defaultMeta } from '#field-api.constants';\nimport type { FormApi, FormFields } from '#form-api';\nimport type { FieldChangeOptions, FormIssue, FormResetFieldOptions, FormSetErrorsOptions } from '#form-api.types';\nimport type { FormContextApi } from '#form-context-api';\nimport type { DeepValue } from '#more-types';\nimport { get } from '#utils/get';\nimport { update, type Updater } from '#utils/update';\nimport { batch } from '@tanstack/store';\nimport { setPath, stringToPath } from 'remeda';\n\nexport class FormFieldApi<Values> {\n  constructor(private context: FormContextApi<Values>) {}\n\n  /**\n   * Changes the value of a specific field with optional control over side effects.\n   * @param name - The name of the field to change\n   * @param value - The new value to set for the field\n   * @param options - Optional configuration for controlling validation, dirty state, and touched state\n   */\n  public change = <const Name extends FormFields<FormApi<Values>>>(\n    name: Name,\n    updater: Updater<DeepValue<Values, Name>>,\n    options?: FieldChangeOptions,\n  ) => {\n    const shouldDirty = options?.should?.dirty !== false;\n    const shouldTouch = options?.should?.touch !== false;\n    const shouldValidate = options?.should?.validate !== false;\n\n    this.context.persisted.setState(current => {\n      const value = get(current.values as never, stringToPath(name)) as DeepValue<Values, Name>;\n\n      const values = setPath(\n        current.values as never,\n        stringToPath(name) as never,\n        update(updater, value) as never,\n      ) as Values;\n\n      return {\n        ...current,\n        values,\n      };\n    });\n\n    if (shouldValidate) void this.context.validate(name, { type: 'change' });\n\n    batch(() => {\n      if (shouldDirty) this.context.setFieldMeta(name, { dirty: true });\n      if (shouldTouch) this.context.setFieldMeta(name, { touched: true });\n    });\n  };\n\n  public focus = <const Name extends FormFields<FormApi<Values>>>(name: Name) => {\n    const ref = this.context.store.state.refs[name as never];\n\n    if (ref) ref.focus();\n\n    this.context.setFieldMeta(name as never, { touched: true });\n    void this.context.validate(name as never, { type: 'focus' });\n  };\n\n  public blur = <const Name extends FormFields<FormApi<Values>>>(name: Name) => {\n    const ref = this.context.store.state.refs[name as never];\n\n    if (ref) ref.blur();\n\n    this.context.setFieldMeta(name as never, { blurred: true });\n    void this.context.validate(name as never, { type: 'blur' });\n  };\n\n  public get = <const Name extends FormFields<FormApi<Values>>>(name: Name) => {\n    return get(this.context.store.state.values as never, stringToPath(name)) as DeepValue<Values, Name>;\n  };\n\n  public meta = <const Name extends FormFields<FormApi<Values>>>(name: Name) => {\n    const meta = this.context.store.state.fields[name];\n\n    if (meta) return meta;\n\n    const updated = this.context.buildFieldMeta(\n      name,\n      undefined,\n      this.context.store.state.values as Values,\n      this.context.store.state.errors,\n    );\n\n    this.context.setFieldMeta(name, updated);\n\n    return updated;\n  };\n\n  public register = <const Name extends FormFields<FormApi<Values>>>(name: Name) => {\n    return (element: HTMLElement | null) => {\n      if (!element) return;\n\n      this.context.persisted.setState(current => {\n        return {\n          ...current,\n          refs: {\n            ...current.refs,\n            [name]: element,\n          },\n        };\n      });\n    };\n  };\n\n  public errors = <const Name extends FormFields<FormApi<Values>>>(name: Name) => {\n    return this.context.store.state.errors[name] ?? [];\n  };\n\n  public setErrors = <const Name extends FormFields<FormApi<Values>>>(\n    name: Name,\n    errors: FormIssue[],\n    options?: FormSetErrorsOptions,\n  ) => {\n    this.context.persisted.setState(current => {\n      const existing = current.errors[name] ?? [];\n      let updated: FormIssue[];\n\n      switch (options?.mode) {\n        case 'append':\n          updated = [...existing, ...errors];\n          break;\n        case 'keep':\n          updated = existing.length > 0 ? existing : errors;\n          break;\n        case 'replace':\n        default:\n          updated = errors;\n          break;\n      }\n\n      return {\n        ...current,\n        errors: {\n          ...current.errors,\n          [name]: updated,\n        },\n      };\n    });\n  };\n\n  public reset = <const Name extends FormFields<FormApi<Values>>>(\n    name: Name,\n    options?: FormResetFieldOptions<DeepValue<Values, Name>>,\n  ) => {\n    const path = stringToPath(name as never);\n    const defaultValue = get(this.context.options.defaultValues, path) as DeepValue<Values, Name>;\n    const value = options?.value ?? defaultValue;\n\n    this.context.persisted.setState(current => {\n      const values = setPath(current.values as never, path as never, value as never);\n      const fields = { ...current.fields };\n      const refs = { ...current.refs };\n      const errors = { ...current.errors };\n\n      if (options?.meta) {\n        const currentMeta = options?.keep?.meta ? (fields[name as string] ?? defaultMeta) : defaultMeta;\n        fields[name as string] = {\n          ...currentMeta,\n          ...options.meta,\n        };\n      } else if (!options?.keep?.meta) delete fields[name as string];\n\n      if (!options?.keep?.refs) delete refs[name as string];\n      if (!options?.keep?.errors) delete errors[name as string];\n\n      return {\n        ...current,\n        values,\n        fields,\n        refs,\n        errors,\n      };\n    });\n  };\n}\n","import { defaultStatus } from '#field-api.constants';\nimport type { FormOptions, FormResetOptions, FormSubmitErrorHandler, FormSubmitSuccessHandler } from '#form-api.types';\nimport { FormArrayFieldApi } from '#form-array-field-api';\nimport { FormContextApi } from '#form-context-api';\nimport { FormFieldApi } from '#form-field-api';\nimport type { DeepKeys, DeepKeysOfType, DeepValue } from '#more-types';\nimport type { ArrayLike, StandardSchema } from '#types';\n\nexport type AnyFormApi = FormApi<any>;\n\nexport type FormValues<Form extends AnyFormApi> = Form extends FormApi<infer Values> ? Values : never;\nexport type FormFields<Form extends AnyFormApi> = DeepKeys<FormValues<Form>>;\nexport type FormArrayFields<Form extends AnyFormApi> = DeepKeysOfType<FormValues<Form>, ArrayLike>;\nexport type FormFieldValue<Form extends AnyFormApi, Name extends FormFields<Form>> = DeepValue<FormValues<Form>, Name>;\n\nexport class FormApi<Values> {\n  private context: FormContextApi<Values>;\n  public field: FormFieldApi<Values>;\n  public array: FormArrayFieldApi<Values>;\n\n  constructor(options: FormOptions<Values>) {\n    // todo: add form id to options\n\n    this.context = new FormContextApi(options);\n    this.field = new FormFieldApi(this.context);\n    this.array = new FormArrayFieldApi({ field: this.field, context: this.context });\n  }\n\n  public '~mount' = () => {\n    const unsubscribe = this.context.store.mount();\n\n    return unsubscribe;\n  };\n\n  public '~update' = (options: FormOptions<Values>) => {\n    this.context.options = options;\n  };\n\n  public store = () => {\n    return this.context.store;\n  };\n\n  public status = () => {\n    return this.context.store.state.status;\n  };\n\n  public values = () => {\n    return this.context.store.state.values;\n  };\n\n  public options = () => {\n    return this.context.options;\n  };\n\n  public get validate() {\n    return this.context.validate;\n  }\n\n  public submit =\n    (\n      onSuccess: FormSubmitSuccessHandler<StandardSchema<Values>>,\n      onError?: FormSubmitErrorHandler<StandardSchema<Values>>,\n    ) =>\n    async () => {\n      this.context.setStatus({ submitting: true, dirty: true });\n\n      const issues = await this.context.validate(undefined, { type: 'submit' });\n      const valid = issues.length === 0;\n\n      if (valid) {\n        await onSuccess(this.context.store.state.values as never, this as never);\n      } else {\n        await onError?.(issues, this as never);\n      }\n\n      this.context.setStatus({\n        submits: this.context.persisted.state.status.submits + 1,\n        submitting: false,\n        successful: valid,\n      });\n    };\n\n  public reset = (options?: FormResetOptions<Values>) => {\n    this.context.persisted.setState(current => {\n      return {\n        values: options?.values ?? this.context.options.defaultValues,\n        fields: options?.keep?.fields ? current.fields : {},\n        refs: options?.keep?.refs ? current.refs : {},\n        errors: options?.keep?.errors ? current.errors : {},\n        status: {\n          ...defaultStatus,\n          ...options?.status,\n        },\n      };\n    });\n  };\n}\n","import { type AnyFormApi, type FormFields, type FormFieldValue } from '#form-api';\nimport type {\n  FieldChangeOptions,\n  FieldMeta,\n  FormIssue,\n  FormResetFieldOptions,\n  FormSetErrorsOptions,\n  ValidateOptions,\n} from '#form-api.types';\nimport { get } from '#utils/get';\nimport type { Updater } from '#utils/update';\nimport { Derived } from '@tanstack/store';\nimport { isDeepEqual, stringToPath } from 'remeda';\n\nexport type FieldOptions<Form extends AnyFormApi, Name extends FormFields<Form>> = {\n  form: Form;\n  name: Name;\n};\n\nexport type FieldState<Value> = {\n  value: Value;\n  defaultValue: Value;\n  meta: FieldMeta;\n  errors: FormIssue[];\n};\n\nexport type AnyFieldApi = FieldApi<any>;\n\nexport class FieldApi<Value> {\n  private _options: FieldOptions<AnyFormApi, string>;\n  private form: AnyFormApi;\n  private _store: Derived<FieldState<Value>>;\n\n  constructor(options: FieldOptions<AnyFormApi, string>) {\n    this._options = options;\n    this.form = options.form;\n\n    this._store = new Derived<FieldState<Value>>({\n      deps: [this.form.store()],\n      fn: ({ prevVal }) => {\n        const previous = prevVal as FieldState<Value> | undefined;\n\n        const value = this.form.field.get(this._options.name as never) as Value;\n        const defaultValue = get(this.form.options().defaultValues as never, stringToPath(this._options.name)) as Value;\n        const meta = this.form.field.meta(this._options.name as never);\n        const errors = this.form.field.errors(this._options.name as never);\n\n        const updated = {\n          value,\n          defaultValue,\n          meta,\n          errors,\n        };\n\n        if (previous && isDeepEqual(previous, updated)) return previous;\n\n        return updated;\n      },\n    });\n  }\n\n  public '~mount' = () => {\n    const unsubscribe = this._store.mount();\n\n    return unsubscribe;\n  };\n\n  public '~update' = (options: FieldOptions<AnyFormApi, string>) => {\n    // ref: https://github.com/TanStack/form/blob/main/packages/form-core/src/FieldApi.ts#L1300\n    this._options = options;\n  };\n\n  public options = () => {\n    return this._options;\n  };\n\n  public store = () => {\n    return this._store;\n  };\n\n  public state = () => {\n    return this._store.state;\n  };\n\n  public focus = () => {\n    return this.form.field.focus(this._options.name);\n  };\n\n  public blur = () => {\n    return this.form.field.blur(this._options.name);\n  };\n\n  /**\n   * Changes the value of this field with optional control over side effects.\n   * @param value - The new value to set for the field\n   * @param options - Optional configuration for controlling validation, dirty state, and touched state\n   */\n  public change = (value: Updater<Value>, options?: FieldChangeOptions) => {\n    return this.form.field.change(this._options.name, value as never, options);\n  };\n\n  public register = () => this.form.field.register(this._options.name);\n\n  /**\n   * Validates this specific field using the specified validation type.\n   * @param options - Optional validation options specifying the validation type ('change' | 'submit' | 'blur' | 'focus')\n   * @returns Promise resolving to an array of validation issues for this field\n   */\n  public validate = (options?: ValidateOptions) => {\n    return this.form.validate(this._options.name, options);\n  };\n\n  /**\n   * Resets this field to its default value and optionally resets metadata and errors.\n   * @param options - Reset options for controlling what gets reset and what gets kept\n   */\n  public reset = (options?: FormResetFieldOptions<Value>) => {\n    return this.form.field.reset(this._options.name, options);\n  };\n\n  /**\n   * Sets validation errors for this specific field.\n   * @param errors - Array of validation errors to set\n   * @param mode - How to handle existing errors: 'replace' (default), 'append', or 'keep'\n   */\n  public setErrors = (errors: FormIssue[], options?: FormSetErrorsOptions) => {\n    return this.form.field.setErrors(this._options.name, errors, options);\n  };\n}\n\nexport const createFieldApi = <Form extends AnyFormApi, const Name extends FormFields<Form>>(\n  options: FieldOptions<Form, Name>,\n) => {\n  type Value = FormFieldValue<Form, Name>;\n\n  return new FieldApi(options) as FieldApi<Value>;\n};\n\n// const schema = z.object({ name: z.string(), nested: z.object({ deep: z.object({ deeper: z.string().array() }) }) });\n// const form = new FormApi({ schema });\n// const field = createFieldApi({ form, name: 'name' });\n","import { FieldApi, type FieldOptions } from '#field-api';\nimport { type AnyFormApi, type FormArrayFields, type FormFieldValue } from '#form-api';\nimport type {\n  FieldChangeOptions,\n  FormIssue,\n  FormResetFieldOptions,\n  FormSetErrorsOptions,\n  ValidateOptions,\n} from '#form-api.types';\nimport type { UnwrapOneLevelOfArray } from '#more-types';\nimport type { ArrayLike } from '#types';\nimport type { Updater } from '#utils/update';\n\nexport type ArrayFieldOptions<Form extends AnyFormApi, Name extends FormArrayFields<Form>> = {\n  form: Form;\n  name: Name;\n};\n\nexport type AnyArrayFieldApi = ArrayFieldApi<any>;\n\nexport class ArrayFieldApi<Value extends ArrayLike> {\n  private field: FieldApi<Value>;\n\n  constructor(options: FieldOptions<AnyFormApi, string>) {\n    this.field = new FieldApi<Value>(options);\n  }\n\n  private get _options() {\n    return this.field.options();\n  }\n\n  public '~mount' = () => {\n    const unsubscribe = this.field.store().mount();\n\n    return unsubscribe;\n  };\n\n  public '~update' = (options: FieldOptions<AnyFormApi, string>) => {\n    this.field['~update'](options);\n  };\n\n  public store = () => {\n    return this.field.store();\n  };\n\n  public state = () => {\n    return this.field.store().state;\n  };\n\n  /**\n   * Appends a new item to the end of the array.\n   * @param value - The value to append to the array\n   * @param options - Optional configuration for controlling validation, dirty state, and touched state\n   */\n  public append = (value: UnwrapOneLevelOfArray<Value>, options?: FieldChangeOptions) => {\n    return this._options.form.array.append(this._options.name as never, value as never, options);\n  };\n\n  /**\n   * Prepends a new item to the beginning of the array.\n   * @param value - The value to prepend to the array\n   * @param options - Optional configuration for controlling validation, dirty state, and touched state\n   */\n  public prepend = (value: UnwrapOneLevelOfArray<Value>, options?: FieldChangeOptions) => {\n    return this._options.form.array.prepend(this._options.name as never, value as never, options);\n  };\n\n  /**\n   * Inserts a new item at the specified index in the array.\n   * @param index - The index at which to insert the value\n   * @param value - The value to insert into the array\n   * @param options - Optional configuration for controlling validation, dirty state, and touched state\n   */\n  public insert = (index: number, value: Updater<UnwrapOneLevelOfArray<Value>>, options?: FieldChangeOptions) => {\n    return this._options.form.array.insert(this._options.name as never, index, value as never, options);\n  };\n\n  /**\n   * Updates an item at the specified index in the array.\n   * @param index - The index of the item to update\n   * @param value - The new value or updater function\n   * @param options - Optional configuration for controlling validation, dirty state, and touched state\n   */\n  public update = (index: number, value: Updater<UnwrapOneLevelOfArray<Value>>, options?: FieldChangeOptions) => {\n    return this._options.form.array.update(this._options.name as never, index, value as never, options);\n  };\n\n  /**\n   * Removes an item at the specified index from the array.\n   * @param index - The index of the item to remove\n   * @param options - Optional configuration for controlling validation, dirty state, and touched state\n   */\n  public remove = (index: number, options?: FieldChangeOptions) => {\n    return this._options.form.array.remove(this._options.name as never, index, options);\n  };\n\n  /**\n   * Swaps two items in the array by their indices.\n   * @param from - The index of the first item\n   * @param to - The index of the second item\n   * @param options - Optional configuration for controlling validation, dirty state, and touched state\n   */\n  public swap = (from: number, to: number, options?: FieldChangeOptions) => {\n    return this._options.form.array.swap(this._options.name as never, from, to, options);\n  };\n\n  /**\n   * Moves an item from one index to another in the array.\n   * @param from - The index of the item to move\n   * @param to - The target index\n   * @param options - Optional configuration for controlling validation, dirty state, and touched state\n   */\n  public move = (from: number, to: number, options?: FieldChangeOptions) => {\n    return this._options.form.array.move(this._options.name as never, from, to, options);\n  };\n\n  /**\n   * Replaces the entire array with a new value.\n   * @param value - The new array value or updater function\n   * @param options - Optional configuration for controlling validation, dirty state, and touched state\n   */\n  public replace = (value: Updater<Value>, options?: FieldChangeOptions) => {\n    return this._options.form.array.replace(this._options.name as never, value as never, options);\n  };\n\n  /**\n   * Validates this specific array field using the specified validation type.\n   * @param options - Optional validation options specifying the validation type ('change' | 'submit' | 'blur' | 'focus')\n   * @returns Promise resolving to an array of validation issues for this field\n   */\n  public validate = (options?: ValidateOptions) => {\n    return this._options.form.validate(this._options.name, options);\n  };\n\n  /**\n   * Resets this array field to its default value and optionally resets metadata and errors.\n   * @param options - Reset options for controlling what gets reset and what gets kept\n   */\n  public reset = (options?: FormResetFieldOptions<Value>) => {\n    return this._options.form.field.reset(this._options.name, options);\n  };\n\n  /**\n   * Sets validation errors for this specific array field.\n   * @param errors - Array of validation errors to set\n   * @param mode - How to handle existing errors: 'replace' (default), 'append', or 'keep'\n   */\n  public setErrors = (errors: FormIssue[], options?: FormSetErrorsOptions) => {\n    return this._options.form.field.setErrors(this._options.name, errors, options);\n  };\n}\n\nexport const createArrayFieldApi = <FormApi extends AnyFormApi, const Name extends FormArrayFields<FormApi>>(\n  options: ArrayFieldOptions<FormApi, Name>,\n) => {\n  return new ArrayFieldApi(options) as ArrayFieldApi<FormFieldValue<FormApi, Name>>;\n};\n"],"mappings":"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"}

package/dist/index.d.cts

@@ -0,0 +1,443 @@
+import * as _standard_schema_spec1 from "@standard-schema/spec";
+import { StandardSchemaV1 } from "@standard-schema/spec";
+import { PartialDeep, Simplify } from "type-fest";
+import * as _tanstack_store0 from "@tanstack/store";
+import { Derived, Store } from "@tanstack/store";
+
+//#region src/more-types.d.ts
+/**
+ * @private
+ */
+type UnwrapOneLevelOfArray<T> = T extends (infer U)[] ? U : T;
+type Narrowable = string | number | bigint | boolean;
+type NarrowRaw<A> = (A extends [] ? [] : never) | (A extends Narrowable ? A : never) | { [K in keyof A]: A[K] extends Function ? A[K] : NarrowRaw<A[K]> };
+type Try<A1, A2, Catch = never> = A1 extends A2 ? A1 : Catch;
+/**
+ * @private
+ */
+type Narrow<A> = Try<A, [], NarrowRaw<A>>;
+interface AnyDeepKeyAndValue<K$1 extends string = string, V extends any = any> {
+  key: K$1;
+  value: V;
+}
+type ArrayAccessor<TParent extends AnyDeepKeyAndValue> = `${TParent['key'] extends never ? '' : TParent['key']}.${number}`;
+interface ArrayDeepKeyAndValue<in out TParent extends AnyDeepKeyAndValue, in out T extends ReadonlyArray<any>> extends AnyDeepKeyAndValue {
+  key: ArrayAccessor<TParent>;
+  value: T[number] | Nullable<TParent['value']>;
+}
+type DeepKeyAndValueArray<TParent extends AnyDeepKeyAndValue, T extends ReadonlyArray<any>, TAcc> = DeepKeysAndValuesImpl<NonNullable<T[number]>, ArrayDeepKeyAndValue<TParent, T>, TAcc | ArrayDeepKeyAndValue<TParent, T>>;
+type TupleAccessor<TParent extends AnyDeepKeyAndValue, TKey extends string> = `${TParent['key'] extends never ? '' : TParent['key']}[${TKey}]`;
+interface TupleDeepKeyAndValue<in out TParent extends AnyDeepKeyAndValue, in out T, in out TKey extends AllTupleKeys<T>> extends AnyDeepKeyAndValue {
+  key: TupleAccessor<TParent, TKey>;
+  value: T[TKey] | Nullable<TParent['value']>;
+}
+type AllTupleKeys<T> = T extends any ? keyof T & `${number}` : never;
+type DeepKeyAndValueTuple<TParent extends AnyDeepKeyAndValue, T extends ReadonlyArray<any>, TAcc, TAllKeys extends AllTupleKeys<T> = AllTupleKeys<T>> = TAllKeys extends any ? DeepKeysAndValuesImpl<NonNullable<T[TAllKeys]>, TupleDeepKeyAndValue<TParent, T, TAllKeys>, TAcc | TupleDeepKeyAndValue<TParent, T, TAllKeys>> : never;
+type AllObjectKeys<T> = T extends any ? keyof T & (string | number) : never;
+type ObjectAccessor<TParent extends AnyDeepKeyAndValue, TKey extends string | number> = TParent['key'] extends never ? `${TKey}` : `${TParent['key']}.${TKey}`;
+type Nullable<T> = T & (undefined | null);
+type ObjectValue<TParent extends AnyDeepKeyAndValue, T, TKey extends AllObjectKeys<T>> = T[TKey] | Nullable<TParent['value']>;
+interface ObjectDeepKeyAndValue<in out TParent extends AnyDeepKeyAndValue, in out T, in out TKey extends AllObjectKeys<T>> extends AnyDeepKeyAndValue {
+  key: ObjectAccessor<TParent, TKey>;
+  value: ObjectValue<TParent, T, TKey>;
+}
+type DeepKeyAndValueObject<TParent extends AnyDeepKeyAndValue, T, TAcc, TAllKeys extends AllObjectKeys<T> = AllObjectKeys<T>> = TAllKeys extends any ? DeepKeysAndValuesImpl<NonNullable<T[TAllKeys]>, ObjectDeepKeyAndValue<TParent, T, TAllKeys>, TAcc | ObjectDeepKeyAndValue<TParent, T, TAllKeys>> : never;
+type UnknownAccessor<TParent extends AnyDeepKeyAndValue> = TParent['key'] extends never ? string : `${TParent['key']}.${string}`;
+interface UnknownDeepKeyAndValue<TParent extends AnyDeepKeyAndValue> extends AnyDeepKeyAndValue {
+  key: UnknownAccessor<TParent>;
+  value: unknown;
+}
+type DeepKeysAndValues<T> = DeepKeysAndValuesImpl<T> extends AnyDeepKeyAndValue ? DeepKeysAndValuesImpl<T> : never;
+type DeepKeysAndValuesImpl<T, TParent extends AnyDeepKeyAndValue = never, TAcc = never> = unknown extends T ? TAcc | UnknownDeepKeyAndValue<TParent> : unknown extends T ? T : T extends string | number | boolean | bigint | Date ? TAcc : T extends ReadonlyArray<any> ? number extends T['length'] ? DeepKeyAndValueArray<TParent, T, TAcc> : DeepKeyAndValueTuple<TParent, T, TAcc> : keyof T extends never ? TAcc | UnknownDeepKeyAndValue<TParent> : T extends object ? DeepKeyAndValueObject<TParent, T, TAcc> : TAcc;
+type DeepRecord<T> = { [TRecord in DeepKeysAndValues<T> as TRecord['key']]: TRecord['value'] };
+/**
+ * The keys of an object or array, deeply nested.
+ */
+type DeepKeys<T> = unknown extends T ? string : DeepKeysAndValues<T>['key'];
+/**
+ * Infer the type of a deeply nested property within an object or an array.
+ */
+type DeepValue<TValue, TAccessor> = unknown extends TValue ? TValue : TAccessor extends DeepKeys<TValue> ? DeepRecord<TValue>[TAccessor] : never;
+/**
+ * The keys of an object or array, deeply nested and only with a value of TValue
+ */
+type DeepKeysOfType<TData, TValue> = Extract<DeepKeysAndValues<TData>, AnyDeepKeyAndValue<string, TValue>>['key'];
+/**
+ * Maps the deep keys of TFormData to the shallow keys of TFieldGroupData.
+ *  Since using template strings as keys is impractical, it relies on shallow keys only.
+ */
+type FieldsMap<TFormData, TFieldGroupData> = TFieldGroupData extends any[] ? never : string extends keyof TFieldGroupData ? never : { [K in keyof TFieldGroupData]: DeepKeysOfType<TFormData, TFieldGroupData[K]> };
+//#endregion
+//#region src/types.d.ts
+type EventLike = {
+  target?: {
+    value: any;
+  };
+};
+type ArrayLike = any[] | undefined | null;
+//#endregion
+//#region src/form-api.types.d.ts
+type PersistedFormStatus = {
+  submits: number;
+  submitting: boolean;
+  validating: boolean;
+  successful: boolean;
+  dirty: boolean;
+};
+type FormStatus = Simplify<PersistedFormStatus & {
+  submitted: boolean;
+  valid: boolean;
+}>;
+type PersistedFieldMeta = {
+  blurred: boolean;
+  touched: boolean;
+  dirty: boolean;
+};
+type FieldMeta = Simplify<PersistedFieldMeta & {
+  touched: boolean;
+  default: boolean;
+  valid: boolean;
+  pristine: boolean;
+}>;
+type FormBaseStore<Values> = {
+  values: Values;
+  fields: Record<string, PersistedFieldMeta>;
+  refs: Record<string, HTMLElement | null>;
+  status: PersistedFormStatus;
+  errors: Record<string, FormIssue[]>;
+};
+type FormStore<Values> = {
+  values: Values;
+  fields: Record<string, FieldMeta>;
+  refs: Record<string, HTMLElement | null>;
+  status: FormStatus;
+  errors: Record<string, FormIssue[]>;
+};
+type FieldControl<Value> = {
+  focus: () => void;
+  blur: () => void;
+  change: (value: Value) => void;
+  register: (element: HTMLElement | null) => void;
+};
+type FormValidatorSchema<Values> = StandardSchemaV1<PartialDeep<Values>>;
+type FormValidatorFunction<Values> = (store: FormStore<Values>) => FormValidatorSchema<Values>;
+type FormValidator<Values> = FormValidatorSchema<Values> | FormValidatorFunction<Values>;
+type FormOptions<Values> = {
+  schema: StandardSchemaV1<Values>;
+  values?: Values;
+  defaultValues: Values;
+  validate?: {
+    change?: FormValidator<Values>;
+    submit?: FormValidator<Values>;
+    blur?: FormValidator<Values>;
+    focus?: FormValidator<Values>;
+  };
+  related?: Record<DeepKeys<Values>, DeepKeys<Values>[]>;
+};
+type FormIssue = StandardSchemaV1.Issue;
+type ValidationType = 'change' | 'submit' | 'blur' | 'focus';
+type ValidateOptions = {
+  type?: ValidationType;
+};
+type FieldChangeOptions = {
+  should?: {
+    /** Whether to validate the field after changing its value. Defaults to true. */
+    validate?: boolean;
+    /** Whether to mark the field as dirty after changing its value. Defaults to true. */
+    dirty?: boolean;
+    /** Whether to mark the field as touched after changing its value. Defaults to true. */
+    touch?: boolean;
+  };
+};
+type FieldResetMeta = {
+  blurred?: boolean;
+  touched?: boolean;
+  dirty?: boolean;
+};
+type FieldResetKeepOptions = {
+  errors?: boolean;
+  refs?: boolean;
+  meta?: boolean;
+};
+type FormResetFieldOptions<Value> = {
+  value?: Value;
+  meta?: FieldResetMeta;
+  keep?: FieldResetKeepOptions;
+};
+type FormResetKeepOptions = {
+  /** Keep current field errors */
+  errors?: boolean;
+  /** Keep current references to html input elements */
+  refs?: boolean;
+  /** Keep current field metadata */
+  fields?: boolean;
+};
+type FormResetOptions<Values> = {
+  values?: Values;
+  status?: Partial<PersistedFormStatus>;
+  keep?: FormResetKeepOptions;
+};
+type FieldSetErrorsMode = 'replace' | 'append' | 'keep';
+type FormSetErrorsOptions = {
+  mode?: FieldSetErrorsMode;
+};
+type FormSubmitSuccessHandler<Schema extends StandardSchemaV1> = (data: StandardSchemaV1.InferOutput<Schema>, form: FormApi<Schema>) => void | Promise<void>;
+type FormSubmitErrorHandler<Schema extends StandardSchemaV1> = (issues: FormIssue[], form: FormApi<Schema>) => void | Promise<void>;
+type FormSubmitHandlers<Schema extends StandardSchemaV1> = {
+  onSuccess: FormSubmitSuccessHandler<Schema>;
+  onError?: FormSubmitErrorHandler<Schema>;
+};
+//#endregion
+//#region src/form-context-api.d.ts
+declare class FormContextApi<Values> {
+  options: FormOptions<Values>;
+  persisted: Store<FormBaseStore<Values>>;
+  store: Derived<FormStore<Values>>;
+  constructor(options: FormOptions<Values>);
+  get status(): {
+    submits: number;
+    submitting: boolean;
+    validating: boolean;
+    successful: boolean;
+    dirty: boolean;
+    submitted: boolean;
+    valid: boolean;
+  };
+  get values(): Values;
+  private get validator();
+  buildFieldMeta: (fieldName: string, persistedMeta: PersistedFieldMeta | undefined, values: Values, errors: Record<string, FormIssue[]>) => FieldMeta;
+  setFieldMeta: (name: string, meta: Partial<PersistedFieldMeta>) => void;
+  resetFieldMeta: (name: string) => void;
+  recomputeFieldMeta: (name: string) => void;
+  setStatus: (status: Partial<PersistedFormStatus>) => void;
+  validate: (field?: FormFields<FormApi<Values>> | FormFields<FormApi<Values>>[], options?: ValidateOptions) => Promise<_standard_schema_spec1.StandardSchemaV1.Issue[]>;
+}
+//#endregion
+//#region src/utils/update.d.ts
+type UpdaterFn<TInput, TOutput = TInput> = (input: TInput) => TOutput;
+type Updater<TInput, TOutput = TInput> = TOutput | UpdaterFn<TInput, TOutput>;
+//#endregion
+//#region src/form-field-api.d.ts
+declare class FormFieldApi<Values> {
+  private context;
+  constructor(context: FormContextApi<Values>);
+  /**
+   * Changes the value of a specific field with optional control over side effects.
+   * @param name - The name of the field to change
+   * @param value - The new value to set for the field
+   * @param options - Optional configuration for controlling validation, dirty state, and touched state
+   */
+  change: <const Name extends FormFields<FormApi<Values>>>(name: Name, updater: Updater<DeepValue<Values, Name>>, options?: FieldChangeOptions) => void;
+  focus: <const Name extends FormFields<FormApi<Values>>>(name: Name) => void;
+  blur: <const Name extends FormFields<FormApi<Values>>>(name: Name) => void;
+  get: <const Name extends FormFields<FormApi<Values>>>(name: Name) => DeepValue<Values, Name>;
+  meta: <const Name extends FormFields<FormApi<Values>>>(name: Name) => {
+    blurred: boolean;
+    touched: boolean;
+    dirty: boolean;
+    default: boolean;
+    valid: boolean;
+    pristine: boolean;
+  };
+  register: <const Name extends FormFields<FormApi<Values>>>(name: Name) => (element: HTMLElement | null) => void;
+  errors: <const Name extends FormFields<FormApi<Values>>>(name: Name) => _standard_schema_spec1.StandardSchemaV1.Issue[];
+  setErrors: <const Name extends FormFields<FormApi<Values>>>(name: Name, errors: FormIssue[], options?: FormSetErrorsOptions) => void;
+  reset: <const Name extends FormFields<FormApi<Values>>>(name: Name, options?: FormResetFieldOptions<DeepValue<Values, Name>>) => void;
+}
+//#endregion
+//#region src/form-array-field-api.d.ts
+declare class FormArrayFieldApi<Values> {
+  private context;
+  private field;
+  constructor({
+    field,
+    context
+  }: {
+    field: FormFieldApi<Values>;
+    context: FormContextApi<Values>;
+  });
+  insert: <const Name extends FormArrayFields<FormApi<Values>>>(name: Name, index: number, value: Updater<UnwrapOneLevelOfArray<DeepValue<Values, Name>>>, options?: FieldChangeOptions) => void;
+  append: <const Name extends FormArrayFields<FormApi<Values>>>(name: Name, value: UnwrapOneLevelOfArray<DeepValue<Values, Name>>, options?: FieldChangeOptions) => void;
+  prepend: <const Name extends FormArrayFields<FormApi<Values>>>(name: Name, value: UnwrapOneLevelOfArray<DeepValue<Values, Name>>, options?: FieldChangeOptions) => void;
+  swap: <const Name extends FormArrayFields<FormApi<Values>>>(name: Name, from: number, to: number, options?: FieldChangeOptions) => void;
+  move<const Name extends FormArrayFields<FormApi<Values>>>(name: Name, _from: number, _to: number, options?: FieldChangeOptions): void;
+  update: <const Name extends FormArrayFields<FormApi<Values>>>(name: Name, index: number, value: Updater<UnwrapOneLevelOfArray<DeepValue<Values, Name>>>, options?: FieldChangeOptions) => void;
+  remove<const Name extends FormArrayFields<FormApi<Values>>>(name: Name, index: number, options?: FieldChangeOptions): void;
+  replace<const Name extends FormArrayFields<FormApi<Values>>>(name: Name, value: Updater<DeepValue<Values, Name>>, options?: FieldChangeOptions): void;
+}
+//#endregion
+//#region src/form-api.d.ts
+type AnyFormApi = FormApi<any>;
+type FormValues<Form extends AnyFormApi> = Form extends FormApi<infer Values> ? Values : never;
+type FormFields<Form extends AnyFormApi> = DeepKeys<FormValues<Form>>;
+type FormArrayFields<Form extends AnyFormApi> = DeepKeysOfType<FormValues<Form>, ArrayLike>;
+type FormFieldValue<Form extends AnyFormApi, Name extends FormFields<Form>> = DeepValue<FormValues<Form>, Name>;
+declare class FormApi<Values> {
+  private context;
+  field: FormFieldApi<Values>;
+  array: FormArrayFieldApi<Values>;
+  constructor(options: FormOptions<Values>);
+  '~mount': () => () => void;
+  '~update': (options: FormOptions<Values>) => void;
+  store: () => _tanstack_store0.Derived<FormStore<Values>, readonly any[]>;
+  status: () => {
+    submits: number;
+    submitting: boolean;
+    validating: boolean;
+    successful: boolean;
+    dirty: boolean;
+    submitted: boolean;
+    valid: boolean;
+  };
+  values: () => Values;
+  options: () => FormOptions<Values>;
+  get validate(): (field?: DeepKeys<Values> | DeepKeys<Values>[] | undefined, options?: ValidateOptions) => Promise<StandardSchemaV1.Issue[]>;
+  submit: (onSuccess: FormSubmitSuccessHandler<StandardSchemaV1<Values>>, onError?: FormSubmitErrorHandler<StandardSchemaV1<Values>>) => () => Promise<void>;
+  reset: (options?: FormResetOptions<Values>) => void;
+}
+//#endregion
+//#region src/field-api.d.ts
+type FieldOptions<Form extends AnyFormApi, Name extends FormFields<Form>> = {
+  form: Form;
+  name: Name;
+};
+type FieldState<Value> = {
+  value: Value;
+  defaultValue: Value;
+  meta: FieldMeta;
+  errors: FormIssue[];
+};
+type AnyFieldApi = FieldApi<any>;
+declare class FieldApi<Value> {
+  private _options;
+  private form;
+  private _store;
+  constructor(options: FieldOptions<AnyFormApi, string>);
+  '~mount': () => () => void;
+  '~update': (options: FieldOptions<AnyFormApi, string>) => void;
+  options: () => FieldOptions<AnyFormApi, string>;
+  store: () => Derived<FieldState<Value>, readonly any[]>;
+  state: () => FieldState<Value>;
+  focus: () => void;
+  blur: () => void;
+  /**
+   * Changes the value of this field with optional control over side effects.
+   * @param value - The new value to set for the field
+   * @param options - Optional configuration for controlling validation, dirty state, and touched state
+   */
+  change: (value: Updater<Value>, options?: FieldChangeOptions) => void;
+  register: () => (element: HTMLElement | null) => void;
+  /**
+   * Validates this specific field using the specified validation type.
+   * @param options - Optional validation options specifying the validation type ('change' | 'submit' | 'blur' | 'focus')
+   * @returns Promise resolving to an array of validation issues for this field
+   */
+  validate: (options?: ValidateOptions) => Promise<_standard_schema_spec1.StandardSchemaV1.Issue[]>;
+  /**
+   * Resets this field to its default value and optionally resets metadata and errors.
+   * @param options - Reset options for controlling what gets reset and what gets kept
+   */
+  reset: (options?: FormResetFieldOptions<Value>) => void;
+  /**
+   * Sets validation errors for this specific field.
+   * @param errors - Array of validation errors to set
+   * @param mode - How to handle existing errors: 'replace' (default), 'append', or 'keep'
+   */
+  setErrors: (errors: FormIssue[], options?: FormSetErrorsOptions) => void;
+}
+declare const createFieldApi: <Form extends AnyFormApi, const Name extends FormFields<Form>>(options: FieldOptions<Form, Name>) => FieldApi<FormFieldValue<Form, Name>>;
+//#endregion
+//#region src/array-field-api.d.ts
+type ArrayFieldOptions<Form extends AnyFormApi, Name extends FormArrayFields<Form>> = {
+  form: Form;
+  name: Name;
+};
+type AnyArrayFieldApi = ArrayFieldApi<any>;
+declare class ArrayFieldApi<Value extends ArrayLike> {
+  private field;
+  constructor(options: FieldOptions<AnyFormApi, string>);
+  private get _options();
+  '~mount': () => () => void;
+  '~update': (options: FieldOptions<AnyFormApi, string>) => void;
+  store: () => _tanstack_store0.Derived<FieldState<Value>, readonly any[]>;
+  state: () => FieldState<Value>;
+  /**
+   * Appends a new item to the end of the array.
+   * @param value - The value to append to the array
+   * @param options - Optional configuration for controlling validation, dirty state, and touched state
+   */
+  append: (value: UnwrapOneLevelOfArray<Value>, options?: FieldChangeOptions) => void;
+  /**
+   * Prepends a new item to the beginning of the array.
+   * @param value - The value to prepend to the array
+   * @param options - Optional configuration for controlling validation, dirty state, and touched state
+   */
+  prepend: (value: UnwrapOneLevelOfArray<Value>, options?: FieldChangeOptions) => void;
+  /**
+   * Inserts a new item at the specified index in the array.
+   * @param index - The index at which to insert the value
+   * @param value - The value to insert into the array
+   * @param options - Optional configuration for controlling validation, dirty state, and touched state
+   */
+  insert: (index: number, value: Updater<UnwrapOneLevelOfArray<Value>>, options?: FieldChangeOptions) => void;
+  /**
+   * Updates an item at the specified index in the array.
+   * @param index - The index of the item to update
+   * @param value - The new value or updater function
+   * @param options - Optional configuration for controlling validation, dirty state, and touched state
+   */
+  update: (index: number, value: Updater<UnwrapOneLevelOfArray<Value>>, options?: FieldChangeOptions) => void;
+  /**
+   * Removes an item at the specified index from the array.
+   * @param index - The index of the item to remove
+   * @param options - Optional configuration for controlling validation, dirty state, and touched state
+   */
+  remove: (index: number, options?: FieldChangeOptions) => void;
+  /**
+   * Swaps two items in the array by their indices.
+   * @param from - The index of the first item
+   * @param to - The index of the second item
+   * @param options - Optional configuration for controlling validation, dirty state, and touched state
+   */
+  swap: (from: number, to: number, options?: FieldChangeOptions) => void;
+  /**
+   * Moves an item from one index to another in the array.
+   * @param from - The index of the item to move
+   * @param to - The target index
+   * @param options - Optional configuration for controlling validation, dirty state, and touched state
+   */
+  move: (from: number, to: number, options?: FieldChangeOptions) => void;
+  /**
+   * Replaces the entire array with a new value.
+   * @param value - The new array value or updater function
+   * @param options - Optional configuration for controlling validation, dirty state, and touched state
+   */
+  replace: (value: Updater<Value>, options?: FieldChangeOptions) => void;
+  /**
+   * Validates this specific array field using the specified validation type.
+   * @param options - Optional validation options specifying the validation type ('change' | 'submit' | 'blur' | 'focus')
+   * @returns Promise resolving to an array of validation issues for this field
+   */
+  validate: (options?: ValidateOptions) => Promise<StandardSchemaV1.Issue[]>;
+  /**
+   * Resets this array field to its default value and optionally resets metadata and errors.
+   * @param options - Reset options for controlling what gets reset and what gets kept
+   */
+  reset: (options?: FormResetFieldOptions<Value>) => void;
+  /**
+   * Sets validation errors for this specific array field.
+   * @param errors - Array of validation errors to set
+   * @param mode - How to handle existing errors: 'replace' (default), 'append', or 'keep'
+   */
+  setErrors: (errors: FormIssue[], options?: FormSetErrorsOptions) => void;
+}
+declare const createArrayFieldApi: <FormApi$1 extends AnyFormApi, const Name extends FormArrayFields<FormApi$1>>(options: ArrayFieldOptions<FormApi$1, Name>) => ArrayFieldApi<FormFieldValue<FormApi$1, Name>>;
+//#endregion
+//#region src/types/any-form-like-api.d.ts
+type AnyFormLikeApi = AnyFormApi | AnyArrayFieldApi | AnyFieldApi;
+//#endregion
+//#region src/types/api-selector.d.ts
+type ApiSelector<Api extends AnyFormLikeApi, Selected> = (state: ReturnType<Api['store']>['state']) => Selected;
+//#endregion
+export { AllObjectKeys, AllTupleKeys, type AnyArrayFieldApi, AnyDeepKeyAndValue, type AnyFieldApi, type AnyFormApi, type AnyFormLikeApi, type ApiSelector, ArrayAccessor, ArrayDeepKeyAndValue, ArrayFieldApi, type ArrayFieldOptions, type ArrayLike, DeepKeyAndValueArray, DeepKeyAndValueObject, DeepKeyAndValueTuple, DeepKeys, DeepKeysAndValues, DeepKeysAndValuesImpl, DeepKeysOfType, DeepRecord, DeepValue, type EventLike, FieldApi, FieldChangeOptions, FieldControl, FieldMeta, type FieldOptions, FieldResetKeepOptions, FieldResetMeta, FieldSetErrorsMode, type FieldState, FieldsMap, FormApi, type FormArrayFields, FormBaseStore, type FormFieldValue, type FormFields, FormIssue, FormOptions, FormResetFieldOptions, FormResetKeepOptions, FormResetOptions, FormSetErrorsOptions, FormStatus, FormStore, FormSubmitErrorHandler, FormSubmitHandlers, FormSubmitSuccessHandler, type FormValues, Narrow, Nullable, ObjectAccessor, ObjectDeepKeyAndValue, ObjectValue, PersistedFieldMeta, PersistedFormStatus, type Simplify, type StandardSchemaV1 as StandardSchema, TupleAccessor, TupleDeepKeyAndValue, UnknownAccessor, UnknownDeepKeyAndValue, UnwrapOneLevelOfArray, ValidateOptions, ValidationType, createArrayFieldApi, createFieldApi };
+//# sourceMappingURL=index.d.cts.map