attaform 0.27.4 → 0.27.6

package/dist/shared/{attaform.Cjh6b6xU.d.cts → attaform.F2Q8iv38.d.ts}

@@ -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.cjs';
+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.js';
 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.gj8dtOlx.d.mts → attaform.FmqKO1Ex.d.cts}

@@ -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.mjs';
+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.cjs';
 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.C8zVmank.d.ts → attaform.Fp3sCrVs.d.ts}

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { G as GenericForm, s as FlatPath, B as NestedType, F as FormKey, U as UseFormConfiguration, A as AbstractSchema, aq as AcceptableDefaults, ae as ValidateOnConfig, a as UseFormReturnType } from './attaform.BIPSHY5U.js';
+import { G as GenericForm, s as FlatPath, B as NestedType, F as FormKey, U as UseFormConfiguration, A as AbstractSchema, aq as AcceptableDefaults, ae as ValidateOnConfig, a as UseFormReturnType } from './attaform.DniawQLP.js';
 
 /**
  * The Zod v4 schema roots `useForm` accepts. A fixed-shape

package/dist/shared/{attaform.CgsQZdy1.mjs → attaform.nMaz2C5P.mjs}

@@ -1380,7 +1380,7 @@ function latchHostControl(el, rv, control) {
   componentHostLatch.set(el, control);
 }
 function setupNoLatchHost(el, rv) {
-  rv.markHostConnected(true);
+  rv.markHostConnected(true, el);
   const focusin = (event) => {
     const from = event.relatedTarget;
     if (from instanceof Node && el.contains(from)) return;
@@ -1510,7 +1510,7 @@ const vRegisterDynamic = {
       if (latchedControl != null) {
         teardownAria(latchedControl);
         value.deregisterElement(latchedControl);
-      } else value.markHostConnected(false);
+      } else value.markHostConnected(false, el);
       componentHostLatch.delete(el);
     }
     delete el.composing;
@@ -1672,4 +1672,4 @@ function hydrateAttaformState(app, payload) {
 const DEVTOOLS_WINDOW_KEY = "__attaform_devtools__";
 
 export { AttaformError as A, kFormContext as B, kFormInstanceId as C, DEVTOOLS_WINDOW_KEY as D, kAttaformAncestorWizard as E, InvalidPathError as I, OutsideSetupError as O, ROOT_PATH as R, SubmitErrorHandlerError as S, __DEV__ as _, InvalidUseFormConfigError as a, ROOT_PATH_KEY as b, RegistryNotInstalledError as c, ReservedFormKeyError as d, assignKey as e, canonicalizePath as f, createAttaform as g, createRegistry as h, getRegistryFromApp as i, hydrateAttaformState as j, isPathPrefix as k, kAttaformRegistry as l, kAttaformWizardActiveStepResolver as m, pathsEqual as n, keyForSegments as o, parseDottedPath as p, normalizeErrorInput as q, renderAttaformState as r, segmentsForPathKey as s, toError as t, useRegistry as u, vRegister as v, INTERACTIVE_TAG_NAMES as w, normalizeErrorInputs as x, coerceToPathKey as y, ensureAttaformInstalled as z };
-//# sourceMappingURL=attaform.CgsQZdy1.mjs.map
+//# sourceMappingURL=attaform.nMaz2C5P.mjs.map