@juantroconisf/lib 9.4.0 → 11.0.0

package/dist/index.d.mts

@@ -76,12 +76,19 @@ interface ComponentInputProps {
     onBlur: () => void;
     isInvalid: boolean;
     errorMessage: string;
+    /** Derived from the Yup schema — true when the field is marked .required(). */
+    isRequired: boolean;
 }
-/** Props returned by on.input() */
+/** Props returned by on.input() — for Input and Textarea */
 interface ItemInputProps<V = any> extends ComponentInputProps {
     onValueChange: (value: V) => void;
     value: V;
 }
+/** Props returned by on.numberInput() — for NumberInput */
+interface ItemNumberInputProps extends ComponentInputProps {
+    onValueChange: (value: number) => void;
+    value: number;
+}
 /** Props returned by on.select() */
 interface ItemSelectProps extends ComponentInputProps {
     onSelectionChange: NonNullable<SelectProps["onSelectionChange"]>;
@@ -92,6 +99,16 @@ interface ItemAutocompleteProps extends ComponentInputProps {
     onSelectionChange: NonNullable<AutocompleteProps["onSelectionChange"]>;
     selectedKey: SingleSelection["selectedKey"];
 }
+/** Props returned by on.checkbox() and on.switch() */
+interface ItemToggleProps extends ComponentInputProps {
+    onValueChange: (isSelected: boolean) => void;
+    isSelected: boolean;
+}
+/** Props returned by on.radio() — for RadioGroup */
+interface ItemRadioGroupProps extends ComponentInputProps {
+    onValueChange: (value: string) => void;
+    value: string;
+}
 /**
  * Interface for the polymorphic 'on' method handlers.
  */
@@ -102,6 +119,10 @@ interface OnMethods<O extends StateType> {
     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 numeric field for NumberInput. */
+    numberInput<P extends AllPaths<O>>(id: P): ItemNumberInputProps;
+    /** Registers a numeric field within an object array element. */
+    numberInput<P extends ObjectArrayFieldPaths<O>>(compositePath: P, itemId: string | number): ItemNumberInputProps;
     /** Registers a scalar or nested object field. */
     select<P extends AllPaths<O>>(id: P): ItemSelectProps;
     /** Registers a complete array field for multi-selection. */
@@ -116,6 +137,18 @@ interface OnMethods<O extends StateType> {
     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;
+    /** Registers a boolean field for Checkbox. */
+    checkbox<P extends AllPaths<O>>(id: P): ItemToggleProps;
+    /** Registers a boolean field within an object array element for Checkbox. */
+    checkbox<P extends ObjectArrayFieldPaths<O>>(compositePath: P, itemId: string | number): ItemToggleProps;
+    /** Registers a boolean field for Switch. */
+    switch<P extends AllPaths<O>>(id: P): ItemToggleProps;
+    /** Registers a boolean field within an object array element for Switch. */
+    switch<P extends ObjectArrayFieldPaths<O>>(compositePath: P, itemId: string | number): ItemToggleProps;
+    /** Registers a string field for RadioGroup. */
+    radio<P extends AllPaths<O>>(id: P): ItemRadioGroupProps;
+    /** Registers a string field within an object array element for RadioGroup. */
+    radio<P extends ObjectArrayFieldPaths<O>>(compositePath: P, itemId: string | number): ItemRadioGroupProps;
 }
 /**
  * Recursive type to find all paths to arrays in the state.
@@ -123,10 +156,6 @@ interface OnMethods<O extends StateType> {
 type ArrayPaths<T> = T extends object ? {
     [K in keyof T & string]: NonNullable<T[K]> extends (infer E)[] ? K | (E extends object ? `${K}.${ArrayPaths<E>}` : never) : NonNullable<T[K]> extends object ? NonNullable<T[K]> extends Date ? never : `${K}.${ArrayPaths<NonNullable<T[K]>>}` : never;
 }[keyof T & string] : never;
-/** 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];
 /**
  * Helper to get paths for fields within object arrays.
  * Returns paths like "arrayKey.fieldName".
@@ -137,16 +166,28 @@ type ObjectArrayFieldPaths<O extends StateType> = {
 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;
+/** Extracts the array key from a composite path e.g. "relatives.age" → "relatives". */
+type ExtractArrayKey<P extends string> = P extends `${infer K}.${string}` ? K : never;
+/**
+ * Resolves the identifier field type for the array referenced by a composite path.
+ * e.g. if relatives[].id is string, then ArrayItemIdTypeFromPath<O, "relatives.age"> = string
+ */
+type ArrayItemIdTypeFromPath<O extends StateType, P extends string> = ExtractArrayKey<P> extends keyof O ? ItemIdType<O, ExtractArrayKey<P>> : string | number;
+/**
+ * Resolves the value type for the field referenced by a composite path.
+ * e.g. "relatives.age" → number (the type of the `age` field in each relative item)
+ */
+type CompositeFieldValue<O extends StateType, P extends string> = P extends `${infer K}.${infer F}` ? K extends keyof O ? O[K] extends (infer E)[] ? F extends keyof E ? NonNullable<E[F]> : any : any : any : any;
 type NestedFieldValue<T, F extends string> = F extends `${infer First}.${infer Rest}` ? First extends keyof T ? NestedFieldValue<NonNullable<T[First]>, Rest> : NonNullable<T> extends (infer U)[] ? NestedFieldValue<U, F> : any : F extends keyof T ? NonNullable<T[F]> : NonNullable<T> extends (infer U)[] ? F extends keyof U ? NonNullable<U[F]> : any : any;
 type FieldPaths<T> = T extends Record<string, any> ? {
     [K in keyof T & string]: T[K] extends any[] ? K : T[K] extends Record<string, any> ? `${K}.${FieldPaths<T[K]>}` : K;
 }[keyof T & string] : never;
 type NestedObjectPaths<O extends StateType> = {
-    [K in keyof O & string]: O[K] extends any[] ? never : O[K] extends Record<string, any> ? `${K}.${FieldPaths<O[K]>}` : never;
+    [K in keyof O & string]: NonNullable<O[K]> extends any[] ? never : NonNullable<O[K]> extends Date ? never : NonNullable<O[K]> extends Record<string, any> ? `${K}.${FieldPaths<NonNullable<O[K]>>}` : never;
 }[keyof O & string];
-/** Keys whose values are not arrays and not plain objects (i.e. scalar/primitive fields). */
+/** Keys whose values are not arrays and not plain objects (i.e. scalar/primitive fields). Date is treated as a scalar. */
 type ScalarKeys<O extends StateType> = {
-    [K in keyof O]: O[K] extends any[] ? never : O[K] extends Record<string, any> ? never : K;
+    [K in keyof O]: NonNullable<O[K]> extends any[] ? never : NonNullable<O[K]> extends Date ? K : NonNullable<O[K]> extends Record<string, any> ? never : K;
 }[keyof O];
 type AllPaths<O extends StateType> = ScalarKeys<O> | NestedObjectPaths<O>;
 /**
@@ -156,17 +197,19 @@ interface HelpersFunc<O extends StateType> {
     /** Adds a new item to an array. */
     addItem: <K extends ArrayPaths<O>>(arrayKey: K, item: NestedFieldValue<O, K> extends (infer E)[] ? E : never, index?: number) => void;
     /** Removes an item from an array by its index. */
-    removeItem: <K extends ArrayPaths<O>>(arrayKey: K, index: number) => void;
+    removeItemByIndexByIndex: <K extends ArrayPaths<O>>(arrayKey: K, index: number) => void;
     /** Removes an item from an array by its unique identifier. */
     removeById: <K extends ArrayPaths<O>>(arrayKey: K, itemId: string | number) => void;
-    /** Replaces an item in an array at the given index. */
-    updateItem: <K extends ArrayPaths<O>>(arrayKey: K, index: number, value: NestedFieldValue<O, K> extends (infer E)[] ? E : never) => void;
+    /** Updates an item in an array at the given index (supports partial updates). */
+    updateByIndex: <K extends ArrayPaths<O>>(arrayKey: K, index: number, value: NestedFieldValue<O, K> extends (infer E)[] ? Partial<E> : never) => void;
+    /** Updates an item in an array by its unique identifier (supports partial updates). */
+    updateById: <K extends ArrayPaths<O>>(arrayKey: K, itemId: string | number, value: NestedFieldValue<O, K> extends (infer E)[] ? Partial<E> : never) => void;
     /** Moves an item within an array using indices. */
-    moveItem: <K extends ArrayPaths<O>>(arrayKey: K, from: number, to: number) => void;
+    moveItemByIndex: <K extends ArrayPaths<O>>(arrayKey: K, from: number, to: number) => void;
     /** Moves an item within an array using unique identifiers. */
     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). */
-    getItem: <K extends ArrayPaths<O>>(arrayKey: K, itemId: string | number) => (NestedFieldValue<O, K> extends (infer E)[] ? E : never) | undefined;
+    getItemById: <K extends ArrayPaths<O>>(arrayKey: K, itemId: string | number) => (NestedFieldValue<O, K> extends (infer E)[] ? E : never) | undefined;
 }
 /**
  * The response object from the useForm hook.
@@ -176,13 +219,26 @@ interface UseFormResponse<O extends StateType> {
     onFieldBlur: BlurFunc<O>;
     /** 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;
+    /** Manually updates a field within an object array item. */
+    onArrayItemChange<P extends ObjectArrayFieldPaths<O>>(options: {
+        /** Composite dot-notation path: e.g. "users.name" */
+        at: P;
+        /** The unique identifier of the target array item — type is inferred from the array element's id field. */
+        id: ArrayItemIdTypeFromPath<O, P & string>;
+        /** The new value — type is inferred from the field referenced by `at`. */
+        value: CompositeFieldValue<O, P & string>;
+    }): void;
+    /** Manually updates a scalar or nested object selection field. */
     onSelectionChange: ValueChangeFunc<O, keyof O>;
