@juantroconisf/lib 5.1.1 → 5.3.0

package/dist/index.d.mts

@@ -130,6 +130,10 @@ interface OnMethods<O extends StateType> {
 type ArrayKeys<O extends StateType> = {
     [K in keyof O]: O[K] extends any[] ? K : never;
 }[keyof O];
+/** Keys whose values are arrays of objects (not primitives). */
+type ObjectArrayKeys<O extends StateType> = {
+    [K in keyof O]: O[K] extends Record<string, any>[] ? K : never;
+}[keyof O];
 type ArrayElement<T> = T extends (infer E)[] ? E : never;
 /** Resolves the type of the identifier field for an array element (defaults to "id"). */
 type ItemIdType<O extends StateType, K extends keyof O> = "id" extends keyof ArrayElement<O[K]> ? ArrayElement<O[K]>["id"] : string | number;
@@ -161,6 +165,8 @@ interface HelpersFunc<O extends StateType> {
     moveItem: <K extends ArrayKeys<O>>(arrayKey: K, from: number, to: number) => void;
     /** Moves an item within an array using unique identifiers. */
     moveById: <K extends ArrayKeys<O>>(arrayKey: K, fromId: string | number, toId: string | number) => void;
+    /** Gets an item from an array by its unique identifier (O(1) via indexMap). */
+    getItem: <K extends ArrayKeys<O>>(arrayKey: K, itemId: ItemIdType<O, K>) => ArrayElement<O[K]> | undefined;
 }
 /**
  * The response object from the useForm hook.
@@ -168,7 +174,10 @@ interface HelpersFunc<O extends StateType> {
  */
 interface UseFormResponse<O extends StateType> {
     onBlur: BlurFunc<O>;
-    onValueChange: ValueChangeFunc<O, keyof O>;
+    /** Updates an object array element's field by ID. */
+    onValueChange<K extends ObjectArrayKeys<O>, F extends keyof ArrayElement<O[K]> & string>(arrayKey: K, itemId: ItemIdType<O, K>, field: F, value: ArrayElement<O[K]>[F]): void;
+    /** Updates a scalar or nested object field. */
+    onValueChange<P extends AllPaths<O>>(id: P, value: NestedFieldValue<O, P & string>): void;
     onSelectionChange: ValueChangeFunc<O, keyof O>;
     state: O;
     setState: React.Dispatch<React.SetStateAction<O>>;

package/dist/index.d.ts

@@ -130,6 +130,10 @@ interface OnMethods<O extends StateType> {
 type ArrayKeys<O extends StateType> = {
     [K in keyof O]: O[K] extends any[] ? K : never;
 }[keyof O];
+/** Keys whose values are arrays of objects (not primitives). */
+type ObjectArrayKeys<O extends StateType> = {
+    [K in keyof O]: O[K] extends Record<string, any>[] ? K : never;
+}[keyof O];
 type ArrayElement<T> = T extends (infer E)[] ? E : never;
 /** Resolves the type of the identifier field for an array element (defaults to "id"). */
 type ItemIdType<O extends StateType, K extends keyof O> = "id" extends keyof ArrayElement<O[K]> ? ArrayElement<O[K]>["id"] : string | number;
@@ -161,6 +165,8 @@ interface HelpersFunc<O extends StateType> {
     moveItem: <K extends ArrayKeys<O>>(arrayKey: K, from: number, to: number) => void;
     /** Moves an item within an array using unique identifiers. */
     moveById: <K extends ArrayKeys<O>>(arrayKey: K, fromId: string | number, toId: string | number) => void;
+    /** Gets an item from an array by its unique identifier (O(1) via indexMap). */
+    getItem: <K extends ArrayKeys<O>>(arrayKey: K, itemId: ItemIdType<O, K>) => ArrayElement<O[K]> | undefined;
 }
 /**
  * The response object from the useForm hook.
@@ -168,7 +174,10 @@ interface HelpersFunc<O extends StateType> {
  */
 interface UseFormResponse<O extends StateType> {
     onBlur: BlurFunc<O>;
-    onValueChange: ValueChangeFunc<O, keyof O>;
+    /** Updates an object array element's field by ID. */
+    onValueChange<K extends ObjectArrayKeys<O>, F extends keyof ArrayElement<O[K]> & string>(arrayKey: K, itemId: ItemIdType<O, K>, field: F, value: ArrayElement<O[K]>[F]): void;
+    /** Updates a scalar or nested object field. */
+    onValueChange<P extends AllPaths<O>>(id: P, value: NestedFieldValue<O, P & string>): void;
     onSelectionChange: ValueChangeFunc<O, keyof O>;
     state: O;
     setState: React.Dispatch<React.SetStateAction<O>>;

package/dist/index.js

@@ -294,10 +294,48 @@ function useForm(initialState, {
         value: true
       })
     );
-  }, onValueChange = (id, value) => {
-    setState((prev) => handleNestedChange({ state: prev, id, value }));
-    validateInput(id, value);
-  }, onSelectionChange = (id, value) => {
+  }, onValueChange = ((...args) => {
+    if (args.length === 2) {
+      const [id, value] = args;
+      setState((prev) => handleNestedChange({ state: prev, id, value }));
+      validateInput(id, value);
+      return;
+    }
+    if (args.length === 3) {
+      const [arrayKey, index, value] = args;
+      setState((prev) => {
+        const arr = [...prev[arrayKey]];
+        arr[index] = value;
+        return { ...prev, [arrayKey]: arr };
+      });
+      return;
+    }
+    if (args.length === 4) {
+      const [arrayKey, itemId, field, value] = args;
+      const index = getIndex(String(arrayKey), itemId);
+      if (index === void 0) return;
+      setState(
+        (prev) => handleArrayItemChange({ state: prev, arrayKey, index, field, value })
+      );
+      validateItemInput(arrayKey, itemId, field, value);
+      return;
+    }
+    if (args.length === 5) {
+      const [parentKey, parentId, field, index, value] = args;
+      const parentIndex = getIndex(String(parentKey), parentId);
+      if (parentIndex === void 0) return;
+      setState((prev) => {
+        const parentArr = [...prev[parentKey]];
+        const item = { ...parentArr[parentIndex] };
+        const nestedArr = [...getNestedValue(item, field) || []];
+        nestedArr[index] = value;
+        const updatedItem = setNestedValue(item, field, nestedArr);
+        parentArr[parentIndex] = updatedItem;
+        return { ...prev, [parentKey]: parentArr };
+      });
+      return;
+    }
+  }), onSelectionChange = (id, value) => {
     const fixedValue = typeof value === "string" || value === null ? value : Array.from(value);
     setState(
       (prev) => handleNestedChange({
@@ -754,6 +792,13 @@ function useForm(initialState, {
           arr[index] = value;
           return { ...prev, [arrayKey]: arr };
         });
+      },
+      getItem: (arrayKey, itemId) => {
+        const index = getIndex(String(arrayKey), itemId);
+        if (index !== void 0) {
+          return state[arrayKey][index];
+        }
+        return void 0;
       }
     },
     isDirty: JSON.stringify(state) !== JSON.stringify(initialState),

package/dist/index.mjs

@@ -275,10 +275,48 @@ function useForm(initialState, {
         value: true
       })
     );
-  }, onValueChange = (id, value) => {
-    setState((prev) => handleNestedChange({ state: prev, id, value }));
-    validateInput(id, value);
-  }, onSelectionChange = (id, value) => {
+  }, onValueChange = ((...args) => {
+    if (args.length === 2) {
+      const [id, value] = args;
+      setState((prev) => handleNestedChange({ state: prev, id, value }));
+      validateInput(id, value);
+      return;
+    }
+    if (args.length === 3) {
+      const [arrayKey, index, value] = args;
+      setState((prev) => {
+        const arr = [...prev[arrayKey]];
+        arr[index] = value;
+        return { ...prev, [arrayKey]: arr };
+      });
+      return;
+    }
+    if (args.length === 4) {
+      const [arrayKey, itemId, field, value] = args;
+      const index = getIndex(String(arrayKey), itemId);
+      if (index === void 0) return;
+      setState(
+        (prev) => handleArrayItemChange({ state: prev, arrayKey, index, field, value })
+      );
+      validateItemInput(arrayKey, itemId, field, value);
+      return;
+    }
+    if (args.length === 5) {
+      const [parentKey, parentId, field, index, value] = args;
+      const parentIndex = getIndex(String(parentKey), parentId);
+      if (parentIndex === void 0) return;
+      setState((prev) => {
+        const parentArr = [...prev[parentKey]];
+        const item = { ...parentArr[parentIndex] };
+        const nestedArr = [...getNestedValue(item, field) || []];
+        nestedArr[index] = value;
+        const updatedItem = setNestedValue(item, field, nestedArr);
+        parentArr[parentIndex] = updatedItem;
+        return { ...prev, [parentKey]: parentArr };
+      });
+      return;
+    }
+  }), onSelectionChange = (id, value) => {
     const fixedValue = typeof value === "string" || value === null ? value : Array.from(value);
     setState(
       (prev) => handleNestedChange({
@@ -735,6 +773,13 @@ function useForm(initialState, {
           arr[index] = value;
           return { ...prev, [arrayKey]: arr };
         });
+      },
+      getItem: (arrayKey, itemId) => {
+        const index = getIndex(String(arrayKey), itemId);
+        if (index !== void 0) {
+          return state[arrayKey][index];
+        }
+        return void 0;
       }
     },
     isDirty: JSON.stringify(state) !== JSON.stringify(initialState),

package/package.json

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