formstand 0.5.0 → 0.7.0

package/dist/index.d.cts

@@ -162,28 +162,8 @@ type FormContextApi<TSchema extends z.ZodType> = Readonly<{
 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;
-
-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>>;
+    store: ReadonlyStore$2<FormState<unknown>>;
     setValue(path: string, value: unknown): void;
     setTouched(path: string, touched?: boolean): void;
     setError(path: string, errors: string | readonly string[]): void;
@@ -218,6 +198,94 @@ declare function useField<TValue = unknown>(form: FieldFormApi & {
 }, path: string | ((state: FormState<unknown>) => string), options?: UseFieldOptions): UseFieldReturn<TValue>;
 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>>;
 
+type ReadonlyStore$1<T> = Pick<StoreApi<T>, "getState" | "getInitialState" | "subscribe">;
+type FieldArrayFormApi = Readonly<{
+    store: ReadonlyStore$1<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;
+}>;
+type ArrayItemOf<T> = [NonNullable<T>] extends [readonly (infer U)[]] ? U : never;
+declare function useFieldArray<TSchema extends z.ZodType>(form: Form<TSchema>, pathSelector: (state: FormState<z.input<TSchema>>) => string): UseFieldArrayReturn<unknown>;
+declare function useFieldArray<TItem = unknown>(form: FieldArrayFormApi & {
+    readonly schema?: undefined;
+}, path: string | ((state: FormState<unknown>) => string)): UseFieldArrayReturn<TItem>;
+declare function useFieldArray<TSchema extends z.ZodType, P extends FieldPath<z.input<TSchema>>>(form: Form<TSchema>, path: P): UseFieldArrayReturn<ArrayItemOf<FieldValue<z.input<TSchema>, P>>>;
+
+type BoundUseField<TSchema extends z.ZodType> = {
+    (pathSelector: (state: FormState<z.input<TSchema>>) => string, options?: UseFieldOptions): UseFieldReturn<unknown>;
+    <P extends FieldPath<z.input<TSchema>>>(path: P, options?: UseFieldOptions): UseFieldReturn<FieldValue<z.input<TSchema>, P>>;
+};
+type BoundUseFieldArray<TSchema extends z.ZodType> = {
+    (pathSelector: (state: FormState<z.input<TSchema>>) => string): UseFieldArrayReturn<unknown>;
+    <P extends FieldPath<z.input<TSchema>>>(path: P): UseFieldArrayReturn<ArrayItemOf<FieldValue<z.input<TSchema>, P>>>;
+};
+type BoundUseSelector<TSchema extends z.ZodType> = <U>(selector: (state: FormState<z.input<TSchema>>) => U) => U;
+type BoundUseFlag<TSchema extends z.ZodType> = (path?: FieldPath<z.input<TSchema>>) => boolean;
+type FormHooks<TSchema extends z.ZodType, N extends string> = Readonly<{
+    [K in `use${Capitalize<N>}Field`]: BoundUseField<TSchema>;
+} & {
+    [K in `use${Capitalize<N>}FieldArray`]: BoundUseFieldArray<TSchema>;
+} & {
+    [K in `use${Capitalize<N>}Selector`]: BoundUseSelector<TSchema>;
+} & {
+    [K in `use${Capitalize<N>}SelectorShallow`]: BoundUseSelector<TSchema>;
+} & {
+    [K in `use${Capitalize<N>}Error`]: () => readonly string[] | undefined;
+} & {
+    [K in `use${Capitalize<N>}IsDirty`]: BoundUseFlag<TSchema>;
+} & {
+    [K in `use${Capitalize<N>}IsValid`]: BoundUseFlag<TSchema>;
+} & {
+    [K in `use${Capitalize<N>}IsSubmitting`]: () => boolean;
+} & {
+    [K in `use${Capitalize<N>}SubmitCount`]: () => number;
+}>;
+declare const createFormHooks: <TSchema extends z.ZodType, N extends string = "">(form: Form<TSchema>, name?: N) => FormHooks<TSchema, N>;
+
+type ReadonlyStore<T> = Pick<StoreApi<T>, "getState" | "getInitialState" | "subscribe">;
+type FormStateApi = Readonly<{
+    store: ReadonlyStore<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;
+
+declare const useFormError: (form: FormStateApi) => readonly string[] | undefined;
+
+declare function useIsDirty(form: FormStateApi & {
+    readonly schema?: undefined;
+}, path?: string): boolean;
+declare function useIsDirty<TSchema extends z.ZodType, P extends FieldPath<z.input<TSchema>>>(form: Form<TSchema>, path?: P): boolean;
+declare function useIsValid(form: FormStateApi & {
+    readonly schema?: undefined;
+}, path?: string): boolean;
+declare function useIsValid<TSchema extends z.ZodType, P extends FieldPath<z.input<TSchema>>>(form: Form<TSchema>, path?: P): boolean;
+declare const useIsSubmitting: (form: FormStateApi) => boolean;
+declare const useSubmitCount: (form: FormStateApi) => number;
+
 type PathsOf<F extends FieldFormApi> = F extends Form<infer TSchema extends z.ZodType> ? FieldPath<z.input<TSchema>> : string;
 type FieldRef<T> = ((instance: T | null) => void) | Readonly<{
     current: T | null;
@@ -264,37 +332,6 @@ declare const SelectField: <T extends string, F extends FieldFormApi>({ form, pa
 declare const focusFirstError: (errors: ErrorMap, root?: ParentNode) => boolean;
 declare const focusField: (path: string, 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;
-}>;
-type ArrayItemOf<T> = [NonNullable<T>] extends [readonly (infer U)[]] ? U : never;
-declare function useFieldArray<TSchema extends z.ZodType>(form: Form<TSchema>, pathSelector: (state: FormState<z.input<TSchema>>) => string): UseFieldArrayReturn<unknown>;
-declare function useFieldArray<TItem = unknown>(form: FieldArrayFormApi & {
-    readonly schema?: undefined;
-}, path: string | ((state: FormState<unknown>) => string)): UseFieldArrayReturn<TItem>;
-declare function useFieldArray<TSchema extends z.ZodType, P extends FieldPath<z.input<TSchema>>>(form: Form<TSchema>, path: P): UseFieldArrayReturn<ArrayItemOf<FieldValue<z.input<TSchema>, P>>>;
-
 type TextInputProps = Readonly<{
     name: string;
     value: string;
@@ -340,4 +377,4 @@ declare const numberInputProps: <T extends number | null | undefined>(field: Use
 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 ParsedNumberText, type PathSegment, type PathsOf, 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, emptyValueForSchema, flattenIssues, focusField, focusFirstError, getAtPath, isAsyncRequiredError, numberInputProps, numberToInputText, parseNumberText, parsePath, selectProps, setAtPath, shouldValidateOn, textInputProps, useField, useFieldArray, useForm, useFormError, useFormSelector, useFormSelectorShallow, useIsDirty, useIsSubmitting, useIsValid, useSubmitCount, validateAsync, validateSync };
+export { type BoolMap, type BoundUseField, type BoundUseFieldArray, type BoundUseFlag, type BoundUseSelector, 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 FormHooks, type FormProviderProps, type FormState, type FormStateApi, type InvalidSubmitHandler, NumberField, type NumberFieldProps, type NumberInputProps, type ParsedNumberText, type PathSegment, type PathsOf, 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, createFormHooks, emptyValueForSchema, flattenIssues, focusField, focusFirstError, getAtPath, isAsyncRequiredError, numberInputProps, numberToInputText, parseNumberText, parsePath, selectProps, setAtPath, shouldValidateOn, textInputProps, useField, useFieldArray, useForm, useFormError, useFormSelector, useFormSelectorShallow, useIsDirty, useIsSubmitting, useIsValid, useSubmitCount, validateAsync, validateSync };

package/dist/index.d.ts

@@ -162,28 +162,8 @@ type FormContextApi<TSchema extends z.ZodType> = Readonly<{
 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;
-
-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>>;
+    store: ReadonlyStore$2<FormState<unknown>>;
     setValue(path: string, value: unknown): void;
     setTouched(path: string, touched?: boolean): void;
     setError(path: string, errors: string | readonly string[]): void;
@@ -218,6 +198,94 @@ declare function useField<TValue = unknown>(form: FieldFormApi & {
 }, path: string | ((state: FormState<unknown>) => string), options?: UseFieldOptions): UseFieldReturn<TValue>;
 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>>;
 
+type ReadonlyStore$1<T> = Pick<StoreApi<T>, "getState" | "getInitialState" | "subscribe">;
+type FieldArrayFormApi = Readonly<{
+    store: ReadonlyStore$1<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;
+}>;
+type ArrayItemOf<T> = [NonNullable<T>] extends [readonly (infer U)[]] ? U : never;
+declare function useFieldArray<TSchema extends z.ZodType>(form: Form<TSchema>, pathSelector: (state: FormState<z.input<TSchema>>) => string): UseFieldArrayReturn<unknown>;
+declare function useFieldArray<TItem = unknown>(form: FieldArrayFormApi & {
+    readonly schema?: undefined;
+}, path: string | ((state: FormState<unknown>) => string)): UseFieldArrayReturn<TItem>;
+declare function useFieldArray<TSchema extends z.ZodType, P extends FieldPath<z.input<TSchema>>>(form: Form<TSchema>, path: P): UseFieldArrayReturn<ArrayItemOf<FieldValue<z.input<TSchema>, P>>>;
+
+type BoundUseField<TSchema extends z.ZodType> = {
+    (pathSelector: (state: FormState<z.input<TSchema>>) => string, options?: UseFieldOptions): UseFieldReturn<unknown>;
+    <P extends FieldPath<z.input<TSchema>>>(path: P, options?: UseFieldOptions): UseFieldReturn<FieldValue<z.input<TSchema>, P>>;
+};
+type BoundUseFieldArray<TSchema extends z.ZodType> = {
+    (pathSelector: (state: FormState<z.input<TSchema>>) => string): UseFieldArrayReturn<unknown>;
+    <P extends FieldPath<z.input<TSchema>>>(path: P): UseFieldArrayReturn<ArrayItemOf<FieldValue<z.input<TSchema>, P>>>;
+};
+type BoundUseSelector<TSchema extends z.ZodType> = <U>(selector: (state: FormState<z.input<TSchema>>) => U) => U;
+type BoundUseFlag<TSchema extends z.ZodType> = (path?: FieldPath<z.input<TSchema>>) => boolean;
+type FormHooks<TSchema extends z.ZodType, N extends string> = Readonly<{
+    [K in `use${Capitalize<N>}Field`]: BoundUseField<TSchema>;
+} & {
+    [K in `use${Capitalize<N>}FieldArray`]: BoundUseFieldArray<TSchema>;
+} & {
+    [K in `use${Capitalize<N>}Selector`]: BoundUseSelector<TSchema>;
+} & {
+    [K in `use${Capitalize<N>}SelectorShallow`]: BoundUseSelector<TSchema>;
+} & {
+    [K in `use${Capitalize<N>}Error`]: () => readonly string[] | undefined;
+} & {
+    [K in `use${Capitalize<N>}IsDirty`]: BoundUseFlag<TSchema>;
+} & {
+    [K in `use${Capitalize<N>}IsValid`]: BoundUseFlag<TSchema>;
+} & {
+    [K in `use${Capitalize<N>}IsSubmitting`]: () => boolean;
+} & {
+    [K in `use${Capitalize<N>}SubmitCount`]: () => number;
+}>;
+declare const createFormHooks: <TSchema extends z.ZodType, N extends string = "">(form: Form<TSchema>, name?: N) => FormHooks<TSchema, N>;
+
+type ReadonlyStore<T> = Pick<StoreApi<T>, "getState" | "getInitialState" | "subscribe">;
+type FormStateApi = Readonly<{
+    store: ReadonlyStore<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;
+
+declare const useFormError: (form: FormStateApi) => readonly string[] | undefined;
+
+declare function useIsDirty(form: FormStateApi & {
+    readonly schema?: undefined;
+}, path?: string): boolean;
+declare function useIsDirty<TSchema extends z.ZodType, P extends FieldPath<z.input<TSchema>>>(form: Form<TSchema>, path?: P): boolean;
+declare function useIsValid(form: FormStateApi & {
+    readonly schema?: undefined;
+}, path?: string): boolean;
+declare function useIsValid<TSchema extends z.ZodType, P extends FieldPath<z.input<TSchema>>>(form: Form<TSchema>, path?: P): boolean;
+declare const useIsSubmitting: (form: FormStateApi) => boolean;
+declare const useSubmitCount: (form: FormStateApi) => number;
+
 type PathsOf<F extends FieldFormApi> = F extends Form<infer TSchema extends z.ZodType> ? FieldPath<z.input<TSchema>> : string;
 type FieldRef<T> = ((instance: T | null) => void) | Readonly<{
     current: T | null;
@@ -264,37 +332,6 @@ declare const SelectField: <T extends string, F extends FieldFormApi>({ form, pa
 declare const focusFirstError: (errors: ErrorMap, root?: ParentNode) => boolean;
 declare const focusField: (path: string, 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;
-}>;
-type ArrayItemOf<T> = [NonNullable<T>] extends [readonly (infer U)[]] ? U : never;
-declare function useFieldArray<TSchema extends z.ZodType>(form: Form<TSchema>, pathSelector: (state: FormState<z.input<TSchema>>) => string): UseFieldArrayReturn<unknown>;
-declare function useFieldArray<TItem = unknown>(form: FieldArrayFormApi & {
-    readonly schema?: undefined;
-}, path: string | ((state: FormState<unknown>) => string)): UseFieldArrayReturn<TItem>;
-declare function useFieldArray<TSchema extends z.ZodType, P extends FieldPath<z.input<TSchema>>>(form: Form<TSchema>, path: P): UseFieldArrayReturn<ArrayItemOf<FieldValue<z.input<TSchema>, P>>>;
-
 type TextInputProps = Readonly<{
     name: string;
     value: string;
@@ -340,4 +377,4 @@ declare const numberInputProps: <T extends number | null | undefined>(field: Use
 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 ParsedNumberText, type PathSegment, type PathsOf, 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, emptyValueForSchema, flattenIssues, focusField, focusFirstError, getAtPath, isAsyncRequiredError, numberInputProps, numberToInputText, parseNumberText, parsePath, selectProps, setAtPath, shouldValidateOn, textInputProps, useField, useFieldArray, useForm, useFormError, useFormSelector, useFormSelectorShallow, useIsDirty, useIsSubmitting, useIsValid, useSubmitCount, validateAsync, validateSync };
+export { type BoolMap, type BoundUseField, type BoundUseFieldArray, type BoundUseFlag, type BoundUseSelector, 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 FormHooks, type FormProviderProps, type FormState, type FormStateApi, type InvalidSubmitHandler, NumberField, type NumberFieldProps, type NumberInputProps, type ParsedNumberText, type PathSegment, type PathsOf, 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, createFormHooks, emptyValueForSchema, flattenIssues, focusField, focusFirstError, getAtPath, isAsyncRequiredError, numberInputProps, numberToInputText, parseNumberText, parsePath, selectProps, setAtPath, shouldValidateOn, textInputProps, useField, useFieldArray, useForm, useFormError, useFormSelector, useFormSelectorShallow, useIsDirty, useIsSubmitting, useIsValid, useSubmitCount, validateAsync, validateSync };

package/dist/index.js

@@ -1,6 +1,6 @@
 import { createStore } from 'zustand/vanilla';
 import { z } from 'zod';
-import { useRef, useEffect, createContext, useMemo, useCallback, useId, useState, useContext } from 'react';
+import { useRef, useEffect, createContext, useMemo, useCallback, useState, useId, useContext } from 'react';
 import { jsxs, jsx } from 'react/jsx-runtime';
 import { useStore } from 'zustand/react';
 import { useShallow } from 'zustand/react/shallow';
@@ -983,29 +983,6 @@ var createFormContext = () => {
   };
   return { Provider, useFormContext };
 };
-function useFormSelector(form, selector) {
-  return useStore(form.store, selector);
-}
-function useFormSelectorShallow(form, selector) {
-  return useStore(form.store, useShallow(selector));
-}
-var useFormError = (form) => useStore(
-  form.store,
-  useShallow((state) => state.errors[""])
-);
-var useIsDirty = (form) => useStore(
-  form.store,
-  (state) => isFieldDirty(state.values, state.initialValues)
-);
-var useIsValid = (form) => useStore(form.store, (state) => {
-  for (const k in state.errors) {
-    const errs = state.errors[k];
-    if (errs !== void 0 && errs.length > 0) return false;
-  }
-  return true;
-});
-var useIsSubmitting = (form) => useStore(form.store, (state) => state.isSubmitting);
-var useSubmitCount = (form) => useStore(form.store, (state) => state.submitCount);
 function useField(form, pathArg, options) {
   const slice = useStore(
     form.store,
@@ -1135,6 +1112,169 @@ function useField(form, pathArg, options) {
     [slice, emptyValue, setValue, setTouched, setError, clearError, validate, validateAsync2, onBlur]
   );
 }
+var EMPTY_ID_STATE = { items: [], ids: [], counter: 0 };
+var EMPTY_ITEMS = [];
+var reconcileIds = (prev, nextItems) => {
+  if (prev.items === nextItems) return prev;
+  if (prev.items.length === nextItems.length && prev.items.every((item, i) => Object.is(item, nextItems[i]))) {
+    return prev;
+  }
+  const buckets = prev.items.reduce((acc, item, i) => {
+    const bucket = acc.get(item);
+    if (bucket === void 0) {
+      acc.set(item, [i]);
+    } else {
+      bucket.push(i);
+    }
+    return acc;
+  }, /* @__PURE__ */ new Map());
+  const matchedIds = nextItems.map((item) => {
+    const prevIndex = buckets.get(item)?.shift();
+    return prevIndex === void 0 ? null : prev.ids[prevIndex] ?? null;
+  });
+  const leftover = [...buckets.values()].flat().sort((a, b) => a - b).map((i) => prev.ids[i]).filter((id) => id !== void 0);
+  const ordinals = matchedIds.reduce((acc, id) => {
+    const count = acc.length === 0 ? 0 : acc[acc.length - 1] ?? 0;
+    acc.push(id === null ? count + 1 : count);
+    return acc;
+  }, []);
+  const unmatched = ordinals.length === 0 ? 0 : ordinals[ordinals.length - 1] ?? 0;
+  const ids = matchedIds.map((id, i) => {
+    if (id !== null) return id;
+    const ordinal = ordinals[i] ?? 0;
+    return leftover[ordinal - 1] ?? `__zfa_${prev.counter + (ordinal - leftover.length)}`;
+  });
+  return {
+    items: nextItems,
+    ids,
+    counter: prev.counter + Math.max(0, unmatched - leftover.length)
+  };
+};
+function useFieldArray(form, pathArg) {
+  const path = useStore(
+    form.store,
+    (state) => typeof pathArg === "function" ? pathArg(state) : pathArg
+  );
+  const slice = useStore(
+    form.store,
+    useShallow((state) => {
+      const value = getAtPath(state.values, path);
+      return {
+        items: Array.isArray(value) ? value : EMPTY_ITEMS,
+        error: state.errors[path]
+      };
+    })
+  );
+  const items = slice.items;
+  const error = slice.error;
+  const [idEntry, setIdEntry] = useState({ form, path, state: EMPTY_ID_STATE });
+  const base = idEntry.form === form && idEntry.path === path ? idEntry.state : { ...EMPTY_ID_STATE, counter: idEntry.state.counter };
+  const nextIdState = reconcileIds(base, items);
+  if (idEntry.form !== form || idEntry.path !== path || idEntry.state !== nextIdState) {
+    setIdEntry({ form, path, state: nextIdState });
+  }
+  const ids = nextIdState.ids;
+  const push = useCallback(
+    (item) => form.arrayPush(path, item),
+    [form, path]
+  );
+  const remove = useCallback(
+    (index) => form.arrayRemove(path, index),
+    [form, path]
+  );
+  const insert = useCallback(
+    (index, item) => form.arrayInsert(path, index, item),
+    [form, path]
+  );
+  const move = useCallback(
+    (from, to) => form.arrayMove(path, from, to),
+    [form, path]
+  );
+  const swap = useCallback(
+    (a, b) => form.arraySwap(path, a, b),
+    [form, path]
+  );
+  const fields = useMemo(
+    () => items.map((value, index) => ({
+      id: ids[index] ?? `__zfa_fallback_${index}`,
+      value
+    })),
+    [items, ids]
+  );
+  return useMemo(
+    () => ({
+      fields,
+      items,
+      length: items.length,
+      error,
+      push,
+      remove,
+      insert,
+      move,
+      swap
+    }),
+    [fields, items, error, push, remove, insert, move, swap]
+  );
+}
+var useFormError = (form) => useStore(
+  form.store,
+  useShallow((state) => state.errors[""])
+);
+function useIsDirty(form, path) {
+  return useStore(
+    form.store,
+    (state) => path === void 0 || path === "" ? isFieldDirty(state.values, state.initialValues) : isFieldDirty(
+      getAtPath(state.values, path),
+      getAtPath(state.initialValues, path)
+    )
+  );
+}
+function useIsValid(form, path) {
+  return useStore(form.store, (state) => {
+    for (const k in state.errors) {
+      const errs = state.errors[k];
+      if (errs !== void 0 && errs.length > 0 && (path === void 0 || path === "" || isPathOrChild(k, path))) {
+        return false;
+      }
+    }
+    return true;
+  });
+}
+var useIsSubmitting = (form) => useStore(form.store, (state) => state.isSubmitting);
+var useSubmitCount = (form) => useStore(form.store, (state) => state.submitCount);
+function useFormSelector(form, selector) {
+  return useStore(form.store, selector);
+}
+function useFormSelectorShallow(form, selector) {
+  return useStore(form.store, useShallow(selector));
+}
+
+// src/react/createFormHooks.ts
+var capitalize = (name) => name.length === 0 ? name : name.charAt(0).toUpperCase() + name.slice(1);
+var createFormHooks = (form, name) => {
+  const structural = form;
+  const useBoundField = (path, options) => useField(structural, path, options);
+  const useBoundFieldArray = (path) => useFieldArray(structural, path);
+  const useBoundSelector = (selector) => useFormSelector(structural, selector);
+  const useBoundSelectorShallow = (selector) => useFormSelectorShallow(structural, selector);
+  const useBoundError = () => useFormError(structural);
+  const useBoundIsDirty = (path) => useIsDirty(structural, path);
+  const useBoundIsValid = (path) => useIsValid(structural, path);
+  const useBoundIsSubmitting = () => useIsSubmitting(structural);
+  const useBoundSubmitCount = () => useSubmitCount(structural);
+  const prefix = capitalize(name ?? "");
+  return {
+    [`use${prefix}Field`]: useBoundField,
+    [`use${prefix}FieldArray`]: useBoundFieldArray,
+    [`use${prefix}Selector`]: useBoundSelector,
+    [`use${prefix}SelectorShallow`]: useBoundSelectorShallow,
+    [`use${prefix}Error`]: useBoundError,
+    [`use${prefix}IsDirty`]: useBoundIsDirty,
+    [`use${prefix}IsValid`]: useBoundIsValid,
+    [`use${prefix}IsSubmitting`]: useBoundIsSubmitting,
+    [`use${prefix}SubmitCount`]: useBoundSubmitCount
+  };
+};
 
 // src/react/inputProps.ts
 var ariaInvalid = (field) => field.error !== void 0 && field.error.length > 0 ? true : void 0;
@@ -1389,111 +1529,7 @@ var focusField = (path, root) => {
   const controls = focusableControls(root ?? document);
   return path === "" ? (root !== void 0 || document.querySelectorAll("form").length <= 1) && focusFirstOf(controls) : focusFirstOf(controls.filter((el) => nameMatchesAny(el, [path])));
 };
-var EMPTY_ID_STATE = { items: [], ids: [], counter: 0 };
-var EMPTY_ITEMS = [];
-var reconcileIds = (prev, nextItems) => {
-  if (prev.items === nextItems) return prev;
-  if (prev.items.length === nextItems.length && prev.items.every((item, i) => Object.is(item, nextItems[i]))) {
-    return prev;
-  }
-  const buckets = prev.items.reduce((acc, item, i) => {
-    const bucket = acc.get(item);
-    if (bucket === void 0) {
-      acc.set(item, [i]);
-    } else {
-      bucket.push(i);
-    }
-    return acc;
-  }, /* @__PURE__ */ new Map());
-  const matchedIds = nextItems.map((item) => {
-    const prevIndex = buckets.get(item)?.shift();
-    return prevIndex === void 0 ? null : prev.ids[prevIndex] ?? null;
-  });
-  const leftover = [...buckets.values()].flat().sort((a, b) => a - b).map((i) => prev.ids[i]).filter((id) => id !== void 0);
-  const ordinals = matchedIds.reduce((acc, id) => {
-    const count = acc.length === 0 ? 0 : acc[acc.length - 1] ?? 0;
-    acc.push(id === null ? count + 1 : count);
-    return acc;
-  }, []);
-  const unmatched = ordinals.length === 0 ? 0 : ordinals[ordinals.length - 1] ?? 0;
-  const ids = matchedIds.map((id, i) => {
-    if (id !== null) return id;
-    const ordinal = ordinals[i] ?? 0;
-    return leftover[ordinal - 1] ?? `__zfa_${prev.counter + (ordinal - leftover.length)}`;
-  });
-  return {
-    items: nextItems,
-    ids,
-    counter: prev.counter + Math.max(0, unmatched - leftover.length)
-  };
-};
-function useFieldArray(form, pathArg) {
-  const path = useStore(
-    form.store,
-    (state) => typeof pathArg === "function" ? pathArg(state) : pathArg
-  );
-  const slice = useStore(
-    form.store,
-    useShallow((state) => {
-      const value = getAtPath(state.values, path);
-      return {
-        items: Array.isArray(value) ? value : EMPTY_ITEMS,
-        error: state.errors[path]
-      };
-    })
-  );
-  const items = slice.items;
-  const error = slice.error;
-  const [idEntry, setIdEntry] = useState({ form, path, state: EMPTY_ID_STATE });
-  const base = idEntry.form === form && idEntry.path === path ? idEntry.state : { ...EMPTY_ID_STATE, counter: idEntry.state.counter };
-  const nextIdState = reconcileIds(base, items);
-  if (idEntry.form !== form || idEntry.path !== path || idEntry.state !== nextIdState) {
-    setIdEntry({ form, path, state: nextIdState });
-  }
-  const ids = nextIdState.ids;
-  const push = useCallback(
-    (item) => form.arrayPush(path, item),
-    [form, path]
-  );
-  const remove = useCallback(
-    (index) => form.arrayRemove(path, index),
-    [form, path]
-  );
-  const insert = useCallback(
-    (index, item) => form.arrayInsert(path, index, item),
-    [form, path]
-  );
-  const move = useCallback(
-    (from, to) => form.arrayMove(path, from, to),
-    [form, path]
-  );
-  const swap = useCallback(
-    (a, b) => form.arraySwap(path, a, b),
-    [form, path]
-  );
-  const fields = useMemo(
-    () => items.map((value, index) => ({
-      id: ids[index] ?? `__zfa_fallback_${index}`,
-      value
-    })),
-    [items, ids]
-  );
-  return useMemo(
-    () => ({
-      fields,
-      items,
-      length: items.length,
-      error,
-      push,
-      remove,
-      insert,
-      move,
-      swap
-    }),
-    [fields, items, error, push, remove, insert, move, swap]
-  );
-}
 
-export { CheckboxField, NumberField, SelectField, TextField, checkboxProps, createForm, createFormContext, emptyValueForSchema, flattenIssues, focusField, focusFirstError, getAtPath, isAsyncRequiredError, numberInputProps, numberToInputText, parseNumberText, parsePath, selectProps, setAtPath, shouldValidateOn, textInputProps, useField, useFieldArray, useForm, useFormError, useFormSelector, useFormSelectorShallow, useIsDirty, useIsSubmitting, useIsValid, useSubmitCount, validateAsync, validateSync };
+export { CheckboxField, NumberField, SelectField, TextField, checkboxProps, createForm, createFormContext, createFormHooks, emptyValueForSchema, flattenIssues, focusField, focusFirstError, getAtPath, isAsyncRequiredError, numberInputProps, numberToInputText, parseNumberText, parsePath, selectProps, setAtPath, shouldValidateOn, textInputProps, useField, useFieldArray, useForm, useFormError, useFormSelector, useFormSelectorShallow, useIsDirty, useIsSubmitting, useIsValid, useSubmitCount, validateAsync, validateSync };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map