attaform 0.18.2 → 0.20.0

package/dist/shared/{attaform.BqK_L4gK.cjs → attaform.BPy-4qRx.cjs}

@@ -45,14 +45,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));
@@ -406,6 +398,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 = vue.effectScope(true);
+  scope.run(() => {
+    vue.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);
+  vue.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 = vue.effectScope(true);
+    scope.run(() => {
+      vue.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}`;
@@ -590,22 +773,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;
@@ -616,22 +858,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;
 }
@@ -644,7 +870,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) {
@@ -734,56 +960,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;
@@ -825,10 +1001,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();
@@ -880,7 +1057,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();
@@ -906,12 +1083,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;
@@ -958,8 +1135,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);
@@ -1055,8 +1233,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;
@@ -1103,8 +1282,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]
@@ -1217,14 +1397,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 vue.nextTick(() => {
         if (warnedUnsupportedElements.has(el)) return;
         const hasMarker = el[REGISTER_OWNER_MARKER] === true;
@@ -1247,12 +1427,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?.();
@@ -1262,87 +1458,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);
-  vue.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 = vue.effectScope(true);
-    scope.run(() => {
-      vue.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) {
@@ -1511,6 +1638,7 @@ exports.AttaformError = AttaformError;
 exports.DEFAULT_SENSITIVE_NAMES = DEFAULT_SENSITIVE_NAMES;
 exports.FORM_ERRORS_PATH = FORM_ERRORS_PATH;
 exports.FORM_ERRORS_PATH_KEY = FORM_ERRORS_PATH_KEY;
+exports.INTERACTIVE_TAG_NAMES = INTERACTIVE_TAG_NAMES;
 exports.InvalidPathError = InvalidPathError;
 exports.InvalidUseFormConfigError = InvalidUseFormConfigError;
 exports.OutsideSetupError = OutsideSetupError;
@@ -1518,9 +1646,9 @@ exports.ROOT_PATH = ROOT_PATH;
 exports.ROOT_PATH_KEY = ROOT_PATH_KEY;
 exports.RegistryNotInstalledError = RegistryNotInstalledError;
 exports.ReservedFormKeyError = ReservedFormKeyError;
-exports.SensitivePersistFieldError = SensitivePersistFieldError;
 exports.SubmitErrorHandlerError = SubmitErrorHandlerError;
 exports.__DEV__ = __DEV__;
+exports.allowSensitivePersist = allowSensitivePersist;
 exports.assignKey = assignKey;
 exports.canonicalizePath = canonicalizePath;
 exports.captureUserCallSite = captureUserCallSite;
@@ -1529,8 +1657,6 @@ exports.createAttaform = createAttaform;
 exports.createIsSensitivePath = createIsSensitivePath;
 exports.createPersistOptInRegistry = createPersistOptInRegistry;
 exports.createRegistry = createRegistry;
-exports.createSegmentMatchesSensitive = createSegmentMatchesSensitive;
-exports.enforceSensitiveCheck = enforceSensitiveCheck;
 exports.ensureAttaformInstalled = ensureAttaformInstalled;
 exports.getRegistryFromApp = getRegistryFromApp;
 exports.isPathPrefix = isPathPrefix;
@@ -1543,9 +1669,8 @@ exports.kFormContext = kFormContext;
 exports.kFormInstanceId = kFormInstanceId;
 exports.parseDottedPath = parseDottedPath;
 exports.pathKeyToDotted = pathKeyToDotted;
-exports.segmentMatchesSensitive = segmentMatchesSensitive;
 exports.segmentsForPathKey = segmentsForPathKey;
 exports.useRegister = useRegister;
 exports.useRegistry = useRegistry;
 exports.vRegister = vRegister;
-//# sourceMappingURL=attaform.BqK_L4gK.cjs.map
+//# sourceMappingURL=attaform.BPy-4qRx.cjs.map