attaform 0.18.2 → 0.20.0

package/dist/runtime/plugins/attaform.cjs

@@ -1,8 +1,8 @@
 'use strict';
 
 const app = require('nuxt/app');
-const devtoolsShared = require('../../shared/attaform.5UhpSVFI.cjs');
-const paths = require('../../shared/attaform.BqK_L4gK.cjs');
+const devtoolsShared = require('../../shared/attaform.BPxsYtTe.cjs');
+const paths = require('../../shared/attaform.BPy-4qRx.cjs');
 
 var attaform_default = app.defineNuxtPlugin({
   // `enforce: 'pre'` makes the "we run before any component's setup" claim

package/dist/runtime/plugins/attaform.mjs

@@ -1,6 +1,6 @@
 import { defineNuxtPlugin, useRuntimeConfig, useRoute } from 'nuxt/app';
-import { a as renderAttaformState, h as hydrateAttaformState, D as DEVTOOLS_WINDOW_KEY } from '../../shared/attaform.Dl161U6E.mjs';
-import { l as createAttaform, y as kAttaformWizardActiveStepResolver, s as getRegistryFromApp } from '../../shared/attaform.CDmaxrt2.mjs';
+import { r as renderAttaformState, h as hydrateAttaformState, D as DEVTOOLS_WINDOW_KEY } from '../../shared/attaform.EZG6fOFb.mjs';
+import { m as createAttaform, x as kAttaformWizardActiveStepResolver, r as getRegistryFromApp } from '../../shared/attaform.BKozEdTr.mjs';
 
 var attaform_default = defineNuxtPlugin({
   // `enforce: 'pre'` makes the "we run before any component's setup" claim

package/dist/shared/{attaform.CDmaxrt2.mjs → attaform.BKozEdTr.mjs}

@@ -1,4 +1,4 @@
-import { shallowReactive, getCurrentInstance, inject, shallowRef, onBeforeMount, onBeforeUpdate, onMounted, nextTick, warn, isRef, effectScope, watch } from 'vue';
+import { shallowReactive, getCurrentInstance, inject, shallowRef, onBeforeMount, onBeforeUpdate, onMounted, effectScope, watch, warn, nextTick, isRef } from 'vue';
 
 const __DEV__ = typeof process !== "undefined" && process.env["NODE_ENV"] !== "production";
 
@@ -43,14 +43,6 @@ class ReservedFormKeyError extends AttaformError {
     );
   }
 }
-class SensitivePersistFieldError extends AttaformError {
-  constructor(path) {
-    const display = Array.isArray(path) ? path.join(".") : String(path);
-    super(
-      `[attaform] Refusing to persist "${display}" \u2014 this path matches a sensitive-name pattern (password / cvv / ssn / token / etc.). Storing sensitive data in client-side storage is a compliance risk (HIPAA / PII / PCI-DSS / SOC2). Fix: persist this server-side, OR pass \`acknowledgeSensitive: true\` to register() (or form.persist()) if the client-side persistence is intentional.`
-    );
-  }
-}
 class AnonPersistError extends AttaformError {
   constructor(opts) {
     super(formatAnonPersistMessage(opts));
@@ -404,6 +396,197 @@ function warnNoParentRV(instance) {
   );
 }
 
+const MANAGED_ARIA_ATTRS = [
+  "aria-invalid",
+  "aria-busy",
+  "aria-required",
+  "aria-describedby"
+];
+const ariaLockKey = Symbol.for("attaform:aria-locks");
+const ariaScopeKey = Symbol.for("attaform:aria-scope");
+const EMPTY_ARIA_LOCKS = /* @__PURE__ */ new Set();
+function mergeAriaLocks(el, vnode) {
+  let locks = el[ariaLockKey];
+  if (locks === void 0) {
+    locks = /* @__PURE__ */ new Set();
+    el[ariaLockKey] = locks;
+  }
+  const props = vnode.props;
+  if (props !== null) {
+    for (const attr of MANAGED_ARIA_ATTRS) {
+      if (attr in props) locks.add(attr);
+    }
+  }
+  return locks;
+}
+function setAriaAttr(el, attr, value) {
+  if (value === null) el.removeAttribute(attr);
+  else el.setAttribute(attr, value);
+}
+function resolveAriaValue(attr, rv, ds) {
+  switch (attr) {
+    case "aria-invalid":
+      return ds === "error" ? "true" : null;
+    case "aria-busy":
+      return ds === "pending" ? "true" : null;
+    case "aria-required":
+      return rv.isRequired === true ? "true" : null;
+    case "aria-describedby":
+      return ds === "error" && rv.aria?.errorId !== void 0 ? rv.aria.errorId : null;
+    default:
+      return null;
+  }
+}
+function applyAria(el, rv) {
+  if (rv.ariaEnabled !== true || rv.ariaDisplayState === void 0) return;
+  const locks = el[ariaLockKey] ?? EMPTY_ARIA_LOCKS;
+  const ds = rv.ariaDisplayState.value;
+  for (const attr of MANAGED_ARIA_ATTRS) {
+    if (!locks.has(attr)) setAriaAttr(el, attr, resolveAriaValue(attr, rv, ds));
+  }
+}
+function setupAria(el, rv, vnode) {
+  if (rv.ariaEnabled !== true || rv.ariaDisplayState === void 0) return;
+  mergeAriaLocks(el, vnode);
+  applyAria(el, rv);
+  const displayState = rv.ariaDisplayState;
+  const scope = effectScope(true);
+  scope.run(() => {
+    watch(displayState, () => applyAria(el, rv), { flush: "post" });
+  });
+  el[ariaScopeKey] = () => scope.stop();
+}
+function getSSRAriaProps(rv, vnode) {
+  if (rv.ariaEnabled !== true || rv.ariaDisplayState === void 0) return void 0;
+  const props = vnode?.props ?? null;
+  const ds = rv.ariaDisplayState.value;
+  const out = {};
+  for (const attr of MANAGED_ARIA_ATTRS) {
+    if (props !== null && attr in props) continue;
+    const value = resolveAriaValue(attr, rv, ds);
+    if (value !== null) out[attr] = value;
+  }
+  return out;
+}
+function teardownAria(el) {
+  const stop = el[ariaScopeKey];
+  if (stop === void 0) return;
+  stop();
+  delete el[ariaScopeKey];
+  const locks = el[ariaLockKey] ?? EMPTY_ARIA_LOCKS;
+  for (const attr of MANAGED_ARIA_ATTRS) {
+    if (!locks.has(attr)) el.removeAttribute(attr);
+  }
+  delete el[ariaLockKey];
+}
+
+const listenersKey = Symbol.for("attaform:directive-listeners");
+function addTrackedListener(el, event, handler, options) {
+  el.addEventListener(event, handler, options);
+  const carrier = el;
+  const bag = carrier[listenersKey] ?? [];
+  bag.push({ event, handler, options });
+  carrier[listenersKey] = bag;
+}
+function removeTrackedListeners(el) {
+  const carrier = el;
+  const bag = carrier[listenersKey];
+  if (bag === void 0) return;
+  for (const { event, handler, options } of bag) {
+    el.removeEventListener(event, handler, options);
+  }
+  delete carrier[listenersKey];
+}
+function noteInteraction(value) {
+  if (isRegisterValueLike(value)) value.markInteracted();
+}
+function isRegisterValueLike(val) {
+  return typeof val === "object" && val !== null && "markInteracted" in val && typeof val.markInteracted === "function";
+}
+
+function isBlankFileValue(value) {
+  if (value === null || value === void 0) return true;
+  if (Array.isArray(value) && value.length === 0) return true;
+  if (typeof FileList !== "undefined" && value instanceof FileList && value.length === 0)
+    return true;
+  return false;
+}
+function readFilesFromInput(el) {
+  const files = el.files;
+  if (el.multiple) {
+    return files === null ? [] : Array.from(files);
+  }
+  if (files === null || files.length === 0) return null;
+  return files.item(0);
+}
+const warnedPersistedFileForms = __DEV__ ? /* @__PURE__ */ new WeakMap() : null;
+function maybeWarnPersistedFile(value) {
+  if (!__DEV__ || warnedPersistedFileForms === null) return;
+  if (value.persist !== true) return;
+  let warnedPaths = warnedPersistedFileForms.get(value.persistOptIns);
+  if (warnedPaths === void 0) {
+    warnedPaths = /* @__PURE__ */ new Set();
+    warnedPersistedFileForms.set(value.persistOptIns, warnedPaths);
+  }
+  if (warnedPaths.has(value.path)) return;
+  warnedPaths.add(value.path);
+  warn(
+    `[attaform] register('${value.path}', { persist: true }) on <input type="file"> \u2014 files can't ride a refresh (browsers block programmatic writes to <input type="file">), so this path won't be saved. For long-lived flows, upload on selection and persist the resulting URL or ID in a sibling string field.`
+  );
+}
+const fileScopeKey = Symbol.for("attaform:file-scope");
+const vRegisterFile = {
+  created(el, { value }) {
+    if (!isRegisterValue(value)) return;
+    const input = el;
+    value.registerElement(input);
+    maybeWarnPersistedFile(value);
+    const currentRaw = value.innerRef.value;
+    if (isBlankFileValue(currentRaw)) {
+      const blankShape = input.multiple ? [] : null;
+      value.setValueWithInternalPath(blankShape, { blank: true });
+    }
+    addTrackedListener(input, "change", () => {
+      noteInteraction(value);
+      const next = readFilesFromInput(input);
+      const blank = isBlankFileValue(next);
+      value.setValueWithInternalPath(next, blank ? { blank: true } : void 0);
+    });
+    const scope = effectScope(true);
+    scope.run(() => {
+      watch(
+        value.innerRef,
+        (next) => {
+          if (!isBlankFileValue(next)) return;
+          value.setValueWithInternalPath(next, { blank: true });
+          if (input.value !== "") input.value = "";
+        },
+        { flush: "post" }
+      );
+    });
+    input[fileScopeKey] = () => scope.stop();
+  },
+  beforeUpdate(el, { value }) {
+    if (!isRegisterValue(value)) return;
+    const input = el;
+    const currentRaw = value.innerRef.value;
+    if (isBlankFileValue(currentRaw)) {
+      value.setValueWithInternalPath(currentRaw, { blank: true });
+      if (input.value !== "") input.value = "";
+    }
+  },
+  beforeUnmount(el, { value }) {
+    removeTrackedListeners(el);
+    const stop = el[fileScopeKey];
+    if (stop !== void 0) {
+      stop();
+      delete el[fileScopeKey];
+    }
+    if (!isRegisterValue(value)) return;
+    value.deregisterElement(el);
+  }
+};
+
 const idGenerator = /* @__PURE__ */ (() => {
   let counter = 0;
   return () => `el-${++counter}`;
@@ -588,22 +771,81 @@ function createIsSensitivePath(names = DEFAULT_SENSITIVE_NAMES) {
     return false;
   };
 }
-const defaultSegmentMatches = createSegmentMatchesSensitive();
 const defaultIsSensitivePath = createIsSensitivePath();
-function segmentMatchesSensitive(segment) {
-  return defaultSegmentMatches(segment);
-}
 function isSensitivePath(path) {
   return defaultIsSensitivePath(path);
 }
-function enforceSensitiveCheck(path, acknowledged, isSensitive = defaultIsSensitivePath) {
-  if (acknowledged) return;
-  if (!isSensitive(path)) return;
-  throw new SensitivePersistFieldError(path);
+const warnedSensitivePersist = __DEV__ ? /* @__PURE__ */ new Set() : null;
+function allowSensitivePersist(path, acknowledged, isSensitive = defaultIsSensitivePath) {
+  if (acknowledged) return true;
+  if (!isSensitive(path)) return true;
+  if (warnedSensitivePersist !== null) {
+    const display = Array.isArray(path) ? path.join(".") : String(path);
+    if (!warnedSensitivePersist.has(display)) {
+      warnedSensitivePersist.add(display);
+      console.warn(
+        `[attaform] Not persisting "${display}" \u2014 it matches a sensitive-name pattern (password / cvv / ssn / token / etc.) and was opted into persistence without \`acknowledgeSensitive: true\`. Storing sensitive data in client-side storage is a compliance risk (PII / PCI-DSS / HIPAA / SOC2). Persist it server-side, or pass \`acknowledgeSensitive: true\` to register() / form.persist() if this is intentional.`
+      );
+    }
+  }
+  return false;
 }
 
+function syncPersistOptIn(el, value, oldValue, vnodeType) {
+  const wasOptedIn = isRegisterValue(oldValue) && oldValue.persist === true;
+  const isFileInput = el.tagName === "INPUT" && (vnodeType === "file" || el.type === "file");
+  const wantsOptIn = !isFileInput && isRegisterValue(value) && value.persist === true;
+  if (!wasOptedIn && !wantsOptIn) return;
+  const elementId = getOrAssignElementId(el);
+  if (wasOptedIn) {
+    const old = oldValue;
+    const samePathAndRegistry = wantsOptIn && value.path === old.path && value.persistOptIns === old.persistOptIns;
+    if (!samePathAndRegistry) {
+      old.persistOptIns.remove(elementId, old.path);
+    }
+  }
+  if (wantsOptIn) {
+    const v = value;
+    if (allowSensitivePersist(v.path, v.acknowledgeSensitive, v.isSensitivePath)) {
+      v.persistOptIns.add(elementId, v.path);
+    }
+  }
+}
+function syncMultiTabOptOut(value, oldValue) {
+  const wasOptedOut = isRegisterValue(oldValue) && oldValue.unmarkNoSync !== void 0;
+  const wantsOptOut = isRegisterValue(value) && value.markNoSync !== void 0;
+  if (!wasOptedOut && !wantsOptOut) return;
+  if (wasOptedOut) {
+    const old = oldValue;
+    const samePath = wantsOptOut && value.path === old.path;
+    if (!samePath) old.unmarkNoSync?.();
+  }
+  if (wantsOptOut) {
+    const v = value;
+    const samePathOld = wasOptedOut && oldValue.path === v.path;
+    if (!samePathOld) v.markNoSync?.();
+  }
+}
+function syncElementRegistration(el, value, oldValue) {
+  const wasRegistered = isRegisterValue(oldValue);
+  const isRegistered = isRegisterValue(value);
+  if (!wasRegistered && !isRegistered) return;
+  if (wasRegistered && isRegistered) {
+    const old = oldValue;
+    const next = value;
+    if (old.path === next.path && old.persistOptIns === next.persistOptIns) return;
+  }
+  if (wasRegistered) {
+    oldValue.deregisterElement(el);
+  }
+  if (isRegistered) {
+    value.registerElement(el);
+  }
+}
+
+const INTERACTIVE_TAG_NAMES = /* @__PURE__ */ new Set(["INPUT", "SELECT", "TEXTAREA"]);
+
 const assignKey = Symbol.for("attaform:assign-key");
-const listenersKey = Symbol.for("attaform:directive-listeners");
 function isRegisterValue(val) {
   if (typeof val !== "object" || val === null) return false;
   if (!("innerRef" in val)) return false;
@@ -614,22 +856,6 @@ function isRegisterValue(val) {
   if (typeof val.setValueWithInternalPath !== "function") return false;
   return true;
 }
-function addEventListener(el, event, handler, options) {
-  el.addEventListener(event, handler, options);
-  const carrier = el;
-  const bag = carrier[listenersKey] ?? [];
-  bag.push({ event, handler, options });
-  carrier[listenersKey] = bag;
-}
-function removeTrackedListeners(el) {
-  const carrier = el;
-  const bag = carrier[listenersKey];
-  if (bag === void 0) return;
-  for (const { event, handler, options } of bag) {
-    el.removeEventListener(event, handler, options);
-  }
-  delete carrier[listenersKey];
-}
 function writeLastTypedForm(rv, next) {
   rv.lastTypedForm.value = next;
 }
@@ -642,7 +868,7 @@ function isDefaultAssigner(fn) {
   return typeof fn === "function" && fn[DEFAULT_ASSIGNER_TAG] === true;
 }
 function shouldBailListener(el) {
-  if (SUPPORTED_TAGS.has(el.tagName)) return false;
+  if (INTERACTIVE_TAG_NAMES.has(el.tagName)) return false;
   return isDefaultAssigner(el[assignKey]);
 }
 function runTransforms(initial, registerValue) {
@@ -732,56 +958,6 @@ const getModelAssigner = (el, vnode, registerValue) => {
   defaultAssigner[DEFAULT_ASSIGNER_TAG] = true;
   return defaultAssigner;
 };
-function syncPersistOptIn(el, value, oldValue, vnodeType) {
-  const wasOptedIn = isRegisterValue(oldValue) && oldValue.persist === true;
-  const isFileInput = el.tagName === "INPUT" && (vnodeType === "file" || el.type === "file");
-  const wantsOptIn = !isFileInput && isRegisterValue(value) && value.persist === true;
-  if (!wasOptedIn && !wantsOptIn) return;
-  const elementId = getOrAssignElementId(el);
-  if (wasOptedIn) {
-    const old = oldValue;
-    const samePathAndRegistry = wantsOptIn && value.path === old.path && value.persistOptIns === old.persistOptIns;
-    if (!samePathAndRegistry) {
-      old.persistOptIns.remove(elementId, old.path);
-    }
-  }
-  if (wantsOptIn) {
-    const v = value;
-    enforceSensitiveCheck(v.path, v.acknowledgeSensitive, v.isSensitivePath);
-    v.persistOptIns.add(elementId, v.path);
-  }
-}
-function syncMultiTabOptOut(value, oldValue) {
-  const wasOptedOut = isRegisterValue(oldValue) && oldValue.unmarkNoSync !== void 0;
-  const wantsOptOut = isRegisterValue(value) && value.markNoSync !== void 0;
-  if (!wasOptedOut && !wantsOptOut) return;
-  if (wasOptedOut) {
-    const old = oldValue;
-    const samePath = wantsOptOut && value.path === old.path;
-    if (!samePath) old.unmarkNoSync?.();
-  }
-  if (wantsOptOut) {
-    const v = value;
-    const samePathOld = wasOptedOut && oldValue.path === v.path;
-    if (!samePathOld) v.markNoSync?.();
-  }
-}
-function syncElementRegistration(el, value, oldValue) {
-  const wasRegistered = isRegisterValue(oldValue);
-  const isRegistered = isRegisterValue(value);
-  if (!wasRegistered && !isRegistered) return;
-  if (wasRegistered && isRegistered) {
-    const old = oldValue;
-    const next = value;
-    if (old.path === next.path && old.persistOptIns === next.persistOptIns) return;
-  }
-  if (wasRegistered) {
-    oldValue.deregisterElement(el);
-  }
-  if (isRegistered) {
-    value.registerElement(el);
-  }
-}
 function onCompositionStart(e) {
   const target = e.target;
   if (!target) return;
@@ -823,10 +999,11 @@ const vRegisterText = {
       value.registerElement(el);
       setAssignFunction(el, vnode, value);
     }
-    addEventListener(el, lazy === true ? "change" : "input", (e) => {
+    addTrackedListener(el, lazy === true ? "change" : "input", (e) => {
       if (shouldBailListener(el)) return;
       const target = e.target;
       if (target === null || target.composing) return;
+      noteInteraction(value);
       let domValue = el.value;
       if (trim === true && lazy === true) {
         domValue = domValue.trim();
@@ -878,7 +1055,7 @@ const vRegisterText = {
       }
     });
     if (trim === true || castToNumber) {
-      addEventListener(el, "change", () => {
+      addTrackedListener(el, "change", () => {
         if (shouldBailListener(el)) return;
         let normalized = el.value;
         if (trim === true) normalized = normalized.trim();
@@ -904,12 +1081,12 @@ const vRegisterText = {
       });
     }
     if (lazy !== true) {
-      addEventListener(el, "compositionstart", onCompositionStart);
-      addEventListener(el, "compositionend", onCompositionEnd);
-      addEventListener(el, "change", onCompositionEnd);
+      addTrackedListener(el, "compositionstart", onCompositionStart);
+      addTrackedListener(el, "compositionend", onCompositionEnd);
+      addTrackedListener(el, "change", onCompositionEnd);
     }
     if (number === true && vnode.props?.["type"] !== "number") {
-      addEventListener(el, "beforeinput", (e) => {
+      addTrackedListener(el, "beforeinput", (e) => {
         const ev = e;
         if (ev.inputType !== "insertText" && ev.inputType !== "insertFromPaste" && ev.inputType !== "insertFromDrop") {
           return;
@@ -956,8 +1133,9 @@ const vRegisterCheckbox = {
     if (!isRegisterValue(value)) return;
     value.registerElement(el);
     setAssignFunction(el, vnode, value);
-    addEventListener(el, "change", () => {
+    addTrackedListener(el, "change", () => {
       if (shouldBailListener(el)) return;
+      noteInteraction(value);
       const modelValue = value.innerRef.value ?? [];
       const explicitValueRequired = true;
       const rawElementValue = getValue(el, explicitValueRequired);
@@ -1053,8 +1231,9 @@ const vRegisterRadio = {
     if (!isRegisterValue(value)) return;
     value.registerElement(el);
     setAssignFunction(el, vnode, value);
-    addEventListener(el, "change", () => {
+    addTrackedListener(el, "change", () => {
       if (shouldBailListener(el)) return;
+      noteInteraction(value);
       el[assignKey]?.(getValue(el));
       if (isRegisterValue(value) && isDefaultAssigner(el[assignKey])) {
         const currentModel = value.innerRef.value;
@@ -1101,8 +1280,9 @@ const vRegisterSelect = {
     if (!isRegisterValue(value)) return;
     value.registerElement(el);
     const isSetModel = isSet(value.innerRef.value);
-    addEventListener(el, "change", () => {
+    addTrackedListener(el, "change", () => {
       if (shouldBailListener(el)) return;
+      noteInteraction(value);
       const selectedVal = Array.prototype.filter.call(el.options, (o) => o.selected).map((o) => number === true ? looseToNumber(getValue(o)) : getValue(o));
       const wrote = el[assignKey]?.(
         el.multiple ? isSetModel ? new Set(selectedVal) : selectedVal : selectedVal[0]
@@ -1215,14 +1395,14 @@ function getCheckboxValue(el, checked) {
   const key = checked ? "_trueValue" : "_falseValue";
   return key in el ? el[key] : checked;
 }
-const SUPPORTED_TAGS = /* @__PURE__ */ new Set(["INPUT", "TEXTAREA", "SELECT"]);
 const warnedUnsupportedElements = __DEV__ ? /* @__PURE__ */ new WeakSet() : null;
 const vRegisterDynamic = {
   created(el, binding, vnode) {
     syncPersistOptIn(el, binding.value, void 0, vnode.props?.["type"]);
     syncMultiTabOptOut(binding.value, void 0);
     callModelHook(el, binding, vnode, null, "created");
-    if (__DEV__ && warnedUnsupportedElements !== null && !SUPPORTED_TAGS.has(el.tagName) && !warnedUnsupportedElements.has(el)) {
+    if (isRegisterValue(binding.value)) setupAria(el, binding.value, vnode);
+    if (__DEV__ && warnedUnsupportedElements !== null && !INTERACTIVE_TAG_NAMES.has(el.tagName) && !warnedUnsupportedElements.has(el)) {
       void nextTick(() => {
         if (warnedUnsupportedElements.has(el)) return;
         const hasMarker = el[REGISTER_OWNER_MARKER] === true;
@@ -1245,12 +1425,28 @@ const vRegisterDynamic = {
     syncMultiTabOptOut(binding.value, binding.oldValue);
     syncElementRegistration(el, binding.value, binding.oldValue);
     callModelHook(el, binding, vnode, prevVNode, "beforeUpdate");
+    const ariaEl = el;
+    const value = binding.value;
+    if (!isRegisterValue(value) || value.ariaEnabled !== true || value.ariaDisplayState === void 0) {
+      teardownAria(ariaEl);
+    } else {
+      const old = binding.oldValue;
+      const pathChanged = !isRegisterValue(old) || old.path !== value.path;
+      if (pathChanged) {
+        teardownAria(ariaEl);
+        setupAria(ariaEl, value, vnode);
+      } else {
+        mergeAriaLocks(ariaEl, vnode);
+        applyAria(ariaEl, value);
+      }
+    }
   },
   updated(el, binding, vnode, prevVNode) {
     callModelHook(el, binding, vnode, prevVNode, "updated");
   },
   beforeUnmount(el, { value }) {
     removeTrackedListeners(el);
+    teardownAria(el);
     if (isRegisterValue(value)) {
       value.persistOptIns.removeAllFor(getOrAssignElementId(el));
       value.unmarkNoSync?.();
@@ -1260,87 +1456,18 @@ const vRegisterDynamic = {
     delete el.composing;
     delete el._assigning;
     delete el[assignKey];
-  }
-};
-function isBlankFileValue(value) {
-  if (value === null || value === void 0) return true;
-  if (Array.isArray(value) && value.length === 0) return true;
-  if (typeof FileList !== "undefined" && value instanceof FileList && value.length === 0)
-    return true;
-  return false;
-}
-function readFilesFromInput(el) {
-  const files = el.files;
-  if (el.multiple) {
-    return files === null ? [] : Array.from(files);
-  }
-  if (files === null || files.length === 0) return null;
-  return files.item(0);
-}
-const warnedPersistedFileForms = __DEV__ ? /* @__PURE__ */ new WeakMap() : null;
-function maybeWarnPersistedFile(value) {
-  if (!__DEV__ || warnedPersistedFileForms === null) return;
-  if (value.persist !== true) return;
-  let warnedPaths = warnedPersistedFileForms.get(value.persistOptIns);
-  if (warnedPaths === void 0) {
-    warnedPaths = /* @__PURE__ */ new Set();
-    warnedPersistedFileForms.set(value.persistOptIns, warnedPaths);
-  }
-  if (warnedPaths.has(value.path)) return;
-  warnedPaths.add(value.path);
-  warn(
-    `[attaform] register('${value.path}', { persist: true }) on <input type="file"> \u2014 files can't ride a refresh (browsers block programmatic writes to <input type="file">), so this path won't be saved. For long-lived flows, upload on selection and persist the resulting URL or ID in a sibling string field.`
-  );
-}
-const fileScopeKey = Symbol.for("attaform:file-scope");
-const vRegisterFile = {
-  created(el, { value }) {
-    if (!isRegisterValue(value)) return;
-    const input = el;
-    value.registerElement(input);
-    maybeWarnPersistedFile(value);
-    const currentRaw = value.innerRef.value;
-    if (isBlankFileValue(currentRaw)) {
-      const blankShape = input.multiple ? [] : null;
-      value.setValueWithInternalPath(blankShape, { blank: true });
-    }
-    addEventListener(input, "change", () => {
-      const next = readFilesFromInput(input);
-      const blank = isBlankFileValue(next);
-      value.setValueWithInternalPath(next, blank ? { blank: true } : void 0);
-    });
-    const scope = effectScope(true);
-    scope.run(() => {
-      watch(
-        value.innerRef,
-        (next) => {
-          if (!isBlankFileValue(next)) return;
-          value.setValueWithInternalPath(next, { blank: true });
-          if (input.value !== "") input.value = "";
-        },
-        { flush: "post" }
-      );
-    });
-    input[fileScopeKey] = () => scope.stop();
-  },
-  beforeUpdate(el, { value }) {
-    if (!isRegisterValue(value)) return;
-    const input = el;
-    const currentRaw = value.innerRef.value;
-    if (isBlankFileValue(currentRaw)) {
-      value.setValueWithInternalPath(currentRaw, { blank: true });
-      if (input.value !== "") input.value = "";
-    }
   },
-  beforeUnmount(el, { value }) {
-    removeTrackedListeners(el);
-    const stop = el[fileScopeKey];
-    if (stop !== void 0) {
-      stop();
-      delete el[fileScopeKey];
-    }
-    if (!isRegisterValue(value)) return;
-    value.deregisterElement(el);
+  // The lifecycle hooks above don't run on the server (Vue skips
+  // directive lifecycle during SSR), so emit the same aria attributes
+  // here from the SSR-time gated display state. Honors authored attrs
+  // (vnode-level lockout) and the ariaEnabled gate, touches no DOM, and
+  // shares `resolveAriaValue` with the client path. Ids are SSR-stable
+  // (formInstanceId derives from Vue's useId), so a server-rendered
+  // describedby matches the client after hydration.
+  getSSRProps(binding, vnode) {
+    const rv = binding.value;
+    if (!isRegisterValue(rv)) return void 0;
+    return getSSRAriaProps(rv, vnode ?? null);
   }
 };
 function resolveDynamicModel(tagName, type) {
@@ -1504,5 +1631,5 @@ function isPathPrefix(prefix, path) {
   return true;
 }
 
-export { AnonPersistError as A, kFormInstanceId as B, parseDottedPath as C, DEFAULT_SENSITIVE_NAMES as D, pathKeyToDotted as E, FORM_ERRORS_PATH as F, segmentMatchesSensitive as G, segmentsForPathKey as H, InvalidPathError as I, useRegister as J, useRegistry as K, vRegister as L, OutsideSetupError as O, ROOT_PATH as R, SensitivePersistFieldError as S, __DEV__ as _, AttaformError as a, FORM_ERRORS_PATH_KEY as b, InvalidUseFormConfigError as c, ROOT_PATH_KEY as d, RegistryNotInstalledError as e, ReservedFormKeyError as f, SubmitErrorHandlerError as g, assignKey as h, canonicalizePath as i, captureUserCallSite as j, coerceToPathKey as k, createAttaform as l, createIsSensitivePath as m, createPersistOptInRegistry as n, createRegistry as o, createSegmentMatchesSensitive as p, enforceSensitiveCheck as q, ensureAttaformInstalled as r, getRegistryFromApp as s, isPathPrefix as t, isRegisterValue as u, isSensitivePath as v, kAttaformAncestorWizard as w, kAttaformRegistry as x, kAttaformWizardActiveStepResolver as y, kFormContext as z };
-//# sourceMappingURL=attaform.CDmaxrt2.mjs.map
+export { AnonPersistError as A, parseDottedPath as B, pathKeyToDotted as C, DEFAULT_SENSITIVE_NAMES as D, segmentsForPathKey as E, FORM_ERRORS_PATH as F, useRegister as G, useRegistry as H, INTERACTIVE_TAG_NAMES as I, vRegister as J, OutsideSetupError as O, ROOT_PATH as R, SubmitErrorHandlerError as S, __DEV__ as _, AttaformError as a, FORM_ERRORS_PATH_KEY as b, InvalidPathError as c, InvalidUseFormConfigError as d, ROOT_PATH_KEY as e, RegistryNotInstalledError as f, ReservedFormKeyError as g, allowSensitivePersist as h, assignKey as i, canonicalizePath as j, captureUserCallSite as k, coerceToPathKey as l, createAttaform as m, createIsSensitivePath as n, createPersistOptInRegistry as o, createRegistry as p, ensureAttaformInstalled as q, getRegistryFromApp as r, isPathPrefix as s, isRegisterValue as t, isSensitivePath as u, kAttaformAncestorWizard as v, kAttaformRegistry as w, kAttaformWizardActiveStepResolver as x, kFormContext as y, kFormInstanceId as z };
+//# sourceMappingURL=attaform.BKozEdTr.mjs.map