@juantroconisf/lib 11.7.0 → 11.8.0

package/dist/index.d.mts

@@ -238,6 +238,8 @@ 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<boolean>;
 }
 /**
  * The response object from the useForm hook.

package/dist/index.d.ts

@@ -238,6 +238,8 @@ 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<boolean>;
 }
 /**
  * The response object from the useForm hook.

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)(() => {
@@ -544,8 +554,14 @@ function useForm(schema, {
   );
   const validateAll = (0, import_react2.useCallback)(() => {
     if (!validationSchema) return false;
-    const newMetadata = new Map(metadataRef.current);
+    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);
       if (err.inner) {
         err.inner.forEach((validationError) => {
           const yupPath = validationError.path;
@@ -598,13 +614,14 @@ function useForm(schema, {
       return (async () => {
         try {
           await validationSchema.validate(state, { abortEarly: false });
+          setMetadata(cleanMetadata);
           return false;
         } catch (asyncErr) {
           return handleErrors(asyncErr);
         }
       })();
     }
-    setMetadata(newMetadata);
+    setMetadata(cleanMetadata);
     return false;
   }, [validationSchema, state, arrayIdentifiers]);
   const handleFieldChange = (0, import_react2.useCallback)(
@@ -948,6 +965,83 @@ 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 false;
+        const index = getIndex(arrayKey, itemId);
+        if (index === void 0) return false;
+        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);
+          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(".");
+              const currentMeta = newMetadata.get(compositeKey) || {
+                isTouched: false,
+                isInvalid: false,
+                errorMessage: ""
+              };
+              newMetadata.set(compositeKey, {
+                ...currentMeta,
+                isTouched: true,
+                isInvalid: true,
+                errorMessage: validationError.message
+              });
+            });
+          }
+          setMetadata(newMetadata);
+          return true;
+        };
+        try {
+          await validationSchema.validateAt(yupPath, stateRef.current, {
+            abortEarly: false
+          });
+          setMetadata(cleanMetadata);
+          return false;
+        } catch (err) {
+          if (err.name === "ValidationError") {
+            return handleErrors(err);
+          }
+          return false;
+        }
       }
     }),
     [getIndex, arrayIdentifiers, state, metadata]

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(() => {
@@ -518,8 +528,14 @@ function useForm(schema, {
   );
   const validateAll = useCallback(() => {
     if (!validationSchema) return false;
-    const newMetadata = new Map(metadataRef.current);
+    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);
       if (err.inner) {
         err.inner.forEach((validationError) => {
           const yupPath = validationError.path;
@@ -572,13 +588,14 @@ function useForm(schema, {
       return (async () => {
         try {
           await validationSchema.validate(state, { abortEarly: false });
+          setMetadata(cleanMetadata);
           return false;
         } catch (asyncErr) {
           return handleErrors(asyncErr);
         }
       })();
     }
-    setMetadata(newMetadata);
+    setMetadata(cleanMetadata);
     return false;
   }, [validationSchema, state, arrayIdentifiers]);
   const handleFieldChange = useCallback(
@@ -922,6 +939,83 @@ 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 false;
+        const index = getIndex(arrayKey, itemId);
+        if (index === void 0) return false;
+        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);
+          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(".");
+              const currentMeta = newMetadata.get(compositeKey) || {
+                isTouched: false,
+                isInvalid: false,
+                errorMessage: ""
+              };
+              newMetadata.set(compositeKey, {
+                ...currentMeta,
+                isTouched: true,
+                isInvalid: true,
+                errorMessage: validationError.message
+              });
+            });
+          }
+          setMetadata(newMetadata);
+          return true;
+        };
+        try {
+          await validationSchema.validateAt(yupPath, stateRef.current, {
+            abortEarly: false
+          });
+          setMetadata(cleanMetadata);
+          return false;
+        } catch (err) {
+          if (err.name === "ValidationError") {
+            return handleErrors(err);
+          }
+          return false;
+        }
       }
     }),
     [getIndex, arrayIdentifiers, state, metadata]

package/package.json

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