formstand 0.22.1 → 0.24.0

package/dist/index.d.cts

@@ -1,14 +1,16 @@
-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-BJum0RBu.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-BJum0RBu.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-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 { z } from 'zod';
 import * as react from 'react';
 import { ChangeEvent, ReactNode } from 'react';
 import { StoreApi } from 'zustand/vanilla';
 
 type PathSegment = string | number;
+type ContainerKind = "array" | "record";
+type ContainerKindAt = (prefix: string) => ContainerKind | null;
 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 setAtPath: <T>(obj: T, path: string, value: unknown, containerKindAt?: ContainerKindAt) => T;
 
 type PersistStorage = Readonly<{
     getItem: (key: string) => string | null;
@@ -173,6 +175,8 @@ type FieldArrayFormApi = Readonly<{
     validateField?(path: string): FieldValidationResult;
     setError?(path: string, errors: string | readonly string[]): void;
     clearErrors?(path?: string): void;
+    setTouched?(path: string, touched?: boolean): void;
+    setValue?(path: string, value: unknown): void;
 }>;
 type FieldArrayEntry<TItem> = Readonly<{
     id: string;
@@ -187,11 +191,21 @@ type UseFieldArrayReturn<TItem> = Readonly<{
     firstError: string | undefined;
     setError: (errors: string | readonly string[]) => void;
     clearError: () => void;
+    touched: boolean;
+    dirty: boolean;
+    isValidating: boolean;
+    setTouched: (touched?: boolean) => void;
+    onBlur: () => void;
+    validate: () => FieldValidationResult;
     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;
+    replace: (items: readonly TItem[]) => void;
+    update: (index: number, item: TItem) => void;
+    prepend: (item: TItem) => void;
+    clear: () => void;
 }>;
 declare const inferredCallsOnly: unique symbol;
 interface InferredTypeArg {
@@ -438,4 +452,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, type ArrayPathsOf, type BoundUseField, type BoundUseFieldArray, type BoundUseFields, type BoundUseFlag, type BoundUseSelector, type BoundUseVariantField, CheckboxField, type CheckboxFieldProps, type CheckboxProps, CreateFormOptions, DateField, type DateFieldProps, type DateInputProps, DefaultPathDepth, ErrorMap, type FieldArrayEntry, type FieldArrayFormApi, type FieldFormApi, FieldPath, type FieldPathArg, type FieldRef, FieldValidationResult, FieldValue, Form, type FormActionHandler, type FormActionOptions, type FormActionStateHandler, type FormContextApi, type FormHooks, type FormProviderProps, FormState, type FormStateApi, type FormStep, InvalidSubmitHandler, type MaskedInputBinding, type MaskedInputOptions, type MaskedParse, NumberField, type NumberFieldProps, type NumberInputBinding, type NumberInputProps, type ParsedDateText, type ParsedNumberText, PathDepth, type PathSegment, type PathsAccepting, type PathsOf, type PersistHandle, type PersistOptions, type PersistStorage, SelectField, type SelectFieldOption, type SelectFieldProps, type SelectProps, type SelectValueAt, SettledFieldValidationResult, type StepStatus, TextField, type TextFieldProps, type TextInputProps, type UnionValueAt, type UseFieldArrayReturn, type UseFieldOptions, type UseFieldReturn, type UseFieldsReturn, type UseFormStepsReturn, type VariantFieldPath, type VariantFieldValue, type VariantKeys, 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 { 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 };

package/dist/index.d.ts

@@ -1,14 +1,16 @@
-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-BJum0RBu.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-BJum0RBu.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-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 { z } from 'zod';
 import * as react from 'react';
 import { ChangeEvent, ReactNode } from 'react';
 import { StoreApi } from 'zustand/vanilla';
 
 type PathSegment = string | number;
+type ContainerKind = "array" | "record";
+type ContainerKindAt = (prefix: string) => ContainerKind | null;
 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 setAtPath: <T>(obj: T, path: string, value: unknown, containerKindAt?: ContainerKindAt) => T;
 
 type PersistStorage = Readonly<{
     getItem: (key: string) => string | null;
@@ -173,6 +175,8 @@ type FieldArrayFormApi = Readonly<{
     validateField?(path: string): FieldValidationResult;
     setError?(path: string, errors: string | readonly string[]): void;
     clearErrors?(path?: string): void;
+    setTouched?(path: string, touched?: boolean): void;
+    setValue?(path: string, value: unknown): void;
 }>;
 type FieldArrayEntry<TItem> = Readonly<{
     id: string;
@@ -187,11 +191,21 @@ type UseFieldArrayReturn<TItem> = Readonly<{
     firstError: string | undefined;
     setError: (errors: string | readonly string[]) => void;
     clearError: () => void;
+    touched: boolean;
+    dirty: boolean;
+    isValidating: boolean;
+    setTouched: (touched?: boolean) => void;
+    onBlur: () => void;
+    validate: () => FieldValidationResult;
     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;
+    replace: (items: readonly TItem[]) => void;
+    update: (index: number, item: TItem) => void;
+    prepend: (item: TItem) => void;
+    clear: () => void;
 }>;
 declare const inferredCallsOnly: unique symbol;
 interface InferredTypeArg {
@@ -438,4 +452,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, type ArrayPathsOf, type BoundUseField, type BoundUseFieldArray, type BoundUseFields, type BoundUseFlag, type BoundUseSelector, type BoundUseVariantField, CheckboxField, type CheckboxFieldProps, type CheckboxProps, CreateFormOptions, DateField, type DateFieldProps, type DateInputProps, DefaultPathDepth, ErrorMap, type FieldArrayEntry, type FieldArrayFormApi, type FieldFormApi, FieldPath, type FieldPathArg, type FieldRef, FieldValidationResult, FieldValue, Form, type FormActionHandler, type FormActionOptions, type FormActionStateHandler, type FormContextApi, type FormHooks, type FormProviderProps, FormState, type FormStateApi, type FormStep, InvalidSubmitHandler, type MaskedInputBinding, type MaskedInputOptions, type MaskedParse, NumberField, type NumberFieldProps, type NumberInputBinding, type NumberInputProps, type ParsedDateText, type ParsedNumberText, PathDepth, type PathSegment, type PathsAccepting, type PathsOf, type PersistHandle, type PersistOptions, type PersistStorage, SelectField, type SelectFieldOption, type SelectFieldProps, type SelectProps, type SelectValueAt, SettledFieldValidationResult, type StepStatus, TextField, type TextFieldProps, type TextInputProps, type UnionValueAt, type UseFieldArrayReturn, type UseFieldOptions, type UseFieldReturn, type UseFieldsReturn, type UseFormStepsReturn, type VariantFieldPath, type VariantFieldValue, type VariantKeys, 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 { 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 };

package/dist/index.js

@@ -1,5 +1,5 @@
-import { isDevToolsBuild, getAtPath, isDevBuild, slotAtPath, setAtPath, isPlainObject, hasOwnSlot, valuesEqual, useFormSelectorShallow, isFieldDirty, useFormSelector, parsePath } from './chunk-BMXIZEI4.js';
-export { getAtPath, parsePath, setAtPath, useFormSelector, useFormSelectorShallow } from './chunk-BMXIZEI4.js';
+import { isDevToolsBuild, getAtPath, isDevBuild, slotAtPath, setAtPath, isPlainObject, hasOwnSlot, valuesEqual, useFormSelectorShallow, isFieldDirty, useFormSelector, parsePath } from './chunk-EQIS5IVH.js';
+export { getAtPath, parsePath, setAtPath, useFormSelector, useFormSelectorShallow } from './chunk-EQIS5IVH.js';
 import { flagAt, entryAt, shouldValidateOn } from './chunk-V3PDMTPP.js';
 export { shouldValidateOn } from './chunk-V3PDMTPP.js';
 import { createStore } from 'zustand/vanilla';
@@ -203,6 +203,9 @@ var fieldSchemaForIntrospection = (schema, path) => {
     if (s instanceof z.ZodTuple && typeof segment === "number") {
       return s.def.items[segment] ?? null;
     }
+    if (s instanceof z.ZodRecord) {
+      return s.valueType;
+    }
     if (s instanceof z.ZodDiscriminatedUnion || s instanceof z.ZodUnion) {
       const options = s.def.options;
       return options.reduce(
@@ -217,6 +220,42 @@ var fieldSchemaForIntrospection = (schema, path) => {
     schema
   );
 };
+var containerKindAt = (schema) => (prefix) => {
+  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";
+  }
+  if (inner instanceof z.ZodObject || inner instanceof z.ZodRecord) {
+    return "record";
+  }
+  return null;
+};
 var fieldSchemaAtPath = (schema, path) => parsePath(path).reduce((current, segment) => {
   if (current === null || hasChecks(current)) return null;
   if (current instanceof z.ZodObject && typeof segment === "string") {
@@ -320,6 +359,7 @@ var releaseChangedSlices = (server, prevValues, nextValues) => {
 };
 var createForm = (schema, options) => {
   const initialMode = options.mode ?? "onBlur";
+  const kindAt = containerKindAt(schema);
   const initialReValidateMode = options.reValidateMode ?? "onChange";
   const initial = {
     values: options.initialValues,
@@ -677,7 +717,7 @@ var createForm = (schema, options) => {
     }
     const arr = Array.isArray(current) ? current : [];
     const next = nextArray(arr);
-    const written = setAtPath(store.getState().values, path, next);
+    const written = setAtPath(store.getState().values, path, next, kindAt);
     clearArrayOpsUnder(store, path, true);
     if (Array.isArray(current) && getAtPath(written, path) === next) {
       recordArrayOp(store, path, {
@@ -839,7 +879,7 @@ var createForm = (schema, options) => {
       clearArrayOpsUnder(store, path);
       store.setState((state) => ({
         ...state,
-        values: setAtPath(state.values, path, value),
+        values: setAtPath(state.values, path, value, kindAt),
         ...errorChannels(state, {
           serverErrors: releaseSpine(state.serverErrors, path)
         })
@@ -986,7 +1026,7 @@ var createForm = (schema, options) => {
       }
       store.setState((state) => ({
         ...state,
-        values: initialSlot.exists ? setAtPath(state.values, path, initialSlot.value) : state.values,
+        values: initialSlot.exists ? setAtPath(state.values, path, initialSlot.value, kindAt) : state.values,
         // A runtime "" path scopes the whole form (the imperative surface is
         // string-typed even though FieldPath excludes ""). Server entries
         // follow the setValue release contract (releaseSpine).
@@ -1845,7 +1885,10 @@ function useFieldArray(form, pathArg) {
         items: Array.isArray(value) ? value : EMPTY_ITEMS,
         // Own-key read, like useField: an array named "constructor" must
         // not read Object as its error list.
-        error: entryAt(state.errors, path)
+        error: entryAt(state.errors, path),
+        touched: flagAt(state.touched, path),
+        dirty: isFieldDirty(value, getAtPath(state.initialValues, path)),
+        isValidating: flagAt(state.isValidating, path)
       };
     })
   );
@@ -1914,6 +1957,52 @@ function useFieldArray(form, pathArg) {
     [form, path]
   );
   const clearError = useCallback(() => form.clearErrors?.(path), [form, path]);
+  const setTouched = useCallback(
+    (touched) => form.setTouched?.(path, touched),
+    [form, path]
+  );
+  const onBlur = useCallback(() => {
+    form.setTouched?.(path, true);
+    const state = form.store.getState();
+    if (shouldValidateOn(
+      "blur",
+      state.mode,
+      state.reValidateMode,
+      state.submitCount > 0,
+      true
+    )) {
+      form.validateField?.(path);
+    }
+  }, [form, path]);
+  const validate = useCallback(
+    () => form.validateField?.(path) ?? { kind: "valid" },
+    [form, path]
+  );
+  const replace = useCallback(
+    (next) => {
+      form.setValue?.(path, next);
+      revalidate();
+    },
+    [form, path, revalidate]
+  );
+  const update = useCallback(
+    (index, item) => {
+      form.setValue?.(`${path}.${index}`, item);
+      revalidate();
+    },
+    [form, path, revalidate]
+  );
+  const prepend = useCallback(
+    (item) => {
+      form.arrayInsert(path, 0, item);
+      revalidate();
+    },
+    [form, path, revalidate]
+  );
+  const clear = useCallback(() => {
+    form.setValue?.(path, []);
+    revalidate();
+  }, [form, path, revalidate]);
   return useMemo(
     () => ({
       path,
@@ -1924,13 +2013,45 @@ function useFieldArray(form, pathArg) {
       firstError: error?.[0],
       setError,
       clearError,
+      touched: slice.touched,
+      dirty: slice.dirty,
+      isValidating: slice.isValidating,
+      setTouched,
+      onBlur,
+      validate,
       push,
       remove,
       insert,
       move,
-      swap
+      swap,
+      replace,
+      update,
+      prepend,
+      clear
     }),
-    [path, fields, items, error, setError, clearError, push, remove, insert, move, swap]
+    [
+      path,
+      fields,
+      items,
+      error,
+      setError,
+      clearError,
+      slice.touched,
+      slice.dirty,
+      slice.isValidating,
+      setTouched,
+      onBlur,
+      validate,
+      push,
+      remove,
+      insert,
+      move,
+      swap,
+      replace,
+      update,
+      prepend,
+      clear
+    ]
   );
 }
 var useFormError = (form) => useStore(