+    /** Manually updates a selection-based field within an object array item. */
+    onArraySelectionChange<P extends ObjectArrayFieldPaths<O>>(options: {
+        /** Composite dot-notation path: e.g. "users.role" */
+        at: P;
+        /** The unique identifier of the target array item — type is inferred from the array element's id field. */
+        id: ArrayItemIdTypeFromPath<O, P & string>;
+        /** The new selection value — type is inferred from the field referenced by `at`. */
+        value: CompositeFieldValue<O, P & string>;
+    }): void;
     state: O;
     setState: React.Dispatch<React.SetStateAction<O>>;
     metadata: MetadataType;

package/dist/index.d.ts

@@ -76,12 +76,19 @@ interface ComponentInputProps {
     onBlur: () => void;
     isInvalid: boolean;
     errorMessage: string;
+    /** Derived from the Yup schema — true when the field is marked .required(). */
+    isRequired: boolean;
 }
-/** Props returned by on.input() */
+/** Props returned by on.input() — for Input and Textarea */
 interface ItemInputProps<V = any> extends ComponentInputProps {
     onValueChange: (value: V) => void;
     value: V;
 }
+/** Props returned by on.numberInput() — for NumberInput */
+interface ItemNumberInputProps extends ComponentInputProps {
+    onValueChange: (value: number) => void;
+    value: number;
+}
 /** Props returned by on.select() */
 interface ItemSelectProps extends ComponentInputProps {
     onSelectionChange: NonNullable<SelectProps["onSelectionChange"]>;
@@ -92,6 +99,16 @@ interface ItemAutocompleteProps extends ComponentInputProps {
     onSelectionChange: NonNullable<AutocompleteProps["onSelectionChange"]>;
     selectedKey: SingleSelection["selectedKey"];
 }
+/** Props returned by on.checkbox() and on.switch() */
+interface ItemToggleProps extends ComponentInputProps {
+    onValueChange: (isSelected: boolean) => void;
+    isSelected: boolean;
+}
+/** Props returned by on.radio() — for RadioGroup */
+interface ItemRadioGroupProps extends ComponentInputProps {
+    onValueChange: (value: string) => void;
+    value: string;
+}
 /**
  * Interface for the polymorphic 'on' method handlers.
  */
@@ -102,6 +119,10 @@ interface OnMethods<O extends StateType> {
     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 numeric field for NumberInput. */
+    numberInput<P extends AllPaths<O>>(id: P): ItemNumberInputProps;
+    /** Registers a numeric field within an object array element. */
+    numberInput<P extends ObjectArrayFieldPaths<O>>(compositePath: P, itemId: string | number): ItemNumberInputProps;
     /** Registers a scalar or nested object field. */
     select<P extends AllPaths<O>>(id: P): ItemSelectProps;
     /** Registers a complete array field for multi-selection. */
@@ -116,6 +137,18 @@ interface OnMethods<O extends StateType> {
     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;
+    /** Registers a boolean field for Checkbox. */
+    checkbox<P extends AllPaths<O>>(id: P): ItemToggleProps;
+    /** Registers a boolean field within an object array element for Checkbox. */
+    checkbox<P extends ObjectArrayFieldPaths<O>>(compositePath: P, itemId: string | number): ItemToggleProps;
+    /** Registers a boolean field for Switch. */
+    switch<P extends AllPaths<O>>(id: P): ItemToggleProps;
+    /** Registers a boolean field within an object array element for Switch. */
+    switch<P extends ObjectArrayFieldPaths<O>>(compositePath: P, itemId: string | number): ItemToggleProps;
+    /** Registers a string field for RadioGroup. */
+    radio<P extends AllPaths<O>>(id: P): ItemRadioGroupProps;
+    /** Registers a string field within an object array element for RadioGroup. */
+    radio<P extends ObjectArrayFieldPaths<O>>(compositePath: P, itemId: string | number): ItemRadioGroupProps;
 }
 /**
  * Recursive type to find all paths to arrays in the state.
@@ -123,10 +156,6 @@ interface OnMethods<O extends StateType> {
 type ArrayPaths<T> = T extends object ? {
     [K in keyof T & string]: NonNullable<T[K]> extends (infer E)[] ? K | (E extends object ? `${K}.${ArrayPaths<E>}` : never) : NonNullable<T[K]> extends object ? NonNullable<T[K]> extends Date ? never : `${K}.${ArrayPaths<NonNullable<T[K]>>}` : never;
 }[keyof T & string] : never;
-/** 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];
 /**
  * Helper to get paths for fields within object arrays.
  * Returns paths like "arrayKey.fieldName".
@@ -137,16 +166,28 @@ type ObjectArrayFieldPaths<O extends StateType> = {
 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;
+/** Extracts the array key from a composite path e.g. "relatives.age" → "relatives". */
+type ExtractArrayKey<P extends string> = P extends `${infer K}.${string}` ? K : never;
+/**
+ * Resolves the identifier field type for the array referenced by a composite path.
+ * e.g. if relatives[].id is string, then ArrayItemIdTypeFromPath<O, "relatives.age"> = string
+ */
+type ArrayItemIdTypeFromPath<O extends StateType, P extends string> = ExtractArrayKey<P> extends keyof O ? ItemIdType<O, ExtractArrayKey<P>> : string | number;
+/**
+ * Resolves the value type for the field referenced by a composite path.
+ * e.g. "relatives.age" → number (the type of the `age` field in each relative item)
+ */
+type CompositeFieldValue<O extends StateType, P extends string> = P extends `${infer K}.${infer F}` ? K extends keyof O ? O[K] extends (infer E)[] ? F extends keyof E ? NonNullable<E[F]> : any : any : any : any;
 type NestedFieldValue<T, F extends string> = F extends `${infer First}.${infer Rest}` ? First extends keyof T ? NestedFieldValue<NonNullable<T[First]>, Rest> : NonNullable<T> extends (infer U)[] ? NestedFieldValue<U, F> : any : F extends keyof T ? NonNullable<T[F]> : NonNullable<T> extends (infer U)[] ? F extends keyof U ? NonNullable<U[F]> : any : any;
 type FieldPaths<T> = T extends Record<string, any> ? {
     [K in keyof T & string]: T[K] extends any[] ? K : T[K] extends Record<string, any> ? `${K}.${FieldPaths<T[K]>}` : K;
 }[keyof T & string] : never;
 type NestedObjectPaths<O extends StateType> = {
-    [K in keyof O & string]: O[K] extends any[] ? never : O[K] extends Record<string, any> ? `${K}.${FieldPaths<O[K]>}` : never;
+    [K in keyof O & string]: NonNullable<O[K]> extends any[] ? never : NonNullable<O[K]> extends Date ? never : NonNullable<O[K]> extends Record<string, any> ? `${K}.${FieldPaths<NonNullable<O[K]>>}` : never;
 }[keyof O & string];
-/** Keys whose values are not arrays and not plain objects (i.e. scalar/primitive fields). */
+/** Keys whose values are not arrays and not plain objects (i.e. scalar/primitive fields). Date is treated as a scalar. */
 type ScalarKeys<O extends StateType> = {
-    [K in keyof O]: O[K] extends any[] ? never : O[K] extends Record<string, any> ? never : K;
+    [K in keyof O]: NonNullable<O[K]> extends any[] ? never : NonNullable<O[K]> extends Date ? K : NonNullable<O[K]> extends Record<string, any> ? never : K;
 }[keyof O];
 type AllPaths<O extends StateType> = ScalarKeys<O> | NestedObjectPaths<O>;
 /**
@@ -156,17 +197,19 @@ interface HelpersFunc<O extends StateType> {
     /** Adds a new item to an array. */
     addItem: <K extends ArrayPaths<O>>(arrayKey: K, item: NestedFieldValue<O, K> extends (infer E)[] ? E : never, index?: number) => void;
     /** Removes an item from an array by its index. */
-    removeItem: <K extends ArrayPaths<O>>(arrayKey: K, index: number) => void;
+    removeItemByIndexByIndex: <K extends ArrayPaths<O>>(arrayKey: K, index: number) => void;
     /** Removes an item from an array by its unique identifier. */
     removeById: <K extends ArrayPaths<O>>(arrayKey: K, itemId: string | number) => void;
-    /** Replaces an item in an array at the given index. */
-    updateItem: <K extends ArrayPaths<O>>(arrayKey: K, index: number, value: NestedFieldValue<O, K> extends (infer E)[] ? E : never) => void;
+    /** Updates an item in an array at the given index (supports partial updates). */
+    updateByIndex: <K extends ArrayPaths<O>>(arrayKey: K, index: number, value: NestedFieldValue<O, K> extends (infer E)[] ? Partial<E> : never) => void;
+    /** Updates an item in an array by its unique identifier (supports partial updates). */
+    updateById: <K extends ArrayPaths<O>>(arrayKey: K, itemId: string | number, value: NestedFieldValue<O, K> extends (infer E)[] ? Partial<E> : never) => void;
     /** Moves an item within an array using indices. */
-    moveItem: <K extends ArrayPaths<O>>(arrayKey: K, from: number, to: number) => void;
+    moveItemByIndex: <K extends ArrayPaths<O>>(arrayKey: K, from: number, to: number) => void;
     /** Moves an item within an array using unique identifiers. */
     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). */
-    getItem: <K extends ArrayPaths<O>>(arrayKey: K, itemId: string | number) => (NestedFieldValue<O, K> extends (infer E)[] ? E : never) | undefined;
+    getItemById: <K extends ArrayPaths<O>>(arrayKey: K, itemId: string | number) => (NestedFieldValue<O, K> extends (infer E)[] ? E : never) | undefined;
 }
 /**
  * The response object from the useForm hook.
@@ -176,13 +219,26 @@ interface UseFormResponse<O extends StateType> {
     onFieldBlur: BlurFunc<O>;
     /** 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;
+    /** Manually updates a field within an object array item. */
+    onArrayItemChange<P extends ObjectArrayFieldPaths<O>>(options: {
+        /** Composite dot-notation path: e.g. "users.name" */
+        at: P;
+        /** The unique identifier of the target array item — type is inferred from the array element's id field. */
+        id: ArrayItemIdTypeFromPath<O, P & string>;
+        /** The new value — type is inferred from the field referenced by `at`. */
+        value: CompositeFieldValue<O, P & string>;
+    }): void;
+    /** Manually updates a scalar or nested object selection field. */
     onSelectionChange: ValueChangeFunc<O, keyof O>;
