attaform 0.30.0 → 0.30.1

package/dist/shared/{attaform.DNJOWjQw.mjs → attaform.BIWicztt.mjs}

@@ -1,12 +1,12 @@
 import { computed, readonly, toRaw, ref, watchEffect, getCurrentScope, onScopeDispose, shallowReadonly, reactive, shallowReactive, shallowRef, toValue, watch, triggerRef, getCurrentInstance, onServerPrefetch, provide, useId, inject, onBeforeMount, onBeforeUpdate, onMounted, effectScope, nextTick } from 'vue';
 import { e as ensureAttaformInstalled, u as useRegistry, d as kFormContext, f as kFormInstanceId, b as kAttaformWizardActiveStepResolver, i as kAttaformAncestorWizard } from './attaform.WiGdIqgx.mjs';
-import { c as armDomBinding } from './attaform.B3resMQ1.mjs';
+import { c as armDomBinding } from './attaform.D_f1WgYf.mjs';
 import { R as REGISTER_OWNER_MARKER, b as V_REGISTER_MARKER } from './attaform.KvlEedlF.mjs';
-import { A as ANONYMOUS_FORM_KEY_PREFIX, i as isShadowedKey, d as safeOwnHas, a as safeOwnRead, e as consumerHas, f as spreadConsumerRecord, g as copyConsumerArray, r as readConsumerIndex, b as safeAssign, h as consumerKeys, j as readConsumerProp, k as diffAndApply, p as pickDefined, s as structuralSnapshot, n as normalizeNumericOption, l as DEFAULT_FIELD_VALIDATION_DEBOUNCE_MS, m as consumerSymbolKeys, o as applyChangedKeys, R as RESERVED_KEY_PREFIX, q as DEFAULT_MAX_RECURSION_DEPTH, t as ANONYMOUS_WIZARD_KEY_PREFIX } from './attaform.BRDDQeHV.mjs';
+import { A as ANONYMOUS_FORM_KEY_PREFIX, i as isShadowedKey, d as safeOwnHas, a as safeOwnRead, e as consumerHas, f as spreadConsumerRecord, g as copyConsumerArray, r as readConsumerIndex, b as safeAssign, h as consumerKeys, j as readConsumerProp, k as diffAndApply, p as pickDefined, s as structuralSnapshot, n as normalizeNumericOption, l as DEFAULT_FIELD_VALIDATION_DEBOUNCE_MS, m as consumerSymbolKeys, o as applyChangedKeys, R as RESERVED_KEY_PREFIX, q as DEFAULT_MAX_RECURSION_DEPTH, c as callConsumerFn, t as ANONYMOUS_WIZARD_KEY_PREFIX } from './attaform.8mfKZCwH.mjs';
 import { i as isPathPrefix, e as canonicalizePath, k as keyForSegments, m as mapSegmentKeys, b as ROOT_PATH_KEY, s as segmentsForPathKey, S as SubmitErrorHandlerError, t as toError, j as groupErrorsByKey, n as normalizeErrorInput, h as SET_MEMBER_SEGMENT, R as ROOT_PATH, l as normalizeErrorInputs, a as InvalidUseFormConfigError, d as ReservedFormKeyError } from './attaform.CdZIEf7_.mjs';
 
 const AttaformErrorCode = {
-  /** A required field is in the blank set — user hasn't supplied a value. */
+  /** A required field is in the blank set: no value was supplied. */
   NoValueSupplied: "atta:no-value-supplied",
   /** The schema adapter's `validateAtPath` threw synchronously. */
   AdapterThrew: "atta:adapter-threw",
@@ -566,9 +566,8 @@ function buildLeafFieldStateBase(state, segments, key, formInstanceId) {
     updatedAt: record?.updatedAt ?? null,
     errors,
     // A leaf has no descendants, so its own-bucket errors ARE its subtree
-    // errors. Reuse the same array reference: referential `ownErrors ===
-    // errors`, and no second read of the whole-form `derivedBlankErrors`
-    // map (preserves the P3 blank-reactivity optimization above).
+    // errors. Reuse the array reference, which makes `ownErrors === errors`
+    // and avoids a second read of the whole-form `derivedBlankErrors` map.
     ownErrors: errors,
     validating,
     valid,
@@ -748,19 +747,19 @@ function buildContainerFieldStateBase(state, segments, key, formInstanceId) {
       elements: EMPTY_ELEMENTS,
       updatedAt,
       errors,
-      // The container's OWN bucket only (this exact path), excluding every
-      // descendant that `errors` rolls up: a cross-field `.refine()` here,
-      // or `setErrors` pinned at this node. The same raw union the leaf
-      // builds from the three stores; the container already depends on all
-      // three via `aggregateErrorsAt`, so there's no new reactivity cost.
+      // The container's OWN bucket at this exact path, excluding every
+      // descendant `errors` rolls up: a cross-field `.refine()` here, or a
+      // `setErrors` pinned at this node. The same raw union the leaf builds
+      // from the three stores, and the container already depends on all three
+      // through `aggregateErrorsAt`, so it costs no new reactivity.
       ownErrors: state.getErrorsForPath(segments),
       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.
+      // A container surfaces its OWN transform failure, from a transform
+      // registered on the container path such as a file normalizer, and never
+      // rolls up a descendant's: that stays a per-field channel.
       transformError: ownTransformError,
       path: segments,
       ...computeFieldIdentity(formInstanceId, state.formKey, key),
@@ -1092,9 +1091,9 @@ function buildErrorsSurface(state, sweep) {
     // non-schema keys reachable while a genuinely-absent key stays out.
     hasOwn: (segments, key) => liveContainerHasKey(state, segments, key) || errorAwareContainerKeys(state, segments).includes(key),
     isArrayAt: (segments) => isArrayPath(state, segments),
-    // `errors()` / `errors([])` / `errors(path)` are all the subtree
-    // aggregate — the same helper `meta.errors` reads, so the surfaces
-    // never drift.
+    // `errors()`, `errors([])` and `errors(path)` are all the subtree
+    // aggregate, through the helper `meta.errors` reads, so they cannot
+    // drift.
     call: (path) => aggregateErrorsAt(state, path, keyForSegments(path).key),
     surface: "form.errors",
     sweep
@@ -2294,7 +2293,7 @@ function buildRegister(state, formInstanceId, instanceConfig) {
         const accepted = isBlankSignal ? markBlank() : state.setValueAtPath(segments, value, withInstanceMeta(void 0));
         return accepted;
       },
-      // Called by the `vRegisterHint` compile-time transform's wrapping
+      // Called by the `vRegisterHintTransform` compile-time transform's wrapping
       // IIFE on every server-side render of `<element v-register="…">`.
       // Without it, every SSR'd FieldState serialises `connected: false`
       // (because Vue skips directive lifecycle during SSR) and the client
@@ -2323,12 +2322,12 @@ function buildRegister(state, formInstanceId, instanceConfig) {
         }
         return false;
       },
-      // --- 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. ---
+      // --- 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 and counter machinery,
+      // the same pattern as `markBlank` and `setValueWithInternalPath`, so
+      // the directive (which holds this RegisterValue and 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),
@@ -2341,10 +2340,10 @@ function buildRegister(state, formInstanceId, instanceConfig) {
         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
-      // fixtures or downstream code can't mutate the canonical
-      // segment list out from under the directive.
+      // Frozen so a wrapper component can pass `rv.segments` straight to
+      // `form.fields(...)` with no defensive copy, and so neither a test
+      // fixture nor downstream code can mutate the canonical segment list
+      // out from under the directive.
       segments: Object.freeze(segments.slice()),
       formKey: state.formKey,
       formInstanceId,
@@ -2550,15 +2549,15 @@ function buildMetaProxy(keys, read) {
   return new Proxy(target, {
     get: (_, key) => owns.has(key) ? read(key) : Reflect.get(target, key),
     has: (_, key) => owns.has(key) || Reflect.has(target, key),
-    // Safe to hand back the same array every time: the spec copies a
-    // trap's key list before using it.
+    // Safe to hand back the same array every time: the spec copies a trap's
+    // key list before using it.
     ownKeys: () => keys,
     getOwnPropertyDescriptor(_, key) {
       if (!owns.has(key)) return Reflect.getOwnPropertyDescriptor(target, key);
       return { configurable: true, enumerable: true, value: read(key), writable: false };
     },
-    // A getter with no setter throws on assignment under strict mode,
-    // which every module here is. `false` keeps that.
+    // A getter with no setter throws on assignment under strict mode, which
+    // every module here is; `false` keeps that.
     set: denyWrite,
     deleteProperty: denyWrite,
     defineProperty: denyWrite
@@ -2794,12 +2793,11 @@ function buildFormApi(state, formInstanceId, options = {}) {
   );
   const rootFieldState = getRootFieldStateAt([]);
   const metaOwn = {
-    // Whole-form work signals compose the LIFECYCLE counters with the
-    // per-leaf rollup: a submit-time validate shows up as
-    // activeValidations, per-field debounced validators as
-    // fieldValidationCounts — either flips the flag. `valid` keeps the
-    // form-level `firstValidationDone` mount gate; `errors` is the
-    // unfiltered whole-form aggregate.
+    // Whole-form work signals compose the LIFECYCLE counters with the per-leaf
+    // rollup: a submit-time validate shows up in `activeValidations` and a
+    // per-field debounced validator in `fieldValidationCounts`, and either
+    // flips the flag. `valid` keeps the form-level mount gate, and `errors` is
+    // the unfiltered whole-form aggregate.
     validating: computed(
       () => state.activeValidations.value > 0 || rootFieldState.value.validating
     ),
@@ -2811,7 +2809,7 @@ function buildFormApi(state, formInstanceId, options = {}) {
     busy: computed(
       () => state.activeValidations.value > 0 || state.activeTransforms.value > 0 || rootFieldState.value.validating || rootFieldState.value.transforming
     ),
-    // Lifecycle (form-level only — not on FieldState).
+    // Lifecycle, form-level only and never on FieldState.
     submitting,
     submissionAttempts,
     departAttempts,
@@ -2928,10 +2926,10 @@ function buildFormApi(state, formInstanceId, options = {}) {
   }
   const api = {
     handleSubmit: gated(handleSubmit),
-    // Callable readonly Proxies (`values`, `fields`, `errors`) and the
-    // reactive containers (`meta`, `history`, `blankPaths`) are exposed
-    // through getters so reading them activates the form on first
-    // touch. Each underlying object is identity-stable across reads.
+    // The callable readonly Proxies (`values`, `fields`, `errors`) and the
+    // reactive containers (`meta`, `history`, `blankPaths`) are exposed through
+    // getters, so reading one activates the form on first touch. Each
+    // underlying object is identity-stable across reads.
     get values() {
       void state.activate();
       return valuesProxy;
@@ -2948,7 +2946,7 @@ function buildFormApi(state, formInstanceId, options = {}) {
     key: state.formKey,
     // Auto-unwrapping views over the per-store async-defaults lifecycle
     // refs (see FormStore.hydrating / hydrateError). Reading either
-    // activates the form — observing factory state implies use.
+    // activates the form: observing factory state implies use.
     get hydrating() {
       void state.activate();
       return state.hydrating.value;
@@ -2957,20 +2955,18 @@ function buildFormApi(state, formInstanceId, options = {}) {
       void state.activate();
       return state.hydrateError.value;
     },
-    // Orthogonal to `hydrating` and `hydrateError`: `ready` flips true
-    // once defaults are applied (sync at construction or async factory
-    // resolved successfully). One-way latch — stays true through later
-    // refetches even when those refetches fail, so stale-while-
-    // revalidate UIs keep rendering the prior values while
-    // `hydrateError` surfaces the refresh failure.
+    // Orthogonal to `hydrating` and `hydrateError`. `ready` flips true once
+    // defaults are applied, whether sync at construction or from a factory
+    // that resolved, and it is a one-way latch: it stays true through later
+    // refetches even when those fail, so a stale-while-revalidate UI keeps
+    // rendering the prior values while `hydrateError` surfaces the failure.
     get ready() {
       void state.activate();
       return state.defaultsResolved.value;
     },
-    // `rehydrate` and `activate` are themselves activation entry points
-    // — they fire the factory by design. Wrapping them with `gated`
-    // would double-fire (`state.activate()` plus the underlying call),
-    // so they call `state` directly.
+    // `rehydrate` and `activate` are activation entry points themselves and
+    // fire the factory by design, so wrapping them in `gated` would
+    // double-fire. They call `state` directly.
     rehydrate: () => state.rehydrate(),
     activate: () => state.activate(),
     get errors() {
@@ -3585,19 +3581,16 @@ function touchFieldRecord(st, pathKey, path, patch) {
     path,
     updatedAt: patch.updatedAt ?? current?.updatedAt ?? null,
     connected: patch.connected ?? current?.connected ?? false,
-    // focused/blurred use an explicit-undefined guard because
-    // patches legitimately carry `null` to mark a disconnect — the
-    // `??` operator would short-circuit on null and fall through to
-    // `current`, losing the intent. `!== undefined` honours an
-    // explicit null and preserves current only on absence.
+    // `focused` / `blurred` need an explicit-undefined guard: a patch
+    // legitimately carries `null` to mark a disconnect, and `??` would
+    // short-circuit on it and fall through to `current`, losing the intent.
     focused: patch.focused !== void 0 ? patch.focused : current?.focused ?? null,
     blurred: patch.blurred !== void 0 ? patch.blurred : current?.blurred ?? null,
-    // touched is plain `boolean`; `??` is equivalent to the explicit
-    // guard here because `false` is not nullish.
+    // `touched` is a plain boolean, so `??` is equivalent to the guard above.
     touched: patch.touched ?? current?.touched ?? false,
-    // interacted is sticky-true; a merge patch only ever sets it, so
-    // `??` preserves the current bit. It flips back to false solely
-    // through the reset paths, which reconstruct the record outright.
+    // `interacted` is sticky-true and a merge patch only ever sets it, so `??`
+    // preserves the current bit. Only the reset paths clear it, and they
+    // reconstruct the record outright.
     interacted: patch.interacted ?? current?.interacted ?? false,
     blurredAfterInteraction: patch.blurredAfterInteraction ?? current?.blurredAfterInteraction ?? false
   });
@@ -4160,13 +4153,13 @@ function markFocused(st, path, focused, meta) {
   touchFieldRecord(st, key, path, {
     focused,
     blurred: !focused,
-    // `touched` flips to true on blur and stays true thereafter; while
-    // a field is currently focused we keep whatever value it held.
+    // `touched` flips true on blur and stays; a focused field keeps whatever
+    // it held.
     touched: focused ? current?.touched ?? false : true,
-    // `blurredAfterInteraction` flips true on the first blur that lands
-    // after a value edit and stays true. A tab-through blur before any
-    // edit leaves it false (`interacted` is still false at that blur),
-    // which is what keeps a clean tab-through from arming the gate.
+    // `blurredAfterInteraction` flips true on the first blur after a value
+    // edit and stays. A tab-through blur before any edit leaves it false,
+    // since `interacted` is still false, which is what keeps a clean
+    // tab-through from arming the gate.
     blurredAfterInteraction: !focused && current?.interacted === true ? true : current?.blurredAfterInteraction ?? false
   });
   const focusMode = meta?.instance?.validateOn ?? st.fieldValidationMode;
@@ -4618,15 +4611,12 @@ function createFormStore(options) {
     blankPaths,
     originalBlankPaths,
     // --- kernel-internal state ---
-    // Defensive copy, not a fix for an observed alias: today
-    // `getDefaultValues` happens to build a fresh tree, so form storage
-    // does not currently share structure with the consumer's object.
-    // That is an adapter implementation detail rather than a contract,
-    // and this field is now durable state that every `reset()` reads, so
-    // it should not depend on it. The copy also means a consumer who
-    // keeps a reference to the literal they passed cannot mutate the
-    // form's defaults from outside. `reset()` snapshots for a harder
-    // reason (see there) where an alias IS reachable.
+    // A defensive copy. `getDefaultValues` building a fresh tree is an adapter
+    // implementation detail, not a contract, and this field is durable state
+    // that every `reset()` reads, so it must not depend on one. The copy also
+    // stops a consumer holding a reference to the literal they passed from
+    // mutating the form's defaults from outside. `reset()` snapshots for a
+    // harder reason, where an alias IS reachable.
     defaultValues: structuralSnapshot(defaultValues),
     ssrPrefetch,
     rememberVariants,
@@ -4664,10 +4654,10 @@ function createFormStore(options) {
     arrayElementKey: bind(arrayElementKey),
     reset: bind(reset),
     resetField: bind(resetField),
-    // The schema/user pair below reads as a fold waiting to happen. It was
-    // tried: a `setErrorsForPathIn(channel)` factory measured 10 B LARGER,
-    // because gzip had already collected the rent on two adjacent copies
-    // and the helper added a name the original did not need.
+    // The schema/user pair below reads as a fold waiting to happen. Folding
+    // them into a `setErrorsForPathIn(channel)` factory measures 10 B LARGER:
+    // gzip has already collected the rent on two adjacent copies, and the
+    // helper adds a name the original does not need.
     setSchemaErrorsForPath: (path, entries) => setErrorChannelForKey(
       st,
       canonicalizePath(path).key,
@@ -4868,12 +4858,10 @@ function buildFreshState(key, schema, configuration, registry) {
       coerce: configuration.coerce,
       initialBlankPaths
     }),
-    // Server-only: bind the SSR prefetch coordination handles. `enqueue`
-    // records intent on every `state.activate()` so a wizard skip-list
-    // override or a future transform mark has a consistent set to diff
-    // against; `shouldFire` lets the activate path bail when the
-    // wizard explicitly skipped this key — even an explicit
-    // `form.activate()` defers to the wizard's render-efficiency
+    // Server only. `enqueue` records intent on every `state.activate()`
+    // so a wizard skip-list override has a consistent set to diff
+    // against; `shouldFire` lets the activate path bail on a key the
+    // wizard skipped. Even an explicit `form.activate()` defers to that
     // skip-list on the server.
     ...registry.ssr ? {
       ssrPrefetch: {
@@ -5335,27 +5323,33 @@ function useWizard(options) {
       return activeKey.value === "" ? void 0 : activeKey.value;
     }
   };
-  function lazyComputedFor(marker) {
+  function lazyComputedFor(marker, index) {
     const cached = lazyComputeds.get(marker);
     if (cached !== void 0) return cached;
     const c = computed(() => {
       void lazyEpoch.value;
-      return marker.resolve(slotCtx);
+      return callConsumerFn(
+        () => marker.resolve(slotCtx),
+        void 0);
     });
     lazyComputeds.set(marker, c);
     return c;
   }
   const MAX_SLOT_DEPTH = 32;
-  function normalizeSlot(slot, ctx, gated, depth) {
+  function normalizeSlot(slot, ctx, gated, depth, index) {
     if (depth > MAX_SLOT_DEPTH) {
       return void 0;
     }
     if (slot === void 0 || slot === null) return void 0;
     if (typeof slot === "string") return { form: getOrBuildNoop(slot), gated };
     if (isGateMarker(slot)) return normalizeSlot(slot.inner, ctx, true, depth + 1);
-    if (isLazyMarker(slot)) return normalizeSlot(lazyComputedFor(slot).value, ctx, gated, depth + 1);
+    if (isLazyMarker(slot)) {
+      return normalizeSlot(lazyComputedFor(slot).value, ctx, gated, depth + 1);
+    }
     if (typeof slot === "function") {
-      const result = slot(ctx);
+      const result = callConsumerFn(
+        () => slot(ctx),
+        void 0);
       return normalizeSlot(result, ctx, gated, depth + 1);
     }
     if (isAnyForm(slot)) return { form: slot, gated };
@@ -5673,13 +5667,14 @@ function useWizard(options) {
       seedRef.value = resolved.value;
       applyGateSeed(resolved.value);
     } else {
-      const eager = resolved.factory();
+      const eager = callConsumerFn(() => resolved.factory(), void 0);
       if (eager instanceof Promise) {
         void eager.then((value) => {
           seedRef.value = value;
           applyGateSeed(value);
+        }).catch((err) => {
         });
-      } else {
+      } else if (eager !== void 0) {
         seedRef.value = eager;
         applyGateSeed(eager);
       }
@@ -5752,10 +5747,13 @@ function useWizard(options) {
   const statuses = buildWizardStatusesProxy(statusesRecord);
   const progressOverride = options.progress;
   const progress = computed(() => {
+    const list = compiledSteps.value;
     if (progressOverride !== void 0) {
-      return progressOverride(compiledSteps.value);
+      const override = callConsumerFn(
+        () => progressOverride(list),
+        null);
+      if (override !== null) return override;
     }
-    const list = compiledSteps.value;
     if (list.length === 0) return 0;
     let valid = 0;
     for (const step of list) {
@@ -5783,11 +5781,15 @@ function useWizard(options) {
   historyHandle.subscribe((value) => {
     urlMirror.value = value;
   });
-  const restoreCallback = options.restore === false ? void 0 : options.restore !== void 0 ? options.restore : () => {
+  const consumerRestore = options.restore;
+  const restoreCallback = consumerRestore === false ? void 0 : consumerRestore !== void 0 ? () => callConsumerFn(() => consumerRestore(), void 0) : () => {
     const value = urlMirror.value;
     return value === void 0 ? void 0 : { step: value };
   };
-  const persistCallback = options.persist === false ? void 0 : options.persist !== void 0 ? options.persist : (state) => {
+  const consumerPersist = options.persist;
+  const persistCallback = consumerPersist === false ? void 0 : consumerPersist !== void 0 ? (state) => {
+    callConsumerFn(() => consumerPersist(state), void 0);
+  } : (state) => {
     if (state.step === void 0) return;
     const current = historyHandle.read();
     const effectiveCurrent = current !== void 0 && isCompiledKey(current) ? current : firstKey();