formstand 0.17.0 → 0.18.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 FieldValidationResult, S as SettledFieldValidationResult, b as FormState, c as FieldPath, d as FieldValue, E as ErrorMap } from './createForm-D0xLZH-Q.cjs';
-export { B as BoolMap, e as FieldSnapshot, f as FieldsValidationResult, I as InvalidSubmitHandler, R as ReadonlyStoreApi, g as ResetOptions, h as SettledFieldsValidationResult, i as SettledValidationResult, j as SubmitHandler, k as SubmitOptions, l as SubmitResult, V as ValidationMode, m as ValidationResult, n as ValidationTrigger, o as createForm, p as emptyValueForSchema, q as flattenIssues, r as isAsyncRequiredError, s as shouldValidateOn, v as validateAsync, t as validateSync } from './createForm-D0xLZH-Q.cjs';
+import { P as PathDepth, D as DefaultPathDepth, F as Form, C as CreateFormOptions, a as FieldValidationResult, S as SettledFieldValidationResult, b as FormState, c as FieldPath, d as FieldValue, E as ErrorMap } from './createForm-B73p1TgL.cjs';
+export { B as BoolMap, e as FieldSnapshot, f as FieldsValidationResult, I as InvalidSubmitHandler, R as ReadonlyStoreApi, g as ResetOptions, h as SettledFieldsValidationResult, i as SettledValidationResult, j as SubmitHandler, k as SubmitOptions, l as SubmitResult, V as ValidationMode, m as ValidationResult, n as ValidationTrigger, o as createForm, p as emptyValueForSchema, q as flattenIssues, r as isAsyncRequiredError, s as isClearableSchema, t as shouldValidateOn, v as validateAsync, u as validateSync } from './createForm-B73p1TgL.cjs';
 import { z } from 'zod';
 import * as react from 'react';
 import { ReactNode, ChangeEvent } from 'react';
@@ -23,7 +23,7 @@ type PersistOptions<TSchema extends z.ZodType> = Readonly<{
     apply?: "adopt" | "restore" | "manual";
 }>;
 type PersistHandle = Readonly<{
-    restore: () => boolean;
+    load: () => boolean;
     clear: () => void;
     dispose: () => void;
 }>;
