attaform 0.21.1 → 0.21.2

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

@@ -1,5 +1,5 @@
-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';
+import { computed, ref, watchEffect, getCurrentScope, onScopeDispose, shallowReadonly, readonly, toRaw, reactive, watch, markRaw, shallowRef, getCurrentInstance, onServerPrefetch, provide, useId, inject, onBeforeMount, onBeforeUpdate, onMounted, effectScope, nextTick } from 'vue';
+import { _ as __DEV__, a as canonicalizePath, s as segmentsForPathKey, l as isPathPrefix, F as FORM_ERRORS_PATH_KEY, S as SubmitErrorHandlerError, t as toError, A as AnonPersistError, q as INTERACTIVE_TAG_NAMES, r as getOrAssignElementId, e as ROOT_PATH_KEY, R as ROOT_PATH, w as allowSensitivePersist, x as FORM_ERRORS_PATH, y as coerceToPathKey, z as isSensitivePath, B as createPersistOptInRegistry, d as InvalidUseFormConfigError, C as ensureAttaformInstalled, u as useRegistry, E as kFormContext, G as kFormInstanceId, h as ReservedFormKeyError, H as createIsSensitivePath, J as REGISTER_OWNER_MARKER, V as V_REGISTER_MARKER, k as kAttaformWizardActiveStepResolver, K as kAttaformAncestorWizard } from './attaform.DP-u7_tk.mjs';
 
 function safeAssign(target, key, value) {
   if (key === "__proto__") {
@@ -160,68 +160,80 @@ function mergeStructuralImpl(schema, scratch, consumer, defaultValue) {
   }
   if (consumer === null) return null;
   if (Array.isArray(consumer)) {
-    const shape = resolveArrayShape(schema, scratch);
-    const isTuple = typeof shape === "number";
-    const targetLen = isTuple ? shape : consumer.length;
-    let cachedElementDefault;
-    let cachedElementDefaultRead = false;
-    let mutated = targetLen > consumer.length;
-    const out = consumer.slice();
-    while (out.length < targetLen) out.push(void 0);
-    for (let i = 0; i < targetLen; i++) {
-      scratch.push(i);
-      let elemDefault;
-      if (isTuple) {
-        elemDefault = schema.getDefaultAtPath(scratch);
-      } else {
-        if (!cachedElementDefaultRead) {
-          cachedElementDefault = schema.getDefaultAtPath(scratch);
-          cachedElementDefaultRead = true;
-        }
-        elemDefault = cachedElementDefault;
-      }
-      const consumerElem = i < consumer.length ? consumer[i] : void 0;
-      const merged = mergeStructuralImpl(schema, scratch, consumerElem, elemDefault);
-      scratch.pop();
-      if (merged !== consumerElem) {
-        out[i] = merged;
-        mutated = true;
-      }
-    }
-    return mutated ? out : consumer;
+    return mergeStructuralArray(schema, scratch, consumer);
   }
   if (isPlainRecord(consumer)) {
     if (!isPlainRecord(defaultValue)) {
       return consumer;
     }
-    let mutated = false;
     const out = { ...consumer };
-    for (const key of Object.keys(defaultValue)) {
-      if (!safeOwnHas(consumer, key)) {
-        const defAtKey = safeOwnRead(defaultValue, key);
-        scratch.push(key);
-        const filled = mergeStructuralImpl(schema, scratch, void 0, defAtKey);
-        scratch.pop();
-        if (filled !== void 0) {
-          safeAssign(out, key, filled);
-          mutated = true;
-        }
+    const filledAny = fillMissingKeysFromDefault(schema, scratch, consumer, defaultValue, out);
+    const recursedAny = recurseIntoConsumerKeys(schema, scratch, consumer, defaultValue, out);
+    return filledAny || recursedAny ? out : consumer;
+  }
+  return consumer;
+}
+function mergeStructuralArray(schema, scratch, consumer) {
+  const shape = resolveArrayShape(schema, scratch);
+  const isTuple = typeof shape === "number";
+  const targetLen = isTuple ? shape : consumer.length;
+  let cachedElementDefault;
+  let cachedElementDefaultRead = false;
+  let mutated = targetLen > consumer.length;
+  const out = consumer.slice();
+  while (out.length < targetLen) out.push(void 0);
+  for (let i = 0; i < targetLen; i++) {
+    scratch.push(i);
+    let elemDefault;
+    if (isTuple) {
+      elemDefault = schema.getDefaultAtPath(scratch);
+    } else {
+      if (!cachedElementDefaultRead) {
+        cachedElementDefault = schema.getDefaultAtPath(scratch);
+        cachedElementDefaultRead = true;
       }
+      elemDefault = cachedElementDefault;
     }
-    for (const key of Object.keys(consumer)) {
-      const cVal = safeOwnRead(consumer, key);
-      if (cVal === void 0) continue;
+    const consumerElem = i < consumer.length ? consumer[i] : void 0;
+    const merged = mergeStructuralImpl(schema, scratch, consumerElem, elemDefault);
+    scratch.pop();
+    if (merged !== consumerElem) {
+      out[i] = merged;
+      mutated = true;
+    }
+  }
+  return mutated ? out : consumer;
+}
+function fillMissingKeysFromDefault(schema, scratch, consumer, defaultValue, out) {
+  let mutated = false;
+  for (const key of Object.keys(defaultValue)) {
+    if (!safeOwnHas(consumer, key)) {
+      const defAtKey = safeOwnRead(defaultValue, key);
       scratch.push(key);
-      const merged = mergeStructuralImpl(schema, scratch, cVal, safeOwnRead(defaultValue, key));
+      const filled = mergeStructuralImpl(schema, scratch, void 0, defAtKey);
       scratch.pop();
-      if (merged !== cVal) {
-        safeAssign(out, key, merged);
+      if (filled !== void 0) {
+        safeAssign(out, key, filled);
         mutated = true;
       }
     }
-    return mutated ? out : consumer;
   }
-  return consumer;
+  return mutated;
+}
+function recurseIntoConsumerKeys(schema, scratch, consumer, defaultValue, out) {
+  let mutated = false;
+  for (const key of Object.keys(consumer)) {
+    const cVal = safeOwnRead(consumer, key);
+    if (cVal === void 0) continue;
+    scratch.push(key);
+    const merged = mergeStructuralImpl(schema, scratch, cVal, safeOwnRead(defaultValue, key));
+    scratch.pop();
+    if (merged !== cVal) {
+      safeAssign(out, key, merged);
+      mutated = true;
+    }
+  }
+  return mutated;
 }
 function setAtPathWithSchemaFill(root, schema, fullPath, value) {
   if (fullPath.length === 0) return value;
@@ -304,55 +316,27 @@ function diffAndApply(oldValue, newValue, prefix, visit) {
   const oldIsDescendable = isDescendable(oldValue);
   const newIsDescendable = isDescendable(newValue);
   if (oldValue === void 0 && newIsDescendable) {
-    if (Array.isArray(newValue)) {
-      for (let i = 0; i < newValue.length; i++) {
-        diffAndApply(void 0, newValue[i], appendSegment(prefix, i), visit);
-      }
-    } else {
-      const rec = newValue;
-      for (const k of Object.keys(rec)) {
-        diffAndApply(void 0, rec[k], appendSegment(prefix, k), visit);
-      }
-    }
+    walkNewDescendable(newValue, prefix, visit);
     return;
   }
   if (oldIsDescendable && newValue === void 0) {
-    if (Array.isArray(oldValue)) {
-      for (let i = 0; i < oldValue.length; i++) {
-        diffAndApply(oldValue[i], void 0, appendSegment(prefix, i), visit);
-      }
-    } else {
-      const rec = oldValue;
-      for (const k of Object.keys(rec)) {
-        diffAndApply(rec[k], void 0, appendSegment(prefix, k), visit);
-      }
-    }
+    walkOldDescendable(oldValue, prefix, visit);
     return;
   }
   if (oldIsDescendable && newIsDescendable) {
     const oldIsArray = Array.isArray(oldValue);
     const newIsArray = Array.isArray(newValue);
     if (oldIsArray && newIsArray) {
-      const oldArr = oldValue;
-      const newArr = newValue;
-      const max = Math.max(oldArr.length, newArr.length);
-      for (let i = 0; i < max; i++) {
-        diffAndApply(oldArr[i], newArr[i], appendSegment(prefix, i), visit);
-      }
+      diffArraysLockstep(oldValue, newValue, prefix, visit);
       return;
     }
     if (!oldIsArray && !newIsArray) {
-      const oldRec = oldValue;
-      const newRec = newValue;
-      const seen = /* @__PURE__ */ new Set();
-      for (const k of Object.keys(oldRec)) {
-        seen.add(k);
-        diffAndApply(oldRec[k], newRec[k], appendSegment(prefix, k), visit);
-      }
-      for (const k of Object.keys(newRec)) {
-        if (seen.has(k)) continue;
-        diffAndApply(oldRec[k], newRec[k], appendSegment(prefix, k), visit);
-      }
+      diffObjectsLockstep(
+        oldValue,
+        newValue,
+        prefix,
+        visit
+      );
       return;
     }
     visit({ kind: "changed", path: prefix, oldValue, newValue });
@@ -376,6 +360,47 @@ function diffAndApply(oldValue, newValue, prefix, visit) {
   }
   visit({ kind: "changed", path: prefix, oldValue, newValue });
 }
+function walkNewDescendable(newValue, prefix, visit) {
+  if (Array.isArray(newValue)) {
+    for (let i = 0; i < newValue.length; i++) {
+      diffAndApply(void 0, newValue[i], appendSegment(prefix, i), visit);
+    }
+  } else {
+    const rec = newValue;
+    for (const k of Object.keys(rec)) {
+      diffAndApply(void 0, rec[k], appendSegment(prefix, k), visit);
+    }
+  }
+}
+function walkOldDescendable(oldValue, prefix, visit) {
+  if (Array.isArray(oldValue)) {
+    for (let i = 0; i < oldValue.length; i++) {
+      diffAndApply(oldValue[i], void 0, appendSegment(prefix, i), visit);
+    }
+  } else {
+    const rec = oldValue;
+    for (const k of Object.keys(rec)) {
+      diffAndApply(rec[k], void 0, appendSegment(prefix, k), visit);
+    }
+  }
+}
+function diffArraysLockstep(oldArr, newArr, prefix, visit) {
+  const max = Math.max(oldArr.length, newArr.length);
+  for (let i = 0; i < max; i++) {
+    diffAndApply(oldArr[i], newArr[i], appendSegment(prefix, i), visit);
+  }
+}
+function diffObjectsLockstep(oldRec, newRec, prefix, visit) {
+  const seen = /* @__PURE__ */ new Set();
+  for (const k of Object.keys(oldRec)) {
+    seen.add(k);
+    diffAndApply(oldRec[k], newRec[k], appendSegment(prefix, k), visit);
+  }
+  for (const k of Object.keys(newRec)) {
+    if (seen.has(k)) continue;
+    diffAndApply(oldRec[k], newRec[k], appendSegment(prefix, k), visit);
+  }
+}
 function applyChangedKeys(target, source) {
   if (!isDescendable(target) || !isDescendable(source)) return false;
   const targetIsArray = Array.isArray(target);
@@ -623,6 +648,12 @@ function buildFieldStateAccessor(state, formInstanceId, getFormMetaBase, options
     return c;
   };
 }
+function resolveFieldMetaAndLabel(state, segments) {
+  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 { resolved, label };
+}
 function buildLeafFieldStateBase(state, segments, key, formInstanceId) {
   const record = state.fields.get(key);
   const value = state.getValueAtPath(segments);
@@ -644,9 +675,7 @@ function buildLeafFieldStateBase(state, segments, key, formInstanceId) {
   const elementRecord = state.elements.get(key);
   const elementsArr = elementRecord ? Object.freeze([...elementRecord.elements]) : EMPTY_ELEMENTS;
   const firstElement = elementsArr[0] ?? null;
-  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);
+  const { resolved, label } = resolveFieldMetaAndLabel(state, segments);
   return {
     value,
     original,
@@ -783,9 +812,7 @@ function buildContainerFieldStateBase(state, segments, key, formInstanceId) {
   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);
+  const { resolved, label } = resolveFieldMetaAndLabel(state, segments);
   return {
     base: {
       value,
@@ -1568,20 +1595,20 @@ function buildFieldStateProxy(state, formInstanceId, getFormMetaBase, options) {
 }
 function materializeFields(state, containerSegments, snapshotFieldStateAt) {
   const liveValue = getAtPath(state.form.value, containerSegments);
-  return walk$2(liveValue, containerSegments, state.schema, snapshotFieldStateAt);
+  return walk$1(liveValue, containerSegments, state.schema, snapshotFieldStateAt);
 }
-function walk$2(value, basePath, schema, snapshotFieldStateAt) {
+function walk$1(value, basePath, schema, snapshotFieldStateAt) {
   if (schema.isLeafAtPath(basePath)) return snapshotFieldStateAt(basePath);
   if (value === null || value === void 0) return value;
   if (typeof value !== "object") {
     return value;
   }
   if (Array.isArray(value)) {
-    return value.map((_, i) => walk$2(value[i], [...basePath, i], schema, snapshotFieldStateAt));
+    return value.map((_, i) => walk$1(value[i], [...basePath, i], schema, snapshotFieldStateAt));
   }
   const result = {};
   for (const key of Object.keys(value)) {
-    result[key] = walk$2(
+    result[key] = walk$1(
       value[key],
       [...basePath, key],
       schema,
@@ -1665,47 +1692,42 @@ function mergeDeep(target, source, path, schema) {
   if (!isPlainRecord(source)) return source;
   if (schema !== void 0) {
     const du = schema.getUnionDiscriminatorAtPath(path);
-    if (du !== void 0) {
-      const sourceRecord = source;
-      const sourceDisc = sourceRecord[du.discriminatorKey];
-      if (sourceDisc !== void 0 && !du.isVariantSelected(sourceDisc)) {
-        return { [du.discriminatorKey]: sourceDisc };
-      }
-      if (sourceDisc !== void 0) {
-        const variantDefault = du.getVariantDefault(sourceDisc);
-        if (isPlainRecord(variantDefault)) {
-          const out2 = { ...variantDefault };
-          for (const key of Object.keys(sourceRecord)) {
-            if (!safeOwnHas(variantDefault, key) && key !== du.discriminatorKey) continue;
-            safeAssign(
-              out2,
-              key,
-              mergeDeep(
-                safeOwnRead(out2, key),
-                safeOwnRead(sourceRecord, key),
-                [...path, key],
-                schema
-              )
-            );
-          }
-          return out2;
-        }
-      }
-      return {};
+    if (du !== void 0) return mergeDuAwareKeys(source, path, schema, du);
+  }
+  return mergeObjectKeys(target, source, path, schema);
+}
+function mergeDuAwareKeys(source, path, schema, du) {
+  const sourceDisc = source[du.discriminatorKey];
+  if (sourceDisc !== void 0 && !du.isVariantSelected(sourceDisc)) {
+    return { [du.discriminatorKey]: sourceDisc };
+  }
+  if (sourceDisc !== void 0) {
+    const variantDefault = du.getVariantDefault(sourceDisc);
+    if (isPlainRecord(variantDefault)) {
+      return mergeVariantKeys(source, variantDefault, path, schema, du);
     }
   }
-  const mergeTarget = target;
-  const out = isPlainRecord(mergeTarget) ? { ...mergeTarget } : {};
+  return {};
+}
+function mergeVariantKeys(source, variantDefault, path, schema, du) {
+  const out = { ...variantDefault };
   for (const key of Object.keys(source)) {
+    if (!safeOwnHas(variantDefault, key) && key !== du.discriminatorKey) continue;
     safeAssign(
       out,
       key,
-      mergeDeep(
-        safeOwnRead(out, key),
-        safeOwnRead(source, key),
-        [...path, key],
-        schema
-      )
+      mergeDeep(safeOwnRead(out, key), safeOwnRead(source, key), [...path, key], schema)
+    );
+  }
+  return out;
+}
+function mergeObjectKeys(target, source, path, schema) {
+  const out = isPlainRecord(target) ? { ...target } : {};
+  for (const key of Object.keys(source)) {
+    safeAssign(
+      out,
+      key,
+      mergeDeep(safeOwnRead(out, key), safeOwnRead(source, key), [...path, key], schema)
     );
   }
   return out;
@@ -2004,6 +2026,33 @@ function applyInvalidSubmitPolicy(state, formInstanceId, policy) {
   target.element.focus({ preventScroll: true });
 }
 
+function captureUserCallSite() {
+  const raw = new Error().stack;
+  if (typeof raw !== "string") return void 0;
+  const lines = raw.split("\n");
+  for (let i = 1; i < lines.length; i++) {
+    const frame = lines[i];
+    if (frame === void 0) continue;
+    if (/attaform[/-]forms?/i.test(frame)) continue;
+    if (/\bforms\.[A-Za-z0-9_-]+\.m?js\b/.test(frame)) continue;
+    const trimmed = frame.trim();
+    if (trimmed.length === 0) continue;
+    return shortenSourceFrame(trimmed);
+  }
+  return void 0;
+}
+function shortenSourceFrame(frame) {
+  const match = /(?:^|\s|\()([^\s()]+):(\d+):\d+\)?$/.exec(frame);
+  if (match === null) return frame;
+  const [, urlOrPath, line] = match;
+  if (urlOrPath === void 0 || line === void 0) return frame;
+  let path = urlOrPath;
+  path = path.replace(/^[a-z]+:\/\/[^/]+\//i, "");
+  path = path.replace(/^_nuxt\//, "");
+  path = path.replace(/^\//, "");
+  return `(${path}:${line})`;
+}
+
 function extractSchemaFields(schema) {
   try {
     const root = schema.getDefaultAtPath([]);
@@ -2062,9 +2111,9 @@ function isLeafValue(value) {
   return true;
 }
 function isSlimPrimitiveValid(schema, store, path, value) {
-  return walk$1(schema, store, path, value);
+  return walk(schema, store, path, value);
 }
-function walk$1(schema, store, path, value) {
+function walk(schema, store, path, value) {
   if (schema.isPreprocessOrCoerceLeaf(path)) return true;
   const accepted = schema.getSlimPrimitiveTypesAtPath(path);
   const kind = isLeafValue(value) ? slimKindOf(value) : Array.isArray(value) ? "array" : "object";
@@ -2074,13 +2123,13 @@ function walk$1(schema, store, path, value) {
   }
   if (Array.isArray(value)) {
     for (let i = 0; i < value.length; i++) {
-      if (!walk$1(schema, store, [...path, i], value[i])) return false;
+      if (!walk(schema, store, [...path, i], value[i])) return false;
     }
     return true;
   }
   if (isPlainRecord(value)) {
     for (const key of Object.keys(value)) {
-      if (!walk$1(schema, store, [...path, key], value[key])) {
+      if (!walk(schema, store, [...path, key], value[key])) {
         return false;
       }
     }
@@ -2480,49 +2529,60 @@ function walkUnsetSentinels(values, schema) {
     walkUnspecified(rootSlim, [], paths);
     return { cleanedValues: void 0, paths };
   }
-  const cleaned = walk(values, [], schema, paths);
+  const cleaned = walkCore(values, [], schema, paths, true);
   return { cleanedValues: cleaned, paths };
 }
-function walk(input, segments, schema, paths) {
+function isOpaqueLeaf(value) {
+  return value instanceof Date || value instanceof RegExp || value instanceof Map || value instanceof Set || typeof value === "function";
+}
+function walkCore(input, segments, schema, paths, synthesizeSchemaKeys) {
   if (isUnset(input)) {
     return expandUnsetAt(segments, schema, paths);
   }
   if (input === void 0) {
-    const slim = schema.getDefaultAtPath(segments);
-    return walkUnspecified(slim, segments, paths);
-  }
-  if (input === null) return null;
-  if (input instanceof Date || input instanceof RegExp || input instanceof Map || input instanceof Set || typeof input === "function") {
+    if (synthesizeSchemaKeys) {
+      const slim = schema.getDefaultAtPath(segments);
+      return walkUnspecified(slim, segments, paths);
+    }
     return input;
   }
+  if (input === null) return null;
+  if (isOpaqueLeaf(input)) return input;
   if (Array.isArray(input)) {
     const out = new Array(input.length);
     let mutated = false;
     for (let i = 0; i < input.length; i++) {
-      const walked = walk(input[i], [...segments, i], schema, paths);
+      const walked = walkCore(input[i], [...segments, i], schema, paths, synthesizeSchemaKeys);
       out[i] = walked;
       if (walked !== input[i]) mutated = true;
     }
     return mutated ? out : input;
   }
   if (typeof input === "object") {
-    const slim = schema.getDefaultAtPath(segments);
-    const inputKeys = Object.keys(input);
-    const inputKeysSet = new Set(inputKeys);
-    const allKeys = new Set(inputKeys);
-    if (slim !== null && slim !== void 0 && typeof slim === "object" && !Array.isArray(slim) && !(slim instanceof Date) && !(slim instanceof RegExp) && !(slim instanceof Map) && !(slim instanceof Set)) {
-      for (const k of Object.keys(slim)) allKeys.add(k);
+    const obj = input;
+    const inputKeys = Object.keys(obj);
+    let keys = inputKeys;
+    let mutated = false;
+    let inputKeysSet = null;
+    if (synthesizeSchemaKeys) {
+      inputKeysSet = new Set(inputKeys);
+      const allKeys = new Set(inputKeys);
+      const slim = schema.getDefaultAtPath(segments);
+      if (slim !== null && slim !== void 0 && typeof slim === "object" && !Array.isArray(slim) && !isOpaqueLeaf(slim)) {
+        for (const k of Object.keys(slim)) allKeys.add(k);
+      }
+      keys = allKeys;
+      mutated = allKeys.size !== inputKeys.length;
     }
     const out = {};
-    let mutated = allKeys.size !== inputKeys.length;
-    for (const key of allKeys) {
-      const orig = input[key];
-      if (orig === void 0 && inputKeysSet.has(key)) {
+    for (const key of keys) {
+      const orig = obj[key];
+      if (synthesizeSchemaKeys && orig === void 0 && inputKeysSet?.has(key) === true) {
         safeAssign(out, key, void 0);
         mutated = true;
         continue;
       }
-      const walked = walk(orig, [...segments, key], schema, paths);
+      const walked = walkCore(orig, [...segments, key], schema, paths, synthesizeSchemaKeys);
       safeAssign(out, key, walked);
       if (walked !== orig) mutated = true;
     }
@@ -2537,7 +2597,7 @@ function walkUnspecified(slim, segments, paths) {
     }
     return slim;
   }
-  if (slim instanceof Date || slim instanceof RegExp || slim instanceof Map || slim instanceof Set || typeof slim === "function") {
+  if (isOpaqueLeaf(slim)) {
     return slim;
   }
   if (Array.isArray(slim)) return slim;
@@ -2556,40 +2616,9 @@ function walkUnspecified(slim, segments, paths) {
 }
 function substituteUnsetSentinels(value, prefix, schema) {
   const paths = [];
-  const cleaned = substitute(value, [...prefix], schema, paths);
+  const cleaned = walkCore(value, [...prefix], schema, paths, false);
   return { cleanedValues: cleaned, paths };
 }
-function substitute(input, segments, schema, paths) {
-  if (isUnset(input)) {
-    return expandUnsetAt(segments, schema, paths);
-  }
-  if (input === void 0 || input === null) return input;
-  if (input instanceof Date || input instanceof RegExp || input instanceof Map || input instanceof Set || typeof input === "function") {
-    return input;
-  }
-  if (Array.isArray(input)) {
-    let mutated = false;
-    const out = new Array(input.length);
-    for (let i = 0; i < input.length; i++) {
-      const walked = substitute(input[i], [...segments, i], schema, paths);
-      out[i] = walked;
-      if (walked !== input[i]) mutated = true;
-    }
-    return mutated ? out : input;
-  }
-  if (typeof input === "object") {
-    let mutated = false;
-    const out = {};
-    for (const key of Object.keys(input)) {
-      const orig = input[key];
-      const walked = substitute(orig, [...segments, key], schema, paths);
-      safeAssign(out, key, walked);
-      if (walked !== orig) mutated = true;
-    }
-    return mutated ? out : input;
-  }
-  return input;
-}
 function isPrimitiveOrEmpty(value) {
   if (value === null || value === void 0) return true;
   const t = typeof value;
@@ -2619,7 +2648,7 @@ function expandUnsetAt(segments, schema, paths) {
     paths.push(canonicalizePath(segments).key);
     return slim;
   }
-  if (slim instanceof Date || slim instanceof RegExp || slim instanceof Map || slim instanceof Set || typeof slim === "function") {
+  if (isOpaqueLeaf(slim)) {
     paths.push(canonicalizePath(segments).key);
     return slim;
   }
@@ -2753,6 +2782,17 @@ function buildFormApi(state, formInstanceId, options = {}) {
     if (instanceMeta === void 0) return meta;
     return meta === void 0 ? { instance: instanceMeta } : { ...meta, instance: instanceMeta };
   };
+  const reMarkBlanksAfterSubstitution = (paths) => {
+    for (const pathKey of paths) {
+      const blankSegments = segmentsForPathKey(pathKey);
+      if (blankSegments === null) continue;
+      state.setValueAtPath(
+        blankSegments,
+        state.getValueAtPath(blankSegments),
+        withInstanceMeta({ blank: true })
+      );
+    }
+  };
   const getFormMetaBase = () => {
     const { base: rootBase } = buildContainerFieldStateBase(
       state,
@@ -2810,15 +2850,7 @@ function buildFormApi(state, formInstanceId, options = {}) {
       );
       const ok2 = state.setValueAtPath([], walked2.cleanedValues, withInstanceMeta());
       if (!ok2) return false;
-      for (const pathKey of walked2.paths) {
-        const blankSegments = segmentsForPathKey(pathKey);
-        if (blankSegments === null) continue;
-        state.setValueAtPath(
-          blankSegments,
-          state.getValueAtPath(blankSegments),
-          withInstanceMeta({ blank: true })
-        );
-      }
+      reMarkBlanksAfterSubstitution(walked2.paths);
       return true;
     }
     const segments = canonicalizePath(pathOrValue).segments;
@@ -2873,15 +2905,7 @@ function buildFormApi(state, formInstanceId, options = {}) {
     );
     const ok = state.setValueAtPath(segments, walked.cleanedValues, withInstanceMeta());
     if (!ok) return false;
-    for (const pathKey of walked.paths) {
-      const blankSegments = segmentsForPathKey(pathKey);
-      if (blankSegments === null) continue;
-      state.setValueAtPath(
-        blankSegments,
-        state.getValueAtPath(blankSegments),
-        withInstanceMeta({ blank: true })
-      );
-    }
+    reMarkBlanksAfterSubstitution(walked.paths);
     return true;
   }
   const errorsProxy = buildErrorsProxy(state);
@@ -5304,6 +5328,20 @@ function captureErrorEntries(map) {
   for (const [k, v] of map) out.push([k, [...v]]);
   return out;
 }
+function pathsEqual(a, b) {
+  if (a.length !== b.length) return false;
+  for (let j = 0; j < a.length; j++) {
+    if (a[j] !== b[j]) return false;
+  }
+  return true;
+}
+function errorFieldsEqual(av, bvi) {
+  if (av === bvi) return true;
+  if (av.message !== bvi.message) return false;
+  if (av.code !== bvi.code) return false;
+  if (av.formKey !== bvi.formKey) return false;
+  return av.path === bvi.path || pathsEqual(av.path, bvi.path);
+}
 function errorsEqual(a, b) {
   if (a.length !== b.length) return false;
   const bMap = /* @__PURE__ */ new Map();
@@ -5313,18 +5351,7 @@ function errorsEqual(a, b) {
     if (bv === void 0) return false;
     if (v.length !== bv.length) return false;
     for (let i = 0; i < v.length; i++) {
-      const av = v[i];
-      const bvi = bv[i];
-      if (av === bvi) continue;
-      if (av.message !== bvi.message) return false;
-      if (av.code !== bvi.code) return false;
-      if (av.formKey !== bvi.formKey) return false;
-      if (av.path !== bvi.path) {
-        if (av.path.length !== bvi.path.length) return false;
-        for (let j = 0; j < av.path.length; j++) {
-          if (av.path[j] !== bvi.path[j]) return false;
-        }
-      }
+      if (!errorFieldsEqual(v[i], bv[i])) return false;
     }
   }
   return true;
@@ -5906,6 +5933,99 @@ function warnIfAmbientProviderHadDuplicates() {
   }
 }
 
+const warnedNoParentRV = __DEV__ ? /* @__PURE__ */ new WeakSet() : null;
+let warnedOutsideSetup = false;
+function makeRegisterValueProxy(capturedRegisterValue) {
+  return new Proxy({}, {
+    get(_target, prop) {
+      if (prop === "__v_isRef") return true;
+      if (prop === "value") return capturedRegisterValue.value;
+      const v = capturedRegisterValue.value;
+      if (v === void 0) return void 0;
+      return Reflect.get(v, prop);
+    },
+    has(_target, prop) {
+      if (prop === "__v_isRef" || prop === "value") return true;
+      const v = capturedRegisterValue.value;
+      if (v === void 0) return false;
+      return Reflect.has(v, prop);
+    },
+    ownKeys(_target) {
+      const v = capturedRegisterValue.value;
+      if (v === void 0) return [];
+      return Reflect.ownKeys(v);
+    },
+    getOwnPropertyDescriptor(_target, prop) {
+      const v = capturedRegisterValue.value;
+      if (v === void 0) return void 0;
+      const desc = Reflect.getOwnPropertyDescriptor(v, prop);
+      if (desc !== void 0) {
+        desc.configurable = true;
+      }
+      return desc;
+    }
+  });
+}
+function useRegister() {
+  const instance = getCurrentInstance();
+  if (instance === null) {
+    warnOutsideSetup();
+    return makeRegisterValueProxy(shallowRef(void 0));
+  }
+  ensureAttaformInstalled(instance.appContext.app);
+  const capturedRegisterValue = shallowRef(void 0);
+  const refreshAndStripBridgeAttrs = () => {
+    const rawAttrs = instance.attrs;
+    if ("registerValue" in rawAttrs) {
+      capturedRegisterValue.value = rawAttrs["registerValue"];
+      delete rawAttrs["registerValue"];
+    } else {
+      const dirs = instance.vnode.dirs;
+      if (dirs !== null && dirs !== void 0) {
+        for (const dir of dirs) {
+          const marked = dir.dir?.[V_REGISTER_MARKER];
+          if (marked === true) {
+            capturedRegisterValue.value = dir.value;
+            break;
+          }
+        }
+      }
+    }
+    if ("value" in rawAttrs) delete rawAttrs["value"];
+  };
+  refreshAndStripBridgeAttrs();
+  onBeforeMount(refreshAndStripBridgeAttrs);
+  onBeforeUpdate(refreshAndStripBridgeAttrs);
+  onMounted(() => {
+    const el = instance.vnode.el;
+    if (el !== null && el !== void 0 && typeof el === "object") {
+      el[REGISTER_OWNER_MARKER] = true;
+    }
+    if (capturedRegisterValue.value === void 0) {
+      warnNoParentRV(instance);
+    }
+  });
+  return makeRegisterValueProxy(capturedRegisterValue);
+}
+function warnOutsideSetup() {
+  if (!__DEV__) return;
+  if (warnedOutsideSetup) return;
+  warnedOutsideSetup = true;
+  const frame = captureUserCallSite();
+  console.warn(
+    `[attaform] useRegister() called outside a component setup; returning an unbound RegisterValue proxy. Fix: call it inside <script setup> or a setup() function \u2014 not from an event handler or async callback.` + (frame !== void 0 ? ` ${frame}` : "")
+  );
+}
+function warnNoParentRV(instance) {
+  if (!__DEV__ || warnedNoParentRV === null) return;
+  if (warnedNoParentRV.has(instance)) return;
+  warnedNoParentRV.add(instance);
+  const frame = captureUserCallSite();
+  console.warn(
+    `[attaform] useRegister: no parent registerValue prop; RegisterValue fields will read as undefined. Pass v-register on the parent: \`<YourComponent v-register="form.register('field')" />\`.` + (frame !== void 0 ? ` ${frame}` : "")
+  );
+}
+
 const LAZY_BRAND = Symbol.for("attaform/wizard-lazy");
 function lazy(resolve) {
   return { [LAZY_BRAND]: true, resolve };
@@ -6969,5 +7089,5 @@ function warnIfAmbientWizardProviderHadDuplicates() {
   }
 }
 
-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
+export { AttaformErrorCode as A, deleteAtPath as B, safeOwnRead as C, DEFAULT_TIMINGS as D, humanize as E, PERSISTENCE_MODULE_KEY as P, injectWizard as a, isUnset as b, useRegister as c, useWizard as d, isPlainRecord as e, safeAssign as f, diffAndApply as g, slimKindOf as h, injectForm as i, applyPatchesForward as j, normalizeNumericOption as k, lazy as l, defaultCoercionRules as m, normalizePersistConfig as n, defaultDisplayState as o, defineCoercion as p, makeDefaultDisplayState as q, useAbstractForm as r, structuralSnapshot as s, getAtPath as t, unset as u, setAtPath as v, resolveStorageKeyBase as w, DEFAULT_PERSISTENCE_DEBOUNCE_MS as x, cleanupOrphanKeys as y, mergeSparseHydration as z };
+//# sourceMappingURL=attaform.CTheKoTc.mjs.map