solid-hook-form 2.3.0 → 2.4.0

package/dist/main.d.ts

@@ -29,6 +29,11 @@ type FieldError = {
     message?: Message;
 };
 type FieldErrors<F extends FormValues = FormValues> = Partial<Record<Path<F>, FieldError>>;
+type SetErrorOptions = {
+    shouldFocus?: boolean;
+};
+type SetError<F extends FormValues = FormValues> = (name: Path<F>, error: FieldError, options?: SetErrorOptions) => void;
+type ClearErrors<F extends FormValues = FormValues> = (name?: Path<F> | Path<F>[]) => void;
 
 type Ref = HTMLElement | null;
 type RegisterReturn<F extends FormValues> = {
@@ -120,6 +125,8 @@ type CreateFormReturn<F extends FormValues = FormValues> = {
     setValue: SetValue<F>;
     handleSubmit: HandleSubmit<F>;
     reset: Reset<F>;
+    setError: SetError<F>;
+    clearErrors: ClearErrors<F>;
     trigger: Trigger<F>;
 };
 type CreateForm = <F extends FormValues>(arg: CreateFormArg<F>) => CreateFormReturn<F>;

package/dist/main.js

@@ -1,5 +1,5 @@
 import { createContext, createSignal, createMemo, useContext } from 'solid-js';
-import { createStore, reconcile, produce } from 'solid-js/store';
+import { createStore, produce, reconcile } from 'solid-js/store';
 import { memo, createComponent } from 'solid-js/web';
 
 // src/create_form.ts
@@ -88,7 +88,7 @@ var createErrors = () => {
       })
     );
   };
