attaform 0.20.1 → 0.20.2

package/README.md

@@ -3,7 +3,7 @@
 [![npm version][npm-version-src]][npm-version-href]
 [![npm downloads][npm-downloads-src]][npm-downloads-href]
 [![License][license-src]][license-href]
-[![Node.js Test Suite](https://github.com/attaform/attaform/actions/workflows/matrix.yml/badge.svg)](https://github.com/attaform/attaform/actions/workflows/matrix.yml)
+[![Node.js Test Suite](https://github.com/attaform/Attaform/actions/workflows/matrix.yml/badge.svg)](https://github.com/attaform/Attaform/actions/workflows/matrix.yml)
 [![OpenSSF Scorecard][scorecard-src]][scorecard-href]
 [![OpenSSF Best Practices][cii-src]][cii-href]
 [![Nuxt][nuxt-src]][nuxt-href]

package/dist/chunks/devtools.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-const paths = require('../shared/attaform.BPy-4qRx.cjs');
+const paths = require('../shared/attaform.z5j3LwJz.cjs');
 
 const INSPECTOR_ID = "attaform";
 const TIMELINE_LAYER_ID = "attaform:events";
@@ -18,7 +18,7 @@ async function setupAttaformDevtools(app, registry) {
       id: INSPECTOR_ID,
       label: "Attaform",
       packageName: "attaform",
-      homepage: "https://github.com/attaform/attaform",
+      homepage: "https://github.com/attaform/Attaform",
       app,
       componentStateTypes: ["Attaform form"]
     },

package/dist/chunks/devtools.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"devtools.cjs","sources":["../../src/runtime/core/devtools.ts"],"sourcesContent":["import type { App } from 'vue'\nimport type { FormStore } from './create-form-store'\nimport type { AttaformRegistry } from './registry'\nimport type { GenericForm } from '../types/types-core'\nimport type { FormKey } from '../types/types-api'\nimport { canonicalizePath } from './paths'\n\n/**\n * Vue DevTools plugin wiring for attaform. Lazy-imported by\n * `createAttaform` under dev-mode guards so the production\n * bundle tree-shakes it out entirely.\n *\n * Registers:\n *  - An inspector (per-app) that lists every registered form, with\n *    nodes for form value / errors / aggregates / history.\n *  - A timeline layer that emits events on submit start/success/\n *    failure, reset, undo, redo, and form mutations.\n *  - State editing — modifying a leaf inside the inspector tree\n *    pushes through `state.setValueAtPath`, mutating the form.\n *\n * Tolerant of missing `@vue/devtools-api` — the peer dep is marked\n * optional. If the import fails, `setupAttaformDevtools` silently\n * no-ops so production builds / users without DevTools installed\n * don't see errors.\n */\n\nconst INSPECTOR_ID = 'attaform'\nconst TIMELINE_LAYER_ID = 'attaform:events'\n\ntype UnsafeDevtoolsApi = {\n  addInspector(opts: { id: string; label: string; icon?: string; app: App }): void\n  addTimelineLayer(opts: { id: string; label: string; color: number }): void\n  sendInspectorTree(inspectorId: string): void\n  sendInspectorState(inspectorId: string): void\n  addTimelineEvent(payload: {\n    layerId: string\n    event: {\n      time: number\n      title: string\n      subtitle?: string\n      data?: Record<string, unknown>\n      groupId?: string | number\n    }\n  }): void\n  on: {\n    getInspectorTree(\n      handler: (payload: {\n        inspectorId: string\n        filter: string\n        rootNodes: Array<{ id: string; label: string; tags?: unknown[] }>\n      }) => void\n    ): void\n    getInspectorState(\n      handler: (payload: {\n        inspectorId: string\n        nodeId: string\n        state: Record<string, Array<{ key: string; value: unknown; editable?: boolean }>>\n      }) => void\n    ): void\n    editInspectorState(\n      handler: (payload: {\n        inspectorId: string\n        nodeId: string\n        path: string[]\n        state: { value: unknown; newKey?: string | null; remove?: boolean }\n      }) => void\n    ): void\n  }\n}\n\ntype SetupDevtoolsPluginFn = (\n  descriptor: {\n    id: string\n    label: string\n    packageName?: string\n    homepage?: string\n    componentStateTypes?: string[]\n    app: App\n  },\n  setup: (api: UnsafeDevtoolsApi) => void\n) => void\n\n/**\n * Install the DevTools plugin for the given Vue app + registry. Safe\n * to call in production — if `@vue/devtools-api` isn't installed, the\n * dynamic import fails and we log nothing. Returns `true` when\n * DevTools was wired successfully, `false` otherwise — useful for\n * tests.\n */\nexport async function setupAttaformDevtools(\n  app: App,\n  registry: AttaformRegistry\n): Promise<boolean> {\n  let mod: { setupDevtoolsPlugin?: SetupDevtoolsPluginFn }\n  try {\n    mod = (await import('@vue/devtools-api')) as {\n      setupDevtoolsPlugin?: SetupDevtoolsPluginFn\n    }\n  } catch {\n    // Peer dep not installed — silently skip. Production builds pass\n    // `{ devtools: false }` explicitly, but this catch covers the\n    // \"dev without the peer dep\" case without a noisy warning.\n    return false\n  }\n  const setupDevtoolsPlugin = mod.setupDevtoolsPlugin\n  if (typeof setupDevtoolsPlugin !== 'function') return false\n\n  setupDevtoolsPlugin(\n    {\n      id: INSPECTOR_ID,\n      label: 'Attaform',\n      packageName: 'attaform',\n      homepage: 'https://github.com/attaform/attaform',\n      app,\n      componentStateTypes: ['Attaform form'],\n    },\n    (api) => wire(api, app, registry)\n  )\n  return true\n}\n\nfunction wire(api: UnsafeDevtoolsApi, app: App, registry: AttaformRegistry): void {\n  // Per-form subscriber bookkeeping — we keep the unsubscribers so\n  // the registry's eviction path can detach them when a form is\n  // disposed. Using a Map keyed by FormKey mirrors the registry.\n  const subscriberUnsubs = new Map<FormKey, () => void>()\n\n  api.addInspector({ id: INSPECTOR_ID, label: 'Attaform', app })\n  api.addTimelineLayer({ id: TIMELINE_LAYER_ID, label: 'Attaform', color: 0x5b8def })\n\n  function refreshTree(): void {\n    api.sendInspectorTree(INSPECTOR_ID)\n  }\n\n  function refreshState(): void {\n    api.sendInspectorState(INSPECTOR_ID)\n  }\n\n  function subscribeForm(state: FormStore<GenericForm>): void {\n    if (subscriberUnsubs.has(state.formKey)) return\n    const unsubChange = state.onFormChange(() => {\n      refreshState()\n      api.addTimelineEvent({\n        layerId: TIMELINE_LAYER_ID,\n        event: {\n          time: Date.now(),\n          title: 'form.change',\n          subtitle: state.formKey,\n          // Devtools is dev-only — emit raw values. Consumers worried\n          // about screen-share leaks should close the panel before\n          // sharing, same as they would for the browser DevTools\n          // console.\n          data: { form: state.form.value as Record<string, unknown> },\n        },\n      })\n    })\n    const unsubSubmit = state.onSubmitSuccess(() => {\n      api.addTimelineEvent({\n        layerId: TIMELINE_LAYER_ID,\n        event: {\n          time: Date.now(),\n          title: 'submit.success',\n          subtitle: state.formKey,\n          data: { form: state.form.value as Record<string, unknown> },\n        },\n      })\n    })\n    const unsubReset = state.onReset(() => {\n      refreshState()\n      api.addTimelineEvent({\n        layerId: TIMELINE_LAYER_ID,\n        event: {\n          time: Date.now(),\n          title: 'reset',\n          subtitle: state.formKey,\n        },\n      })\n    })\n    subscriberUnsubs.set(state.formKey, () => {\n      unsubChange()\n      unsubSubmit()\n      unsubReset()\n    })\n  }\n\n  // Subscribe all currently-registered forms + register as they're\n  // added. The registry's `forms` Map is shallowReactive — we poll\n  // once per render on refresh; for live change detection, each\n  // useForm call that adds a new form triggers a tree/state refresh\n  // via the form's own onFormChange emission on the first\n  // applyFormReplacement.\n  function syncForms(): void {\n    for (const [, state] of registry.forms) {\n      subscribeForm(state)\n    }\n    // Drop subscribers for forms that were evicted.\n    for (const [formKey, unsub] of subscriberUnsubs) {\n      if (!registry.forms.has(formKey)) {\n        unsub()\n        subscriberUnsubs.delete(formKey)\n      }\n    }\n  }\n\n  api.on.getInspectorTree((payload) => {\n    if (payload.inspectorId !== INSPECTOR_ID) return\n    syncForms()\n    payload.rootNodes = [...registry.forms.keys()].map((key) => ({\n      id: `form:${key}`,\n      label: key,\n      tags: [],\n    }))\n  })\n\n  api.on.getInspectorState((payload) => {\n    if (payload.inspectorId !== INSPECTOR_ID) return\n    if (!payload.nodeId.startsWith('form:')) return\n    const formKey = payload.nodeId.slice('form:'.length)\n    const state = registry.forms.get(formKey)\n    if (state === undefined) return\n    // Devtools is dev-only — render raw values for everything,\n    // including sensitive-named paths. Consumers concerned about\n    // screen-share leaks should close the panel before sharing.\n    payload.state['Form value'] = [\n      {\n        key: 'form',\n        value: state.form.value,\n        editable: true,\n      },\n    ]\n    // Schema-driven and user-injected errors land in separate inspector\n    // sections so devs can see the source distinction at a glance — a\n    // user-injected entry surviving a successful submit, or a schema\n    // entry that should have cleared after a value fix, are immediately\n    // visible without cross-referencing call sites.\n    payload.state['Schema Errors'] = [\n      ...[...state.schemaErrors.entries()].map(([k, v]) => ({\n        key: String(k),\n        value: v as unknown,\n      })),\n    ]\n    payload.state['User Errors'] = [\n      ...[...state.userErrors.entries()].map(([k, v]) => ({\n        key: String(k),\n        value: v as unknown,\n      })),\n    ]\n    payload.state['Aggregates'] = [\n      { key: 'submitting', value: state.submitting.value },\n      { key: 'submissionAttempts', value: state.submissionAttempts.value },\n      { key: 'departAttempts', value: state.departAttempts.value },\n      { key: 'submitError', value: state.submitError.value },\n      { key: 'activeValidations', value: state.activeValidations.value },\n    ]\n  })\n\n  api.on.editInspectorState((payload) => {\n    if (payload.inspectorId !== INSPECTOR_ID) return\n    if (!payload.nodeId.startsWith('form:')) return\n    const formKey = payload.nodeId.slice('form:'.length)\n    const state = registry.forms.get(formKey)\n    if (state === undefined) return\n    // payload.path is `['Form value', 'form', ...pathSegments]` — the\n    // first two segments are the inspector section + key, the rest is\n    // the target form path the user edited. Pass the segment array\n    // directly to `canonicalizePath`: join('.') would collapse a\n    // literal-dot field key (`{\"user.email\": ...}`) into two segments,\n    // writing to the wrong leaf.\n    if (payload.path.length < 3) return\n    const section = payload.path[0]\n    if (section !== 'Form value') return\n    const segments = payload.path.slice(2)\n    const { segments: canonicalPath, key: canonicalKey } = canonicalizePath(segments)\n    // A devtools edit on a path that any element has opted in to should\n    // persist (matches the user's expectation: editing via the inspector\n    // should be indistinguishable from typing into the bound input).\n    // No opt-in for this path → no write.\n    state.setValueAtPath(canonicalPath, payload.state.value, {\n      persist: state.persistOptIns.hasAnyOptInForPath(canonicalKey),\n    })\n    refreshState()\n  })\n\n  // Initial sync so existing forms show up.\n  syncForms()\n  refreshTree()\n}\n"],"names":["canonicalizePath"],"mappings":"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"}
+{"version":3,"file":"devtools.cjs","sources":["../../src/runtime/core/devtools.ts"],"sourcesContent":["import type { App } from 'vue'\nimport type { FormStore } from './create-form-store'\nimport type { AttaformRegistry } from './registry'\nimport type { GenericForm } from '../types/types-core'\nimport type { FormKey } from '../types/types-api'\nimport { canonicalizePath } from './paths'\n\n/**\n * Vue DevTools plugin wiring for attaform. Lazy-imported by\n * `createAttaform` under dev-mode guards so the production\n * bundle tree-shakes it out entirely.\n *\n * Registers:\n *  - An inspector (per-app) that lists every registered form, with\n *    nodes for form value / errors / aggregates / history.\n *  - A timeline layer that emits events on submit start/success/\n *    failure, reset, undo, redo, and form mutations.\n *  - State editing — modifying a leaf inside the inspector tree\n *    pushes through `state.setValueAtPath`, mutating the form.\n *\n * Tolerant of missing `@vue/devtools-api` — the peer dep is marked\n * optional. If the import fails, `setupAttaformDevtools` silently\n * no-ops so production builds / users without DevTools installed\n * don't see errors.\n */\n\nconst INSPECTOR_ID = 'attaform'\nconst TIMELINE_LAYER_ID = 'attaform:events'\n\ntype UnsafeDevtoolsApi = {\n  addInspector(opts: { id: string; label: string; icon?: string; app: App }): void\n  addTimelineLayer(opts: { id: string; label: string; color: number }): void\n  sendInspectorTree(inspectorId: string): void\n  sendInspectorState(inspectorId: string): void\n  addTimelineEvent(payload: {\n    layerId: string\n    event: {\n      time: number\n      title: string\n      subtitle?: string\n      data?: Record<string, unknown>\n      groupId?: string | number\n    }\n  }): void\n  on: {\n    getInspectorTree(\n      handler: (payload: {\n        inspectorId: string\n        filter: string\n        rootNodes: Array<{ id: string; label: string; tags?: unknown[] }>\n      }) => void\n    ): void\n    getInspectorState(\n      handler: (payload: {\n        inspectorId: string\n        nodeId: string\n        state: Record<string, Array<{ key: string; value: unknown; editable?: boolean }>>\n      }) => void\n    ): void\n    editInspectorState(\n      handler: (payload: {\n        inspectorId: string\n        nodeId: string\n        path: string[]\n        state: { value: unknown; newKey?: string | null; remove?: boolean }\n      }) => void\n    ): void\n  }\n}\n\ntype SetupDevtoolsPluginFn = (\n  descriptor: {\n    id: string\n    label: string\n    packageName?: string\n    homepage?: string\n    componentStateTypes?: string[]\n    app: App\n  },\n  setup: (api: UnsafeDevtoolsApi) => void\n) => void\n\n/**\n * Install the DevTools plugin for the given Vue app + registry. Safe\n * to call in production — if `@vue/devtools-api` isn't installed, the\n * dynamic import fails and we log nothing. Returns `true` when\n * DevTools was wired successfully, `false` otherwise — useful for\n * tests.\n */\nexport async function setupAttaformDevtools(\n  app: App,\n  registry: AttaformRegistry\n): Promise<boolean> {\n  let mod: { setupDevtoolsPlugin?: SetupDevtoolsPluginFn }\n  try {\n    mod = (await import('@vue/devtools-api')) as {\n      setupDevtoolsPlugin?: SetupDevtoolsPluginFn\n    }\n  } catch {\n    // Peer dep not installed — silently skip. Production builds pass\n    // `{ devtools: false }` explicitly, but this catch covers the\n    // \"dev without the peer dep\" case without a noisy warning.\n    return false\n  }\n  const setupDevtoolsPlugin = mod.setupDevtoolsPlugin\n  if (typeof setupDevtoolsPlugin !== 'function') return false\n\n  setupDevtoolsPlugin(\n    {\n      id: INSPECTOR_ID,\n      label: 'Attaform',\n      packageName: 'attaform',\n      homepage: 'https://github.com/attaform/Attaform',\n      app,\n      componentStateTypes: ['Attaform form'],\n    },\n    (api) => wire(api, app, registry)\n  )\n  return true\n}\n\nfunction wire(api: UnsafeDevtoolsApi, app: App, registry: AttaformRegistry): void {\n  // Per-form subscriber bookkeeping — we keep the unsubscribers so\n  // the registry's eviction path can detach them when a form is\n  // disposed. Using a Map keyed by FormKey mirrors the registry.\n  const subscriberUnsubs = new Map<FormKey, () => void>()\n\n  api.addInspector({ id: INSPECTOR_ID, label: 'Attaform', app })\n  api.addTimelineLayer({ id: TIMELINE_LAYER_ID, label: 'Attaform', color: 0x5b8def })\n\n  function refreshTree(): void {\n    api.sendInspectorTree(INSPECTOR_ID)\n  }\n\n  function refreshState(): void {\n    api.sendInspectorState(INSPECTOR_ID)\n  }\n\n  function subscribeForm(state: FormStore<GenericForm>): void {\n    if (subscriberUnsubs.has(state.formKey)) return\n    const unsubChange = state.onFormChange(() => {\n      refreshState()\n      api.addTimelineEvent({\n        layerId: TIMELINE_LAYER_ID,\n        event: {\n          time: Date.now(),\n          title: 'form.change',\n          subtitle: state.formKey,\n          // Devtools is dev-only — emit raw values. Consumers worried\n          // about screen-share leaks should close the panel before\n          // sharing, same as they would for the browser DevTools\n          // console.\n          data: { form: state.form.value as Record<string, unknown> },\n        },\n      })\n    })\n    const unsubSubmit = state.onSubmitSuccess(() => {\n      api.addTimelineEvent({\n        layerId: TIMELINE_LAYER_ID,\n        event: {\n          time: Date.now(),\n          title: 'submit.success',\n          subtitle: state.formKey,\n          data: { form: state.form.value as Record<string, unknown> },\n        },\n      })\n    })\n    const unsubReset = state.onReset(() => {\n      refreshState()\n      api.addTimelineEvent({\n        layerId: TIMELINE_LAYER_ID,\n        event: {\n          time: Date.now(),\n          title: 'reset',\n          subtitle: state.formKey,\n        },\n      })\n    })\n    subscriberUnsubs.set(state.formKey, () => {\n      unsubChange()\n      unsubSubmit()\n      unsubReset()\n    })\n  }\n\n  // Subscribe all currently-registered forms + register as they're\n  // added. The registry's `forms` Map is shallowReactive — we poll\n  // once per render on refresh; for live change detection, each\n  // useForm call that adds a new form triggers a tree/state refresh\n  // via the form's own onFormChange emission on the first\n  // applyFormReplacement.\n  function syncForms(): void {\n    for (const [, state] of registry.forms) {\n      subscribeForm(state)\n    }\n    // Drop subscribers for forms that were evicted.\n    for (const [formKey, unsub] of subscriberUnsubs) {\n      if (!registry.forms.has(formKey)) {\n        unsub()\n        subscriberUnsubs.delete(formKey)\n      }\n    }\n  }\n\n  api.on.getInspectorTree((payload) => {\n    if (payload.inspectorId !== INSPECTOR_ID) return\n    syncForms()\n    payload.rootNodes = [...registry.forms.keys()].map((key) => ({\n      id: `form:${key}`,\n      label: key,\n      tags: [],\n    }))\n  })\n\n  api.on.getInspectorState((payload) => {\n    if (payload.inspectorId !== INSPECTOR_ID) return\n    if (!payload.nodeId.startsWith('form:')) return\n    const formKey = payload.nodeId.slice('form:'.length)\n    const state = registry.forms.get(formKey)\n    if (state === undefined) return\n    // Devtools is dev-only — render raw values for everything,\n    // including sensitive-named paths. Consumers concerned about\n    // screen-share leaks should close the panel before sharing.\n    payload.state['Form value'] = [\n      {\n        key: 'form',\n        value: state.form.value,\n        editable: true,\n      },\n    ]\n    // Schema-driven and user-injected errors land in separate inspector\n    // sections so devs can see the source distinction at a glance — a\n    // user-injected entry surviving a successful submit, or a schema\n    // entry that should have cleared after a value fix, are immediately\n    // visible without cross-referencing call sites.\n    payload.state['Schema Errors'] = [\n      ...[...state.schemaErrors.entries()].map(([k, v]) => ({\n        key: String(k),\n        value: v as unknown,\n      })),\n    ]\n    payload.state['User Errors'] = [\n      ...[...state.userErrors.entries()].map(([k, v]) => ({\n        key: String(k),\n        value: v as unknown,\n      })),\n    ]\n    payload.state['Aggregates'] = [\n      { key: 'submitting', value: state.submitting.value },\n      { key: 'submissionAttempts', value: state.submissionAttempts.value },\n      { key: 'departAttempts', value: state.departAttempts.value },\n      { key: 'submitError', value: state.submitError.value },\n      { key: 'activeValidations', value: state.activeValidations.value },\n    ]\n  })\n\n  api.on.editInspectorState((payload) => {\n    if (payload.inspectorId !== INSPECTOR_ID) return\n    if (!payload.nodeId.startsWith('form:')) return\n    const formKey = payload.nodeId.slice('form:'.length)\n    const state = registry.forms.get(formKey)\n    if (state === undefined) return\n    // payload.path is `['Form value', 'form', ...pathSegments]` — the\n    // first two segments are the inspector section + key, the rest is\n    // the target form path the user edited. Pass the segment array\n    // directly to `canonicalizePath`: join('.') would collapse a\n    // literal-dot field key (`{\"user.email\": ...}`) into two segments,\n    // writing to the wrong leaf.\n    if (payload.path.length < 3) return\n    const section = payload.path[0]\n    if (section !== 'Form value') return\n    const segments = payload.path.slice(2)\n    const { segments: canonicalPath, key: canonicalKey } = canonicalizePath(segments)\n    // A devtools edit on a path that any element has opted in to should\n    // persist (matches the user's expectation: editing via the inspector\n    // should be indistinguishable from typing into the bound input).\n    // No opt-in for this path → no write.\n    state.setValueAtPath(canonicalPath, payload.state.value, {\n      persist: state.persistOptIns.hasAnyOptInForPath(canonicalKey),\n    })\n    refreshState()\n  })\n\n  // Initial sync so existing forms show up.\n  syncForms()\n  refreshTree()\n}\n"],"names":["canonicalizePath"],"mappings":"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"}

package/dist/chunks/devtools.mjs

@@ -1,4 +1,4 @@
-import { j as canonicalizePath } from '../shared/attaform.BKozEdTr.mjs';
+import { j as canonicalizePath } from '../shared/attaform.QG5TG8lB.mjs';
 
 const INSPECTOR_ID = "attaform";
 const TIMELINE_LAYER_ID = "attaform:events";
@@ -16,7 +16,7 @@ async function setupAttaformDevtools(app, registry) {
       id: INSPECTOR_ID,
       label: "Attaform",
       packageName: "attaform",
-      homepage: "https://github.com/attaform/attaform",
+      homepage: "https://github.com/attaform/Attaform",
       app,
       componentStateTypes: ["Attaform form"]
     },

package/dist/chunks/devtools.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"devtools.mjs","sources":["../../src/runtime/core/devtools.ts"],"sourcesContent":["import type { App } from 'vue'\nimport type { FormStore } from './create-form-store'\nimport type { AttaformRegistry } from './registry'\nimport type { GenericForm } from '../types/types-core'\nimport type { FormKey } from '../types/types-api'\nimport { canonicalizePath } from './paths'\n\n/**\n * Vue DevTools plugin wiring for attaform. Lazy-imported by\n * `createAttaform` under dev-mode guards so the production\n * bundle tree-shakes it out entirely.\n *\n * Registers:\n *  - An inspector (per-app) that lists every registered form, with\n *    nodes for form value / errors / aggregates / history.\n *  - A timeline layer that emits events on submit start/success/\n *    failure, reset, undo, redo, and form mutations.\n *  - State editing — modifying a leaf inside the inspector tree\n *    pushes through `state.setValueAtPath`, mutating the form.\n *\n * Tolerant of missing `@vue/devtools-api` — the peer dep is marked\n * optional. If the import fails, `setupAttaformDevtools` silently\n * no-ops so production builds / users without DevTools installed\n * don't see errors.\n */\n\nconst INSPECTOR_ID = 'attaform'\nconst TIMELINE_LAYER_ID = 'attaform:events'\n\ntype UnsafeDevtoolsApi = {\n  addInspector(opts: { id: string; label: string; icon?: string; app: App }): void\n  addTimelineLayer(opts: { id: string; label: string; color: number }): void\n  sendInspectorTree(inspectorId: string): void\n  sendInspectorState(inspectorId: string): void\n  addTimelineEvent(payload: {\n    layerId: string\n    event: {\n      time: number\n      title: string\n      subtitle?: string\n      data?: Record<string, unknown>\n      groupId?: string | number\n    }\n  }): void\n  on: {\n    getInspectorTree(\n      handler: (payload: {\n        inspectorId: string\n        filter: string\n        rootNodes: Array<{ id: string; label: string; tags?: unknown[] }>\n      }) => void\n    ): void\n    getInspectorState(\n      handler: (payload: {\n        inspectorId: string\n        nodeId: string\n        state: Record<string, Array<{ key: string; value: unknown; editable?: boolean }>>\n      }) => void\n    ): void\n    editInspectorState(\n      handler: (payload: {\n        inspectorId: string\n        nodeId: string\n        path: string[]\n        state: { value: unknown; newKey?: string | null; remove?: boolean }\n      }) => void\n    ): void\n  }\n}\n\ntype SetupDevtoolsPluginFn = (\n  descriptor: {\n    id: string\n    label: string\n    packageName?: string\n    homepage?: string\n    componentStateTypes?: string[]\n    app: App\n  },\n  setup: (api: UnsafeDevtoolsApi) => void\n) => void\n\n/**\n * Install the DevTools plugin for the given Vue app + registry. Safe\n * to call in production — if `@vue/devtools-api` isn't installed, the\n * dynamic import fails and we log nothing. Returns `true` when\n * DevTools was wired successfully, `false` otherwise — useful for\n * tests.\n */\nexport async function setupAttaformDevtools(\n  app: App,\n  registry: AttaformRegistry\n): Promise<boolean> {\n  let mod: { setupDevtoolsPlugin?: SetupDevtoolsPluginFn }\n  try {\n    mod = (await import('@vue/devtools-api')) as {\n      setupDevtoolsPlugin?: SetupDevtoolsPluginFn\n    }\n  } catch {\n    // Peer dep not installed — silently skip. Production builds pass\n    // `{ devtools: false }` explicitly, but this catch covers the\n    // \"dev without the peer dep\" case without a noisy warning.\n    return false\n  }\n  const setupDevtoolsPlugin = mod.setupDevtoolsPlugin\n  if (typeof setupDevtoolsPlugin !== 'function') return false\n\n  setupDevtoolsPlugin(\n    {\n      id: INSPECTOR_ID,\n      label: 'Attaform',\n      packageName: 'attaform',\n      homepage: 'https://github.com/attaform/attaform',\n      app,\n      componentStateTypes: ['Attaform form'],\n    },\n    (api) => wire(api, app, registry)\n  )\n  return true\n}\n\nfunction wire(api: UnsafeDevtoolsApi, app: App, registry: AttaformRegistry): void {\n  // Per-form subscriber bookkeeping — we keep the unsubscribers so\n  // the registry's eviction path can detach them when a form is\n  // disposed. Using a Map keyed by FormKey mirrors the registry.\n  const subscriberUnsubs = new Map<FormKey, () => void>()\n\n  api.addInspector({ id: INSPECTOR_ID, label: 'Attaform', app })\n  api.addTimelineLayer({ id: TIMELINE_LAYER_ID, label: 'Attaform', color: 0x5b8def })\n\n  function refreshTree(): void {\n    api.sendInspectorTree(INSPECTOR_ID)\n  }\n\n  function refreshState(): void {\n    api.sendInspectorState(INSPECTOR_ID)\n  }\n\n  function subscribeForm(state: FormStore<GenericForm>): void {\n    if (subscriberUnsubs.has(state.formKey)) return\n    const unsubChange = state.onFormChange(() => {\n      refreshState()\n      api.addTimelineEvent({\n        layerId: TIMELINE_LAYER_ID,\n        event: {\n          time: Date.now(),\n          title: 'form.change',\n          subtitle: state.formKey,\n          // Devtools is dev-only — emit raw values. Consumers worried\n          // about screen-share leaks should close the panel before\n          // sharing, same as they would for the browser DevTools\n          // console.\n          data: { form: state.form.value as Record<string, unknown> },\n        },\n      })\n    })\n    const unsubSubmit = state.onSubmitSuccess(() => {\n      api.addTimelineEvent({\n        layerId: TIMELINE_LAYER_ID,\n        event: {\n          time: Date.now(),\n          title: 'submit.success',\n          subtitle: state.formKey,\n          data: { form: state.form.value as Record<string, unknown> },\n        },\n      })\n    })\n    const unsubReset = state.onReset(() => {\n      refreshState()\n      api.addTimelineEvent({\n        layerId: TIMELINE_LAYER_ID,\n        event: {\n          time: Date.now(),\n          title: 'reset',\n          subtitle: state.formKey,\n        },\n      })\n    })\n    subscriberUnsubs.set(state.formKey, () => {\n      unsubChange()\n      unsubSubmit()\n      unsubReset()\n    })\n  }\n\n  // Subscribe all currently-registered forms + register as they're\n  // added. The registry's `forms` Map is shallowReactive — we poll\n  // once per render on refresh; for live change detection, each\n  // useForm call that adds a new form triggers a tree/state refresh\n  // via the form's own onFormChange emission on the first\n  // applyFormReplacement.\n  function syncForms(): void {\n    for (const [, state] of registry.forms) {\n      subscribeForm(state)\n    }\n    // Drop subscribers for forms that were evicted.\n    for (const [formKey, unsub] of subscriberUnsubs) {\n      if (!registry.forms.has(formKey)) {\n        unsub()\n        subscriberUnsubs.delete(formKey)\n      }\n    }\n  }\n\n  api.on.getInspectorTree((payload) => {\n    if (payload.inspectorId !== INSPECTOR_ID) return\n    syncForms()\n    payload.rootNodes = [...registry.forms.keys()].map((key) => ({\n      id: `form:${key}`,\n      label: key,\n      tags: [],\n    }))\n  })\n\n  api.on.getInspectorState((payload) => {\n    if (payload.inspectorId !== INSPECTOR_ID) return\n    if (!payload.nodeId.startsWith('form:')) return\n    const formKey = payload.nodeId.slice('form:'.length)\n    const state = registry.forms.get(formKey)\n    if (state === undefined) return\n    // Devtools is dev-only — render raw values for everything,\n    // including sensitive-named paths. Consumers concerned about\n    // screen-share leaks should close the panel before sharing.\n    payload.state['Form value'] = [\n      {\n        key: 'form',\n        value: state.form.value,\n        editable: true,\n      },\n    ]\n    // Schema-driven and user-injected errors land in separate inspector\n    // sections so devs can see the source distinction at a glance — a\n    // user-injected entry surviving a successful submit, or a schema\n    // entry that should have cleared after a value fix, are immediately\n    // visible without cross-referencing call sites.\n    payload.state['Schema Errors'] = [\n      ...[...state.schemaErrors.entries()].map(([k, v]) => ({\n        key: String(k),\n        value: v as unknown,\n      })),\n    ]\n    payload.state['User Errors'] = [\n      ...[...state.userErrors.entries()].map(([k, v]) => ({\n        key: String(k),\n        value: v as unknown,\n      })),\n    ]\n    payload.state['Aggregates'] = [\n      { key: 'submitting', value: state.submitting.value },\n      { key: 'submissionAttempts', value: state.submissionAttempts.value },\n      { key: 'departAttempts', value: state.departAttempts.value },\n      { key: 'submitError', value: state.submitError.value },\n      { key: 'activeValidations', value: state.activeValidations.value },\n    ]\n  })\n\n  api.on.editInspectorState((payload) => {\n    if (payload.inspectorId !== INSPECTOR_ID) return\n    if (!payload.nodeId.startsWith('form:')) return\n    const formKey = payload.nodeId.slice('form:'.length)\n    const state = registry.forms.get(formKey)\n    if (state === undefined) return\n    // payload.path is `['Form value', 'form', ...pathSegments]` — the\n    // first two segments are the inspector section + key, the rest is\n    // the target form path the user edited. Pass the segment array\n    // directly to `canonicalizePath`: join('.') would collapse a\n    // literal-dot field key (`{\"user.email\": ...}`) into two segments,\n    // writing to the wrong leaf.\n    if (payload.path.length < 3) return\n    const section = payload.path[0]\n    if (section !== 'Form value') return\n    const segments = payload.path.slice(2)\n    const { segments: canonicalPath, key: canonicalKey } = canonicalizePath(segments)\n    // A devtools edit on a path that any element has opted in to should\n    // persist (matches the user's expectation: editing via the inspector\n    // should be indistinguishable from typing into the bound input).\n    // No opt-in for this path → no write.\n    state.setValueAtPath(canonicalPath, payload.state.value, {\n      persist: state.persistOptIns.hasAnyOptInForPath(canonicalKey),\n    })\n    refreshState()\n  })\n\n  // Initial sync so existing forms show up.\n  syncForms()\n  refreshTree()\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"devtools.mjs","sources":["../../src/runtime/core/devtools.ts"],"sourcesContent":["import type { App } from 'vue'\nimport type { FormStore } from './create-form-store'\nimport type { AttaformRegistry } from './registry'\nimport type { GenericForm } from '../types/types-core'\nimport type { FormKey } from '../types/types-api'\nimport { canonicalizePath } from './paths'\n\n/**\n * Vue DevTools plugin wiring for attaform. Lazy-imported by\n * `createAttaform` under dev-mode guards so the production\n * bundle tree-shakes it out entirely.\n *\n * Registers:\n *  - An inspector (per-app) that lists every registered form, with\n *    nodes for form value / errors / aggregates / history.\n *  - A timeline layer that emits events on submit start/success/\n *    failure, reset, undo, redo, and form mutations.\n *  - State editing — modifying a leaf inside the inspector tree\n *    pushes through `state.setValueAtPath`, mutating the form.\n *\n * Tolerant of missing `@vue/devtools-api` — the peer dep is marked\n * optional. If the import fails, `setupAttaformDevtools` silently\n * no-ops so production builds / users without DevTools installed\n * don't see errors.\n */\n\nconst INSPECTOR_ID = 'attaform'\nconst TIMELINE_LAYER_ID = 'attaform:events'\n\ntype UnsafeDevtoolsApi = {\n  addInspector(opts: { id: string; label: string; icon?: string; app: App }): void\n  addTimelineLayer(opts: { id: string; label: string; color: number }): void\n  sendInspectorTree(inspectorId: string): void\n  sendInspectorState(inspectorId: string): void\n  addTimelineEvent(payload: {\n    layerId: string\n    event: {\n      time: number\n      title: string\n      subtitle?: string\n      data?: Record<string, unknown>\n      groupId?: string | number\n    }\n  }): void\n  on: {\n    getInspectorTree(\n      handler: (payload: {\n        inspectorId: string\n        filter: string\n        rootNodes: Array<{ id: string; label: string; tags?: unknown[] }>\n      }) => void\n    ): void\n    getInspectorState(\n      handler: (payload: {\n        inspectorId: string\n        nodeId: string\n        state: Record<string, Array<{ key: string; value: unknown; editable?: boolean }>>\n      }) => void\n    ): void\n    editInspectorState(\n      handler: (payload: {\n        inspectorId: string\n        nodeId: string\n        path: string[]\n        state: { value: unknown; newKey?: string | null; remove?: boolean }\n      }) => void\n    ): void\n  }\n}\n\ntype SetupDevtoolsPluginFn = (\n  descriptor: {\n    id: string\n    label: string\n    packageName?: string\n    homepage?: string\n    componentStateTypes?: string[]\n    app: App\n  },\n  setup: (api: UnsafeDevtoolsApi) => void\n) => void\n\n/**\n * Install the DevTools plugin for the given Vue app + registry. Safe\n * to call in production — if `@vue/devtools-api` isn't installed, the\n * dynamic import fails and we log nothing. Returns `true` when\n * DevTools was wired successfully, `false` otherwise — useful for\n * tests.\n */\nexport async function setupAttaformDevtools(\n  app: App,\n  registry: AttaformRegistry\n): Promise<boolean> {\n  let mod: { setupDevtoolsPlugin?: SetupDevtoolsPluginFn }\n  try {\n    mod = (await import('@vue/devtools-api')) as {\n      setupDevtoolsPlugin?: SetupDevtoolsPluginFn\n    }\n  } catch {\n    // Peer dep not installed — silently skip. Production builds pass\n    // `{ devtools: false }` explicitly, but this catch covers the\n    // \"dev without the peer dep\" case without a noisy warning.\n    return false\n  }\n  const setupDevtoolsPlugin = mod.setupDevtoolsPlugin\n  if (typeof setupDevtoolsPlugin !== 'function') return false\n\n  setupDevtoolsPlugin(\n    {\n      id: INSPECTOR_ID,\n      label: 'Attaform',\n      packageName: 'attaform',\n      homepage: 'https://github.com/attaform/Attaform',\n      app,\n      componentStateTypes: ['Attaform form'],\n    },\n    (api) => wire(api, app, registry)\n  )\n  return true\n}\n\nfunction wire(api: UnsafeDevtoolsApi, app: App, registry: AttaformRegistry): void {\n  // Per-form subscriber bookkeeping — we keep the unsubscribers so\n  // the registry's eviction path can detach them when a form is\n  // disposed. Using a Map keyed by FormKey mirrors the registry.\n  const subscriberUnsubs = new Map<FormKey, () => void>()\n\n  api.addInspector({ id: INSPECTOR_ID, label: 'Attaform', app })\n  api.addTimelineLayer({ id: TIMELINE_LAYER_ID, label: 'Attaform', color: 0x5b8def })\n\n  function refreshTree(): void {\n    api.sendInspectorTree(INSPECTOR_ID)\n  }\n\n  function refreshState(): void {\n    api.sendInspectorState(INSPECTOR_ID)\n  }\n\n  function subscribeForm(state: FormStore<GenericForm>): void {\n    if (subscriberUnsubs.has(state.formKey)) return\n    const unsubChange = state.onFormChange(() => {\n      refreshState()\n      api.addTimelineEvent({\n        layerId: TIMELINE_LAYER_ID,\n        event: {\n          time: Date.now(),\n          title: 'form.change',\n          subtitle: state.formKey,\n          // Devtools is dev-only — emit raw values. Consumers worried\n          // about screen-share leaks should close the panel before\n          // sharing, same as they would for the browser DevTools\n          // console.\n          data: { form: state.form.value as Record<string, unknown> },\n        },\n      })\n    })\n    const unsubSubmit = state.onSubmitSuccess(() => {\n      api.addTimelineEvent({\n        layerId: TIMELINE_LAYER_ID,\n        event: {\n          time: Date.now(),\n          title: 'submit.success',\n          subtitle: state.formKey,\n          data: { form: state.form.value as Record<string, unknown> },\n        },\n      })\n    })\n    const unsubReset = state.onReset(() => {\n      refreshState()\n      api.addTimelineEvent({\n        layerId: TIMELINE_LAYER_ID,\n        event: {\n          time: Date.now(),\n          title: 'reset',\n          subtitle: state.formKey,\n        },\n      })\n    })\n    subscriberUnsubs.set(state.formKey, () => {\n      unsubChange()\n      unsubSubmit()\n      unsubReset()\n    })\n  }\n\n  // Subscribe all currently-registered forms + register as they're\n  // added. The registry's `forms` Map is shallowReactive — we poll\n  // once per render on refresh; for live change detection, each\n  // useForm call that adds a new form triggers a tree/state refresh\n  // via the form's own onFormChange emission on the first\n  // applyFormReplacement.\n  function syncForms(): void {\n    for (const [, state] of registry.forms) {\n      subscribeForm(state)\n    }\n    // Drop subscribers for forms that were evicted.\n    for (const [formKey, unsub] of subscriberUnsubs) {\n      if (!registry.forms.has(formKey)) {\n        unsub()\n        subscriberUnsubs.delete(formKey)\n      }\n    }\n  }\n\n  api.on.getInspectorTree((payload) => {\n    if (payload.inspectorId !== INSPECTOR_ID) return\n    syncForms()\n    payload.rootNodes = [...registry.forms.keys()].map((key) => ({\n      id: `form:${key}`,\n      label: key,\n      tags: [],\n    }))\n  })\n\n  api.on.getInspectorState((payload) => {\n    if (payload.inspectorId !== INSPECTOR_ID) return\n    if (!payload.nodeId.startsWith('form:')) return\n    const formKey = payload.nodeId.slice('form:'.length)\n    const state = registry.forms.get(formKey)\n    if (state === undefined) return\n    // Devtools is dev-only — render raw values for everything,\n    // including sensitive-named paths. Consumers concerned about\n    // screen-share leaks should close the panel before sharing.\n    payload.state['Form value'] = [\n      {\n        key: 'form',\n        value: state.form.value,\n        editable: true,\n      },\n    ]\n    // Schema-driven and user-injected errors land in separate inspector\n    // sections so devs can see the source distinction at a glance — a\n    // user-injected entry surviving a successful submit, or a schema\n    // entry that should have cleared after a value fix, are immediately\n    // visible without cross-referencing call sites.\n    payload.state['Schema Errors'] = [\n      ...[...state.schemaErrors.entries()].map(([k, v]) => ({\n        key: String(k),\n        value: v as unknown,\n      })),\n    ]\n    payload.state['User Errors'] = [\n      ...[...state.userErrors.entries()].map(([k, v]) => ({\n        key: String(k),\n        value: v as unknown,\n      })),\n    ]\n    payload.state['Aggregates'] = [\n      { key: 'submitting', value: state.submitting.value },\n      { key: 'submissionAttempts', value: state.submissionAttempts.value },\n      { key: 'departAttempts', value: state.departAttempts.value },\n      { key: 'submitError', value: state.submitError.value },\n      { key: 'activeValidations', value: state.activeValidations.value },\n    ]\n  })\n\n  api.on.editInspectorState((payload) => {\n    if (payload.inspectorId !== INSPECTOR_ID) return\n    if (!payload.nodeId.startsWith('form:')) return\n    const formKey = payload.nodeId.slice('form:'.length)\n    const state = registry.forms.get(formKey)\n    if (state === undefined) return\n    // payload.path is `['Form value', 'form', ...pathSegments]` — the\n    // first two segments are the inspector section + key, the rest is\n    // the target form path the user edited. Pass the segment array\n    // directly to `canonicalizePath`: join('.') would collapse a\n    // literal-dot field key (`{\"user.email\": ...}`) into two segments,\n    // writing to the wrong leaf.\n    if (payload.path.length < 3) return\n    const section = payload.path[0]\n    if (section !== 'Form value') return\n    const segments = payload.path.slice(2)\n    const { segments: canonicalPath, key: canonicalKey } = canonicalizePath(segments)\n    // A devtools edit on a path that any element has opted in to should\n    // persist (matches the user's expectation: editing via the inspector\n    // should be indistinguishable from typing into the bound input).\n    // No opt-in for this path → no write.\n    state.setValueAtPath(canonicalPath, payload.state.value, {\n      persist: state.persistOptIns.hasAnyOptInForPath(canonicalKey),\n    })\n    refreshState()\n  })\n\n  // Initial sync so existing forms show up.\n  syncForms()\n  refreshTree()\n}\n"],"names":[],"mappings":"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"}

package/dist/chunks/indexeddb.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-const paths = require('../shared/attaform.BPy-4qRx.cjs');
+const paths = require('../shared/attaform.z5j3LwJz.cjs');
 
 const DB_NAME = "attaform";
 const STORE_NAME = "kv";

package/dist/chunks/indexeddb.mjs

@@ -1,4 +1,4 @@
-import { _ as __DEV__ } from '../shared/attaform.BKozEdTr.mjs';
+import { _ as __DEV__ } from '../shared/attaform.QG5TG8lB.mjs';
 
 const DB_NAME = "attaform";
 const STORE_NAME = "kv";

package/dist/chunks/local-storage.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-const paths = require('../shared/attaform.BPy-4qRx.cjs');
+const paths = require('../shared/attaform.z5j3LwJz.cjs');
 
 function createLocalStorageAdapter() {
   const available = typeof localStorage !== "undefined";

package/dist/chunks/local-storage.mjs

@@ -1,4 +1,4 @@
-import { _ as __DEV__ } from '../shared/attaform.BKozEdTr.mjs';
+import { _ as __DEV__ } from '../shared/attaform.QG5TG8lB.mjs';
 
 function createLocalStorageAdapter() {
   const available = typeof localStorage !== "undefined";

package/dist/chunks/session-storage.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-const paths = require('../shared/attaform.BPy-4qRx.cjs');
+const paths = require('../shared/attaform.z5j3LwJz.cjs');
 
 function createSessionStorageAdapter() {
   const available = typeof sessionStorage !== "undefined";

package/dist/chunks/session-storage.mjs

@@ -1,4 +1,4 @@
-import { _ as __DEV__ } from '../shared/attaform.BKozEdTr.mjs';
+import { _ as __DEV__ } from '../shared/attaform.QG5TG8lB.mjs';
 
 function createSessionStorageAdapter() {
   const available = typeof sessionStorage !== "undefined";

package/dist/index.cjs

@@ -1,8 +1,8 @@
 'use strict';
 
-const paths = require('./shared/attaform.BPy-4qRx.cjs');
-const devtoolsShared = require('./shared/attaform.BPxsYtTe.cjs');
-const injectWizard = require('./shared/attaform.DLnE5bZa.cjs');
+const paths = require('./shared/attaform.z5j3LwJz.cjs');
+const devtoolsShared = require('./shared/attaform.D2SCCd4O.cjs');
+const injectWizard = require('./shared/attaform.CwLjUqmQ.cjs');
 
 function escapeForInlineScript(json) {
   return json.replace(/[<>&\u2028\u2029]/g, (char) => {

package/dist/index.d.cts

@@ -1,8 +1,8 @@
 import { Plugin, App } from 'vue';
-import { S as SSRDetectOptions, c as SerializedFormData, b as AttaformRegistry } from './shared/attaform.D5-1XGQU.cjs';
-export { A as AnyForm, a as AttaformErrorCode, C as CompiledStep, F as FormStatus, I as InjectWizardInput, L as LazyMarker, d as StepSlot, U as UseRegisterReturn, e as UseWizardReturnType, W as WizardAggregateError, f as WizardCtx, g as WizardCtxForm, h as WizardOnError, i as WizardOnSubmit, j as WizardOptions, k as WizardPersistFn, l as WizardRestoreFn, m as WizardRestoreState, n as WizardStatusesProxy, o as WizardSubmitContext, p as createRegistry, q as defaultCoercionRules, r as defineCoercion, s as getRegistryFromApp, t as injectForm, u as injectWizard, v as kAttaformRegistry, w as lazy, x as useRegister, y as useRegistry, z as useWizard } from './shared/attaform.D5-1XGQU.cjs';
-import { f as AttaformDefaults, t as FormKey, G as GenericForm, ai as UseFormConfiguration, A as AbstractSchema, j as DefaultValuesInput, aj as UseFormReturnType, a8 as RegisterValue, a3 as RegisterModelDynamicCustomDirective, x as GetDisplayState, am as ValidationError, c as ApiErrorEnvelope, a as ApiErrorDetails } from './shared/attaform.SfhU0OEY.cjs';
-export { b as ApiErrorEntry, d as ArrayItem, e as ArrayPath, C as CoercionEntry, g as CoercionRegistry, h as CoercionResult, i as CustomDirectiveRegisterAssignerFn, D as DeepPartial, k as DefaultValuesResponse, l as DefaultValuesShape, m as DisplayState, E as ErrorsProxyShape, F as FieldMetaPayload, n as FieldState, o as FieldStateMap, p as FieldStateMapEntry, q as FlatPath, r as FormErrorRecord, s as FormErrorsSurface, u as FormMeta, v as FormStorage, w as FormStorageKind, H as HandleSubmit, y as HistoryConfig, I as IsTuple, z as IsUnion, J as JoinSegments, K as KeyofUnion, L as LiftedValueShape, M as MetaTrackerValue, N as NestedReadType, B as NestedType, O as OnError, P as OnInvalidSubmitPolicy, Q as OnSubmit, R as PartialFlatPath, S as Path, T as PathKey, U as PendingValidationStatus, V as PersistConfig, W as PersistConfigOptions, X as PersistIncludeMode, Z as Primitive, _ as ROOT_PATH, $ as ROOT_PATH_KEY, a0 as ReactiveValidationStatus, a1 as RegisterDirective, a2 as RegisterFlatPath, a4 as RegisterOptions, a5 as RegisterSelectModifier, a6 as RegisterTextModifier, a7 as RegisterTransform, aa as Segment, ab as SetValueCallback, ac as SetValuePayload, ad as SettledValidationStatus, ae as SlimPrimitiveKind, af as SlimRuntimeOf, ag as SubmitHandler, ah as Unset, ak as ValidateOn, al as ValidateOnConfig, an as ValidationResponse, ao as ValidationResponseWithoutValue, ap as ValueOfUnion, aq as WriteMeta, ar as WriteShape, as as canonicalizePath, at as isPathPrefix, au as isUnset, av as parseDottedPath, aw as unset } from './shared/attaform.SfhU0OEY.cjs';
+import { S as SSRDetectOptions, c as SerializedFormData, b as AttaformRegistry } from './shared/attaform.DbRgDFa7.cjs';
+export { A as AnyForm, a as AttaformErrorCode, C as CompiledStep, F as FormStatus, I as InjectWizardInput, L as LazyMarker, d as StepSlot, U as UseRegisterReturn, e as UseWizardReturnType, W as WizardAggregateError, f as WizardCtx, g as WizardCtxForm, h as WizardOnError, i as WizardOnSubmit, j as WizardOptions, k as WizardPersistFn, l as WizardRestoreFn, m as WizardRestoreState, n as WizardStatusesProxy, o as WizardSubmitContext, p as createRegistry, q as defaultCoercionRules, r as defineCoercion, s as getRegistryFromApp, t as injectForm, u as injectWizard, v as kAttaformRegistry, w as lazy, x as useRegister, y as useRegistry, z as useWizard } from './shared/attaform.DbRgDFa7.cjs';
+import { f as AttaformDefaults, t as FormKey, G as GenericForm, ai as UseFormConfiguration, A as AbstractSchema, j as DefaultValuesInput, aj as UseFormReturnType, a8 as RegisterValue, a3 as RegisterModelDynamicCustomDirective, x as GetDisplayState, am as ValidationError, c as ApiErrorEnvelope, a as ApiErrorDetails } from './shared/attaform.99cfHcIt.cjs';
+export { b as ApiErrorEntry, d as ArrayItem, e as ArrayPath, C as CoercionEntry, g as CoercionRegistry, h as CoercionResult, i as CustomDirectiveRegisterAssignerFn, D as DeepPartial, k as DefaultValuesResponse, l as DefaultValuesShape, m as DisplayState, E as ErrorsProxyShape, F as FieldMetaPayload, n as FieldState, o as FieldStateMap, p as FieldStateMapEntry, q as FlatPath, r as FormErrorRecord, s as FormErrorsSurface, u as FormMeta, v as FormStorage, w as FormStorageKind, H as HandleSubmit, y as HistoryConfig, I as IsTuple, z as IsUnion, J as JoinSegments, K as KeyofUnion, L as LiftedValueShape, M as MetaTrackerValue, N as NestedReadType, B as NestedType, O as OnError, P as OnInvalidSubmitPolicy, Q as OnSubmit, R as PartialFlatPath, S as Path, T as PathKey, U as PendingValidationStatus, V as PersistConfig, W as PersistConfigOptions, X as PersistIncludeMode, Z as Primitive, _ as ROOT_PATH, $ as ROOT_PATH_KEY, a0 as ReactiveValidationStatus, a1 as RegisterDirective, a2 as RegisterFlatPath, a4 as RegisterOptions, a5 as RegisterSelectModifier, a6 as RegisterTextModifier, a7 as RegisterTransform, aa as Segment, ab as SetValueCallback, ac as SetValuePayload, ad as SettledValidationStatus, ae as SlimPrimitiveKind, af as SlimRuntimeOf, ag as SubmitHandler, ah as Unset, ak as ValidateOn, al as ValidateOnConfig, an as ValidationResponse, ao as ValidationResponseWithoutValue, ap as ValueOfUnion, aq as WriteMeta, ar as WriteShape, as as canonicalizePath, at as isPathPrefix, au as isUnset, av as parseDottedPath, aw as unset } from './shared/attaform.99cfHcIt.cjs';
 export { A as AnonPersistError, a as AttaformError, I as InvalidPathError, b as InvalidUseFormConfigError, O as OutsideSetupError, R as RegistryNotInstalledError, c as ReservedFormKeyError, S as SubmitErrorHandlerError } from './shared/attaform.DkA5J8NW.cjs';
 
 /**

package/dist/index.d.mts

@@ -1,8 +1,8 @@
 import { Plugin, App } from 'vue';
-import { S as SSRDetectOptions, c as SerializedFormData, b as AttaformRegistry } from './shared/attaform.EMzJcQci.mjs';
-export { A as AnyForm, a as AttaformErrorCode, C as CompiledStep, F as FormStatus, I as InjectWizardInput, L as LazyMarker, d as StepSlot, U as UseRegisterReturn, e as UseWizardReturnType, W as WizardAggregateError, f as WizardCtx, g as WizardCtxForm, h as WizardOnError, i as WizardOnSubmit, j as WizardOptions, k as WizardPersistFn, l as WizardRestoreFn, m as WizardRestoreState, n as WizardStatusesProxy, o as WizardSubmitContext, p as createRegistry, q as defaultCoercionRules, r as defineCoercion, s as getRegistryFromApp, t as injectForm, u as injectWizard, v as kAttaformRegistry, w as lazy, x as useRegister, y as useRegistry, z as useWizard } from './shared/attaform.EMzJcQci.mjs';
-import { f as AttaformDefaults, t as FormKey, G as GenericForm, ai as UseFormConfiguration, A as AbstractSchema, j as DefaultValuesInput, aj as UseFormReturnType, a8 as RegisterValue, a3 as RegisterModelDynamicCustomDirective, x as GetDisplayState, am as ValidationError, c as ApiErrorEnvelope, a as ApiErrorDetails } from './shared/attaform.SfhU0OEY.mjs';
-export { b as ApiErrorEntry, d as ArrayItem, e as ArrayPath, C as CoercionEntry, g as CoercionRegistry, h as CoercionResult, i as CustomDirectiveRegisterAssignerFn, D as DeepPartial, k as DefaultValuesResponse, l as DefaultValuesShape, m as DisplayState, E as ErrorsProxyShape, F as FieldMetaPayload, n as FieldState, o as FieldStateMap, p as FieldStateMapEntry, q as FlatPath, r as FormErrorRecord, s as FormErrorsSurface, u as FormMeta, v as FormStorage, w as FormStorageKind, H as HandleSubmit, y as HistoryConfig, I as IsTuple, z as IsUnion, J as JoinSegments, K as KeyofUnion, L as LiftedValueShape, M as MetaTrackerValue, N as NestedReadType, B as NestedType, O as OnError, P as OnInvalidSubmitPolicy, Q as OnSubmit, R as PartialFlatPath, S as Path, T as PathKey, U as PendingValidationStatus, V as PersistConfig, W as PersistConfigOptions, X as PersistIncludeMode, Z as Primitive, _ as ROOT_PATH, $ as ROOT_PATH_KEY, a0 as ReactiveValidationStatus, a1 as RegisterDirective, a2 as RegisterFlatPath, a4 as RegisterOptions, a5 as RegisterSelectModifier, a6 as RegisterTextModifier, a7 as RegisterTransform, aa as Segment, ab as SetValueCallback, ac as SetValuePayload, ad as SettledValidationStatus, ae as SlimPrimitiveKind, af as SlimRuntimeOf, ag as SubmitHandler, ah as Unset, ak as ValidateOn, al as ValidateOnConfig, an as ValidationResponse, ao as ValidationResponseWithoutValue, ap as ValueOfUnion, aq as WriteMeta, ar as WriteShape, as as canonicalizePath, at as isPathPrefix, au as isUnset, av as parseDottedPath, aw as unset } from './shared/attaform.SfhU0OEY.mjs';
+import { S as SSRDetectOptions, c as SerializedFormData, b as AttaformRegistry } from './shared/attaform.sWm8B15V.mjs';
+export { A as AnyForm, a as AttaformErrorCode, C as CompiledStep, F as FormStatus, I as InjectWizardInput, L as LazyMarker, d as StepSlot, U as UseRegisterReturn, e as UseWizardReturnType, W as WizardAggregateError, f as WizardCtx, g as WizardCtxForm, h as WizardOnError, i as WizardOnSubmit, j as WizardOptions, k as WizardPersistFn, l as WizardRestoreFn, m as WizardRestoreState, n as WizardStatusesProxy, o as WizardSubmitContext, p as createRegistry, q as defaultCoercionRules, r as defineCoercion, s as getRegistryFromApp, t as injectForm, u as injectWizard, v as kAttaformRegistry, w as lazy, x as useRegister, y as useRegistry, z as useWizard } from './shared/attaform.sWm8B15V.mjs';
+import { f as AttaformDefaults, t as FormKey, G as GenericForm, ai as UseFormConfiguration, A as AbstractSchema, j as DefaultValuesInput, aj as UseFormReturnType, a8 as RegisterValue, a3 as RegisterModelDynamicCustomDirective, x as GetDisplayState, am as ValidationError, c as ApiErrorEnvelope, a as ApiErrorDetails } from './shared/attaform.99cfHcIt.mjs';
+export { b as ApiErrorEntry, d as ArrayItem, e as ArrayPath, C as CoercionEntry, g as CoercionRegistry, h as CoercionResult, i as CustomDirectiveRegisterAssignerFn, D as DeepPartial, k as DefaultValuesResponse, l as DefaultValuesShape, m as DisplayState, E as ErrorsProxyShape, F as FieldMetaPayload, n as FieldState, o as FieldStateMap, p as FieldStateMapEntry, q as FlatPath, r as FormErrorRecord, s as FormErrorsSurface, u as FormMeta, v as FormStorage, w as FormStorageKind, H as HandleSubmit, y as HistoryConfig, I as IsTuple, z as IsUnion, J as JoinSegments, K as KeyofUnion, L as LiftedValueShape, M as MetaTrackerValue, N as NestedReadType, B as NestedType, O as OnError, P as OnInvalidSubmitPolicy, Q as OnSubmit, R as PartialFlatPath, S as Path, T as PathKey, U as PendingValidationStatus, V as PersistConfig, W as PersistConfigOptions, X as PersistIncludeMode, Z as Primitive, _ as ROOT_PATH, $ as ROOT_PATH_KEY, a0 as ReactiveValidationStatus, a1 as RegisterDirective, a2 as RegisterFlatPath, a4 as RegisterOptions, a5 as RegisterSelectModifier, a6 as RegisterTextModifier, a7 as RegisterTransform, aa as Segment, ab as SetValueCallback, ac as SetValuePayload, ad as SettledValidationStatus, ae as SlimPrimitiveKind, af as SlimRuntimeOf, ag as SubmitHandler, ah as Unset, ak as ValidateOn, al as ValidateOnConfig, an as ValidationResponse, ao as ValidationResponseWithoutValue, ap as ValueOfUnion, aq as WriteMeta, ar as WriteShape, as as canonicalizePath, at as isPathPrefix, au as isUnset, av as parseDottedPath, aw as unset } from './shared/attaform.99cfHcIt.mjs';
 export { A as AnonPersistError, a as AttaformError, I as InvalidPathError, b as InvalidUseFormConfigError, O as OutsideSetupError, R as RegistryNotInstalledError, c as ReservedFormKeyError, S as SubmitErrorHandlerError } from './shared/attaform.DkA5J8NW.mjs';
 
 /**

package/dist/index.d.ts

@@ -1,8 +1,8 @@
 import { Plugin, App } from 'vue';
-import { S as SSRDetectOptions, c as SerializedFormData, b as AttaformRegistry } from './shared/attaform.Bh3ACtts.js';
-export { A as AnyForm, a as AttaformErrorCode, C as CompiledStep, F as FormStatus, I as InjectWizardInput, L as LazyMarker, d as StepSlot, U as UseRegisterReturn, e as UseWizardReturnType, W as WizardAggregateError, f as WizardCtx, g as WizardCtxForm, h as WizardOnError, i as WizardOnSubmit, j as WizardOptions, k as WizardPersistFn, l as WizardRestoreFn, m as WizardRestoreState, n as WizardStatusesProxy, o as WizardSubmitContext, p as createRegistry, q as defaultCoercionRules, r as defineCoercion, s as getRegistryFromApp, t as injectForm, u as injectWizard, v as kAttaformRegistry, w as lazy, x as useRegister, y as useRegistry, z as useWizard } from './shared/attaform.Bh3ACtts.js';
-import { f as AttaformDefaults, t as FormKey, G as GenericForm, ai as UseFormConfiguration, A as AbstractSchema, j as DefaultValuesInput, aj as UseFormReturnType, a8 as RegisterValue, a3 as RegisterModelDynamicCustomDirective, x as GetDisplayState, am as ValidationError, c as ApiErrorEnvelope, a as ApiErrorDetails } from './shared/attaform.SfhU0OEY.js';
-export { b as ApiErrorEntry, d as ArrayItem, e as ArrayPath, C as CoercionEntry, g as CoercionRegistry, h as CoercionResult, i as CustomDirectiveRegisterAssignerFn, D as DeepPartial, k as DefaultValuesResponse, l as DefaultValuesShape, m as DisplayState, E as ErrorsProxyShape, F as FieldMetaPayload, n as FieldState, o as FieldStateMap, p as FieldStateMapEntry, q as FlatPath, r as FormErrorRecord, s as FormErrorsSurface, u as FormMeta, v as FormStorage, w as FormStorageKind, H as HandleSubmit, y as HistoryConfig, I as IsTuple, z as IsUnion, J as JoinSegments, K as KeyofUnion, L as LiftedValueShape, M as MetaTrackerValue, N as NestedReadType, B as NestedType, O as OnError, P as OnInvalidSubmitPolicy, Q as OnSubmit, R as PartialFlatPath, S as Path, T as PathKey, U as PendingValidationStatus, V as PersistConfig, W as PersistConfigOptions, X as PersistIncludeMode, Z as Primitive, _ as ROOT_PATH, $ as ROOT_PATH_KEY, a0 as ReactiveValidationStatus, a1 as RegisterDirective, a2 as RegisterFlatPath, a4 as RegisterOptions, a5 as RegisterSelectModifier, a6 as RegisterTextModifier, a7 as RegisterTransform, aa as Segment, ab as SetValueCallback, ac as SetValuePayload, ad as SettledValidationStatus, ae as SlimPrimitiveKind, af as SlimRuntimeOf, ag as SubmitHandler, ah as Unset, ak as ValidateOn, al as ValidateOnConfig, an as ValidationResponse, ao as ValidationResponseWithoutValue, ap as ValueOfUnion, aq as WriteMeta, ar as WriteShape, as as canonicalizePath, at as isPathPrefix, au as isUnset, av as parseDottedPath, aw as unset } from './shared/attaform.SfhU0OEY.js';
+import { S as SSRDetectOptions, c as SerializedFormData, b as AttaformRegistry } from './shared/attaform.ceGEAEMk.js';
+export { A as AnyForm, a as AttaformErrorCode, C as CompiledStep, F as FormStatus, I as InjectWizardInput, L as LazyMarker, d as StepSlot, U as UseRegisterReturn, e as UseWizardReturnType, W as WizardAggregateError, f as WizardCtx, g as WizardCtxForm, h as WizardOnError, i as WizardOnSubmit, j as WizardOptions, k as WizardPersistFn, l as WizardRestoreFn, m as WizardRestoreState, n as WizardStatusesProxy, o as WizardSubmitContext, p as createRegistry, q as defaultCoercionRules, r as defineCoercion, s as getRegistryFromApp, t as injectForm, u as injectWizard, v as kAttaformRegistry, w as lazy, x as useRegister, y as useRegistry, z as useWizard } from './shared/attaform.ceGEAEMk.js';
+import { f as AttaformDefaults, t as FormKey, G as GenericForm, ai as UseFormConfiguration, A as AbstractSchema, j as DefaultValuesInput, aj as UseFormReturnType, a8 as RegisterValue, a3 as RegisterModelDynamicCustomDirective, x as GetDisplayState, am as ValidationError, c as ApiErrorEnvelope, a as ApiErrorDetails } from './shared/attaform.99cfHcIt.js';
+export { b as ApiErrorEntry, d as ArrayItem, e as ArrayPath, C as CoercionEntry, g as CoercionRegistry, h as CoercionResult, i as CustomDirectiveRegisterAssignerFn, D as DeepPartial, k as DefaultValuesResponse, l as DefaultValuesShape, m as DisplayState, E as ErrorsProxyShape, F as FieldMetaPayload, n as FieldState, o as FieldStateMap, p as FieldStateMapEntry, q as FlatPath, r as FormErrorRecord, s as FormErrorsSurface, u as FormMeta, v as FormStorage, w as FormStorageKind, H as HandleSubmit, y as HistoryConfig, I as IsTuple, z as IsUnion, J as JoinSegments, K as KeyofUnion, L as LiftedValueShape, M as MetaTrackerValue, N as NestedReadType, B as NestedType, O as OnError, P as OnInvalidSubmitPolicy, Q as OnSubmit, R as PartialFlatPath, S as Path, T as PathKey, U as PendingValidationStatus, V as PersistConfig, W as PersistConfigOptions, X as PersistIncludeMode, Z as Primitive, _ as ROOT_PATH, $ as ROOT_PATH_KEY, a0 as ReactiveValidationStatus, a1 as RegisterDirective, a2 as RegisterFlatPath, a4 as RegisterOptions, a5 as RegisterSelectModifier, a6 as RegisterTextModifier, a7 as RegisterTransform, aa as Segment, ab as SetValueCallback, ac as SetValuePayload, ad as SettledValidationStatus, ae as SlimPrimitiveKind, af as SlimRuntimeOf, ag as SubmitHandler, ah as Unset, ak as ValidateOn, al as ValidateOnConfig, an as ValidationResponse, ao as ValidationResponseWithoutValue, ap as ValueOfUnion, aq as WriteMeta, ar as WriteShape, as as canonicalizePath, at as isPathPrefix, au as isUnset, av as parseDottedPath, aw as unset } from './shared/attaform.99cfHcIt.js';
 export { A as AnonPersistError, a as AttaformError, I as InvalidPathError, b as InvalidUseFormConfigError, O as OutsideSetupError, R as RegistryNotInstalledError, c as ReservedFormKeyError, S as SubmitErrorHandlerError } from './shared/attaform.DkA5J8NW.js';
 
 /**

package/dist/index.mjs

@@ -1,8 +1,8 @@
-import { j as canonicalizePath, c as InvalidPathError } from './shared/attaform.BKozEdTr.mjs';
-export { A as AnonPersistError, a as AttaformError, D as DEFAULT_SENSITIVE_NAMES, d as InvalidUseFormConfigError, O as OutsideSetupError, R as ROOT_PATH, e as ROOT_PATH_KEY, f as RegistryNotInstalledError, g as ReservedFormKeyError, S as SubmitErrorHandlerError, i as assignKey, m as createAttaform, p as createRegistry, r as getRegistryFromApp, s as isPathPrefix, t as isRegisterValue, w as kAttaformRegistry, B as parseDottedPath, G as useRegister, H as useRegistry, J as vRegister } from './shared/attaform.BKozEdTr.mjs';
-export { D as DEVTOOLS_WINDOW_KEY, h as hydrateAttaformState, r as renderAttaformState } from './shared/attaform.EZG6fOFb.mjs';
-import { n as normalizeNumericOption } from './shared/attaform.BqZuwLTK.mjs';
-export { A as AttaformErrorCode, d as defaultCoercionRules, a as defaultDisplayState, b as defineCoercion, i as injectForm, c as injectWizard, f as isUnset, l as lazy, u as unset, o as useForm, p as useWizard } from './shared/attaform.BqZuwLTK.mjs';
+import { j as canonicalizePath, c as InvalidPathError } from './shared/attaform.QG5TG8lB.mjs';
+export { A as AnonPersistError, a as AttaformError, D as DEFAULT_SENSITIVE_NAMES, d as InvalidUseFormConfigError, O as OutsideSetupError, R as ROOT_PATH, e as ROOT_PATH_KEY, f as RegistryNotInstalledError, g as ReservedFormKeyError, S as SubmitErrorHandlerError, i as assignKey, m as createAttaform, p as createRegistry, s as getRegistryFromApp, t as isPathPrefix, u as isRegisterValue, x as kAttaformRegistry, C as parseDottedPath, H as useRegister, J as useRegistry, K as vRegister } from './shared/attaform.QG5TG8lB.mjs';
+export { D as DEVTOOLS_WINDOW_KEY, h as hydrateAttaformState, r as renderAttaformState } from './shared/attaform.CnrxbkB6.mjs';
+import { n as normalizeNumericOption } from './shared/attaform.tiWEVznj.mjs';
+export { A as AttaformErrorCode, d as defaultCoercionRules, a as defaultDisplayState, b as defineCoercion, i as injectForm, c as injectWizard, f as isUnset, l as lazy, u as unset, o as useForm, p as useWizard } from './shared/attaform.tiWEVznj.mjs';
 
 function escapeForInlineScript(json) {
   return json.replace(/[<>&\u2028\u2029]/g, (char) => {

package/dist/nuxt.d.cts

@@ -1,5 +1,5 @@
 import * as _nuxt_schema from '@nuxt/schema';
-import { f as AttaformDefaults } from './shared/attaform.SfhU0OEY.cjs';
+import { f as AttaformDefaults } from './shared/attaform.99cfHcIt.cjs';
 import 'vue';
 
 /**

package/dist/nuxt.d.mts

@@ -1,5 +1,5 @@
 import * as _nuxt_schema from '@nuxt/schema';
-import { f as AttaformDefaults } from './shared/attaform.SfhU0OEY.mjs';
+import { f as AttaformDefaults } from './shared/attaform.99cfHcIt.mjs';
 import 'vue';
 
 /**

package/dist/nuxt.d.ts

@@ -1,5 +1,5 @@
 import * as _nuxt_schema from '@nuxt/schema';
-import { f as AttaformDefaults } from './shared/attaform.SfhU0OEY.js';
+import { f as AttaformDefaults } from './shared/attaform.99cfHcIt.js';
 import 'vue';
 
 /**

package/dist/runtime/plugins/attaform.cjs

@@ -1,8 +1,8 @@
 'use strict';
 
 const app = require('nuxt/app');
-const devtoolsShared = require('../../shared/attaform.BPxsYtTe.cjs');
-const paths = require('../../shared/attaform.BPy-4qRx.cjs');
+const devtoolsShared = require('../../shared/attaform.D2SCCd4O.cjs');
+const paths = require('../../shared/attaform.z5j3LwJz.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 { 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';
+import { r as renderAttaformState, h as hydrateAttaformState, D as DEVTOOLS_WINDOW_KEY } from '../../shared/attaform.CnrxbkB6.mjs';
+import { m as createAttaform, y as kAttaformWizardActiveStepResolver, s as getRegistryFromApp } from '../../shared/attaform.QG5TG8lB.mjs';
 
 var attaform_default = defineNuxtPlugin({
   // `enforce: 'pre'` makes the "we run before any component's setup" claim

package/dist/shared/{attaform.SfhU0OEY.d.cts → attaform.99cfHcIt.d.cts}

@@ -2554,18 +2554,34 @@ type RegisterValue<Value = unknown> = Readonly<{
      * Attach an HTML element to this binding. Called by `v-register`
      * automatically; expose it to custom integrations that need to
      * register an element manually.
+     *
+     * Recording the element also enables `setValueWithInternalPath` to
+     * auto-attach per-element persist meta on writes that don't carry
+     * their own.
      */
     registerElement: (el: HTMLElement) => void;
     /**
      * Detach an HTML element from this binding. Pair with
-     * `registerElement` for custom integrations.
+     * `registerElement` for custom integrations. Clears the recorded
+     * element so subsequent writes without explicit `meta` fall back to
+     * "no auto-persist".
      */
     deregisterElement: (el: HTMLElement) => void;
     /**
      * Write the field's value programmatically. Returns `true` when the
      * write was accepted, `false` when it was rejected (e.g. wrong
-     * primitive type for the path). The optional `meta` lets custom
-     * directives signal whether the write should be persisted.
+     * primitive type for the path).
+     *
+     * When `meta` is undefined and the binding has a registered element,
+     * the rv consults the per-element opt-in (set by
+     * `register(path, { persist: true })` against that element) and
+     * auto-attaches `{ persist: true }` when opted in. Custom directives
+     * and consumer assigners can omit `meta` to participate in the same
+     * persistence channel the default assigner uses.
+     *
+     * Pass an explicit `meta` to override the auto-derivation, e.g.
+     * `{ persist: false }` to skip persistence for a transient write
+     * even when the element is opted in.
      */
     setValueWithInternalPath: (value: unknown, meta?: WriteMeta) => boolean;
     /**
@@ -2808,9 +2824,9 @@ type RegisterValue<Value = unknown> = Readonly<{
  * on the bound element.
  *
  * The directive passes the extracted value plus the `RegisterValue`
- * the directive is currently bound to. The second arg lets a
- * top-level handler write back to form state without having to
- * capture the RV via closure:
+ * the directive is currently bound to, regardless of install path.
+ * The second arg lets a top-level handler write back to form state
+ * without having to capture the RV via closure:
  *
  * ```ts
  * function upperCaseAssigner(value: unknown, rv: RegisterValue): void {
@@ -2818,9 +2834,10 @@ type RegisterValue<Value = unknown> = Readonly<{
  * }
  * ```
  *
- * `registerValue` is omitted only for assigners installed directly
- * via `el[assignKey] = fn` — those callers already have the RV in
- * scope at install time.
+ * The `registerValue` parameter is typed optional only to keep
+ * standalone invocations from outside the directive (rare; manual
+ * dispatch in tests, for example) type-checkable; the directive
+ * itself always supplies it at fire time.
  *
  * Return `true` when the write was accepted, `false` when it was
  * rejected (e.g. the value didn't match the path's expected type).

package/dist/shared/{attaform.SfhU0OEY.d.mts → attaform.99cfHcIt.d.mts}

@@ -2554,18 +2554,34 @@ type RegisterValue<Value = unknown> = Readonly<{
      * Attach an HTML element to this binding. Called by `v-register`
      * automatically; expose it to custom integrations that need to
      * register an element manually.
+     *
+     * Recording the element also enables `setValueWithInternalPath` to
+     * auto-attach per-element persist meta on writes that don't carry
+     * their own.
      */
     registerElement: (el: HTMLElement) => void;
     /**
      * Detach an HTML element from this binding. Pair with
-     * `registerElement` for custom integrations.
+     * `registerElement` for custom integrations. Clears the recorded
+     * element so subsequent writes without explicit `meta` fall back to
+     * "no auto-persist".
      */
     deregisterElement: (el: HTMLElement) => void;
     /**
      * Write the field's value programmatically. Returns `true` when the
      * write was accepted, `false` when it was rejected (e.g. wrong
-     * primitive type for the path). The optional `meta` lets custom
-     * directives signal whether the write should be persisted.
+     * primitive type for the path).
+     *
+     * When `meta` is undefined and the binding has a registered element,
+     * the rv consults the per-element opt-in (set by
+     * `register(path, { persist: true })` against that element) and
+     * auto-attaches `{ persist: true }` when opted in. Custom directives
+     * and consumer assigners can omit `meta` to participate in the same
+     * persistence channel the default assigner uses.
+     *
+     * Pass an explicit `meta` to override the auto-derivation, e.g.
+     * `{ persist: false }` to skip persistence for a transient write
+     * even when the element is opted in.
      */
     setValueWithInternalPath: (value: unknown, meta?: WriteMeta) => boolean;
     /**
@@ -2808,9 +2824,9 @@ type RegisterValue<Value = unknown> = Readonly<{
  * on the bound element.
  *
  * The directive passes the extracted value plus the `RegisterValue`
- * the directive is currently bound to. The second arg lets a
- * top-level handler write back to form state without having to
- * capture the RV via closure:
+ * the directive is currently bound to, regardless of install path.
+ * The second arg lets a top-level handler write back to form state
+ * without having to capture the RV via closure:
  *
  * ```ts
  * function upperCaseAssigner(value: unknown, rv: RegisterValue): void {
@@ -2818,9 +2834,10 @@ type RegisterValue<Value = unknown> = Readonly<{
  * }
  * ```
  *
- * `registerValue` is omitted only for assigners installed directly
- * via `el[assignKey] = fn` — those callers already have the RV in
- * scope at install time.
+ * The `registerValue` parameter is typed optional only to keep
+ * standalone invocations from outside the directive (rare; manual
+ * dispatch in tests, for example) type-checkable; the directive
+ * itself always supplies it at fire time.
  *
  * Return `true` when the write was accepted, `false` when it was
  * rejected (e.g. the value didn't match the path's expected type).

package/dist/shared/{attaform.SfhU0OEY.d.ts → attaform.99cfHcIt.d.ts}

@@ -2554,18 +2554,34 @@ type RegisterValue<Value = unknown> = Readonly<{
      * Attach an HTML element to this binding. Called by `v-register`
      * automatically; expose it to custom integrations that need to
      * register an element manually.
+     *
+     * Recording the element also enables `setValueWithInternalPath` to
+     * auto-attach per-element persist meta on writes that don't carry
+     * their own.
      */
     registerElement: (el: HTMLElement) => void;
     /**
      * Detach an HTML element from this binding. Pair with
-     * `registerElement` for custom integrations.
+     * `registerElement` for custom integrations. Clears the recorded
+     * element so subsequent writes without explicit `meta` fall back to
+     * "no auto-persist".
      */
     deregisterElement: (el: HTMLElement) => void;
     /**
      * Write the field's value programmatically. Returns `true` when the
      * write was accepted, `false` when it was rejected (e.g. wrong
-     * primitive type for the path). The optional `meta` lets custom
-     * directives signal whether the write should be persisted.
+     * primitive type for the path).
+     *
+     * When `meta` is undefined and the binding has a registered element,
+     * the rv consults the per-element opt-in (set by
+     * `register(path, { persist: true })` against that element) and
+     * auto-attaches `{ persist: true }` when opted in. Custom directives
+     * and consumer assigners can omit `meta` to participate in the same
+     * persistence channel the default assigner uses.
+     *
+     * Pass an explicit `meta` to override the auto-derivation, e.g.
+     * `{ persist: false }` to skip persistence for a transient write
+     * even when the element is opted in.
      */
     setValueWithInternalPath: (value: unknown, meta?: WriteMeta) => boolean;
     /**
@@ -2808,9 +2824,9 @@ type RegisterValue<Value = unknown> = Readonly<{
  * on the bound element.
  *
  * The directive passes the extracted value plus the `RegisterValue`
- * the directive is currently bound to. The second arg lets a
- * top-level handler write back to form state without having to
- * capture the RV via closure:
+ * the directive is currently bound to, regardless of install path.
+ * The second arg lets a top-level handler write back to form state
+ * without having to capture the RV via closure:
  *
  * ```ts
  * function upperCaseAssigner(value: unknown, rv: RegisterValue): void {
@@ -2818,9 +2834,10 @@ type RegisterValue<Value = unknown> = Readonly<{
  * }
  * ```
  *
- * `registerValue` is omitted only for assigners installed directly
- * via `el[assignKey] = fn` — those callers already have the RV in
- * scope at install time.
+ * The `registerValue` parameter is typed optional only to keep
+ * standalone invocations from outside the directive (rare; manual
+ * dispatch in tests, for example) type-checkable; the directive
+ * itself always supplies it at fire time.
  *
  * Return `true` when the write was accepted, `false` when it was
  * rejected (e.g. the value didn't match the path's expected type).