@uniform-ts/core 0.0.8 → 0.0.9

package/dist/{field-KKjnXn-d.d.mts → field-Cogi7eQc.d.mts}

@@ -27,14 +27,28 @@ type ArrayItem<T> = T extends (infer U)[] ? U : never;
 type DeepKeys<T> = T extends object ? {
     [K in keyof T & string]: T[K] extends unknown[] ? ArrayItem<T[K]> extends object ? K | `${K}.${DeepKeys<ArrayItem<T[K]>>}` : K : T[K] extends object ? K | `${K}.${DeepKeys<T[K]>}` : K;
 }[keyof T & string] : never;
+/**
+ * Extends `DeepKeys` with index-based array paths like `"items.0.name"`.
+ * Used by `setOnChange` to allow registering handlers for specific rows.
+ *
+ * @example
+ * // Given { tasks: { priority: string; notes: string }[] }
+ * // DeepKeysIndexed adds: "tasks.0.priority" | "tasks.0.notes" | "tasks.1.priority" | ...
+ * // (represented as template literal `tasks.${number}.priority`)
+ */
+type DeepKeysIndexed<T> = T extends object ? {
+    [K in keyof T & string]: T[K] extends unknown[] ? ArrayItem<T[K]> extends object ? K | `${K}.${DeepKeys<ArrayItem<T[K]>>}` | `${K}.${number}.${DeepKeys<ArrayItem<T[K]>>}` : K : T[K] extends object ? K | `${K}.${DeepKeysIndexed<T[K]>}` : K;
+}[keyof T & string] : never;
 /**
  * Resolves the value type at a dot-notated path within a type `T`.
  * Array fields use the unprefixed child path (matching `DeepKeys` convention).
+ * Also supports indexed paths like `"items.0.qty"` — the numeric segment is skipped.
  *
  * @example
  * // DeepFieldValue<{ name: string; items: { qty: number }[] }, 'items.qty'> → number
+ * // DeepFieldValue<{ items: { qty: number }[] }, 'items.0.qty'> → number
  */
