Refactor

apps/showcase/doc/forms/StatesDoc.vue

@@ -3,13 +3,13 @@
         <p>Form uses the <i>name</i> property to create a state object for tracking values, errors, and actions.</p>
     </DocSectionText>
     <div class="card flex justify-center">
-        <Form v-slot="$form" :initialValues="initialValues" :resolver="resolver" @submit="onFormSubmit" class="grid md:grid-cols-2 gap-4 w-full">
+        <Form v-slot="$form" :initialValues :resolver @submit="onFormSubmit" class="grid lg:grid-cols-2 gap-4 w-full">
             <div class="flex flex-col justify-center items-center gap-4">
                 <InputText name="username" type="text" placeholder="Username" />
                 <Button type="submit" severity="secondary" label="Submit" />
             </div>
             <Fieldset legend="Form States">
-                <pre>{{ $form }}</pre>
+                <pre class="whitespace-pre-wrap">{{ $form }}</pre>
             </Fieldset>
         </Form>
     </div>
@@ -25,13 +25,13 @@ export default {
             },
             code: {
                 basic: `
-<Form v-slot="$form" :initialValues :resolver @submit="onFormSubmit" class="grid md:grid-cols-2 gap-4 w-full">
+<Form v-slot="$form" :initialValues :resolver @submit="onFormSubmit" class="grid lg:grid-cols-2 gap-4 w-full">
     <div class="flex flex-col justify-center items-center gap-4">
         <InputText name="username" type="text" placeholder="Username" />
         <Button type="submit" severity="secondary" label="Submit" />
     </div>
     <Fieldset legend="Form States">
-        <pre>{{ $form }}</pre>
+        <pre class="whitespace-pre-wrap">{{ $form }}</pre>
     </Fieldset>
 </Form>
 `,
@@ -99,10 +99,14 @@ export default {
     },
     methods: {
         resolver: ({ values }) => {
-            const errors = {};
+            const errors = { username: [] };
 
             if (!values.username) {
-                errors.username = [{ message: 'Username is required.' }];
+                errors.username.push({ type: 'required', message: 'Username is required.' });
+            }
+
+            if (values.username?.length < 3) {
+                errors.username.push({ type: 'minimum', message: 'Username must be at least 3 characters long.' });
             }
 
             return {

packages/form/src/form/Form.d.ts

@@ -72,14 +72,29 @@ export interface FormPassThroughAttributes {
     [key: string]: any;
 }
 
+/**
+ * Resolver options for Form component.
+ */
+export interface FormResolverOptions {
+    /**
+     * The values of the form fields.
+     */
+    values: Record<string, any>;
+    /**
+     * The names of the form fields.
+     */
+    names: string[] | undefined;
+}
+
 /**
  * Defines valid properties in Form component.
  */
 export interface FormProps {
     /**
      * A function that resolves validation logic.
+     * @param {FormResolverOptions} e - Resolver options
      */
-    resolver?: (values: Record<string, any>) => Promise<Record<string, any>> | Record<string, any> | undefined;
+    resolver?: (e: FormResolverOptions) => Promise<Record<string, any>> | Record<string, any> | undefined;
     /**
      * The initial values for the form fields.
      */

packages/form/src/useform/index.d.ts

@@ -7,8 +7,13 @@ export interface useFormReturn {
     states: any;
 }
 
+export interface useFormResolverOptions {
+    values: Record<string, any>;
+    names: string[] | undefined;
+}
+
 export interface useFormOptions {
-    resolver?: (values: Record<string, any>) => Promise<Record<string, any>> | Record<string, any> | undefined;
+    resolver?: (e: useFormResolverOptions) => Promise<Record<string, any>> | Record<string, any> | undefined;
     initialValues?: Record<string, any> | undefined;
     validateOnValueUpdate?: boolean | string[];
     validateOnBlur?: boolean | string[];

packages/form/src/useform/index.js

@@ -84,13 +84,14 @@ export const useForm = (options = {}) => {
     };
 
     const validate = async (field) => {
+        const names = Object.keys(states) ?? [];
         const values = Object.entries(states).reduce((acc, [key, val]) => {
             acc[key] = val.value;
 
             return acc;
         }, {});
 
-        const result = (await options.resolver?.({ values })) ?? {};
+        const result = (await options.resolver?.({ values, names })) ?? {};
 
         for (const sField of Object.keys(states)) {
             if (sField === field || !field) {
@@ -118,7 +119,7 @@ export const useForm = (options = {}) => {
         handleSubmit,
         validate,
         reset,
-        valid: toValue(valid),
-        states: toValue(states)
+        valid,
+        states
     };
 };