attaform 0.27.4 → 0.27.6

package/dist/shared/{attaform.DKtXMaJB.d.ts → attaform.CHlJLAiv.d.mts}

@@ -1,4 +1,4 @@
-import { G as GenericForm, F as FormKey, a as UseFormReturnType, a4 as RegisterValue, T as PathKey, k as DisplayCtx, w as GetDisplayState, l as DisplayMachine, S as Path, a9 as SlimPrimitiveKind, C as CoercionEntry, e as CoercionRegistry, af as ValidationError, A as AbstractSchema, aj as WriteMeta, h as DeepPartial, ak as WriteShape, as as TransformAbortHolder, ad as ValidateOn, d as AttaformDefaults, at as RegisterModelDynamicCustomDirective } from './attaform.BIPSHY5U.js';
+import { G as GenericForm, F as FormKey, a as UseFormReturnType, a4 as RegisterValue, T as PathKey, k as DisplayCtx, w as GetDisplayState, l as DisplayMachine, S as Path, a9 as SlimPrimitiveKind, C as CoercionEntry, e as CoercionRegistry, af as ValidationError, A as AbstractSchema, aj as WriteMeta, h as DeepPartial, ak as WriteShape, as as TransformAbortHolder, ad as ValidateOn, d as AttaformDefaults, at as RegisterModelDynamicCustomDirective } from './attaform.DniawQLP.mjs';
 import { Ref, ComputedRef, App, InjectionKey, Plugin } from 'vue';
 
 /**
@@ -758,6 +758,16 @@ type FormStore<F extends GenericForm, G extends GenericForm = F> = {
      * does not mutate value / focused / blurred or trigger validation.
      */
     touchAtPath(segments: Path): void;
+    /**
+     * Walk every active-variant leaf under `segments` and flip the full
+     * interaction ladder (`touched` / `interacted` /
+     * `blurredAfterInteraction`), as though the user had focused,
+     * edited, and left each one. Powers `form.interact(path?)`.
+     * Idempotent; does not mutate value / focused / blurred. Returns
+     * whether any leaf resolved, so the caller can skip validation and
+     * dev-warn on an empty path.
+     */
+    interactAtPath(segments: Path): boolean;
     /**
      * SSR-only optimistic mark: flip `connected: true` on the field
      * record without an actual DOM element. Called by the `vRegisterHint`
@@ -773,8 +783,14 @@ type FormStore<F extends GenericForm, G extends GenericForm = F> = {
      * (a composite widget, or none found). The directive calls it on mount
      * (`true`) and unmount (`false`). Distinct from the SSR-only
      * `markConnectedOptimistically`; idempotent on the leading edge.
+     *
+     * `hostEl` (the host root) is recorded on connect as this path's
+     * focus-first-error anchor, scoped to `formInstanceId` the same way a
+     * registered control is. A no-latch host enters no `elements` record, so
+     * without this it is absent from `getFirstErrorElement`'s walk; the anchor
+     * lets that walk resolve a focus target from the host subtree.
      */
