formstand 0.23.0 → 0.25.0

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-import { P as PathDepth, D as DefaultPathDepth, F as Form, C as CreateFormOptions, a as FormState, b as FieldValidationResult, S as SettledFieldValidationResult, c as FieldPath, d as FieldValue, I as InvalidSubmitHandler, A as ArrayFieldPath, e as ArrayItemOf, E as ErrorMap } from './createForm-BexUOCjZ.cjs';
-export { B as BoolMap, f as FieldSnapshot, g as FieldsValidationResult, R as ReadonlyStoreApi, h as ResetOptions, i as SettledFieldsValidationResult, j as SettledValidationResult, k as SubmitHandler, l as SubmitOptions, m as SubmitResult, V as ValidationMode, n as ValidationResult, o as ValidationTrigger, p as createForm, q as emptyValueForSchema, r as flattenIssues, s as isAsyncRequiredError, t as isClearableSchema, u as shouldValidateOn, v as validateAsync, w as validateSync } from './createForm-BexUOCjZ.cjs';
+import { P as PathDepth, D as DefaultPathDepth, F as Form, C as CreateFormOptions, a as FormState, b as FieldValidationResult, S as SettledFieldValidationResult, c as FieldPath, d as FieldValue, I as InvalidSubmitHandler, A as ArrayFieldPath, e as ArrayItemOf, E as ErrorMap } from './createForm-CMVALnc3.cjs';
+export { B as BoolMap, f as FieldSnapshot, g as FieldsValidationResult, R as ReadonlyStoreApi, h as ResetOptions, i as SettledFieldsValidationResult, j as SettledValidationResult, k as SubmitHandler, l as SubmitOptions, m as SubmitResult, V as ValidationMode, n as ValidationResult, o as ValidationTrigger, p as createForm, q as emptyValueForSchema, r as flattenIssues, s as isAsyncRequiredError, t as isClearableSchema, u as shouldValidateOn, v as validateAsync, w as validateSync } from './createForm-CMVALnc3.cjs';
 import { z } from 'zod';
 import * as react from 'react';
 import { ChangeEvent, ReactNode } from 'react';
@@ -33,7 +33,7 @@ declare const persistForm: <TSchema extends z.ZodType, D extends PathDepth = Def
 
 declare const usePersistForm: <TSchema extends z.ZodType, D extends PathDepth = DefaultPathDepth>(form: Form<TSchema, D>, options: PersistOptions<TSchema>) => PersistHandle;
 
