attaform 0.24.3 → 0.25.0

package/dist/shared/{attaform.B_F61Rx1.mjs → attaform.DK3xUBkj.mjs}

@@ -1,6 +1,6 @@
-import { computed, ref, watchEffect, getCurrentScope, onScopeDispose, shallowReadonly, readonly, toRaw, reactive, watch, markRaw, triggerRef, shallowRef, getCurrentInstance, onServerPrefetch, provide, useId, inject, onBeforeMount, onBeforeUpdate, onMounted, effectScope, nextTick } from 'vue';
-import { n as pathsEqual, j as isPathPrefix, _ as __DEV__, f as canonicalizePath, s as segmentsForPathKey, o as keyForSegments, b as ROOT_PATH_KEY, S as SubmitErrorHandlerError, t as toError, q as INTERACTIVE_TAG_NAMES, R as ROOT_PATH, r as coerceToPathKey, a as InvalidUseFormConfigError, w as ensureAttaformInstalled, u as useRegistry, x as kFormContext, y as kFormInstanceId, d as ReservedFormKeyError, l as kAttaformWizardActiveStepResolver, z as kAttaformAncestorWizard } from './attaform.C5qkSN6t.mjs';
-import { R as REGISTER_OWNER_MARKER, V as V_REGISTER_MARKER } from './attaform.WvcckZMD.mjs';
+import { computed, ref, watchEffect, getCurrentScope, onScopeDispose, shallowReadonly, nextTick, warn, readonly, toRaw, reactive, watch, markRaw, triggerRef, shallowRef, getCurrentInstance, onServerPrefetch, provide, useId, inject, onBeforeMount, onBeforeUpdate, onMounted, effectScope } from 'vue';
+import { n as pathsEqual, j as isPathPrefix, _ as __DEV__, f as canonicalizePath, s as segmentsForPathKey, o as keyForSegments, b as ROOT_PATH_KEY, S as SubmitErrorHandlerError, t as toError, q as INTERACTIVE_TAG_NAMES, R as ROOT_PATH, r as coerceToPathKey, a as InvalidUseFormConfigError, w as ensureAttaformInstalled, u as useRegistry, x as kFormContext, y as kFormInstanceId, d as ReservedFormKeyError, l as kAttaformWizardActiveStepResolver, z as kAttaformAncestorWizard } from './attaform.CqwcTExO.mjs';
+import { R as REGISTER_OWNER_MARKER, b as V_REGISTER_MARKER } from './attaform.Vp2-CWZB.mjs';
 
 function safeAssign(target, key, value) {
   if (key === "__proto__") {
@@ -939,6 +939,15 @@ function buildContainerFieldStateBase(state, segments, key, formInstanceId) {
     if (since !== void 0 && (transformingSince === null || since < transformingSince))
       transformingSince = since;
   }
+  const ownRecord = state.fields.get(key);
+  if (ownRecord !== void 0) {
+    if (ownRecord.focused === true) focused = true;
+    if (ownRecord.blurred === true) blurred = true;
+    if (ownRecord.touched === true) touched = true;
+    if (ownRecord.interacted === true) interacted = true;
+    if (ownRecord.blurredAfterInteraction === true) blurredAfterInteraction = true;
+    if (ownRecord.connected === true) connected = true;
+  }
   const ownTransformError = state.transformErrors.get(key) ?? null;
   const gated = asyncPending && !state.firstValidationDone.value;
   const valid = !gated && errors.length === 0 && !validating;
@@ -2009,11 +2018,11 @@ function applyInvalidSubmitPolicy(state, formInstanceId, policy) {
     return;
   }
   if (policy === "focus-first-error") {
-    target.element.focus();
+    target.element.focus({ focusVisible: true });
     return;
   }
   target.element.scrollIntoView();
-  target.element.focus({ preventScroll: true });
+  target.element.focus({ preventScroll: true, focusVisible: true });
 }
 
 const warnedRejections = __DEV__ ? /* @__PURE__ */ new WeakMap() : null;
@@ -2284,6 +2293,7 @@ function coerceValue(value, accepted, elementAccepted, index) {
   return coerceScalar(value, accepted, index);
 }
 
+const warnedMultiRootHosts = /* @__PURE__ */ new Set();
 const EMPTY_TRANSFORMS = Object.freeze([]);
 const attaformListenersSymbol = Symbol.for("attaform:focus-listeners");
 function attachFocusListeners(state, segments, element, instanceMeta) {
@@ -2388,6 +2398,24 @@ function buildRegister(state, formInstanceId, instanceConfig) {
       setValueWithInternalPath: (value, meta) => {
         return state.setValueAtPath(segments, value, withInstanceMeta(meta));
       },
+      setValueFromHost: (value) => {
+        state.markInteracted(segments);
+        const accepted = state.setValueAtPath(segments, value, withInstanceMeta(void 0));
+        if (__DEV__) {
+          const dedupeKey = `${formInstanceId}:${pathKey}`;
+          const isWired = () => (state.elements.get(pathKey)?.elements.size ?? 0) > 0 || state.getFieldRecord(segments)?.connected === true;
+          if (!warnedMultiRootHosts.has(dedupeKey) && !isWired()) {
+            warnedMultiRootHosts.add(dedupeKey);
+            void nextTick(() => {
+              if (isWired()) return;
+              warn(
+                `[attaform] v-register received a value update from a component it never attached to. Vue drops a runtime directive on a component with more than one root node (a fragment / multi-root template), so v-register's value binding works but its field state (connected, focus, aria, scroll-to-error) does not. Give the component a single element root, or wrap it so v-register lands on one element.`
+              );
+            });
+          }
+        }
+        return accepted;
+      },
       // Called by the `vRegisterHint` compile-time transform's wrapping
       // IIFE on every server-side render of `<element v-register="…">`.
       // Without it, every SSR'd FieldState serialises `connected: false`
@@ -2399,6 +2427,24 @@ function buildRegister(state, formInstanceId, instanceConfig) {
       markConnectedOptimistically: () => {
         state.markConnectedOptimistically(segments);
       },
+      markHostConnected: (connected) => {
+        state.markHostConnected(segments, connected);
+      },
+      markFocused: (focused) => {
+        state.markFocused(
+          segments,
+          focused,
+          instanceMeta !== void 0 ? { instance: instanceMeta } : void 0
+        );
+      },
+      hasRegisteredDescendant: (hostElement) => {
+        const record = state.elements.get(pathKey);
+        if (record === void 0) return false;
+        for (const element of record.elements) {
+          if (hostElement.contains(element)) return true;
+        }
+        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
@@ -3181,7 +3227,7 @@ function buildFormApi(state, formInstanceId, options = {}) {
   const focusFirstError = (options2) => {
     const target = state.getFirstErrorElement(formInstanceId);
     if (target === null) return false;
-    target.element.focus(options2);
+    target.element.focus({ focusVisible: true, ...options2 });
     return true;
   };
   const scrollToFirstError = (options2) => {
@@ -4972,6 +5018,21 @@ function createFormStore(options) {
       blurred: current?.blurred ?? true
     });
   }
+  function markHostConnected(path, connected) {
+    const { key } = canonicalizePath(path);
+    const current = fields.get(key);
+    if (connected) {
+      if (current?.connected === true) return;
+      touchFieldRecord(key, path, {
+        connected: true,
+        focused: current?.focused ?? false,
+        blurred: current?.blurred ?? true
+      });
+    } else {
+      if (current?.connected !== true) return;
+      touchFieldRecord(key, path, { connected: false, focused: null, blurred: null });
+    }
+  }
   function markFocused(path, focused, meta) {
     const { key } = canonicalizePath(path);
     const current = fields.get(key);
@@ -5303,10 +5364,7 @@ function createFormStore(options) {
       if (elementToFormInstance.get(entry.element) !== formInstanceId) continue;
       if (!entry.element.isConnected) continue;
       if (entry.element.offsetParent === null) continue;
-      const { key } = canonicalizePath(entry.path);
-      const hasSchemaErr = (schemaErrors.get(key)?.length ?? 0) > 0;
-      const hasUserErr = (userErrors.get(key)?.length ?? 0) > 0;
-      if (!hasSchemaErr && !hasUserErr) continue;
+      if (getErrorsForPath(entry.path).length === 0) continue;
       return { path: entry.path, element: entry.element };
     }
     return null;
@@ -5381,6 +5439,7 @@ function createFormStore(options) {
     markInteracted,
     touchAtPath,
     markConnectedOptimistically,
+    markHostConnected,
     isPristineAtPath,
     isPristineAtPathByKey,
     hasStructuralChangeUnder,
@@ -5885,7 +5944,7 @@ function resolveState(key, registry) {
   if (key !== void 0) {
     const stored = registry.forms.get(key);
     if (stored === void 0) {
-      warnMiss$1(`no form registered for key '${key}'`, registry.ssr);
+      warnMiss$1(`no form registered for key '${key}'`, registry.ssr, registry.forms);
       return null;
     }
     return stored;
@@ -5895,12 +5954,22 @@ function resolveState(key, registry) {
   warnIfAmbientProviderHadDuplicates();
   return ambient;
 }
-function warnMiss$1(detail, ssr) {
+function availableKeysHint$1(forms) {
+  const addressable = [...forms.keys()].filter((key) => !key.startsWith(RESERVED_KEY_PREFIX));
+  if (addressable.length === 0) return void 0;
+  return `Registered keys: ${addressable.map((key) => `'${key}'`).join(", ")}.`;
+}
+function warnMiss$1(detail, ssr, forms) {
   if (!__DEV__ || ssr) return;
   const frame = captureUserCallSite();
-  console.warn(
-    `[attaform] injectForm: ${detail}. Returning null.` + (frame !== void 0 ? ` ${frame}` : "")
+  const parts = [`[attaform] injectForm: ${detail}. Returning null.`];
+  const keys = availableKeysHint$1(forms);
+  if (keys !== void 0) parts.push(keys);
+  parts.push(
+    `A form created by a child or sibling component is not registered until that component's own setup runs, which happens after this point. Lift its useForm({ key }) call to a common ancestor, or read the form after mount.`
   );
+  if (frame !== void 0) parts.push(frame);
+  console.warn(parts.join(" "));
 }
 function warnIfAmbientProviderHadDuplicates() {
   if (!__DEV__ || ambientProvideHistory === null) return;
@@ -5979,6 +6048,8 @@ function useRegister() {
       }
     }
     if ("value" in rawAttrs) delete rawAttrs["value"];
+    if ("modelValue" in rawAttrs) delete rawAttrs["modelValue"];
+    if ("onUpdate:modelValue" in rawAttrs) delete rawAttrs["onUpdate:modelValue"];
   };
   refreshAndStripBridgeAttrs();
   onBeforeMount(refreshAndStripBridgeAttrs);
@@ -6158,6 +6229,9 @@ function asStatusSource(form) {
 function asSubmissionSource(form) {
   return form;
 }
+function asHandleSubmitSource(form) {
+  return form;
+}
 function useWizard(options) {
   const rawSteps = Array.isArray(options.steps) ? options.steps : [];
   if (rawSteps.length === 0 && __DEV__) {
@@ -6252,6 +6326,7 @@ function useWizard(options) {
     }
   };
   function resolveSlot(slot, index, ctx) {
+    if (slot === void 0 || slot === null) return void 0;
     if (typeof slot === "string") {
       return getOrBuildNoop(slot);
     }
@@ -6267,7 +6342,7 @@ function useWizard(options) {
     return void 0;
   }
   function resolveSlotResult(result) {
-    if (result === void 0) return void 0;
+    if (result === void 0 || result === null) return void 0;
     if (typeof result === "string") {
       return getOrBuildNoop(result);
     }
@@ -6335,6 +6410,50 @@ function useWizard(options) {
     const first = list[0];
     return first === void 0 ? void 0 : first.form;
   });
+  watch(compiledSteps, (list, prevList) => {
+    const key = activeKey.value;
+    if (key === "") return;
+    if (list.some((step) => step.key === key)) return;
+    if (list.length === 0) {
+      activeKey.value = "";
+      return;
+    }
+    const oldIndex = prevList.findIndex((step) => step.key === key);
+    const slid = list[oldIndex < 0 ? 0 : Math.min(oldIndex, list.length - 1)];
+    if (slid !== void 0) activeKey.value = slid.key;
+  });
+  const activeFormFacade = new Proxy({}, {
+    get(_target, prop) {
+      const form = activeForm.value;
+      if (form === void 0) return void 0;
+      if (prop === "handleSubmit") {
+        const lateBound = (onValid, onInvalid) => {
+          return (event) => {
+            const current = activeForm.value;
+            if (current === void 0) return Promise.resolve();
+            return asHandleSubmitSource(current).handleSubmit(onValid, onInvalid)(event);
+          };
+        };
+        return lateBound;
+      }
+      return Reflect.get(form, prop, form);
+    },
+    has(_target, prop) {
+      const form = activeForm.value;
+      return form === void 0 ? false : Reflect.has(form, prop);
+    },
+    ownKeys(_target) {
+      const form = activeForm.value;
+      return form === void 0 ? [] : Reflect.ownKeys(form);
+    },
+    getOwnPropertyDescriptor(_target, prop) {
+      const form = activeForm.value;
+      if (form === void 0) return void 0;
+      const descriptor = Reflect.getOwnPropertyDescriptor(form, prop);
+      if (descriptor === void 0) return void 0;
+      return { ...descriptor, configurable: true };
+    }
+  });
   const isFinalStep = computed(() => {
     const list = compiledSteps.value;
     const idx = activeIndex.value;
@@ -6699,6 +6818,39 @@ function useWizard(options) {
     const target = list[idx + 1];
     moveTo(target.key);
   }
+  async function tryNext() {
+    if (submitting.value) {
+      if (__DEV__) {
+        console.warn(`[attaform] wizard.tryNext(): blocked while a submit is in flight.`);
+      }
+      return false;
+    }
+    const list = compiledSteps.value;
+    if (list.length === 0) {
+      if (__DEV__) {
+        console.warn(`[attaform] wizard.tryNext(): wizard has no compiled steps; no-op.`);
+      }
+      return false;
+    }
+    const idx = activeIndex.value;
+    if (idx < 0 || idx >= list.length - 1) {
+      if (__DEV__) {
+        console.warn(
+          `[attaform] wizard.tryNext(): already on the final step ("${activeKey.value}"). Use wizard.handleSubmit() to submit.`
+        );
+      }
+      return false;
+    }
+    const form = activeForm.value;
+    if (form === void 0) return false;
+    let advanced = false;
+    await asHandleSubmitSource(form).handleSubmit(() => {
+      const before = activeKey.value;
+      next();
+      advanced = activeKey.value !== before;
+    })();
+    return advanced;
+  }
   function back() {
     if (submitting.value) {
       if (__DEV__) {
@@ -6835,20 +6987,13 @@ function useWizard(options) {
         const final = isFinalStep.value;
         const list = compiledSteps.value;
         const results = /* @__PURE__ */ new Map();
-        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);
-        }
+        await Promise.all(
+          list.map(async (step) => {
+            registry.forms.get(step.key)?.clearUserErrors();
+            const result = await processOne(step.form);
+            results.set(step.key, result);
+          })
+        );
         for (const key of results.keys()) {
           const store = registry.forms.get(key);
           if (store !== void 0) {
@@ -6883,14 +7028,7 @@ function useWizard(options) {
             }
             return;
           }
-          if (final) {
-            done.value = true;
-          } else {
-            recordDeparture(currentKey);
-            const idx = activeIndex.value;
-            const target = list[idx + 1];
-            if (target !== void 0) moveTo(target.key);
-          }
+          done.value = true;
         } else {
           await focusFirstWizardError(errors);
           if (onError !== void 0) {
@@ -6940,13 +7078,14 @@ function useWizard(options) {
     next,
     back,
     goTo,
+    tryNext,
     handleSubmit,
     reset,
     get currentStep() {
       return currentStep.value;
     },
     get activeForm() {
-      return activeForm.value;
+      return activeForm.value === void 0 ? void 0 : activeFormFacade;
     },
     get activeIndex() {
       return activeIndex.value;
@@ -7078,6 +7217,9 @@ function warnMiss(detail, ssr, hint) {
   const frame = captureUserCallSite();
   const parts = [`[attaform] injectWizard: ${detail}. Returning null.`];
   if (hint !== void 0) parts.push(hint);
+  parts.push(
+    `A wizard created by a child or sibling component is not registered until that component's own setup runs, which happens after this point. Lift its useWizard({ key }) call to a common ancestor, or read the wizard after mount.`
+  );
   if (frame !== void 0) parts.push(frame);
   console.warn(parts.join(" "));
 }
@@ -7100,4 +7242,4 @@ function warnIfAmbientWizardProviderHadDuplicates() {
 }
 
 export { AttaformErrorCode as A, DEFAULT_TIMINGS as D, injectWizard as a, isUnset as b, useRegister as c, useWizard as d, defaultCoercionRules as e, defaultDisplayState as f, defineCoercion as g, useAbstractForm as h, injectForm as i, isPlainRecord as j, safeAssign as k, lazy as l, makeDefaultDisplayState as m, slimKindOf as n, humanize as o, getAtPath as p, setAtPath as q, safeOwnRead as s, unset as u };
-//# sourceMappingURL=attaform.B_F61Rx1.mjs.map
+//# sourceMappingURL=attaform.DK3xUBkj.mjs.map