-    markHostConnected(path: Path, connected: boolean): void;
+    markHostConnected(path: Path, connected: boolean, hostEl: HTMLElement, formInstanceId: string): void;
     /**
      * Leaf-only pristine check. `originals` is populated via
      * `diffAndApply`'s `added` patches, which fire only on primitive

package/dist/shared/{attaform.CuUx4jWI.mjs → attaform.CKH2lGdL.mjs}

@@ -1,5 +1,5 @@
 import { computed, ref, watchEffect, getCurrentScope, onScopeDispose, shallowReadonly, nextTick, warn, readonly, toRaw, reactive, toValue, watch, markRaw, triggerRef, shallowRef, getCurrentInstance, onServerPrefetch, provide, useId, inject, onBeforeMount, onBeforeUpdate, onMounted, effectScope } from 'vue';
-import { n as pathsEqual, k 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 normalizeErrorInput, w as INTERACTIVE_TAG_NAMES, R as ROOT_PATH, x as normalizeErrorInputs, y as coerceToPathKey, a as InvalidUseFormConfigError, z as ensureAttaformInstalled, u as useRegistry, B as kFormContext, C as kFormInstanceId, d as ReservedFormKeyError, m as kAttaformWizardActiveStepResolver, E as kAttaformAncestorWizard } from './attaform.CgsQZdy1.mjs';
+import { n as pathsEqual, k 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 normalizeErrorInput, w as INTERACTIVE_TAG_NAMES, R as ROOT_PATH, x as normalizeErrorInputs, y as coerceToPathKey, a as InvalidUseFormConfigError, z as ensureAttaformInstalled, u as useRegistry, B as kFormContext, C as kFormInstanceId, d as ReservedFormKeyError, m as kAttaformWizardActiveStepResolver, E as kAttaformAncestorWizard } from './attaform.nMaz2C5P.mjs';
 import { R as REGISTER_OWNER_MARKER, b as V_REGISTER_MARKER } from './attaform.KvlEedlF.mjs';
 
 function safeAssign(target, key, value) {
@@ -624,7 +624,9 @@ function computeVerdict(field, formMeta) {
     (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";
+  if (field.valid === true && field.blank !== true && (field.dirty === true || field.interacted === true)) {
+    return "success";
+  }
   return "idle";
 }
 function earliestNonNull(a, b) {
@@ -2507,8 +2509,8 @@ function buildRegister(state, formInstanceId, instanceConfig) {
       markConnectedOptimistically: () => {
         state.markConnectedOptimistically(segments);
       },
-      markHostConnected: (connected) => {
-        state.markHostConnected(segments, connected);
+      markHostConnected: (connected, hostEl) => {
+        state.markHostConnected(segments, connected, hostEl, formInstanceId);
       },
       markFocused: (focused) => {
         state.markFocused(
@@ -3312,6 +3314,14 @@ function buildFormApi(state, formInstanceId, options = {}) {
     const segments = pathInput === void 0 ? ROOT_PATH : canonicalizePath(pathInput).segments;
     state.touchAtPath(segments);
   }
+  async function interact(pathInput) {
+    const segments = pathInput === void 0 ? ROOT_PATH : canonicalizePath(pathInput).segments;
+    if (!state.interactAtPath(segments)) return;
+    try {
+      await validateAsyncBuilt(pathInput === void 0 ? void 0 : segments);
+    } catch {
+    }
+  }
   const focusFirstError = (options2) => {
     const target = state.getFirstErrorElement(formInstanceId);
     if (target === null) return false;
@@ -3458,6 +3468,7 @@ function buildFormApi(state, formInstanceId, options = {}) {
     scrollToFirstError: gated(scrollToFirstError),
     applyInvalidSubmitPolicy: gated(applyInvalidSubmitPolicyPublic),
     touch: gated(touch),
+    interact: gated(interact),
     get history() {
       void state.activate();
       return formHistory;
@@ -4066,6 +4077,25 @@ function mergeObjectKeys(target, source, path, schema) {
 }
 
 const isContainer = (value) => Array.isArray(value) || isPlainRecord(value);
+const HOST_FOCUS_TARGET_SELECTOR = [
+  'input:not([type="hidden"])',
+  "select",
+  "textarea",
+  "button",
+  "a[href]",
+  '[tabindex]:not([tabindex="-1"])',
+  '[contenteditable="true"]'
+].join(", ");
+function resolveHostFocusTarget(hostRoot) {
+  const candidates = hostRoot.querySelectorAll(HOST_FOCUS_TARGET_SELECTOR);
+  for (const el of candidates) {
+    if (!el.isConnected) continue;
+    if (el.offsetParent === null) continue;
+    if (el.matches(":disabled")) continue;
+    return el;
+  }
+  return hostRoot;
+}
 function isHydratedFieldRecord(value) {
   if (typeof value !== "object" || value === null) return false;
   const r = value;
@@ -4251,6 +4281,7 @@ function createFormStore(options) {
   const fields = reactive(/* @__PURE__ */ new Map());
   const elements = reactive(/* @__PURE__ */ new Map());
   const elementToFormInstance = /* @__PURE__ */ new WeakMap();
+  const hostTargets = /* @__PURE__ */ new Map();
   let sortedRegistrationsCache = null;
   const schemaErrors = reactive(/* @__PURE__ */ new Map());
   const userErrors = reactive(/* @__PURE__ */ new Map());
@@ -5123,6 +5154,7 @@ function createFormStore(options) {
       record.elements.add(raw);
     }
     elementToFormInstance.set(element, formInstanceId);
+    hostTargets.delete(key);
     sortedRegistrationsCache = null;
     const current = fields.get(key);
     touchFieldRecord(key, path, {
@@ -5160,10 +5192,14 @@ function createFormStore(options) {
       blurred: current?.blurred ?? true
     });
   }
