@juantroconisf/lib 11.7.0 → 11.9.0

package/dist/index.d.mts

@@ -238,6 +238,11 @@ interface HelpersFunc<O extends StateType> {
     moveById: <K extends ArrayPaths<O>>(arrayKey: K, fromId: string | number, toId: string | number) => void;
     /** Gets an item from an array by its unique identifier (O(1) via indexMap). */
     getItemById: <K extends ArrayPaths<O>>(arrayKey: K, itemId: string | number) => (NestedFieldValue<O, K> extends (infer E)[] ? E : never) | undefined;
+    /** Validates a single item in an array by its unique identifier. */
+    validateItem: <K extends ArrayPaths<O>>(arrayKey: K, itemId: string | number) => Promise<{
+        isValid: boolean;
+        errors: string[];
+    }>;
 }
 /**
  * The response object from the useForm hook.
@@ -285,7 +290,7 @@ interface UseFormResponse<O extends StateType> {
      * If validation fails, identifying errors and touching fields.
      * If validation succeeds, calls the provided handler with the current state.
      */
-    onFormSubmit: (fn: FormSubmitHandler<O>) => (e: React.FormEvent) => void;
+    onFormSubmit: (fn: FormSubmitHandler<O>) => (e: React.FormEvent) => Promise<void>;
     /**
      * A controlled form component that handles submission and validation.
      */

package/dist/index.d.ts

@@ -238,6 +238,11 @@ interface HelpersFunc<O extends StateType> {
     moveById: <K extends ArrayPaths<O>>(arrayKey: K, fromId: string | number, toId: string | number) => void;
     /** Gets an item from an array by its unique identifier (O(1) via indexMap). */
     getItemById: <K extends ArrayPaths<O>>(arrayKey: K, itemId: string | number) => (NestedFieldValue<O, K> extends (infer E)[] ? E : never) | undefined;
+    /** Validates a single item in an array by its unique identifier. */
+    validateItem: <K extends ArrayPaths<O>>(arrayKey: K, itemId: string | number) => Promise<{
+        isValid: boolean;
+        errors: string[];
+    }>;
 }
 /**
  * The response object from the useForm hook.
@@ -285,7 +290,7 @@ interface UseFormResponse<O extends StateType> {
      * If validation fails, identifying errors and touching fields.
      * If validation succeeds, calls the provided handler with the current state.
      */
-    onFormSubmit: (fn: FormSubmitHandler<O>) => (e: React.FormEvent) => void;
+    onFormSubmit: (fn: FormSubmitHandler<O>) => (e: React.FormEvent) => Promise<void>;
     /**
      * A controlled form component that handles submission and validation.
      */

package/dist/index.js