@@ -62,6 +62,7 @@ type UseFieldReturn<TValue> = Readonly<{
     value: TValue;
     initialValue: TValue;
     emptyValue: null | undefined;
+    clearable: boolean;
     error: readonly string[] | undefined;
     firstError: string | undefined;
     touched: boolean;

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { P as PathDepth, D as DefaultPathDepth, F as Form, C as CreateFormOptions, a as FieldValidationResult, S as SettledFieldValidationResult, b as FormState, c as FieldPath, d as FieldValue, E as ErrorMap } from './createForm-D0xLZH-Q.js';
-export { B as BoolMap, e as FieldSnapshot, f as FieldsValidationResult, I as InvalidSubmitHandler, R as ReadonlyStoreApi, g as ResetOptions, h as SettledFieldsValidationResult, i as SettledValidationResult, j as SubmitHandler, k as SubmitOptions, l as SubmitResult, V as ValidationMode, m as ValidationResult, n as ValidationTrigger, o as createForm, p as emptyValueForSchema, q as flattenIssues, r as isAsyncRequiredError, s as shouldValidateOn, v as validateAsync, t as validateSync } from './createForm-D0xLZH-Q.js';
+import { P as PathDepth, D as DefaultPathDepth, F as Form, C as CreateFormOptions, a as FieldValidationResult, S as SettledFieldValidationResult, b as FormState, c as FieldPath, d as FieldValue, E as ErrorMap } from './createForm-B73p1TgL.js';
+export { B as BoolMap, e as FieldSnapshot, f as FieldsValidationResult, I as InvalidSubmitHandler, R as ReadonlyStoreApi, g as ResetOptions, h as SettledFieldsValidationResult, i as SettledValidationResult, j as SubmitHandler, k as SubmitOptions, l as SubmitResult, V as ValidationMode, m as ValidationResult, n as ValidationTrigger, o as createForm, p as emptyValueForSchema, q as flattenIssues, r as isAsyncRequiredError, s as isClearableSchema, t as shouldValidateOn, v as validateAsync, u as validateSync } from './createForm-B73p1TgL.js';
 import { z } from 'zod';
 import * as react from 'react';
 import { ReactNode, ChangeEvent } from 'react';
@@ -23,7 +23,7 @@ type PersistOptions<TSchema extends z.ZodType> = Readonly<{
     apply?: "adopt" | "restore" | "manual";
 }>;
 type PersistHandle = Readonly<{
-    restore: () => boolean;
+    load: () => boolean;
     clear: () => void;
     dispose: () => void;
 }>;
@@ -62,6 +62,7 @@ type UseFieldReturn<TValue> = Readonly<{
     value: TValue;
     initialValue: TValue;
     emptyValue: null | undefined;
+    clearable: boolean;
     error: readonly string[] | undefined;
     firstError: string | undefined;
     touched: boolean;

package/dist/index.js

@@ -142,6 +142,7 @@ var emptyValueForSchema = (schema) => {
   };
   return walk(schema, false);
 };
+var isClearableSchema = (schema) => schema instanceof z.ZodOptional || schema instanceof z.ZodNullable || schema instanceof z.ZodDefault || schema instanceof z.ZodPrefault;
 var unwrapForWalk = (s) => {
   if (s instanceof z.ZodOptional || s instanceof z.ZodNullable) {
     return s.unwrap();
@@ -1063,7 +1064,7 @@ var persistForm = (form, options) => {
       return void 0;
     }
   };
-  const restore = () => {
+  const load = () => {
     try {
       const raw = storage === null ? null : storage.getItem(options.key);
       if (raw === null) return false;
@@ -1108,7 +1109,7 @@ var persistForm = (form, options) => {
     }
   };
   if (apply !== "manual") {
-    restore();
+    load();
   }
   const unsubscribe = form.watchValues((values) => {
     cancelPending();
@@ -1122,7 +1123,7 @@ var persistForm = (form, options) => {
     }
   });
   return Object.freeze({
-    restore,
+    load,
     clear: () => {
       cancelPending();
       try {
@@ -1153,7 +1154,7 @@ var usePersistForm = (form, options) => {
   }, [form, key]);
   return useMemo(
     () => ({
-      restore: () => inner.current?.restore() ?? false,
+      load: () => inner.current?.load() ?? false,
       clear: () => inner.current?.clear(),
       // dispose stops THIS component's watching early; the effect cleanup
       // still runs its own dispose harmlessly (persistForm's dispose is
@@ -1217,12 +1218,17 @@ function useField(form, pathArg, options) {
   const path = slice.path;
   const formSchema = form.schema;
   const initialValue = slice.initialValue;
-  const emptyValue = useMemo(() => {
+  const { emptyValue, clearable } = useMemo(() => {
     if (formSchema !== void 0) {
       const sub = fieldSchemaAtPath(formSchema, path);
-      if (sub !== null) return emptyValueForSchema(sub);
+      if (sub !== null) {
+        return {
+          emptyValue: emptyValueForSchema(sub),
+          clearable: isClearableSchema(sub)
+        };
+      }
     }
-    return initialValue === null ? null : void 0;
+    return initialValue === null ? { emptyValue: null, clearable: true } : { emptyValue: void 0, clearable: false };
   }, [formSchema, path, initialValue]);
   const debounceMs = options?.debounceMs;
   const debounceTimerRef = useRef(null);
@@ -1308,6 +1314,7 @@ function useField(form, pathArg, options) {
       value: slice.value,
       initialValue: slice.initialValue,
       emptyValue,
+      clearable,
       error: slice.error,
       // `?.[0]` covers both the undefined channel and an empty array.
       firstError: slice.error?.[0],
@@ -1322,7 +1329,7 @@ function useField(form, pathArg, options) {
       validateAsync: validateAsync2,
       onBlur
     }),
-    [slice, emptyValue, setValue, setTouched, setError, clearError, validate, validateAsync2, onBlur]
+    [slice, emptyValue, clearable, setValue, setTouched, setError, clearError, validate, validateAsync2, onBlur]
   );
 }
 
@@ -1657,9 +1664,7 @@ var textInputProps = (field) => ({
   "aria-invalid": ariaInvalid(field),
   onChange: (e) => {
     const text = e.target.value;
-    field.setValue(
-      text === "" && field.emptyValue === null ? null : text
-    );
+    field.setValue(text === "" && field.clearable ? field.emptyValue : text);
   },
   onBlur: field.onBlur
 });
@@ -1733,9 +1738,7 @@ var selectProps = (field) => ({
   "aria-invalid": ariaInvalid(field),
   onChange: (e) => {
     const v = e.target.value;
-    field.setValue(
-      v === "" && field.emptyValue === null ? null : v
-    );
+    field.setValue(v === "" && field.clearable ? field.emptyValue : v);
   },
   onBlur: field.onBlur
 });
@@ -1942,7 +1945,7 @@ var SelectField = ({
   const field = useField(form, path);
   const a11y = useFieldA11y(field.error);
   const select = selectProps(field);
-  const clearable = field.emptyValue === null;
+  const clearable = field.clearable;
   const hasExplicitEmptyOption = options.some((opt) => opt.value === "");
   const showEmptyOption = !hasExplicitEmptyOption && (clearable || select.value === "" || placeholder !== void 0);
   return /* @__PURE__ */ jsx(
@@ -2031,6 +2034,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, numberInputProps, numberToInputText, parseDateText, parseNumberText, persistForm, selectProps, shouldValidateOn, textInputProps, useField, useFieldArray, useFields, useForm, useFormError, useFormValues, useIsDirty, useIsSubmitting, useIsValid, useIsValidating, 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, shouldValidateOn, textInputProps, useField, useFieldArray, useFields, useForm, useFormError, useFormValues, useIsDirty, useIsSubmitting, useIsValid, useIsValidating, useNumberInput, usePersistForm, useSubmitCount, useVariantField, validateAsync, validateSync };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map