+    /** Manually updates a selection-based field within an object array item. */
+    onArraySelectionChange<P extends ObjectArrayFieldPaths<O>>(options: {
+        /** Composite dot-notation path: e.g. "users.role" */
+        at: P;
+        /** The unique identifier of the target array item — type is inferred from the array element's id field. */
+        id: ArrayItemIdTypeFromPath<O, P & string>;
+        /** The new selection value — type is inferred from the field referenced by `at`. */
+        value: CompositeFieldValue<O, P & string>;
+    }): void;
     state: O;
     setState: React.Dispatch<React.SetStateAction<O>>;
     metadata: MetadataType;

package/dist/index.js

@@ -592,10 +592,17 @@ function useForm(schema, {
       const { compositeKey, fieldPath, realPath, value } = resolution;
       const meta = metadataRef.current.get(compositeKey);
       const isTouched = meta?.isTouched;
+      let isRequired = false;
+      try {
+        const rule = getRule(fieldPath, validationSchema);
+        if (rule) isRequired = rule.describe().optional === false;
+      } catch {
+      }
       return {
         id: compositeKey,
         isInvalid: Boolean(isTouched && meta?.isInvalid),
         errorMessage: isTouched ? meta?.errorMessage || "" : "",
+        isRequired,
         onBlur: () => {
           if (metadataRef.current.get(compositeKey)?.isTouched) return;
           validateField(
@@ -618,7 +625,7 @@ function useForm(schema, {
         }
       };
     },
-    [validateField]
+    [validateField, getRule, validationSchema]
   );
   const on = (0, import_react2.useMemo)(
     () => ({
@@ -670,6 +677,62 @@ function useForm(schema, {
             handleFieldChange(data, fixed);
           }
         };
+      },
+      numberInput: (...args) => {
+        const data = resolveFieldData(
+          args,
+          stateRef.current,
+          getIndex,
+          getNestedValue
+        );
+        if (!data) return {};
+        return {
+          ...createHandlers(data),
+          value: data.value ?? 0,
+          onValueChange: (v) => handleFieldChange(data, v)
+        };
+      },
+      checkbox: (...args) => {
+        const data = resolveFieldData(
+          args,
+          stateRef.current,
+          getIndex,
+          getNestedValue
+        );
+        if (!data) return {};
+        return {
+          ...createHandlers(data),
+          isSelected: Boolean(data.value),
+          onValueChange: (v) => handleFieldChange(data, v)
+        };
+      },
+      switch: (...args) => {
+        const data = resolveFieldData(
+          args,
+          stateRef.current,
+          getIndex,
+          getNestedValue
+        );
+        if (!data) return {};
+        return {
+          ...createHandlers(data),
+          isSelected: Boolean(data.value),
+          onValueChange: (v) => handleFieldChange(data, v)
+        };
+      },
+      radio: (...args) => {
+        const data = resolveFieldData(
+          args,
+          stateRef.current,
+          getIndex,
+          getNestedValue
+        );
+        if (!data) return {};
+        return {
+          ...createHandlers(data),
+          value: data.value ?? "",
+          onValueChange: (v) => handleFieldChange(data, v)
+        };
       }
     }),
     [createHandlers, getIndex, handleFieldChange]
@@ -689,7 +752,7 @@ function useForm(schema, {
           });
         });
       },