-declare const useForm: <TSchema extends z.ZodType, D extends PathDepth = DefaultPathDepth>(schema: TSchema, options: CreateFormOptions<TSchema, D>) => Form<TSchema, D>;
+declare const useForm: <TSchema extends z.ZodType, D extends PathDepth = DefaultPathDepth>(schema: TSchema, options: CreateFormOptions<TSchema, D>) => Form<TSchema, NoInfer<D>>;
 
 type ReadonlyStore$2<T> = Pick<StoreApi<T>, "getState" | "getInitialState" | "subscribe">;
 type FieldFormApi = Readonly<{
@@ -68,17 +68,17 @@ type UseFieldReturn<TValue> = Readonly<{
     validateAsync: () => Promise<SettledFieldValidationResult>;
     onBlur: () => void;
 }>;
-declare const inferredCallsOnly$2: unique symbol;
-interface InferredTypeArg$2 {
-    readonly [inferredCallsOnly$2]: typeof inferredCallsOnly$2;
+declare const inferredCallsOnly$3: unique symbol;
+interface InferredTypeArg$3 {
+    readonly [inferredCallsOnly$3]: typeof inferredCallsOnly$3;
 }
 declare function useField<TSchema extends z.ZodType>(form: FieldFormApi & Readonly<{
     schema: TSchema;
     store: ReadonlyStore$2<FormState<z.input<TSchema>>>;
 }>, pathSelector: (state: FormState<z.input<TSchema>>) => string, options?: UseFieldOptions): UseFieldReturn<unknown>;
-declare function useField<TValue = InferredTypeArg$2>(form: FieldFormApi & Readonly<{
+declare function useField<TValue = InferredTypeArg$3>(form: FieldFormApi & Readonly<{
     schema: z.ZodType;
-}>, path: TValue extends InferredTypeArg$2 ? never : "Remove the explicit type argument: a schema-typed form infers the value type from the path", options?: UseFieldOptions): UseFieldReturn<TValue>;
+}>, path: TValue extends InferredTypeArg$3 ? never : "Remove the explicit type argument: a schema-typed form infers the value type from the path", options?: UseFieldOptions): UseFieldReturn<TValue>;
 declare function useField<TValue = unknown>(form: FieldFormApi & {
     readonly schema?: undefined;
 }, path: FieldPathArg<unknown>, options?: UseFieldOptions): UseFieldReturn<TValue>;
@@ -152,13 +152,13 @@ type AllKeys<V> = V extends unknown ? keyof V : never;
 type VariantKeys<V> = Exclude<AllKeys<V>, CommonKeys<V>> & string;
 type VariantFieldPath<V, D extends PathDepth = DefaultPathDepth> = Exclude<V extends unknown ? FieldPath<V, D> : never, (CommonKeys<V> & string) | `${CommonKeys<V> & string}.${string}`> & string;
 type UnionValueAt<TValues, P extends string> = P extends keyof TValues ? NonNullable<TValues[P]> : TValues extends readonly (infer Item)[] ? P extends `${number}` ? NonNullable<Item> : P extends `${infer Head}.${infer Tail}` ? Head extends keyof TValues ? UnionValueAt<NonNullable<TValues[Head]>, Tail> : Head extends `${number}` ? UnionValueAt<NonNullable<Item>, Tail> : never : never : P extends `${infer Head}.${infer Tail}` ? Head extends keyof TValues ? UnionValueAt<NonNullable<TValues[Head]>, Tail> : never : never;
-declare const inferredCallsOnly$1: unique symbol;
-interface InferredTypeArg$1 {
-    readonly [inferredCallsOnly$1]: typeof inferredCallsOnly$1;
+declare const inferredCallsOnly$2: unique symbol;
+interface InferredTypeArg$2 {
+    readonly [inferredCallsOnly$2]: typeof inferredCallsOnly$2;
 }
-declare function useVariantField<TValue = InferredTypeArg$1>(form: FieldFormApi & Readonly<{
+declare function useVariantField<TValue = InferredTypeArg$2>(form: FieldFormApi & Readonly<{
     schema: z.ZodType;
-}>, unionPath: TValue extends InferredTypeArg$1 ? never : "Remove the explicit type argument: a schema-typed form infers the variant value from the union path and field", field: string): UseFieldReturn<TValue | undefined>;
+}>, unionPath: TValue extends InferredTypeArg$2 ? never : "Remove the explicit type argument: a schema-typed form infers the variant value from the union path and field", field: string): UseFieldReturn<TValue | undefined>;
 declare function useVariantField<TValue = unknown>(form: FieldFormApi & {
     readonly schema?: undefined;
 }, unionPath: string, field: string): UseFieldReturn<TValue | undefined>;
@@ -207,22 +207,35 @@ type UseFieldArrayReturn<TItem> = Readonly<{
     prepend: (item: TItem) => void;
     clear: () => void;
 }>;
-declare const inferredCallsOnly: unique symbol;
-interface InferredTypeArg {
-    readonly [inferredCallsOnly]: typeof inferredCallsOnly;
+declare const inferredCallsOnly$1: unique symbol;
+interface InferredTypeArg$1 {
+    readonly [inferredCallsOnly$1]: typeof inferredCallsOnly$1;
 }
 declare function useFieldArray<TSchema extends z.ZodType>(form: FieldArrayFormApi & Readonly<{
     schema: TSchema;
     store: ReadonlyStore$1<FormState<z.input<TSchema>>>;
 }>, pathSelector: (state: FormState<z.input<TSchema>>) => string): UseFieldArrayReturn<unknown>;
-declare function useFieldArray<TItem = InferredTypeArg>(form: FieldArrayFormApi & Readonly<{
+declare function useFieldArray<TItem = InferredTypeArg$1>(form: FieldArrayFormApi & Readonly<{
     schema: z.ZodType;
-}>, path: TItem extends InferredTypeArg ? never : "Remove the explicit type argument: a schema-typed form infers the item type from the path"): UseFieldArrayReturn<TItem>;
+}>, path: TItem extends InferredTypeArg$1 ? never : "Remove the explicit type argument: a schema-typed form infers the item type from the path"): UseFieldArrayReturn<TItem>;
 declare function useFieldArray<TItem = unknown>(form: FieldArrayFormApi & {
     readonly schema?: undefined;
 }, path: FieldPathArg<unknown>): UseFieldArrayReturn<TItem>;
 declare function useFieldArray<TSchema extends z.ZodType, P extends ArrayFieldPath<z.input<TSchema>, D> & string, D extends PathDepth = DefaultPathDepth>(form: Form<TSchema, D>, path: P): UseFieldArrayReturn<ArrayItemOf<FieldValue<z.input<TSchema>, P>>>;
 
+type VariantArrayFieldPath<V, D extends PathDepth = DefaultPathDepth> = Exclude<V extends unknown ? ArrayFieldPath<V, D> : never, (keyof V & string) | `${keyof V & string}.${string}`> & string;
+declare const inferredCallsOnly: unique symbol;
+interface InferredTypeArg {
+    readonly [inferredCallsOnly]: typeof inferredCallsOnly;
+}
+declare function useVariantFieldArray<TItem = InferredTypeArg>(form: FieldArrayFormApi & Readonly<{
+    schema: z.ZodType;
+}>, unionPath: TItem extends InferredTypeArg ? never : "Remove the explicit type argument: a schema-typed form infers the item type from the union path and field", field: string): UseFieldArrayReturn<TItem>;
+declare function useVariantFieldArray<TItem = unknown>(form: FieldArrayFormApi & {
+    readonly schema?: undefined;
+}, unionPath: string, field: string): UseFieldArrayReturn<TItem>;
+declare function useVariantFieldArray<TSchema extends z.ZodType, P extends string, TField extends VariantArrayFieldPath<UnionValueAt<z.input<TSchema>, P>>, D extends PathDepth = DefaultPathDepth>(form: Form<TSchema, D>, unionPath: P, field: TField): UseFieldArrayReturn<ArrayItemOf<VariantFieldValue<UnionValueAt<z.input<TSchema>, P>, TField>>>;
+
 type UseFieldsReturn<TFields extends readonly unknown[]> = Readonly<{
     fields: TFields;
     error: readonly string[] | undefined;
@@ -244,6 +257,7 @@ type BoundUseField<TSchema extends z.ZodType, D extends PathDepth = DefaultPathD
     <P extends FieldPath<z.input<TSchema>, D>>(path: P, options?: UseFieldOptions): UseFieldReturn<FieldValue<z.input<TSchema>, P>>;
 };
 type BoundUseVariantField<TSchema extends z.ZodType> = <P extends string, TField extends VariantFieldPath<UnionValueAt<z.input<TSchema>, P>>>(unionPath: P, field: TField) => UseFieldReturn<VariantFieldValue<UnionValueAt<z.input<TSchema>, P>, TField> | undefined>;
+type BoundUseVariantFieldArray<TSchema extends z.ZodType> = <P extends string, TField extends VariantArrayFieldPath<UnionValueAt<z.input<TSchema>, P>>>(unionPath: P, field: TField) => UseFieldArrayReturn<ArrayItemOf<VariantFieldValue<UnionValueAt<z.input<TSchema>, P>, TField>>>;
 type BoundUseFieldArray<TSchema extends z.ZodType, D extends PathDepth = DefaultPathDepth> = {
     (pathSelector: (state: FormState<z.input<TSchema>>) => string): UseFieldArrayReturn<unknown>;
     <P extends ArrayFieldPath<z.input<TSchema>, D>>(path: P): UseFieldArrayReturn<ArrayItemOf<FieldValue<z.input<TSchema>, P>>>;
@@ -256,6 +270,8 @@ type FormHooks<TSchema extends z.ZodType, N extends string, D extends PathDepth
     [K in `use${Capitalize<N>}VariantField`]: BoundUseVariantField<TSchema>;
 } & {
     [K in `use${Capitalize<N>}FieldArray`]: BoundUseFieldArray<TSchema, D>;
+} & {
+    [K in `use${Capitalize<N>}VariantFieldArray`]: BoundUseVariantFieldArray<TSchema>;
 } & {
     [K in `use${Capitalize<N>}Selector`]: BoundUseSelector<TSchema>;
 } & {
@@ -452,5 +468,5 @@ declare const dateInputProps: <T extends Date | null | undefined>(field: UseFiel
 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 { ArrayFieldPath, ArrayItemOf, CheckboxField, CreateFormOptions, DateField, DefaultPathDepth, ErrorMap, FieldPath, FieldValidationResult, FieldValue, Form, FormState, InvalidSubmitHandler, NumberField, PathDepth, SelectField, SettledFieldValidationResult, TextField, checkboxProps, createFormContext, createFormHooks, dateInputProps, dateToInputText, focusField, focusFirstError, getAtPath, hasFieldError, numberInputProps, numberToInputText, parseDateText, parseNumberText, parsePath, persistForm, selectProps, setAtPath, textInputProps, useField, useFieldArray, useFields, useForm, useFormAction, useFormActionState, useFormError, useFormSelector, useFormSelectorShallow, useFormSteps, useFormValues, useIsDirty, useIsSubmitting, useIsValid, useIsValidating, useMaskedInput, useNumberInput, usePersistForm, useSubmitCount, useVariantField };
-export type { ArrayPathsOf, BoundUseField, BoundUseFieldArray, BoundUseFields, BoundUseFlag, BoundUseSelector, BoundUseVariantField, CheckboxFieldProps, CheckboxProps, DateFieldProps, DateInputProps, FieldArrayEntry, FieldArrayFormApi, FieldFormApi, FieldPathArg, FieldRef, FormActionHandler, FormActionOptions, FormActionStateHandler, FormContextApi, FormHooks, FormProviderProps, FormStateApi, FormStep, MaskedInputBinding, MaskedInputOptions, MaskedParse, NumberFieldProps, NumberInputBinding, NumberInputProps, ParsedDateText, ParsedNumberText, PathSegment, PathsAccepting, PathsOf, PersistHandle, PersistOptions, PersistStorage, SelectFieldOption, SelectFieldProps, SelectProps, SelectValueAt, StepStatus, TextFieldProps, TextInputProps, UnionValueAt, UseFieldArrayReturn, UseFieldOptions, UseFieldReturn, UseFieldsReturn, UseFormStepsReturn, VariantFieldPath, VariantFieldValue, VariantKeys };
+export { ArrayFieldPath, ArrayItemOf, CheckboxField, CreateFormOptions, DateField, DefaultPathDepth, ErrorMap, FieldPath, FieldValidationResult, FieldValue, Form, FormState, InvalidSubmitHandler, NumberField, PathDepth, SelectField, SettledFieldValidationResult, TextField, checkboxProps, createFormContext, createFormHooks, dateInputProps, dateToInputText, focusField, focusFirstError, getAtPath, hasFieldError, numberInputProps, numberToInputText, parseDateText, parseNumberText, parsePath, persistForm, selectProps, setAtPath, textInputProps, useField, useFieldArray, useFields, useForm, useFormAction, useFormActionState, useFormError, useFormSelector, useFormSelectorShallow, useFormSteps, useFormValues, useIsDirty, useIsSubmitting, useIsValid, useIsValidating, useMaskedInput, useNumberInput, usePersistForm, useSubmitCount, useVariantField, useVariantFieldArray };
+export type { ArrayPathsOf, BoundUseField, BoundUseFieldArray, BoundUseFields, BoundUseFlag, BoundUseSelector, BoundUseVariantField, BoundUseVariantFieldArray, CheckboxFieldProps, CheckboxProps, DateFieldProps, DateInputProps, FieldArrayEntry, FieldArrayFormApi, FieldFormApi, FieldPathArg, FieldRef, FormActionHandler, FormActionOptions, FormActionStateHandler, FormContextApi, FormHooks, FormProviderProps, FormStateApi, FormStep, MaskedInputBinding, MaskedInputOptions, MaskedParse, NumberFieldProps, NumberInputBinding, NumberInputProps, ParsedDateText, ParsedNumberText, PathSegment, PathsAccepting, PathsOf, PersistHandle, PersistOptions, PersistStorage, SelectFieldOption, SelectFieldProps, SelectProps, SelectValueAt, StepStatus, TextFieldProps, TextInputProps, UnionValueAt, UseFieldArrayReturn, UseFieldOptions, UseFieldReturn, UseFieldsReturn, UseFormStepsReturn, VariantArrayFieldPath, VariantFieldPath, VariantFieldValue, VariantKeys };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { P as PathDepth, D as DefaultPathDepth, F as Form, C as CreateFormOptions, a as FormState, b as FieldValidationResult, S as SettledFieldValidationResult, c as FieldPath, d as FieldValue, I as InvalidSubmitHandler, A as ArrayFieldPath, e as ArrayItemOf, E as ErrorMap } from './createForm-BexUOCjZ.js';
-export { B as BoolMap, f as FieldSnapshot, g as FieldsValidationResult, R as ReadonlyStoreApi, h as ResetOptions, i as SettledFieldsValidationResult, j as SettledValidationResult, k as SubmitHandler, l as SubmitOptions, m as SubmitResult, V as ValidationMode, n as ValidationResult, o as ValidationTrigger, p as createForm, q as emptyValueForSchema, r as flattenIssues, s as isAsyncRequiredError, t as isClearableSchema, u as shouldValidateOn, v as validateAsync, w as validateSync } from './createForm-BexUOCjZ.js';
+import { P as PathDepth, D as DefaultPathDepth, F as Form, C as CreateFormOptions, a as FormState, b as FieldValidationResult, S as SettledFieldValidationResult, c as FieldPath, d as FieldValue, I as InvalidSubmitHandler, A as ArrayFieldPath, e as ArrayItemOf, E as ErrorMap } from './createForm-CMVALnc3.js';
+export { B as BoolMap, f as FieldSnapshot, g as FieldsValidationResult, R as ReadonlyStoreApi, h as ResetOptions, i as SettledFieldsValidationResult, j as SettledValidationResult, k as SubmitHandler, l as SubmitOptions, m as SubmitResult, V as ValidationMode, n as ValidationResult, o as ValidationTrigger, p as createForm, q as emptyValueForSchema, r as flattenIssues, s as isAsyncRequiredError, t as isClearableSchema, u as shouldValidateOn, v as validateAsync, w as validateSync } from './createForm-CMVALnc3.js';
 import { z } from 'zod';
 import * as react from 'react';
 import { ChangeEvent, ReactNode } from 'react';
@@ -33,7 +33,7 @@ declare const persistForm: <TSchema extends z.ZodType, D extends PathDepth = Def
 
 declare const usePersistForm: <TSchema extends z.ZodType, D extends PathDepth = DefaultPathDepth>(form: Form<TSchema, D>, options: PersistOptions<TSchema>) => PersistHandle;
 
-declare const useForm: <TSchema extends z.ZodType, D extends PathDepth = DefaultPathDepth>(schema: TSchema, options: CreateFormOptions<TSchema, D>) => Form<TSchema, D>;
+declare const useForm: <TSchema extends z.ZodType, D extends PathDepth = DefaultPathDepth>(schema: TSchema, options: CreateFormOptions<TSchema, D>) => Form<TSchema, NoInfer<D>>;
 
 type ReadonlyStore$2<T> = Pick<StoreApi<T>, "getState" | "getInitialState" | "subscribe">;
 type FieldFormApi = Readonly<{
@@ -68,17 +68,17 @@ type UseFieldReturn<TValue> = Readonly<{
     validateAsync: () => Promise<SettledFieldValidationResult>;
     onBlur: () => void;
 }>;
-declare const inferredCallsOnly$2: unique symbol;
-interface InferredTypeArg$2 {
-    readonly [inferredCallsOnly$2]: typeof inferredCallsOnly$2;
+declare const inferredCallsOnly$3: unique symbol;
+interface InferredTypeArg$3 {
+    readonly [inferredCallsOnly$3]: typeof inferredCallsOnly$3;
 }
 declare function useField<TSchema extends z.ZodType>(form: FieldFormApi & Readonly<{
     schema: TSchema;
     store: ReadonlyStore$2<FormState<z.input<TSchema>>>;
 }>, pathSelector: (state: FormState<z.input<TSchema>>) => string, options?: UseFieldOptions): UseFieldReturn<unknown>;
-declare function useField<TValue = InferredTypeArg$2>(form: FieldFormApi & Readonly<{
+declare function useField<TValue = InferredTypeArg$3>(form: FieldFormApi & Readonly<{
     schema: z.ZodType;
-}>, path: TValue extends InferredTypeArg$2 ? never : "Remove the explicit type argument: a schema-typed form infers the value type from the path", options?: UseFieldOptions): UseFieldReturn<TValue>;
+}>, path: TValue extends InferredTypeArg$3 ? never : "Remove the explicit type argument: a schema-typed form infers the value type from the path", options?: UseFieldOptions): UseFieldReturn<TValue>;
 declare function useField<TValue = unknown>(form: FieldFormApi & {
     readonly schema?: undefined;
 }, path: FieldPathArg<unknown>, options?: UseFieldOptions): UseFieldReturn<TValue>;
@@ -152,13 +152,13 @@ type AllKeys<V> = V extends unknown ? keyof V : never;
 type VariantKeys<V> = Exclude<AllKeys<V>, CommonKeys<V>> & string;
 type VariantFieldPath<V, D extends PathDepth = DefaultPathDepth> = Exclude<V extends unknown ? FieldPath<V, D> : never, (CommonKeys<V> & string) | `${CommonKeys<V> & string}.${string}`> & string;
 type UnionValueAt<TValues, P extends string> = P extends keyof TValues ? NonNullable<TValues[P]> : TValues extends readonly (infer Item)[] ? P extends `${number}` ? NonNullable<Item> : P extends `${infer Head}.${infer Tail}` ? Head extends keyof TValues ? UnionValueAt<NonNullable<TValues[Head]>, Tail> : Head extends `${number}` ? UnionValueAt<NonNullable<Item>, Tail> : never : never : P extends `${infer Head}.${infer Tail}` ? Head extends keyof TValues ? UnionValueAt<NonNullable<TValues[Head]>, Tail> : never : never;
-declare const inferredCallsOnly$1: unique symbol;
-interface InferredTypeArg$1 {
-    readonly [inferredCallsOnly$1]: typeof inferredCallsOnly$1;
+declare const inferredCallsOnly$2: unique symbol;
+interface InferredTypeArg$2 {
+    readonly [inferredCallsOnly$2]: typeof inferredCallsOnly$2;
 }
-declare function useVariantField<TValue = InferredTypeArg$1>(form: FieldFormApi & Readonly<{
+declare function useVariantField<TValue = InferredTypeArg$2>(form: FieldFormApi & Readonly<{
     schema: z.ZodType;
-}>, unionPath: TValue extends InferredTypeArg$1 ? never : "Remove the explicit type argument: a schema-typed form infers the variant value from the union path and field", field: string): UseFieldReturn<TValue | undefined>;
+}>, unionPath: TValue extends InferredTypeArg$2 ? never : "Remove the explicit type argument: a schema-typed form infers the variant value from the union path and field", field: string): UseFieldReturn<TValue | undefined>;
 declare function useVariantField<TValue = unknown>(form: FieldFormApi & {
     readonly schema?: undefined;
 }, unionPath: string, field: string): UseFieldReturn<TValue | undefined>;
@@ -207,22 +207,35 @@ type UseFieldArrayReturn<TItem> = Readonly<{
     prepend: (item: TItem) => void;
     clear: () => void;
 }>;
-declare const inferredCallsOnly: unique symbol;
-interface InferredTypeArg {
-    readonly [inferredCallsOnly]: typeof inferredCallsOnly;
+declare const inferredCallsOnly$1: unique symbol;
+interface InferredTypeArg$1 {
+    readonly [inferredCallsOnly$1]: typeof inferredCallsOnly$1;
 }
 declare function useFieldArray<TSchema extends z.ZodType>(form: FieldArrayFormApi & Readonly<{
     schema: TSchema;
     store: ReadonlyStore$1<FormState<z.input<TSchema>>>;
 }>, pathSelector: (state: FormState<z.input<TSchema>>) => string): UseFieldArrayReturn<unknown>;
-declare function useFieldArray<TItem = InferredTypeArg>(form: FieldArrayFormApi & Readonly<{
+declare function useFieldArray<TItem = InferredTypeArg$1>(form: FieldArrayFormApi & Readonly<{
     schema: z.ZodType;
-}>, path: TItem extends InferredTypeArg ? never : "Remove the explicit type argument: a schema-typed form infers the item type from the path"): UseFieldArrayReturn<TItem>;
+}>, path: TItem extends InferredTypeArg$1 ? never : "Remove the explicit type argument: a schema-typed form infers the item type from the path"): UseFieldArrayReturn<TItem>;
 declare function useFieldArray<TItem = unknown>(form: FieldArrayFormApi & {
     readonly schema?: undefined;
 }, path: FieldPathArg<unknown>): UseFieldArrayReturn<TItem>;
 declare function useFieldArray<TSchema extends z.ZodType, P extends ArrayFieldPath<z.input<TSchema>, D> & string, D extends PathDepth = DefaultPathDepth>(form: Form<TSchema, D>, path: P): UseFieldArrayReturn<ArrayItemOf<FieldValue<z.input<TSchema>, P>>>;
 
+type VariantArrayFieldPath<V, D extends PathDepth = DefaultPathDepth> = Exclude<V extends unknown ? ArrayFieldPath<V, D> : never, (keyof V & string) | `${keyof V & string}.${string}`> & string;
+declare const inferredCallsOnly: unique symbol;
+interface InferredTypeArg {
+    readonly [inferredCallsOnly]: typeof inferredCallsOnly;
+}
+declare function useVariantFieldArray<TItem = InferredTypeArg>(form: FieldArrayFormApi & Readonly<{
+    schema: z.ZodType;
+}>, unionPath: TItem extends InferredTypeArg ? never : "Remove the explicit type argument: a schema-typed form infers the item type from the union path and field", field: string): UseFieldArrayReturn<TItem>;
+declare function useVariantFieldArray<TItem = unknown>(form: FieldArrayFormApi & {
+    readonly schema?: undefined;
+}, unionPath: string, field: string): UseFieldArrayReturn<TItem>;
+declare function useVariantFieldArray<TSchema extends z.ZodType, P extends string, TField extends VariantArrayFieldPath<UnionValueAt<z.input<TSchema>, P>>, D extends PathDepth = DefaultPathDepth>(form: Form<TSchema, D>, unionPath: P, field: TField): UseFieldArrayReturn<ArrayItemOf<VariantFieldValue<UnionValueAt<z.input<TSchema>, P>, TField>>>;
+
 type UseFieldsReturn<TFields extends readonly unknown[]> = Readonly<{
     fields: TFields;
     error: readonly string[] | undefined;
@@ -244,6 +257,7 @@ type BoundUseField<TSchema extends z.ZodType, D extends PathDepth = DefaultPathD
     <P extends FieldPath<z.input<TSchema>, D>>(path: P, options?: UseFieldOptions): UseFieldReturn<FieldValue<z.input<TSchema>, P>>;
 };
 type BoundUseVariantField<TSchema extends z.ZodType> = <P extends string, TField extends VariantFieldPath<UnionValueAt<z.input<TSchema>, P>>>(unionPath: P, field: TField) => UseFieldReturn<VariantFieldValue<UnionValueAt<z.input<TSchema>, P>, TField> | undefined>;
+type BoundUseVariantFieldArray<TSchema extends z.ZodType> = <P extends string, TField extends VariantArrayFieldPath<UnionValueAt<z.input<TSchema>, P>>>(unionPath: P, field: TField) => UseFieldArrayReturn<ArrayItemOf<VariantFieldValue<UnionValueAt<z.input<TSchema>, P>, TField>>>;
 type BoundUseFieldArray<TSchema extends z.ZodType, D extends PathDepth = DefaultPathDepth> = {
     (pathSelector: (state: FormState<z.input<TSchema>>) => string): UseFieldArrayReturn<unknown>;
     <P extends ArrayFieldPath<z.input<TSchema>, D>>(path: P): UseFieldArrayReturn<ArrayItemOf<FieldValue<z.input<TSchema>, P>>>;
@@ -256,6 +270,8 @@ type FormHooks<TSchema extends z.ZodType, N extends string, D extends PathDepth
     [K in `use${Capitalize<N>}VariantField`]: BoundUseVariantField<TSchema>;
 } & {
     [K in `use${Capitalize<N>}FieldArray`]: BoundUseFieldArray<TSchema, D>;
+} & {
+    [K in `use${Capitalize<N>}VariantFieldArray`]: BoundUseVariantFieldArray<TSchema>;
 } & {
     [K in `use${Capitalize<N>}Selector`]: BoundUseSelector<TSchema>;
 } & {
@@ -452,5 +468,5 @@ declare const dateInputProps: <T extends Date | null | undefined>(field: UseFiel
 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 { ArrayFieldPath, ArrayItemOf, CheckboxField, CreateFormOptions, DateField, DefaultPathDepth, ErrorMap, FieldPath, FieldValidationResult, FieldValue, Form, FormState, InvalidSubmitHandler, NumberField, PathDepth, SelectField, SettledFieldValidationResult, TextField, checkboxProps, createFormContext, createFormHooks, dateInputProps, dateToInputText, focusField, focusFirstError, getAtPath, hasFieldError, numberInputProps, numberToInputText, parseDateText, parseNumberText, parsePath, persistForm, selectProps, setAtPath, textInputProps, useField, useFieldArray, useFields, useForm, useFormAction, useFormActionState, useFormError, useFormSelector, useFormSelectorShallow, useFormSteps, useFormValues, useIsDirty, useIsSubmitting, useIsValid, useIsValidating, useMaskedInput, useNumberInput, usePersistForm, useSubmitCount, useVariantField };
-export type { ArrayPathsOf, BoundUseField, BoundUseFieldArray, BoundUseFields, BoundUseFlag, BoundUseSelector, BoundUseVariantField, CheckboxFieldProps, CheckboxProps, DateFieldProps, DateInputProps, FieldArrayEntry, FieldArrayFormApi, FieldFormApi, FieldPathArg, FieldRef, FormActionHandler, FormActionOptions, FormActionStateHandler, FormContextApi, FormHooks, FormProviderProps, FormStateApi, FormStep, MaskedInputBinding, MaskedInputOptions, MaskedParse, NumberFieldProps, NumberInputBinding, NumberInputProps, ParsedDateText, ParsedNumberText, PathSegment, PathsAccepting, PathsOf, PersistHandle, PersistOptions, PersistStorage, SelectFieldOption, SelectFieldProps, SelectProps, SelectValueAt, StepStatus, TextFieldProps, TextInputProps, UnionValueAt, UseFieldArrayReturn, UseFieldOptions, UseFieldReturn, UseFieldsReturn, UseFormStepsReturn, VariantFieldPath, VariantFieldValue, VariantKeys };
+export { ArrayFieldPath, ArrayItemOf, CheckboxField, CreateFormOptions, DateField, DefaultPathDepth, ErrorMap, FieldPath, FieldValidationResult, FieldValue, Form, FormState, InvalidSubmitHandler, NumberField, PathDepth, SelectField, SettledFieldValidationResult, TextField, checkboxProps, createFormContext, createFormHooks, dateInputProps, dateToInputText, focusField, focusFirstError, getAtPath, hasFieldError, numberInputProps, numberToInputText, parseDateText, parseNumberText, parsePath, persistForm, selectProps, setAtPath, textInputProps, useField, useFieldArray, useFields, useForm, useFormAction, useFormActionState, useFormError, useFormSelector, useFormSelectorShallow, useFormSteps, useFormValues, useIsDirty, useIsSubmitting, useIsValid, useIsValidating, useMaskedInput, useNumberInput, usePersistForm, useSubmitCount, useVariantField, useVariantFieldArray };
+export type { ArrayPathsOf, BoundUseField, BoundUseFieldArray, BoundUseFields, BoundUseFlag, BoundUseSelector, BoundUseVariantField, BoundUseVariantFieldArray, CheckboxFieldProps, CheckboxProps, DateFieldProps, DateInputProps, FieldArrayEntry, FieldArrayFormApi, FieldFormApi, FieldPathArg, FieldRef, FormActionHandler, FormActionOptions, FormActionStateHandler, FormContextApi, FormHooks, FormProviderProps, FormStateApi, FormStep, MaskedInputBinding, MaskedInputOptions, MaskedParse, NumberFieldProps, NumberInputBinding, NumberInputProps, ParsedDateText, ParsedNumberText, PathSegment, PathsAccepting, PathsOf, PersistHandle, PersistOptions, PersistStorage, SelectFieldOption, SelectFieldProps, SelectProps, SelectValueAt, StepStatus, TextFieldProps, TextInputProps, UnionValueAt, UseFieldArrayReturn, UseFieldOptions, UseFieldReturn, UseFieldsReturn, UseFormStepsReturn, VariantArrayFieldPath, VariantFieldPath, VariantFieldValue, VariantKeys };

package/dist/index.js

@@ -221,12 +221,32 @@ var fieldSchemaForIntrospection = (schema, path) => {
   );
 };
 var containerKindAt = (schema) => (prefix) => {
-  const sub = fieldSchemaForIntrospection(schema, prefix);
-  if (sub === null) return null;
   const unwrapAll = (s) => {
     const inner2 = unwrapForWalk(s);
     return inner2 === null ? s : unwrapAll(inner2);
   };
+  const step = (s, segment) => {
+    const inner2 = unwrapAll(s);
+    if (inner2 instanceof z.ZodObject && typeof segment === "string") {
+      const shape = inner2.shape;
+      return Object.hasOwn(shape, segment) ? shape[segment] ?? null : null;
+    }
+    if (inner2 instanceof z.ZodArray && typeof segment === "number") {
+      return inner2.element;
+    }
+    if (inner2 instanceof z.ZodTuple && typeof segment === "number") {
+      return inner2.def.items[segment] ?? null;
+    }
+    if (inner2 instanceof z.ZodRecord) {
+      return inner2.valueType;
+    }
+    return null;
+  };
+  const sub = parsePath(prefix).reduce(
+    (current, segment) => current === null ? null : step(current, segment),
+    schema
+  );
+  if (sub === null) return null;
   const inner = unwrapAll(sub);
   if (inner instanceof z.ZodArray || inner instanceof z.ZodTuple) {
     return "array";
@@ -2034,6 +2054,14 @@ function useFieldArray(form, pathArg) {
     ]
   );
 }
+
+// src/react/useVariantFieldArray.ts
+function useVariantFieldArray(form, unionPath, field) {
+  return useFieldArray(
+    form,
+    `${unionPath}.${field}`
+  );
+}
 var useFormError = (form) => useStore(
   form.store,
   useShallow((state) => state.errors[""])
@@ -2112,6 +2140,11 @@ var createFormHooks = (form, name) => {
     field
   );
   const useBoundFieldArray = (path) => useFieldArray(structural, path);
+  const useBoundVariantFieldArray = (unionPath, field) => useVariantFieldArray(
+    structural,
+    unionPath,
+    field
+  );
   const useBoundSelector = (selector) => useFormSelector(structural, selector);
   const useBoundSelectorShallow = (selector) => useFormSelectorShallow(structural, selector);
   const useBoundError = () => useFormError(structural);
@@ -2131,6 +2164,7 @@ var createFormHooks = (form, name) => {
     [`use${prefix}Field`]: useBoundField,
     [`use${prefix}VariantField`]: useBoundVariantField,
     [`use${prefix}FieldArray`]: useBoundFieldArray,
+    [`use${prefix}VariantFieldArray`]: useBoundVariantFieldArray,
     [`use${prefix}Selector`]: useBoundSelector,
     [`use${prefix}SelectorShallow`]: useBoundSelectorShallow,
     [`use${prefix}Error`]: useBoundError,
@@ -2436,6 +2470,6 @@ var focusField = (path, root) => {
   return path === "" ? (root !== void 0 || document.querySelectorAll("form").length <= 1) && focusFirstOf(namedControls(scope).filter(isFocusCandidate)) : focusFirstOf(pathCandidates(scope, [path]).filter(isFocusCandidate));
 };
 
-export { CheckboxField, DateField, NumberField, SelectField, TextField, checkboxProps, createForm, createFormContext, createFormHooks, dateInputProps, dateToInputText, emptyValueForSchema, flattenIssues, focusField, focusFirstError, hasFieldError, isAsyncRequiredError, isClearableSchema, numberInputProps, numberToInputText, parseDateText, parseNumberText, persistForm, selectProps, textInputProps, useField, useFieldArray, useFields, useForm, useFormAction, useFormActionState, useFormError, useFormSteps, useFormValues, useIsDirty, useIsSubmitting, useIsValid, useIsValidating, useMaskedInput, useNumberInput, usePersistForm, useSubmitCount, useVariantField, validateAsync, validateSync };
+export { CheckboxField, DateField, NumberField, SelectField, TextField, checkboxProps, createForm, createFormContext, createFormHooks, dateInputProps, dateToInputText, emptyValueForSchema, flattenIssues, focusField, focusFirstError, hasFieldError, isAsyncRequiredError, isClearableSchema, numberInputProps, numberToInputText, parseDateText, parseNumberText, persistForm, selectProps, textInputProps, useField, useFieldArray, useFields, useForm, useFormAction, useFormActionState, useFormError, useFormSteps, useFormValues, useIsDirty, useIsSubmitting, useIsValid, useIsValidating, useMaskedInput, useNumberInput, usePersistForm, useSubmitCount, useVariantField, useVariantFieldArray, validateAsync, validateSync };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map