-type DeepFieldValue<T, K extends string> = K extends keyof T ? T[K] : K extends `${infer Head}.${infer Tail}` ? Head extends keyof T ? T[Head] extends (infer Item)[] ? DeepFieldValue<NonNullable<Item>, Tail> : DeepFieldValue<NonNullable<T[Head]>, Tail> : unknown : unknown;
+type DeepFieldValue<T, K extends string> = K extends keyof T ? T[K] : K extends `${infer Head}.${infer Tail}` ? Head extends keyof T ? T[Head] extends (infer Item)[] ? Tail extends `${number}.${infer Rest}` ? DeepFieldValue<NonNullable<Item>, Rest> : DeepFieldValue<NonNullable<Item>, Tail> : DeepFieldValue<NonNullable<T[Head]>, Tail> : unknown : unknown;
 /**
  * Resolves the values type that a `setCondition` predicate receives for a
  * given field key `K` within form values type `TValues`.
@@ -745,4 +759,4 @@ type FieldOverride<TSchema extends z.$ZodObject = z.$ZodObject, TValue = unknown
     [key: string]: unknown;
 };
 
-export type { AutoFormProps as A, SubmitButtonProps as B, ComponentRegistry as C, DeepKeys as D, FieldMetaBase as F, LayoutSlots as L, ObjectWrapperProps as O, PersistStorage as P, ResolvedLayoutSlots as R, SectionConfig as S, ValidationMessages as V, FieldConfig as a, AutoFormHandle as b, FieldProps as c, FieldWrapperProps as d, ArrayButtonProps as e, ArrayCollapseButtonProps as f, ArrayFieldLayoutProps as g, ArrayRowLayoutProps as h, ArrayWrapperProps as i, AutoFormConfig as j, FormMethods as k, FieldDependencyResult as l, DeepFieldValue as m, ConditionValues as n, FormClassNames as o, CoercionMap as p, FormLabels as q, ArrayButtonSlots as r, FieldCondition as s, FieldMeta as t, FieldOverride as u, FieldType as v, FormWrapperProps as w, ResolvedArrayButtonSlots as x, SectionWrapperProps as y, SelectOption as z };
+export type { AutoFormProps as A, SelectOption as B, ComponentRegistry as C, DeepKeysIndexed as D, SubmitButtonProps as E, FieldMetaBase as F, LayoutSlots as L, ObjectWrapperProps as O, PersistStorage as P, ResolvedLayoutSlots as R, SectionConfig as S, ValidationMessages as V, FieldConfig as a, AutoFormHandle as b, FieldProps as c, FieldWrapperProps as d, ArrayButtonProps as e, ArrayCollapseButtonProps as f, ArrayFieldLayoutProps as g, ArrayRowLayoutProps as h, ArrayWrapperProps as i, AutoFormConfig as j, FormMethods as k, DeepKeys as l, FieldDependencyResult as m, DeepFieldValue as n, ConditionValues as o, FormClassNames as p, CoercionMap as q, FormLabels as r, ArrayButtonSlots as s, FieldCondition as t, FieldMeta as u, FieldOverride as v, FieldType as w, FormWrapperProps as x, ResolvedArrayButtonSlots as y, SectionWrapperProps as z };

package/dist/{field-KKjnXn-d.d.ts → field-Cogi7eQc.d.ts}

@@ -27,14 +27,28 @@ type ArrayItem<T> = T extends (infer U)[] ? U : never;
 type DeepKeys<T> = T extends object ? {
     [K in keyof T & string]: T[K] extends unknown[] ? ArrayItem<T[K]> extends object ? K | `${K}.${DeepKeys<ArrayItem<T[K]>>}` : K : T[K] extends object ? K | `${K}.${DeepKeys<T[K]>}` : K;
 }[keyof T & string] : never;
+/**
+ * Extends `DeepKeys` with index-based array paths like `"items.0.name"`.
+ * Used by `setOnChange` to allow registering handlers for specific rows.
+ *
+ * @example
+ * // Given { tasks: { priority: string; notes: string }[] }
+ * // DeepKeysIndexed adds: "tasks.0.priority" | "tasks.0.notes" | "tasks.1.priority" | ...
+ * // (represented as template literal `tasks.${number}.priority`)
+ */
+type DeepKeysIndexed<T> = T extends object ? {
+    [K in keyof T & string]: T[K] extends unknown[] ? ArrayItem<T[K]> extends object ? K | `${K}.${DeepKeys<ArrayItem<T[K]>>}` | `${K}.${number}.${DeepKeys<ArrayItem<T[K]>>}` : K : T[K] extends object ? K | `${K}.${DeepKeysIndexed<T[K]>}` : K;
+}[keyof T & string] : never;
 /**
  * Resolves the value type at a dot-notated path within a type `T`.
  * Array fields use the unprefixed child path (matching `DeepKeys` convention).
+ * Also supports indexed paths like `"items.0.qty"` — the numeric segment is skipped.
  *
  * @example
  * // DeepFieldValue<{ name: string; items: { qty: number }[] }, 'items.qty'> → number
+ * // DeepFieldValue<{ items: { qty: number }[] }, 'items.0.qty'> → number
  */