@@ -428,7 +428,17 @@ function useForm(schema, {
   const indexMapRef = (0, import_react2.useRef)(indexMap);
   indexMapRef.current = indexMap;
   const getIndex = (0, import_react2.useCallback)((arrayKey, itemId) => {
-    return indexMapRef.current.get(arrayKey)?.get(itemId);
+    const map = indexMapRef.current.get(arrayKey);
+    if (!map) return void 0;
+    const index = map.get(itemId);
+    if (index !== void 0) return index;
+    if (typeof itemId === "string") {
+      const num = Number(itemId);
+      if (!isNaN(num)) return map.get(num);
+    } else if (typeof itemId === "number") {
+      return map.get(String(itemId));
+    }
+    return void 0;
   }, []);
   const ruleCache = (0, import_react2.useRef)(/* @__PURE__ */ new Map());
   (0, import_react2.useMemo)(() => {
@@ -543,9 +553,21 @@ function useForm(schema, {
     [getRule, runValidation, validationSchema]
   );
   const validateAll = (0, import_react2.useCallback)(() => {
-    if (!validationSchema) return false;
-    const newMetadata = new Map(metadataRef.current);
+    if (!validationSchema)
+      return Promise.resolve({ isValid: true, errors: [] });
+    const cleanMetadata = new Map(metadataRef.current);
+    cleanMetadata.forEach((value, key) => {
+      if (value.isInvalid) {
+        cleanMetadata.set(key, {
+          ...value,
+          isInvalid: false,
+          errorMessage: ""
+        });
+      }
+    });
     const handleErrors = (err) => {
+      const newMetadata = new Map(cleanMetadata);
+      const errors = [];
       if (err.inner) {
         err.inner.forEach((validationError) => {
           const yupPath = validationError.path;
@@ -573,6 +595,7 @@ function useForm(schema, {
             }
           }
           const compositeKey = compositeParts.join(".");
+          errors.push(compositeKey);
           const currentMeta = newMetadata.get(compositeKey) || {
             isTouched: false,
             isInvalid: false,
@@ -587,25 +610,26 @@ function useForm(schema, {
         });
       }
       setMetadata(newMetadata);
-      return true;
+      return { isValid: false, errors };
     };
     try {
       validationSchema.validateSync(state, { abortEarly: false });
     } catch (err) {
       if (err.name === "ValidationError") {
-        return handleErrors(err);
+        return Promise.resolve(handleErrors(err));
       }
       return (async () => {
         try {
           await validationSchema.validate(state, { abortEarly: false });
-          return false;
+          setMetadata(cleanMetadata);
+          return { isValid: true, errors: [] };
         } catch (asyncErr) {
           return handleErrors(asyncErr);
         }
       })();
     }
-    setMetadata(newMetadata);
-    return false;
+    setMetadata(cleanMetadata);
+    return Promise.resolve({ isValid: true, errors: [] });
   }, [validationSchema, state, arrayIdentifiers]);
   const handleFieldChange = (0, import_react2.useCallback)(
     (resolution, newValue) => {
@@ -750,91 +774,88 @@ function useForm(schema, {
     },
     [validateField, getRule, validationSchema]
   );
-  const on = (0, import_react2.useMemo)(
-    () => {
-      const getCachedProps = (method, args, factory) => {
-        const data = resolveFieldData(
-          args,
-          stateRef.current,
-          getIndex,
-          getNestedValue,
-          getRule,
-          validationSchema
-        );
-        if (!data) return {};
-        const meta = metadataRef.current.get(data.compositeKey);
-        const deps = JSON.stringify([
-          data.value,
-          meta?.isInvalid,
-          meta?.errorMessage,
-          meta?.isTouched
-        ]);
-        const cacheKey = `${method}:${JSON.stringify(args)}`;
-        const cached = propsCache.current.get(cacheKey);
-        if (cached && cached.deps === deps) {
-          return cached.props;
-        }
-        const props = factory(data);
-        propsCache.current.set(cacheKey, { props, deps });
-        return props;
-      };
-      return {
-        input: (...args) => getCachedProps("input", args, (data) => ({
-          ...createHandlers(data),
-          value: data.value === null || data.value === void 0 ? "" : typeof data.value === "boolean" ? data.value : String(data.value),
-          onValueChange: (v) => handleFieldChange(data, v)
-        })),
-        select: (...args) => getCachedProps("select", args, (data) => {
-          const isArray = Array.isArray(data.value);
-          return {
-            ...createHandlers(data),
-            selectedKeys: data.value === null || data.value === void 0 ? [] : isArray ? data.value.map(String) : [String(data.value)],
-            onSelectionChange: (v) => {
-              const fixed = typeof v === "string" || v === null ? v : isArray ? Array.from(v) : Array.from(v)[0] ?? null;
-              handleFieldChange(data, fixed);
-            }
-          };
-        }),
-        autocomplete: (...args) => getCachedProps("autocomplete", args, (data) => ({
+  const on = (0, import_react2.useMemo)(() => {
+    const getCachedProps = (method, args, factory) => {
+      const data = resolveFieldData(
+        args,
+        stateRef.current,
+        getIndex,
+        getNestedValue,
+        getRule,
+        validationSchema
+      );
+      if (!data) return {};
+      const meta = metadataRef.current.get(data.compositeKey);
+      const deps = JSON.stringify([
+        data.value,
+        meta?.isInvalid,
+        meta?.errorMessage,
+        meta?.isTouched
+      ]);
+      const cacheKey = `${method}:${JSON.stringify(args)}`;
+      const cached = propsCache.current.get(cacheKey);
+      if (cached && cached.deps === deps) {
+        return cached.props;
+      }
+      const props = factory(data);
+      propsCache.current.set(cacheKey, { props, deps });
+      return props;
+    };
+    return {
+      input: (...args) => getCachedProps("input", args, (data) => ({
+        ...createHandlers(data),
+        value: data.value === null || data.value === void 0 ? "" : typeof data.value === "boolean" ? data.value : String(data.value),
+        onValueChange: (v) => handleFieldChange(data, v)
+      })),
+      select: (...args) => getCachedProps("select", args, (data) => {
+        const isArray = Array.isArray(data.value);
+        return {
           ...createHandlers(data),
-          selectedKey: data.value === null || data.value === void 0 ? null : String(data.value),
+          selectedKeys: data.value === null || data.value === void 0 ? [] : isArray ? data.value.map(String) : [String(data.value)],
           onSelectionChange: (v) => {
-            const fixed = typeof v === "string" || v === null || v === void 0 ? v : String(v);
+            const fixed = typeof v === "string" || v === null ? v : isArray ? Array.from(v) : Array.from(v)[0] ?? null;
             handleFieldChange(data, fixed);
           }
-        })),
-        numberInput: (...args) => getCachedProps("numberInput", args, (data) => ({
-          ...createHandlers(data),
-          value: data.value === null || data.value === void 0 ? "" : String(data.value),
-          onValueChange: (v) => handleFieldChange(data, v)
-        })),
-        checkbox: (...args) => getCachedProps("checkbox", args, (data) => ({
-          ...createHandlers(data),
-          isSelected: Boolean(data.value),
-          onValueChange: (v) => handleFieldChange(data, v)
-        })),
-        switch: (...args) => getCachedProps("switch", args, (data) => ({
-          ...createHandlers(data),
-          isSelected: Boolean(data.value),
-          onValueChange: (v) => handleFieldChange(data, v)
-        })),
-        radio: (...args) => getCachedProps("radio", args, (data) => ({
-          ...createHandlers(data),
-          value: data.value === null || data.value === void 0 ? "" : String(data.value),
-          onValueChange: (v) => handleFieldChange(data, v)
-        }))
-      };
-    },
-    [
-      createHandlers,
-      getIndex,
-      handleFieldChange,
-      getRule,
-      validationSchema,
-      state,
-      metadata
-    ]
-  );
+        };
+      }),
+      autocomplete: (...args) => getCachedProps("autocomplete", args, (data) => ({
+        ...createHandlers(data),
+        selectedKey: data.value === null || data.value === void 0 ? null : String(data.value),
+        onSelectionChange: (v) => {
+          const fixed = typeof v === "string" || v === null || v === void 0 ? v : String(v);
+          handleFieldChange(data, fixed);
+        }
+      })),
+      numberInput: (...args) => getCachedProps("numberInput", args, (data) => ({
+        ...createHandlers(data),
+        value: data.value === null || data.value === void 0 ? "" : String(data.value),
+        onValueChange: (v) => handleFieldChange(data, v)
+      })),
+      checkbox: (...args) => getCachedProps("checkbox", args, (data) => ({
+        ...createHandlers(data),
+        isSelected: Boolean(data.value),
+        onValueChange: (v) => handleFieldChange(data, v)
+      })),
+      switch: (...args) => getCachedProps("switch", args, (data) => ({
+        ...createHandlers(data),
+        isSelected: Boolean(data.value),
+        onValueChange: (v) => handleFieldChange(data, v)
+      })),
+      radio: (...args) => getCachedProps("radio", args, (data) => ({
+        ...createHandlers(data),
+        value: data.value === null || data.value === void 0 ? "" : String(data.value),
+        onValueChange: (v) => handleFieldChange(data, v)
+      }))
+    };
+  }, [
+    createHandlers,
+    getIndex,
+    handleFieldChange,
+    getRule,
+    validationSchema,
+    state,
+    metadata
+  ]);
   const helpers = (0, import_react2.useMemo)(
     () => ({
       addItem: (arrayKey, item, index) => {
@@ -948,6 +969,85 @@ function useForm(schema, {
         const index = getIndex(arrayKey, itemId);
         if (index === void 0) return void 0;
         return getNestedValue(stateRef.current, arrayKey)[index];
+      },
+      validateItem: async (arrayKey, itemId) => {
+        if (!validationSchema) return { isValid: true, errors: [] };
+        const index = getIndex(arrayKey, itemId);
+        if (index === void 0) return { isValid: true, errors: [] };
+        const yupPath = `${String(arrayKey)}[${index}]`;
+        const prefix = `${String(arrayKey)}.${itemId}.`;
+        const cleanMetadata = new Map(metadataRef.current);
+        for (const key of cleanMetadata.keys()) {
+          if (key.startsWith(prefix) || key === `${String(arrayKey)}.${itemId}`) {
+            const meta = cleanMetadata.get(key);
+            cleanMetadata.set(key, {
+              ...meta,
+              isInvalid: false,
+              errorMessage: ""
+            });
+          }
+        }
+        const handleErrors = (err) => {
+          const newMetadata = new Map(cleanMetadata);
+          const errors = [];
+          if (err.inner) {
+            err.inner.forEach((validationError) => {
+              const localDotPath = validationError.path.replace(
+                /\[(\d+)\]/g,
+                ".$1"
+              );
+              const parts = localDotPath.split(".");
+              let current = stateRef.current;
+              const compositeParts = [];
+              for (let i = 0; i < parts.length; i++) {
+                const part = parts[i];
+                if (Array.isArray(current)) {
+                  const idx = parseInt(part, 10);
+                  const item = current[idx];
+                  if (item && typeof item === "object") {
+                    const genericPath = compositeParts.join(".").replace(/\.\d+/g, "");
+                    const idKey = arrayIdentifiers?.[genericPath] || "id";
+                    const id = item[idKey];
+                    compositeParts.push(String(id !== void 0 ? id : idx));
+                  } else {
+                    compositeParts.push(part);
+                  }
+                  current = item;
+                } else {
+                  compositeParts.push(part);
+                  current = current?.[part];
+                }
+              }
+              const compositeKey = compositeParts.join(".");
+              errors.push(compositeKey);
+              const currentMeta = newMetadata.get(compositeKey) || {
+                isTouched: false,
+                isInvalid: false,
+                errorMessage: ""
+              };
+              newMetadata.set(compositeKey, {
+                ...currentMeta,
+                isTouched: true,
+                isInvalid: true,
+                errorMessage: validationError.message
+              });
+            });
+          }
+          setMetadata(newMetadata);
+          return { isValid: false, errors };
+        };
+        try {
+          await validationSchema.validateAt(yupPath, stateRef.current, {
+            abortEarly: false
+          });
+          setMetadata(cleanMetadata);
+          return { isValid: true, errors: [] };
+        } catch (err) {
+          if (err.name === "ValidationError") {
+            return handleErrors(err);
+          }
+          return { isValid: true, errors: [] };
+        }
       }
     }),
     [getIndex, arrayIdentifiers, state, metadata]
@@ -1036,7 +1136,8 @@ function useForm(schema, {
   const onFormSubmit = (0, import_react2.useCallback)(
     (fn) => async (e) => {
       e.preventDefault();
-      if (await validateAll()) return;
+      const { isValid } = await validateAll();
+      if (!isValid) return;
       fn(stateRef.current, e);
     },
     [validateAll]
@@ -1071,9 +1172,8 @@ function useForm(schema, {
       const { onSubmit, ...rest } = props;
       const handleSubmit = async (e) => {
         e.preventDefault();
-        if (await validateAllRef.current()) {
-          return;
-        }
+        const { isValid } = await validateAllRef.current();
+        if (!isValid) return;
         onFormSubmitPropRef.current?.(stateRef.current, e);
         if (resetOnSubmitRef.current) {
           handleReset({ keepValues: keepValuesPropRef.current });

package/dist/index.mjs

@@ -402,7 +402,17 @@ function useForm(schema, {
   const indexMapRef = useRef(indexMap);
   indexMapRef.current = indexMap;
   const getIndex = useCallback((arrayKey, itemId) => {
-    return indexMapRef.current.get(arrayKey)?.get(itemId);
+    const map = indexMapRef.current.get(arrayKey);
+    if (!map) return void 0;
+    const index = map.get(itemId);
+    if (index !== void 0) return index;
+    if (typeof itemId === "string") {
+      const num = Number(itemId);
+      if (!isNaN(num)) return map.get(num);
+    } else if (typeof itemId === "number") {
+      return map.get(String(itemId));
+    }
+    return void 0;
   }, []);
   const ruleCache = useRef(/* @__PURE__ */ new Map());
   useMemo(() => {
@@ -517,9 +527,21 @@ function useForm(schema, {
     [getRule, runValidation, validationSchema]
   );
   const validateAll = useCallback(() => {
-    if (!validationSchema) return false;
-    const newMetadata = new Map(metadataRef.current);
+    if (!validationSchema)
+      return Promise.resolve({ isValid: true, errors: [] });
+    const cleanMetadata = new Map(metadataRef.current);
+    cleanMetadata.forEach((value, key) => {
+      if (value.isInvalid) {
+        cleanMetadata.set(key, {
+          ...value,
+          isInvalid: false,
+          errorMessage: ""
+        });
+      }
+    });
     const handleErrors = (err) => {
+      const newMetadata = new Map(cleanMetadata);
+      const errors = [];
       if (err.inner) {
         err.inner.forEach((validationError) => {
           const yupPath = validationError.path;
@@ -547,6 +569,7 @@ function useForm(schema, {
             }
           }
           const compositeKey = compositeParts.join(".");
+          errors.push(compositeKey);
           const currentMeta = newMetadata.get(compositeKey) || {
             isTouched: false,
             isInvalid: false,
@@ -561,25 +584,26 @@ function useForm(schema, {
         });
       }
       setMetadata(newMetadata);
-      return true;
+      return { isValid: false, errors };
     };
     try {
       validationSchema.validateSync(state, { abortEarly: false });
     } catch (err) {
       if (err.name === "ValidationError") {
-        return handleErrors(err);
+        return Promise.resolve(handleErrors(err));
       }
       return (async () => {
         try {
           await validationSchema.validate(state, { abortEarly: false });
-          return false;
+          setMetadata(cleanMetadata);
+          return { isValid: true, errors: [] };
         } catch (asyncErr) {
           return handleErrors(asyncErr);
         }
       })();
     }
-    setMetadata(newMetadata);
-    return false;
+    setMetadata(cleanMetadata);
+    return Promise.resolve({ isValid: true, errors: [] });
   }, [validationSchema, state, arrayIdentifiers]);
   const handleFieldChange = useCallback(
     (resolution, newValue) => {
@@ -724,91 +748,88 @@ function useForm(schema, {
     },
     [validateField, getRule, validationSchema]
   );
-  const on = useMemo(
-    () => {
-      const getCachedProps = (method, args, factory) => {
-        const data = resolveFieldData(
-          args,
-          stateRef.current,
-          getIndex,
-          getNestedValue,
-          getRule,
-          validationSchema
-        );
-        if (!data) return {};
-        const meta = metadataRef.current.get(data.compositeKey);
-        const deps = JSON.stringify([
-          data.value,
-          meta?.isInvalid,
-          meta?.errorMessage,
-          meta?.isTouched
-        ]);
-        const cacheKey = `${method}:${JSON.stringify(args)}`;
-        const cached = propsCache.current.get(cacheKey);
-        if (cached && cached.deps === deps) {
-          return cached.props;
-        }
-        const props = factory(data);
-        propsCache.current.set(cacheKey, { props, deps });
-        return props;
-      };
-      return {
-        input: (...args) => getCachedProps("input", args, (data) => ({
-          ...createHandlers(data),
-          value: data.value === null || data.value === void 0 ? "" : typeof data.value === "boolean" ? data.value : String(data.value),
-          onValueChange: (v) => handleFieldChange(data, v)
-        })),
-        select: (...args) => getCachedProps("select", args, (data) => {
-          const isArray = Array.isArray(data.value);
-          return {
-            ...createHandlers(data),
-            selectedKeys: data.value === null || data.value === void 0 ? [] : isArray ? data.value.map(String) : [String(data.value)],
-            onSelectionChange: (v) => {
-              const fixed = typeof v === "string" || v === null ? v : isArray ? Array.from(v) : Array.from(v)[0] ?? null;
-              handleFieldChange(data, fixed);
-            }
-          };
-        }),
-        autocomplete: (...args) => getCachedProps("autocomplete", args, (data) => ({
+  const on = useMemo(() => {
+    const getCachedProps = (method, args, factory) => {
+      const data = resolveFieldData(
+        args,
+        stateRef.current,
+        getIndex,
+        getNestedValue,
+        getRule,
+        validationSchema
+      );
+      if (!data) return {};
+      const meta = metadataRef.current.get(data.compositeKey);
+      const deps = JSON.stringify([
+        data.value,
+        meta?.isInvalid,
+        meta?.errorMessage,
+        meta?.isTouched
+      ]);
+      const cacheKey = `${method}:${JSON.stringify(args)}`;
+      const cached = propsCache.current.get(cacheKey);
+      if (cached && cached.deps === deps) {
+        return cached.props;
+      }
+      const props = factory(data);
+      propsCache.current.set(cacheKey, { props, deps });
+      return props;
+    };
+    return {
+      input: (...args) => getCachedProps("input", args, (data) => ({
+        ...createHandlers(data),
+        value: data.value === null || data.value === void 0 ? "" : typeof data.value === "boolean" ? data.value : String(data.value),
+        onValueChange: (v) => handleFieldChange(data, v)
+      })),
+      select: (...args) => getCachedProps("select", args, (data) => {
+        const isArray = Array.isArray(data.value);
+        return {
           ...createHandlers(data),
-          selectedKey: data.value === null || data.value === void 0 ? null : String(data.value),
+          selectedKeys: data.value === null || data.value === void 0 ? [] : isArray ? data.value.map(String) : [String(data.value)],
           onSelectionChange: (v) => {
-            const fixed = typeof v === "string" || v === null || v === void 0 ? v : String(v);
+            const fixed = typeof v === "string" || v === null ? v : isArray ? Array.from(v) : Array.from(v)[0] ?? null;
             handleFieldChange(data, fixed);
           }
-        })),
-        numberInput: (...args) => getCachedProps("numberInput", args, (data) => ({
-          ...createHandlers(data),
-          value: data.value === null || data.value === void 0 ? "" : String(data.value),
-          onValueChange: (v) => handleFieldChange(data, v)
-        })),
-        checkbox: (...args) => getCachedProps("checkbox", args, (data) => ({
-          ...createHandlers(data),
-          isSelected: Boolean(data.value),
-          onValueChange: (v) => handleFieldChange(data, v)
-        })),
-        switch: (...args) => getCachedProps("switch", args, (data) => ({
-          ...createHandlers(data),
-          isSelected: Boolean(data.value),
-          onValueChange: (v) => handleFieldChange(data, v)
-        })),
-        radio: (...args) => getCachedProps("radio", args, (data) => ({
-          ...createHandlers(data),
-          value: data.value === null || data.value === void 0 ? "" : String(data.value),
-          onValueChange: (v) => handleFieldChange(data, v)
-        }))
-      };
-    },
-    [
-      createHandlers,
-      getIndex,
-      handleFieldChange,
-      getRule,
-      validationSchema,
-      state,
-      metadata
-    ]
-  );
+        };
+      }),
+      autocomplete: (...args) => getCachedProps("autocomplete", args, (data) => ({
+        ...createHandlers(data),
+        selectedKey: data.value === null || data.value === void 0 ? null : String(data.value),
+        onSelectionChange: (v) => {
+          const fixed = typeof v === "string" || v === null || v === void 0 ? v : String(v);
+          handleFieldChange(data, fixed);
+        }
+      })),
+      numberInput: (...args) => getCachedProps("numberInput", args, (data) => ({
+        ...createHandlers(data),
+        value: data.value === null || data.value === void 0 ? "" : String(data.value),
+        onValueChange: (v) => handleFieldChange(data, v)
+      })),
+      checkbox: (...args) => getCachedProps("checkbox", args, (data) => ({
+        ...createHandlers(data),
+        isSelected: Boolean(data.value),
+        onValueChange: (v) => handleFieldChange(data, v)
+      })),
+      switch: (...args) => getCachedProps("switch", args, (data) => ({
+        ...createHandlers(data),
+        isSelected: Boolean(data.value),
+        onValueChange: (v) => handleFieldChange(data, v)
+      })),
+      radio: (...args) => getCachedProps("radio", args, (data) => ({
+        ...createHandlers(data),
+        value: data.value === null || data.value === void 0 ? "" : String(data.value),
+        onValueChange: (v) => handleFieldChange(data, v)
+      }))
+    };
+  }, [
+    createHandlers,
+    getIndex,
+    handleFieldChange,
+    getRule,
+    validationSchema,
+    state,
+    metadata
+  ]);
   const helpers = useMemo(
     () => ({
       addItem: (arrayKey, item, index) => {
@@ -922,6 +943,85 @@ function useForm(schema, {
         const index = getIndex(arrayKey, itemId);
         if (index === void 0) return void 0;
         return getNestedValue(stateRef.current, arrayKey)[index];
+      },
+      validateItem: async (arrayKey, itemId) => {
+        if (!validationSchema) return { isValid: true, errors: [] };
+        const index = getIndex(arrayKey, itemId);
+        if (index === void 0) return { isValid: true, errors: [] };
+        const yupPath = `${String(arrayKey)}[${index}]`;
+        const prefix = `${String(arrayKey)}.${itemId}.`;
+        const cleanMetadata = new Map(metadataRef.current);
+        for (const key of cleanMetadata.keys()) {
+          if (key.startsWith(prefix) || key === `${String(arrayKey)}.${itemId}`) {
+            const meta = cleanMetadata.get(key);
+            cleanMetadata.set(key, {
+              ...meta,
+              isInvalid: false,
+              errorMessage: ""
+            });
+          }
+        }
+        const handleErrors = (err) => {
+          const newMetadata = new Map(cleanMetadata);
+          const errors = [];
+          if (err.inner) {
+            err.inner.forEach((validationError) => {
+              const localDotPath = validationError.path.replace(
+                /\[(\d+)\]/g,
+                ".$1"
+              );
+              const parts = localDotPath.split(".");
+              let current = stateRef.current;
+              const compositeParts = [];
+              for (let i = 0; i < parts.length; i++) {
+                const part = parts[i];
+                if (Array.isArray(current)) {
+                  const idx = parseInt(part, 10);
+                  const item = current[idx];
+                  if (item && typeof item === "object") {
+                    const genericPath = compositeParts.join(".").replace(/\.\d+/g, "");
+                    const idKey = arrayIdentifiers?.[genericPath] || "id";
+                    const id = item[idKey];
+                    compositeParts.push(String(id !== void 0 ? id : idx));
+                  } else {
+                    compositeParts.push(part);
+                  }
+                  current = item;
+                } else {
+                  compositeParts.push(part);
+                  current = current?.[part];
+                }
+              }
+              const compositeKey = compositeParts.join(".");
+              errors.push(compositeKey);
+              const currentMeta = newMetadata.get(compositeKey) || {
+                isTouched: false,
+                isInvalid: false,
+                errorMessage: ""
+              };
+              newMetadata.set(compositeKey, {
+                ...currentMeta,
+                isTouched: true,
+                isInvalid: true,
+                errorMessage: validationError.message
+              });
+            });
+          }
+          setMetadata(newMetadata);
+          return { isValid: false, errors };
+        };
+        try {
+          await validationSchema.validateAt(yupPath, stateRef.current, {
+            abortEarly: false
+          });
+          setMetadata(cleanMetadata);
+          return { isValid: true, errors: [] };
+        } catch (err) {
+          if (err.name === "ValidationError") {
+            return handleErrors(err);
+          }
+          return { isValid: true, errors: [] };
+        }
       }
     }),
     [getIndex, arrayIdentifiers, state, metadata]
@@ -1010,7 +1110,8 @@ function useForm(schema, {
   const onFormSubmit = useCallback(
     (fn) => async (e) => {
       e.preventDefault();
-      if (await validateAll()) return;
+      const { isValid } = await validateAll();
+      if (!isValid) return;
       fn(stateRef.current, e);
     },
     [validateAll]
@@ -1045,9 +1146,8 @@ function useForm(schema, {
       const { onSubmit, ...rest } = props;
       const handleSubmit = async (e) => {
         e.preventDefault();
-        if (await validateAllRef.current()) {
-          return;
-        }
+        const { isValid } = await validateAllRef.current();
+        if (!isValid) return;
         onFormSubmitPropRef.current?.(stateRef.current, e);
         if (resetOnSubmitRef.current) {
           handleReset({ keepValues: keepValuesPropRef.current });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@juantroconisf/lib",
-  "version": "11.7.0",
+  "version": "11.9.0",
   "description": "A form validation library for HeroUI.",
   "main": "dist/index.js",
   "module": "dist/index.mjs",