formstand 0.2.0

package/dist/index.d.cts

@@ -0,0 +1,330 @@
+import { z } from 'zod';
+import { StoreApi } from 'zustand/vanilla';
+import * as react from 'react';
+import { ReactNode, ChangeEvent } from 'react';
+
+type LeafType = string | number | boolean | bigint | symbol | null | undefined | Date | RegExp;
+type IsRecord<T> = T extends LeafType ? false : T extends readonly unknown[] ? false : T extends object ? true : false;
+type IsArray<T> = T extends readonly unknown[] ? true : false;
+type Prev = [never, 0, 1, 2, 3, 4, 5, 6, 7, 8];
+type FieldPath<T, D extends number = 7> = [D] extends [0] ? never : IsArray<T> extends true ? T extends readonly (infer U)[] ? `${number}` | (IsRecord<NonNullable<U>> extends true ? `${number}.${FieldPath<NonNullable<U>, Prev[D]>}` : IsArray<NonNullable<U>> extends true ? `${number}.${FieldPath<NonNullable<U>, Prev[D]>}` : never) : never : IsRecord<T> extends true ? {
+    [K in keyof T & string]: K | (IsRecord<NonNullable<T[K]>> extends true ? `${K}.${FieldPath<NonNullable<T[K]>, Prev[D]>}` : IsArray<NonNullable<T[K]>> extends true ? `${K}.${FieldPath<NonNullable<T[K]>, Prev[D]>}` : never);
+}[keyof T & string] : never;
+type StepValue<T, K extends string> = T extends readonly (infer U)[] ? K extends `${number}` ? U : never : T extends object ? K extends keyof T ? T[K] : never : never;
+type FieldValue<T, P extends string> = [T] extends [NonNullable<T>] ? P extends `${infer Head}.${infer Tail}` ? FieldValue<StepValue<T, Head>, Tail> : StepValue<T, P> : FieldValue<NonNullable<T>, P> | undefined;
+
+type ValidationMode = "onChange" | "onBlur" | "onSubmit" | "onTouched" | "all";
+type ValidationTrigger = "change" | "blur";
+declare const shouldValidateOn: (trigger: ValidationTrigger, mode: ValidationMode, reValidateMode: ValidationMode, submitAttempted: boolean, touched?: boolean) => boolean;
+
+type ErrorMap = Readonly<Record<string, readonly string[]>>;
+type BoolMap = Readonly<Record<string, boolean>>;
+type FormState<TValues> = Readonly<{
+    values: TValues;
+    initialValues: TValues;
+    errors: ErrorMap;
+    schemaErrors: ErrorMap;
+    serverErrors: ErrorMap;
+    touched: BoolMap;
+    isSubmitting: boolean;
+    submitCount: number;
+    isValidating: BoolMap;
+    isValidatingForm: boolean;
+    mode: ValidationMode;
+    reValidateMode: ValidationMode;
+}>;
+
+type SettledValidationResult<TOutput> = Readonly<{
+    kind: "valid";
+    data: TOutput;
+}> | Readonly<{
+    kind: "invalid";
+    errors: ErrorMap;
+}>;
+type ValidationResult<TOutput> = SettledValidationResult<TOutput> | Readonly<{
+    kind: "pending";
+    promise: Promise<SettledValidationResult<TOutput>>;
+}>;
+type SettledFieldValidationResult = Readonly<{
+    kind: "valid";
+}> | Readonly<{
+    kind: "invalid";
+    errors: readonly string[];
+}>;
+type FieldValidationResult = SettledFieldValidationResult | Readonly<{
+    kind: "pending";
+    promise: Promise<SettledFieldValidationResult>;
+}>;
+declare const flattenIssues: (issues: readonly z.core.$ZodIssue[]) => ErrorMap;
+declare const validateSync: <TSchema extends z.ZodType>(schema: TSchema, values: z.input<TSchema>) => SettledValidationResult<z.output<TSchema>>;
+declare const validateAsync: <TSchema extends z.ZodType>(schema: TSchema, values: z.input<TSchema>) => Promise<SettledValidationResult<z.output<TSchema>>>;
+declare const isAsyncRequiredError: (e: unknown) => boolean;
+
+type ReadonlyStoreApi<T> = Pick<StoreApi<T>, "getState" | "getInitialState" | "subscribe">;
+type CreateFormOptions<TSchema extends z.ZodType> = Readonly<{
+    initialValues: z.input<TSchema>;
+    mode?: ValidationMode;
+    reValidateMode?: ValidationMode;
+    validateOnMount?: boolean;
+}>;
+type SubmitHandler<TSchema extends z.ZodType> = (data: z.output<TSchema>) => void | Promise<void>;
+type InvalidSubmitHandler = (errors: ErrorMap) => void;
+type SubmitOptions = Readonly<{
+    force?: boolean;
+}>;
+type SubmitResult<TOutput> = Readonly<{
+    kind: "valid";
+    data: TOutput;
+}> | Readonly<{
+    kind: "invalid";
+    errors: ErrorMap;
+}> | Readonly<{
+    kind: "skipped";
+}>;
+type ArrayItemOf<T> = T extends readonly (infer U)[] ? U : never;
+type ErrorPath<TValues> = FieldPath<TValues> | "";
+type ResetOptions = Readonly<{
+    keepErrors?: boolean;
+    keepTouched?: boolean;
+    keepSubmitCount?: boolean;
+}>;
+type FieldSnapshot<TValue> = Readonly<{
+    value: TValue;
+    error: readonly string[] | undefined;
+    touched: boolean;
+    dirty: boolean;
+    isValidating: boolean;
+}>;
+type Form<TSchema extends z.ZodType> = Readonly<{
+    schema: TSchema;
+    store: ReadonlyStoreApi<FormState<z.input<TSchema>>>;
+    getState: () => FormState<z.input<TSchema>>;
+    subscribe: (listener: (state: FormState<z.input<TSchema>>, prev: FormState<z.input<TSchema>>) => void) => () => void;
+    getField: <P extends FieldPath<z.input<TSchema>>>(path: P) => FieldValue<z.input<TSchema>, P>;
+    watchField: <P extends FieldPath<z.input<TSchema>>>(path: P, listener: (snapshot: FieldSnapshot<FieldValue<z.input<TSchema>, P>>) => void) => () => void;
+    watchValue: <P extends FieldPath<z.input<TSchema>>>(path: P, listener: (value: FieldValue<z.input<TSchema>, P>, previous: FieldValue<z.input<TSchema>, P>) => void) => () => void;
+    watchValues: (listener: (values: z.input<TSchema>, previous: z.input<TSchema>) => void) => () => void;
+    setValue: <P extends FieldPath<z.input<TSchema>>>(path: P, value: FieldValue<z.input<TSchema>, P>) => void;
+    setValues: (next: z.input<TSchema>) => void;
+    setTouched: (path: FieldPath<z.input<TSchema>>, touched?: boolean) => void;
+    setSubmitting: (value: boolean) => void;
+    setMode: (mode: ValidationMode) => void;
+    setReValidateMode: (mode: ValidationMode) => void;
+    setError: (path: ErrorPath<z.input<TSchema>>, errors: string | readonly string[]) => void;
+    setErrors: (errors: ErrorMap) => void;
+    clearErrors: (path?: ErrorPath<z.input<TSchema>>) => void;
+    updateState: (updater: (state: FormState<z.input<TSchema>>) => Partial<Omit<FormState<z.input<TSchema>>, "errors">>) => void;
+    reset: (nextInitial?: Partial<z.input<TSchema>>, options?: ResetOptions) => void;
+    resetField: (path: FieldPath<z.input<TSchema>>) => void;
+    adoptValues: (values: z.input<TSchema>) => void;
+    getFieldState: <P extends FieldPath<z.input<TSchema>>>(path: P) => FieldSnapshot<FieldValue<z.input<TSchema>, P>>;
+    validate: () => ValidationResult<z.output<TSchema>>;
+    validateField: (path: ErrorPath<z.input<TSchema>>) => FieldValidationResult;
+    validateFields: (paths: readonly FieldPath<z.input<TSchema>>[]) => boolean | Promise<boolean>;
+    validateAsync: () => Promise<ValidationResult<z.output<TSchema>>>;
+    validateFieldAsync: (path: ErrorPath<z.input<TSchema>>) => Promise<FieldValidationResult>;
+    validateFieldsAsync: (paths: readonly FieldPath<z.input<TSchema>>[]) => Promise<boolean>;
+    submit: (onValid: SubmitHandler<TSchema>, onInvalid?: InvalidSubmitHandler, options?: SubmitOptions) => Promise<SubmitResult<z.output<TSchema>>>;
+    arrayPush: <P extends FieldPath<z.input<TSchema>>>(path: P, item: ArrayItemOf<NonNullable<FieldValue<z.input<TSchema>, P>>>) => void;
+    arrayRemove: (path: FieldPath<z.input<TSchema>>, index: number) => void;
+    arrayInsert: <P extends FieldPath<z.input<TSchema>>>(path: P, index: number, item: ArrayItemOf<NonNullable<FieldValue<z.input<TSchema>, P>>>) => void;
+    arrayMove: (path: FieldPath<z.input<TSchema>>, from: number, to: number) => void;
+    arraySwap: (path: FieldPath<z.input<TSchema>>, a: number, b: number) => void;
+    handleSubmit: (onValid: SubmitHandler<TSchema>, onInvalid?: InvalidSubmitHandler, options?: SubmitOptions) => (event?: {
+        preventDefault: () => void;
+    }) => Promise<SubmitResult<z.output<TSchema>>>;
+    diff: () => Readonly<Record<string, unknown>>;
+    dirtyFields: () => readonly string[];
+    snapshot: () => FormState<z.input<TSchema>>;
+    restore: (snapshot: FormState<z.input<TSchema>>) => void;
+}>;
+declare const createForm: <TSchema extends z.ZodType>(schema: TSchema, options: CreateFormOptions<TSchema>) => Form<TSchema>;
+
+type PathSegment = string | number;
+declare const parsePath: (path: string) => readonly PathSegment[];
+declare const getAtPath: (obj: unknown, path: string) => unknown;
+declare const setAtPath: <T>(obj: T, path: string, value: unknown) => T;
+
+declare const useForm: <TSchema extends z.ZodType>(schema: TSchema, options: CreateFormOptions<TSchema>) => Form<TSchema>;
+
+type FormProviderProps<TSchema extends z.ZodType> = Readonly<{
+    form: Form<TSchema>;
+    children: ReactNode;
+}>;
+type FormContextApi<TSchema extends z.ZodType> = Readonly<{
+    Provider: (props: FormProviderProps<TSchema>) => ReactNode;
+    useFormContext: () => Form<TSchema>;
+}>;
+declare const createFormContext: <TSchema extends z.ZodType>() => FormContextApi<TSchema>;
+
+type ReadonlyStore$2<T> = Pick<StoreApi<T>, "getState" | "getInitialState" | "subscribe">;
+type FormStateApi = Readonly<{
+    store: ReadonlyStore$2<FormState<unknown>>;
+}>;
+declare function useFormSelector<TSchema extends z.ZodType, U>(form: Form<TSchema>, selector: (state: FormState<z.input<TSchema>>) => U): U;
+declare function useFormSelector<U>(form: FormStateApi & {
+    readonly schema?: undefined;
+}, selector: (state: FormState<unknown>) => U): U;
+declare function useFormSelectorShallow<TSchema extends z.ZodType, U>(form: Form<TSchema>, selector: (state: FormState<z.input<TSchema>>) => U): U;
+declare function useFormSelectorShallow<U>(form: FormStateApi & {
+    readonly schema?: undefined;
+}, selector: (state: FormState<unknown>) => U): U;
+/**
+ * @deprecated Renamed to `useFormSelector` — React DOM ships its own
+ * (deprecated) `useFormState`, and auto-imports regularly grab the wrong one.
+ * This alias will be removed before 1.0.
+ */
+declare const useFormState: typeof useFormSelector;
+/** @deprecated Renamed to `useFormSelectorShallow`; see `useFormState`. */
+declare const useFormStateShallow: typeof useFormSelectorShallow;
+
+declare const useFormError: (form: FormStateApi) => readonly string[] | undefined;
+
+declare const useIsDirty: (form: FormStateApi) => boolean;
+declare const useIsValid: (form: FormStateApi) => boolean;
+declare const useIsSubmitting: (form: FormStateApi) => boolean;
+declare const useSubmitCount: (form: FormStateApi) => number;
+
+type ReadonlyStore$1<T> = Pick<StoreApi<T>, "getState" | "getInitialState" | "subscribe">;
+type FieldFormApi = Readonly<{
+    store: ReadonlyStore$1<FormState<unknown>>;
+    setValue(path: string, value: unknown): void;
+    setTouched(path: string, touched?: boolean): void;
+    setError(path: string, errors: readonly string[]): void;
+    clearErrors(path?: string): void;
+    validateField(path: string): FieldValidationResult;
+    validateFieldAsync(path: string): Promise<FieldValidationResult>;
+}>;
+type FieldPathArg<TValues> = string | ((state: FormState<TValues>) => string);
+type UseFieldOptions = Readonly<{
+    debounceMs?: number;
+}>;
+type UseFieldReturn<TValue> = Readonly<{
+    path: string;
+    value: TValue;
+    initialValue: TValue;
+    emptyValue: null | undefined;
+    error: readonly string[] | undefined;
+    touched: boolean;
+    dirty: boolean;
+    isValidating: boolean;
+    setValue: (value: TValue) => void;
+    setTouched: (touched?: boolean) => void;
+    setError: (errors: readonly string[]) => void;
+    clearError: () => void;
+    validate: () => FieldValidationResult;
+    validateAsync: () => Promise<FieldValidationResult>;
+    onBlur: () => void;
+}>;
+declare function useField<TSchema extends z.ZodType, P extends FieldPath<z.input<TSchema>>>(form: Form<TSchema>, path: P, options?: UseFieldOptions): UseFieldReturn<FieldValue<z.input<TSchema>, P>>;
+declare function useField<TSchema extends z.ZodType>(form: Form<TSchema>, pathSelector: (state: FormState<z.input<TSchema>>) => string, options?: UseFieldOptions): UseFieldReturn<unknown>;
+declare function useField<TValue = unknown>(form: FieldFormApi & {
+    readonly schema?: undefined;
+}, path: string | ((state: FormState<unknown>) => string), options?: UseFieldOptions): UseFieldReturn<TValue>;
+
+type FieldRef<T> = ((instance: T | null) => void) | Readonly<{
+    current: T | null;
+}> | null;
+type TextFieldProps = Readonly<{
+    form: FieldFormApi;
+    path: string;
+    label?: ReactNode;
+    placeholder?: string;
+    type?: "text" | "password" | "email" | "url" | "tel";
+    autoComplete?: string;
+    ref?: FieldRef<HTMLInputElement>;
+}>;
+declare const TextField: ({ form, path, label, placeholder, type, autoComplete, ref, }: TextFieldProps) => react.JSX.Element;
+type NumberFieldProps = Readonly<{
+    form: FieldFormApi;
+    path: string;
+    label?: ReactNode;
+    placeholder?: string;
+    ref?: FieldRef<HTMLInputElement>;
+}>;
+declare const NumberField: ({ form, path, label, placeholder, ref, }: NumberFieldProps) => react.JSX.Element;
+type CheckboxFieldProps = Readonly<{
+    form: FieldFormApi;
+    path: string;
+    label?: ReactNode;
+    ref?: FieldRef<HTMLInputElement>;
+}>;
+declare const CheckboxField: ({ form, path, label, ref }: CheckboxFieldProps) => react.JSX.Element;
+type SelectFieldOption<T extends string> = Readonly<{
+    value: T;
+    label: ReactNode;
+}>;
+type SelectFieldProps<T extends string> = Readonly<{
+    form: FieldFormApi;
+    path: string;
+    label?: ReactNode;
+    options: readonly SelectFieldOption<T>[];
+    placeholder?: string;
+    ref?: FieldRef<HTMLSelectElement>;
+}>;
+declare const SelectField: <T extends string>({ form, path, label, options, placeholder, ref, }: SelectFieldProps<T>) => react.JSX.Element;
+
+declare const focusFirstError: (errors: ErrorMap, root?: ParentNode) => boolean;
+
+type ReadonlyStore<T> = Pick<StoreApi<T>, "getState" | "getInitialState" | "subscribe">;
+type FieldArrayFormApi = Readonly<{
+    store: ReadonlyStore<FormState<unknown>>;
+    arrayPush(path: string, item: unknown): void;
+    arrayRemove(path: string, index: number): void;
+    arrayInsert(path: string, index: number, item: unknown): void;
+    arrayMove(path: string, from: number, to: number): void;
+    arraySwap(path: string, a: number, b: number): void;
+}>;
+type FieldArrayEntry<TItem> = Readonly<{
+    id: string;
+    value: TItem;
+}>;
+type UseFieldArrayReturn<TItem> = Readonly<{
+    fields: readonly FieldArrayEntry<TItem>[];
+    items: readonly TItem[];
+    length: number;
+    error: readonly string[] | undefined;
+    push: (item: TItem) => void;
+    remove: (index: number) => void;
+    insert: (index: number, item: TItem) => void;
+    move: (from: number, to: number) => void;
+    swap: (a: number, b: number) => void;
+}>;
+declare const useFieldArray: <TItem = unknown>(form: FieldArrayFormApi, pathArg: string | ((state: FormState<unknown>) => string)) => UseFieldArrayReturn<TItem>;
+
+type TextInputProps = Readonly<{
+    name: string;
+    value: string;
+    "aria-invalid": true | undefined;
+    onChange: (e: ChangeEvent<HTMLInputElement | HTMLTextAreaElement>) => void;
+    onBlur: () => void;
+}>;
+type NumberInputProps = Readonly<{
+    type: "number";
+    name: string;
+    value: string;
+    "aria-invalid": true | undefined;
+    onChange: (e: ChangeEvent<HTMLInputElement>) => void;
+    onBlur: () => void;
+}>;
+type CheckboxProps = Readonly<{
+    type: "checkbox";
+    name: string;
+    checked: boolean;
+    "aria-invalid": true | undefined;
+    onChange: (e: ChangeEvent<HTMLInputElement>) => void;
+    onBlur: () => void;
+}>;
+type SelectProps = Readonly<{
+    name: string;
+    value: string;
+    "aria-invalid": true | undefined;
+    onChange: (e: ChangeEvent<HTMLSelectElement>) => void;
+    onBlur: () => void;
+}>;
+declare const textInputProps: <T extends string | null | undefined>(field: UseFieldReturn<T>) => TextInputProps;
+declare const numberInputProps: <T extends number | null | undefined>(field: UseFieldReturn<T>) => NumberInputProps;
+declare const checkboxProps: <T extends boolean | null | undefined>(field: UseFieldReturn<T>) => CheckboxProps;
+declare const selectProps: <T extends string | null | undefined>(field: UseFieldReturn<T>) => SelectProps;
+
+export { type BoolMap, CheckboxField, type CheckboxFieldProps, type CheckboxProps, type CreateFormOptions, type ErrorMap, type FieldArrayEntry, type FieldArrayFormApi, type FieldFormApi, type FieldPath, type FieldPathArg, type FieldRef, type FieldSnapshot, type FieldValidationResult, type FieldValue, type Form, type FormContextApi, type FormProviderProps, type FormState, type FormStateApi, type InvalidSubmitHandler, NumberField, type NumberFieldProps, type NumberInputProps, type PathSegment, type ReadonlyStoreApi, type ResetOptions, SelectField, type SelectFieldOption, type SelectFieldProps, type SelectProps, type SettledFieldValidationResult, type SettledValidationResult, type SubmitHandler, type SubmitOptions, type SubmitResult, TextField, type TextFieldProps, type TextInputProps, type UseFieldArrayReturn, type UseFieldOptions, type UseFieldReturn, type ValidationMode, type ValidationResult, type ValidationTrigger, checkboxProps, createForm, createFormContext, flattenIssues, focusFirstError, getAtPath, isAsyncRequiredError, numberInputProps, parsePath, selectProps, setAtPath, shouldValidateOn, textInputProps, useField, useFieldArray, useForm, useFormError, useFormSelector, useFormSelectorShallow, useFormState, useFormStateShallow, useIsDirty, useIsSubmitting, useIsValid, useSubmitCount, validateAsync, validateSync };