-      removeItem: (arrayKey, index) => {
+      removeItemByIndexByIndex: (arrayKey, index) => {
         const currentArr = getNestedValue(stateRef.current, arrayKey) || [];
         const item = currentArr[index];
         const idKey = arrayIdentifiers?.[arrayKey] || "id";
@@ -726,10 +789,10 @@ function useForm(schema, {
           setMetadata((prev) => removeCompositeKeysByPrefix(prev, prefix));
         }
       },
-      updateItem: (arrayKey, index, value) => {
+      updateByIndex: (arrayKey, index, value) => {
         setState((prev) => {
           const arr = [...getNestedValue(prev, arrayKey) || []];
-          arr[index] = value;
+          arr[index] = typeof arr[index] === "object" && typeof value === "object" ? { ...arr[index], ...value } : value;
           return handleNestedChange({
             state: prev,
             id: arrayKey,
@@ -738,7 +801,22 @@ function useForm(schema, {
           });
         });
       },
-      moveItem: (arrayKey, from, to) => {
+      updateById: (arrayKey, itemId, value) => {
+        const index = getIndex(arrayKey, itemId);
+        if (index !== void 0) {
+          setState((prev) => {
+            const arr = [...getNestedValue(prev, arrayKey) || []];
+            arr[index] = typeof arr[index] === "object" && typeof value === "object" ? { ...arr[index], ...value } : value;
+            return handleNestedChange({
+              state: prev,
+              id: arrayKey,
+              value: arr,
+              hasNestedValues: String(arrayKey).includes(".")
+            });
+          });
+        }
+      },
+      moveItemByIndex: (arrayKey, from, to) => {
         setState((prev) => {
           const arr = [...getNestedValue(prev, arrayKey) || []];
           const [item] = arr.splice(from, 1);
@@ -768,7 +846,7 @@ function useForm(schema, {
           });
         }
       },
-      getItem: (arrayKey, itemId) => {
+      getItemById: (arrayKey, itemId) => {
         const index = getIndex(arrayKey, itemId);
         if (index === void 0) return void 0;
         return getNestedValue(stateRef.current, arrayKey)[index];
@@ -798,12 +876,26 @@ function useForm(schema, {
     },
     [validateField]
   );
-  const polymorphicOnValueChange = (0, import_react2.useCallback)(
-    (...args) => {
-      const value = args[args.length - 1];
-      const idArgs = args.slice(0, args.length - 1);
+  const scalarOnFieldChange = (0, import_react2.useCallback)(
+    (id, value) => {
+      const data = resolveFieldData(
+        [id],
+        stateRef.current,
+        getIndex,
+        getNestedValue
+      );
+      if (data) handleFieldChange(data, value);
+    },
+    [getIndex, handleFieldChange]
+  );
+  const arrayItemChange = (0, import_react2.useCallback)(
+    ({
+      at: compositePath,
+      id: itemId,
+      value
+    }) => {
       const data = resolveFieldData(
-        idArgs,
+        [compositePath, itemId],
         stateRef.current,
         getIndex,
         getNestedValue
@@ -812,7 +904,7 @@ function useForm(schema, {
     },
     [getIndex, handleFieldChange]
   );
-  const polymorphicOnSelectionChange = (0, import_react2.useCallback)(
+  const scalarOnSelectionChange = (0, import_react2.useCallback)(
     (id, val) => {
       const fixed = typeof val === "string" || val === null ? val : Array.from(val);
       let nextState = handleNestedChange({
@@ -826,6 +918,23 @@ function useForm(schema, {
     },
     [validateField]
   );
+  const arraySelectionChange = (0, import_react2.useCallback)(
+    ({
+      at: compositePath,
+      id: itemId,
+      value: val
+    }) => {
+      const fixed = typeof val === "string" || val === null ? val : Array.from(val);
+      const data = resolveFieldData(
+        [compositePath, itemId],
+        stateRef.current,
+        getIndex,
+        getNestedValue
+      );
+      if (data) handleFieldChange(data, fixed);
+    },
+    [getIndex, handleFieldChange]
+  );
   const onFormSubmit = (0, import_react2.useCallback)(
     (fn) => (e) => {
       e.preventDefault();
@@ -892,9 +1001,11 @@ function useForm(schema, {
       metadata,
       on,
       helpers,
-      onFieldChange: polymorphicOnValueChange,
+      onFieldChange: scalarOnFieldChange,
+      onArrayItemChange: arrayItemChange,
       onFieldBlur: onBlur,
-      onSelectionChange: polymorphicOnSelectionChange,
+      onSelectionChange: scalarOnSelectionChange,
+      onArraySelectionChange: arraySelectionChange,
       isDirty: Array.from(metadata.values()).some((m) => m.isTouched),
       onFormReset: handleReset,
       onFormSubmit,
@@ -907,8 +1018,10 @@ function useForm(schema, {
       on,
       helpers,
       onBlur,
-      polymorphicOnValueChange,
-      polymorphicOnSelectionChange,
+      scalarOnFieldChange,
+      arrayItemChange,
+      scalarOnSelectionChange,
+      arraySelectionChange,
       validateAll,
       onFormSubmit,
       ControlledForm,