attaform 0.26.0 → 0.27.1

package/README.md

@@ -24,36 +24,44 @@ A type-safe, schema-driven form library for Vue 3 and Nuxt with first-class Zod
 npm install attaform zod
 ```
 
+<!-- @generated-start:quick-start -->
+
 ```vue
 <script setup lang="ts">
+  import { useForm } from 'attaform'
   import { z } from 'zod'
-  import { useForm } from 'attaform/zod' // auto-detects your Zod major
 
   const schema = z.object({
-    username: z.string().min(2, 'At least 2 characters'),
+    email: z.email('Enter a valid email'),
     password: z.string().min(8, 'At least 8 characters'),
   })
 
   const form = useForm({ schema })
 
   const onSubmit = form.handleSubmit(async (values) => {
-    await fetch('/api/signup', { method: 'POST', body: JSON.stringify(values) })
+    await fetch('/api/sign-in', { method: 'POST', body: JSON.stringify(values) })
   })
 </script>
 
 <template>
-  <form @submit.prevent="onSubmit">
-    <input v-register="form.register('username')" placeholder="Username" />
-    <small v-if="form.errors.username?.[0]">{{ form.errors.username[0].message }}</small>
-
-    <input v-register="form.register('password')" type="password" placeholder="Password" />
-    <small v-if="form.errors.password?.[0]">{{ form.errors.password[0].message }}</small>
-
-    <button :disabled="form.meta.submitting">Sign up</button>
+  <form @submit="onSubmit">
+    <label>
+      Email
+      <input v-register="form.register('email')" autocomplete="email" />
+      <em v-if="form.fields.email.showErrors">{{ form.fields.email.firstError?.message }}</em>
+    </label>
+    <label>
+      Password
+      <input v-register="form.register('password')" type="password" autocomplete="off" />
+      <em v-if="form.fields.password.showErrors">{{ form.fields.password.firstError?.message }}</em>
+    </label>
+    <button :disabled="form.meta.submitting" type="submit">Sign in</button>
   </form>
 </template>
 ```
 
+<!-- @generated-end:quick-start -->
+
 Hand the schema to `useForm`, bind each input with `v-register`, and Attaform owns the values, the coercion, the live errors, and the typed submit payload. That is the whole loop.
 
 **[Full walkthrough →](https://attaform.dev/docs/getting-started/quick-start)** Setting up Nuxt, Vite, or bare Vue? See the [installation guide](https://attaform.dev/docs/getting-started/installation).
@@ -65,6 +73,7 @@ Hand the schema to `useForm`, bind each input with `v-register`, and Attaform ow
 - **`useWizard` for multistep.** Compose forms into a flow with shared navigation, per-step validation, state retained across steps, and deep-link restore. [useWizard →](https://attaform.dev/docs/multistep/use-wizard)
 - **SSR-native.** Server-rendered HTML matches the hydrated client with no flash. Auto-wired in Nuxt, one Vite plugin for bare Vue. [SSR in Nuxt →](https://attaform.dev/docs/server-and-ssr/ssr-nuxt)
 - **DevTools built in.** Inspect every form on the page, walk its history, and edit values live. No probes to install. [DevTools panel →](https://attaform.dev/docs/devtools-and-debugging/devtools-panel)
+- **Built for AI-assisted coding.** Ships an `llms.txt` index, a full-text docs dump, and an installable Agent Skill (`npx attaform skill`), so your coding assistant writes idiomatic Attaform the first time. [AI agents →](https://attaform.dev/docs/reference/ai-agents)
 - **Secure by construction.** Zero runtime dependencies (no supply-chain surface), prototype-pollution-safe deep writes, and Attaform never throws into your app. [Security policy →](./SECURITY.md)
 
 ## Documentation
@@ -76,6 +85,7 @@ Full docs live at **[attaform.dev](https://attaform.dev)**.
 - [Entry points](https://attaform.dev/docs/reference/entry-points): every public export, grouped by subpath.
 - [Performance](https://attaform.dev/docs/server-and-ssr/performance): how it scales, when to worry.
 - [Troubleshooting](https://attaform.dev/docs/devtools-and-debugging/troubleshooting): common gotchas and fixes.
+- [AI agents](https://attaform.dev/docs/reference/ai-agents): `llms.txt`, the full-text docs dump, and an installable skill for coding assistants.
 - [Changelog](./CHANGELOG.md): full release history.
 
 ## Status

package/bin/attaform.mjs

@@ -0,0 +1,125 @@
+#!/usr/bin/env node
+/**
+ * Attaform CLI.
+ *
+ * `attaform skill [dir]` copies the bundled Agent Skill (which ships in
+ * the package under `skills/attaform/`) into a project so an AI
+ * assistant loads it while working on a form. The skill moves in
+ * lockstep with the installed Attaform version: run through `npx` in a
+ * project that already has Attaform and it copies that version's skill.
+ *
+ * With no `[dir]`, it places the skill next to whichever assistants the
+ * project already uses (`.claude/`, `.cursor/`, `.codex/`, `.agents/`)
+ * and falls back to the vendor-neutral `.agents/skills/` when none is
+ * present. `SKILL.md` is one portable format, so a single copy is read
+ * natively by Claude Code, Cursor, Codex, OpenCode, and the rest.
+ *
+ * Zero dependencies (Node built-ins only), so it ships verbatim with no
+ * build step.
+ */
+import { cpSync, existsSync, readdirSync } from 'node:fs'
+import { relative, resolve } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+// The skill directory bundled in the package, resolved relative to this
+// file (`bin/attaform.mjs` -> `skills/attaform/`). It ships via the
+// package.json `files` entry, so it is present in both the git checkout
+// and the installed package.
+const SKILL_SOURCE = fileURLToPath(new URL('../skills/attaform/', import.meta.url))
+
+// The vendor-neutral skills directory: read by OpenCode, Cursor, Cline,
+// and others, and the destination when a project has not committed to a
+// single assistant yet.
+const NEUTRAL_SKILLS_DIR = '.agents/skills'
+
+// Marker directory an assistant creates -> the skills directory it reads.
+// `SKILL.md` is one portable format, so the same files drop into each.
+// Detection is intentionally narrow: only paths a project would not have
+// for another reason (unlike `.github/`, which nearly every repo carries).
+const ASSISTANT_SKILL_DIRS = [
+  { marker: '.claude', skillsDir: '.claude/skills' },
+  { marker: '.cursor', skillsDir: '.cursor/skills' },
+  { marker: '.codex', skillsDir: '.codex/skills' },
+  { marker: '.agents', skillsDir: NEUTRAL_SKILLS_DIR },
+]
+
+function usage() {
+  console.log(
+    [
+      'Usage: attaform skill [dir]',
+      '',
+      "  Copy Attaform's Agent Skill into your project so an AI assistant",
+      '  loads it while working on a form.',
+      '',
+      '  With no [dir], the skill lands next to each assistant the project',
+      '  already uses (.claude, .cursor, .codex, .agents), or',
+      `  ${NEUTRAL_SKILLS_DIR}/ when none is present.`,
+      '',
+      '  [dir]   Skills directory to install into, e.g. attaform skill .cursor/skills',
+    ].join('\n')
+  )
+}
+
+function countFiles(dir) {
+  let total = 0
+  for (const entry of readdirSync(dir, { withFileTypes: true })) {
+    total += entry.isDirectory() ? countFiles(resolve(dir, entry.name)) : 1
+  }
+  return total
+}
+
+// The skills directories to install into. An explicit arg wins verbatim.
+// Otherwise place next to each assistant the project already uses, and
+// fall back to the vendor-neutral directory when none is detected.
+function resolveTargets(dirArg) {
+  if (dirArg !== undefined) return { dirs: [dirArg], detected: true }
+
+  const dirs = ASSISTANT_SKILL_DIRS.filter(({ marker }) =>
+    existsSync(resolve(process.cwd(), marker))
+  ).map(({ skillsDir }) => skillsDir)
+
+  return dirs.length > 0
+    ? { dirs, detected: true }
+    : { dirs: [NEUTRAL_SKILLS_DIR], detected: false }
+}
+
+function installSkill(skillsDir) {
+  const dest = resolve(skillsDir, 'attaform')
+  const existed = existsSync(dest)
+  cpSync(SKILL_SOURCE, dest, { recursive: true })
+
+  const where = relative(process.cwd(), dest) || dest
+  const count = countFiles(dest)
+  console.log(
+    `${existed ? 'Updated' : 'Installed'} the Attaform skill (${count} file${count === 1 ? '' : 's'}) at ${where}/`
+  )
+}
+
+const [command, dirArg] = process.argv.slice(2)
+
+if (command === undefined || command === '-h' || command === '--help' || command === 'help') {
+  usage()
+  process.exit(0)
+}
+
+if (command !== 'skill') {
+  console.error(`attaform: unknown command "${command}"\n`)
+  usage()
+  process.exit(1)
+}
+
+try {
+  const { dirs, detected } = resolveTargets(dirArg)
+  for (const dir of dirs) installSkill(dir)
+  if (!detected) {
+    console.log(
+      `No assistant directory found, so the skill went to the vendor-neutral ${NEUTRAL_SKILLS_DIR}/. Pass a path (e.g. attaform skill .claude/skills) to target a specific assistant.`
+    )
+  }
+  console.log('Your assistant will load it while it works on a form in this project.')
+} catch (error) {
+  console.error(
+    `attaform: could not install the skill: ${error instanceof Error ? error.message : String(error)}`
+  )
+  process.exit(1)
+}

package/dist/abstract.cjs

@@ -0,0 +1,47 @@
+'use strict';
+
+const serializeScript = require('./shared/attaform.DQT7_-FO.cjs');
+const devtoolsShared = require('./shared/attaform.Co5LNRnv.cjs');
+const registerProtocol = require('./shared/attaform.yUrz7C2z.cjs');
+
+
+
+exports.AttaformErrorCode = serializeScript.AttaformErrorCode;
+exports.DEFAULT_TIMINGS = serializeScript.DEFAULT_TIMINGS;
+exports.defaultCoercionRules = serializeScript.defaultCoercionRules;
+exports.defaultDisplayState = serializeScript.defaultDisplayState;
+exports.defineCoercion = serializeScript.defineCoercion;
+exports.escapeForInlineScript = serializeScript.escapeForInlineScript;
+exports.injectForm = serializeScript.injectForm;
+exports.injectWizard = serializeScript.injectWizard;
+exports.isUnset = serializeScript.isUnset;
+exports.lazy = serializeScript.lazy;
+exports.makeDefaultDisplayState = serializeScript.makeDefaultDisplayState;
+exports.unset = serializeScript.unset;
+exports.useAbstractForm = serializeScript.useAbstractForm;
+exports.useRegister = serializeScript.useRegister;
+exports.useWizard = serializeScript.useWizard;
+exports.AttaformError = devtoolsShared.AttaformError;
+exports.DEVTOOLS_WINDOW_KEY = devtoolsShared.DEVTOOLS_WINDOW_KEY;
+exports.InvalidPathError = devtoolsShared.InvalidPathError;
+exports.InvalidUseFormConfigError = devtoolsShared.InvalidUseFormConfigError;
+exports.OutsideSetupError = devtoolsShared.OutsideSetupError;
+exports.ROOT_PATH = devtoolsShared.ROOT_PATH;
+exports.ROOT_PATH_KEY = devtoolsShared.ROOT_PATH_KEY;
+exports.RegistryNotInstalledError = devtoolsShared.RegistryNotInstalledError;
+exports.ReservedFormKeyError = devtoolsShared.ReservedFormKeyError;
+exports.SubmitErrorHandlerError = devtoolsShared.SubmitErrorHandlerError;
+exports.assignKey = devtoolsShared.assignKey;
+exports.canonicalizePath = devtoolsShared.canonicalizePath;
+exports.createAttaform = devtoolsShared.createAttaform;
+exports.createRegistry = devtoolsShared.createRegistry;
+exports.getRegistryFromApp = devtoolsShared.getRegistryFromApp;
+exports.hydrateAttaformState = devtoolsShared.hydrateAttaformState;
+exports.isPathPrefix = devtoolsShared.isPathPrefix;
+exports.kAttaformRegistry = devtoolsShared.kAttaformRegistry;
+exports.parseDottedPath = devtoolsShared.parseDottedPath;
+exports.renderAttaformState = devtoolsShared.renderAttaformState;
+exports.useRegistry = devtoolsShared.useRegistry;
+exports.vRegister = devtoolsShared.vRegister;
+exports.isRegisterValue = registerProtocol.isRegisterValue;
+//# sourceMappingURL=abstract.cjs.map

package/dist/abstract.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"abstract.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/dist/abstract.d.cts

@@ -0,0 +1,42 @@
+import { A as AttaformRegistry } from './shared/attaform.D99pd7JG.cjs';
+export { a as AnyForm, b as AttaformDevtoolsBridge, c as AttaformError, d as AttaformErrorCode, e as AttaformPluginOptions, C as CompiledStep, D as DEFAULT_TIMINGS, f as DEVTOOLS_WINDOW_KEY, g as DisplayTimings, F as FormStatus, I as InjectWizardInput, h as InvalidPathError, i as InvalidUseFormConfigError, L as LazyMarker, O as OutsideSetupError, R as RegistryNotInstalledError, j as ReservedFormKeyError, S as SerializedAttaformState, k as SerializedFormData, l as StepSlot, m as SubmitErrorHandlerError, U as UseRegisterReturn, n as UseWizardReturnType, W as WizardAggregateError, o as WizardCtx, p as WizardCtxForm, q as WizardOnError, r as WizardOnSubmit, s as WizardOptions, t as WizardPersistFn, u as WizardRestoreFn, v as WizardRestoreState, w as WizardStatusesProxy, x as WizardSubmitContext, y as assignKey, z as createAttaform, B as createRegistry, E as defaultCoercionRules, G as defaultDisplayState, H as defineCoercion, J as escapeForInlineScript, K as getRegistryFromApp, M as hydrateAttaformState, N as injectForm, P as injectWizard, Q as isRegisterValue, T as kAttaformRegistry, V as lazy, X as makeDefaultDisplayState, Y as renderAttaformState, Z as useRegister, _ as useRegistry, $ as useWizard, a0 as vRegister } from './shared/attaform.D99pd7JG.cjs';
+import { G as GenericForm, F as FormKey, U as UseFormConfiguration, A as AbstractSchema, D as DefaultValuesInput, a as UseFormReturnType } from './shared/attaform.C3WnCDXz.cjs';
+export { b as ArrayItem, c as ArrayPath, d as AttaformDefaults, C as CoercionEntry, e as CoercionRegistry, f as CoercionResult, g as CustomDirectiveRegisterAssignerFn, h as DeepPartial, i as DefaultValuesResponse, j as DefaultValuesShape, k as DisplayCtx, l as DisplayMachine, m as DisplayState, E as ErrorInput, n as ErrorsProxyShape, o as FieldMetaPayload, p as FieldState, q as FieldStateMap, r as FieldStateMapEntry, s as FlatPath, t as FormErrorRecord, u as FormErrorsSurface, v as FormMeta, w as GetDisplayState, H as HandleSubmit, x as HistoryConfig, I as IsTuple, y as IsUnion, J as JoinSegments, z as Json, 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, V as PendingValidationStatus, W as Primitive, X as ROOT_PATH, Y as ROOT_PATH_KEY, Z as ReactiveValidationStatus, _ as RegisterDirective, $ as RegisterFlatPath, a0 as RegisterOptions, a1 as RegisterSelectModifier, a2 as RegisterTextModifier, a3 as RegisterTransform, a4 as RegisterValue, a5 as Segment, a6 as SetValueCallback, a7 as SetValuePayload, a8 as SettledValidationStatus, a9 as SlimPrimitiveKind, aa as SlimRuntimeOf, ab as SubmitHandler, ac as Unset, ad as ValidateOn, ae as ValidateOnConfig, af as ValidationError, ag as ValidationResponse, ah as ValidationResponseWithoutValue, ai as ValueOfUnion, aj as WriteMeta, ak as WriteShape, al as canonicalizePath, am as isPathPrefix, an as isUnset, ao as parseDottedPath, ap as unset } from './shared/attaform.C3WnCDXz.cjs';
+import 'vue';
+
+/**
+ * Schema-agnostic `useForm`. Accepts any object that implements
+ * `AbstractSchema` — useful when integrating a custom schema
+ * adapter or a third-party validation library.
+ *
+ * ```ts
+ * import { useForm } from 'attaform'
+ *
+ * const form = useForm({
+ *   schema: myCustomAdapter,
+ *   defaultValues: { name: '' },
+ * })
+ * ```
+ *
+ * Most consumers prefer a typed entry point that wraps the underlying
+ * library's schema with the matching adapter automatically; see the
+ * subpath documentation for the available adapters.
+ *
+ * Returns the same form API as the typed entry points; see
+ * `UseFormReturnType` for the full surface.
+ */
+declare function useAbstractForm<Form extends GenericForm, GetValueFormType extends GenericForm = Form, ReadForm extends GenericForm = Form, K extends FormKey = FormKey>(configuration: UseFormConfiguration<Form, GetValueFormType, AbstractSchema<Form, GetValueFormType>, DefaultValuesInput<Form>, K>, 
+/**
+ * Internal escape hatch for callers that already hold a registry
+ * reference and need to construct a form outside Vue's setup context
+ * (e.g. the wizard's lazy noop builder, which runs inside a
+ * `computed` re-eval). Passing this skips the strict `useRegistry()`
+ * call; everything else (FormStore allocation, registry presence,
+ * consumer ref-counting via `onScopeDispose`) goes through the same
+ * path eager calls follow. Not part of the public surface.
+ */
+options?: {
+    readonly registry?: AttaformRegistry;
+}): UseFormReturnType<Form, GetValueFormType, ReadForm, K>;
+
+export { AbstractSchema, AttaformRegistry, DefaultValuesInput, FormKey, GenericForm, UseFormConfiguration, UseFormReturnType, useAbstractForm };

package/dist/abstract.d.mts

@@ -0,0 +1,42 @@
+import { A as AttaformRegistry } from './shared/attaform.kBkYlKP_.mjs';
+export { a as AnyForm, b as AttaformDevtoolsBridge, c as AttaformError, d as AttaformErrorCode, e as AttaformPluginOptions, C as CompiledStep, D as DEFAULT_TIMINGS, f as DEVTOOLS_WINDOW_KEY, g as DisplayTimings, F as FormStatus, I as InjectWizardInput, h as InvalidPathError, i as InvalidUseFormConfigError, L as LazyMarker, O as OutsideSetupError, R as RegistryNotInstalledError, j as ReservedFormKeyError, S as SerializedAttaformState, k as SerializedFormData, l as StepSlot, m as SubmitErrorHandlerError, U as UseRegisterReturn, n as UseWizardReturnType, W as WizardAggregateError, o as WizardCtx, p as WizardCtxForm, q as WizardOnError, r as WizardOnSubmit, s as WizardOptions, t as WizardPersistFn, u as WizardRestoreFn, v as WizardRestoreState, w as WizardStatusesProxy, x as WizardSubmitContext, y as assignKey, z as createAttaform, B as createRegistry, E as defaultCoercionRules, G as defaultDisplayState, H as defineCoercion, J as escapeForInlineScript, K as getRegistryFromApp, M as hydrateAttaformState, N as injectForm, P as injectWizard, Q as isRegisterValue, T as kAttaformRegistry, V as lazy, X as makeDefaultDisplayState, Y as renderAttaformState, Z as useRegister, _ as useRegistry, $ as useWizard, a0 as vRegister } from './shared/attaform.kBkYlKP_.mjs';
+import { G as GenericForm, F as FormKey, U as UseFormConfiguration, A as AbstractSchema, D as DefaultValuesInput, a as UseFormReturnType } from './shared/attaform.C3WnCDXz.mjs';
+export { b as ArrayItem, c as ArrayPath, d as AttaformDefaults, C as CoercionEntry, e as CoercionRegistry, f as CoercionResult, g as CustomDirectiveRegisterAssignerFn, h as DeepPartial, i as DefaultValuesResponse, j as DefaultValuesShape, k as DisplayCtx, l as DisplayMachine, m as DisplayState, E as ErrorInput, n as ErrorsProxyShape, o as FieldMetaPayload, p as FieldState, q as FieldStateMap, r as FieldStateMapEntry, s as FlatPath, t as FormErrorRecord, u as FormErrorsSurface, v as FormMeta, w as GetDisplayState, H as HandleSubmit, x as HistoryConfig, I as IsTuple, y as IsUnion, J as JoinSegments, z as Json, 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, V as PendingValidationStatus, W as Primitive, X as ROOT_PATH, Y as ROOT_PATH_KEY, Z as ReactiveValidationStatus, _ as RegisterDirective, $ as RegisterFlatPath, a0 as RegisterOptions, a1 as RegisterSelectModifier, a2 as RegisterTextModifier, a3 as RegisterTransform, a4 as RegisterValue, a5 as Segment, a6 as SetValueCallback, a7 as SetValuePayload, a8 as SettledValidationStatus, a9 as SlimPrimitiveKind, aa as SlimRuntimeOf, ab as SubmitHandler, ac as Unset, ad as ValidateOn, ae as ValidateOnConfig, af as ValidationError, ag as ValidationResponse, ah as ValidationResponseWithoutValue, ai as ValueOfUnion, aj as WriteMeta, ak as WriteShape, al as canonicalizePath, am as isPathPrefix, an as isUnset, ao as parseDottedPath, ap as unset } from './shared/attaform.C3WnCDXz.mjs';
+import 'vue';
+
+/**
+ * Schema-agnostic `useForm`. Accepts any object that implements
+ * `AbstractSchema` — useful when integrating a custom schema
+ * adapter or a third-party validation library.
+ *
+ * ```ts
+ * import { useForm } from 'attaform'
+ *
+ * const form = useForm({
+ *   schema: myCustomAdapter,
+ *   defaultValues: { name: '' },
+ * })
+ * ```
+ *
+ * Most consumers prefer a typed entry point that wraps the underlying
+ * library's schema with the matching adapter automatically; see the
+ * subpath documentation for the available adapters.
+ *
+ * Returns the same form API as the typed entry points; see
+ * `UseFormReturnType` for the full surface.
+ */
+declare function useAbstractForm<Form extends GenericForm, GetValueFormType extends GenericForm = Form, ReadForm extends GenericForm = Form, K extends FormKey = FormKey>(configuration: UseFormConfiguration<Form, GetValueFormType, AbstractSchema<Form, GetValueFormType>, DefaultValuesInput<Form>, K>, 
+/**
+ * Internal escape hatch for callers that already hold a registry
+ * reference and need to construct a form outside Vue's setup context
+ * (e.g. the wizard's lazy noop builder, which runs inside a
+ * `computed` re-eval). Passing this skips the strict `useRegistry()`
+ * call; everything else (FormStore allocation, registry presence,
+ * consumer ref-counting via `onScopeDispose`) goes through the same
+ * path eager calls follow. Not part of the public surface.
+ */
+options?: {
+    readonly registry?: AttaformRegistry;
+}): UseFormReturnType<Form, GetValueFormType, ReadForm, K>;
+
+export { AbstractSchema, AttaformRegistry, DefaultValuesInput, FormKey, GenericForm, UseFormConfiguration, UseFormReturnType, useAbstractForm };

package/dist/abstract.d.ts

@@ -0,0 +1,42 @@
+import { A as AttaformRegistry } from './shared/attaform.CEXUlUkc.js';
+export { a as AnyForm, b as AttaformDevtoolsBridge, c as AttaformError, d as AttaformErrorCode, e as AttaformPluginOptions, C as CompiledStep, D as DEFAULT_TIMINGS, f as DEVTOOLS_WINDOW_KEY, g as DisplayTimings, F as FormStatus, I as InjectWizardInput, h as InvalidPathError, i as InvalidUseFormConfigError, L as LazyMarker, O as OutsideSetupError, R as RegistryNotInstalledError, j as ReservedFormKeyError, S as SerializedAttaformState, k as SerializedFormData, l as StepSlot, m as SubmitErrorHandlerError, U as UseRegisterReturn, n as UseWizardReturnType, W as WizardAggregateError, o as WizardCtx, p as WizardCtxForm, q as WizardOnError, r as WizardOnSubmit, s as WizardOptions, t as WizardPersistFn, u as WizardRestoreFn, v as WizardRestoreState, w as WizardStatusesProxy, x as WizardSubmitContext, y as assignKey, z as createAttaform, B as createRegistry, E as defaultCoercionRules, G as defaultDisplayState, H as defineCoercion, J as escapeForInlineScript, K as getRegistryFromApp, M as hydrateAttaformState, N as injectForm, P as injectWizard, Q as isRegisterValue, T as kAttaformRegistry, V as lazy, X as makeDefaultDisplayState, Y as renderAttaformState, Z as useRegister, _ as useRegistry, $ as useWizard, a0 as vRegister } from './shared/attaform.CEXUlUkc.js';
+import { G as GenericForm, F as FormKey, U as UseFormConfiguration, A as AbstractSchema, D as DefaultValuesInput, a as UseFormReturnType } from './shared/attaform.C3WnCDXz.js';
+export { b as ArrayItem, c as ArrayPath, d as AttaformDefaults, C as CoercionEntry, e as CoercionRegistry, f as CoercionResult, g as CustomDirectiveRegisterAssignerFn, h as DeepPartial, i as DefaultValuesResponse, j as DefaultValuesShape, k as DisplayCtx, l as DisplayMachine, m as DisplayState, E as ErrorInput, n as ErrorsProxyShape, o as FieldMetaPayload, p as FieldState, q as FieldStateMap, r as FieldStateMapEntry, s as FlatPath, t as FormErrorRecord, u as FormErrorsSurface, v as FormMeta, w as GetDisplayState, H as HandleSubmit, x as HistoryConfig, I as IsTuple, y as IsUnion, J as JoinSegments, z as Json, 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, V as PendingValidationStatus, W as Primitive, X as ROOT_PATH, Y as ROOT_PATH_KEY, Z as ReactiveValidationStatus, _ as RegisterDirective, $ as RegisterFlatPath, a0 as RegisterOptions, a1 as RegisterSelectModifier, a2 as RegisterTextModifier, a3 as RegisterTransform, a4 as RegisterValue, a5 as Segment, a6 as SetValueCallback, a7 as SetValuePayload, a8 as SettledValidationStatus, a9 as SlimPrimitiveKind, aa as SlimRuntimeOf, ab as SubmitHandler, ac as Unset, ad as ValidateOn, ae as ValidateOnConfig, af as ValidationError, ag as ValidationResponse, ah as ValidationResponseWithoutValue, ai as ValueOfUnion, aj as WriteMeta, ak as WriteShape, al as canonicalizePath, am as isPathPrefix, an as isUnset, ao as parseDottedPath, ap as unset } from './shared/attaform.C3WnCDXz.js';
+import 'vue';
+
+/**
+ * Schema-agnostic `useForm`. Accepts any object that implements
+ * `AbstractSchema` — useful when integrating a custom schema
+ * adapter or a third-party validation library.
+ *
+ * ```ts
+ * import { useForm } from 'attaform'
+ *
+ * const form = useForm({
+ *   schema: myCustomAdapter,
+ *   defaultValues: { name: '' },
+ * })
+ * ```
+ *
+ * Most consumers prefer a typed entry point that wraps the underlying
+ * library's schema with the matching adapter automatically; see the
+ * subpath documentation for the available adapters.
+ *
+ * Returns the same form API as the typed entry points; see
+ * `UseFormReturnType` for the full surface.
+ */
+declare function useAbstractForm<Form extends GenericForm, GetValueFormType extends GenericForm = Form, ReadForm extends GenericForm = Form, K extends FormKey = FormKey>(configuration: UseFormConfiguration<Form, GetValueFormType, AbstractSchema<Form, GetValueFormType>, DefaultValuesInput<Form>, K>, 
+/**
+ * Internal escape hatch for callers that already hold a registry
+ * reference and need to construct a form outside Vue's setup context
+ * (e.g. the wizard's lazy noop builder, which runs inside a
+ * `computed` re-eval). Passing this skips the strict `useRegistry()`
+ * call; everything else (FormStore allocation, registry presence,
+ * consumer ref-counting via `onScopeDispose`) goes through the same
+ * path eager calls follow. Not part of the public surface.
+ */
+options?: {
+    readonly registry?: AttaformRegistry;
+}): UseFormReturnType<Form, GetValueFormType, ReadForm, K>;
+
+export { AbstractSchema, AttaformRegistry, DefaultValuesInput, FormKey, GenericForm, UseFormConfiguration, UseFormReturnType, useAbstractForm };

package/dist/abstract.mjs

@@ -0,0 +1,4 @@
+export { A as AttaformErrorCode, D as DEFAULT_TIMINGS, d as defaultCoercionRules, a as defaultDisplayState, b as defineCoercion, e as escapeForInlineScript, i as injectForm, c as injectWizard, f as isUnset, l as lazy, m as makeDefaultDisplayState, u as unset, g as useAbstractForm, h as useRegister, j as useWizard } from './shared/attaform.CyQxTOdX.mjs';
+export { A as AttaformError, D as DEVTOOLS_WINDOW_KEY, I as InvalidPathError, a as InvalidUseFormConfigError, O as OutsideSetupError, R as ROOT_PATH, b as ROOT_PATH_KEY, c as RegistryNotInstalledError, d as ReservedFormKeyError, S as SubmitErrorHandlerError, e as assignKey, f as canonicalizePath, g as createAttaform, h as createRegistry, i as getRegistryFromApp, j as hydrateAttaformState, k as isPathPrefix, l as kAttaformRegistry, p as parseDottedPath, r as renderAttaformState, u as useRegistry, v as vRegister } from './shared/attaform.Da8EdI2t.mjs';
+export { i as isRegisterValue } from './shared/attaform.KvlEedlF.mjs';
+//# sourceMappingURL=abstract.mjs.map

package/dist/abstract.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"abstract.mjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;"}

package/dist/chunks/devtools.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-const paths = require('../shared/attaform.BPl-ECRT.cjs');
+const devtoolsShared = require('../shared/attaform.Co5LNRnv.cjs');
 
 const INSPECTOR_ID = "attaform";
 const TIMELINE_LAYER_ID = "attaform:events";
@@ -145,7 +145,7 @@ function wire(api, app, registry) {
     const section = payload.path[0];
     if (section !== "Form value") return;
     const segments = payload.path.slice(2);
-    const { segments: canonicalPath } = paths.canonicalizePath(segments);
+    const { segments: canonicalPath } = devtoolsShared.canonicalizePath(segments);
     state.setValueAtPath(canonicalPath, payload.state.value);
     refreshState();
   });

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 } = canonicalizePath(segments)\n    state.setValueAtPath(canonicalPath, payload.state.value)\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 } = canonicalizePath(segments)\n    state.setValueAtPath(canonicalPath, payload.state.value)\n    refreshState()\n  })\n\n  // Initial sync so existing forms show up.\n  syncForms()\n  refreshTree()\n}\n"],"names":["canonicalizePath"],"mappings":";;;;AA0BA,MAAM,YAAA,GAAe,UAAA;AACrB,MAAM,iBAAA,GAAoB,iBAAA;AA8D1B,eAAsB,qBAAA,CACpB,KACA,QAAA,EACkB;AAClB,EAAA,IAAI,GAAA;AACJ,EAAA,IAAI;AACF,IAAA,GAAA,GAAO,MAAM,OAAO,mBAAmB,CAAA;AAAA,EAGzC,CAAA,CAAA,MAAQ;AAIN,IAAA,OAAO,KAAA;AAAA,EACT;AACA,EAAA,MAAM,sBAAsB,GAAA,CAAI,mBAAA;AAChC,EAAA,IAAI,OAAO,mBAAA,KAAwB,UAAA,EAAY,OAAO,KAAA;AAEtD,EAAA,mBAAA;AAAA,IACE;AAAA,MACE,EAAA,EAAI,YAAA;AAAA,MACJ,KAAA,EAAO,UAAA;AAAA,MACP,WAAA,EAAa,UAAA;AAAA,MACb,QAAA,EAAU,sCAAA;AAAA,MACV,GAAA;AAAA,MACA,mBAAA,EAAqB,CAAC,eAAe;AAAA,KACvC;AAAA,IACA,CAAC,GAAA,KAAQ,IAAA,CAAK,GAAA,EAAK,KAAK,QAAQ;AAAA,GAClC;AACA,EAAA,OAAO,IAAA;AACT;AAEA,SAAS,IAAA,CAAK,GAAA,EAAwB,GAAA,EAAU,QAAA,EAAkC;AAIhF,EAAA,MAAM,gBAAA,uBAAuB,GAAA,EAAyB;AAEtD,EAAA,GAAA,CAAI,aAAa,EAAE,EAAA,EAAI,cAAc,KAAA,EAAO,UAAA,EAAY,KAAK,CAAA;AAC7D,EAAA,GAAA,CAAI,gBAAA,CAAiB,EAAE,EAAA,EAAI,iBAAA,EAAmB,OAAO,UAAA,EAAY,KAAA,EAAO,SAAU,CAAA;AAElF,EAAA,SAAS,WAAA,GAAoB;AAC3B,IAAA,GAAA,CAAI,kBAAkB,YAAY,CAAA;AAAA,EACpC;AAEA,EAAA,SAAS,YAAA,GAAqB;AAC5B,IAAA,GAAA,CAAI,mBAAmB,YAAY,CAAA;AAAA,EACrC;AAEA,EAAA,SAAS,cAAc,KAAA,EAAqC;AAC1D,IAAA,IAAI,gBAAA,CAAiB,GAAA,CAAI,KAAA,CAAM,OAAO,CAAA,EAAG;AACzC,IAAA,MAAM,WAAA,GAAc,KAAA,CAAM,YAAA,CAAa,MAAM;AAC3C,MAAA,YAAA,EAAa;AACb,MAAA,GAAA,CAAI,gBAAA,CAAiB;AAAA,QACnB,OAAA,EAAS,iBAAA;AAAA,QACT,KAAA,EAAO;AAAA,UACL,IAAA,EAAM,KAAK,GAAA,EAAI;AAAA,UACf,KAAA,EAAO,aAAA;AAAA,UACP,UAAU,KAAA,CAAM,OAAA;AAAA;AAAA;AAAA;AAAA;AAAA,UAKhB,IAAA,EAAM,EAAE,IAAA,EAAM,KAAA,CAAM,KAAK,KAAA;AAAiC;AAC5D,OACD,CAAA;AAAA,IACH,CAAC,CAAA;AACD,IAAA,MAAM,WAAA,GAAc,KAAA,CAAM,eAAA,CAAgB,MAAM;AAC9C,MAAA,GAAA,CAAI,gBAAA,CAAiB;AAAA,QACnB,OAAA,EAAS,iBAAA;AAAA,QACT,KAAA,EAAO;AAAA,UACL,IAAA,EAAM,KAAK,GAAA,EAAI;AAAA,UACf,KAAA,EAAO,gBAAA;AAAA,UACP,UAAU,KAAA,CAAM,OAAA;AAAA,UAChB,IAAA,EAAM,EAAE,IAAA,EAAM,KAAA,CAAM,KAAK,KAAA;AAAiC;AAC5D,OACD,CAAA;AAAA,IACH,CAAC,CAAA;AACD,IAAA,MAAM,UAAA,GAAa,KAAA,CAAM,OAAA,CAAQ,MAAM;AACrC,MAAA,YAAA,EAAa;AACb,MAAA,GAAA,CAAI,gBAAA,CAAiB;AAAA,QACnB,OAAA,EAAS,iBAAA;AAAA,QACT,KAAA,EAAO;AAAA,UACL,IAAA,EAAM,KAAK,GAAA,EAAI;AAAA,UACf,KAAA,EAAO,OAAA;AAAA,UACP,UAAU,KAAA,CAAM;AAAA;AAClB,OACD,CAAA;AAAA,IACH,CAAC,CAAA;AACD,IAAA,gBAAA,CAAiB,GAAA,CAAI,KAAA,CAAM,OAAA,EAAS,MAAM;AACxC,MAAA,WAAA,EAAY;AACZ,MAAA,WAAA,EAAY;AACZ,MAAA,UAAA,EAAW;AAAA,IACb,CAAC,CAAA;AAAA,EACH;AAQA,EAAA,SAAS,SAAA,GAAkB;AACzB,IAAA,KAAA,MAAW,GAAG,KAAK,CAAA,IAAK,SAAS,KAAA,EAAO;AACtC,MAAA,aAAA,CAAc,KAAK,CAAA;AAAA,IACrB;AAEA,IAAA,KAAA,MAAW,CAAC,OAAA,EAAS,KAAK,CAAA,IAAK,gBAAA,EAAkB;AAC/C,MAAA,IAAI,CAAC,QAAA,CAAS,KAAA,CAAM,GAAA,CAAI,OAAO,CAAA,EAAG;AAChC,QAAA,KAAA,EAAM;AACN,QAAA,gBAAA,CAAiB,OAAO,OAAO,CAAA;AAAA,MACjC;AAAA,IACF;AAAA,EACF;AAEA,EAAA,GAAA,CAAI,EAAA,CAAG,gBAAA,CAAiB,CAAC,OAAA,KAAY;AACnC,IAAA,IAAI,OAAA,CAAQ,gBAAgB,YAAA,EAAc;AAC1C,IAAA,SAAA,EAAU;AACV,IAAA,OAAA,CAAQ,SAAA,GAAY,CAAC,GAAG,QAAA,CAAS,KAAA,CAAM,MAAM,CAAA,CAAE,GAAA,CAAI,CAAC,GAAA,MAAS;AAAA,MAC3D,EAAA,EAAI,QAAQ,GAAG,CAAA,CAAA;AAAA,MACf,KAAA,EAAO,GAAA;AAAA,MACP,MAAM;AAAC,KACT,CAAE,CAAA;AAAA,EACJ,CAAC,CAAA;AAED,EAAA,GAAA,CAAI,EAAA,CAAG,iBAAA,CAAkB,CAAC,OAAA,KAAY;AACpC,IAAA,IAAI,OAAA,CAAQ,gBAAgB,YAAA,EAAc;AAC1C,IAAA,IAAI,CAAC,OAAA,CAAQ,MAAA,CAAO,UAAA,CAAW,OAAO,CAAA,EAAG;AACzC,IAAA,MAAM,OAAA,GAAU,OAAA,CAAQ,MAAA,CAAO,KAAA,CAAM,QAAQ,MAAM,CAAA;AACnD,IAAA,MAAM,KAAA,GAAQ,QAAA,CAAS,KAAA,CAAM,GAAA,CAAI,OAAO,CAAA;AACxC,IAAA,IAAI,UAAU,MAAA,EAAW;AAIzB,IAAA,OAAA,CAAQ,KAAA,CAAM,YAAY,CAAA,GAAI;AAAA,MAC5B;AAAA,QACE,GAAA,EAAK,MAAA;AAAA,QACL,KAAA,EAAO,MAAM,IAAA,CAAK,KAAA;AAAA,QAClB,QAAA,EAAU;AAAA;AACZ,KACF;AAMA,IAAA,OAAA,CAAQ,KAAA,CAAM,eAAe,CAAA,GAAI;AAAA,MAC/B,GAAG,CAAC,GAAG,KAAA,CAAM,YAAA,CAAa,OAAA,EAAS,CAAA,CAAE,GAAA,CAAI,CAAC,CAAC,CAAA,EAAG,CAAC,CAAA,MAAO;AAAA,QACpD,GAAA,EAAK,OAAO,CAAC,CAAA;AAAA,QACb,KAAA,EAAO;AAAA,OACT,CAAE;AAAA,KACJ;AACA,IAAA,OAAA,CAAQ,KAAA,CAAM,aAAa,CAAA,GAAI;AAAA,MAC7B,GAAG,CAAC,GAAG,KAAA,CAAM,UAAA,CAAW,OAAA,EAAS,CAAA,CAAE,GAAA,CAAI,CAAC,CAAC,CAAA,EAAG,CAAC,CAAA,MAAO;AAAA,QAClD,GAAA,EAAK,OAAO,CAAC,CAAA;AAAA,QACb,KAAA,EAAO;AAAA,OACT,CAAE;AAAA,KACJ;AACA,IAAA,OAAA,CAAQ,KAAA,CAAM,YAAY,CAAA,GAAI;AAAA,MAC5B,EAAE,GAAA,EAAK,YAAA,EAAc,KAAA,EAAO,KAAA,CAAM,WAAW,KAAA,EAAM;AAAA,MACnD,EAAE,GAAA,EAAK,oBAAA,EAAsB,KAAA,EAAO,KAAA,CAAM,mBAAmB,KAAA,EAAM;AAAA,MACnE,EAAE,GAAA,EAAK,gBAAA,EAAkB,KAAA,EAAO,KAAA,CAAM,eAAe,KAAA,EAAM;AAAA,MAC3D,EAAE,GAAA,EAAK,aAAA,EAAe,KAAA,EAAO,KAAA,CAAM,YAAY,KAAA,EAAM;AAAA,MACrD,EAAE,GAAA,EAAK,mBAAA,EAAqB,KAAA,EAAO,KAAA,CAAM,kBAAkB,KAAA;AAAM,KACnE;AAAA,EACF,CAAC,CAAA;AAED,EAAA,GAAA,CAAI,EAAA,CAAG,kBAAA,CAAmB,CAAC,OAAA,KAAY;AACrC,IAAA,IAAI,OAAA,CAAQ,gBAAgB,YAAA,EAAc;AAC1C,IAAA,IAAI,CAAC,OAAA,CAAQ,MAAA,CAAO,UAAA,CAAW,OAAO,CAAA,EAAG;AACzC,IAAA,MAAM,OAAA,GAAU,OAAA,CAAQ,MAAA,CAAO,KAAA,CAAM,QAAQ,MAAM,CAAA;AACnD,IAAA,MAAM,KAAA,GAAQ,QAAA,CAAS,KAAA,CAAM,GAAA,CAAI,OAAO,CAAA;AACxC,IAAA,IAAI,UAAU,MAAA,EAAW;AAOzB,IAAA,IAAI,OAAA,CAAQ,IAAA,CAAK,MAAA,GAAS,CAAA,EAAG;AAC7B,IAAA,MAAM,OAAA,GAAU,OAAA,CAAQ,IAAA,CAAK,CAAC,CAAA;AAC9B,IAAA,IAAI,YAAY,YAAA,EAAc;AAC9B,IAAA,MAAM,QAAA,GAAW,OAAA,CAAQ,IAAA,CAAK,KAAA,CAAM,CAAC,CAAA;AACrC,IAAA,MAAM,EAAE,QAAA,EAAU,aAAA,EAAc,GAAIA,gCAAiB,QAAQ,CAAA;AAC7D,IAAA,KAAA,CAAM,cAAA,CAAe,aAAA,EAAe,OAAA,CAAQ,KAAA,CAAM,KAAK,CAAA;AACvD,IAAA,YAAA,EAAa;AAAA,EACf,CAAC,CAAA;AAGD,EAAA,SAAA,EAAU;AACV,EAAA,WAAA,EAAY;AACd;;;;"}

package/dist/chunks/devtools.mjs

@@ -1,4 +1,4 @@
-import { f as canonicalizePath } from '../shared/attaform.DGhIix5D.mjs';
+import { f as canonicalizePath } from '../shared/attaform.Da8EdI2t.mjs';
 
 const INSPECTOR_ID = "attaform";
 const TIMELINE_LAYER_ID = "attaform:events";

package/dist/chunks/fingerprint2.cjs

@@ -1,7 +1,7 @@
 'use strict';
 
 const canonicalStringify = require('../shared/attaform.CQN9R62B.cjs');
-const index = require('../shared/attaform.tZ0YKisf.cjs');
+const index = require('../shared/attaform.C__F01CE.cjs');
 
 const cyclicSentinel = "<cyclic>";
 function fingerprintZodSchema(schema) {

package/dist/chunks/fingerprint2.mjs

@@ -1,5 +1,5 @@
 import { c as canonicalStringify } from '../shared/attaform.BJGA_UOS.mjs';
-import { k as kindOf, g as getIntersectionLeft, b as getIntersectionRight, c as unwrapLazy, d as unwrapInner, e as unwrapPipe, h as getDiscriminator, i as getDiscriminatedOptions, j as getUnionOptions, l as getRecordKeyType, m as getRecordValueType, n as getTupleItems, o as getSetValueType, p as getArrayElement, q as getObjectShape, r as getEnumValues, s as getLiteralValues, t as getChecks, v as getCatchDefault, x as getDefaultValue } from '../shared/attaform.DSOIz08n.mjs';
+import { k as kindOf, g as getIntersectionLeft, b as getIntersectionRight, c as unwrapLazy, d as unwrapInner, e as unwrapPipe, h as getDiscriminator, i as getDiscriminatedOptions, j as getUnionOptions, l as getRecordKeyType, m as getRecordValueType, n as getTupleItems, o as getSetValueType, p as getArrayElement, q as getObjectShape, r as getEnumValues, s as getLiteralValues, t as getChecks, v as getCatchDefault, x as getDefaultValue } from '../shared/attaform.BceJrhQ7.mjs';
 
 const cyclicSentinel = "<cyclic>";
 function fingerprintZodSchema(schema) {

package/dist/esbuild.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-const detectZodMajor = require('./shared/attaform.LEWUFqUw.cjs');
+const detectZodMajor = require('./shared/attaform.DoQm_Vkd.cjs');
 
 function attaform(options = {}) {
   const resolveZodAlias = options.resolveZodAlias !== false;
@@ -11,7 +11,7 @@ function attaform(options = {}) {
       const root = build.initialOptions.absWorkingDir ?? options.root ?? process.cwd();
       const target = detectZodMajor.resolveZodAliasTarget(root, "attaform/esbuild", resolveZodAlias, warnState);
       if (target === null) return;
-      build.onResolve({ filter: /^attaform\/zod$/ }, async (args) => {
+      build.onResolve({ filter: detectZodMajor.REWRITABLE_ZOD_SPECIFIER_FILTER }, async (args) => {
         const result = await build.resolve(target, {
           kind: args.kind,
           importer: args.importer,

package/dist/esbuild.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"esbuild.cjs","sources":["../src/esbuild.ts"],"sourcesContent":["/**\n * `attaform/esbuild` — esbuild plugin that rewrites `attaform/zod`\n * imports to the single matching adapter subpath (`attaform/zod-v3` or\n * `attaform/zod-v4`) at build time, based on the consumer's installed Zod\n * major. Without it, esbuild ships both adapters because the unified\n * `attaform/zod` entry imports both for runtime dispatch.\n *\n * Usage:\n *\n *   // build.mjs\n *   import { build } from 'esbuild'\n *   import { attaform } from 'attaform/esbuild'\n *\n *   await build({\n *     entryPoints: ['src/main.ts'],\n *     bundle: true,\n *     plugins: [attaform()],\n *   })\n *\n * This plugin only does the adapter rewrite. The Vue SFC `v-register`\n * transforms that `attaform/vite` wires (load-bearing for SSR initial\n * render) are `@vitejs/plugin-vue`-specific and do not transfer; a\n * non-Vite consumer that needs them wires `attaform/transforms` into\n * their Vue compiler separately.\n *\n * Zero-dep: the plugin imports nothing from `esbuild` (the bundler injects\n * its plugin API at the consumer's build); the structural types below are\n * all it needs to compile.\n */\nimport { resolveZodAliasTarget } from './core/detect-zod-major'\n\n/** Options for the esbuild `attaform()` plugin. */\nexport interface AttaformEsbuildPluginOptions {\n  /**\n   * Rewrite `attaform/zod` imports at build time to the matching adapter\n   * subpath. Default `true`. Set to `false` to keep the runtime-dispatch\n   * unified entry (ships both adapters).\n   */\n  resolveZodAlias?: boolean\n  /**\n   * Project root to resolve the installed Zod from. Defaults to the\n   * build's `absWorkingDir`, falling back to `process.cwd()`. Set this\n   * when the build runs from a directory other than the project that owns\n   * the Zod dependency.\n   */\n  root?: string\n}\n\ninterface EsbuildOnResolveArgs {\n  path: string\n  importer: string\n  resolveDir: string\n  kind: string\n}\ninterface EsbuildResolveResult {\n  path: string\n  external: boolean\n  namespace: string\n  errors: unknown[]\n}\ninterface EsbuildOnResolveResult {\n  path?: string\n  external?: boolean\n  namespace?: string\n  errors?: unknown[]\n}\ninterface EsbuildPluginBuild {\n  initialOptions: { absWorkingDir?: string }\n  onResolve(\n    options: { filter: RegExp },\n    callback: (args: EsbuildOnResolveArgs) => Promise<EsbuildOnResolveResult>\n  ): void\n  resolve(\n    path: string,\n    options: { kind: string; importer?: string; resolveDir?: string }\n  ): Promise<EsbuildResolveResult>\n}\n\n/** The structural shape esbuild requires of the plugin. */\nexport interface AttaformEsbuildPlugin {\n  name: string\n  setup(build: EsbuildPluginBuild): void\n}\n\nexport function attaform(options: AttaformEsbuildPluginOptions = {}): AttaformEsbuildPlugin {\n  const resolveZodAlias = options.resolveZodAlias !== false\n  const warnState = { warned: false }\n  return {\n    name: 'attaform',\n    setup(build) {\n      const root = build.initialOptions.absWorkingDir ?? options.root ?? process.cwd()\n      const target = resolveZodAliasTarget(root, 'attaform/esbuild', resolveZodAlias, warnState)\n      // Nothing to rewrite (opt-out, or unclassifiable version): leave the\n      // unified entry in place and register no hook.\n      if (target === null) return\n      build.onResolve({ filter: /^attaform\\/zod$/ }, async (args) => {\n        // Re-resolve the rewritten specifier so esbuild returns a real\n        // path. The filter is anchored to the bare unified specifier, so\n        // resolving `attaform/zod-v4` does not re-enter this callback.\n        const result = await build.resolve(target, {\n          kind: args.kind,\n          importer: args.importer,\n          resolveDir: args.resolveDir,\n        })\n        if (result.errors.length > 0) return { errors: result.errors }\n        return { path: result.path, external: result.external, namespace: result.namespace }\n      })\n    },\n  }\n}\n"],"names":["resolveZodAliasTarget"],"mappings":";;;;AAoFO,SAAS,QAAA,CAAS,OAAA,GAAwC,EAAC,EAA0B;AAC1F,EAAA,MAAM,eAAA,GAAkB,QAAQ,eAAA,KAAoB,KAAA;AACpD,EAAA,MAAM,SAAA,GAAY,EAAE,MAAA,EAAQ,KAAA,EAAM;AAClC,EAAA,OAAO;AAAA,IACL,IAAA,EAAM,UAAA;AAAA,IACN,MAAM,KAAA,EAAO;AACX,MAAA,MAAM,OAAO,KAAA,CAAM,cAAA,CAAe,iBAAiB,OAAA,CAAQ,IAAA,IAAQ,QAAQ,GAAA,EAAI;AAC/E,MAAA,MAAM,MAAA,GAASA,oCAAA,CAAsB,IAAA,EAAM,kBAAA,EAAoB,iBAAiB,SAAS,CAAA;AAGzF,MAAA,IAAI,WAAW,IAAA,EAAM;AACrB,MAAA,KAAA,CAAM,UAAU,EAAE,MAAA,EAAQ,iBAAA,EAAkB,EAAG,OAAO,IAAA,KAAS;AAI7D,QAAA,MAAM,MAAA,GAAS,MAAM,KAAA,CAAM,OAAA,CAAQ,MAAA,EAAQ;AAAA,UACzC,MAAM,IAAA,CAAK,IAAA;AAAA,UACX,UAAU,IAAA,CAAK,QAAA;AAAA,UACf,YAAY,IAAA,CAAK;AAAA,SAClB,CAAA;AACD,QAAA,IAAI,MAAA,CAAO,OAAO,MAAA,GAAS,CAAA,SAAU,EAAE,MAAA,EAAQ,OAAO,MAAA,EAAO;AAC7D,QAAA,OAAO,EAAE,MAAM,MAAA,CAAO,IAAA,EAAM,UAAU,MAAA,CAAO,QAAA,EAAU,SAAA,EAAW,MAAA,CAAO,SAAA,EAAU;AAAA,MACrF,CAAC,CAAA;AAAA,IACH;AAAA,GACF;AACF;;;;"}
+{"version":3,"file":"esbuild.cjs","sources":["../src/esbuild.ts"],"sourcesContent":["/**\n * `attaform/esbuild` — esbuild plugin that rewrites `attaform` and\n * `attaform/zod` imports to the single matching adapter subpath\n * (`attaform/zod-v3` or `attaform/zod-v4`) at build time, based on the\n * consumer's installed Zod major. Without it, esbuild ships both adapters\n * because those entries import both for runtime dispatch.\n *\n * Usage:\n *\n *   // build.mjs\n *   import { build } from 'esbuild'\n *   import { attaform } from 'attaform/esbuild'\n *\n *   await build({\n *     entryPoints: ['src/main.ts'],\n *     bundle: true,\n *     plugins: [attaform()],\n *   })\n *\n * This plugin only does the adapter rewrite. The Vue SFC `v-register`\n * transforms that `attaform/vite` wires (load-bearing for SSR initial\n * render) are `@vitejs/plugin-vue`-specific and do not transfer; a\n * non-Vite consumer that needs them wires `attaform/transforms` into\n * their Vue compiler separately.\n *\n * Zero-dep: the plugin imports nothing from `esbuild` (the bundler injects\n * its plugin API at the consumer's build); the structural types below are\n * all it needs to compile.\n */\nimport { resolveZodAliasTarget, REWRITABLE_ZOD_SPECIFIER_FILTER } from './core/detect-zod-major'\n\n/** Options for the esbuild `attaform()` plugin. */\nexport interface AttaformEsbuildPluginOptions {\n  /**\n   * Rewrite `attaform` and `attaform/zod` imports at build time to the\n   * matching adapter subpath. Default `true`. Set to `false` to keep the\n   * runtime-dispatch unified entry (ships both adapters).\n   */\n  resolveZodAlias?: boolean\n  /**\n   * Project root to resolve the installed Zod from. Defaults to the\n   * build's `absWorkingDir`, falling back to `process.cwd()`. Set this\n   * when the build runs from a directory other than the project that owns\n   * the Zod dependency.\n   */\n  root?: string\n}\n\ninterface EsbuildOnResolveArgs {\n  path: string\n  importer: string\n  resolveDir: string\n  kind: string\n}\ninterface EsbuildResolveResult {\n  path: string\n  external: boolean\n  namespace: string\n  errors: unknown[]\n}\ninterface EsbuildOnResolveResult {\n  path?: string\n  external?: boolean\n  namespace?: string\n  errors?: unknown[]\n}\ninterface EsbuildPluginBuild {\n  initialOptions: { absWorkingDir?: string }\n  onResolve(\n    options: { filter: RegExp },\n    callback: (args: EsbuildOnResolveArgs) => Promise<EsbuildOnResolveResult>\n  ): void\n  resolve(\n    path: string,\n    options: { kind: string; importer?: string; resolveDir?: string }\n  ): Promise<EsbuildResolveResult>\n}\n\n/** The structural shape esbuild requires of the plugin. */\nexport interface AttaformEsbuildPlugin {\n  name: string\n  setup(build: EsbuildPluginBuild): void\n}\n\nexport function attaform(options: AttaformEsbuildPluginOptions = {}): AttaformEsbuildPlugin {\n  const resolveZodAlias = options.resolveZodAlias !== false\n  const warnState = { warned: false }\n  return {\n    name: 'attaform',\n    setup(build) {\n      const root = build.initialOptions.absWorkingDir ?? options.root ?? process.cwd()\n      const target = resolveZodAliasTarget(root, 'attaform/esbuild', resolveZodAlias, warnState)\n      // Nothing to rewrite (opt-out, or unclassifiable version): leave the\n      // unified entry in place and register no hook.\n      if (target === null) return\n      build.onResolve({ filter: REWRITABLE_ZOD_SPECIFIER_FILTER }, async (args) => {\n        // Re-resolve the rewritten specifier so esbuild returns a real\n        // path. Both matched specifiers (bare `attaform` and\n        // `attaform/zod`) rewrite to the same detected adapter; the filter\n        // is anchored so resolving `attaform/zod-v4` does not re-enter\n        // this callback.\n        const result = await build.resolve(target, {\n          kind: args.kind,\n          importer: args.importer,\n          resolveDir: args.resolveDir,\n        })\n        if (result.errors.length > 0) return { errors: result.errors }\n        return { path: result.path, external: result.external, namespace: result.namespace }\n      })\n    },\n  }\n}\n"],"names":["resolveZodAliasTarget","REWRITABLE_ZOD_SPECIFIER_FILTER"],"mappings":";;;;AAoFO,SAAS,QAAA,CAAS,OAAA,GAAwC,EAAC,EAA0B;AAC1F,EAAA,MAAM,eAAA,GAAkB,QAAQ,eAAA,KAAoB,KAAA;AACpD,EAAA,MAAM,SAAA,GAAY,EAAE,MAAA,EAAQ,KAAA,EAAM;AAClC,EAAA,OAAO;AAAA,IACL,IAAA,EAAM,UAAA;AAAA,IACN,MAAM,KAAA,EAAO;AACX,MAAA,MAAM,OAAO,KAAA,CAAM,cAAA,CAAe,iBAAiB,OAAA,CAAQ,IAAA,IAAQ,QAAQ,GAAA,EAAI;AAC/E,MAAA,MAAM,MAAA,GAASA,oCAAA,CAAsB,IAAA,EAAM,kBAAA,EAAoB,iBAAiB,SAAS,CAAA;AAGzF,MAAA,IAAI,WAAW,IAAA,EAAM;AACrB,MAAA,KAAA,CAAM,UAAU,EAAE,MAAA,EAAQC,8CAAA,EAAgC,EAAG,OAAO,IAAA,KAAS;AAM3E,QAAA,MAAM,MAAA,GAAS,MAAM,KAAA,CAAM,OAAA,CAAQ,MAAA,EAAQ;AAAA,UACzC,MAAM,IAAA,CAAK,IAAA;AAAA,UACX,UAAU,IAAA,CAAK,QAAA;AAAA,UACf,YAAY,IAAA,CAAK;AAAA,SAClB,CAAA;AACD,QAAA,IAAI,MAAA,CAAO,OAAO,MAAA,GAAS,CAAA,SAAU,EAAE,MAAA,EAAQ,OAAO,MAAA,EAAO;AAC7D,QAAA,OAAO,EAAE,MAAM,MAAA,CAAO,IAAA,EAAM,UAAU,MAAA,CAAO,QAAA,EAAU,SAAA,EAAW,MAAA,CAAO,SAAA,EAAU;AAAA,MACrF,CAAC,CAAA;AAAA,IACH;AAAA,GACF;AACF;;;;"}

package/dist/esbuild.d.cts

@@ -1,9 +1,9 @@
 /** Options for the esbuild `attaform()` plugin. */
 interface AttaformEsbuildPluginOptions {
     /**
-     * Rewrite `attaform/zod` imports at build time to the matching adapter
-     * subpath. Default `true`. Set to `false` to keep the runtime-dispatch
-     * unified entry (ships both adapters).
+     * Rewrite `attaform` and `attaform/zod` imports at build time to the
+     * matching adapter subpath. Default `true`. Set to `false` to keep the
+     * runtime-dispatch unified entry (ships both adapters).
      */
     resolveZodAlias?: boolean;
     /**

package/dist/esbuild.d.mts

@@ -1,9 +1,9 @@
 /** Options for the esbuild `attaform()` plugin. */
 interface AttaformEsbuildPluginOptions {
     /**
-     * Rewrite `attaform/zod` imports at build time to the matching adapter
-     * subpath. Default `true`. Set to `false` to keep the runtime-dispatch
-     * unified entry (ships both adapters).
+     * Rewrite `attaform` and `attaform/zod` imports at build time to the
+     * matching adapter subpath. Default `true`. Set to `false` to keep the
+     * runtime-dispatch unified entry (ships both adapters).
      */
     resolveZodAlias?: boolean;
     /**

package/dist/esbuild.d.ts

@@ -1,9 +1,9 @@
 /** Options for the esbuild `attaform()` plugin. */
 interface AttaformEsbuildPluginOptions {
     /**
-     * Rewrite `attaform/zod` imports at build time to the matching adapter
-     * subpath. Default `true`. Set to `false` to keep the runtime-dispatch
-     * unified entry (ships both adapters).
+     * Rewrite `attaform` and `attaform/zod` imports at build time to the
+     * matching adapter subpath. Default `true`. Set to `false` to keep the
+     * runtime-dispatch unified entry (ships both adapters).
      */
     resolveZodAlias?: boolean;
     /**

package/dist/esbuild.mjs

@@ -1,4 +1,4 @@
-import { r as resolveZodAliasTarget } from './shared/attaform.sHkHv_98.mjs';
+import { r as resolveZodAliasTarget, R as REWRITABLE_ZOD_SPECIFIER_FILTER } from './shared/attaform.DhnPb6nK.mjs';
 
 function attaform(options = {}) {
   const resolveZodAlias = options.resolveZodAlias !== false;
@@ -9,7 +9,7 @@ function attaform(options = {}) {
       const root = build.initialOptions.absWorkingDir ?? options.root ?? process.cwd();
       const target = resolveZodAliasTarget(root, "attaform/esbuild", resolveZodAlias, warnState);
       if (target === null) return;
-      build.onResolve({ filter: /^attaform\/zod$/ }, async (args) => {
+      build.onResolve({ filter: REWRITABLE_ZOD_SPECIFIER_FILTER }, async (args) => {
         const result = await build.resolve(target, {
           kind: args.kind,
           importer: args.importer,