-  function markHostConnected(path, connected) {
+  function markHostConnected(path, connected, hostEl, formInstanceId) {
     const { key } = canonicalizePath(path);
     const current = fields.get(key);
     if (connected) {
+      if (!elements.has(key)) {
+        hostTargets.set(key, { path, hostRoot: hostEl, formInstanceId });
+        sortedRegistrationsCache = null;
+      }
       if (current?.connected === true) return;
       touchFieldRecord(key, path, {
         connected: true,
@@ -5171,6 +5207,7 @@ function createFormStore(options) {
         blurred: current?.blurred ?? true
       });
     } else {
+      if (hostTargets.delete(key)) sortedRegistrationsCache = null;
       if (current?.connected !== true) return;
       touchFieldRecord(key, path, { connected: false, focused: null, blurred: null });
     }
@@ -5247,6 +5284,32 @@ function createFormStore(options) {
       );
     }
   }
+  function interactAtPath(segments) {
+    if (effectiveDisabled.value) return false;
+    const formValue = form.value;
+    let interactedAny = false;
+    for (const [, entry] of originals) {
+      if (!isPathPrefix(segments, entry.segments)) continue;
+      if (!hasAtPath(formValue, entry.segments)) continue;
+      interactedAny = true;
+      const leafKey = canonicalizePath(entry.segments).key;
+      const current = fields.get(leafKey);
+      if (current?.touched === true && current.interacted === true && current.blurredAfterInteraction === true) {
+        continue;
+      }
+      touchFieldRecord(leafKey, entry.segments, {
+        touched: true,
+        interacted: true,
+        blurredAfterInteraction: true
+      });
+    }
+    if (!interactedAny && __DEV__) {
+      console.warn(
+        `[attaform] form.interact(): no fields resolved at path ${JSON.stringify(segments)}. Check the path matches an existing field or container.`
+      );
+    }
+    return interactedAny;
+  }
   function rehydrate() {
     const factory = defaultValuesFactory.value;
     if (factory === void 0) {
@@ -5505,18 +5568,35 @@ function createFormStore(options) {
   function getFirstErrorElement(formInstanceId) {
     sortedRegistrationsCache ?? (sortedRegistrationsCache = rebuildSortedRegistrations());
     for (const entry of sortedRegistrationsCache) {
-      if (elementToFormInstance.get(entry.element) !== formInstanceId) continue;
+      if (entry.formInstanceId !== formInstanceId) continue;
       if (!entry.element.isConnected) continue;
       if (entry.element.offsetParent === null) continue;
       if (getErrorsForPath(entry.path).length === 0) continue;
-      return { path: entry.path, element: entry.element };
+      const element = entry.host ? resolveHostFocusTarget(entry.element) : entry.element;
+      return { path: entry.path, element };
     }
     return null;
   }
   function rebuildSortedRegistrations() {
     const flat = [];
     for (const [, record] of elements) {
-      for (const el of record.elements) flat.push({ path: record.path, element: el });
+      for (const el of record.elements) {
+        flat.push({
+          path: record.path,
+          element: el,
+          host: false,
+          formInstanceId: elementToFormInstance.get(el) ?? ""
+        });
+      }
+    }
+    for (const [key, target] of hostTargets) {
+      if (elements.has(key)) continue;
+      flat.push({
+        path: target.path,
+        element: target.hostRoot,
+        host: true,
+        formInstanceId: target.formInstanceId
+      });
     }
     flat.sort(
       (a, b) => a.element.compareDocumentPosition(b.element) & Node.DOCUMENT_POSITION_FOLLOWING ? -1 : 1
@@ -5584,6 +5664,7 @@ function createFormStore(options) {
     markFocused,
     markInteracted,
     touchAtPath,
+    interactAtPath,
     markConnectedOptimistically,
     markHostConnected,
     isPristineAtPath,
@@ -7589,4 +7670,4 @@ function escapeForInlineScript(json) {
 }
 
 export { AttaformErrorCode as A, DEFAULT_TIMINGS as D, defaultDisplayState as a, defineCoercion as b, injectWizard as c, defaultCoercionRules as d, escapeForInlineScript as e, isUnset as f, gate as g, useAbstractForm as h, injectForm as i, useRegister as j, useWizard as k, lazy as l, makeDefaultDisplayState as m, isPlainRecord as n, safeAssign as o, slimKindOf as p, humanize as q, getAtPath as r, safeOwnRead as s, setAtPath as t, unset as u };
-//# sourceMappingURL=attaform.CuUx4jWI.mjs.map
+//# sourceMappingURL=attaform.CKH2lGdL.mjs.map