package/dist/index.d.ts

@@ -0,0 +1,330 @@
+import { z } from 'zod';
+import { StoreApi } from 'zustand/vanilla';
+import * as react from 'react';
+import { ReactNode, ChangeEvent } from 'react';
+
+type LeafType = string | number | boolean | bigint | symbol | null | undefined | Date | RegExp;
+type IsRecord<T> = T extends LeafType ? false : T extends readonly unknown[] ? false : T extends object ? true : false;
+type IsArray<T> = T extends readonly unknown[] ? true : false;
+type Prev = [never, 0, 1, 2, 3, 4, 5, 6, 7, 8];
+type FieldPath<T, D extends number = 7> = [D] extends [0] ? never : IsArray<T> extends true ? T extends readonly (infer U)[] ? `${number}` | (IsRecord<NonNullable<U>> extends true ? `${number}.${FieldPath<NonNullable<U>, Prev[D]>}` : IsArray<NonNullable<U>> extends true ? `${number}.${FieldPath<NonNullable<U>, Prev[D]>}` : never) : never : IsRecord<T> extends true ? {
+    [K in keyof T & string]: K | (IsRecord<NonNullable<T[K]>> extends true ? `${K}.${FieldPath<NonNullable<T[K]>, Prev[D]>}` : IsArray<NonNullable<T[K]>> extends true ? `${K}.${FieldPath<NonNullable<T[K]>, Prev[D]>}` : never);
+}[keyof T & string] : never;
+type StepValue<T, K extends string> = T extends readonly (infer U)[] ? K extends `${number}` ? U : never : T extends object ? K extends keyof T ? T[K] : never : never;
+type FieldValue<T, P extends string> = [T] extends [NonNullable<T>] ? P extends `${infer Head}.${infer Tail}` ? FieldValue<StepValue<T, Head>, Tail> : StepValue<T, P> : FieldValue<NonNullable<T>, P> | undefined;
+
+type ValidationMode = "onChange" | "onBlur" | "onSubmit" | "onTouched" | "all";
+type ValidationTrigger = "change" | "blur";
+declare const shouldValidateOn: (trigger: ValidationTrigger, mode: ValidationMode, reValidateMode: ValidationMode, submitAttempted: boolean, touched?: boolean) => boolean;
+
+type ErrorMap = Readonly<Record<string, readonly string[]>>;
+type BoolMap = Readonly<Record<string, boolean>>;
+type FormState<TValues> = Readonly<{
+    values: TValues;
+    initialValues: TValues;
+    errors: ErrorMap;
+    schemaErrors: ErrorMap;
+    serverErrors: ErrorMap;
+    touched: BoolMap;
+    isSubmitting: boolean;
+    submitCount: number;
+    isValidating: BoolMap;
+    isValidatingForm: boolean;
+    mode: ValidationMode;
+    reValidateMode: ValidationMode;
+}>;
+
+type SettledValidationResult<TOutput> = Readonly<{
+    kind: "valid";
+    data: TOutput;
+}> | Readonly<{
+    kind: "invalid";
+    errors: ErrorMap;
+}>;
+type ValidationResult<TOutput> = SettledValidationResult<TOutput> | Readonly<{
+    kind: "pending";
+    promise: Promise<SettledValidationResult<TOutput>>;
+}>;
+type SettledFieldValidationResult = Readonly<{
+    kind: "valid";
+}> | Readonly<{
+    kind: "invalid";
+    errors: readonly string[];
+}>;
+type FieldValidationResult = SettledFieldValidationResult | Readonly<{
+    kind: "pending";
+    promise: Promise<SettledFieldValidationResult>;
+}>;
+declare const flattenIssues: (issues: readonly z.core.$ZodIssue[]) => ErrorMap;
+declare const validateSync: <TSchema extends z.ZodType>(schema: TSchema, values: z.input<TSchema>) => SettledValidationResult<z.output<TSchema>>;
+declare const validateAsync: <TSchema extends z.ZodType>(schema: TSchema, values: z.input<TSchema>) => Promise<SettledValidationResult<z.output<TSchema>>>;
+declare const isAsyncRequiredError: (e: unknown) => boolean;
+
+type ReadonlyStoreApi<T> = Pick<StoreApi<T>, "getState" | "getInitialState" | "subscribe">;
+type CreateFormOptions<TSchema extends z.ZodType> = Readonly<{
+    initialValues: z.input<TSchema>;
+    mode?: ValidationMode;
+    reValidateMode?: ValidationMode;
+    validateOnMount?: boolean;
+}>;
+type SubmitHandler<TSchema extends z.ZodType> = (data: z.output<TSchema>) => void | Promise<void>;
+type InvalidSubmitHandler = (errors: ErrorMap) => void;
+type SubmitOptions = Readonly<{
+    force?: boolean;
+}>;
+type SubmitResult<TOutput> = Readonly<{
+    kind: "valid";
+    data: TOutput;
+}> | Readonly<{
+    kind: "invalid";
+    errors: ErrorMap;
+}> | Readonly<{
+    kind: "skipped";
+}>;
+type ArrayItemOf<T> = T extends readonly (infer U)[] ? U : never;
+type ErrorPath<TValues> = FieldPath<TValues> | "";
+type ResetOptions = Readonly<{
+    keepErrors?: boolean;
+    keepTouched?: boolean;
+    keepSubmitCount?: boolean;
+}>;
+type FieldSnapshot<TValue> = Readonly<{
+    value: TValue;
+    error: readonly string[] | undefined;
+    touched: boolean;
+    dirty: boolean;
+    isValidating: boolean;
+}>;
+type Form<TSchema extends z.ZodType> = Readonly<{
+    schema: TSchema;
+    store: ReadonlyStoreApi<FormState<z.input<TSchema>>>;
+    getState: () => FormState<z.input<TSchema>>;
+    subscribe: (listener: (state: FormState<z.input<TSchema>>, prev: FormState<z.input<TSchema>>) => void) => () => void;
+    getField: <P extends FieldPath<z.input<TSchema>>>(path: P) => FieldValue<z.input<TSchema>, P>;
+    watchField: <P extends FieldPath<z.input<TSchema>>>(path: P, listener: (snapshot: FieldSnapshot<FieldValue<z.input<TSchema>, P>>) => void) => () => void;
+    watchValue: <P extends FieldPath<z.input<TSchema>>>(path: P, listener: (value: FieldValue<z.input<TSchema>, P>, previous: FieldValue<z.input<TSchema>, P>) => void) => () => void;
+    watchValues: (listener: (values: z.input<TSchema>, previous: z.input<TSchema>) => void) => () => void;
+    setValue: <P extends FieldPath<z.input<TSchema>>>(path: P, value: FieldValue<z.input<TSchema>, P>) => void;
+    setValues: (next: z.input<TSchema>) => void;
+    setTouched: (path: FieldPath<z.input<TSchema>>, touched?: boolean) => void;
+    setSubmitting: (value: boolean) => void;
+    setMode: (mode: ValidationMode) => void;
+    setReValidateMode: (mode: ValidationMode) => void;
+    setError: (path: ErrorPath<z.input<TSchema>>, errors: string | readonly string[]) => void;
+    setErrors: (errors: ErrorMap) => void;
+    clearErrors: (path?: ErrorPath<z.input<TSchema>>) => void;
+    updateState: (updater: (state: FormState<z.input<TSchema>>) => Partial<Omit<FormState<z.input<TSchema>>, "errors">>) => void;
+    reset: (nextInitial?: Partial<z.input<TSchema>>, options?: ResetOptions) => void;
+    resetField: (path: FieldPath<z.input<TSchema>>) => void;
+    adoptValues: (values: z.input<TSchema>) => void;
+    getFieldState: <P extends FieldPath<z.input<TSchema>>>(path: P) => FieldSnapshot<FieldValue<z.input<TSchema>, P>>;
+    validate: () => ValidationResult<z.output<TSchema>>;
+    validateField: (path: ErrorPath<z.input<TSchema>>) => FieldValidationResult;
+    validateFields: (paths: readonly FieldPath<z.input<TSchema>>[]) => boolean | Promise<boolean>;
+    validateAsync: () => Promise<ValidationResult<z.output<TSchema>>>;
+    validateFieldAsync: (path: ErrorPath<z.input<TSchema>>) => Promise<FieldValidationResult>;
+    validateFieldsAsync: (paths: readonly FieldPath<z.input<TSchema>>[]) => Promise<boolean>;
+    submit: (onValid: SubmitHandler<TSchema>, onInvalid?: InvalidSubmitHandler, options?: SubmitOptions) => Promise<SubmitResult<z.output<TSchema>>>;
+    arrayPush: <P extends FieldPath<z.input<TSchema>>>(path: P, item: ArrayItemOf<NonNullable<FieldValue<z.input<TSchema>, P>>>) => void;
+    arrayRemove: (path: FieldPath<z.input<TSchema>>, index: number) => void;
+    arrayInsert: <P extends FieldPath<z.input<TSchema>>>(path: P, index: number, item: ArrayItemOf<NonNullable<FieldValue<z.input<TSchema>, P>>>) => void;
+    arrayMove: (path: FieldPath<z.input<TSchema>>, from: number, to: number) => void;
+    arraySwap: (path: FieldPath<z.input<TSchema>>, a: number, b: number) => void;
+    handleSubmit: (onValid: SubmitHandler<TSchema>, onInvalid?: InvalidSubmitHandler, options?: SubmitOptions) => (event?: {
+        preventDefault: () => void;
+    }) => Promise<SubmitResult<z.output<TSchema>>>;
+    diff: () => Readonly<Record<string, unknown>>;
+    dirtyFields: () => readonly string[];
+    snapshot: () => FormState<z.input<TSchema>>;
+    restore: (snapshot: FormState<z.input<TSchema>>) => void;
+}>;
+declare const createForm: <TSchema extends z.ZodType>(schema: TSchema, options: CreateFormOptions<TSchema>) => Form<TSchema>;
+
+type PathSegment = string | number;
+declare const parsePath: (path: string) => readonly PathSegment[];
+declare const getAtPath: (obj: unknown, path: string) => unknown;
+declare const setAtPath: <T>(obj: T, path: string, value: unknown) => T;
+
+declare const useForm: <TSchema extends z.ZodType>(schema: TSchema, options: CreateFormOptions<TSchema>) => Form<TSchema>;
+
+type FormProviderProps<TSchema extends z.ZodType> = Readonly<{
+    form: Form<TSchema>;
+    children: ReactNode;
+}>;
+type FormContextApi<TSchema extends z.ZodType> = Readonly<{
+    Provider: (props: FormProviderProps<TSchema>) => ReactNode;
+    useFormContext: () => Form<TSchema>;
+}>;
+declare const createFormContext: <TSchema extends z.ZodType>() => FormContextApi<TSchema>;
+
+type ReadonlyStore$2<T> = Pick<StoreApi<T>, "getState" | "getInitialState" | "subscribe">;
+type FormStateApi = Readonly<{
+    store: ReadonlyStore$2<FormState<unknown>>;
+}>;
+declare function useFormSelector<TSchema extends z.ZodType, U>(form: Form<TSchema>, selector: (state: FormState<z.input<TSchema>>) => U): U;
+declare function useFormSelector<U>(form: FormStateApi & {
+    readonly schema?: undefined;
+}, selector: (state: FormState<unknown>) => U): U;
+declare function useFormSelectorShallow<TSchema extends z.ZodType, U>(form: Form<TSchema>, selector: (state: FormState<z.input<TSchema>>) => U): U;
+declare function useFormSelectorShallow<U>(form: FormStateApi & {
+    readonly schema?: undefined;
+}, selector: (state: FormState<unknown>) => U): U;
+/**
+ * @deprecated Renamed to `useFormSelector` — React DOM ships its own
+ * (deprecated) `useFormState`, and auto-imports regularly grab the wrong one.
+ * This alias will be removed before 1.0.
+ */
+declare const useFormState: typeof useFormSelector;
+/** @deprecated Renamed to `useFormSelectorShallow`; see `useFormState`. */
+declare const useFormStateShallow: typeof useFormSelectorShallow;
+
+declare const useFormError: (form: FormStateApi) => readonly string[] | undefined;
+
+declare const useIsDirty: (form: FormStateApi) => boolean;
+declare const useIsValid: (form: FormStateApi) => boolean;
+declare const useIsSubmitting: (form: FormStateApi) => boolean;
+declare const useSubmitCount: (form: FormStateApi) => number;
+
+type ReadonlyStore$1<T> = Pick<StoreApi<T>, "getState" | "getInitialState" | "subscribe">;
+type FieldFormApi = Readonly<{
+    store: ReadonlyStore$1<FormState<unknown>>;
+    setValue(path: string, value: unknown): void;
+    setTouched(path: string, touched?: boolean): void;
+    setError(path: string, errors: readonly string[]): void;
+    clearErrors(path?: string): void;
+    validateField(path: string): FieldValidationResult;
+    validateFieldAsync(path: string): Promise<FieldValidationResult>;
+}>;
+type FieldPathArg<TValues> = string | ((state: FormState<TValues>) => string);
+type UseFieldOptions = Readonly<{
+    debounceMs?: number;
+}>;
+type UseFieldReturn<TValue> = Readonly<{
+    path: string;
+    value: TValue;
+    initialValue: TValue;
+    emptyValue: null | undefined;
+    error: readonly string[] | undefined;
+    touched: boolean;
+    dirty: boolean;
+    isValidating: boolean;
+    setValue: (value: TValue) => void;
+    setTouched: (touched?: boolean) => void;
+    setError: (errors: readonly string[]) => void;
+    clearError: () => void;
+    validate: () => FieldValidationResult;
+    validateAsync: () => Promise<FieldValidationResult>;
+    onBlur: () => void;
+}>;
+declare function useField<TSchema extends z.ZodType, P extends FieldPath<z.input<TSchema>>>(form: Form<TSchema>, path: P, options?: UseFieldOptions): UseFieldReturn<FieldValue<z.input<TSchema>, P>>;
+declare function useField<TSchema extends z.ZodType>(form: Form<TSchema>, pathSelector: (state: FormState<z.input<TSchema>>) => string, options?: UseFieldOptions): UseFieldReturn<unknown>;
+declare function useField<TValue = unknown>(form: FieldFormApi & {
+    readonly schema?: undefined;
+}, path: string | ((state: FormState<unknown>) => string), options?: UseFieldOptions): UseFieldReturn<TValue>;
+
+type FieldRef<T> = ((instance: T | null) => void) | Readonly<{
+    current: T | null;
+}> | null;
+type TextFieldProps = Readonly<{
+    form: FieldFormApi;
+    path: string;
+    label?: ReactNode;
+    placeholder?: string;
+    type?: "text" | "password" | "email" | "url" | "tel";
+    autoComplete?: string;
+    ref?: FieldRef<HTMLInputElement>;
+}>;
+declare const TextField: ({ form, path, label, placeholder, type, autoComplete, ref, }: TextFieldProps) => react.JSX.Element;
+type NumberFieldProps = Readonly<{
+    form: FieldFormApi;
+    path: string;
+    label?: ReactNode;
+    placeholder?: string;
+    ref?: FieldRef<HTMLInputElement>;
+}>;
+declare const NumberField: ({ form, path, label, placeholder, ref, }: NumberFieldProps) => react.JSX.Element;
+type CheckboxFieldProps = Readonly<{
+    form: FieldFormApi;
+    path: string;
+    label?: ReactNode;
+    ref?: FieldRef<HTMLInputElement>;
+}>;
+declare const CheckboxField: ({ form, path, label, ref }: CheckboxFieldProps) => react.JSX.Element;
+type SelectFieldOption<T extends string> = Readonly<{
+    value: T;
+    label: ReactNode;
+}>;
+type SelectFieldProps<T extends string> = Readonly<{
+    form: FieldFormApi;
+    path: string;
+    label?: ReactNode;
+    options: readonly SelectFieldOption<T>[];
+    placeholder?: string;
+    ref?: FieldRef<HTMLSelectElement>;
+}>;
+declare const SelectField: <T extends string>({ form, path, label, options, placeholder, ref, }: SelectFieldProps<T>) => react.JSX.Element;
+
+declare const focusFirstError: (errors: ErrorMap, root?: ParentNode) => boolean;
+
+type ReadonlyStore<T> = Pick<StoreApi<T>, "getState" | "getInitialState" | "subscribe">;
+type FieldArrayFormApi = Readonly<{
+    store: ReadonlyStore<FormState<unknown>>;
+    arrayPush(path: string, item: unknown): void;
+    arrayRemove(path: string, index: number): void;
+    arrayInsert(path: string, index: number, item: unknown): void;
+    arrayMove(path: string, from: number, to: number): void;
+    arraySwap(path: string, a: number, b: number): void;
+}>;
+type FieldArrayEntry<TItem> = Readonly<{
+    id: string;
+    value: TItem;
+}>;
+type UseFieldArrayReturn<TItem> = Readonly<{
+    fields: readonly FieldArrayEntry<TItem>[];
+    items: readonly TItem[];
+    length: number;
+    error: readonly string[] | undefined;
+    push: (item: TItem) => void;
+    remove: (index: number) => void;
+    insert: (index: number, item: TItem) => void;
+    move: (from: number, to: number) => void;
+    swap: (a: number, b: number) => void;
+}>;
+declare const useFieldArray: <TItem = unknown>(form: FieldArrayFormApi, pathArg: string | ((state: FormState<unknown>) => string)) => UseFieldArrayReturn<TItem>;
+
+type TextInputProps = Readonly<{
+    name: string;
+    value: string;
+    "aria-invalid": true | undefined;
+    onChange: (e: ChangeEvent<HTMLInputElement | HTMLTextAreaElement>) => void;
+    onBlur: () => void;
+}>;
+type NumberInputProps = Readonly<{
+    type: "number";
+    name: string;
+    value: string;
+    "aria-invalid": true | undefined;
+    onChange: (e: ChangeEvent<HTMLInputElement>) => void;
+    onBlur: () => void;
+}>;
+type CheckboxProps = Readonly<{
+    type: "checkbox";
+    name: string;
+    checked: boolean;
+    "aria-invalid": true | undefined;
+    onChange: (e: ChangeEvent<HTMLInputElement>) => void;
+    onBlur: () => void;
+}>;
+type SelectProps = Readonly<{
+    name: string;
+    value: string;
+    "aria-invalid": true | undefined;
+    onChange: (e: ChangeEvent<HTMLSelectElement>) => void;
+    onBlur: () => void;
+}>;
+declare const textInputProps: <T extends string | null | undefined>(field: UseFieldReturn<T>) => TextInputProps;
+declare const numberInputProps: <T extends number | null | undefined>(field: UseFieldReturn<T>) => NumberInputProps;
+declare const checkboxProps: <T extends boolean | null | undefined>(field: UseFieldReturn<T>) => CheckboxProps;
+declare const selectProps: <T extends string | null | undefined>(field: UseFieldReturn<T>) => SelectProps;
+
+export { type BoolMap, CheckboxField, type CheckboxFieldProps, type CheckboxProps, type CreateFormOptions, type ErrorMap, type FieldArrayEntry, type FieldArrayFormApi, type FieldFormApi, type FieldPath, type FieldPathArg, type FieldRef, type FieldSnapshot, type FieldValidationResult, type FieldValue, type Form, type FormContextApi, type FormProviderProps, type FormState, type FormStateApi, type InvalidSubmitHandler, NumberField, type NumberFieldProps, type NumberInputProps, type PathSegment, type ReadonlyStoreApi, type ResetOptions, SelectField, type SelectFieldOption, type SelectFieldProps, type SelectProps, type SettledFieldValidationResult, type SettledValidationResult, type SubmitHandler, type SubmitOptions, type SubmitResult, TextField, type TextFieldProps, type TextInputProps, type UseFieldArrayReturn, type UseFieldOptions, type UseFieldReturn, type ValidationMode, type ValidationResult, type ValidationTrigger, checkboxProps, createForm, createFormContext, flattenIssues, focusFirstError, getAtPath, isAsyncRequiredError, numberInputProps, parsePath, selectProps, setAtPath, shouldValidateOn, textInputProps, useField, useFieldArray, useForm, useFormError, useFormSelector, useFormSelectorShallow, useFormState, useFormStateShallow, useIsDirty, useIsSubmitting, useIsValid, useSubmitCount, validateAsync, validateSync };