attaform 0.21.2 → 0.22.0

package/dist/shared/{attaform.D2ZuIOCf.cjs → attaform.CjMcwV7W.cjs}

@@ -1,7 +1,7 @@
 'use strict';
 
 const vue = require('vue');
-const paths = require('./attaform.B5LNzqQh.cjs');
+const paths = require('./attaform.01iKS_lz.cjs');
 
 function safeAssign(target, key, value) {
   if (key === "__proto__") {
@@ -36,7 +36,7 @@ function descendStep(value, segment) {
   if (typeof value !== "object") return NOT_FOUND;
   if (Array.isArray(value)) {
     if (typeof segment !== "number") return NOT_FOUND;
-    if (segment < 0 || segment >= value.length) return NOT_FOUND;
+    if (!(segment in value)) return NOT_FOUND;
     return value[segment];
   }
   const record = value;
@@ -71,7 +71,7 @@ function hasAtPath(root, path) {
   if (current === null || current === void 0) return false;
   if (typeof current !== "object") return false;
   if (Array.isArray(current)) {
-    return typeof last === "number" && last >= 0 && last < current.length;
+    return typeof last === "number" && last in current;
   }
   const key = typeof last === "number" ? String(last) : last;
   if (isShadowedKey(key)) return safeOwnHas(current, key);
@@ -100,6 +100,31 @@ function setAtPathOffset(root, path, value, offset) {
   safeAssign(rec, head, setAtPathOffset(safeOwnRead(rec, head), path, value, nextOffset));
   return rec;
 }
+const NO_IN_PLACE = { applied: false };
+function tryInPlaceLeafWrite(root, path, value) {
+  if (path.length === 0) return NO_IN_PLACE;
+  let node = root;
+  for (let i = 0; i < path.length; i++) {
+    const seg = path[i];
+    if (Array.isArray(node)) {
+      if (typeof seg !== "number" || seg < 0 || seg >= node.length) return NO_IN_PLACE;
+    } else if (isPlainRecord(node)) {
+      if (typeof seg !== "string" || isShadowedKey(seg) || !(seg in node)) return NO_IN_PLACE;
+    } else {
+      return NO_IN_PLACE;
+    }
+    const container = node;
+    if (i < path.length - 1) {
+      node = container[seg];
+      continue;
+    }
+    const old = container[seg];
+    if (isPlainRecord(old) || Array.isArray(old)) return NO_IN_PLACE;
+    container[seg] = value;
+    return { applied: true, old };
+  }
+  return NO_IN_PLACE;
+}
 function deleteAtPath(root, path) {
   return deleteAtPathOffset(root, path, 0);
 }
@@ -403,7 +428,7 @@ function diffObjectsLockstep(oldRec, newRec, prefix, visit) {
     diffAndApply(oldRec[k], newRec[k], appendSegment(prefix, k), visit);
   }
 }
-function applyChangedKeys(target, source) {
+function applyChangedKeys(target, source, arrayOpPath, currentPath) {
   if (!isDescendable(target) || !isDescendable(source)) return false;
   const targetIsArray = Array.isArray(target);
   const sourceIsArray = Array.isArray(source);
@@ -421,11 +446,27 @@ function applyChangedKeys(target, source) {
   if (targetIsArray) {
     const t = target;
     const s = source;
-    if (t.length > s.length) t.length = s.length;
-    for (const idx of changedFirstSegments) {
-      if (typeof idx === "symbol") continue;
-      const i = typeof idx === "number" ? idx : Number(idx);
-      t[i] = s[i];
+    if (arrayOpPath === null || paths.pathsEqual(currentPath, arrayOpPath)) {
+      if (t.length > s.length) t.length = s.length;
+      for (const idx of changedFirstSegments) {
+        if (typeof idx === "symbol") continue;
+        const i = typeof idx === "number" ? idx : Number(idx);
+        if (i >= s.length) continue;
+        t[i] = s[i];
+      }
+    } else {
+      for (const idx of changedFirstSegments) {
+        if (typeof idx === "symbol") continue;
+        const i = typeof idx === "number" ? idx : Number(idx);
+        if (i >= s.length) continue;
+        const childPath = appendSegment(currentPath, i);
+        const curEl = t[i];
+        const nextEl = s[i];
+        if (paths.isPathPrefix(childPath, arrayOpPath) && isDescendable(curEl) && isDescendable(nextEl) && applyChangedKeys(curEl, nextEl, arrayOpPath, childPath)) {
+          continue;
+        }
+        t[i] = nextEl;
+      }
     }
   } else {
     const t = target;
@@ -437,7 +478,14 @@ function applyChangedKeys(target, source) {
     for (const k of changedFirstSegments) {
       if (typeof k === "symbol") continue;
       const key = String(k);
-      safeAssign(t, key, safeOwnRead(s, key));
+      const nextVal = safeOwnRead(s, key);
+      if (arrayOpPath !== null) {
+        const curVal = safeOwnRead(t, key);
+        if (isDescendable(curVal) && isDescendable(nextVal) && applyChangedKeys(curVal, nextVal, arrayOpPath, appendSegment(currentPath, key))) {
+          continue;
+        }
+      }
+      safeAssign(t, key, nextVal);
     }
   }
   return true;
@@ -549,6 +597,50 @@ function resolveGetDisplayState(config) {
   return config ?? defaultDisplayState;
 }
 
+const AttaformErrorCode = {
+  /** A required field is in the blank set — user hasn't supplied a value. */
+  NoValueSupplied: "atta:no-value-supplied",
+  /** The schema adapter's `validateAtPath` threw synchronously. */
+  AdapterThrew: "atta:adapter-threw",
+  /**
+   * User code inside a `z.preprocess`, `.refine`, or `.transform`
+   * threw (sync or async). The adapter caught the throw and surfaced
+   * it as a `ValidationError` at the field path so the form's normal
+   * error pipeline handles it instead of leaking as an unhandled
+   * rejection or routing through `submitError`.
+   */
+  ValidatorThrew: "atta:validator-threw",
+  /**
+   * A function-form `defaultValues` factory threw or its promise
+   * rejected. The runtime captures the raw error on `form.hydrateError`
+   * and ALSO surfaces a form-level `ValidationError` (path `[]`) so
+   * the standard error pipeline carries the signal. Critical for the
+   * SSR round-trip: `hydrateError` itself does not ride the wire
+   * payload, but `schemaErrors` does, so the client sees the failure
+   * after rehydration without an extra channel.
+   */
+  HydrationFailed: "atta:hydration-failed",
+  /** The supplied path didn't resolve to any node in the schema. */
+  PathNotFound: "atta:path-not-found",
+  /**
+   * A walked form's `activate()` (async `defaultValues` factory) threw
+   * during `wizard.handleSubmit`'s path walk. Surfaced as a synthetic
+   * `ValidationError` at the form-level path (`[]`) so the wizard's
+   * aggregate error pipeline can carry the failure alongside ordinary
+   * validation errors. The raw factory error remains on
+   * `form.hydrateError` for retry UX.
+   */
+  ActivationFailed: "atta:activation-failed"
+};
+function makeBlankRequiredError(segments, formKey) {
+  return {
+    message: "No value supplied",
+    path: [...segments],
+    formKey,
+    code: AttaformErrorCode.NoValueSupplied
+  };
+}
+
 const DEFAULT_FIELD_VALIDATION_DEBOUNCE_MS = 0;
 const DEFAULT_PERSISTENCE_DEBOUNCE_MS = 300;
 const DEFAULT_HISTORY_MAX_SNAPSHOTS = 128;
@@ -662,7 +754,7 @@ function buildLeafFieldStateBase(state, segments, key, formInstanceId) {
   const original = state.originals.get(key)?.value;
   const pristine = state.isPristineAtPath(segments);
   const schemaForKey = state.schemaErrors.get(key);
-  const blankForKey = state.derivedBlankErrors.value.get(key);
+  const blankForKey = state.blankPaths.has(key) && state.schema.isRequiredAtPath(segments) ? [makeBlankRequiredError(segments, state.formKey)] : void 0;
   const userForKey = state.userErrors.get(key);
   const errors = [];
   if (schemaForKey !== void 0) errors.push(...schemaForKey);
@@ -726,9 +818,32 @@ function buildLeafFieldState(state, segments, key, formInstanceId, getFormMetaBa
     getDisplayState
   );
 }
+function visitActiveLeafPaths(value, base, visit) {
+  if (Array.isArray(value)) {
+    for (let i = 0; i < value.length; i++) {
+      const child = value[i];
+      if (Array.isArray(child) || isPlainRecord(child)) {
+        visitActiveLeafPaths(child, [...base, i], visit);
+      } else {
+        visit([...base, i]);
+      }
+    }
+    return;
+  }
+  if (isPlainRecord(value)) {
+    for (const k of Object.keys(value)) {
+      const child = value[k];
+      if (Array.isArray(child) || isPlainRecord(child)) {
+        visitActiveLeafPaths(child, [...base, k], visit);
+      } else {
+        visit([...base, k]);
+      }
+    }
+  }
+}
 function buildContainerFieldStateBase(state, segments, key, formInstanceId) {
   const formValue = state.form.value;
-  const value = state.getValueAtPath(segments);
+  const value = getAtPath(formValue, segments);
   const original = state.originals.get(key)?.value;
   let pristine = true;
   let blank = true;
@@ -747,12 +862,16 @@ function buildContainerFieldStateBase(state, segments, key, formInstanceId) {
   let asyncPending = false;
   const submissionAttempts = state.submissionAttempts.value;
   const blurredLeafSegments = [];
-  for (const [leafKey, entry] of state.originals) {
-    if (!paths.isPathPrefix(segments, entry.segments)) continue;
-    if (segments.length === entry.segments.length) continue;
-    if (!hasAtPath(formValue, entry.segments)) continue;
+  const descendantLeaves = [];
+  visitActiveLeafPaths(value, segments, (leafSegments) => {
+    const { key: leafKey } = paths.keyForSegments(leafSegments);
+    const entry = state.originals.get(leafKey);
+    if (entry === void 0) return;
+    descendantLeaves.push({ key: leafKey, segments: entry.segments });
+  });
+  for (const { key: leafKey, segments: leafSeg } of descendantLeaves) {
     const leafRecord = state.fields.get(leafKey);
-    if (!state.isPristineAtPathByKey(leafKey, entry.segments)) {
+    if (!state.isPristineAtPathByKey(leafKey, leafSeg)) {
       pristine = false;
       dirty = true;
     }
@@ -763,7 +882,7 @@ function buildContainerFieldStateBase(state, segments, key, formInstanceId) {
     if (leafRecord?.interacted === true) interacted = true;
     if (leafRecord?.blurredAfterInteraction === true) {
       blurredAfterInteraction = true;
-      blurredLeafSegments.push(entry.segments);
+      blurredLeafSegments.push(leafSeg);
     }
     if (leafRecord?.connected === true) connected = true;
     if ((state.fieldValidationCounts.get(leafKey) ?? 0) > 0) {
@@ -780,7 +899,7 @@ function buildContainerFieldStateBase(state, segments, key, formInstanceId) {
       if (leafGateOpen && since !== void 0 && (transformingSince === null || since < transformingSince))
         transformingSince = since;
     }
-    if (state.pathHasAsyncValidationByKey(leafKey, entry.segments)) asyncPending = true;
+    if (state.pathHasAsyncValidationByKey(leafKey, leafSeg)) asyncPending = true;
     const ts = leafRecord?.updatedAt;
     if (ts !== void 0 && ts !== null) {
       if (updatedAt === null || ts > updatedAt) updatedAt = ts;
@@ -1407,7 +1526,7 @@ function buildFieldArrayApi(state) {
     append(path, value) {
       const next = readArray(path);
       next.push(value);
-      return writeArray(path, next);
+      return writeArray(path, next, { kind: "insert", index: next.length - 1 });
     },
     prepend(path, value) {
       const next = readArray(path);
@@ -1735,42 +1854,6 @@ function mergeObjectKeys(target, source, path, schema) {
   return out;
 }
 
-const AttaformErrorCode = {
-  /** A required field is in the blank set — user hasn't supplied a value. */
-  NoValueSupplied: "atta:no-value-supplied",
-  /** The schema adapter's `validateAtPath` threw synchronously. */
-  AdapterThrew: "atta:adapter-threw",
-  /**
-   * User code inside a `z.preprocess`, `.refine`, or `.transform`
-   * threw (sync or async). The adapter caught the throw and surfaced
-   * it as a `ValidationError` at the field path so the form's normal
-   * error pipeline handles it instead of leaking as an unhandled
-   * rejection or routing through `submitError`.
-   */
-  ValidatorThrew: "atta:validator-threw",
-  /**
-   * A function-form `defaultValues` factory threw or its promise
-   * rejected. The runtime captures the raw error on `form.hydrateError`
-   * and ALSO surfaces a form-level `ValidationError` (path `[]`) so
-   * the standard error pipeline carries the signal. Critical for the
-   * SSR round-trip: `hydrateError` itself does not ride the wire
-   * payload, but `schemaErrors` does, so the client sees the failure
-   * after rehydration without an extra channel.
-   */
-  HydrationFailed: "atta:hydration-failed",
-  /** The supplied path didn't resolve to any node in the schema. */
-  PathNotFound: "atta:path-not-found",
-  /**
-   * A walked form's `activate()` (async `defaultValues` factory) threw
-   * during `wizard.handleSubmit`'s path walk. Surfaced as a synthetic
-   * `ValidationError` at the form-level path (`[]`) so the wizard's
-   * aggregate error pipeline can carry the failure alongside ordinary
-   * validation errors. The raw factory error remains on
-   * `form.hydrateError` for retry UX.
-   */
-  ActivationFailed: "atta:activation-failed"
-};
-
 const warnedNoScopeStores = paths.__DEV__ ? /* @__PURE__ */ new WeakSet() : null;
 function buildProcessForm(state, formInstanceId, options = {}) {
   const invalidPolicy = options.onInvalidSubmit ?? "focus-first-error";
@@ -2796,19 +2879,116 @@ function buildFormApi(state, formInstanceId, options = {}) {
     }
   };
   const getFormMetaBase = () => {
-    const { base: rootBase } = buildContainerFieldStateBase(
+    let rollup;
+    const rootBase = () => rollup ?? (rollup = buildContainerFieldStateBase(
       state,
       paths.ROOT_PATH,
       paths.ROOT_PATH_KEY,
       formInstanceId
-    );
+    ).base);
     return {
-      ...rootBase,
+      // Rollup-derived (FieldStateBase) — the whole rollup builds once, on the
+      // first access of any of these.
+      get value() {
+        return rootBase().value;
+      },
+      get original() {
+        return rootBase().original;
+      },
+      get pristine() {
+        return rootBase().pristine;
+      },
+      get dirty() {
+        return rootBase().dirty;
+      },
+      get focused() {
+        return rootBase().focused;
+      },
+      get blurred() {
+        return rootBase().blurred;
+      },
+      get touched() {
+        return rootBase().touched;
+      },
+      get interacted() {
+        return rootBase().interacted;
+      },
+      get blurredAfterInteraction() {
+        return rootBase().blurredAfterInteraction;
+      },
+      get connected() {
+        return rootBase().connected;
+      },
+      get element() {
+        return rootBase().element;
+      },
+      get elements() {
+        return rootBase().elements;
+      },
+      get updatedAt() {
+        return rootBase().updatedAt;
+      },
+      get errors() {
+        return rootBase().errors;
+      },
+      get validating() {
+        return rootBase().validating;
+      },
+      get valid() {
+        return rootBase().valid;
+      },
+      get transforming() {
+        return rootBase().transforming;
+      },
+      get busy() {
+        return rootBase().busy;
+      },
+      get transformError() {
+        return rootBase().transformError;
+      },
+      get path() {
+        return rootBase().path;
+      },
+      get id() {
+        return rootBase().id;
+      },
+      get aria() {
+        return rootBase().aria;
+      },
+      get key() {
+        return rootBase().key;
+      },
+      get blank() {
+        return rootBase().blank;
+      },
+      get label() {
+        return rootBase().label;
+      },
+      get description() {
+        return rootBase().description;
+      },
+      get placeholder() {
+        return rootBase().placeholder;
+      },
+      get meta() {
+        return rootBase().meta;
+      },
+      get errorCount() {
+        return rootBase().errors.length;
+      },
+      // Form-level scalars — EAGER reads, tracked on every field-state eval.
+      // They are O(1) refs that never change on a keystroke, so tracking them
+      // per field costs nothing on the hot path. Kept eager (NOT lazy like the
+      // rollup) because behaviors beyond the predicate's own output depend on
+      // every field re-evaluating when they flip — most notably, the display
+      // engine is cleared on submit (revealing held spinners), and that
+      // imperative reset only becomes visible if `submitting` is a tracked dep
+      // of each field. Matches the pre-bust dependency set for these scalars
+      // exactly.
       submitting: state.submitting.value,
       submissionAttempts: state.submissionAttempts.value,
       departAttempts: state.departAttempts.value,
       submitError: state.submitError.value,
-      errorCount: rootBase.errors.length,
       submitted: state.submitted.value,
       instanceId: formInstanceId
     };
@@ -2843,14 +3023,19 @@ function buildFormApi(state, formInstanceId, options = {}) {
     const segments = paths.canonicalizePath(pathInput).segments;
     return vue.computed(() => getAtPath(state.form.value, segments));
   }
-  function setValueImpl(pathOrValue, maybeValue) {
-    if (arguments.length === 1) {
+  function setValueImpl(pathOrValue, maybeValue, maybeOptions) {
+    const argc = arguments.length;
+    const isPathForm = argc >= 2 && (typeof pathOrValue === "string" || Array.isArray(pathOrValue));
+    const options2 = isPathForm ? maybeOptions : argc >= 2 ? maybeValue : void 0;
+    const silent = options2?.silent === true;
+    const writeMeta = (extra) => withInstanceMeta(silent ? { ...extra, silent: true } : extra);
+    if (!isPathForm) {
       const next = typeof pathOrValue === "function" ? pathOrValue(structuralSnapshot(state.form.value)) : pathOrValue;
       const walked2 = walkUnsetSentinels(
         next,
         state.schema
       );
-      const ok2 = state.setValueAtPath([], walked2.cleanedValues, withInstanceMeta());
+      const ok2 = state.setValueAtPath([], walked2.cleanedValues, writeMeta());
       if (!ok2) return false;
       reMarkBlanksAfterSubstitution(walked2.paths);
       return true;
@@ -2864,7 +3049,7 @@ function buildFormApi(state, formInstanceId, options = {}) {
         if (parentDU?.discriminatorKey === last) {
           const slimDefault = state.schema.getEmptyValueAtPath(segments);
           const blank = blankForKind(slimDefault);
-          return state.setValueAtPath(segments, blank, withInstanceMeta({ blank: true }));
+          return state.setValueAtPath(segments, blank, writeMeta({ blank: true }));
         }
       }
       const blankPaths = [];
@@ -2875,9 +3060,9 @@ function buildFormApi(state, formInstanceId, options = {}) {
       );
       const segmentsKey = paths.canonicalizePath(segments).key;
       if (blankPaths.length === 1 && blankPaths[0] === segmentsKey) {
-        return state.setValueAtPath(segments, expanded, withInstanceMeta({ blank: true }));
+        return state.setValueAtPath(segments, expanded, writeMeta({ blank: true }));
       }
-      const ok2 = state.setValueAtPath(segments, expanded, withInstanceMeta());
+      const ok2 = state.setValueAtPath(segments, expanded, writeMeta());
       if (!ok2) return false;
       for (const pathKey of blankPaths) {
         const blankSegments = paths.segmentsForPathKey(pathKey);
@@ -2885,7 +3070,7 @@ function buildFormApi(state, formInstanceId, options = {}) {
         state.setValueAtPath(
           blankSegments,
           state.getValueAtPath(blankSegments),
-          withInstanceMeta({ blank: true })
+          writeMeta({ blank: true })
         );
       }
       return true;
@@ -2905,7 +3090,7 @@ function buildFormApi(state, formInstanceId, options = {}) {
       segments,
       state.schema
     );
-    const ok = state.setValueAtPath(segments, walked.cleanedValues, withInstanceMeta());
+    const ok = state.setValueAtPath(segments, walked.cleanedValues, writeMeta());
     if (!ok) return false;
     reMarkBlanksAfterSubstitution(walked.paths);
     return true;
@@ -3276,7 +3461,19 @@ function buildFormApi(state, formInstanceId, options = {}) {
     }
     return Object.freeze(out);
   }
-  return {
+  const formHandle = {
+    current: void 0
+  };
+  function onChangeImpl(a, b, c) {
+    const sourced = typeof b === "function";
+    const source = sourced ? a : void 0;
+    const handler = sourced ? b : a;
+    const options2 = sourced ? c : b;
+    const stop = state.registerOnChange(source, handler, options2, () => formHandle.current);
+    if (vue.getCurrentScope() !== void 0) vue.onScopeDispose(stop);
+    return stop;
+  }
+  const api = {
     handleSubmit: gated(handleSubmit),
     // Callable readonly Proxies (`values`, `fields`, `errors`) and the
     // reactive containers (`meta`, `history`, `blankPaths`) are exposed
@@ -3363,8 +3560,11 @@ function buildFormApi(state, formInstanceId, options = {}) {
     get blankPaths() {
       void state.activate();
       return blankPathsView;
-    }
+    },
+    onChange: onChangeImpl
   };
+  formHandle.current = api;
+  return api;
 }
 
 const IDLE = Object.freeze({ display: "idle" });
@@ -3791,6 +3991,7 @@ function createArrayBookkeeping(deps) {
     originals,
     blankPaths,
     originalBlankPaths,
+    authoredPaths,
     fieldValidationCounts,
     fieldValidatingSince,
     fieldValidationState,
@@ -3818,6 +4019,7 @@ function createArrayBookkeeping(deps) {
     }));
     migrateSetSubtree(blankPaths, arrayPath, remap);
     migrateSetSubtree(originalBlankPaths, arrayPath, remap);
+    migrateSetSubtree(authoredPaths, arrayPath, remap);
     migrateMapSubtree(fieldValidatingSince, arrayPath, remap, (since) => since);
     migrateMapSubtree(fieldValidationCounts, arrayPath, remap, (count) => count);
     arrayIdentity.applyRemap(arrayPath, remap);
@@ -3861,7 +4063,7 @@ function createArrayBookkeeping(deps) {
         activeValidations.value = Math.max(0, activeValidations.value - 1);
         decFieldValidation(key);
       }
-      entry.controller.abort();
+      entry.aborted = true;
       fieldValidationState.delete(key);
     }
   }
@@ -3873,6 +4075,170 @@ function createArrayBookkeeping(deps) {
   };
 }
 
+const NOOP_STOP = () => {
+};
+function isThenable(value) {
+  return value !== null && (typeof value === "object" || typeof value === "function") && typeof value.then === "function";
+}
+function isSuppressed(meta) {
+  return meta?.hydration === true || meta?.crossTab === true || meta?.silent === true;
+}
+function canonicalizeSourceList(raw) {
+  const list = typeof raw === "string" ? [raw] : raw;
+  const out = [];
+  const seen = /* @__PURE__ */ new Set();
+  for (const entry of list) {
+    const { segments, key } = paths.canonicalizePath(entry);
+    if (seen.has(key)) continue;
+    seen.add(key);
+    out.push({ segments, key, dotted: paths.segmentsToDotted(segments) });
+  }
+  return out;
+}
+function makeResolver(source) {
+  if (source === void 0) {
+    const root = [{ segments: paths.ROOT_PATH, key: paths.ROOT_PATH_KEY, dotted: "" }];
+    return () => root;
+  }
+  if (typeof source !== "function" && !vue.isRef(source)) {
+    const fixed = canonicalizeSourceList(source);
+    return () => fixed;
+  }
+  return () => canonicalizeSourceList(vue.toValue(source));
+}
+function createOnChangeRegistry(deps) {
+  const handlers = /* @__PURE__ */ new Set();
+  function isCurrent(reg, key, token) {
+    return reg.runs.get(key)?.token === token;
+  }
+  function routeError(reg, error, source, changed, value, previous, attempt, token) {
+    if (reg.onError === void 0) {
+      if (paths.__DEV__) {
+        console.error(
+          `[attaform] onChange handler threw for path '${source.dotted}' \u2014 error swallowed. Pass { onError } to handle it. Original error:`,
+          error
+        );
+      }
+      return;
+    }
+    const retry = () => {
+      if (!isCurrent(reg, source.key, token)) return;
+      runHandler(reg, source, changed, value, previous, attempt + 1);
+    };
+    const errCtx = {
+      path: source.dotted,
+      value,
+      attempt,
+      retry,
+      form: reg.getForm()
+    };
+    try {
+      reg.onError(error, errCtx);
+    } catch (err) {
+      if (paths.__DEV__) console.error("[attaform] onChange onError threw:", err);
+    }
+  }
+  function runHandler(reg, source, changed, value, previous, attempt) {
+    const prior = reg.runs.get(source.key);
+    if (prior) prior.controller.abort();
+    const controller = new AbortController();
+    const token = ++reg.seq;
+    reg.runs.set(source.key, { token, controller });
+    const ctx = {
+      path: source.dotted,
+      previous,
+      signal: controller.signal,
+      attempt,
+      form: reg.getForm(),
+      changed
+    };
+    let result;
+    try {
+      result = reg.handler(value, ctx);
+    } catch (error) {
+      routeError(reg, error, source, changed, value, previous, attempt, token);
+      return;
+    }
+    if (isThenable(result)) {
+      result.then(void 0, (error) => {
+        if (isCurrent(reg, source.key, token)) {
+          routeError(reg, error, source, changed, value, previous, attempt, token);
+        }
+      });
+    }
+  }
+  function dispatch(patches, meta) {
+    if (handlers.size === 0 || isSuppressed(meta)) return;
+    for (const reg of handlers) {
+      let sources;
+      try {
+        sources = reg.resolve();
+      } catch (error) {
+        if (paths.__DEV__) console.error("[attaform] onChange source getter threw:", error);
+        continue;
+      }
+      for (const source of sources) {
+        let changed;
+        for (const patch of patches) {
+          if (paths.isPathPrefix(source.segments, patch.path) || paths.isPathPrefix(patch.path, source.segments)) {
+            (changed ?? (changed = [])).push(paths.segmentsToDotted(patch.path));
+          }
+        }
+        if (changed === void 0) continue;
+        const value = deps.getValueAtPath(source.segments);
+        const previous = reg.previous.has(source.key) ? reg.previous.get(source.key) : value;
+        reg.previous.set(source.key, value);
+        runHandler(reg, source, changed, value, previous, 0);
+      }
+    }
+  }
+  function register(source, handler, options, getForm) {
+    if (deps.ssr) return NOOP_STOP;
+    const reg = {
+      handler,
+      onError: options?.onError,
+      getForm,
+      resolve: makeResolver(source),
+      previous: /* @__PURE__ */ new Map(),
+      runs: /* @__PURE__ */ new Map(),
+      seq: 0
+    };
+    try {
+      for (const { key, segments } of reg.resolve()) {
+        reg.previous.set(key, deps.getValueAtPath(segments));
+      }
+    } catch (error) {
+      if (paths.__DEV__) console.error("[attaform] onChange source getter threw at registration:", error);
+    }
+    handlers.add(reg);
+    let stopped = false;
+    return () => {
+      if (stopped) return;
+      stopped = true;
+      handlers.delete(reg);
+      for (const run of reg.runs.values()) run.controller.abort();
+      reg.runs.clear();
+      reg.previous.clear();
+    };
+  }
+  function dispose() {
+    for (const reg of handlers) {
+      for (const run of reg.runs.values()) run.controller.abort();
+      reg.runs.clear();
+      reg.previous.clear();
+    }
+    handlers.clear();
+  }
+  return {
+    get active() {
+      return handlers.size > 0;
+    },
+    register,
+    dispatch,
+    dispose
+  };
+}
+
 function isHydratedFieldRecord(value) {
   if (typeof value !== "object" || value === null) return false;
   const r = value;
@@ -3957,6 +4323,17 @@ function walkAuthoredFromConstraints(value, prefix, out) {
     }
   }
 }
+function freshElementIndices(op) {
+  switch (op.kind) {
+    case "insert":
+    case "replace-at":
+      return [op.index];
+    case "remove":
+    case "swap":
+    case "move":
+      return [];
+  }
+}
 function walkAuthoredFromSchemaDiff(withDefaults, withoutDefaults, prefix, out) {
   if (isPlainRecord(withDefaults) && isPlainRecord(withoutDefaults)) {
     const left = withDefaults;
@@ -3995,6 +4372,7 @@ function createFormStore(options) {
   const formChangeListeners = /* @__PURE__ */ new Set();
   const submitSuccessListeners = /* @__PURE__ */ new Set();
   const resetListeners = /* @__PURE__ */ new Set();
+  const onChangeRegistry = createOnChangeRegistry({ getValueAtPath, ssr });
   const persistOptIns = paths.createPersistOptInRegistry();
   const noSyncPaths = /* @__PURE__ */ new Set();
   const noSyncPathCounts = /* @__PURE__ */ new Map();
@@ -4033,11 +4411,8 @@ function createFormStore(options) {
     if (constraints !== void 0) {
       walkAuthoredFromConstraints(constraints, [], authoredPaths);
     }
-    const slimResponse = schema.getDefaultValues({
-      useDefaultSchemaValues: false,
-      strict
-    });
-    walkAuthoredFromSchemaDiff(schemaWithDefaultsData, slimResponse.data, [], authoredPaths);
+    const slimBaseline = schema.getEmptyValueAtPath([]);
+    walkAuthoredFromSchemaDiff(schemaWithDefaultsData, slimBaseline, [], authoredPaths);
   }
   rebuildAuthoredPaths(defaultValues, schemaInitialData);
   function filterAuthoredErrors(errors) {
@@ -4056,7 +4431,7 @@ function createFormStore(options) {
   });
   const form = vue.ref(stubbedInitialData);
   const arrayIdentity = createArrayIdentity((arraySegs) => {
-    const v = getAtPath(form.value, arraySegs);
+    const v = getAtPath(vue.toRaw(form.value), arraySegs);
     return Array.isArray(v) ? v.length : 0;
   });
   function arrayElementKey(path) {
@@ -4099,14 +4474,7 @@ function createFormStore(options) {
       const segments = paths.segmentsForPathKey(pathKey);
       if (segments === null) continue;
       if (!schema.isRequiredAtPath(segments)) continue;
-      result.set(pathKey, [
-        {
-          message: "No value supplied",
-          path: [...segments],
-          formKey,
-          code: AttaformErrorCode.NoValueSupplied
-        }
-      ]);
+      result.set(pathKey, [makeBlankRequiredError(segments, formKey)]);
     }
     return result;
   });
@@ -4346,6 +4714,7 @@ function createFormStore(options) {
     originals,
     blankPaths,
     originalBlankPaths,
+    authoredPaths,
     fieldValidationCounts,
     fieldValidatingSince,
     fieldValidationState,
@@ -4355,17 +4724,8 @@ function createFormStore(options) {
     touchFieldRecord,
     decFieldValidation
   });
-  function applyFormReplacement(next, meta) {
-    const prev = form.value;
-    if (Object.is(prev, next)) return;
+  function commitWritePatches(patches, meta) {
     const now = (/* @__PURE__ */ new Date()).toISOString();
-    const patches = [];
-    diffAndApply(prev, next, [], (patch) => {
-      patches.push(patch);
-    });
-    if (!applyChangedKeys(prev, next)) {
-      form.value = next;
-    }
     for (const patch of patches) {
       const { key } = paths.canonicalizePath(patch.path);
       if (patch.kind === "added" && !originals.has(key)) {
@@ -4380,10 +4740,63 @@ function createFormStore(options) {
         console.error("[attaform] onFormChange threw:", err);
       }
     }
+    if (onChangeRegistry.active) onChangeRegistry.dispatch(patches, meta);
+  }
+  function applyFormReplacementWithPath(next, meta, arrayOpPath) {
+    const prev = form.value;
+    if (Object.is(prev, next)) return;
+    const patches = [];
+    diffAndApply(prev, next, [], (patch) => {
+      patches.push(patch);
+    });
+    if (!applyChangedKeys(prev, next, arrayOpPath, [])) {
+      form.value = next;
+    } else if (patches.some(
+      (p) => p.path.length > 0 && typeof p.path[0] === "string" && isShadowedKey(p.path[0])
+    )) {
+      vue.triggerRef(form);
+    }
+    commitWritePatches(patches, meta);
+  }
+  function applyFormReplacement(next, meta) {
+    applyFormReplacementWithPath(next, meta, null);
+  }
+  function applyTargetedWrite(path, completedValue, meta) {
+    const result = tryInPlaceLeafWrite(form.value, path, completedValue);
+    if (!result.applied) {
+      applyFormReplacementWithPath(
+        setAtPathWithSchemaFill(form.value, schema, path, completedValue),
+        meta,
+        meta?.arrayOp !== void 0 ? path : null
+      );
+      return;
+    }
+    const patches = [];
+    diffAndApply(result.old, completedValue, path, (patch) => {
+      patches.push(patch);
+    });
+    commitWritePatches(patches, meta);
   }
   function setValueAtPath(path, value, meta) {
-    value = stripSymbolsDeep(value);
-    if (!isSlimPrimitiveValid(schema, form, path, value)) {
+    if (meta?.arrayOp !== void 0 && Array.isArray(value)) {
+      for (const idx of freshElementIndices(meta.arrayOp)) {
+        value[idx] = stripSymbolsDeep(value[idx]);
+      }
+    } else {
+      value = stripSymbolsDeep(value);
+    }
+    let slimOk = true;
+    if (meta?.arrayOp !== void 0 && Array.isArray(value)) {
+      for (const idx of freshElementIndices(meta.arrayOp)) {
+        if (!isSlimPrimitiveValid(schema, form, [...path, idx], value[idx])) {
+          slimOk = false;
+          break;
+        }
+      }
+    } else {
+      slimOk = isSlimPrimitiveValid(schema, form, path, value);
+    }
+    if (!slimOk) {
       return false;
     }
     if (path.length >= 2) {
@@ -4476,22 +4889,37 @@ function createFormStore(options) {
         }
       }
     }
+    const currentValue = getAtPath(form.value, path);
     const pathKey = paths.canonicalizePath(path).key;
     if (meta?.blank === true) {
       blankPaths.add(pathKey);
     } else {
       if (blankPaths.has(pathKey)) blankPaths.delete(pathKey);
-      if (meta?.arrayOp === void 0) {
+      if (meta?.arrayOp === void 0 && (isPlainRecord(currentValue) || Array.isArray(currentValue))) {
         for (const existingKey of [...blankPaths]) {
           if (isPathKeyUnder(existingKey, path)) blankPaths.delete(existingKey);
         }
       }
     }
     const wasAuthoredBefore = authoredPaths.has(pathKey);
-    walkAuthoredFromConstraints(value, path, authoredPaths);
+    if (meta?.arrayOp !== void 0 && Array.isArray(value)) {
+      if (path.length > 0) authoredPaths.add(pathKey);
+      for (const idx of freshElementIndices(meta.arrayOp)) {
+        walkAuthoredFromConstraints(value[idx], [...path, idx], authoredPaths);
+      }
+    } else {
+      walkAuthoredFromConstraints(value, path, authoredPaths);
+    }
     const newlyAuthored = !wasAuthoredBefore && authoredPaths.has(pathKey);
-    const completedValue = mergeStructural(schema, path, value);
-    const currentValue = getAtPath(form.value, path);
+    let completedValue;
+    if (meta?.arrayOp !== void 0 && Array.isArray(value)) {
+      for (const idx of freshElementIndices(meta.arrayOp)) {
+        value[idx] = mergeStructural(schema, [...path, idx], value[idx]);
+      }
+      completedValue = value;
+    } else {
+      completedValue = mergeStructural(schema, path, value);
+    }
     if (Object.is(currentValue, completedValue)) {
       if (newlyAuthored && schema.isPreprocessOrCoerceLeaf(path)) {
         const modeForAuthoringTransition = meta?.instance?.validateOn ?? fieldValidationMode;
@@ -4505,8 +4933,7 @@ function createFormStore(options) {
       return true;
     }
     const oldArrayLength = Array.isArray(currentValue) ? currentValue.length : 0;
-    const nextForm = setAtPathWithSchemaFill(form.value, schema, path, completedValue);
-    applyFormReplacement(nextForm, meta);
+    applyTargetedWrite(path, completedValue, meta);
     if (meta?.arrayOp !== void 0) {
       const remap = remapForOp(meta.arrayOp, oldArrayLength);
       arrayBookkeeping.migrateElementState(path, remap);
@@ -4589,7 +5016,7 @@ function createFormStore(options) {
         const prevValidation = fieldValidationState.get(parentKey2);
         if (prevValidation !== void 0) {
           if (prevValidation.timer !== null) clearTimeout(prevValidation.timer);
-          prevValidation.controller.abort();
+          prevValidation.aborted = true;
           fieldValidationState.delete(parentKey2);
         }
         appliedSync = true;
@@ -4613,15 +5040,19 @@ function createFormStore(options) {
     const prev = fieldValidationState.get(key);
     if (prev !== void 0) {
       if (prev.timer !== null) clearTimeout(prev.timer);
-      prev.controller.abort();
+      prev.aborted = true;
     }
-    const controller = new AbortController();
-    const fresh = { controller, timer: null, settled: false, released: false };
+    const fresh = {
+      aborted: false,
+      timer: null,
+      settled: false,
+      released: false
+    };
     fieldValidationState.set(key, fresh);
     const myEpoch = ++scheduleEpoch;
     const run = () => {
       fresh.timer = null;
-      if (controller.signal.aborted) return;
+      if (fresh.aborted) return;
       let activeIncremented = false;
       try {
         activeValidations.value += 1;
@@ -4638,7 +5069,7 @@ function createFormStore(options) {
       const dataAtScope = subtreeScope ? getAtPath(form.value, path) : form.value;
       const scopeKey = subtreeScope ? paths.canonicalizePath(path).key : paths.ROOT_PATH_KEY;
       void Promise.resolve().then(() => schema.validateAtPath(dataAtScope, scopePath)).then((response) => {
-        if (controller.signal.aborted) return;
+        if (fresh.aborted) return;
         if (myEpoch <= lastCommittedEpoch) return;
         lastCommittedEpoch = myEpoch;
         if (effectiveMode === "blur") {
@@ -4675,7 +5106,7 @@ function createFormStore(options) {
         activeValidations.value = Math.max(0, activeValidations.value - 1);
         decFieldValidation(pkey);
       }
-      entry.controller.abort();
+      entry.aborted = true;
     }
     fieldValidationState.clear();
   }
@@ -4691,7 +5122,7 @@ function createFormStore(options) {
         decFieldValidation(key);
         entry.released = true;
       }
-      entry.controller.abort();
+      entry.aborted = true;
       fieldValidationState.delete(key);
     }
   }
@@ -4750,6 +5181,7 @@ function createFormStore(options) {
     formChangeListeners.clear();
     submitSuccessListeners.clear();
     resetListeners.clear();
+    onChangeRegistry.dispose();
     persistOptIns.clear();
     noSyncPaths.clear();
     noSyncPathCounts.clear();
@@ -5055,7 +5487,7 @@ function createFormStore(options) {
     });
     const next = resetResponse.data;
     rebuildAuthoredPaths(resetSource, next);
-    applyFormReplacement(next);
+    applyFormReplacement(next, { silent: true });
     arrayIdentity.rebaselineAll();
     originals.clear();
     diffAndApply({}, next, [], (patch) => {
@@ -5301,6 +5733,7 @@ function createFormStore(options) {
     settleTransforms,
     scheduleFieldValidation,
     onFormChange,
+    registerOnChange: onChangeRegistry.register,
     onSubmitSuccess,
     onReset,
     emitSubmitSuccess,
@@ -5330,19 +5763,12 @@ function captureErrorEntries(map) {
   for (const [k, v] of map) out.push([k, [...v]]);
   return out;
 }
-function pathsEqual(a, b) {
-  if (a.length !== b.length) return false;
-  for (let j = 0; j < a.length; j++) {
-    if (a[j] !== b[j]) return false;
-  }
-  return true;
-}
 function errorFieldsEqual(av, bvi) {
   if (av === bvi) return true;
   if (av.message !== bvi.message) return false;
   if (av.code !== bvi.code) return false;
   if (av.formKey !== bvi.formKey) return false;
-  return av.path === bvi.path || pathsEqual(av.path, bvi.path);
+  return av.path === bvi.path || paths.pathsEqual(av.path, bvi.path);
 }
 function errorsEqual(a, b) {
   if (a.length !== b.length) return false;
@@ -5721,11 +6147,16 @@ function useAbstractForm(configuration, options) {
   if (merged.autoAria !== void 0) {
     apiOptions.autoAria = merged.autoAria;
   }
-  return buildFormApi(
-    state,
-    formInstanceId,
-    apiOptions
-  );
+  const api = buildFormApi(state, formInstanceId, apiOptions);
+  const onChangeConfig = configuration.onChange;
+  if (onChangeConfig !== void 0) {
+    const handler = typeof onChangeConfig === "function" ? onChangeConfig : onChangeConfig.handler;
+    const onError = typeof onChangeConfig === "function" ? void 0 : onChangeConfig.onError;
+    const options2 = onError === void 0 ? void 0 : { onError };
+    const stop = state.registerOnChange(void 0, handler, options2, () => api);
+    if (vue.getCurrentScope() !== void 0) vue.onScopeDispose(stop);
+  }
+  return api;
 }
 function mergeWithDefaults(defaults, configuration) {
   const strict = configuration.strict ?? defaults.strict;
@@ -7123,4 +7554,4 @@ exports.unset = unset;
 exports.useAbstractForm = useAbstractForm;
 exports.useRegister = useRegister;
 exports.useWizard = useWizard;
-//# sourceMappingURL=attaform.D2ZuIOCf.cjs.map
+//# sourceMappingURL=attaform.CjMcwV7W.cjs.map