@juantroconisf/lib 9.3.0 → 9.4.0

package/dist/index.d.mts

@@ -98,26 +98,24 @@ interface ItemAutocompleteProps extends ComponentInputProps {
 interface OnMethods<O extends StateType> {
     /** Registers a scalar or nested object field. */
     input<P extends AllPaths<O>>(id: P): ItemInputProps<NestedFieldValue<O, P & string>>;
-    /** Registers an array element — adapts to primitive arrays (by index) or object arrays (by ID + field). */
-    /** Registers an array element — adapts to primitive arrays (by index). */
-    input<K extends ArrayPaths<O>>(arrayKey: K, index: number): ItemInputProps<any>;
     /** Registers an object array element's field using composite syntax "array.field". */
     input<P extends ObjectArrayFieldPaths<O>>(compositePath: P, itemId: string | number): ItemInputProps<any>;
+    /** Registers a primitive array element by index. */
+    input<K extends ArrayPaths<O>>(arrayKey: K, index: number): ItemInputProps<any>;
     /** Registers a scalar or nested object field. */
     select<P extends AllPaths<O>>(id: P): ItemSelectProps;
     /** Registers a complete array field for multi-selection. */
     select<K extends ArrayPaths<O>>(arrayKey: K): ItemSelectProps;
-    /** Registers an array element — adapts to primitive arrays (by index) or object arrays (by ID + field). */
-    select<K extends ArrayPaths<O>>(arrayKey: K, index: number): ItemSelectProps;
     /** Registers an object array element's field using composite syntax "array.field". */
     select<P extends ObjectArrayFieldPaths<O>>(compositePath: P, itemId: string | number): ItemSelectProps;
+    /** Registers a primitive array element by index. */
+    select<K extends ArrayPaths<O>>(arrayKey: K, index: number): ItemSelectProps;
     /** Registers a scalar or nested object field. */
     autocomplete<P extends AllPaths<O>>(id: P): ItemAutocompleteProps;
-    /** Registers an array element — adapts to primitive arrays (by index) or object arrays (by ID + field). */
-    /** Registers an array element — adapts to primitive arrays (by index). */
-    autocomplete<K extends ArrayPaths<O>>(arrayKey: K, index: number): ItemAutocompleteProps;
     /** Registers an object array element's field using composite syntax "array.field". */
     autocomplete<P extends ObjectArrayFieldPaths<O>>(compositePath: P, itemId: string | number): ItemAutocompleteProps;
+    /** Registers a primitive array element by index. */
+    autocomplete<K extends ArrayPaths<O>>(arrayKey: K, index: number): ItemAutocompleteProps;
 }
 /**
  * Recursive type to find all paths to arrays in the state.
@@ -176,10 +174,14 @@ interface HelpersFunc<O extends StateType> {
  */
 interface UseFormResponse<O extends StateType> {
     onFieldBlur: BlurFunc<O>;
-    /** Updates an object array element's field by ID. */
-    onFieldChange<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. */
     onFieldChange<P extends AllPaths<O>>(id: P, value: NestedFieldValue<O, P & string>): void;
+    /** Updates an object array element's field using composite syntax "array.field". */
+    onFieldChange<P extends ObjectArrayFieldPaths<O>>(compositePath: P, itemId: string | number, value: any): void;
+    /** Updates an object array element's field by ID (explicit array key, field, and value). */
+    onFieldChange<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 primitive array element by index. */
+    onFieldChange<K extends ArrayPaths<O>>(arrayKey: K, index: number, value: any): void;
     onSelectionChange: ValueChangeFunc<O, keyof O>;
     state: O;
     setState: React.Dispatch<React.SetStateAction<O>>;

package/dist/index.d.ts

@@ -98,26 +98,24 @@ interface ItemAutocompleteProps extends ComponentInputProps {
 interface OnMethods<O extends StateType> {
     /** Registers a scalar or nested object field. */
     input<P extends AllPaths<O>>(id: P): ItemInputProps<NestedFieldValue<O, P & string>>;
-    /** Registers an array element — adapts to primitive arrays (by index) or object arrays (by ID + field). */
-    /** Registers an array element — adapts to primitive arrays (by index). */
-    input<K extends ArrayPaths<O>>(arrayKey: K, index: number): ItemInputProps<any>;
     /** Registers an object array element's field using composite syntax "array.field". */
     input<P extends ObjectArrayFieldPaths<O>>(compositePath: P, itemId: string | number): ItemInputProps<any>;
+    /** Registers a primitive array element by index. */
+    input<K extends ArrayPaths<O>>(arrayKey: K, index: number): ItemInputProps<any>;
     /** Registers a scalar or nested object field. */
     select<P extends AllPaths<O>>(id: P): ItemSelectProps;
     /** Registers a complete array field for multi-selection. */
     select<K extends ArrayPaths<O>>(arrayKey: K): ItemSelectProps;
-    /** Registers an array element — adapts to primitive arrays (by index) or object arrays (by ID + field). */
-    select<K extends ArrayPaths<O>>(arrayKey: K, index: number): ItemSelectProps;
     /** Registers an object array element's field using composite syntax "array.field". */
     select<P extends ObjectArrayFieldPaths<O>>(compositePath: P, itemId: string | number): ItemSelectProps;
+    /** Registers a primitive array element by index. */
+    select<K extends ArrayPaths<O>>(arrayKey: K, index: number): ItemSelectProps;
     /** Registers a scalar or nested object field. */
     autocomplete<P extends AllPaths<O>>(id: P): ItemAutocompleteProps;
-    /** Registers an array element — adapts to primitive arrays (by index) or object arrays (by ID + field). */
-    /** Registers an array element — adapts to primitive arrays (by index). */
-    autocomplete<K extends ArrayPaths<O>>(arrayKey: K, index: number): ItemAutocompleteProps;
     /** Registers an object array element's field using composite syntax "array.field". */
     autocomplete<P extends ObjectArrayFieldPaths<O>>(compositePath: P, itemId: string | number): ItemAutocompleteProps;
+    /** Registers a primitive array element by index. */
+    autocomplete<K extends ArrayPaths<O>>(arrayKey: K, index: number): ItemAutocompleteProps;
 }
 /**
  * Recursive type to find all paths to arrays in the state.
@@ -176,10 +174,14 @@ interface HelpersFunc<O extends StateType> {
  */
 interface UseFormResponse<O extends StateType> {
     onFieldBlur: BlurFunc<O>;
-    /** Updates an object array element's field by ID. */
-    onFieldChange<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. */
     onFieldChange<P extends AllPaths<O>>(id: P, value: NestedFieldValue<O, P & string>): void;
+    /** Updates an object array element's field using composite syntax "array.field". */
+    onFieldChange<P extends ObjectArrayFieldPaths<O>>(compositePath: P, itemId: string | number, value: any): void;
+    /** Updates an object array element's field by ID (explicit array key, field, and value). */
+    onFieldChange<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 primitive array element by index. */
+    onFieldChange<K extends ArrayPaths<O>>(arrayKey: K, index: number, value: any): void;
     onSelectionChange: ValueChangeFunc<O, keyof O>;
     state: O;
     setState: React.Dispatch<React.SetStateAction<O>>;

package/package.json

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