attaform 0.24.3 → 0.25.0

package/dist/shared/{attaform.CB1kYKUB.cjs → attaform.BkUzunyB.cjs}

@@ -1,8 +1,8 @@
 'use strict';
 
 const vue = require('vue');
-const paths = require('./attaform.DQcdvxKZ.cjs');
-const registerProtocol = require('./attaform.CjdepGnw.cjs');
+const paths = require('./attaform.3heDHayA.cjs');
+const registerProtocol = require('./attaform.ZXZ6dH72.cjs');
 
 function safeAssign(target, key, value) {
   if (key === "__proto__") {
@@ -941,6 +941,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;
@@ -2011,11 +2020,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 = paths.__DEV__ ? /* @__PURE__ */ new WeakMap() : null;
@@ -2286,6 +2295,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) {
@@ -2390,6 +2400,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 (paths.__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 vue.nextTick(() => {
+              if (isWired()) return;
+              vue.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`
@@ -2401,6 +2429,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
@@ -3183,7 +3229,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) => {
@@ -4974,6 +5020,21 @@ function createFormStore(options) {
       blurred: current?.blurred ?? true
     });
   }
+  function markHostConnected(path, connected) {
+    const { key } = paths.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 } = paths.canonicalizePath(path);
     const current = fields.get(key);
@@ -5305,10 +5366,7 @@ function createFormStore(options) {
       if (elementToFormInstance.get(entry.element) !== formInstanceId) continue;
       if (!entry.element.isConnected) continue;
       if (entry.element.offsetParent === null) continue;
-      const { key } = paths.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;
@@ -5383,6 +5441,7 @@ function createFormStore(options) {
     markInteracted,
     touchAtPath,
     markConnectedOptimistically,
+    markHostConnected,
     isPristineAtPath,
     isPristineAtPathByKey,
     hasStructuralChangeUnder,
@@ -5887,7 +5946,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;
@@ -5897,12 +5956,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 (!paths.__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 (!paths.__DEV__ || ambientProvideHistory === null) return;
@@ -5981,6 +6050,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();
   vue.onBeforeMount(refreshAndStripBridgeAttrs);
@@ -6160,6 +6231,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 && paths.__DEV__) {
@@ -6254,6 +6328,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);
     }
@@ -6269,7 +6344,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);
     }
@@ -6337,6 +6412,50 @@ function useWizard(options) {
     const first = list[0];
     return first === void 0 ? void 0 : first.form;
   });
+  vue.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 = vue.computed(() => {
     const list = compiledSteps.value;
     const idx = activeIndex.value;
@@ -6701,6 +6820,39 @@ function useWizard(options) {
     const target = list[idx + 1];
     moveTo(target.key);
   }
+  async function tryNext() {
+    if (submitting.value) {
+      if (paths.__DEV__) {
+        console.warn(`[attaform] wizard.tryNext(): blocked while a submit is in flight.`);
+      }
+      return false;
+    }
+    const list = compiledSteps.value;
+    if (list.length === 0) {
+      if (paths.__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 (paths.__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 (paths.__DEV__) {
@@ -6837,20 +6989,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) {
@@ -6885,14 +7030,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) {
@@ -6942,13 +7080,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;
@@ -7080,6 +7219,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(" "));
 }
@@ -7122,4 +7264,4 @@ exports.unset = unset;
 exports.useAbstractForm = useAbstractForm;
 exports.useRegister = useRegister;
 exports.useWizard = useWizard;
-//# sourceMappingURL=attaform.CB1kYKUB.cjs.map
+//# sourceMappingURL=attaform.BkUzunyB.cjs.map