-type DeepFieldValue<T, K extends string> = K extends keyof T ? T[K] : K extends `${infer Head}.${infer Tail}` ? Head extends keyof T ? T[Head] extends (infer Item)[] ? DeepFieldValue<NonNullable<Item>, Tail> : DeepFieldValue<NonNullable<T[Head]>, Tail> : unknown : unknown;
+type DeepFieldValue<T, K extends string> = K extends keyof T ? T[K] : K extends `${infer Head}.${infer Tail}` ? Head extends keyof T ? T[Head] extends (infer Item)[] ? Tail extends `${number}.${infer Rest}` ? DeepFieldValue<NonNullable<Item>, Rest> : DeepFieldValue<NonNullable<Item>, Tail> : DeepFieldValue<NonNullable<T[Head]>, Tail> : unknown : unknown;
 /**
  * Resolves the values type that a `setCondition` predicate receives for a
  * given field key `K` within form values type `TValues`.
@@ -745,4 +759,4 @@ type FieldOverride<TSchema extends z.$ZodObject = z.$ZodObject, TValue = unknown
     [key: string]: unknown;
 };
 
-export type { AutoFormProps as A, SubmitButtonProps as B, ComponentRegistry as C, DeepKeys as D, FieldMetaBase as F, LayoutSlots as L, ObjectWrapperProps as O, PersistStorage as P, ResolvedLayoutSlots as R, SectionConfig as S, ValidationMessages as V, FieldConfig as a, AutoFormHandle as b, FieldProps as c, FieldWrapperProps as d, ArrayButtonProps as e, ArrayCollapseButtonProps as f, ArrayFieldLayoutProps as g, ArrayRowLayoutProps as h, ArrayWrapperProps as i, AutoFormConfig as j, FormMethods as k, FieldDependencyResult as l, DeepFieldValue as m, ConditionValues as n, FormClassNames as o, CoercionMap as p, FormLabels as q, ArrayButtonSlots as r, FieldCondition as s, FieldMeta as t, FieldOverride as u, FieldType as v, FormWrapperProps as w, ResolvedArrayButtonSlots as x, SectionWrapperProps as y, SelectOption as z };
+export type { AutoFormProps as A, SelectOption as B, ComponentRegistry as C, DeepKeysIndexed as D, SubmitButtonProps as E, FieldMetaBase as F, LayoutSlots as L, ObjectWrapperProps as O, PersistStorage as P, ResolvedLayoutSlots as R, SectionConfig as S, ValidationMessages as V, FieldConfig as a, AutoFormHandle as b, FieldProps as c, FieldWrapperProps as d, ArrayButtonProps as e, ArrayCollapseButtonProps as f, ArrayFieldLayoutProps as g, ArrayRowLayoutProps as h, ArrayWrapperProps as i, AutoFormConfig as j, FormMethods as k, DeepKeys as l, FieldDependencyResult as m, DeepFieldValue as n, ConditionValues as o, FormClassNames as p, CoercionMap as q, FormLabels as r, ArrayButtonSlots as s, FieldCondition as t, FieldMeta as u, FieldOverride as v, FieldType as w, FormWrapperProps as x, ResolvedArrayButtonSlots as y, SectionWrapperProps as z };

package/dist/index.d.mts

@@ -1,5 +1,5 @@
-import { F as FieldMetaBase, a as FieldConfig, A as AutoFormProps, b as AutoFormHandle, c as FieldProps, d as FieldWrapperProps, e as ArrayButtonProps, f as ArrayCollapseButtonProps, g as ArrayFieldLayoutProps, h as ArrayRowLayoutProps, O as ObjectWrapperProps, i as ArrayWrapperProps, C as ComponentRegistry, j as AutoFormConfig, D as DeepKeys, k as FormMethods, l as FieldDependencyResult, m as DeepFieldValue, n as ConditionValues, P as PersistStorage, R as ResolvedLayoutSlots, o as FormClassNames, p as CoercionMap$1, V as ValidationMessages, q as FormLabels } from './field-KKjnXn-d.mjs';
-export { r as ArrayButtonSlots, s as FieldCondition, t as FieldMeta, u as FieldOverride, v as FieldType, w as FormWrapperProps, L as LayoutSlots, x as ResolvedArrayButtonSlots, S as SectionConfig, y as SectionWrapperProps, z as SelectOption, B as SubmitButtonProps } from './field-KKjnXn-d.mjs';
+import { F as FieldMetaBase, a as FieldConfig, A as AutoFormProps, b as AutoFormHandle, c as FieldProps, d as FieldWrapperProps, e as ArrayButtonProps, f as ArrayCollapseButtonProps, g as ArrayFieldLayoutProps, h as ArrayRowLayoutProps, O as ObjectWrapperProps, i as ArrayWrapperProps, C as ComponentRegistry, j as AutoFormConfig, D as DeepKeysIndexed, k as FormMethods, l as DeepKeys, m as FieldDependencyResult, n as DeepFieldValue, o as ConditionValues, P as PersistStorage, R as ResolvedLayoutSlots, p as FormClassNames, q as CoercionMap$1, V as ValidationMessages, r as FormLabels } from './field-Cogi7eQc.mjs';
+export { s as ArrayButtonSlots, t as FieldCondition, u as FieldMeta, v as FieldOverride, w as FieldType, x as FormWrapperProps, L as LayoutSlots, y as ResolvedArrayButtonSlots, S as SectionConfig, z as SectionWrapperProps, B as SelectOption, E as SubmitButtonProps } from './field-Cogi7eQc.mjs';
 import * as z from 'zod/v4/core';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as React from 'react';
@@ -227,9 +227,13 @@ declare class UniForm<TSchema extends z.$ZodObject, TRegistered extends string =
      * Replaces any previously registered handler for that field — only one
      * handler per field is kept. This prevents accidental handler accumulation
      * when called inside a React render cycle.
+     *
+     * Supports both generic array paths (`"tasks.priority"` — fires for all rows)
+     * and indexed paths (`"tasks.0.priority"` — fires only for row 0).
+     *
      * Returns `this` for fluent chaining.
      */
