@tanstack/form-core 0.10.2 → 0.11.0

package/build/modern/index.d.ts

@@ -1,49 +1,114 @@
 import { Store } from '@tanstack/store';
-import { DeepKeys, DeepValue, Updater } from './utils.js';
-export { Narrow, Pretty, RequiredByKey, UpdaterFn, deleteBy, functionalUpdate, getBy, isNonEmptyArray, setBy } from './utils.js';
-import { ValidationError, Validator } from './types.js';
+import { ValidationCause, Validator, ValidationError, ValidationErrorMapKeys, ValidationErrorMap } from './types.js';
 
-type ValidateFn$1<TData, ValidatorType> = (values: TData, formApi: FormApi<TData, ValidatorType>) => ValidationError;
-type ValidateOrFn$1<TData, ValidatorType> = ValidatorType extends Validator<TData> ? Parameters<ReturnType<ValidatorType>['validate']>[1] : ValidateFn$1<TData, ValidatorType>;
-type ValidateAsyncFn$1<TData, ValidatorType> = (value: TData, fieldApi: FormApi<TData, ValidatorType>) => ValidationError | Promise<ValidationError>;
-type FormOptions<TData, ValidatorType> = {
-    defaultValues?: TData;
-    defaultState?: Partial<FormState<TData>>;
-    asyncAlways?: boolean;
+type UpdaterFn<TInput, TOutput = TInput> = (input: TInput) => TOutput;
+type Updater<TInput, TOutput = TInput> = TOutput | UpdaterFn<TInput, TOutput>;
+declare function functionalUpdate<TInput, TOutput = TInput>(updater: Updater<TInput, TOutput>, input: TInput): TOutput;
+/**
+ * Get a value from an object using a path, including dot notation.
+ */
+declare function getBy(obj: any, path: any): any;
+/**
+ * Set a value on an object using a path, including dot notation.
+ */
+declare function setBy(obj: any, _path: any, updater: Updater<any>): any;
+/**
+ * Delete a field on an object using a path, including dot notation.
+ */
+declare function deleteBy(obj: any, _path: any): any;
+declare function isNonEmptyArray(obj: any): boolean;
+interface AsyncValidatorArrayPartialOptions<T> {
+    validators?: T;
     asyncDebounceMs?: number;
-    validator?: ValidatorType;
-    onMount?: ValidateOrFn$1<TData, ValidatorType>;
-    onChange?: ValidateOrFn$1<TData, ValidatorType>;
-    onChangeAsync?: ValidateAsyncFn$1<TData, ValidatorType>;
+}
+interface AsyncValidator<T> {
+    cause: ValidationCause;
+    validate: T;
+    debounceMs: number;
+}
+declare function getAsyncValidatorArray<T>(cause: ValidationCause, options: AsyncValidatorArrayPartialOptions<T>): T extends FieldValidators<any, any> ? Array<AsyncValidator<T['onChangeAsync'] | T['onBlurAsync'] | T['onSubmitAsync']>> : T extends FormValidators<any, any> ? Array<AsyncValidator<T['onChangeAsync'] | T['onBlurAsync'] | T['onSubmitAsync']>> : never;
+interface SyncValidatorArrayPartialOptions<T> {
+    validators?: T;
+}
+interface SyncValidator<T> {
+    cause: ValidationCause;
+    validate: T;
+}
+declare function getSyncValidatorArray<T>(cause: ValidationCause, options: SyncValidatorArrayPartialOptions<T>): T extends FieldValidators<any, any> ? Array<SyncValidator<T['onChange'] | T['onBlur'] | T['onSubmit']>> : T extends FormValidators<any, any> ? Array<SyncValidator<T['onChange'] | T['onBlur'] | T['onSubmit']>> : never;
+type RequiredByKey<T, K extends keyof T> = Omit<T, K> & Required<Pick<T, K>>;
+type ComputeRange<N extends number, Result extends Array<unknown> = []> = Result['length'] extends N ? Result : ComputeRange<N, [...Result, Result['length']]>;
+type Index40 = ComputeRange<40>[number];
+type IsTuple<T> = T extends readonly any[] & {
+    length: infer Length;
+} ? Length extends Index40 ? T : never : never;
+type AllowedIndexes<Tuple extends ReadonlyArray<any>, Keys extends number = never> = Tuple extends readonly [] ? Keys : Tuple extends readonly [infer _, ...infer Tail] ? AllowedIndexes<Tail, Keys | Tail['length']> : Keys;
+type DeepKeys<T, TDepth extends any[] = []> = TDepth['length'] extends 5 ? never : unknown extends T ? string : object extends T ? string : T extends readonly any[] & IsTuple<T> ? AllowedIndexes<T> | DeepKeysPrefix<T, AllowedIndexes<T>, TDepth> : T extends any[] ? DeepKeys<T[number], [...TDepth, any]> : T extends Date ? never : T extends object ? (keyof T & string) | DeepKeysPrefix<T, keyof T, TDepth> : never;
+type DeepKeysPrefix<T, TPrefix, TDepth extends any[]> = TPrefix extends keyof T & (number | string) ? `${TPrefix}.${DeepKeys<T[TPrefix], [...TDepth, any]> & string}` : never;
+type DeepValue<T, TProp> = T extends Record<string | number, any> ? TProp extends `${infer TBranch}.${infer TDeepProp}` ? DeepValue<T[TBranch], TDeepProp> : T[TProp & string] : never;
+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 Narrow<A> = Try<A, [], NarrowRaw<A>>;
+type Try<A1, A2, Catch = never> = A1 extends A2 ? A1 : Catch;
+type Pretty<T> = {
+    [K in keyof T]: T[K];
+} & {};
+
+type FormValidateFn<TFormData, TFormValidator extends Validator<TFormData, unknown> | undefined = undefined> = (props: {
+    value: TFormData;
+    formApi: FormApi<TFormData, TFormValidator>;
+}) => ValidationError;
+type FormValidateOrFn<TFormData, TFormValidator extends Validator<TFormData, unknown> | undefined = undefined> = TFormValidator extends Validator<TFormData, infer TFN> ? TFN : FormValidateFn<TFormData, TFormValidator>;
+type FormValidateAsyncFn<TFormData, TFormValidator extends Validator<TFormData, unknown> | undefined = undefined> = (props: {
+    value: TFormData;
+    formApi: FormApi<TFormData, TFormValidator>;
+    signal: AbortSignal;
+}) => ValidationError | Promise<ValidationError>;
+type FormAsyncValidateOrFn<TFormData, TFormValidator extends Validator<TFormData, unknown> | undefined = undefined> = TFormValidator extends Validator<TFormData, infer FFN> ? FFN | FormValidateAsyncFn<TFormData, TFormValidator> : FormValidateAsyncFn<TFormData, TFormValidator>;
+interface FormValidators<TFormData, TFormValidator extends Validator<TFormData, unknown> | undefined = undefined> {
+    onMount?: FormValidateOrFn<TFormData, TFormValidator>;
+    onChange?: FormValidateOrFn<TFormData, TFormValidator>;
+    onChangeAsync?: FormAsyncValidateOrFn<TFormData, TFormValidator>;
     onChangeAsyncDebounceMs?: number;
-    onBlur?: ValidateOrFn$1<TData, ValidatorType>;
-    onBlurAsync?: ValidateAsyncFn$1<TData, ValidatorType>;
+    onBlur?: FormValidateOrFn<TFormData, TFormValidator>;
+    onBlurAsync?: FormAsyncValidateOrFn<TFormData, TFormValidator>;
     onBlurAsyncDebounceMs?: number;
-    onSubmit?: (values: TData, formApi: FormApi<TData, ValidatorType>) => any | Promise<any>;
-    onSubmitInvalid?: (values: TData, formApi: FormApi<TData, ValidatorType>) => void;
+    onSubmit?: FormValidateOrFn<TFormData, TFormValidator>;
+    onSubmitAsync?: FormAsyncValidateOrFn<TFormData, TFormValidator>;
+    onSubmitAsyncDebounceMs?: number;
+}
+type FormOptions<TFormData, TFormValidator extends Validator<TFormData, unknown> | undefined = undefined> = {
+    defaultValues?: TFormData;
+    defaultState?: Partial<FormState<TFormData>>;
+    asyncAlways?: boolean;
+    asyncDebounceMs?: number;
+    validatorAdapter?: TFormValidator;
+    validators?: FormValidators<TFormData, TFormValidator>;
+    onSubmit?: (props: {
+        value: TFormData;
+        formApi: FormApi<TFormData, TFormValidator>;
+    }) => any | Promise<any>;
+    onSubmitInvalid?: (props: {
+        value: TFormData;
+        formApi: FormApi<TFormData, TFormValidator>;
+    }) => void;
 };
-type FieldInfo<TFormData, ValidatorType> = {
-    instances: Record<string, FieldApi<TFormData, any, unknown, ValidatorType>>;
-} & ValidationMeta;
 type ValidationMeta = {
-    validationCount?: number;
-    validationAsyncCount?: number;
-    validationPromise?: Promise<ValidationError[] | undefined>;
-    validationResolve?: (errors: ValidationError[] | undefined) => void;
-    validationReject?: (errors: unknown) => void;
+    lastAbortController: AbortController;
 };
-type ValidationErrorMapKeys = `on${Capitalize<ValidationCause>}`;
-type ValidationErrorMap = {
-    [K in ValidationErrorMapKeys]?: ValidationError;
+type FieldInfo<TFormData, TFormValidator extends Validator<TFormData, unknown> | undefined = undefined> = {
+    instances: Record<string, FieldApi<TFormData, any, Validator<unknown, unknown> | undefined, TFormValidator>>;
+    validationMetaMap: Record<ValidationErrorMapKeys, ValidationMeta | undefined>;
 };
-type FormState<TData> = {
-    values: TData;
+type FormState<TFormData> = {
+    values: TFormData;
     isFormValidating: boolean;
-    formValidationCount: number;
     isFormValid: boolean;
     errors: ValidationError[];
     errorMap: ValidationErrorMap;
-    fieldMeta: Record<DeepKeys<TData>, FieldMeta>;
+    validationMetaMap: Record<ValidationErrorMapKeys, ValidationMeta | undefined>;
+    fieldMeta: Record<DeepKeys<TFormData>, FieldMeta>;
     isFieldsValidating: boolean;
     isFieldsValid: boolean;
     isSubmitting: boolean;
@@ -54,27 +119,33 @@ type FormState<TData> = {
     canSubmit: boolean;
     submissionAttempts: number;
 };
-declare class FormApi<TFormData, ValidatorType> {
-    options: FormOptions<TFormData, ValidatorType>;
+declare class FormApi<TFormData, TFormValidator extends Validator<TFormData, unknown> | undefined = undefined> {
+    options: FormOptions<TFormData, TFormValidator>;
     store: Store<FormState<TFormData>>;
     state: FormState<TFormData>;
-    fieldInfo: Record<DeepKeys<TFormData>, FieldInfo<TFormData, ValidatorType>>;
-    fieldName?: string;
-    validationMeta: ValidationMeta;
-    constructor(opts?: FormOptions<TFormData, ValidatorType>);
+    fieldInfo: Record<DeepKeys<TFormData>, FieldInfo<TFormData, TFormValidator>>;
+    constructor(opts?: FormOptions<TFormData, TFormValidator>);
+    runValidator<TValue extends {
+        value: TFormData;
+        formApi: FormApi<any, any>;
+    }, TType extends 'validate' | 'validateAsync'>(props: {
+        validate: TType extends 'validate' ? FormValidateOrFn<TFormData, TFormValidator> : FormAsyncValidateOrFn<TFormData, TFormValidator>;
+        value: TValue;
+        type: TType;
+    }): ReturnType<ReturnType<Validator<any>>[TType]>;
     mount: () => void;
-    update: (options?: FormOptions<TFormData, ValidatorType>) => void;
+    update: (options?: FormOptions<TFormData, TFormValidator>) => void;
     reset: () => void;
-    validateAllFields: (cause: ValidationCause) => Promise<ValidationError[][]>;
-    validateSync: (cause: ValidationCause) => void;
-    __leaseValidateAsync: () => number;
-    cancelValidateAsync: () => void;
+    validateAllFields: (cause: ValidationCause) => Promise<ValidationError[]>;
+    validateSync: (cause: ValidationCause) => {
+        hasErrored: boolean;
+    };
     validateAsync: (cause: ValidationCause) => Promise<ValidationError[]>;
     validate: (cause: ValidationCause) => ValidationError[] | Promise<ValidationError[]>;
     handleSubmit: () => Promise<void>;
     getFieldValue: <TField extends DeepKeys<TFormData>>(field: TField) => DeepValue<TFormData, TField>;
     getFieldMeta: <TField extends DeepKeys<TFormData>>(field: TField) => FieldMeta | undefined;
-    getFieldInfo: <TField extends DeepKeys<TFormData>>(field: TField) => FieldInfo<TFormData, ValidatorType>;
+    getFieldInfo: <TField extends DeepKeys<TFormData>>(field: TField) => FieldInfo<TFormData, TFormValidator>;
     setFieldMeta: <TField extends DeepKeys<TFormData>>(field: TField, updater: Updater<FieldMeta>) => void;
     setFieldValue: <TField extends DeepKeys<TFormData>>(field: TField, updater: Updater<DeepValue<TFormData, TField>>, opts?: {
         touch?: boolean;
@@ -92,32 +163,42 @@ declare class FormApi<TFormData, ValidatorType> {
     swapFieldValues: <TField extends DeepKeys<TFormData>>(field: TField, index1: number, index2: number) => void;
 }
 
-type ValidationCause = 'change' | 'blur' | 'submit' | 'mount';
-type ValidateFn<TParentData, TName extends DeepKeys<TParentData>, ValidatorType, TData extends DeepValue<TParentData, TName> = DeepValue<TParentData, TName>> = (value: TData, fieldApi: FieldApi<TParentData, TName, ValidatorType, TData>) => ValidationError;
-type ValidateOrFn<TParentData, TName extends DeepKeys<TParentData>, ValidatorType, FormValidator, TData extends DeepValue<TParentData, TName> = DeepValue<TParentData, TName>> = ValidatorType extends Validator<TData> ? Parameters<ReturnType<ValidatorType>['validate']>[1] | ValidateFn<TParentData, TName, ValidatorType, TData> : FormValidator extends Validator<TData> ? Parameters<ReturnType<FormValidator>['validate']>[1] | ValidateFn<TParentData, TName, ValidatorType, TData> : ValidateFn<TParentData, TName, ValidatorType, TData>;
-type ValidateAsyncFn<TParentData, TName extends DeepKeys<TParentData>, ValidatorType, TData extends DeepValue<TParentData, TName> = DeepValue<TParentData, TName>> = (value: TData, fieldApi: FieldApi<TParentData, TName, ValidatorType, TData>) => ValidationError | Promise<ValidationError>;
-type AsyncValidateOrFn<TParentData, TName extends DeepKeys<TParentData>, ValidatorType, FormValidator, TData extends DeepValue<TParentData, TName> = DeepValue<TParentData, TName>> = ValidatorType extends Validator<TData> ? Parameters<ReturnType<ValidatorType>['validate']>[1] | ValidateAsyncFn<TParentData, TName, ValidatorType, TData> : FormValidator extends Validator<TData> ? Parameters<ReturnType<FormValidator>['validate']>[1] | ValidateAsyncFn<TParentData, TName, ValidatorType, TData> : ValidateAsyncFn<TParentData, TName, ValidatorType, TData>;
-interface FieldOptions<TParentData, TName extends DeepKeys<TParentData>, ValidatorType, FormValidator, TData extends DeepValue<TParentData, TName> = DeepValue<TParentData, TName>> {
+type FieldValidateFn<TParentData, TName extends DeepKeys<TParentData>, TFieldValidator extends Validator<DeepValue<TParentData, TName>, unknown> | undefined = undefined, TFormValidator extends Validator<TParentData, unknown> | undefined = undefined, TData extends DeepValue<TParentData, TName> = DeepValue<TParentData, TName>> = (props: {
+    value: TData;
+    fieldApi: FieldApi<TParentData, TName, TFieldValidator, TFormValidator, TData>;
+}) => ValidationError;
+type FieldValidateOrFn<TParentData, TName extends DeepKeys<TParentData>, TFieldValidator extends Validator<DeepValue<TParentData, TName>, unknown> | undefined = undefined, TFormValidator extends Validator<TParentData, unknown> | undefined = undefined, TData extends DeepValue<TParentData, TName> = DeepValue<TParentData, TName>> = TFieldValidator extends Validator<TData, infer TFN> ? TFN | FieldValidateFn<TParentData, TName, TFieldValidator, TFormValidator, TData> : TFormValidator extends Validator<TParentData, infer FFN> ? FFN | FieldValidateFn<TParentData, TName, TFieldValidator, TFormValidator, TData> : FieldValidateFn<TParentData, TName, TFieldValidator, TFormValidator, TData>;
+type FieldValidateAsyncFn<TParentData, TName extends DeepKeys<TParentData>, TFieldValidator extends Validator<DeepValue<TParentData, TName>, unknown> | undefined = undefined, TFormValidator extends Validator<TParentData, unknown> | undefined = undefined, TData extends DeepValue<TParentData, TName> = DeepValue<TParentData, TName>> = (options: {
+    value: TData;
+    fieldApi: FieldApi<TParentData, TName, TFieldValidator, TFormValidator, TData>;
+    signal: AbortSignal;
+}) => ValidationError | Promise<ValidationError>;
+type FieldAsyncValidateOrFn<TParentData, TName extends DeepKeys<TParentData>, TFieldValidator extends Validator<DeepValue<TParentData, TName>, unknown> | undefined = undefined, TFormValidator extends Validator<TParentData, unknown> | undefined = undefined, TData extends DeepValue<TParentData, TName> = DeepValue<TParentData, TName>> = TFieldValidator extends Validator<TData, infer TFN> ? TFN | FieldValidateAsyncFn<TParentData, TName, TFieldValidator, TFormValidator, TData> : TFormValidator extends Validator<TParentData, infer FFN> ? FFN | FieldValidateAsyncFn<TParentData, TName, TFieldValidator, TFormValidator, TData> : FieldValidateAsyncFn<TParentData, TName, TFieldValidator, TFormValidator, TData>;
+interface FieldValidators<TParentData, TName extends DeepKeys<TParentData>, TFieldValidator extends Validator<DeepValue<TParentData, TName>, unknown> | undefined = undefined, TFormValidator extends Validator<TParentData, unknown> | undefined = undefined, TData extends DeepValue<TParentData, TName> = DeepValue<TParentData, TName>> {
+    onMount?: FieldValidateOrFn<TParentData, TName, TFieldValidator, TFormValidator, TData>;
+    onChange?: FieldValidateOrFn<TParentData, TName, TFieldValidator, TFormValidator, TData>;
+    onChangeAsync?: FieldAsyncValidateOrFn<TParentData, TName, TFieldValidator, TFormValidator, TData>;
+    onChangeAsyncDebounceMs?: number;
+    onBlur?: FieldValidateOrFn<TParentData, TName, TFieldValidator, TFormValidator, TData>;
+    onBlurAsync?: FieldAsyncValidateOrFn<TParentData, TName, TFieldValidator, TFormValidator, TData>;
+    onBlurAsyncDebounceMs?: number;
+    onSubmit?: FieldValidateOrFn<TParentData, TName, TFieldValidator, TFormValidator, TData>;
+    onSubmitAsync?: FieldAsyncValidateOrFn<TParentData, TName, TFieldValidator, TFormValidator, TData>;
+    onSubmitAsyncDebounceMs?: number;
+}
+interface FieldOptions<TParentData, TName extends DeepKeys<TParentData>, TFieldValidator extends Validator<DeepValue<TParentData, TName>, unknown> | undefined = undefined, TFormValidator extends Validator<TParentData, unknown> | undefined = undefined, TData extends DeepValue<TParentData, TName> = DeepValue<TParentData, TName>> {
     name: TName;
     index?: TData extends any[] ? number : never;
     defaultValue?: TData;
     asyncDebounceMs?: number;
     asyncAlways?: boolean;
     preserveValue?: boolean;
-    validator?: ValidatorType;
-    onMount?: (formApi: FieldApi<TParentData, TName, ValidatorType, TData>) => void;
-    onChange?: ValidateOrFn<TParentData, TName, ValidatorType, FormValidator, TData>;
-    onChangeAsync?: AsyncValidateOrFn<TParentData, TName, ValidatorType, FormValidator, TData>;
-    onChangeAsyncDebounceMs?: number;
-    onBlur?: ValidateOrFn<TParentData, TName, ValidatorType, FormValidator, TData>;
-    onBlurAsync?: AsyncValidateOrFn<TParentData, TName, ValidatorType, FormValidator, TData>;
-    onBlurAsyncDebounceMs?: number;
-    onSubmit?: ValidateOrFn<TParentData, TName, ValidatorType, FormValidator, TData>;
-    onSubmitAsync?: AsyncValidateOrFn<TParentData, TName, ValidatorType, FormValidator, TData>;
+    validatorAdapter?: TFieldValidator;
+    validators?: FieldValidators<TParentData, TName, TFieldValidator, TFormValidator, TData>;
     defaultMeta?: Partial<FieldMeta>;
 }
-interface FieldApiOptions<TParentData, TName extends DeepKeys<TParentData>, ValidatorType, FormValidator, TData extends DeepValue<TParentData, TName> = DeepValue<TParentData, TName>> extends FieldOptions<TParentData, TName, ValidatorType, FormValidator, TData> {
-    form: FormApi<TParentData, FormValidator>;
+interface FieldApiOptions<TParentData, TName extends DeepKeys<TParentData>, TFieldValidator extends Validator<DeepValue<TParentData, TName>, unknown> | undefined = undefined, TFormValidator extends Validator<TParentData, unknown> | undefined = undefined, TData extends DeepValue<TParentData, TName> = DeepValue<TParentData, TName>> extends FieldOptions<TParentData, TName, TFieldValidator, TFormValidator, TData> {
+    form: FormApi<TParentData, TFormValidator>;
 }
 type FieldMeta = {
     isTouched: boolean;
@@ -131,17 +212,25 @@ type FieldState<TData> = {
     meta: FieldMeta;
 };
 type ResolveName<TParentData> = unknown extends TParentData ? string : DeepKeys<TParentData>;
-declare class FieldApi<TParentData, TName extends DeepKeys<TParentData>, ValidatorType, FormValidator, TData extends DeepValue<TParentData, TName> = DeepValue<TParentData, TName>> {
+declare class FieldApi<TParentData, TName extends DeepKeys<TParentData>, TFieldValidator extends Validator<DeepValue<TParentData, TName>, unknown> | undefined = undefined, TFormValidator extends Validator<TParentData, unknown> | undefined = undefined, TData extends DeepValue<TParentData, TName> = DeepValue<TParentData, TName>> {
     uid: number;
-    form: FieldApiOptions<TParentData, TName, ValidatorType, TData>['form'];
+    form: FieldApiOptions<TParentData, TName, TFieldValidator, TFormValidator, TData>['form'];
     name: DeepKeys<TParentData>;
-    options: FieldApiOptions<TParentData, TName, ValidatorType, TData>;
+    options: FieldApiOptions<TParentData, TName, TFieldValidator, TFormValidator, TData>;
     store: Store<FieldState<TData>>;
     state: FieldState<TData>;
     prevState: FieldState<TData>;
-    constructor(opts: FieldApiOptions<TParentData, TName, ValidatorType, FormValidator, TData>);
+    constructor(opts: FieldApiOptions<TParentData, TName, TFieldValidator, TFormValidator, TData>);
+    runValidator<TValue extends {
+        value: TData;
+        fieldApi: FieldApi<any, any, any, any>;
+    }, TType extends 'validate' | 'validateAsync'>(props: {
+        validate: TType extends 'validate' ? FieldValidateOrFn<any, any, any, any> : FieldAsyncValidateOrFn<any, any, any, any>;
+        value: TValue;
+        type: TType;
+    }): ReturnType<ReturnType<Validator<any>>[TType]>;
     mount: () => () => void;
-    update: (opts: FieldApiOptions<TParentData, TName, ValidatorType, TData>) => void;
+    update: (opts: FieldApiOptions<TParentData, TName, TFieldValidator, TFormValidator, TData>) => void;
     getValue: () => TData;
     setValue: (updater: Updater<TData>, options?: {
         touch?: boolean;
@@ -150,19 +239,19 @@ declare class FieldApi<TParentData, TName extends DeepKeys<TParentData>, Validat
     _getMeta: () => FieldMeta | undefined;
     getMeta: () => FieldMeta;
     setMeta: (updater: Updater<FieldMeta>) => void;
-    getInfo: () => FieldInfo<TParentData, TData>;
+    getInfo: () => FieldInfo<TParentData, TFormValidator>;
     pushValue: (value: TData extends any[] ? TData[number] : never) => void;
     insertValue: (index: number, value: TData extends any[] ? TData[number] : never) => void;
     removeValue: (index: number) => void;
     swapValues: (aIndex: number, bIndex: number) => void;
-    getSubField: <TSubName extends DeepKeys<TData>, TSubData extends DeepValue<TData, TSubName> = DeepValue<TData, TSubName>>(name: TSubName) => FieldApi<TData, TSubName, ValidatorType, TSubData, DeepValue<TData, TSubName>>;
-    validateSync: (value: TData | undefined, cause: ValidationCause) => void;
-    __leaseValidateAsync: () => number;
-    cancelValidateAsync: () => void;
+    getSubField: <TSubName extends DeepKeys<TData>, TSubData extends DeepValue<TData, TSubName> = DeepValue<TData, TSubName>>(name: TSubName) => FieldApi<TData, TSubName, Validator<TSubData, unknown> | undefined, Validator<TData, unknown> | undefined, TSubData>;
+    validateSync: (value: TData | undefined, cause: ValidationCause) => {
+        hasErrored: boolean;
+    };
     validateAsync: (value: TData | undefined, cause: ValidationCause) => Promise<ValidationError[]>;
     validate: (cause: ValidationCause, value?: TData) => ValidationError[] | Promise<ValidationError[]>;
     handleChange: (updater: Updater<TData>) => void;
     handleBlur: () => void;
 }
 
-export { DeepKeys, DeepValue, FieldApi, FieldApiOptions, FieldInfo, FieldMeta, FieldOptions, FieldState, FormApi, FormOptions, FormState, ResolveName, Updater, ValidationCause, ValidationError, ValidationErrorMap, ValidationErrorMapKeys, ValidationMeta, Validator };
+export { DeepKeys, DeepValue, FieldApi, FieldApiOptions, FieldAsyncValidateOrFn, FieldInfo, FieldMeta, FieldOptions, FieldState, FieldValidateAsyncFn, FieldValidateFn, FieldValidateOrFn, FieldValidators, FormApi, FormAsyncValidateOrFn, FormOptions, FormState, FormValidateAsyncFn, FormValidateFn, FormValidateOrFn, FormValidators, Narrow, Pretty, RequiredByKey, ResolveName, Updater, UpdaterFn, ValidationCause, ValidationError, ValidationErrorMap, ValidationErrorMapKeys, ValidationMeta, Validator, deleteBy, functionalUpdate, getAsyncValidatorArray, getBy, getSyncValidatorArray, isNonEmptyArray, setBy };

package/build/modern/types.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/types.ts"],"sourcesContent":["export type ValidationError = undefined | false | null | string\n\n// If/when TypeScript supports higher-kinded types, this should not be `unknown` anymore\nexport type Validator<Type, Fn = unknown> = () => {\n  validate(value: Type, fn: Fn): ValidationError\n  validateAsync(value: Type, fn: Fn): Promise<ValidationError>\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAAA;AAAA;","names":[]}
+{"version":3,"sources":["../../src/types.ts"],"sourcesContent":["export type ValidationError = undefined | false | null | string\n\n// If/when TypeScript supports higher-kinded types, this should not be `unknown` anymore\nexport type Validator<Type, Fn = unknown> = () => {\n  validate(options: { value: Type }, fn: Fn): ValidationError\n  validateAsync(options: { value: Type }, fn: Fn): Promise<ValidationError>\n}\n\nexport type ValidationCause = 'change' | 'blur' | 'submit' | 'mount'\n\nexport type ValidationErrorMapKeys = `on${Capitalize<ValidationCause>}`\n\nexport type ValidationErrorMap = {\n  [K in ValidationErrorMapKeys]?: ValidationError\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAAA;AAAA;","names":[]}

package/build/modern/types.d.cts

@@ -1,7 +1,16 @@
 type ValidationError = undefined | false | null | string;
 type Validator<Type, Fn = unknown> = () => {
-    validate(value: Type, fn: Fn): ValidationError;
-    validateAsync(value: Type, fn: Fn): Promise<ValidationError>;
+    validate(options: {
+        value: Type;
+    }, fn: Fn): ValidationError;
+    validateAsync(options: {
+        value: Type;
+    }, fn: Fn): Promise<ValidationError>;
+};
+type ValidationCause = 'change' | 'blur' | 'submit' | 'mount';
+type ValidationErrorMapKeys = `on${Capitalize<ValidationCause>}`;
+type ValidationErrorMap = {
+    [K in ValidationErrorMapKeys]?: ValidationError;
 };
 
-export { ValidationError, Validator };
+export { ValidationCause, ValidationError, ValidationErrorMap, ValidationErrorMapKeys, Validator };

package/build/modern/types.d.ts

@@ -1,7 +1,16 @@
 type ValidationError = undefined | false | null | string;
 type Validator<Type, Fn = unknown> = () => {
-    validate(value: Type, fn: Fn): ValidationError;
-    validateAsync(value: Type, fn: Fn): Promise<ValidationError>;
+    validate(options: {
+        value: Type;
+    }, fn: Fn): ValidationError;
+    validateAsync(options: {
+        value: Type;
+    }, fn: Fn): Promise<ValidationError>;
+};
+type ValidationCause = 'change' | 'blur' | 'submit' | 'mount';
+type ValidationErrorMapKeys = `on${Capitalize<ValidationCause>}`;
+type ValidationErrorMap = {
+    [K in ValidationErrorMapKeys]?: ValidationError;
 };
 
-export { ValidationError, Validator };
+export { ValidationCause, ValidationError, ValidationErrorMap, ValidationErrorMapKeys, Validator };

package/build/modern/utils.cjs

@@ -22,7 +22,9 @@ var utils_exports = {};
 __export(utils_exports, {
   deleteBy: () => deleteBy,
   functionalUpdate: () => functionalUpdate,
+  getAsyncValidatorArray: () => getAsyncValidatorArray,
   getBy: () => getBy,
+  getSyncValidatorArray: () => getSyncValidatorArray,
   isNonEmptyArray: () => isNonEmptyArray,
   setBy: () => setBy
 });
@@ -121,11 +123,64 @@ function makePathArray(str) {
 function isNonEmptyArray(obj) {
   return !(Array.isArray(obj) && obj.length === 0);
 }
+function getAsyncValidatorArray(cause, options) {
+  const { asyncDebounceMs } = options;
+  const {
+    onChangeAsync,
+    onBlurAsync,
+    onSubmitAsync,
+    onBlurAsyncDebounceMs,
+    onChangeAsyncDebounceMs,
+    onSubmitAsyncDebounceMs
+  } = options.validators || {};
+  const defaultDebounceMs = asyncDebounceMs ?? 0;
+  const changeValidator = {
+    cause: "change",
+    validate: onChangeAsync,
+    debounceMs: onChangeAsyncDebounceMs ?? defaultDebounceMs
+  };
+  const blurValidator = {
+    cause: "blur",
+    validate: onBlurAsync,
+    debounceMs: onBlurAsyncDebounceMs ?? defaultDebounceMs
+  };
+  const submitValidator = {
+    cause: "submit",
+    validate: onSubmitAsync,
+    debounceMs: onSubmitAsyncDebounceMs ?? defaultDebounceMs
+  };
+  switch (cause) {
+    case "submit":
+      return [changeValidator, blurValidator, submitValidator];
+    case "blur":
+      return [blurValidator];
+    case "change":
+    default:
+      return [changeValidator];
+  }
+}
+function getSyncValidatorArray(cause, options) {
+  const { onChange, onBlur, onSubmit } = options.validators || {};
+  const changeValidator = { cause: "change", validate: onChange };
+  const blurValidator = { cause: "blur", validate: onBlur };
+  const submitValidator = { cause: "submit", validate: onSubmit };
+  switch (cause) {
+    case "submit":
+      return [changeValidator, blurValidator, submitValidator];
+    case "blur":
+      return [blurValidator];
+    case "change":
+    default:
+      return [changeValidator];
+  }
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   deleteBy,
   functionalUpdate,
+  getAsyncValidatorArray,
   getBy,
+  getSyncValidatorArray,
   isNonEmptyArray,
   setBy
 });

package/build/modern/utils.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/utils.ts"],"sourcesContent":["export type UpdaterFn<TInput, TOutput = TInput> = (input: TInput) => TOutput\n\nexport type Updater<TInput, TOutput = TInput> =\n  | TOutput\n  | UpdaterFn<TInput, TOutput>\n\nexport function functionalUpdate<TInput, TOutput = TInput>(\n  updater: Updater<TInput, TOutput>,\n  input: TInput,\n): TOutput {\n  return typeof updater === 'function'\n    ? (updater as UpdaterFn<TInput, TOutput>)(input)\n    : updater\n}\n\n/**\n * Get a value from an object using a path, including dot notation.\n */\nexport function getBy(obj: any, path: any) {\n  const pathObj = makePathArray(path)\n  return pathObj.reduce((current: any, pathPart: any) => {\n    if (typeof current !== 'undefined') {\n      return current[pathPart]\n    }\n    return undefined\n  }, obj)\n}\n\n/**\n * Set a value on an object using a path, including dot notation.\n */\nexport function setBy(obj: any, _path: any, updater: Updater<any>) {\n  const path = makePathArray(_path)\n\n  function doSet(parent?: any): any {\n    if (!path.length) {\n      return functionalUpdate(updater, parent)\n    }\n\n    const key = path.shift()\n\n    if (typeof key === 'string') {\n      if (typeof parent === 'object') {\n        return {\n          ...parent,\n          [key]: doSet(parent[key]),\n        }\n      }\n      return {\n        [key]: doSet(),\n      }\n    }\n\n    if (Array.isArray(parent) && key !== undefined) {\n      const prefix = parent.slice(0, key)\n      return [\n        ...(prefix.length ? prefix : new Array(key)),\n        doSet(parent[key]),\n        ...parent.slice(key + 1),\n      ]\n    }\n    return [...new Array(key), doSet()]\n  }\n\n  return doSet(obj)\n}\n\n/**\n * Delete a field on an object using a path, including dot notation.\n */\nexport function deleteBy(obj: any, _path: any) {\n  const path = makePathArray(_path)\n\n  function doDelete(parent: any): any {\n    if (path.length === 1) {\n      const finalPath = path[0]!\n      const { [finalPath]: remove, ...rest } = parent\n      return rest\n    }\n\n    const key = path.shift()\n\n    if (typeof key === 'string') {\n      if (typeof parent === 'object') {\n        return {\n          ...parent,\n          [key]: doDelete(parent[key]),\n        }\n      }\n    }\n\n    if (typeof key === 'number') {\n      if (Array.isArray(parent)) {\n        const prefix = parent.slice(0, key)\n        return [\n          ...(prefix.length ? prefix : new Array(key)),\n          doDelete(parent[key]),\n          ...parent.slice(key + 1),\n        ]\n      }\n    }\n\n    throw new Error('It seems we have created an infinite loop in deleteBy. ')\n  }\n\n  return doDelete(obj)\n}\n\nconst reFindNumbers0 = /^(\\d*)$/gm\nconst reFindNumbers1 = /\\.(\\d*)\\./gm\nconst reFindNumbers2 = /^(\\d*)\\./gm\nconst reFindNumbers3 = /\\.(\\d*$)/gm\nconst reFindMultiplePeriods = /\\.{2,}/gm\n\nconst intPrefix = '__int__'\nconst intReplace = `${intPrefix}$1`\n\nfunction makePathArray(str: string) {\n  if (typeof str !== 'string') {\n    throw new Error('Path must be a string.')\n  }\n\n  return str\n    .replace('[', '.')\n    .replace(']', '')\n    .replace(reFindNumbers0, intReplace)\n    .replace(reFindNumbers1, `.${intReplace}.`)\n    .replace(reFindNumbers2, `${intReplace}.`)\n    .replace(reFindNumbers3, `.${intReplace}`)\n    .replace(reFindMultiplePeriods, '.')\n    .split('.')\n    .map((d) => {\n      if (d.indexOf(intPrefix) === 0) {\n        return parseInt(d.substring(intPrefix.length), 10)\n      }\n      return d\n    })\n}\n\nexport function isNonEmptyArray(obj: any) {\n  return !(Array.isArray(obj) && obj.length === 0)\n}\n\nexport type RequiredByKey<T, K extends keyof T> = Omit<T, K> &\n  Required<Pick<T, K>>\n\ntype ComputeRange<\n  N extends number,\n  Result extends Array<unknown> = [],\n> = Result['length'] extends N\n  ? Result\n  : ComputeRange<N, [...Result, Result['length']]>\ntype Index40 = ComputeRange<40>[number]\n\n// Is this type a tuple?\ntype IsTuple<T> = T extends readonly any[] & { length: infer Length }\n  ? Length extends Index40\n    ? T\n    : never\n  : never\n\n// If this type is a tuple, what indices are allowed?\ntype AllowedIndexes<\n  Tuple extends ReadonlyArray<any>,\n  Keys extends number = never,\n> = Tuple extends readonly []\n  ? Keys\n  : Tuple extends readonly [infer _, ...infer Tail]\n  ? AllowedIndexes<Tail, Keys | Tail['length']>\n  : Keys\n\nexport type DeepKeys<T, TDepth extends any[] = []> = TDepth['length'] extends 5\n  ? never\n  : unknown extends T\n  ? string\n  : object extends T\n  ? string\n  : T extends readonly any[] & IsTuple<T>\n  ? AllowedIndexes<T> | DeepKeysPrefix<T, AllowedIndexes<T>, TDepth>\n  : T extends any[]\n  ? DeepKeys<T[number], [...TDepth, any]>\n  : T extends Date\n  ? never\n  : T extends object\n  ? (keyof T & string) | DeepKeysPrefix<T, keyof T, TDepth>\n  : never\n\ntype DeepKeysPrefix<\n  T,\n  TPrefix,\n  TDepth extends any[],\n> = TPrefix extends keyof T & (number | string)\n  ? `${TPrefix}.${DeepKeys<T[TPrefix], [...TDepth, any]> & string}`\n  : never\n\nexport type DeepValue<T, TProp> = T extends Record<string | number, any>\n  ? TProp extends `${infer TBranch}.${infer TDeepProp}`\n    ? DeepValue<T[TBranch], TDeepProp>\n    : T[TProp & string]\n  : never\n\ntype Narrowable = string | number | bigint | boolean\n\ntype NarrowRaw<A> =\n  | (A extends [] ? [] : never)\n  | (A extends Narrowable ? A : never)\n  | {\n      [K in keyof A]: A[K] extends Function ? A[K] : NarrowRaw<A[K]>\n    }\n\nexport type Narrow<A> = Try<A, [], NarrowRaw<A>>\n\ntype Try<A1, A2, Catch = never> = A1 extends A2 ? A1 : Catch\n\n// Hack to get TypeScript to show simplified types in error messages\nexport type Pretty<T> = { [K in keyof T]: T[K] } & {}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/utils.ts"],"sourcesContent":["import type { ValidationCause, Validator } from './types'\nimport type { FormValidators } from './FormApi'\nimport type { FieldValidators } from './FieldApi'\n\nexport type UpdaterFn<TInput, TOutput = TInput> = (input: TInput) => TOutput\n\nexport type Updater<TInput, TOutput = TInput> =\n  | TOutput\n  | UpdaterFn<TInput, TOutput>\n\nexport function functionalUpdate<TInput, TOutput = TInput>(\n  updater: Updater<TInput, TOutput>,\n  input: TInput,\n): TOutput {\n  return typeof updater === 'function'\n    ? (updater as UpdaterFn<TInput, TOutput>)(input)\n    : updater\n}\n\n/**\n * Get a value from an object using a path, including dot notation.\n */\nexport function getBy(obj: any, path: any) {\n  const pathObj = makePathArray(path)\n  return pathObj.reduce((current: any, pathPart: any) => {\n    if (typeof current !== 'undefined') {\n      return current[pathPart]\n    }\n    return undefined\n  }, obj)\n}\n\n/**\n * Set a value on an object using a path, including dot notation.\n */\nexport function setBy(obj: any, _path: any, updater: Updater<any>) {\n  const path = makePathArray(_path)\n\n  function doSet(parent?: any): any {\n    if (!path.length) {\n      return functionalUpdate(updater, parent)\n    }\n\n    const key = path.shift()\n\n    if (typeof key === 'string') {\n      if (typeof parent === 'object') {\n        return {\n          ...parent,\n          [key]: doSet(parent[key]),\n        }\n      }\n      return {\n        [key]: doSet(),\n      }\n    }\n\n    if (Array.isArray(parent) && key !== undefined) {\n      const prefix = parent.slice(0, key)\n      return [\n        ...(prefix.length ? prefix : new Array(key)),\n        doSet(parent[key]),\n        ...parent.slice(key + 1),\n      ]\n    }\n    return [...new Array(key), doSet()]\n  }\n\n  return doSet(obj)\n}\n\n/**\n * Delete a field on an object using a path, including dot notation.\n */\nexport function deleteBy(obj: any, _path: any) {\n  const path = makePathArray(_path)\n\n  function doDelete(parent: any): any {\n    if (path.length === 1) {\n      const finalPath = path[0]!\n      const { [finalPath]: remove, ...rest } = parent\n      return rest\n    }\n\n    const key = path.shift()\n\n    if (typeof key === 'string') {\n      if (typeof parent === 'object') {\n        return {\n          ...parent,\n          [key]: doDelete(parent[key]),\n        }\n      }\n    }\n\n    if (typeof key === 'number') {\n      if (Array.isArray(parent)) {\n        const prefix = parent.slice(0, key)\n        return [\n          ...(prefix.length ? prefix : new Array(key)),\n          doDelete(parent[key]),\n          ...parent.slice(key + 1),\n        ]\n      }\n    }\n\n    throw new Error('It seems we have created an infinite loop in deleteBy. ')\n  }\n\n  return doDelete(obj)\n}\n\nconst reFindNumbers0 = /^(\\d*)$/gm\nconst reFindNumbers1 = /\\.(\\d*)\\./gm\nconst reFindNumbers2 = /^(\\d*)\\./gm\nconst reFindNumbers3 = /\\.(\\d*$)/gm\nconst reFindMultiplePeriods = /\\.{2,}/gm\n\nconst intPrefix = '__int__'\nconst intReplace = `${intPrefix}$1`\n\nfunction makePathArray(str: string) {\n  if (typeof str !== 'string') {\n    throw new Error('Path must be a string.')\n  }\n\n  return str\n    .replace('[', '.')\n    .replace(']', '')\n    .replace(reFindNumbers0, intReplace)\n    .replace(reFindNumbers1, `.${intReplace}.`)\n    .replace(reFindNumbers2, `${intReplace}.`)\n    .replace(reFindNumbers3, `.${intReplace}`)\n    .replace(reFindMultiplePeriods, '.')\n    .split('.')\n    .map((d) => {\n      if (d.indexOf(intPrefix) === 0) {\n        return parseInt(d.substring(intPrefix.length), 10)\n      }\n      return d\n    })\n}\n\nexport function isNonEmptyArray(obj: any) {\n  return !(Array.isArray(obj) && obj.length === 0)\n}\n\ninterface AsyncValidatorArrayPartialOptions<T> {\n  validators?: T\n  asyncDebounceMs?: number\n}\n\ninterface AsyncValidator<T> {\n  cause: ValidationCause\n  validate: T\n  debounceMs: number\n}\n\nexport function getAsyncValidatorArray<T>(\n  cause: ValidationCause,\n  options: AsyncValidatorArrayPartialOptions<T>,\n): T extends FieldValidators<any, any>\n  ? Array<\n      AsyncValidator<T['onChangeAsync'] | T['onBlurAsync'] | T['onSubmitAsync']>\n    >\n  : T extends FormValidators<any, any>\n  ? Array<\n      AsyncValidator<T['onChangeAsync'] | T['onBlurAsync'] | T['onSubmitAsync']>\n    >\n  : never {\n  const { asyncDebounceMs } = options\n  const {\n    onChangeAsync,\n    onBlurAsync,\n    onSubmitAsync,\n    onBlurAsyncDebounceMs,\n    onChangeAsyncDebounceMs,\n    onSubmitAsyncDebounceMs,\n  } = (options.validators || {}) as\n    | FieldValidators<any, any>\n    | FormValidators<any, any>\n\n  const defaultDebounceMs = asyncDebounceMs ?? 0\n\n  const changeValidator = {\n    cause: 'change',\n    validate: onChangeAsync,\n    debounceMs: onChangeAsyncDebounceMs ?? defaultDebounceMs,\n  } as const\n\n  const blurValidator = {\n    cause: 'blur',\n    validate: onBlurAsync,\n    debounceMs: onBlurAsyncDebounceMs ?? defaultDebounceMs,\n  } as const\n\n  const submitValidator = {\n    cause: 'submit',\n    validate: onSubmitAsync,\n    debounceMs: onSubmitAsyncDebounceMs ?? defaultDebounceMs,\n  } as const\n\n  switch (cause) {\n    case 'submit':\n      return [changeValidator, blurValidator, submitValidator] as never\n    case 'blur':\n      return [blurValidator] as never\n    case 'change':\n    default:\n      return [changeValidator] as never\n  }\n}\n\ninterface SyncValidatorArrayPartialOptions<T> {\n  validators?: T\n}\n\ninterface SyncValidator<T> {\n  cause: ValidationCause\n  validate: T\n}\n\nexport function getSyncValidatorArray<T>(\n  cause: ValidationCause,\n  options: SyncValidatorArrayPartialOptions<T>,\n): T extends FieldValidators<any, any>\n  ? Array<SyncValidator<T['onChange'] | T['onBlur'] | T['onSubmit']>>\n  : T extends FormValidators<any, any>\n  ? Array<SyncValidator<T['onChange'] | T['onBlur'] | T['onSubmit']>>\n  : never {\n  const { onChange, onBlur, onSubmit } = (options.validators || {}) as\n    | FieldValidators<any, any>\n    | FormValidators<any, any>\n\n  const changeValidator = { cause: 'change', validate: onChange } as const\n  const blurValidator = { cause: 'blur', validate: onBlur } as const\n  const submitValidator = { cause: 'submit', validate: onSubmit } as const\n\n  switch (cause) {\n    case 'submit':\n      return [changeValidator, blurValidator, submitValidator] as never\n    case 'blur':\n      return [blurValidator] as never\n    case 'change':\n    default:\n      return [changeValidator] as never\n  }\n}\n\nexport type RequiredByKey<T, K extends keyof T> = Omit<T, K> &\n  Required<Pick<T, K>>\n\ntype ComputeRange<\n  N extends number,\n  Result extends Array<unknown> = [],\n> = Result['length'] extends N\n  ? Result\n  : ComputeRange<N, [...Result, Result['length']]>\ntype Index40 = ComputeRange<40>[number]\n\n// Is this type a tuple?\ntype IsTuple<T> = T extends readonly any[] & { length: infer Length }\n  ? Length extends Index40\n    ? T\n    : never\n  : never\n\n// If this type is a tuple, what indices are allowed?\ntype AllowedIndexes<\n  Tuple extends ReadonlyArray<any>,\n  Keys extends number = never,\n> = Tuple extends readonly []\n  ? Keys\n  : Tuple extends readonly [infer _, ...infer Tail]\n  ? AllowedIndexes<Tail, Keys | Tail['length']>\n  : Keys\n\nexport type DeepKeys<T, TDepth extends any[] = []> = TDepth['length'] extends 5\n  ? never\n  : unknown extends T\n  ? string\n  : object extends T\n  ? string\n  : T extends readonly any[] & IsTuple<T>\n  ? AllowedIndexes<T> | DeepKeysPrefix<T, AllowedIndexes<T>, TDepth>\n  : T extends any[]\n  ? DeepKeys<T[number], [...TDepth, any]>\n  : T extends Date\n  ? never\n  : T extends object\n  ? (keyof T & string) | DeepKeysPrefix<T, keyof T, TDepth>\n  : never\n\ntype DeepKeysPrefix<\n  T,\n  TPrefix,\n  TDepth extends any[],\n> = TPrefix extends keyof T & (number | string)\n  ? `${TPrefix}.${DeepKeys<T[TPrefix], [...TDepth, any]> & string}`\n  : never\n\nexport type DeepValue<T, TProp> = T extends Record<string | number, any>\n  ? TProp extends `${infer TBranch}.${infer TDeepProp}`\n    ? DeepValue<T[TBranch], TDeepProp>\n    : T[TProp & string]\n  : never\n\ntype Narrowable = string | number | bigint | boolean\n\ntype NarrowRaw<A> =\n  | (A extends [] ? [] : never)\n  | (A extends Narrowable ? A : never)\n  | {\n      [K in keyof A]: A[K] extends Function ? A[K] : NarrowRaw<A[K]>\n    }\n\nexport type Narrow<A> = Try<A, [], NarrowRaw<A>>\n\ntype Try<A1, A2, Catch = never> = A1 extends A2 ? A1 : Catch\n\n// Hack to get TypeScript to show simplified types in error messages\nexport type Pretty<T> = { [K in keyof T]: T[K] } & {}\n"],"mappings":"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","names":[]}

package/build/modern/utils.d.cts

@@ -1,37 +1,3 @@
-type UpdaterFn<TInput, TOutput = TInput> = (input: TInput) => TOutput;
-type Updater<TInput, TOutput = TInput> = TOutput | UpdaterFn<TInput, TOutput>;
-declare function functionalUpdate<TInput, TOutput = TInput>(updater: Updater<TInput, TOutput>, input: TInput): TOutput;
-/**
- * Get a value from an object using a path, including dot notation.
- */
-declare function getBy(obj: any, path: any): any;
-/**
- * Set a value on an object using a path, including dot notation.
- */
-declare function setBy(obj: any, _path: any, updater: Updater<any>): any;
-/**
- * Delete a field on an object using a path, including dot notation.
- */
-declare function deleteBy(obj: any, _path: any): any;
-declare function isNonEmptyArray(obj: any): boolean;
-type RequiredByKey<T, K extends keyof T> = Omit<T, K> & Required<Pick<T, K>>;
-type ComputeRange<N extends number, Result extends Array<unknown> = []> = Result['length'] extends N ? Result : ComputeRange<N, [...Result, Result['length']]>;
-type Index40 = ComputeRange<40>[number];
-type IsTuple<T> = T extends readonly any[] & {
-    length: infer Length;
-} ? Length extends Index40 ? T : never : never;
-type AllowedIndexes<Tuple extends ReadonlyArray<any>, Keys extends number = never> = Tuple extends readonly [] ? Keys : Tuple extends readonly [infer _, ...infer Tail] ? AllowedIndexes<Tail, Keys | Tail['length']> : Keys;
-type DeepKeys<T, TDepth extends any[] = []> = TDepth['length'] extends 5 ? never : unknown extends T ? string : object extends T ? string : T extends readonly any[] & IsTuple<T> ? AllowedIndexes<T> | DeepKeysPrefix<T, AllowedIndexes<T>, TDepth> : T extends any[] ? DeepKeys<T[number], [...TDepth, any]> : T extends Date ? never : T extends object ? (keyof T & string) | DeepKeysPrefix<T, keyof T, TDepth> : never;
-type DeepKeysPrefix<T, TPrefix, TDepth extends any[]> = TPrefix extends keyof T & (number | string) ? `${TPrefix}.${DeepKeys<T[TPrefix], [...TDepth, any]> & string}` : never;
-type DeepValue<T, TProp> = T extends Record<string | number, any> ? TProp extends `${infer TBranch}.${infer TDeepProp}` ? DeepValue<T[TBranch], TDeepProp> : T[TProp & string] : never;
-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 Narrow<A> = Try<A, [], NarrowRaw<A>>;
-type Try<A1, A2, Catch = never> = A1 extends A2 ? A1 : Catch;
-type Pretty<T> = {
-    [K in keyof T]: T[K];
-} & {};
-
-export { DeepKeys, DeepValue, Narrow, Pretty, RequiredByKey, Updater, UpdaterFn, deleteBy, functionalUpdate, getBy, isNonEmptyArray, setBy };
+import './types.cjs';
+export { DeepKeys, DeepValue, Narrow, Pretty, RequiredByKey, Updater, UpdaterFn, deleteBy, functionalUpdate, getAsyncValidatorArray, getBy, getSyncValidatorArray, isNonEmptyArray, setBy } from './index.cjs';
+import '@tanstack/store';

package/build/modern/utils.d.ts

@@ -1,37 +1,3 @@
-type UpdaterFn<TInput, TOutput = TInput> = (input: TInput) => TOutput;
-type Updater<TInput, TOutput = TInput> = TOutput | UpdaterFn<TInput, TOutput>;
-declare function functionalUpdate<TInput, TOutput = TInput>(updater: Updater<TInput, TOutput>, input: TInput): TOutput;
-/**
- * Get a value from an object using a path, including dot notation.
- */
-declare function getBy(obj: any, path: any): any;
-/**
- * Set a value on an object using a path, including dot notation.
- */
-declare function setBy(obj: any, _path: any, updater: Updater<any>): any;
-/**
- * Delete a field on an object using a path, including dot notation.
- */
-declare function deleteBy(obj: any, _path: any): any;
-declare function isNonEmptyArray(obj: any): boolean;
-type RequiredByKey<T, K extends keyof T> = Omit<T, K> & Required<Pick<T, K>>;
-type ComputeRange<N extends number, Result extends Array<unknown> = []> = Result['length'] extends N ? Result : ComputeRange<N, [...Result, Result['length']]>;
-type Index40 = ComputeRange<40>[number];
-type IsTuple<T> = T extends readonly any[] & {
-    length: infer Length;
-} ? Length extends Index40 ? T : never : never;
-type AllowedIndexes<Tuple extends ReadonlyArray<any>, Keys extends number = never> = Tuple extends readonly [] ? Keys : Tuple extends readonly [infer _, ...infer Tail] ? AllowedIndexes<Tail, Keys | Tail['length']> : Keys;
-type DeepKeys<T, TDepth extends any[] = []> = TDepth['length'] extends 5 ? never : unknown extends T ? string : object extends T ? string : T extends readonly any[] & IsTuple<T> ? AllowedIndexes<T> | DeepKeysPrefix<T, AllowedIndexes<T>, TDepth> : T extends any[] ? DeepKeys<T[number], [...TDepth, any]> : T extends Date ? never : T extends object ? (keyof T & string) | DeepKeysPrefix<T, keyof T, TDepth> : never;
-type DeepKeysPrefix<T, TPrefix, TDepth extends any[]> = TPrefix extends keyof T & (number | string) ? `${TPrefix}.${DeepKeys<T[TPrefix], [...TDepth, any]> & string}` : never;
-type DeepValue<T, TProp> = T extends Record<string | number, any> ? TProp extends `${infer TBranch}.${infer TDeepProp}` ? DeepValue<T[TBranch], TDeepProp> : T[TProp & string] : never;
-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 Narrow<A> = Try<A, [], NarrowRaw<A>>;
-type Try<A1, A2, Catch = never> = A1 extends A2 ? A1 : Catch;
-type Pretty<T> = {
-    [K in keyof T]: T[K];
-} & {};
-
-export { DeepKeys, DeepValue, Narrow, Pretty, RequiredByKey, Updater, UpdaterFn, deleteBy, functionalUpdate, getBy, isNonEmptyArray, setBy };
+import './types.js';
+export { DeepKeys, DeepValue, Narrow, Pretty, RequiredByKey, Updater, UpdaterFn, deleteBy, functionalUpdate, getAsyncValidatorArray, getBy, getSyncValidatorArray, isNonEmptyArray, setBy } from './index.js';
+import '@tanstack/store';