-  const removeError = (name) => {
+  const clearError = (name) => {
     setErrors(
       produce((prevState) => {
         delete prevState[name];
@@ -101,12 +101,30 @@ var createErrors = () => {
     }
     setErrors(reconcile({}));
   };
+  const clearErrors = (name) => {
+    if (!name) {
+      resetErrors();
+      return;
+    }
+    if (typeof name === "string") {
+      clearError(name);
+      return;
+    }
+    setErrors(
+      produce((prevState) => {
+        name.forEach((name2) => {
+          delete prevState[name2];
+        });
+      })
+    );
+  };
   return {
     errors,
     appendError,
-    removeError,
+    clearError,
     resetErrors,
-    getError
+    getError,
+    clearErrors
   };
 };
 
@@ -119,10 +137,14 @@ var createFields = () => {
   const setField = (name, element) => {
     fields[name] = element;
   };
+  const focusField = (name) => {
+    getField(name)?.focus();
+  };
   return {
     fields,
     getField,
-    setField
+    setField,
+    focusField
   };
 };
 
@@ -294,25 +316,25 @@ var getResolverFields = (fields) => {
 // src/create_form.ts
 var createForm = (arg) => {
   const { defaultValues, mode = "onChange", resolver } = arg;
-  const { fields, getField, setField } = createFields();
+  const { fields, getField, setField, focusField } = createFields();
   const { rules, addRule, getRule } = createRules();
   const [values, setValues] = createSignal(structuredClone(defaultValues));
-  const { errors, appendError, removeError, resetErrors, getError } = createErrors();
+  const { errors, appendError, clearError, resetErrors, clearErrors, getError } = createErrors();
   const { touchedFields, addTouched, resetTouched } = createTouchedFields();
   const { dirtyFields, isDirty, checkDirty, resetDirty } = createDirtyFields(defaultValues);
   const { isSubmitted, submitCount, logSubmit, resetSubmit } = createSubmit();
   const isValid = createMemo(() => {
     return !Object.keys(errors).length;
   });
-  const setFieldError = (name, error) => {
+  const setError = (name, error, options) => {
     const field = getField(name);
     if (field) {
       error.ref = field;
     }
     appendError(name, error);
-  };
-  const clearFieldError = (name) => {
-    removeError(name);
+    if (options?.shouldFocus) {
+      focusField(name);
+    }
   };
   const runSchema = async (names) => {
     if (!resolver) {
@@ -325,9 +347,9 @@ var createForm = (arg) => {
     for (const name of names) {
       const error = get(result.errors, name);
       if (error) {
-        setFieldError(name, error);
+        setError(name, error);
       } else {
-        clearFieldError(name);
+        clearError(name);
       }
     }
   };
@@ -339,9 +361,9 @@ var createForm = (arg) => {
     const rule = getRule(name);
     const error = validate(values(), name, rule);
     if (error) {
-      setFieldError(name, error);
+      setError(name, error);
     } else {
-      clearFieldError(name);
+      clearError(name);
     }
   };
   const validateAllFields = async () => {
@@ -489,6 +511,8 @@ var createForm = (arg) => {
     setValue,
     handleSubmit,
     reset,
+    setError,
+    clearErrors,
     trigger
   };
 };

package/dist/main.jsx

@@ -91,7 +91,7 @@ var createErrors = () => {
       })
     );
   };
-  const removeError = (name) => {
+  const clearError = (name) => {
     setErrors(
       produce((prevState) => {
         delete prevState[name];
@@ -104,12 +104,30 @@ var createErrors = () => {
     }
     setErrors(reconcile({}));
   };
+  const clearErrors = (name) => {
+    if (!name) {
+      resetErrors();
+      return;
+    }
+    if (typeof name === "string") {
+      clearError(name);
+      return;
+    }
+    setErrors(
+      produce((prevState) => {
+        name.forEach((name2) => {
+          delete prevState[name2];
+        });
+      })
+    );
+  };
   return {
     errors,
     appendError,
-    removeError,
+    clearError,
     resetErrors,
-    getError
+    getError,
+    clearErrors
   };
 };
 
@@ -122,10 +140,14 @@ var createFields = () => {
   const setField = (name, element) => {
     fields[name] = element;
   };
+  const focusField = (name) => {
+    getField(name)?.focus();
+  };
   return {
     fields,
     getField,
-    setField
+    setField,
+    focusField
   };
 };
 
@@ -303,25 +325,25 @@ var getResolverFields = (fields) => {
 // src/create_form.ts
 var createForm = (arg) => {
   const { defaultValues, mode = "onChange", resolver } = arg;
-  const { fields, getField, setField } = createFields();
+  const { fields, getField, setField, focusField } = createFields();
   const { rules, addRule, getRule } = createRules();
   const [values, setValues] = createSignal4(structuredClone(defaultValues));
-  const { errors, appendError, removeError, resetErrors, getError } = createErrors();
+  const { errors, appendError, clearError, resetErrors, clearErrors, getError } = createErrors();
   const { touchedFields, addTouched, resetTouched } = createTouchedFields();
   const { dirtyFields, isDirty, checkDirty, resetDirty } = createDirtyFields(defaultValues);
   const { isSubmitted, submitCount, logSubmit, resetSubmit } = createSubmit();
   const isValid = createMemo2(() => {
     return !Object.keys(errors).length;
   });
-  const setFieldError = (name, error) => {
+  const setError = (name, error, options) => {
     const field = getField(name);
     if (field) {
       error.ref = field;
     }
     appendError(name, error);
-  };
-  const clearFieldError = (name) => {
-    removeError(name);
+    if (options?.shouldFocus) {
+      focusField(name);
+    }
   };
   const runSchema = async (names) => {
     if (!resolver) {
@@ -334,9 +356,9 @@ var createForm = (arg) => {
     for (const name of names) {
       const error = get(result.errors, name);
       if (error) {
-        setFieldError(name, error);
+        setError(name, error);
       } else {
-        clearFieldError(name);
+        clearError(name);
       }
     }
   };
@@ -348,9 +370,9 @@ var createForm = (arg) => {
     const rule = getRule(name);
     const error = validate(values(), name, rule);
     if (error) {
-      setFieldError(name, error);
+      setError(name, error);
     } else {
-      clearFieldError(name);
+      clearError(name);
     }
   };
   const validateAllFields = async () => {
@@ -498,6 +520,8 @@ var createForm = (arg) => {
     setValue,
     handleSubmit,
     reset,
+    setError,
+    clearErrors,
     trigger
   };
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "solid-hook-form",
-  "version": "2.3.0",
+  "version": "2.4.0",
   "type": "module",
   "main": "./dist/main.js",
   "module": "./dist/main.js",