-    setOnChange<K extends Exclude<DeepKeys<z.infer<TSchema>>, TRegistered>>(field: K, handler: Handler<TSchema, DeepFieldValue<z.infer<TSchema>, K>>): UniForm<TSchema, TRegistered | K>;
+    setOnChange<K extends Exclude<DeepKeysIndexed<z.infer<TSchema>>, TRegistered>>(field: K, handler: Handler<TSchema, DeepFieldValue<z.infer<TSchema>, K>>): UniForm<TSchema, TRegistered | K>;
     /**
      * Attach a typed condition for a specific field.
      * The field is shown when the predicate returns `true`, hidden when `false`.
@@ -376,6 +380,7 @@ type AutoFormContextValue = {
     labels: FormLabels;
     formMethods: FormMethods;
     control: Control;
+    setDynamicMeta: React.Dispatch<React.SetStateAction<Record<string, Partial<FieldDependencyResult>>>>;
 };
 declare function useAutoFormContext(): AutoFormContextValue;
 

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { F as FieldMetaBase, a as FieldConfig, A as AutoFormProps, b as AutoFormHandle, c as FieldProps, d as FieldWrapperProps, e as ArrayButtonProps, f as ArrayCollapseButtonProps, g as ArrayFieldLayoutProps, h as ArrayRowLayoutProps, O as ObjectWrapperProps, i as ArrayWrapperProps, C as ComponentRegistry, j as AutoFormConfig, D as DeepKeys, k as FormMethods, l as FieldDependencyResult, m as DeepFieldValue, n as ConditionValues, P as PersistStorage, R as ResolvedLayoutSlots, o as FormClassNames, p as CoercionMap$1, V as ValidationMessages, q as FormLabels } from './field-KKjnXn-d.js';
-export { r as ArrayButtonSlots, s as FieldCondition, t as FieldMeta, u as FieldOverride, v as FieldType, w as FormWrapperProps, L as LayoutSlots, x as ResolvedArrayButtonSlots, S as SectionConfig, y as SectionWrapperProps, z as SelectOption, B as SubmitButtonProps } from './field-KKjnXn-d.js';
+import { F as FieldMetaBase, a as FieldConfig, A as AutoFormProps, b as AutoFormHandle, c as FieldProps, d as FieldWrapperProps, e as ArrayButtonProps, f as ArrayCollapseButtonProps, g as ArrayFieldLayoutProps, h as ArrayRowLayoutProps, O as ObjectWrapperProps, i as ArrayWrapperProps, C as ComponentRegistry, j as AutoFormConfig, D as DeepKeysIndexed, k as FormMethods, l as DeepKeys, m as FieldDependencyResult, n as DeepFieldValue, o as ConditionValues, P as PersistStorage, R as ResolvedLayoutSlots, p as FormClassNames, q as CoercionMap$1, V as ValidationMessages, r as FormLabels } from './field-Cogi7eQc.js';
+export { s as ArrayButtonSlots, t as FieldCondition, u as FieldMeta, v as FieldOverride, w as FieldType, x as FormWrapperProps, L as LayoutSlots, y as ResolvedArrayButtonSlots, S as SectionConfig, z as SectionWrapperProps, B as SelectOption, E as SubmitButtonProps } from './field-Cogi7eQc.js';
 import * as z from 'zod/v4/core';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as React from 'react';
@@ -227,9 +227,13 @@ declare class UniForm<TSchema extends z.$ZodObject, TRegistered extends string =
      * Replaces any previously registered handler for that field — only one
      * handler per field is kept. This prevents accidental handler accumulation
      * when called inside a React render cycle.
+     *
+     * Supports both generic array paths (`"tasks.priority"` — fires for all rows)
+     * and indexed paths (`"tasks.0.priority"` — fires only for row 0).
+     *
      * Returns `this` for fluent chaining.
      */
