attaform 0.20.2 → 0.21.1

package/dist/shared/{attaform.tiWEVznj.mjs → attaform.DR6RmxWZ.mjs}

@@ -1,5 +1,5 @@
-import { computed, ref, watchEffect, getCurrentScope, onScopeDispose, shallowReadonly, readonly, reactive, toRaw, watch, markRaw, shallowRef, getCurrentInstance, onServerPrefetch, provide, useId, inject, effectScope, nextTick } from 'vue';
-import { _ as __DEV__, j as canonicalizePath, G as segmentsForPathKey, t as isPathPrefix, b as FORM_ERRORS_PATH_KEY, S as SubmitErrorHandlerError, A as AnonPersistError, k as captureUserCallSite, I as INTERACTIVE_TAG_NAMES, r as getOrAssignElementId, e as ROOT_PATH_KEY, R as ROOT_PATH, h as allowSensitivePersist, F as FORM_ERRORS_PATH, l as coerceToPathKey, v as isSensitivePath, o as createPersistOptInRegistry, d as InvalidUseFormConfigError, q as ensureAttaformInstalled, J as useRegistry, z as kFormContext, B as kFormInstanceId, g as ReservedFormKeyError, n as createIsSensitivePath, y as kAttaformWizardActiveStepResolver, w as kAttaformAncestorWizard } from './attaform.QG5TG8lB.mjs';
+import { computed, ref, watchEffect, getCurrentScope, onScopeDispose, shallowReadonly, readonly, toRaw, reactive, watch, markRaw, shallowRef, getCurrentInstance, onServerPrefetch, provide, useId, inject, effectScope, nextTick } from 'vue';
+import { _ as __DEV__, j as canonicalizePath, G as segmentsForPathKey, t as isPathPrefix, b as FORM_ERRORS_PATH_KEY, S as SubmitErrorHandlerError, H as toError, A as AnonPersistError, k as captureUserCallSite, I as INTERACTIVE_TAG_NAMES, r as getOrAssignElementId, e as ROOT_PATH_KEY, R as ROOT_PATH, h as allowSensitivePersist, F as FORM_ERRORS_PATH, l as coerceToPathKey, v as isSensitivePath, o as createPersistOptInRegistry, d as InvalidUseFormConfigError, q as ensureAttaformInstalled, K as useRegistry, z as kFormContext, B as kFormInstanceId, g as ReservedFormKeyError, n as createIsSensitivePath, y as kAttaformWizardActiveStepResolver, w as kAttaformAncestorWizard } from './attaform.pmtahXKy.mjs';
 
 function safeAssign(target, key, value) {
   if (key === "__proto__") {
@@ -13,10 +13,14 @@ function safeAssign(target, key, value) {
   }
   target[key] = value;
 }
+function isShadowedKey(key) {
+  return key in Object.prototype;
+}
 function safeOwnRead(target, key) {
-  if (key === "__proto__") {
-    const desc = Object.getOwnPropertyDescriptor(target, "__proto__");
-    return desc?.value;
+  if (isShadowedKey(key)) {
+    const desc = Object.getOwnPropertyDescriptor(target, key);
+    if (desc === void 0) return void 0;
+    return "value" in desc ? desc.value : target[key];
   }
   return target[key];
 }
@@ -35,6 +39,10 @@ function descendStep(value, segment) {
   }
   const record = value;
   const key = typeof segment === "number" ? String(segment) : segment;
+  if (isShadowedKey(key)) {
+    if (!safeOwnHas(record, key)) return NOT_FOUND;
+    return safeOwnRead(record, key);
+  }
   if (!(key in record)) return NOT_FOUND;
   return record[key];
 }
@@ -64,6 +72,7 @@ function hasAtPath(root, path) {
     return typeof last === "number" && last >= 0 && last < current.length;
   }
   const key = typeof last === "number" ? String(last) : last;
+  if (isShadowedKey(key)) return safeOwnHas(current, key);
   return key in current;
 }
 function isPlainRecord(value) {
@@ -458,17 +467,57 @@ function structuralSnapshot(value) {
   return out;
 }
 
-const defaultDisplayState = (field, formMeta) => {
-  const gateOpen = formMeta.submissionAttempts > 0 || field.blurredAfterInteraction === true;
-  if (!gateOpen) return "idle";
-  if (field.validating === true) return "pending";
+function isGateOpen(field, formMeta) {
+  return formMeta.submissionAttempts > 0 || field.blurredAfterInteraction === true;
+}
+function computeVerdict(field, formMeta) {
+  if (!isGateOpen(field, formMeta)) return "idle";
   const hasOwnError = field.errors.some(
     (e) => e.path.length === field.path.length && e.path.every((s, i) => s === field.path[i])
   );
   if (hasOwnError) return "error";
   if (field.valid === true && field.blank !== true && field.dirty === true) return "success";
   return "idle";
-};
+}
+function earliestNonNull(a, b) {
+  if (a === null) return b;
+  if (b === null) return a;
+  return a < b ? a : b;
+}
+const DEFAULT_TIMINGS = { showDelay: 120, minVisible: 120 };
+const FOCUS_OUT_GRACE = 16;
+const defaultFamily = /* @__PURE__ */ new WeakSet();
+function isDefaultDisplayState(fn) {
+  return defaultFamily.has(fn);
+}
+function makeDefaultDisplayState({
+  showDelay,
+  minVisible
+}) {
+  const reducer = (prev, { field, formMeta, validatingSince, transformingSince, now }) => {
+    const verdict = computeVerdict(field, formMeta);
+    if (!isGateOpen(field, formMeta)) return { display: verdict };
+    const inFlightSince = earliestNonNull(validatingSince, transformingSince);
+    if (inFlightSince === null) {
+      if (prev.display === "pending") {
+        const shownAt = prev.pendingShownAt ?? now;
+        if (now < shownAt + minVisible)
+          return { display: "pending", pendingShownAt: shownAt, reviewAt: shownAt + minVisible };
+      }
+      return { display: verdict };
+    }
+    if (prev.display === "pending")
+      return { display: "pending", pendingShownAt: prev.pendingShownAt ?? now };
+    const window = field.focused === false ? Math.min(showDelay, FOCUS_OUT_GRACE) : showDelay;
+    if (now - inFlightSince < window) {
+      return { display: prev.display, reviewAt: inFlightSince + window };
+    }
+    return { display: "pending", pendingShownAt: now, reviewAt: now + minVisible };
+  };
+  defaultFamily.add(reducer);
+  return reducer;
+}
+const defaultDisplayState = makeDefaultDisplayState(DEFAULT_TIMINGS);
 function resolveGetDisplayState(config) {
   return config ?? defaultDisplayState;
 }
@@ -587,6 +636,8 @@ function buildLeafFieldStateBase(state, segments, key, formInstanceId) {
   if (blankForKey !== void 0) errors.push(...blankForKey);
   if (userForKey !== void 0) errors.push(...userForKey);
   const validating = (state.fieldValidationCounts.get(key) ?? 0) > 0;
+  const transforming = (state.fieldTransformCounts.get(key) ?? 0) > 0;
+  const transformError = state.transformErrors.get(key) ?? null;
   const gated = state.pathHasAsyncValidation(segments) && !state.firstValidationDone.value;
   const isOrphan = segments.length > 0 && !hasAtPath(state.form.value, segments) && isUnderStubAncestor(state, segments);
   const valid = !gated && errors.length === 0 && !validating && !isOrphan;
@@ -613,6 +664,9 @@ function buildLeafFieldStateBase(state, segments, key, formInstanceId) {
     errors,
     validating,
     valid,
+    transforming,
+    busy: transforming || validating,
+    transformError,
     path: segments,
     ...computeFieldIdentity(formInstanceId, state.formKey, key),
     key: state.arrayElementKey(segments),
@@ -625,7 +679,21 @@ function buildLeafFieldStateBase(state, segments, key, formInstanceId) {
 }
 function buildLeafFieldState(state, segments, key, formInstanceId, getFormMetaBase, getDisplayState) {
   const base = buildLeafFieldStateBase(state, segments, key, formInstanceId);
-  return decorateWithDerivedProps(base, state, getFormMetaBase, getDisplayState);
+  const validatingSince = state.fieldValidatingSince.get(key) ?? null;
+  const transformingSince = state.fieldTransformingSince.get(key) ?? null;
+  return decorateWithDerivedProps(
+    base,
+    state,
+    getFormMetaBase,
+    key,
+    validatingSince,
+    transformingSince,
+    false,
+    // revealedDescendantError: leaves have no descendants
+    false,
+    // isRoot: a leaf is never the form root
+    getDisplayState
+  );
 }
 function buildContainerFieldStateBase(state, segments, key, formInstanceId) {
   const formValue = state.form.value;
@@ -641,8 +709,13 @@ function buildContainerFieldStateBase(state, segments, key, formInstanceId) {
   let blurredAfterInteraction = false;
   let connected = false;
   let validating = false;
+  let validatingSince = null;
+  let transforming = false;
+  let transformingSince = null;
   let updatedAt = null;
   let asyncPending = false;
+  const submissionAttempts = state.submissionAttempts.value;
+  const blurredLeafSegments = [];
   for (const [leafKey, entry] of state.originals) {
     if (!isPathPrefix(segments, entry.segments)) continue;
     if (segments.length === entry.segments.length) continue;
@@ -657,9 +730,25 @@ function buildContainerFieldStateBase(state, segments, key, formInstanceId) {
     if (leafRecord?.blurred === true) blurred = true;
     if (leafRecord?.touched === true) touched = true;
     if (leafRecord?.interacted === true) interacted = true;
-    if (leafRecord?.blurredAfterInteraction === true) blurredAfterInteraction = true;
+    if (leafRecord?.blurredAfterInteraction === true) {
+      blurredAfterInteraction = true;
+      blurredLeafSegments.push(entry.segments);
+    }
     if (leafRecord?.connected === true) connected = true;
-    if ((state.fieldValidationCounts.get(leafKey) ?? 0) > 0) validating = true;
+    if ((state.fieldValidationCounts.get(leafKey) ?? 0) > 0) {
+      validating = true;
+      const leafGateOpen = submissionAttempts > 0 || leafRecord?.blurredAfterInteraction === true;
+      const since = state.fieldValidatingSince.get(leafKey);
+      if (leafGateOpen && since !== void 0 && (validatingSince === null || since < validatingSince))
+        validatingSince = since;
+    }
+    if ((state.fieldTransformCounts.get(leafKey) ?? 0) > 0) {
+      transforming = true;
+      const leafGateOpen = submissionAttempts > 0 || leafRecord?.blurredAfterInteraction === true;
+      const since = state.fieldTransformingSince.get(leafKey);
+      if (leafGateOpen && since !== void 0 && (transformingSince === null || since < transformingSince))
+        transformingSince = since;
+    }
     if (state.pathHasAsyncValidationByKey(leafKey, entry.segments)) asyncPending = true;
     const ts = leafRecord?.updatedAt;
     if (ts !== void 0 && ts !== null) {
@@ -671,50 +760,101 @@ function buildContainerFieldStateBase(state, segments, key, formInstanceId) {
     dirty = true;
   }
   const errors = aggregateErrorsAt(state, segments);
+  const revealedDescendantError = errors.length > 0 && errors.some((e) => {
+    const ePath = e.path;
+    if (ePath.length === segments.length && ePath.every((s, i) => s === segments[i])) return false;
+    if (submissionAttempts > 0) return true;
+    if (ePath.length === 1 && ePath[0] === "") return blurredAfterInteraction;
+    return blurredLeafSegments.some((s) => isPathPrefix(ePath, s));
+  });
   if (!asyncPending && state.pathHasAsyncValidation(segments)) asyncPending = true;
+  if ((state.fieldValidationCounts.get(key) ?? 0) > 0) {
+    validating = true;
+    const since = state.fieldValidatingSince.get(key);
+    if (since !== void 0 && (validatingSince === null || since < validatingSince))
+      validatingSince = since;
+  }
+  if ((state.fieldTransformCounts.get(key) ?? 0) > 0) {
+    transforming = true;
+    const since = state.fieldTransformingSince.get(key);
+    if (since !== void 0 && (transformingSince === null || since < transformingSince))
+      transformingSince = since;
+  }
+  const ownTransformError = state.transformErrors.get(key) ?? null;
   const gated = asyncPending && !state.firstValidationDone.value;
   const valid = !gated && errors.length === 0 && !validating;
   const resolved = state.schema.getFieldMetaAtPath ? state.schema.getFieldMetaAtPath(segments) : EMPTY_RESOLVED_FIELD_META;
   const lastSegment = segments.length === 0 ? "" : segments[segments.length - 1] ?? "";
   const label = resolved.label || humanize(lastSegment);
   return {
-    value,
-    original,
-    pristine,
-    dirty,
-    focused,
-    blurred,
-    touched,
-    interacted,
-    blurredAfterInteraction,
-    connected,
-    element: null,
-    elements: EMPTY_ELEMENTS,
-    updatedAt,
-    errors,
-    validating,
-    valid,
-    path: segments,
-    ...computeFieldIdentity(formInstanceId, state.formKey, key),
-    key: state.arrayElementKey(segments),
-    blank,
-    label,
-    description: resolved.description,
-    placeholder: resolved.placeholder,
-    meta: resolved.meta
+    base: {
+      value,
+      original,
+      pristine,
+      dirty,
+      focused,
+      blurred,
+      touched,
+      interacted,
+      blurredAfterInteraction,
+      connected,
+      element: null,
+      elements: EMPTY_ELEMENTS,
+      updatedAt,
+      errors,
+      validating,
+      valid,
+      transforming,
+      busy: transforming || validating,
+      // A container surfaces its OWN transform failure (a transform registered
+      // on the container path, e.g. a file normalizer) but never rolls up a
+      // descendant leaf's failure — that stays a per-field channel.
+      transformError: ownTransformError,
+      path: segments,
+      ...computeFieldIdentity(formInstanceId, state.formKey, key),
+      key: state.arrayElementKey(segments),
+      blank,
+      label,
+      description: resolved.description,
+      placeholder: resolved.placeholder,
+      meta: resolved.meta
+    },
+    validatingSince,
+    transformingSince,
+    revealedDescendantError
   };
 }
 function buildContainerFieldState(state, segments, key, formInstanceId, getFormMetaBase, getDisplayState) {
-  const base = buildContainerFieldStateBase(state, segments, key, formInstanceId);
-  return decorateWithDerivedProps(base, state, getFormMetaBase, getDisplayState);
+  const { base, validatingSince, transformingSince, revealedDescendantError } = buildContainerFieldStateBase(state, segments, key, formInstanceId);
+  return decorateWithDerivedProps(
+    base,
+    state,
+    getFormMetaBase,
+    key,
+    validatingSince,
+    transformingSince,
+    revealedDescendantError,
+    segments.length === 0,
+    getDisplayState
+  );
 }
-function decorateWithDerivedProps(base, state, getFormMetaBase, getDisplayState) {
+function decorateWithDerivedProps(base, state, getFormMetaBase, key, validatingSince, transformingSince, revealedDescendantError, isRoot, getDisplayState) {
   const firstError = base.errors[0];
   const predicate = getDisplayState ?? state.getDisplayState;
   const formMeta = getFormMetaBase();
-  let displayState;
+  const ctx = {
+    field: base,
+    formMeta,
+    validatingSince,
+    transformingSince,
+    // The engine's clock. Frozen to 0 under SSR (no clock, nothing in
+    // flight) so the reducer returns the plain verdict and hydration matches.
+    now: state.ssr ? 0 : Date.now()
+  };
+  let machine;
+  let rollupApplies = isDefaultDisplayState(predicate);
   try {
-    displayState = predicate(base, formMeta);
+    machine = state.displayEngine.resolve(key, ctx, predicate);
   } catch (err) {
     if (__DEV__ && !warnedDisplayStatePredicates.has(predicate)) {
       warnedDisplayStatePredicates.add(predicate);
@@ -723,8 +863,11 @@ function decorateWithDerivedProps(base, state, getFormMetaBase, getDisplayState)
         err
       );
     }
-    displayState = defaultDisplayState(base, formMeta);
+    machine = state.displayEngine.resolve(key, ctx, defaultDisplayState);
+    rollupApplies = true;
   }
+  const submitValidating = rollupApplies && isRoot && state.submitting.value && state.activeValidations.value > 0;
+  const displayState = machine.display === "pending" || submitValidating ? "pending" : rollupApplies && revealedDescendantError ? "error" : machine.display;
   return {
     ...base,
     displayState,
@@ -770,6 +913,15 @@ function liveKeysAtPath(state, segments) {
   if (typeof value === "object") return Object.keys(value);
   return [];
 }
+function liveContainerHasKey(state, segments, key) {
+  const value = getAtPath(state.form.value, segments);
+  if (value === null || value === void 0 || typeof value !== "object") return false;
+  if (Array.isArray(value)) {
+    const index = Number(key);
+    return Number.isInteger(index) && index >= 0 && index < value.length && String(index) === key;
+  }
+  return Object.hasOwn(value, key);
+}
 function isArrayPath(state, segments) {
   if (segments.length === 0) return false;
   return Array.isArray(getAtPath(state.form.value, segments));
@@ -798,6 +950,21 @@ const INTEGER_SEGMENT = /^(?:0|[1-9]\d*)$/;
 function keyToSegment(key) {
   return INTEGER_SEGMENT.test(key) ? Number(key) : key;
 }
+function callableInvokeShim(method, surface, getDescent) {
+  const fnMethod = Reflect.get(Function.prototype, method);
+  return new Proxy((() => {
+  }), {
+    apply: (_target, _thisArg, args) => Reflect.apply(fnMethod, surface, args),
+    get: (_target, key) => Reflect.get(getDescent(), key),
+    has: (_target, key) => Reflect.has(getDescent(), key),
+    ownKeys: () => Reflect.ownKeys(getDescent()),
+    getOwnPropertyDescriptor: (_target, key) => {
+      const descriptor = Reflect.getOwnPropertyDescriptor(getDescent(), key);
+      if (descriptor !== void 0) descriptor.configurable = true;
+      return descriptor;
+    }
+  });
+}
 function buildSurfaceProxy(opts) {
   const containerCache = /* @__PURE__ */ new Map();
   const leafViewCache = /* @__PURE__ */ new Map();
@@ -824,6 +991,8 @@ function buildSurfaceProxy(opts) {
     const cacheKey = `${JSON.stringify(segments)}+${isArrayLike ? "A" : "O"}`;
     const existing = containerCache.get(cacheKey);
     if (existing !== void 0) return existing;
+    const isFixedObject = opts.schema.isFixedObjectAtPath(segments);
+    const containerHasKey = (k) => opts.containerHasOwnKey !== void 0 ? opts.containerHasOwnKey(segments, k) : opts.containerOwnKeys?.(segments).includes(k) === true;
     const snapshotContainer = () => opts.materializeContainer === void 0 ? {} : opts.materializeContainer(segments);
     const {
       toString: containerToString,
@@ -831,8 +1000,9 @@ function buildSurfaceProxy(opts) {
       toJSON: containerToJSON,
       toPrimitive: containerToPrimitive
     } = makeReadonlyCoercion(snapshotContainer);
-    const target = isArrayLike ? [] : (() => {
-    });
+    const isRoot = segments.length === 0;
+    const target = isRoot ? (() => {
+    }) : isArrayLike ? [] : {};
     const proxy = new Proxy(target, {
       apply(_, __, args) {
         const arg = args[0];
@@ -863,7 +1033,16 @@ function buildSurfaceProxy(opts) {
             return key === "toString" ? containerToString : containerValueOf;
           }
         }
-        return descendOrTerminate(childSegs);
+        if (key === "hasOwnProperty" && !schemaHasPath(childSegs)) {
+          return Object.prototype.hasOwnProperty;
+        }
+        if (isRoot && (key === "call" || key === "apply" || key === "bind")) {
+          return callableInvokeShim(key, proxy, () => descendOrTerminate(childSegs));
+        }
+        if (opts.isTerminalAt?.(childSegs) === true || isFixedObject && schemaHasPath(childSegs) || containerHasKey(key)) {
+          return descendOrTerminate(childSegs);
+        }
+        return void 0;
       },
       has(_, key) {
         if (typeof key === "symbol") return Reflect.has(target, key);
@@ -948,15 +1127,8 @@ function buildSurfaceProxy(opts) {
       toJSON: leafToJSONHandler,
       toPrimitive: leafToPrimitive
     } = makeReadonlyCoercion(snapshotLeaf);
-    const target = (() => {
-    });
+    const target = {};
     const proxy = new Proxy(target, {
-      apply(_, __, args) {
-        const arg = args[0];
-        if (arg === void 0) return opts.resolveCallTarget(segments);
-        const { segments: argSegs } = canonicalizePath(arg);
-        return opts.resolveCallTarget(argSegs);
-      },
       get(_, key) {
         if (typeof key === "symbol") {
           if (key === Symbol.toPrimitive) return leafToPrimitive;
@@ -966,6 +1138,9 @@ function buildSurfaceProxy(opts) {
         if (key === "toString") return leafToString;
         if (key === "valueOf") return leafValueOf;
         if (key === "toJSON") return leafToJSONHandler;
+        if (key === "hasOwnProperty" && !schemaHasPath([...segments, keyToSegment(key)])) {
+          return Object.prototype.hasOwnProperty;
+        }
         if (leafKeys.has(key)) {
           const leaf = opts.resolveLeaf(segments);
           return readLeafKey(leaf, key);
@@ -978,8 +1153,8 @@ function buildSurfaceProxy(opts) {
         return true;
       },
       // Iteration: leaf-views expose the leaf-key set so
-      // `JSON.stringify(form.fields.email)` produces a FieldState
-      // snapshot rather than the function-target placeholder.
+      // `Object.keys(form.fields.email)` / spread enumerate the
+      // FieldState props. (`JSON.stringify` routes through `toJSON` above.)
       ownKeys: () => Array.from(leafKeys),
       getOwnPropertyDescriptor(_, key) {
         if (typeof key !== "string") return void 0;
@@ -1088,6 +1263,12 @@ function buildErrorsProxy(state) {
     // library-produced verdicts (schema + derived-blank) at unreachable
     // paths stay hidden; user-supplied errors are unconditional.
     containerOwnKeys: (segments) => errorAwareContainerKeys(state, segments),
+    // Fast path: a key the live form data holds short-circuits before the
+    // O(n) error-store scan, so iterating `form.errors.<array>` over live
+    // indices stays linear. The scan still runs for a key with no live
+    // home — a server error at a non-schema key (`form.errors.ghost`) —
+    // so it keeps surfacing while a genuinely-absent key reads undefined.
+    containerHasOwnKey: (segments, key) => liveContainerHasKey(state, segments, key) || errorAwareContainerKeys(state, segments).includes(key),
     isArrayContainer: (segments) => isArrayPath(state, segments)
   });
 }
@@ -1261,6 +1442,9 @@ const FIELD_STATE_KEYS = /* @__PURE__ */ new Set([
   "errors",
   "validating",
   "valid",
+  "transforming",
+  "busy",
+  "transformError",
   "displayState",
   "showErrors",
   "showPending",
@@ -1363,14 +1547,22 @@ function buildFieldStateProxy(state, formInstanceId, getFormMetaBase, options) {
     terminalCache.set(cacheKey, proxy);
     return proxy;
   }
+  const surfaceSchema = state.schema;
   return buildSurfaceProxy({
-    schema: state.schema,
+    schema: surfaceSchema,
     resolveLeaf: (path) => getFieldStateAt(path),
     leafKeys: FIELD_STATE_KEYS,
     readLeafKey: (computed, key) => computed.value[key],
     materializeContainer: (segments) => materializeFields(state, segments, snapshotFieldStateAt),
-    resolveCallTarget: (path) => fieldStateTerminalAt(path),
+    // `form.fields(path)` resolves a FieldState for any path the SCHEMA
+    // declares — a leaf, a container, an inactive discriminated-union
+    // variant key, or an out-of-bounds array index (the element schema
+    // admits any index). A path the schema doesn't have is a typo, not a
+    // field, so it reads `undefined` rather than a phantom stub. The
+    // empty path (`form.fields()`) is the root object, always valid.
+    resolveCallTarget: (path) => surfaceSchema.getSlimPrimitiveTypesAtPath(path).size > 0 ? fieldStateTerminalAt(path) : void 0,
     containerOwnKeys: (segments) => liveKeysAtPath(state, segments),
+    containerHasOwnKey: (segments, key) => liveContainerHasKey(state, segments, key),
     isArrayContainer: (segments) => isArrayPath(state, segments)
   });
 }
@@ -1417,90 +1609,6 @@ async function getStorageAdapter(storage) {
     }
   }
 }
-const PERSISTED_ENVELOPE_VERSION = 6;
-function readPersistedPayload(value) {
-  if (value === null || value === void 0 || typeof value !== "object") return null;
-  const envelope = value;
-  if (typeof envelope.v !== "number") return null;
-  if (envelope.v !== PERSISTED_ENVELOPE_VERSION) {
-    warnVersionMismatch(envelope.v);
-    return null;
-  }
-  if (envelope.data === void 0 || typeof envelope.data !== "object") return null;
-  return envelope;
-}
-const warnedVersions = __DEV__ ? /* @__PURE__ */ new Set() : null;
-function warnVersionMismatch(observedVersion) {
-  if (warnedVersions === null) return;
-  if (warnedVersions.has(observedVersion)) return;
-  warnedVersions.add(observedVersion);
-  console.warn(
-    `[attaform] Dropping persisted draft \u2014 envelope v=${observedVersion}, but this version of the library expects v=${PERSISTED_ENVELOPE_VERSION}. The persisted shape changed across releases; older drafts can't be restored. New drafts saved this session will use the current envelope.`
-  );
-}
-function buildPersistedPayload(form, include, schemaErrors, userErrors, blankPaths) {
-  let transientList;
-  if (blankPaths !== void 0 && blankPaths.size > 0) {
-    transientList = [...blankPaths];
-  }
-  if (include === "form") {
-    if (transientList === void 0) return { v: PERSISTED_ENVELOPE_VERSION, data: { form } };
-    return {
-      v: PERSISTED_ENVELOPE_VERSION,
-      data: { form, blankPaths: transientList }
-    };
-  }
-  return {
-    v: PERSISTED_ENVELOPE_VERSION,
-    data: {
-      form,
-      schemaErrors: [...schemaErrors.entries()].map(([k, v]) => [k, [...v]]),
-      userErrors: [...userErrors.entries()].map(([k, v]) => [k, [...v]]),
-      ...transientList !== void 0 ? { blankPaths: transientList } : {}
-    }
-  };
-}
-function createDebouncedWriter(write, debounceMs) {
-  let timer = null;
-  let pending = null;
-  let writeGeneration = 0;
-  function runWrite() {
-    const gen = ++writeGeneration;
-    pending = write().finally(() => {
-      if (writeGeneration === gen) pending = null;
-    });
-  }
-  function schedule() {
-    if (timer !== null) clearTimeout(timer);
-    if (debounceMs === 0) {
-      runWrite();
-      return;
-    }
-    timer = setTimeout(() => {
-      timer = null;
-      runWrite();
-    }, debounceMs);
-  }
-  async function flush() {
-    if (timer !== null) {
-      clearTimeout(timer);
-      timer = null;
-      runWrite();
-    }
-    while (pending !== null) {
-      const awaited = pending;
-      await awaited;
-      if (pending === awaited) break;
-    }
-  }
-  function cancel() {
-    if (timer !== null) {
-      clearTimeout(timer);
-      timer = null;
-    }
-  }
-  return { schedule, flush, cancel };
-}
 function resolveStorageKeyBase(config, formKey) {
   return config.key ?? `${PERSISTENCE_KEY_PREFIX}${formKey}`;
 }
@@ -1547,47 +1655,6 @@ async function sweepNonConfiguredStandardStoresForOrphans(configured, base) {
     }
   }
 }
-function pluckPaths(form, pathKeys) {
-  let sparse = void 0;
-  for (const pathKey of pathKeys) {
-    const segments = segmentsForPathKey(pathKey);
-    if (segments === null) continue;
-    const value = getAtPath(form, segments);
-    if (value === void 0) continue;
-    sparse = setAtPath(sparse ?? {}, segments, value);
-  }
-  return sparse ?? {};
-}
-function stripUnacknowledgedSensitiveLeaves(form, optedInPaths, isSensitivePath) {
-  const acknowledgedSensitive = [];
-  for (const key of optedInPaths) {
-    const segs = segmentsForPathKey(key);
-    if (segs !== null && isSensitivePath(segs)) acknowledgedSensitive.push(segs);
-  }
-  const coveredByAcknowledged = (path) => acknowledgedSensitive.some((prefix) => isPathPrefix(prefix, path));
-  const walk = (path, value) => {
-    if (path.length > 0 && isSensitivePath(path) && !coveredByAcknowledged(path)) {
-      return void 0;
-    }
-    if (value === null || typeof value !== "object") return value;
-    if (Array.isArray(value)) return value.map((item, i) => walk([...path, i], item));
-    if (!isPlainRecord(value)) return value;
-    const out = {};
-    for (const key of Object.keys(value)) {
-      const walked = walk([...path, key], value[key]);
-      if (walked !== void 0) safeAssign(out, key, walked);
-    }
-    return out;
-  };
-  return walk([], form);
-}
-function filterErrorsByPaths(errors, pathKeys) {
-  const out = /* @__PURE__ */ new Map();
-  for (const [key, value] of errors) {
-    if (pathKeys.has(key)) out.set(key, value);
-  }
-  return out;
-}
 function mergeSparseHydration(schemaDefaults, sparse, schema) {
   return mergeDeep(schemaDefaults, sparse, [], schema);
 }
@@ -1771,7 +1838,7 @@ function buildProcessForm(state, formInstanceId, options = {}) {
     if (!result.ok) return result.error;
     return stripData(composeWithDerivedBlank(result.refinement, result.segments));
   }
-  async function process(pathInput) {
+  async function parse(pathInput) {
     const result = await runImperativeValidation(pathInput, {
       cancelInFlight: false,
       commitToSchemaErrors: false
@@ -1824,7 +1891,10 @@ function buildProcessForm(state, formInstanceId, options = {}) {
         state.activeSubmissions.value += 1;
         state.submitting.value = true;
         state.submitError.value = null;
+        state.clearUserErrors();
+        while (state.activeTransforms.value > 0) await state.settleTransforms();
         state.cancelFieldValidation();
+        state.displayEngine.clear();
         state.activeValidations.value += 1;
         const refinement = await runRefinementValidation(state.form.value, void 0);
         const merged = composeWithDerivedBlank(refinement, void 0);
@@ -1861,9 +1931,8 @@ function buildProcessForm(state, formInstanceId, options = {}) {
         state.emitSubmitSuccess();
       } catch (err) {
         if (state.submissionGeneration.value === genAtEntry) {
-          state.submitError.value = err;
+          state.submitError.value = toError(err);
         }
-        throw err;
       } finally {
         if (!validationSettled) {
           state.activeValidations.value = Math.max(0, state.activeValidations.value - 1);
@@ -1877,7 +1946,7 @@ function buildProcessForm(state, formInstanceId, options = {}) {
     };
     return submitHandler;
   };
-  return { validate, validateAsync, process, handleSubmit };
+  return { validate, validateAsync, parse, handleSubmit };
 }
 function toSegments(pathInput) {
   return canonicalizePath(pathInput).segments;
@@ -2350,6 +2419,23 @@ function buildRegister(state, formInstanceId, instanceConfig) {
       markConnectedOptimistically: () => {
         state.markConnectedOptimistically(segments);
       },
+      // --- Async transform lifecycle (internal; the directive's
+      // deferred orchestrator is the only legitimate consumer). Thin
+      // path-bound delegates to the store's per-path token / counter
+      // machinery — same pattern as `markBlank` / `setValueWithInternalPath`,
+      // so the directive (which holds only this RegisterValue, never the
+      // store) can drive the busy/discard/error bookkeeping. ---
+      beginTransform: (holder) => state.beginTransform(pathKey, holder),
+      isCurrentTransform: (token) => state.isCurrentTransform(pathKey, token),
+      endTransform: (token) => state.endTransform(pathKey, token),
+      setTransformError: (err) => state.setTransformError(pathKey, err),
+      // Synchronous read of "is a transform in flight at this path". The
+      // orchestrator's `beginTransform` bumps the count before the
+      // listener's force-sync block runs, so the directive reads this to
+      // skip reverting the DOM to stale storage mid-flight.
+      get transforming() {
+        return (state.fieldTransformCounts.get(pathKey) ?? 0) > 0;
+      },
       path: pathKey,
       // Frozen so a wrapper component can pass `rv.segments` directly
       // to `form.fields(...)` without defensive copying — and so test
@@ -2548,7 +2634,9 @@ function expandUnsetAt(segments, schema, paths) {
 function buildCallableReadonlySnapshotProxy(opts) {
   const target = (() => {
   });
-  const { toString, valueOf, toJSON, toPrimitive } = makeReadonlyCoercion(opts.snapshot);
+  const { toString, valueOf, toJSON, toPrimitive } = makeReadonlyCoercion(
+    opts.coercionSnapshot ?? opts.snapshot
+  );
   const callResolve = opts.resolveCall ?? ((arg) => opts.resolveKey(String(arg)));
   return new Proxy(target, {
     apply(_, __, args) {
@@ -2597,27 +2685,52 @@ function buildCallableReadonlySnapshotProxy(opts) {
   });
 }
 
+function materializeFormValue(node) {
+  if (node === null || typeof node !== "object") return node;
+  if (Array.isArray(node)) {
+    const out2 = new Array(node.length);
+    for (let i = 0; i < node.length; i++) out2[i] = materializeFormValue(node[i]);
+    return out2;
+  }
+  if (!isPlainRecord(node)) return toRaw(node);
+  const rec = node;
+  const out = {};
+  for (const key of Object.keys(rec)) {
+    safeAssign(out, key, materializeFormValue(safeOwnRead(rec, key)));
+  }
+  return out;
+}
 function buildValuesProxy(form) {
   const inner = computed(() => readonly(form.value));
   return buildCallableReadonlySnapshotProxy({
     surface: "form.values",
     snapshot: () => inner.value,
+    // Faithful, reactivity-preserving serialisation: walk the reactive
+    // proxy with own-safe reads so `JSON.stringify(form.values)` /
+    // `String(form.values)` reflect the stored data — including a field
+    // literally named `hasOwnProperty` that Vue would otherwise shim —
+    // while still tracking the per-key reads that drive re-render.
+    coercionSnapshot: () => materializeFormValue(inner.value),
     // Read through the readonly proxy at access time so Vue's
     // dependency tracking lands inside the consumer's active effect
     // — `inner.value[key]` is what triggers per-key tracking.
-    resolveKey: (key) => inner.value[key],
-    // Dynamic path: walk segments through the readonly proxy. Each
-    // step reads through the proxy's own get traps so dependency
-    // tracking propagates at every level.
-    resolveCall: (arg) => {
-      const { segments } = canonicalizePath(arg);
-      let cursor = inner.value;
-      for (const seg of segments) {
-        if (cursor === null || cursor === void 0) return void 0;
-        cursor = cursor[seg];
-      }
-      return cursor;
-    },
+    //
+    // Prototype-shadowed names (`hasOwnProperty`, `constructor`, …) read
+    // off the RAW target instead: own-shadows-inherited semantics still
+    // hold (a data field by that name returns its stored value), but
+    // when there's no such field the inherited member resolves — so
+    // `form.values.hasOwnProperty('x')` keeps working as the real
+    // method. The raw read dodges Vue's `hasOwnProperty` proxy shim,
+    // which would otherwise mask a data field of that name. (`toString`
+    // / `valueOf` / `toJSON` never reach here — the base get trap
+    // intercepts them as coercion handlers first.)
+    resolveKey: (key) => isShadowedKey(key) ? toRaw(inner.value)[key] : inner.value[key],
+    // Dynamic path: walk segments through the readonly proxy with the
+    // same own-property-safe descent the rest of the runtime uses
+    // (`getAtPath`), so `form.values('a.hasOwnProperty')` resolves the
+    // stored value. Per-level reads still propagate Vue's tracking for
+    // ordinary keys.
+    resolveCall: (arg) => getAtPath(inner.value, canonicalizePath(arg).segments),
     ownKeys: () => Reflect.ownKeys(inner.value),
     hasKey: (key) => Reflect.has(inner.value, key),
     describeKey: (key) => {
@@ -2641,7 +2754,12 @@ function buildFormApi(state, formInstanceId, options = {}) {
     return meta === void 0 ? { instance: instanceMeta } : { ...meta, instance: instanceMeta };
   };
   const getFormMetaBase = () => {
-    const rootBase = buildContainerFieldStateBase(state, ROOT_PATH, ROOT_PATH_KEY, formInstanceId);
+    const { base: rootBase } = buildContainerFieldStateBase(
+      state,
+      ROOT_PATH,
+      ROOT_PATH_KEY,
+      formInstanceId
+    );
     return {
       ...rootBase,
       submitting: state.submitting.value,
@@ -2673,12 +2791,12 @@ function buildFormApi(state, formInstanceId, options = {}) {
   const {
     validate: validateBuilt,
     validateAsync: validateAsyncBuilt,
-    process: processBuilt,
+    parse: parseBuilt,
     handleSubmit
   } = buildProcessForm(state, formInstanceId, processOptions);
   const validate = (pathInput) => validateBuilt(pathInput);
   const validateAsync = (pathInput) => validateAsyncBuilt(pathInput);
-  const process = (pathInput) => processBuilt(pathInput);
+  const parse = (pathInput) => parseBuilt(pathInput);
   function pathToRef(pathInput) {
     const segments = canonicalizePath(pathInput).segments;
     return computed(() => getAtPath(state.form.value, segments));
@@ -2906,6 +3024,21 @@ function buildFormApi(state, formInstanceId, options = {}) {
       // keep the explicit form-level computation for the gate.
       valid,
       errors: metaErrors,
+      // Whole-form transforming mirrors the global `activeTransforms`
+      // counter ORed with any per-leaf transform in flight (the root
+      // rollup), exactly as `validating` composes its lifecycle and
+      // per-field sources. `busy` is the union of both work signals at
+      // the form level. `transformError` is leaf-only, so the root
+      // rollup reads it as `null` (kept for FieldState-shape parity).
+      transforming: computed(
+        () => state.activeTransforms.value > 0 || rootFieldState.value.transforming
+      ),
+      busy: computed(
+        () => state.activeValidations.value > 0 || state.activeTransforms.value > 0 || rootFieldState.value.validating || rootFieldState.value.transforming
+      ),
+      get transformError() {
+        return rootFieldState.value.transformError;
+      },
       // `displayState` / the `show*` booleans / `firstError` flow
       // through the same root field-state computed as the rest of the
       // FieldState surface, so `form.meta.displayState` matches
@@ -2976,7 +3109,7 @@ function buildFormApi(state, formInstanceId, options = {}) {
       instanceId: formInstanceId
     })
   );
-  const persistence = state.modules.get(PERSISTENCE_MODULE_KEY);
+  const persistenceHandle = state.modules.get(PERSISTENCE_MODULE_KEY);
   const reset = (nextDefaultValues) => {
     if (nextDefaultValues === void 0) {
       state.reset();
@@ -2991,15 +3124,15 @@ function buildFormApi(state, formInstanceId, options = {}) {
         state.originalBlankPaths.add(pathKey);
       }
     }
-    if (persistence !== void 0) {
-      void persistence.clearPersistedDraft().catch(() => void 0);
+    if (persistenceHandle !== void 0) {
+      void persistenceHandle.ready.then((m) => m?.clearPersistedDraft()).catch(() => void 0);
     }
   };
   const resetField = (pathInput) => {
     const segments = canonicalizePath(pathInput).segments;
     state.resetField(segments);
-    if (persistence !== void 0) {
-      void persistence.clearPersistedDraft(segments).catch(() => void 0);
+    if (persistenceHandle !== void 0) {
+      void persistenceHandle.ready.then((m) => m?.clearPersistedDraft(segments)).catch(() => void 0);
     }
   };
   function clear(pathInput) {
@@ -3017,10 +3150,14 @@ function buildFormApi(state, formInstanceId, options = {}) {
     )) {
       return;
     }
+    if (persistenceHandle === void 0) return;
+    const persistence = await persistenceHandle.ready;
     if (persistence === void 0) return;
     await persistence.writePathImmediately(segments);
   };
   const clearPersistedDraft = async (pathInput) => {
+    if (persistenceHandle === void 0) return;
+    const persistence = await persistenceHandle.ready;
     if (persistence === void 0) return;
     if (pathInput === void 0) {
       await persistence.clearPersistedDraft();
@@ -3130,7 +3267,8 @@ function buildFormApi(state, formInstanceId, options = {}) {
     setValue: gated(setValueImpl),
     validate: gated(validate),
     validateAsync: gated(validateAsync),
-    process: gated(process),
+    parse: gated(parse),
+    settleTransforms: gated(state.settleTransforms),
     register: gated(register),
     key: state.formKey,
     // Auto-unwrapping views over the per-store async-defaults lifecycle
@@ -3203,6 +3341,93 @@ function buildFormApi(state, formInstanceId, options = {}) {
   };
 }
 
+const IDLE = Object.freeze({ display: "idle" });
+const MAX_DELAY = 2147483647;
+function createDisplayEngine(ssr) {
+  const machines = /* @__PURE__ */ new Map();
+  const tick = ref(0);
+  let timer = null;
+  let timerTarget = null;
+  let lastFiredTarget = null;
+  function clearTimer() {
+    if (timer !== null) {
+      clearTimeout(timer);
+      timer = null;
+      timerTarget = null;
+    }
+  }
+  function nearestReviewAt() {
+    let min = null;
+    for (const m of machines.values()) {
+      if (m.reviewAt === void 0 || !Number.isFinite(m.reviewAt)) continue;
+      if (min === null || m.reviewAt < min) min = m.reviewAt;
+    }
+    return min;
+  }
+  function rearm(now) {
+    const target = nearestReviewAt();
+    if (target === null) {
+      clearTimer();
+      return;
+    }
+    if (timer !== null && timerTarget === target) return;
+    if (target === lastFiredTarget) {
+      clearTimer();
+      return;
+    }
+    clearTimer();
+    timerTarget = target;
+    timer = setTimeout(
+      () => {
+        timer = null;
+        timerTarget = null;
+        lastFiredTarget = target;
+        tick.value++;
+      },
+      Math.min(MAX_DELAY, Math.max(0, target - now))
+    );
+  }
+  function resolve(key, ctx, reducer) {
+    void tick.value;
+    const prev = machines.get(key) ?? IDLE;
+    const machine = reducer(prev, ctx);
+    if (ssr) return machine;
+    const active = machine.display !== "idle" || machine.reviewAt !== void 0 && Number.isFinite(machine.reviewAt);
+    if (active) machines.set(key, machine);
+    else machines.delete(key);
+    rearm(ctx.now);
+    return machine;
+  }
+  function clear() {
+    machines.clear();
+    clearTimer();
+    lastFiredTarget = null;
+  }
+  let detachVisibility = null;
+  if (!ssr && typeof document !== "undefined") {
+    const onVisible = () => {
+      if (document.visibilityState === "visible" && machines.size > 0) tick.value++;
+    };
+    document.addEventListener("visibilitychange", onVisible);
+    detachVisibility = () => document.removeEventListener("visibilitychange", onVisible);
+  }
+  function dispose() {
+    clear();
+    if (detachVisibility !== null) {
+      detachVisibility();
+      detachVisibility = null;
+    }
+  }
+  return {
+    resolve,
+    clear,
+    dispose,
+    size: () => machines.size,
+    has: (key) => machines.has(key),
+    hasTimer: () => timer !== null
+  };
+}
+
 function applyDuStubs(schema, data, options = {}) {
   const warned = options.warn === true ? /* @__PURE__ */ new Set() : void 0;
   return walkDuStubs(schema, data, options.basePath ?? [], warned);
@@ -3541,6 +3766,7 @@ function createArrayBookkeeping(deps) {
     blankPaths,
     originalBlankPaths,
     fieldValidationCounts,
+    fieldValidatingSince,
     fieldValidationState,
     schemaErrors,
     activeValidations,
@@ -3566,6 +3792,7 @@ function createArrayBookkeeping(deps) {
     }));
     migrateSetSubtree(blankPaths, arrayPath, remap);
     migrateSetSubtree(originalBlankPaths, arrayPath, remap);
+    migrateMapSubtree(fieldValidatingSince, arrayPath, remap, (since) => since);
     migrateMapSubtree(fieldValidationCounts, arrayPath, remap, (count) => count);
     arrayIdentity.applyRemap(arrayPath, remap);
   }
@@ -3625,6 +3852,18 @@ function isHydratedFieldRecord(value) {
   const r = value;
   return Array.isArray(r.path) && (typeof r.updatedAt === "string" || r.updatedAt === null) && typeof r.connected === "boolean" && (typeof r.focused === "boolean" || r.focused === null) && (typeof r.blurred === "boolean" || r.blurred === null) && typeof r.touched === "boolean" && typeof r.interacted === "boolean" && typeof r.blurredAfterInteraction === "boolean";
 }
+function withClearedHistoryFlags(record, now) {
+  return {
+    path: record.path,
+    updatedAt: now,
+    connected: record.connected,
+    focused: record.focused,
+    blurred: record.blurred,
+    touched: false,
+    interacted: false,
+    blurredAfterInteraction: false
+  };
+}
 function isHydratedValidationErrorArray(value) {
   if (!Array.isArray(value)) return false;
   for (const entry of value) {
@@ -3752,6 +3991,9 @@ function createFormStore(options) {
   const resolvedIsSensitivePath = options.isSensitivePath ?? isSensitivePath;
   const cleanupHooks = [];
   const modules = /* @__PURE__ */ new Map();
+  const fieldValidatingSince = reactive(/* @__PURE__ */ new Map());
+  const displayEngine = createDisplayEngine(ssr);
+  registerCleanup(() => displayEngine.dispose());
   const completedConstraints = defaultValues === void 0 ? void 0 : mergeStructural(schema, [], defaultValues);
   const schemaResponse = schema.getDefaultValues({
     useDefaultSchemaValues: true,
@@ -3880,12 +4122,118 @@ function createFormStore(options) {
   }
   const fieldValidationCounts = reactive(/* @__PURE__ */ new Map());
   function incFieldValidation(key) {
-    fieldValidationCounts.set(key, (fieldValidationCounts.get(key) ?? 0) + 1);
+    fieldValidatingSince.set(key, ssr ? 0 : Date.now());
+    const prevCount = fieldValidationCounts.get(key) ?? 0;
+    fieldValidationCounts.set(key, prevCount + 1);
   }
   function decFieldValidation(key) {
     const next = (fieldValidationCounts.get(key) ?? 0) - 1;
-    if (next <= 0) fieldValidationCounts.delete(key);
-    else fieldValidationCounts.set(key, next);
+    if (next <= 0) {
+      fieldValidationCounts.delete(key);
+      fieldValidatingSince.delete(key);
+    } else {
+      fieldValidationCounts.set(key, next);
+    }
+  }
+  const fieldTransformCounts = reactive(/* @__PURE__ */ new Map());
+  const fieldTransformingSince = reactive(/* @__PURE__ */ new Map());
+  const transformErrors = reactive(/* @__PURE__ */ new Map());
+  const activeTransforms = ref(0);
+  const transformRuns = /* @__PURE__ */ new Map();
+  let transformTokenSeq = 0;
+  const transformWaiters = [];
+  function incFieldTransform(key) {
+    fieldTransformingSince.set(key, ssr ? 0 : Date.now());
+    fieldTransformCounts.set(key, (fieldTransformCounts.get(key) ?? 0) + 1);
+  }
+  function decFieldTransform(key) {
+    const next = (fieldTransformCounts.get(key) ?? 0) - 1;
+    if (next <= 0) {
+      fieldTransformCounts.delete(key);
+      fieldTransformingSince.delete(key);
+    } else {
+      fieldTransformCounts.set(key, next);
+    }
+  }
+  function flushSettledTransformWaiters() {
+    if (transformWaiters.length === 0) return;
+    const globalIdle = activeTransforms.value === 0;
+    for (let i = transformWaiters.length - 1; i >= 0; i--) {
+      const w = transformWaiters[i];
+      if (w === void 0) continue;
+      const idle = w.key === null ? globalIdle : (fieldTransformCounts.get(w.key) ?? 0) === 0;
+      if (idle) {
+        transformWaiters.splice(i, 1);
+        w.resolve();
+      }
+    }
+  }
+  function releaseTransformRun(key, run) {
+    if (run.released) return;
+    run.released = true;
+    run.holder.aborted = true;
+    run.holder.controller?.abort();
+    activeTransforms.value = Math.max(0, activeTransforms.value - 1);
+    decFieldTransform(key);
+  }
+  function beginTransform(key, holder) {
+    const prior = transformRuns.get(key);
+    if (prior !== void 0) releaseTransformRun(key, prior);
+    const token = ++transformTokenSeq;
+    transformRuns.set(key, { token, holder, released: false });
+    incFieldTransform(key);
+    activeTransforms.value += 1;
+    if (transformErrors.has(key)) transformErrors.delete(key);
+    return token;
+  }
+  function isCurrentTransform(key, token) {
+    return transformRuns.get(key)?.token === token;
+  }
+  function endTransform(key, token) {
+    const run = transformRuns.get(key);
+    if (run?.token === token) {
+      if (!run.released) {
+        activeTransforms.value = Math.max(0, activeTransforms.value - 1);
+        decFieldTransform(key);
+      }
+      transformRuns.delete(key);
+    }
+    flushSettledTransformWaiters();
+  }
+  function setTransformError(key, err) {
+    transformErrors.set(key, err);
+  }
+  function cancelTransforms() {
+    for (const [key, run] of [...transformRuns]) {
+      releaseTransformRun(key, run);
+      transformRuns.delete(key);
+    }
+    if (transformErrors.size > 0) transformErrors.clear();
+    flushSettledTransformWaiters();
+  }
+  function cancelTransformsUnder(prefix) {
+    for (const [key, run] of [...transformRuns]) {
+      const segs = segmentsForPathKey(key);
+      if (segs === null) continue;
+      if (!isPathPrefix(prefix, segs)) continue;
+      releaseTransformRun(key, run);
+      transformRuns.delete(key);
+      transformErrors.delete(key);
+    }
+    flushSettledTransformWaiters();
+  }
+  function settleTransforms(path) {
+    if (path === void 0) {
+      if (activeTransforms.value === 0) return Promise.resolve();
+      return new Promise((resolve) => {
+        transformWaiters.push({ key: null, resolve });
+      });
+    }
+    const { key } = canonicalizePath(path);
+    if ((fieldTransformCounts.get(key) ?? 0) === 0) return Promise.resolve();
+    return new Promise((resolve) => {
+      transformWaiters.push({ key, resolve });
+    });
   }
   const initStamp = (/* @__PURE__ */ new Date()).toISOString();
   diffAndApply({}, schemaInitialData, [], (patch) => {
@@ -3973,6 +4321,7 @@ function createFormStore(options) {
     blankPaths,
     originalBlankPaths,
     fieldValidationCounts,
+    fieldValidatingSince,
     fieldValidationState,
     schemaErrors,
     activeValidations,
@@ -4035,6 +4384,7 @@ function createFormStore(options) {
         }
       }
     }
+    if (transformRuns.size !== 0) cancelTransformsUnder(path);
     if (meta?.skipDiscriminatorReshape !== true) {
       if (path.length > 0) {
         const last = path[path.length - 1];
@@ -4240,7 +4590,7 @@ function createFormStore(options) {
       prev.controller.abort();
     }
     const controller = new AbortController();
-    const fresh = { controller, timer: null, settled: false };
+    const fresh = { controller, timer: null, settled: false, released: false };
     fieldValidationState.set(key, fresh);
     const myEpoch = ++scheduleEpoch;
     const run = () => {
@@ -4278,8 +4628,10 @@ function createFormStore(options) {
         applySchemaErrorsForSubtree(scopePath ?? [], restamped);
       }).catch(() => {
       }).finally(() => {
-        activeValidations.value = Math.max(0, activeValidations.value - 1);
-        decFieldValidation(key);
+        if (!fresh.released) {
+          activeValidations.value = Math.max(0, activeValidations.value - 1);
+          decFieldValidation(key);
+        }
         fresh.settled = true;
       });
     };
@@ -4301,6 +4653,22 @@ function createFormStore(options) {
     }
     fieldValidationState.clear();
   }
+  function cancelFieldValidationUnder(prefix) {
+    for (const [key, entry] of [...fieldValidationState]) {
+      const segs = segmentsForPathKey(key);
+      if (segs === null) continue;
+      if (!isPathPrefix(prefix, segs)) continue;
+      if (entry.timer !== null) {
+        clearTimeout(entry.timer);
+      } else if (!entry.settled && !entry.released) {
+        activeValidations.value = Math.max(0, activeValidations.value - 1);
+        decFieldValidation(key);
+        entry.released = true;
+      }
+      entry.controller.abort();
+      fieldValidationState.delete(key);
+    }
+  }
   function onFormChange(listener) {
     formChangeListeners.add(listener);
     return () => {
@@ -4351,6 +4719,8 @@ function createFormStore(options) {
     drainHooks.length = 0;
     modules.clear();
     cancelFieldValidation();
+    cancelTransforms();
+    fieldValidatingSince.clear();
     formChangeListeners.clear();
     submitSuccessListeners.clear();
     resetListeners.clear();
@@ -4486,6 +4856,7 @@ function createFormStore(options) {
     if (remaining === 0) {
       elements.delete(key);
       touchFieldRecord(key, path, { connected: false, focused: null, blurred: null });
+      if (transformRuns.size !== 0) cancelTransformsUnder(path);
     }
     return remaining;
   }
@@ -4697,16 +5068,7 @@ function createFormStore(options) {
     }
     const now = (/* @__PURE__ */ new Date()).toISOString();
     for (const [pathKey, record] of fields) {
-      fields.set(pathKey, {
-        path: record.path,
-        updatedAt: now,
-        connected: record.connected,
-        focused: record.focused,
-        blurred: record.blurred,
-        touched: false,
-        interacted: false,
-        blurredAfterInteraction: false
-      });
+      fields.set(pathKey, withClearedHistoryFlags(record, now));
     }
     submissionGeneration.value += 1;
     submitting.value = false;
@@ -4716,6 +5078,9 @@ function createFormStore(options) {
     submitError.value = null;
     departAttempts.value = 0;
     cancelFieldValidation();
+    cancelTransforms();
+    displayEngine.clear();
+    fieldValidatingSince.clear();
     pathSnapshots.clear();
     scheduleEpoch = 0;
     lastCommittedEpoch = 0;
@@ -4731,6 +5096,13 @@ function createFormStore(options) {
   function resetField(path) {
     const { key: targetKey, segments: targetSegments } = canonicalizePath(path);
     variantMemory.clearUnderPath(targetSegments);
+    cancelFieldValidationUnder(targetSegments);
+    cancelTransformsUnder(targetSegments);
+    for (const [snapKey] of [...pathSnapshots]) {
+      const segs = segmentsForPathKey(snapKey);
+      if (segs === null) continue;
+      if (isPathPrefix(targetSegments, segs)) pathSnapshots.delete(snapKey);
+    }
     const leafEntry = originals.get(targetKey);
     if (leafEntry !== void 0) {
       const wrote = setValueAtPath(targetSegments, leafEntry.value);
@@ -4780,16 +5152,7 @@ function createFormStore(options) {
   function clearFieldRecordFlags(pathKey) {
     const record = fields.get(pathKey);
     if (record === void 0) return;
-    fields.set(pathKey, {
-      path: record.path,
-      updatedAt: (/* @__PURE__ */ new Date()).toISOString(),
-      connected: record.connected,
-      focused: record.focused,
-      blurred: record.blurred,
-      touched: false,
-      interacted: false,
-      blurredAfterInteraction: false
-    });
+    fields.set(pathKey, withClearedHistoryFlags(record, (/* @__PURE__ */ new Date()).toISOString()));
   }
   function isPristineAtPath(path) {
     const { key, segments } = canonicalizePath(path);
@@ -4869,6 +5232,12 @@ function createFormStore(options) {
     pathHasAsyncValidation,
     pathHasAsyncValidationByKey,
     fieldValidationCounts,
+    fieldValidatingSince,
+    fieldTransformCounts,
+    fieldTransformingSince,
+    transformErrors,
+    activeTransforms,
+    displayEngine,
     applyFormReplacement,
     setValueAtPath,
     getValueAtPath,
@@ -4897,6 +5266,13 @@ function createFormStore(options) {
     getOriginalAtPath,
     getFirstErrorElement,
     cancelFieldValidation,
+    beginTransform,
+    isCurrentTransform,
+    endTransform,
+    setTransformError,
+    cancelTransforms,
+    cancelTransformsUnder,
+    settleTransforms,
     scheduleFieldValidation,
     onFormChange,
     onSubmitSuccess,
@@ -4953,7 +5329,7 @@ function errorsEqual(a, b) {
   }
   return true;
 }
-function diffBlankPaths$1(prev, curr) {
+function diffBlankPaths(prev, curr) {
   const added = [];
   const removed = [];
   for (const k of curr) if (!prev.has(k)) added.push(k);
@@ -5041,7 +5417,7 @@ function createHistoryModule(state, config) {
     diffAndApply(prevSnap.form, newSnap.form, [], (p) => formPatches.push(p));
     const prevBlankSet = new Set(prevSnap.blankPaths);
     const currBlankSet = new Set(newSnap.blankPaths);
-    const blankDiff = diffBlankPaths$1(prevBlankSet, currBlankSet);
+    const blankDiff = diffBlankPaths(prevBlankSet, currBlankSet);
     const delta = {
       formPatches,
       blankPathsAdded: blankDiff.added,
@@ -5108,643 +5484,6 @@ function createHistoryModule(state, config) {
   };
 }
 
-function wirePersistence(state, config) {
-  let fingerprint;
-  try {
-    fingerprint = hashStableString(state.schema.fingerprint());
-  } catch (err) {
-    if (__DEV__) {
-      console.warn(
-        `[attaform] Could not fingerprint the schema for form '${state.formKey}': ${err instanceof Error ? err.message : String(err)}. Persistence falls back to a fingerprint-free key, so a schema change won't auto-invalidate a saved draft.`
-      );
-    }
-    fingerprint = "unfingerprinted";
-  }
-  const base = resolveStorageKeyBase(config, state.formKey);
-  const key = `${base}:${fingerprint}`;
-  const debounceMs = normalizeNumericOption({
-    value: config.debounceMs ?? DEFAULT_PERSISTENCE_DEBOUNCE_MS,
-    source: "useForm.persist.debounceMs",
-    allowInfinity: false,
-    min: 0,
-    defaultValue: DEFAULT_PERSISTENCE_DEBOUNCE_MS
-  });
-  const include = config.include ?? "form";
-  const clearOnSubmitSuccess = config.clearOnSubmitSuccess ?? true;
-  const adapterPromise = getStorageAdapter(config.storage);
-  let disposed = false;
-  const isDisposed = () => disposed;
-  let inFlightFinalFlush = null;
-  let pendingOptedInPaths = null;
-  const writer = createDebouncedWriter(async () => {
-    const optedInPaths = pendingOptedInPaths ?? new Set(state.persistOptIns.optedInPaths());
-    pendingOptedInPaths = null;
-    const adapter = await adapterPromise;
-    if (isDisposed()) return;
-    if (optedInPaths.size === 0) {
-      await adapter.removeItem(key);
-      return;
-    }
-    const rawForm = toRaw(state.form.value);
-    const filteredForm = stripUnacknowledgedSensitiveLeaves(
-      pluckPaths(rawForm, optedInPaths),
-      optedInPaths,
-      state.isSensitivePath
-    );
-    const filteredSchemaErrors = filterErrorsByPaths(state.schemaErrors, optedInPaths);
-    const filteredUserErrors = filterErrorsByPaths(state.userErrors, optedInPaths);
-    const filteredTransientEmpty = /* @__PURE__ */ new Set();
-    for (const tk of state.blankPaths) {
-      if (optedInPaths.has(tk)) filteredTransientEmpty.add(tk);
-    }
-    const payload = buildPersistedPayload(
-      filteredForm,
-      include,
-      filteredSchemaErrors,
-      filteredUserErrors,
-      filteredTransientEmpty
-    );
-    await adapter.setItem(key, payload);
-  }, debounceMs);
-  const unsubscribeChange = state.onFormChange((_next, meta) => {
-    if (isDisposed() || inFlightFinalFlush !== null) return;
-    if (meta?.crossTab === true) return;
-    if (meta?.persist !== true) return;
-    pendingOptedInPaths = new Set(state.persistOptIns.optedInPaths());
-    writer.schedule();
-  });
-  const unsubscribeSuccess = clearOnSubmitSuccess ? state.onSubmitSuccess(() => {
-    if (isDisposed()) return;
-    void (async () => {
-      await writer.flush();
-      if (isDisposed()) return;
-      const adapter = await adapterPromise;
-      if (isDisposed()) return;
-      await adapter.removeItem(key);
-    })();
-  }) : () => void 0;
-  const handlePageHide = () => {
-    if (isDisposed()) return;
-    void writer.flush();
-  };
-  if (typeof window !== "undefined") {
-    window.addEventListener("pagehide", handlePageHide);
-  }
-  void (async () => {
-    const adapter = await adapterPromise;
-    if (isDisposed()) return;
-    void cleanupOrphanKeys(adapter, base, key);
-    try {
-      const raw = await adapter.getItem(key);
-      const payload = readPersistedPayload(raw);
-      if (payload === null) {
-        if (raw !== null && raw !== void 0) {
-          await adapter.removeItem(key);
-        }
-        return;
-      }
-      if (isDisposed()) return;
-      const merged = mergeSparseHydration(
-        toRaw(state.form.value),
-        payload.data.form,
-        state.schema
-      );
-      state.applyFormReplacement(merged, { hydration: true });
-      const persistedLeafPaths = collectPersistedLeafPaths(payload.data.form);
-      for (const k of persistedLeafPaths) {
-        state.blankPaths.delete(k);
-        state.originalBlankPaths.delete(k);
-      }
-      for (const k of payload.data.blankPaths ?? []) {
-        state.blankPaths.add(k);
-        state.originalBlankPaths.add(k);
-      }
-      if (include === "form+errors") {
-        if (payload.data.schemaErrors !== void 0) {
-          const flat = payload.data.schemaErrors.flatMap(([, errs]) => errs);
-          state.setAllSchemaErrors(flat);
-        }
-        if (payload.data.userErrors !== void 0) {
-          const flat = payload.data.userErrors.flatMap(([, errs]) => errs);
-          state.setAllUserErrors(flat);
-        }
-      }
-      state.scheduleFieldValidation(
-        [],
-        true
-        /* immediate */
-      );
-    } catch {
-    }
-  })();
-  async function writePathImmediately(path) {
-    if (isDisposed()) return;
-    await writer.flush();
-    if (isDisposed()) return;
-    const adapter = await adapterPromise;
-    if (isDisposed()) return;
-    const raw = await adapter.getItem(key);
-    const existing = readPersistedPayload(raw);
-    const value = getAtPath(toRaw(state.form.value), path);
-    const nextForm = setAtPath(existing?.data.form ?? {}, path, value);
-    const { key: pathKey } = canonicalizePath(path);
-    const transientSet = new Set(
-      (existing?.data.blankPaths ?? []).filter(
-        (k) => k !== pathKey && !isDescendantPathKey(k, pathKey)
-      )
-    );
-    for (const liveKey of state.blankPaths) {
-      if (liveKey === pathKey || isDescendantPathKey(liveKey, pathKey)) {
-        transientSet.add(liveKey);
-      }
-    }
-    if (include === "form") {
-      await adapter.setItem(
-        key,
-        buildPersistedPayload(nextForm, "form", /* @__PURE__ */ new Map(), /* @__PURE__ */ new Map(), transientSet)
-      );
-      return;
-    }
-    const schemaMap = new Map(existing?.data.schemaErrors ?? []);
-    const userMap = new Map(existing?.data.userErrors ?? []);
-    const currentSchema = state.schemaErrors.get(pathKey);
-    const currentUser = state.userErrors.get(pathKey);
-    if (currentSchema !== void 0 && currentSchema.length > 0) {
-      schemaMap.set(pathKey, [...currentSchema]);
-    } else {
-      schemaMap.delete(pathKey);
-    }
-    if (currentUser !== void 0 && currentUser.length > 0) {
-      userMap.set(pathKey, [...currentUser]);
-    } else {
-      userMap.delete(pathKey);
-    }
-    await adapter.setItem(
-      key,
-      buildPersistedPayload(nextForm, "form+errors", schemaMap, userMap, transientSet)
-    );
-  }
-  async function clearPersistedDraft(path) {
-    if (isDisposed()) return;
-    await writer.flush();
-    if (isDisposed()) return;
-    const adapter = await adapterPromise;
-    if (isDisposed()) return;
-    if (path === void 0) {
-      await adapter.removeItem(key);
-      return;
-    }
-    const raw = await adapter.getItem(key);
-    const existing = readPersistedPayload(raw);
-    if (existing === null) return;
-    const nextForm = deleteAtPath(existing.data.form, path);
-    if (isEmptyContainer(nextForm)) {
-      await adapter.removeItem(key);
-      return;
-    }
-    const { key: pathKey } = canonicalizePath(path);
-    const transientSet = new Set(
-      (existing.data.blankPaths ?? []).filter(
-        (k) => k !== pathKey && !isDescendantPathKey(k, pathKey)
-      )
-    );
-    if (include === "form") {
-      await adapter.setItem(
-        key,
-        buildPersistedPayload(nextForm, "form", /* @__PURE__ */ new Map(), /* @__PURE__ */ new Map(), transientSet)
-      );
-      return;
-    }
-    const schemaErrors = (existing.data.schemaErrors ?? []).filter(([k]) => k !== pathKey);
-    const userErrors = (existing.data.userErrors ?? []).filter(([k]) => k !== pathKey);
-    const schemaMap = new Map(schemaErrors.map(([k, v]) => [k, [...v]]));
-    const userMap = new Map(userErrors.map(([k, v]) => [k, [...v]]));
-    await adapter.setItem(
-      key,
-      buildPersistedPayload(nextForm, "form+errors", schemaMap, userMap, transientSet)
-    );
-  }
-  function awaitPendingWrites() {
-    if (inFlightFinalFlush !== null) return inFlightFinalFlush;
-    if (isDisposed()) return Promise.resolve();
-    return writer.flush().catch(() => void 0);
-  }
-  function dispose() {
-    if (isDisposed() || inFlightFinalFlush !== null) return;
-    unsubscribeChange();
-    unsubscribeSuccess();
-    if (typeof window !== "undefined") {
-      window.removeEventListener("pagehide", handlePageHide);
-    }
-    inFlightFinalFlush = writer.flush().catch(() => void 0).finally(() => {
-      disposed = true;
-      inFlightFinalFlush = null;
-    });
-  }
-  return {
-    wiredConfig: config,
-    writePathImmediately,
-    clearPersistedDraft,
-    awaitPendingWrites,
-    dispose
-  };
-}
-function isEmptyContainer(value) {
-  if (value === void 0 || value === null) return true;
-  if (Array.isArray(value)) return value.length === 0;
-  if (isPlainRecord(value)) return Object.keys(value).length === 0;
-  return false;
-}
-function collectPersistedLeafPaths(form) {
-  const out = [];
-  walk(form, []);
-  return out;
-  function walk(node, prefix) {
-    if (Array.isArray(node)) {
-      for (let i = 0; i < node.length; i++) {
-        walk(node[i], [...prefix, i]);
-      }
-      return;
-    }
-    if (isPlainRecord(node)) {
-      for (const key of Object.keys(node)) {
-        walk(node[key], [...prefix, key]);
-      }
-      return;
-    }
-    if (prefix.length === 0) return;
-    out.push(canonicalizePath(prefix).key);
-  }
-}
-function isDescendantPathKey(candidate, ancestor) {
-  if (candidate.length <= ancestor.length) return false;
-  if (!ancestor.endsWith("]")) return false;
-  const childPrefix = `${ancestor.slice(0, -1)},`;
-  return candidate.startsWith(childPrefix);
-}
-
-const PROTOCOL_VERSION = 1;
-const JOIN_COLLECTION_WINDOW_MS = 50;
-const SNAPSHOT_TIMEOUT_MS = 200;
-const MAX_LEADER_ATTEMPTS = 3;
-const SNAPSHOT_RESPONSE_MIN_INTERVAL_MS = 500;
-function isFileLikeValue(value) {
-  if (typeof File !== "undefined" && value instanceof File) return true;
-  if (typeof Blob !== "undefined" && value instanceof Blob) return true;
-  return false;
-}
-function isInboundShapeAcceptable(schema, path, value) {
-  if (isFileLikeValue(value)) return false;
-  let kind;
-  if (Array.isArray(value)) {
-    kind = "array";
-  } else if (value !== null && typeof value === "object" && isPlainRecord(value)) {
-    kind = "object";
-  } else {
-    kind = slimKindOf(value);
-  }
-  const accepted = schema.getSlimPrimitiveTypesAtPath(path);
-  if (!accepted.has(kind)) return false;
-  if (Array.isArray(value)) {
-    for (let i = 0; i < value.length; i++) {
-      if (!isInboundShapeAcceptable(schema, [...path, i], value[i])) return false;
-    }
-    return true;
-  }
-  if (isPlainRecord(value)) {
-    for (const key of Object.keys(value)) {
-      if (!isInboundShapeAcceptable(schema, [...path, key], value[key])) return false;
-    }
-    return true;
-  }
-  return true;
-}
-function diffBlankPaths(prev, curr) {
-  const added = [];
-  const removed = [];
-  const prevSet = new Set(prev);
-  for (const k of curr) if (!prevSet.has(k)) added.push(k);
-  for (const k of prev) if (!curr.has(k)) removed.push(k);
-  return { added, removed };
-}
-function snapshotForm(form) {
-  return structuralSnapshot(form);
-}
-function stripSensitivePathsDeep(value, pathSoFar, isSensitivePath) {
-  if (isFileLikeValue(value)) return void 0;
-  if (value === null || typeof value !== "object") return value;
-  if (Array.isArray(value)) {
-    return value.map((item, i) => stripSensitivePathsDeep(item, [...pathSoFar, i], isSensitivePath));
-  }
-  const proto = Object.getPrototypeOf(value);
-  if (proto !== Object.prototype && proto !== null) return value;
-  const out = {};
-  const src = value;
-  for (const key of Object.keys(src)) {
-    const childPath = [...pathSoFar, key];
-    if (isSensitivePath(childPath)) {
-      safeAssign(out, key, void 0);
-      continue;
-    }
-    safeAssign(out, key, stripSensitivePathsDeep(src[key], childPath, isSensitivePath));
-  }
-  return out;
-}
-function isStringArray(value) {
-  return Array.isArray(value) && value.every((item) => typeof item === "string");
-}
-function isPatchArray(value) {
-  return Array.isArray(value) && value.every(
-    (p) => p !== null && typeof p === "object" && Array.isArray(p.path)
-  );
-}
-function isValidSyncMessage(data) {
-  if (data === null || typeof data !== "object") return false;
-  const m = data;
-  if (m["v"] !== PROTOCOL_VERSION) return false;
-  if (typeof m["senderId"] !== "string") return false;
-  if (typeof m["kind"] !== "string") return false;
-  switch (m["kind"]) {
-    case "hello":
-    case "announce":
-      return true;
-    case "requestSnapshot":
-      return typeof m["targetId"] === "string";
-    case "snapshot":
-      return isStringArray(m["blankPaths"]) && "form" in m;
-    case "patches":
-      return isPatchArray(m["formPatches"]) && isStringArray(m["blankPathsAdded"]) && isStringArray(m["blankPathsRemoved"]);
-    default:
-      return false;
-  }
-}
-function generateSenderId() {
-  try {
-    return globalThis.crypto.randomUUID();
-  } catch {
-    return `atta-${Math.random().toString(36).slice(2)}-${Date.now().toString(36)}`;
-  }
-}
-function createMultiTabSyncModule(state, channelName, options) {
-  if (typeof BroadcastChannel === "undefined") {
-    return {
-      dispose: () => void 0,
-      lifecycle: () => "established",
-      senderId: "",
-      channelName
-    };
-  }
-  let channel;
-  try {
-    channel = new BroadcastChannel(channelName);
-  } catch {
-    return {
-      dispose: () => void 0,
-      lifecycle: () => "established",
-      senderId: "",
-      channelName
-    };
-  }
-  const senderId = generateSenderId();
-  let lifecycle = "joining";
-  let disposed = false;
-  const peerIds = /* @__PURE__ */ new Set();
-  const lastSnapshotResponseAt = /* @__PURE__ */ new Map();
-  let joinCollectionTimer = null;
-  let snapshotTimeoutTimer = null;
-  let leaderAttempts = 0;
-  let prior = {
-    form: snapshotForm(state.form.value),
-    blankPathsSnapshot: [...state.blankPaths]
-  };
-  function safePost(msg) {
-    if (disposed) return;
-    try {
-      channel.postMessage(msg);
-    } catch {
-    }
-  }
-  function refreshPrior() {
-    prior = {
-      form: snapshotForm(state.form.value),
-      blankPathsSnapshot: [...state.blankPaths]
-    };
-  }
-  function isPathLocallySuppressed(path) {
-    if (options.isSensitivePath(path)) return true;
-    const { key } = canonicalizePath([...path]);
-    if (options.noSyncPaths.has(key)) return true;
-    return false;
-  }
-  function postPatches() {
-    if (lifecycle !== "established") return;
-    const next = snapshotForm(state.form.value);
-    const rawPatches = [];
-    diffAndApply(prior.form, next, [], (p) => rawPatches.push(p));
-    const safePatches = [];
-    for (const p of rawPatches) {
-      if (isPathLocallySuppressed(p.path)) continue;
-      if ("value" in p && isFileLikeValue(p.value)) continue;
-      safePatches.push(p);
-    }
-    const { added, removed } = diffBlankPaths(prior.blankPathsSnapshot, state.blankPaths);
-    if (safePatches.length === 0 && added.length === 0 && removed.length === 0) {
-      prior = { form: next, blankPathsSnapshot: [...state.blankPaths] };
-      return;
-    }
-    safePost({
-      v: PROTOCOL_VERSION,
-      kind: "patches",
-      senderId,
-      formPatches: safePatches,
-      blankPathsAdded: added,
-      blankPathsRemoved: removed
-    });
-    prior = { form: next, blankPathsSnapshot: [...state.blankPaths] };
-  }
-  const unsubscribeChange = state.onFormChange((_next, meta) => {
-    if (disposed) return;
-    if (lifecycle !== "established") return;
-    if (meta?.crossTab === true) return;
-    if (meta?.hydration === true) {
-      refreshPrior();
-      return;
-    }
-    postPatches();
-  });
-  function applyIncomingForm(form, blankPaths) {
-    state.blankPaths.clear();
-    for (const k of blankPaths) state.blankPaths.add(k);
-    state.applyFormReplacement(form, { crossTab: true, persist: false });
-    refreshPrior();
-  }
-  function handlePatches(msg) {
-    if (lifecycle !== "established") return;
-    const safePatches = [];
-    for (const p of msg.formPatches) {
-      if (!Array.isArray(p.path)) continue;
-      if (isPathLocallySuppressed(p.path)) continue;
-      if ("value" in p && !isInboundShapeAcceptable(state.schema, p.path, p.value)) {
-        continue;
-      }
-      safePatches.push(p);
-    }
-    const safeBlankAdded = [];
-    for (const k of msg.blankPathsAdded) {
-      const segs = canonicalizePath(k).segments;
-      if (isPathLocallySuppressed(segs)) continue;
-      safeBlankAdded.push(k);
-    }
-    const safeBlankRemoved = [];
-    for (const k of msg.blankPathsRemoved) {
-      const segs = canonicalizePath(k).segments;
-      if (isPathLocallySuppressed(segs)) continue;
-      safeBlankRemoved.push(k);
-    }
-    if (safePatches.length === 0 && safeBlankAdded.length === 0 && safeBlankRemoved.length === 0) {
-      return;
-    }
-    const candidate = applyPatchesForward(state.form.value, safePatches);
-    try {
-      options.validateForm(state.form.value);
-      try {
-        options.validateForm(candidate);
-      } catch {
-        return;
-      }
-    } catch {
-    }
-    const nextBlankPaths = new Set(state.blankPaths);
-    for (const k of safeBlankRemoved) nextBlankPaths.delete(k);
-    for (const k of safeBlankAdded) nextBlankPaths.add(k);
-    applyIncomingForm(candidate, [...nextBlankPaths]);
-  }
-  function handleSnapshot(msg) {
-    if (lifecycle !== "joining") return;
-    if (!isInboundShapeAcceptable(state.schema, [], msg.form)) return;
-    if (snapshotTimeoutTimer !== null) {
-      clearTimeout(snapshotTimeoutTimer);
-      snapshotTimeoutTimer = null;
-    }
-    if (joinCollectionTimer !== null) {
-      clearTimeout(joinCollectionTimer);
-      joinCollectionTimer = null;
-    }
-    applyIncomingForm(msg.form, msg.blankPaths);
-    lifecycle = "established";
-    peerIds.clear();
-  }
-  function respondToHello() {
-    safePost({ v: PROTOCOL_VERSION, kind: "announce", senderId });
-  }
-  function respondToSnapshotRequest(requesterId) {
-    const now = Date.now();
-    const last = lastSnapshotResponseAt.get(requesterId);
-    if (last !== void 0 && now - last < SNAPSHOT_RESPONSE_MIN_INTERVAL_MS) return;
-    lastSnapshotResponseAt.set(requesterId, now);
-    const scrubbedForm = stripSensitivePathsDeep(state.form.value, [], options.isSensitivePath);
-    safePost({
-      v: PROTOCOL_VERSION,
-      kind: "snapshot",
-      senderId,
-      form: scrubbedForm,
-      blankPaths: [...state.blankPaths]
-    });
-  }
-  channel.onmessage = (event) => {
-    if (disposed) return;
-    try {
-      const data = event.data;
-      if (!isValidSyncMessage(data)) return;
-      const msg = data;
-      if (msg.senderId === senderId) return;
-      switch (msg.kind) {
-        case "hello":
-          if (lifecycle !== "established") return;
-          respondToHello();
-          break;
-        case "announce":
-          if (lifecycle === "joining") peerIds.add(msg.senderId);
-          break;
-        case "requestSnapshot":
-          if (lifecycle !== "established") return;
-          if (msg.targetId !== senderId) return;
-          respondToSnapshotRequest(msg.senderId);
-          break;
-        case "snapshot":
-          handleSnapshot(msg);
-          break;
-        case "patches":
-          handlePatches(msg);
-          break;
-      }
-    } catch {
-    }
-  };
-  function electLeaderAndRequest() {
-    if (disposed) return;
-    if (peerIds.size === 0) {
-      lifecycle = "established";
-      refreshPrior();
-      return;
-    }
-    const sorted = [...peerIds].sort();
-    const leaderId = sorted[0];
-    peerIds.delete(leaderId);
-    leaderAttempts++;
-    safePost({
-      v: PROTOCOL_VERSION,
-      kind: "requestSnapshot",
-      senderId,
-      targetId: leaderId
-    });
-    snapshotTimeoutTimer = setTimeout(() => {
-      snapshotTimeoutTimer = null;
-      if (disposed) return;
-      if (lifecycle === "established") return;
-      if (leaderAttempts >= MAX_LEADER_ATTEMPTS || peerIds.size === 0) {
-        lifecycle = "established";
-        refreshPrior();
-        return;
-      }
-      electLeaderAndRequest();
-    }, SNAPSHOT_TIMEOUT_MS);
-  }
-  function joinFlow() {
-    safePost({ v: PROTOCOL_VERSION, kind: "hello", senderId });
-    joinCollectionTimer = setTimeout(() => {
-      joinCollectionTimer = null;
-      if (disposed) return;
-      if (lifecycle === "established") return;
-      electLeaderAndRequest();
-    }, JOIN_COLLECTION_WINDOW_MS);
-  }
-  joinFlow();
-  return {
-    dispose: () => {
-      if (disposed) return;
-      disposed = true;
-      if (joinCollectionTimer !== null) {
-        clearTimeout(joinCollectionTimer);
-        joinCollectionTimer = null;
-      }
-      if (snapshotTimeoutTimer !== null) {
-        clearTimeout(snapshotTimeoutTimer);
-        snapshotTimeoutTimer = null;
-      }
-      unsubscribeChange();
-      try {
-        channel.close();
-      } catch {
-      }
-    },
-    lifecycle: () => lifecycle,
-    senderId,
-    channelName
-  };
-}
-const MULTI_TAB_SYNC_MODULE_KEY = "multiTabSync";
-
 const warned = /* @__PURE__ */ new Set();
 function warnOnceInsecureContext(feature) {
   if (!__DEV__) return;
@@ -5804,8 +5543,10 @@ function useAbstractForm(configuration, options) {
   }
   const existing = registry.forms.get(key);
   if (__DEV__ && existing !== void 0) {
-    warnOnSchemaFingerprintMismatch(key, existing.schema, resolvedSchema);
-    warnOnPersistDivergence(key, existing, configuration.persist);
+    void import('../chunks/dev-key-collision-warnings.mjs').then((m) => {
+      void m.warnOnSchemaFingerprintMismatch(key, existing.schema, resolvedSchema);
+      m.warnOnPersistDivergence(key, existing, configuration.persist);
+    });
   }
   const hadPendingHydration = registry.pendingHydration.has(key);
   const state = existing ?? buildFreshState(key, resolvedSchema, merged, registry);
@@ -5846,10 +5587,33 @@ function useAbstractForm(configuration, options) {
       } else {
         const persistenceBase = resolveStorageKeyBase(resolvedPersist, state.formKey);
         void sweepNonConfiguredStandardStoresForOrphans(resolvedPersist.storage, persistenceBase);
-        const persistenceModule = wirePersistence(state, resolvedPersist);
-        state.modules.set(PERSISTENCE_MODULE_KEY, persistenceModule);
-        state.registerDrain(() => persistenceModule.awaitPendingWrites());
-        state.registerCleanup(() => persistenceModule.dispose());
+        const adapterPromise = getStorageAdapter(resolvedPersist.storage);
+        let persistDisposed = false;
+        state.registerCleanup(() => {
+          persistDisposed = true;
+        });
+        const ready = (async () => {
+          try {
+            const [{ wirePersistence }, fingerprintToken] = await Promise.all([
+              import('../chunks/wire-persistence.mjs'),
+              resolvePersistFingerprintToken(state)
+            ]);
+            if (persistDisposed) return void 0;
+            const persistenceModule = wirePersistence(
+              state,
+              resolvedPersist,
+              adapterPromise,
+              fingerprintToken
+            );
+            state.registerDrain(() => persistenceModule.awaitPendingWrites());
+            state.registerCleanup(() => persistenceModule.dispose());
+            return persistenceModule;
+          } catch {
+            return void 0;
+          }
+        })();
+        const persistenceHandle = { config: resolvedPersist, ready };
+        state.modules.set(PERSISTENCE_MODULE_KEY, persistenceHandle);
       }
     } else {
       void sweepAllOrphansAcrossStandardStores(`${PERSISTENCE_KEY_PREFIX}${state.formKey}`);
@@ -5859,27 +5623,31 @@ function useAbstractForm(configuration, options) {
     const hasBroadcastChannel = typeof BroadcastChannel !== "undefined";
     const secureContext = isSecureContext();
     if (hasBroadcastChannel && secureContext) {
-      let channelName;
-      try {
-        channelName = `attaform:sync:${state.formKey}:${hashStableString(state.schema.fingerprint())}`;
-      } catch {
-        channelName = null;
-      }
-      if (channelName !== null) {
-        const syncModule = createMultiTabSyncModule(state, channelName, {
-          isSensitivePath: state.isSensitivePath,
-          noSyncPaths: state.noSyncPaths,
-          validateForm: (form) => {
-            const result = state.schema.validateAtPath(form, void 0, { sync: true });
-            if (result instanceof Promise) return;
-            if (!result.success) {
-              throw new Error("attaform multi-tab sync: post-apply schema validation failed");
+      let formDisposed = false;
+      state.registerCleanup(() => {
+        formDisposed = true;
+      });
+      void (async () => {
+        try {
+          const [{ createMultiTabSyncModule, MULTI_TAB_SYNC_MODULE_KEY }, fingerprint] = await Promise.all([import('../chunks/multi-tab-sync.mjs'), state.schema.fingerprint()]);
+          if (formDisposed) return;
+          const channelName = `attaform:sync:${state.formKey}:${hashStableString(fingerprint)}`;
+          const syncModule = createMultiTabSyncModule(state, channelName, {
+            isSensitivePath: state.isSensitivePath,
+            noSyncPaths: state.noSyncPaths,
+            validateForm: (form) => {
+              const result = state.schema.validateAtPath(form, void 0, { sync: true });
+              if (result instanceof Promise) return;
+              if (!result.success) {
+                throw new Error("attaform multi-tab sync: post-apply schema validation failed");
+              }
             }
-          }
-        });
-        state.modules.set(MULTI_TAB_SYNC_MODULE_KEY, syncModule);
-        state.registerCleanup(() => syncModule.dispose());
-      }
+          });
+          state.modules.set(MULTI_TAB_SYNC_MODULE_KEY, syncModule);
+          state.registerCleanup(() => syncModule.dispose());
+        } catch {
+        }
+      })();
     } else if (hasBroadcastChannel && !secureContext) {
       warnOnceInsecureContext("multiTab");
     }
@@ -6040,55 +5808,17 @@ function resolveFormKey(key) {
   }
   return `${ANONYMOUS_FORM_KEY_PREFIX}${anonCounter++}`;
 }
-function warnOnSchemaFingerprintMismatch(key, existing, incoming) {
-  let existingFp;
-  let incomingFp;
+async function resolvePersistFingerprintToken(state) {
   try {
-    existingFp = existing.fingerprint();
-    incomingFp = incoming.fingerprint();
-  } catch (error) {
-    console.error(
-      `[attaform] fingerprint() threw for key "${key}"; skipping mismatch check.`,
-      error
-    );
-    return;
-  }
-  if (existingFp === incomingFp) return;
-  console.warn(
-    `[attaform] useForm() calls with key "${key}" use different schemas; first wins, second is ignored. Use identical schemas or unique keys.
-  existing: ${existingFp}
-  incoming: ${incomingFp}`
-  );
-}
-function warnOnPersistDivergence(key, existing, incomingPersist) {
-  if (incomingPersist === void 0) return;
-  const wired = existing.modules.get(PERSISTENCE_MODULE_KEY);
-  const incomingNormalized = normalizePersistConfig(incomingPersist);
-  if (wired === void 0) {
-    console.warn(
-      `[attaform] useForm({ key: "${key}" }) passed a persist config but the first useForm({ key }) call didn't wire persistence; the new config is silently dropped. Pass persist on the first call, or remove persist here to make the inheritance explicit.`
-    );
-    return;
+    return hashStableString(await state.schema.fingerprint());
+  } catch (err) {
+    if (__DEV__) {
+      console.warn(
+        `[attaform] Could not fingerprint the schema for form '${state.formKey}': ${err instanceof Error ? err.message : String(err)}. Persistence falls back to a fingerprint-free key, so a schema change won't auto-invalidate a saved draft.`
+      );
+    }
+    return "unfingerprinted";
   }
-  if (persistConfigsEquivalent(wired.wiredConfig, incomingNormalized)) return;
-  console.warn(
-    `[attaform] useForm({ key: "${key}" }) passed a persist config that differs from the first useForm({ key }) call's; first wins, this one is ignored.
-  wired:    ${describePersist(wired.wiredConfig)}
-  incoming: ${describePersist(incomingNormalized)}`
-  );
-}
-function persistConfigsEquivalent(a, b) {
-  if (a.storage !== b.storage) return false;
-  if ((a.key ?? void 0) !== (b.key ?? void 0)) return false;
-  if ((a.debounceMs ?? void 0) !== (b.debounceMs ?? void 0)) return false;
-  return true;
-}
-function describePersist(config) {
-  const storage = typeof config.storage === "string" ? config.storage : "custom-adapter";
-  const parts = [`storage=${storage}`];
-  if (config.key !== void 0) parts.push(`key=${config.key}`);
-  if (config.debounceMs !== void 0) parts.push(`debounceMs=${config.debounceMs}`);
-  return `{ ${parts.join(", ")} }`;
 }
 const warnedAnonPersistKeys = /* @__PURE__ */ new Set();
 function enforceAnonPersistRule(formKey, ssr) {
@@ -6185,6 +5915,8 @@ function isLazyMarker(value) {
 }
 
 const NOOP_WIZARD_HISTORY = {
+  push() {
+  },
   replace() {
   },
   read() {
@@ -6199,6 +5931,9 @@ function createWizardHistory(param) {
   if (typeof window === "undefined") return NOOP_WIZARD_HISTORY;
   const subscribers = [];
   let disposed = false;
+  function currentKey() {
+    return new URL(window.location.href).searchParams.get(param) ?? void 0;
+  }
   function buildUrl(key) {
     const url = new URL(window.location.href);
     url.searchParams.set(param, key);
@@ -6206,25 +5941,29 @@ function createWizardHistory(param) {
   }
   function handlePopstate() {
     if (disposed) return;
-    const url = new URL(window.location.href);
-    const value = url.searchParams.get(param) ?? void 0;
+    const value = currentKey();
     for (const subscriber of subscribers) subscriber(value);
   }
   window.addEventListener("popstate", handlePopstate);
-  function safeReplaceState(key) {
+  function safeWrite(key, mode) {
     try {
-      window.history.replaceState({}, "", buildUrl(key));
+      if (mode === "push") window.history.pushState({}, "", buildUrl(key));
+      else window.history.replaceState({}, "", buildUrl(key));
     } catch {
     }
   }
   return {
+    push(key) {
+      if (disposed) return;
+      if (currentKey() === key) return;
+      safeWrite(key, "push");
+    },
     replace(key) {
       if (disposed) return;
-      safeReplaceState(key);
+      safeWrite(key, "replace");
     },
     read() {
-      const url = new URL(window.location.href);
-      return url.searchParams.get(param) ?? void 0;
+      return currentKey();
     },
     subscribe(callback) {
       if (disposed) return;
@@ -6256,12 +5995,13 @@ function buildNoopWizardSchema(formKey) {
     formKey
   };
   return {
-    fingerprint: () => NOOP_FINGERPRINT,
+    fingerprint: () => Promise.resolve(NOOP_FINGERPRINT),
     getDefaultValues: () => defaultsResponse,
     getDefaultAtPath: () => void 0,
     getEmptyValueAtPath: () => void 0,
     isPreprocessOrCoerceLeaf: () => false,
     arrayShapeAtPath: () => void 0,
+    isFixedObjectAtPath: (path) => path.length === 0,
     getSchemasAtPath: () => [],
     validateAtPath: () => success,
     getSlimPrimitiveTypesAtPath: () => new Set(EMPTY_SLIM_KINDS),
@@ -6715,7 +6455,10 @@ function useWizard(options) {
   };
   const persistCallback = options.persist === false ? void 0 : options.persist !== void 0 ? options.persist : (state) => {
     if (state.step === void 0) return;
-    historyHandle.replace(state.step);
+    const current = historyHandle.read();
+    const effectiveCurrent = current !== void 0 && isCompiledKey(current) ? current : firstKey();
+    if (state.step === effectiveCurrent) historyHandle.replace(state.step);
+    else historyHandle.push(state.step);
   };
   function isCompiledKey(key) {
     const list = compiledSteps.value;
@@ -6796,6 +6539,7 @@ function useWizard(options) {
   }
   const submitting = ref(false);
   const submissionAttempts = ref(0);
+  const submitError = ref(null);
   const done = ref(false);
   function activateForm(form) {
     const source = asSubmissionSource(form);
@@ -6923,7 +6667,7 @@ function useWizard(options) {
         formKey: form.key
       };
     }
-    return full.process();
+    return full.parse();
   }
   function collectErrors(results) {
     const out = [];
@@ -6954,6 +6698,7 @@ function useWizard(options) {
         return;
       }
       submitting.value = true;
+      submitError.value = null;
       try {
         const currentKey = activeKey.value;
         const final = isFinalStep.value;
@@ -6962,18 +6707,24 @@ function useWizard(options) {
         if (final) {
           await Promise.all(
             list.map(async (step) => {
+              registry.forms.get(step.key)?.clearUserErrors();
               const result = await processOne(step.form);
               results.set(step.key, result);
             })
           );
         } else {
           const active = activeForm.value;
+          registry.forms.get(active.key)?.clearUserErrors();
           const result = await processOne(active);
           results.set(active.key, result);
         }
         for (const key of results.keys()) {
           const store = registry.forms.get(key);
-          if (store !== void 0) store.submissionAttempts.value += 1;
+          if (store !== void 0) {
+            store.submissionAttempts.value += 1;
+            store.cancelFieldValidation();
+            store.displayEngine.clear();
+          }
         }
         submissionAttempts.value += 1;
         const errors = collectErrors(results);
@@ -6998,7 +6749,6 @@ function useWizard(options) {
             if (target !== void 0) moveTo(target.key);
           }
         } else {
-          if (onError !== void 0) await onError(errors);
           if (options.focusFirstError !== false) {
             const firstFailedKey = errors[0]?.formKey;
             if (firstFailedKey !== void 0 && isCompiledKey(firstFailedKey)) {
@@ -7013,7 +6763,16 @@ function useWizard(options) {
               }
             }
           }
+          if (onError !== void 0) {
+            try {
+              await onError(errors);
+            } catch (cause) {
+              throw new SubmitErrorHandlerError("User-provided onError threw", { cause });
+            }
+          }
         }
+      } catch (err) {
+        submitError.value = toError(err);
       } finally {
         submitting.value = false;
       }
@@ -7022,6 +6781,7 @@ function useWizard(options) {
   function reset() {
     submissionAttempts.value = 0;
     done.value = false;
+    submitError.value = null;
     lazyEpoch.value += 1;
     for (const step of compiledSteps.value) {
       const full = asSubmissionSource(step.form);
@@ -7097,6 +6857,9 @@ function useWizard(options) {
     get submissionAttempts() {
       return submissionAttempts.value;
     },
+    get submitError() {
+      return submitError.value;
+    },
     get visited() {
       return visited.value;
     }
@@ -7206,5 +6969,5 @@ function warnIfAmbientWizardProviderHadDuplicates() {
   }
 }
 
-export { AttaformErrorCode as A, defaultDisplayState as a, defineCoercion as b, injectWizard as c, defaultCoercionRules as d, isPlainRecord as e, isUnset as f, getAtPath as g, humanize as h, injectForm as i, safeOwnRead as j, setAtPath as k, lazy as l, slimKindOf as m, normalizeNumericOption as n, useAbstractForm as o, useWizard as p, safeAssign as s, unset as u };
-//# sourceMappingURL=attaform.tiWEVznj.mjs.map
+export { AttaformErrorCode as A, useAbstractForm as B, useWizard as C, DEFAULT_PERSISTENCE_DEBOUNCE_MS as D, PERSISTENCE_MODULE_KEY as P, DEFAULT_TIMINGS as a, applyPatchesForward as b, cleanupOrphanKeys as c, defaultCoercionRules as d, defaultDisplayState as e, defineCoercion as f, deleteAtPath as g, diffAndApply as h, getAtPath as i, humanize as j, injectForm as k, injectWizard as l, isPlainRecord as m, isUnset as n, lazy as o, makeDefaultDisplayState as p, mergeSparseHydration as q, normalizeNumericOption as r, normalizePersistConfig as s, resolveStorageKeyBase as t, safeAssign as u, safeOwnRead as v, setAtPath as w, slimKindOf as x, structuralSnapshot as y, unset as z };
+//# sourceMappingURL=attaform.DR6RmxWZ.mjs.map