-    setOnChange<K extends Exclude<DeepKeys<z.infer<TSchema>>, TRegistered>>(field: K, handler: Handler<TSchema, DeepFieldValue<z.infer<TSchema>, K>>): UniForm<TSchema, TRegistered | K>;
+    setOnChange<K extends Exclude<DeepKeysIndexed<z.infer<TSchema>>, TRegistered>>(field: K, handler: Handler<TSchema, DeepFieldValue<z.infer<TSchema>, K>>): UniForm<TSchema, TRegistered | K>;
     /**
      * Attach a typed condition for a specific field.
      * The field is shown when the predicate returns `true`, hidden when `false`.
@@ -376,6 +380,7 @@ type AutoFormContextValue = {
     labels: FormLabels;
     formMethods: FormMethods;
     control: Control;
+    setDynamicMeta: React.Dispatch<React.SetStateAction<Record<string, Partial<FieldDependencyResult>>>>;
 };
 declare function useAutoFormContext(): AutoFormContextValue;
 

package/dist/index.js

@@ -738,6 +738,124 @@ function getDefaultValue(field) {
       return void 0;
   }
 }
+
+// src/utils/reindexDynamicMeta.ts
+function buildKeyPattern(arrayName) {
+  return new RegExp(`^${escapeRegExp(arrayName)}\\.(\\d+)\\.(.+)$`);
+}
+function escapeRegExp(str) {
+  return str.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+function reindexDynamicMeta(dynamicMeta, arrayName, mutation) {
+  const pattern = buildKeyPattern(arrayName);
+  const matched = [];
+  const result = {};
+  for (const [key, value] of Object.entries(dynamicMeta)) {
+    const match = pattern.exec(key);
+    if (match) {
+      matched.push({
+        key,
+        index: parseInt(match[1], 10),
+        childField: match[2],
+        value
+      });
+    } else {
+      result[key] = value;
+    }
+  }
+  if (!isValidMutation(mutation)) {
+    return dynamicMeta;
+  }
+  switch (mutation.type) {
+    case "remove":
+      applyRemove(matched, mutation.index, arrayName, result);
+      break;
+    case "move":
+      applyMove(matched, mutation.from, mutation.to, arrayName, result);
+      break;
+    case "duplicate":
+      applyDuplicate(matched, mutation.index, arrayName, result);
+      break;
+    case "add":
+      applyAdd(matched, mutation.index, arrayName, result);
+      break;
+  }
+  return result;
+}
+function isValidMutation(mutation, _entries) {
+  switch (mutation.type) {
+    case "remove":
+      return mutation.index >= 0;
+    case "move":
+      return mutation.from >= 0 && mutation.to >= 0;
+    case "duplicate":
+      return mutation.index >= 0;
+    case "add":
+      return mutation.index >= 0;
+  }
+}
+function buildKey(arrayName, index, childField) {
+  return `${arrayName}.${index}.${childField}`;
+}
+function applyRemove(entries, removedIndex, arrayName, result) {
+  for (const entry of entries) {
+    if (entry.index === removedIndex) {
+      continue;
+    } else if (entry.index > removedIndex) {
+      result[buildKey(arrayName, entry.index - 1, entry.childField)] = entry.value;
+    } else {
+      result[buildKey(arrayName, entry.index, entry.childField)] = entry.value;
+    }
+  }
+}
+function applyMove(entries, from, to, arrayName, result) {
+  if (from === to) {
+    for (const entry of entries) {
+      result[buildKey(arrayName, entry.index, entry.childField)] = entry.value;
+    }
+    return;
+  }
+  for (const entry of entries) {
+    let newIndex;
+    if (entry.index === from) {
+      newIndex = to;
+    } else if (from < to) {
+      if (entry.index > from && entry.index <= to) {
+        newIndex = entry.index - 1;
+      } else {
+        newIndex = entry.index;
+      }
+    } else {
+      if (entry.index >= to && entry.index < from) {
+        newIndex = entry.index + 1;
+      } else {
+        newIndex = entry.index;
+      }
+    }
+    result[buildKey(arrayName, newIndex, entry.childField)] = entry.value;
+  }
+}
+function applyDuplicate(entries, sourceIndex, arrayName, result) {
+  for (const entry of entries) {
+    if (entry.index === sourceIndex) {
+      result[buildKey(arrayName, entry.index, entry.childField)] = entry.value;
+      result[buildKey(arrayName, sourceIndex + 1, entry.childField)] = entry.value;
+    } else if (entry.index > sourceIndex) {
+      result[buildKey(arrayName, entry.index + 1, entry.childField)] = entry.value;
+    } else {
+      result[buildKey(arrayName, entry.index, entry.childField)] = entry.value;
+    }
+  }
+}
+function applyAdd(entries, newIndex, arrayName, result) {
+  for (const entry of entries) {
+    if (entry.index >= newIndex) {
+      result[buildKey(arrayName, entry.index + 1, entry.childField)] = entry.value;
+    } else {
+      result[buildKey(arrayName, entry.index, entry.childField)] = entry.value;
+    }
+  }
+}
 function getRowSummary(row, itemConfig, index, itemSummary) {
   if (itemConfig.type === "object") {
     for (const child of itemConfig.children) {
@@ -750,8 +868,43 @@ function getRowSummary(row, itemConfig, index, itemSummary) {
   }
   return itemSummary?.(index) ?? `Item ${index + 1}`;
 }
+function bindRowIndexToItemConfig(itemConfig, rowIndex) {
+  if (itemConfig.type !== "object") return itemConfig;
+  const children = itemConfig.children.map((child) => {
+    if (!child.meta.onChange) return child;
+    const originalOnChange = child.meta.onChange;
+    return {
+      ...child,
+      meta: {
+        ...child.meta,
+        onChange: (value, formMethods) => {
+          void originalOnChange(value, formMethods, rowIndex);
+        }
+      }
+    };
+  });
+  return { ...itemConfig, children };
+}
+function applyRowDynamicMeta(itemConfig, rowOverrides) {
+  if (itemConfig.type !== "object") return itemConfig;
+  const children = itemConfig.children.map((child) => {
+    const override = rowOverrides[child.name];
+    if (!override) return child;
+    const { options, label, ...metaOverrides } = override;
+    let updated = {
+      ...child,
+      ...label !== void 0 ? { label } : {},
+      meta: { ...child.meta, ...metaOverrides }
+    };
+    if (options !== void 0 && updated.type === "select") {
+      updated = { ...updated, options };
+    }
+    return updated;
+  });
+  return { ...itemConfig, children };
+}
 function ArrayField({ field, control, effectiveName }) {
-  const { classNames, layout, labels } = useAutoFormContext();
+  const { classNames, layout, labels, setDynamicMeta } = useAutoFormContext();
   const {
     fields: rows,
     append,
@@ -797,6 +950,7 @@ function ArrayField({ field, control, effectiveName }) {
   } = layout.arrayButtons;
   const ArrayFieldLayout = layout.arrayFieldLayout;
   const RowLayout = layout.arrayRowLayout;
+  const rowDynamicMeta = field._rowDynamicMeta;
   const renderedRows = rows.map((row, index) => {
     const isCollapsed = showCollapse && collapsed.has(index);
     const collapseButton = showCollapse && CollapseBtn ? /* @__PURE__ */ jsxRuntime.jsxs(
@@ -828,7 +982,16 @@ function ArrayField({ field, control, effectiveName }) {
       {
         type: "button",
         className: classNames.arrayMove,
-        onClick: () => move(index, index - 1),
+        onClick: () => {
+          move(index, index - 1);
+          setDynamicMeta(
+            (prev) => reindexDynamicMeta(prev, effectiveName, {
+              type: "move",
+              from: index,
+              to: index - 1
+            })
+          );
+        },
         disabled: index === 0,
         "aria-label": labels.arrayAriaMoveUp?.(index) ?? `Move item ${index + 1} up`,
         children: labels.arrayMoveUp ?? "\u2191"
@@ -839,7 +1002,16 @@ function ArrayField({ field, control, effectiveName }) {
       {
         type: "button",
         className: classNames.arrayMove,
-        onClick: () => move(index, index + 1),
+        onClick: () => {
+          move(index, index + 1);
+          setDynamicMeta(
+            (prev) => reindexDynamicMeta(prev, effectiveName, {
+              type: "move",
+              from: index,
+              to: index + 1
+            })
+          );
+        },
         disabled: index === rows.length - 1,
         "aria-label": labels.arrayAriaMoveDown?.(index) ?? `Move item ${index + 1} down`,
         children: labels.arrayMoveDown ?? "\u2193"
@@ -855,6 +1027,12 @@ function ArrayField({ field, control, effectiveName }) {
             Object.entries(row).filter(([k]) => k !== "id")
           );
           insert(index + 1, values);
+          setDynamicMeta(
+            (prev) => reindexDynamicMeta(prev, effectiveName, {
+              type: "duplicate",
+              index
+            })
+          );
         },
         "aria-label": labels.arrayAriaDuplicate?.(index) ?? `Duplicate item ${index + 1}`,
         children: labels.arrayDuplicate ?? "Duplicate"
@@ -865,7 +1043,15 @@ function ArrayField({ field, control, effectiveName }) {
       {
         type: "button",
         className: classNames.arrayRemove,
-        onClick: () => remove(index),
+        onClick: () => {
+          remove(index);
+          setDynamicMeta(
+            (prev) => reindexDynamicMeta(prev, effectiveName, {
+              type: "remove",
+              index
+            })
+          );
+        },
         disabled: atMin,
         "aria-label": labels.arrayAriaRemove?.(index) ?? `Remove item ${index + 1}`,
         children: labels.arrayRemove ?? "Remove"
@@ -874,7 +1060,10 @@ function ArrayField({ field, control, effectiveName }) {
     const fieldContent = !isCollapsed ? /* @__PURE__ */ jsxRuntime.jsx(
       FieldRenderer,
       {
-        field: effectiveItemConfig,
+        field: bindRowIndexToItemConfig(
+          rowDynamicMeta?.[index] ? applyRowDynamicMeta(effectiveItemConfig, rowDynamicMeta[index]) : effectiveItemConfig,
+          index
+        ),
         control,
         namePrefix: `${effectiveName}.${index}`
       }
@@ -902,7 +1091,16 @@ function ArrayField({ field, control, effectiveName }) {
       type: "button",
       className: classNames.arrayAdd,
       disabled: atMax,
-      onClick: () => append(getDefaultValue(itemConfig)),
+      onClick: () => {
+        const newIndex = rows.length;
+        append(getDefaultValue(itemConfig));
+        setDynamicMeta(
+          (prev) => reindexDynamicMeta(prev, effectiveName, {
+            type: "add",
+            index: newIndex
+          })
+        );
+      },
       children: labels.arrayAdd ?? "Add"
     }
   ) : null;
@@ -1155,6 +1353,28 @@ function useLatestRef(value) {
   return ref;
 }
 
+// src/utils/createRowScopedContext.ts
+function createRowScopedContext(baseCtx, arrayName, rowIndex, itemFieldNames, getValues) {
+  return {
+    ...baseCtx,
+    getValues,
+    setFieldMeta: (field, meta) => {
+      const fieldStr = field;
+      const prefix = arrayName + ".";
+      const childName = fieldStr.startsWith(prefix) ? fieldStr.slice(prefix.length) : fieldStr;
+      if (itemFieldNames.has(childName)) {
+        const qualifiedKey = `${arrayName}.${rowIndex}.${childName}`;
+        baseCtx.setFieldMeta(
+          qualifiedKey,
+          meta
+        );
+      } else {
+        baseCtx.setFieldMeta(field, meta);
+      }
+    }
+  };
+}
+
 // src/utils/fieldPipeline.ts
 function applyFieldOverrides(fields, overrides) {
   return fields.map((field) => {
@@ -1215,10 +1435,74 @@ function injectOnChangeHandlers(fields, uniForm, ctx, handlerKeys = new Set(uniF
     } else if (updated.type === "array") {
       const prefix = field.name + ".";
       const itemKeys = /* @__PURE__ */ new Set();
+      const indexedKeys = /* @__PURE__ */ new Set();
       for (const key of handlerKeys) {
-        if (key.startsWith(prefix)) itemKeys.add(key.slice(prefix.length));
+        if (key.startsWith(prefix)) {
+          const remainder = key.slice(prefix.length);
+          const indexMatch = remainder.match(/^(\d+)\.(.+)$/);
+          if (indexMatch) {
+            indexedKeys.add(remainder);
+            itemKeys.add(indexMatch[2]);
+          } else {
+            itemKeys.add(remainder);
+          }
+        }
       }
-      if (itemKeys.size) {
+      if (itemKeys.size && updated.itemConfig.type === "object") {
+        const itemFieldNames = new Set(
+          updated.itemConfig.children.map((c) => c.name)
+        );
+        const arrayName = field.name;
+        const newChildren = updated.itemConfig.children.map((child) => {
+          if (!itemKeys.has(child.name)) return child;
+          const existingOnChange = child.meta.onChange;
+          const rowAwareHandler = (value, formMethods, rowIndex) => {
+            void existingOnChange?.(value, formMethods);
+            const rowCtx = createRowScopedContext(
+              ctx,
+              arrayName,
+              rowIndex,
+              itemFieldNames,
+              () => {
+                const allValues = ctx.getValues();
+                const arrayValues = allValues?.[arrayName];
+                if (Array.isArray(arrayValues)) {
+                  return arrayValues[rowIndex] ?? {};
+                }
+                return {};
+              }
+            );
+            void uniForm._fireHandler(
+              `${arrayName}.${child.name}`,
+              value,
+              rowCtx
+            );
+            const indexedKey = `${rowIndex}.${child.name}`;
+            if (indexedKeys.has(indexedKey)) {
+              void uniForm._fireHandler(
+                `${arrayName}.${indexedKey}`,
+                value,
+                rowCtx
+              );
+            }
+          };
+          return {
+            ...child,
+            meta: {
+              ...child.meta,
+              // Cast to FieldMeta onChange type — ArrayField's bindRowIndexToItemConfig
+              // will call this with the rowIndex third argument at render time.
+              onChange: rowAwareHandler
+            }
+          };
+        });
+        const newItemConfig = {
+          ...updated.itemConfig,
+          children: newChildren
+        };
+        if (newItemConfig !== updated.itemConfig)
+          updated = { ...updated, itemConfig: newItemConfig };
+      } else if (itemKeys.size) {
         const remappedUniForm = {
           _getWatchedFields: () => Array.from(itemKeys),
           _fireHandlers: (name, value, c) => uniForm._fireHandler(`${field.name}.${name}`, value, c)
@@ -1264,18 +1548,43 @@ function injectConditions(fields, conditions) {
     return updated;
   });
 }
+var ROW_KEY_PATTERN = /^(.+?)\.(\d+)\.(.+)$/;
 function applyDynamicMeta(fields, overrides) {
   if (!Object.keys(overrides).length) return fields;
   return fields.map((field) => {
     const override = overrides[field.name];
-    if (!override) return field;
-    const { options, label, ...metaOverrides } = override;
-    return {
-      ...field,
-      ...label !== void 0 ? { label } : {},
-      ...options !== void 0 ? { options } : {},
-      meta: { ...field.meta, ...metaOverrides }
-    };
+    let updated = field;
+    if (override) {
+      const { options, label, ...metaOverrides } = override;
+      updated = {
+        ...field,
+        ...label !== void 0 ? { label } : {},
+        ...options !== void 0 ? { options } : {},
+        meta: { ...field.meta, ...metaOverrides }
+      };
+    }
+    if (updated.type === "array") {
+      const prefix = `${updated.name}.`;
+      let rowDynamicMeta;
+      for (const [key, value] of Object.entries(overrides)) {
+        if (!key.startsWith(prefix)) continue;
+        const match = ROW_KEY_PATTERN.exec(key);
+        if (!match) continue;
+        const [, matchedArrayName, indexStr, childField] = match;
+        if (matchedArrayName !== updated.name) continue;
+        const rowIndex = Number(indexStr);
+        if (!rowDynamicMeta) rowDynamicMeta = {};
+        if (!rowDynamicMeta[rowIndex]) rowDynamicMeta[rowIndex] = {};
+        rowDynamicMeta[rowIndex][childField] = value;
+      }
+      if (rowDynamicMeta) {
+        updated = {
+          ...updated,
+          _rowDynamicMeta: rowDynamicMeta
+        };
+      }
+    }
+    return updated;
   });
 }
 function buildDefaults(fields) {
@@ -1593,7 +1902,8 @@ function AutoForm(props) {
       messages,
       labels,
       formMethods,
-      control
+      control,
+      setDynamicMeta
     }),
     [
       registry,
@@ -1607,7 +1917,8 @@ function AutoForm(props) {
       messages,
       labels,
       formMethods,
-      control
+      control,
+      setDynamicMeta
     ]
   );
   if (isLoadingDefaults) {
@@ -1724,6 +2035,10 @@ var UniForm = class {
    * Replaces any previously registered handler for that field — only one
    * handler per field is kept. This prevents accidental handler accumulation
    * when called inside a React render cycle.
+   *
+   * Supports both generic array paths (`"tasks.priority"` — fires for all rows)
+   * and indexed paths (`"tasks.0.priority"` — fires only for row 0).
+   *
    * Returns `this` for fluent chaining.
    */
   setOnChange(field, handler) {