attaform 0.27.6 → 0.28.0

package/dist/index.d.ts

@@ -1,249 +0,0 @@
-export { a as AnyForm, b as AttaformDevtoolsBridge, c as AttaformError, d as AttaformErrorCode, e as AttaformPluginOptions, A as AttaformRegistry, C as CompiledStep, D as DEFAULT_TIMINGS, f as DEVTOOLS_WINDOW_KEY, g as DisplayTimings, F as FormStatus, h as FormStatusSeed, G as GateMarker, I as InjectWizardInput, i as InvalidPathError, j as InvalidUseFormConfigError, L as LazyMarker, O as OutsideSetupError, R as RegistryNotInstalledError, k as ReservedFormKeyError, S as SerializedAttaformState, l as SerializedFormData, m as StepSlot, n as SubmitErrorHandlerError, U as UseRegisterReturn, o as UseWizardReturnType, W as WizardAggregateError, p as WizardCtx, q as WizardCtxForm, r as WizardOnError, s as WizardOnSubmit, t as WizardOptions, u as WizardPersistFn, v as WizardRestoreFn, w as WizardRestoreState, x as WizardStatusesProxy, y as WizardSubmitContext, z as assignKey, B as createAttaform, E as createRegistry, H as defaultCoercionRules, J as defaultDisplayState, K as defineCoercion, M as escapeForInlineScript, N as gate, P as getRegistryFromApp, Q as hydrateAttaformState, T as injectForm, V as injectWizard, X as isRegisterValue, Y as kAttaformRegistry, Z as lazy, _ as makeDefaultDisplayState, $ as renderAttaformState, a0 as useRegister, a1 as useRegistry, a2 as useWizard, a3 as vRegister } from './shared/attaform.F2Q8iv38.js';
-import { G as GenericForm, F as FormKey, U as UseFormConfiguration, A as AbstractSchema, aq as AcceptableDefaults, ae as ValidateOnConfig, a as UseFormReturnType, D as DefaultValuesInput, o as FieldMetaPayload } from './shared/attaform.DniawQLP.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, 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, 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.DniawQLP.js';
-import { S as SupportedRootSchema, b as StorageShape } from './shared/attaform.Fp3sCrVs.js';
-export { P as PathInput, a as PathOutput } from './shared/attaform.Fp3sCrVs.js';
-import { S as SupportedRootSchema$1, U as UnwrapZodRoot, a as StorageShape$1 } from './shared/attaform.DRUT703x.js';
-import { z } from 'zod';
-import 'vue';
-
-/**
- * Type-level Zod-major discriminator for the unified `attaform/zod`
- * entry. The runtime dispatch (`use-form.ts`'s impl) already routes on
- * the schema's shape via `isZodV4SchemaShape`; this is the type-level
- * mirror so the overloads and projection helpers discriminate the same
- * way.
- *
- * Why a structural marker instead of `z.ZodObject`: the unified entry's
- * overloads constrain on `z.ZodObject`, but the published `.d.mts`
- * resolves `z` against whichever single Zod major the consumer
- * installed. In a v3-only install `z.ZodObject` is v3's `ZodObject`
- * (and, lacking its required type arguments, degrades to an `any`-like
- * error type under `skipLibCheck`), so a v3 schema satisfies the v4
- * overload's constraint and binds it — collapsing the read slot to
- * `never`. A Zod v4 schema carries the `_zod` internals brand; a v3
- * schema never does.
- * Intersecting a v4-only constraint or conditional branch with this
- * marker keeps it unreachable for a v3 schema regardless of how `zod`
- * resolves, so v3 schemas fall through to the v3 overload.
- *
- * Distinct from `core/zod-shape.ts`'s runtime `ZodV4Shape` (which reads
- * the public `def` getter): at the type level the stable v4 brand is
- * `_zod.def`, the same internals `StorageShape` (v4) already reads.
- *
- * Pairing requirement: a v4 overload/branch must constrain on
- * `z.ZodObject<z.ZodRawShape> & ZodV4Internals`, NOT bare
- * `z.ZodObject & ZodV4Internals`. In a v3-only install `z.ZodObject`
- * with no type argument is `ZodObject<T, ...>` missing its required
- * arguments — an error type that behaves like `any` under
- * `skipLibCheck`, so `any & ZodV4Internals` collapses back to `any` and
- * the marker stops excluding v3 schemas. Supplying `z.ZodRawShape`
- * keeps it a concrete object type in both majors, so the intersection
- * stays meaningful.
- */
-type ZodV4Internals = {
-    _zod: {
-        def: unknown;
-    };
-};
-
-/**
- * Per-major projection helpers shared by the unified `attaform/zod`
- * entry. Each maps an arbitrary Zod v4 OR v3 object schema to the
- * `GenericForm`-shaped input / output / storage-read projections the
- * form types are parameterised over. The constraint on each alias scopes
- * `S` to one Zod major, so the projection is a direct read with no
- * dispatch in the type body.
- *
- * Hoisted out of `types-unified.ts` and `use-form.ts` so the two entry
- * points share one definition. Internal — consumer code never reaches
- * for these; the overloaded `useForm` already gives full inference at
- * call sites.
- */
-
-/**
- * The schema's own input type, exactly as a consumer would reference it
- * (`z.input<S>`) — NOT routed through `GenericForm` / `UnwrapZodRoot`. This
- * is the reflexive escape arm `AcceptableDefaults` adds to the
- * `defaultValues` slot so a generic form wrapper forwarding `z.input<S>`
- * type-checks under a free `S` (#422). It must stay syntactically identical
- * to what the wrapper forwards: wrapping it in a conditional makes it a
- * deferred conditional that no longer matches the forwarded value under a
- * generic. Wrong-major schemas can't actually bind the slot — they are
- * rejected at the overload's `schema` constraint — so the raw input never
- * widens the slot for the wrong major.
- */
-type V4SchemaInput<S extends SupportedRootSchema> = z.input<S>;
-type V3SchemaInput<S extends SupportedRootSchema$1> = z.input<S>;
-type V4FormOf<S extends SupportedRootSchema> = z.input<S> extends GenericForm ? z.input<S> : never;
-type V4OutOf<S extends SupportedRootSchema> = z.output<S> extends GenericForm ? z.output<S> : never;
-type V4ReadOf<S extends SupportedRootSchema> = StorageShape<S> extends GenericForm ? StorageShape<S> : never;
-type V3FormOf<S extends SupportedRootSchema$1> = z.input<UnwrapZodRoot<S>> extends GenericForm ? z.input<UnwrapZodRoot<S>> : never;
-type V3OutOf<S extends SupportedRootSchema$1> = z.output<UnwrapZodRoot<S>> extends GenericForm ? z.output<UnwrapZodRoot<S>> : never;
-type V3ReadOf<S extends SupportedRootSchema$1> = StorageShape$1<UnwrapZodRoot<S>> extends GenericForm ? StorageShape$1<UnwrapZodRoot<S>> : never;
-
-/**
- * Create a form bound to a Zod v4 schema.
- *
- * ```ts
- * import { useForm } from 'attaform/zod'
- * import { z } from 'zod'
- *
- * const form = useForm({
- *   schema: z.object({
- *     username: z.string().min(2, 'At least 2 characters'),
- *     password: z.string().min(8, 'At least 8 characters'),
- *   }),
- * })
- * ```
- *
- * The constraint intersects `ZodV4Internals` (the v4-only `_zod`
- * brand) so a v3 schema can't bind this overload even when `z`
- * resolves to v3 in a single-major consumer install; v3 schemas fall
- * through to the v3 overload below. See `types-zod-major.ts`.
- */
-declare function useForm<Schema extends SupportedRootSchema & ZodV4Internals, K extends FormKey = FormKey>(configuration: Omit<UseFormConfiguration<V4FormOf<Schema>, V4OutOf<Schema>, AbstractSchema<V4FormOf<Schema>, V4OutOf<Schema>>, never, K>, 'schema' | 'validateOn' | 'debounceMs' | 'defaultValues'> & {
-    schema: Schema;
-    defaultValues?: AcceptableDefaults<V4FormOf<Schema>, V4SchemaInput<Schema>>;
-} & ValidateOnConfig): UseFormReturnType<V4FormOf<Schema>, V4OutOf<Schema>, V4ReadOf<Schema>, K>;
-/**
- * Create a form bound to a Zod v3 schema.
- *
- * ```ts
- * import { useForm } from 'attaform/zod'
- * import { z } from 'zod-v3'
- *
- * const form = useForm({
- *   schema: z.object({
- *     username: z.string().min(2, 'At least 2 characters'),
- *     password: z.string().min(8, 'At least 8 characters'),
- *   }),
- * })
- * ```
- *
- * v3 schemas match this overload; v4 schemas hit the v4 overload
- * above first and never reach here.
- */
-declare function useForm<Schema extends SupportedRootSchema$1, K extends FormKey = FormKey>(configuration: Omit<UseFormConfiguration<V3FormOf<Schema>, V3OutOf<Schema>, AbstractSchema<V3FormOf<Schema>, V3OutOf<Schema>>, never, K>, 'schema' | 'validateOn' | 'debounceMs' | 'defaultValues'> & {
-    schema: Schema;
-    defaultValues?: AcceptableDefaults<V3FormOf<Schema>, V3SchemaInput<Schema>>;
-} & ValidateOnConfig): UseFormReturnType<V3FormOf<Schema>, V3OutOf<Schema>, V3ReadOf<Schema>, K>;
-
-/**
- * Type-level helpers for the unified `attaform/zod` entry. These give
- * tests and other type-query call sites a deterministic projection
- * over an arbitrary v4 OR v3 schema, sidestepping the brittle
- * instantiation-expression resolution rules TypeScript applies to
- * overloaded functions (`typeof useForm<X>` can pick the wrong
- * overload or the impl signature, depending on whether the type
- * argument is a concrete schema, a generic, or a constraint).
- *
- * The helpers dispatch ONCE per use site via a binary conditional —
- * no stacking, no amplification across the return type. Equivalent
- * to writing `ReturnType<typeof useForm<S>>` but cache-stable across
- * call patterns.
- *
- * Per `inference-first DX`, these helpers are test- and
- * internal-facing. Consumer code shouldn't reach for them — the
- * overloaded `useForm` already gives full inference at call sites.
- */
-
-/**
- * Direct V4 projection — no major-dispatch. Use when the schema's
- * Zod major is known statically (typical for V4 generic helpers like
- * `function setup<S extends z.ZodObject>(s: S)`). TS simplifies the
- * helper cleanly under generic constraints because no conditional
- * is present.
- */
-type UseFormReturnV4<Schema extends z.ZodObject, K extends FormKey = FormKey> = UseFormReturnType<V4FormOf<Schema>, V4OutOf<Schema>, V4ReadOf<Schema>, K>;
-/**
- * Direct V4 configuration projection. Mirrors `UseFormReturnV4`.
- */
-type UseFormConfigV4<Schema extends z.ZodObject, K extends FormKey = FormKey> = Omit<UseFormConfiguration<V4FormOf<Schema>, V4OutOf<Schema>, AbstractSchema<V4FormOf<Schema>, V4OutOf<Schema>>, DefaultValuesInput<V4FormOf<Schema>>, K>, 'schema' | 'validateOn' | 'debounceMs'> & {
-    schema: Schema;
-} & ValidateOnConfig;
-/**
- * Direct V3 projection — no major-dispatch. Use when the schema's
- * Zod major is known statically.
- */
-type UseFormReturnV3<Schema extends z.ZodObject<z.ZodRawShape>, K extends FormKey = FormKey> = UseFormReturnType<V3FormOf<Schema>, V3OutOf<Schema>, V3ReadOf<Schema>, K>;
-/**
- * Direct V3 configuration projection. Mirrors `UseFormReturnV3`.
- */
-type UseFormConfigV3<Schema extends z.ZodObject<z.ZodRawShape>, K extends FormKey = FormKey> = Omit<UseFormConfiguration<V3FormOf<Schema>, V3OutOf<Schema>, AbstractSchema<V3FormOf<Schema>, V3OutOf<Schema>>, DefaultValuesInput<V3FormOf<Schema>>, K>, 'schema' | 'validateOn' | 'debounceMs'> & {
-    schema: Schema;
-} & ValidateOnConfig;
-/**
- * The return shape of `useForm` for a given Zod schema. Dispatches
- * once on the schema's major version and projects to the matching
- * adapter's `Form` / `Out` / `Read` slots. The dispatch matches the
- * full `SupportedRootSchema` per major, so an object, record, or
- * discriminated-union root all resolve here exactly as the runtime
- * `useForm` overloads accept them.
- *
- * Replaces `ReturnType<typeof useForm<Schema, K>>` in test code with
- * concrete schemas. For generic helpers (`<S extends z.ZodObject>`),
- * use `UseFormReturnV4<S>` directly — TS doesn't simplify
- * conditional types under generic constraints, so the dispatch in
- * this helper stays deferred and TS can't prove return-type
- * compatibility.
- */
-type UseFormReturn<Schema, K extends FormKey = FormKey> = Schema extends SupportedRootSchema & ZodV4Internals ? UseFormReturnType<V4FormOf<Schema>, V4OutOf<Schema>, V4ReadOf<Schema>, K> : Schema extends SupportedRootSchema$1 ? UseFormReturnType<V3FormOf<Schema>, V3OutOf<Schema>, V3ReadOf<Schema>, K> : never;
-/**
- * The configuration parameter shape of `useForm` for a given Zod
- * schema. Mirrors `UseFormReturn`'s dispatch — replaces
- * `Parameters<typeof useForm<Schema, K>>[0]` in test code.
- */
-type UseFormConfig<Schema, K extends FormKey = FormKey> = Schema extends SupportedRootSchema & ZodV4Internals ? Omit<UseFormConfiguration<V4FormOf<Schema>, V4OutOf<Schema>, AbstractSchema<V4FormOf<Schema>, V4OutOf<Schema>>, DefaultValuesInput<V4FormOf<Schema>>, K>, 'schema' | 'validateOn' | 'debounceMs'> & {
-    schema: Schema;
-} & ValidateOnConfig : Schema extends SupportedRootSchema$1 ? Omit<UseFormConfiguration<V3FormOf<Schema>, V3OutOf<Schema>, AbstractSchema<V3FormOf<Schema>, V3OutOf<Schema>>, DefaultValuesInput<V3FormOf<Schema>>, K>, 'schema' | 'validateOn' | 'debounceMs'> & {
-    schema: Schema;
-} & ValidateOnConfig : never;
-
-/**
- * Field-metadata write/read API for the unified `attaform/zod` entry.
- *
- * Storage is shared with both adapters via `field-meta-store` — a
- * payload written here is visible to whichever adapter the unified
- * `useForm` dispatches to at runtime, regardless of Zod major. No
- * `zod` runtime import; the type-only `import type` is erased at
- * build, so `attaform/zod` carries no `z.registry` reference even
- * when consumed by a Zod 3 project without the Vite plugin alias.
- *
- * The native v4 chain `schema.register(fieldMeta, payload)` continues
- * to work — Zod 4's `.register()` only calls `.add(this, payload)`
- * structurally, satisfied by the shared store.
- */
-
-type ZodFieldMetaRegistry = ReturnType<typeof z.registry<FieldMetaPayload>>;
-/**
- * The shared registry every Attaform-aware Zod schema can register
- * field metadata against, regardless of major. Same instance the v3
- * and v4 adapter entries expose — write in one place, read from
- * any.
- *
- * Cast to Zod 4's `$ZodRegistry<FieldMetaPayload>` so the native
- * `schema.register(fieldMeta, payload)` chain type-checks for v4
- * users; the runtime call only needs `.add` structurally, which the
- * shared store provides.
- */
-declare const fieldMeta: ZodFieldMetaRegistry;
-/**
- * Attach `payload` to `schema` in the shared registry and return a
- * clone of `schema` so each call gets its own identity (the registry
- * keys on schema reference, so cloning prevents last-write-wins
- * collisions for sub-schemas reused at multiple paths).
- *
- * Works on both Zod 3 and Zod 4 schemas — branches on the runtime
- * shape of the schema:
- * - Zod 4 schemas expose a public `.clone()` method; we call it.
- * - Zod 3 schemas don't, so we reconstruct via
- *   `new schema.constructor(schema._def)`.
- *
- * Both forms produce a fresh schema with the same effective
- * structure, so the registry slot is unique to this call site.
- */
-declare function withMeta<S>(schema: S, payload: FieldMetaPayload): S;
-
-export { DefaultValuesInput, FieldMetaPayload, FormKey, GenericForm, UseFormConfiguration, UseFormReturnType, ValidateOnConfig, fieldMeta, useForm, withMeta };
-export type { UseFormConfig, UseFormConfigV3, UseFormConfigV4, UseFormReturn, UseFormReturnV3, UseFormReturnV4 };

package/dist/index.mjs.map

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

package/dist/nuxt.cjs

@@ -1,84 +0,0 @@
-'use strict';
-
-const node_module = require('node:module');
-const node_path = require('node:path');
-const node_url = require('node:url');
-const kit = require('@nuxt/kit');
-const vite = require('./vite.cjs');
-
-var _documentCurrentScript = typeof document !== 'undefined' ? document.currentScript : null;
-const pkgVersion = node_module.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('nuxt.cjs', document.baseURI).href)))("../package.json").version;
-function isResolvableForVite(specifier, consumerRootDir) {
-  const consumerURL = node_url.pathToFileURL(node_path.join(consumerRootDir, "package.json")).href;
-  return canResolve(specifier, consumerURL) || canResolve(specifier, (typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('nuxt.cjs', document.baseURI).href)));
-}
-function canResolve(specifier, fromURL) {
-  try {
-    undefined(specifier, fromURL);
-    return true;
-  } catch {
-    return false;
-  }
-}
-var nuxt_default = kit.defineNuxtModule({
-  meta: {
-    name: "Attaform",
-    configKey: "attaform",
-    version: pkgVersion,
-    docs: "https://attaform.dev/docs",
-    compatibility: {
-      nuxt: ">=3.0.0"
-    }
-  },
-  defaults: {},
-  setup(_options, nuxt) {
-    var _a, _b;
-    kit.addVitePlugin(vite.attaform({ resolveZodAlias: _options.resolveZodAlias !== false }));
-    const runtimePublic = nuxt.options.runtimeConfig.public;
-    runtimePublic["attaform"] = {
-      defaults: _options.defaults ?? {},
-      version: pkgVersion
-    };
-    (_a = nuxt.options.vite).optimizeDeps ?? (_a.optimizeDeps = {});
-    (_b = nuxt.options.vite.optimizeDeps).include ?? (_b.include = []);
-    const include = nuxt.options.vite.optimizeDeps.include;
-    for (const spec of ["@vue/devtools-api", "zod"]) {
-      if (!isResolvableForVite(spec, nuxt.options.rootDir)) continue;
-      if (!include.includes(spec)) include.push(spec);
-    }
-    const resolver = kit.createResolver((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('nuxt.cjs', document.baseURI).href)));
-    if (_options.autoImports !== false) {
-      kit.addImports(vite.attaformAutoImports);
-    }
-    kit.addPlugin({
-      src: resolver.resolve("./runtime/plugins/attaform")
-    });
-    if (nuxt.options.dev) {
-      nuxt.hook("ready", async () => {
-        try {
-          const { addCustomTab } = await import('@nuxt/devtools-kit');
-          addCustomTab({
-            name: "attaform",
-            title: "Attaform",
-            // Brand mark — purple square with a white "A" silhouette,
-            // matching `apps/site/public/favicon.svg`. Served by the
-            // `attaform/vite` middleware at the same `/_attaform_devtools`
-            // route family (sibling to the panel HTML). A real URL
-            // renders reliably across Nuxt DevTools versions where
-            // `data:` URIs don't.
-            icon: "/_attaform_devtools/icon.svg",
-            view: {
-              type: "iframe",
-              src: "/_attaform_devtools",
-              persistent: true
-            }
-          });
-        } catch {
-        }
-      });
-    }
-  }
-});
-
-module.exports = nuxt_default;
-//# sourceMappingURL=nuxt.cjs.map

package/dist/nuxt.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"nuxt.cjs","sources":["../src/nuxt.ts"],"sourcesContent":["import { createRequire } from 'node:module'\nimport { join } from 'node:path'\nimport { pathToFileURL } from 'node:url'\nimport { addImports, addPlugin, addVitePlugin, createResolver, defineNuxtModule } from '@nuxt/kit'\nimport { attaformAutoImports } from './runtime/auto-imports'\nimport type { AttaformDefaults } from './runtime/types/types-api'\nimport { attaform as attaformVitePlugin } from './vite'\n\n// Read the published version from the package's own package.json so the\n// module's DevTools panel surfaces the live version pill without a\n// build-time string injection. `createRequire` reads sync at module load —\n// run once, free at steady state. Works under unbuild's Rollup output\n// without bundler-specific JSON-import handling.\nconst pkgVersion = (createRequire(import.meta.url)('../package.json') as { version: string })\n  .version\n\n/**\n * Options accepted by `attaform/nuxt` under the `attaform`\n * config key.\n *\n * ```ts\n * // nuxt.config.ts\n * export default defineNuxtConfig({\n *   modules: ['attaform/nuxt'],\n *   attaform: {\n *     defaults: { debounceMs: 100 },\n *   },\n * })\n * ```\n */\nexport interface AttaformModuleOptions {\n  /**\n   * App-level defaults applied to every `useForm` call. Per-form\n   * options always win. See `AttaformDefaults` for the\n   * supported option set and merge rules.\n   */\n  defaults?: AttaformDefaults\n  /**\n   * Forwarded to `attaform/vite`'s `resolveZodAlias` option.\n   * Default `true` — `attaform` and `attaform/zod` imports are rewritten\n   * at build time to either `attaform/zod-v3` or `attaform/zod-v4`, based\n   * on the consumer's installed Zod major. Set to `false` to bypass\n   * the rewrite and ship the runtime-dispatch unified entry instead.\n   */\n  resolveZodAlias?: boolean\n  /**\n   * Auto-import Attaform's form composables (`useForm`, `useWizard`,\n   * `injectForm`, `injectWizard`, `fieldMeta`, `withMeta`, `lazy`) so\n   * components can call them without an explicit `import`. Default\n   * `true`. The set is declared in Attaform's auto-import manifest and\n   * resolves from `attaform/zod`, so the build-time adapter rewrite\n   * still ships a single Zod major. Set to `false` to suppress the\n   * names entirely and import the composables yourself. Note a Nuxt\n   * auto-import already loses to an explicit or local binding of the\n   * same name, so opting out is only needed to keep the names out of\n   * global scope altogether.\n   */\n  autoImports?: boolean\n}\n\n/**\n * Shape of the Nuxt public runtime-config slot the module populates.\n * Reach it via `useRuntimeConfig().public.attaform` if you need to\n * read the configured defaults outside the form library itself.\n */\nexport type AttaformRuntimeConfig = {\n  defaults: AttaformDefaults\n  /**\n   * Library version, read from the package's own `package.json` at\n   * module setup. Surfaced to the runtime plugin so the DevTools\n   * overlay panel can render a version pill — single source of truth\n   * matches the `meta.version` Nuxt DevTools sees in the Modules panel.\n   */\n  version: string\n}\n\n/**\n * Whether `specifier` is resolvable using ESM resolution from either the\n * consumer's project root or attaform's own module location. Returning\n * true matches what Vite's resolver would do for `optimizeDeps.include`,\n * so a true here means Vite will pre-bundle the dep without warning.\n *\n * Why two probe locations:\n *   - Consumer-rootDir probe finds direct deps + their declared peers\n *     (the standard pnpm strict-isolation visibility).\n *   - attaform-module probe finds peers attaform itself declares —\n *     specifically the optional `@vue/devtools-api`, which lands in\n *     attaform's own node_modules tree (or pnpm virtual store) when\n *     installed, even if the consumer never references it directly.\n *\n * Why ESM resolution (`import.meta.resolve`) rather than CJS\n * (`createRequire(...).resolve`):\n *   - attaform's exports map declares only `import` conditions for\n *     non-`/nuxt` entries. CJS resolve hits ERR_PACKAGE_PATH_NOT_EXPORTED\n *     for `attaform` and its sub-entries.\n *   - pnpm strict isolation hides hoisted transitives behind the\n *     virtual store. CJS resolve walks the bare node_modules chain and\n *     misses them; ESM resolve follows pnpm's symlinks correctly.\n *   - `import.meta.resolve(spec, parentURL)` is sync and stable in\n *     Node 20.6+, which attaform already requires (engines.node).\n */\nfunction isResolvableForVite(specifier: string, consumerRootDir: string): boolean {\n  const consumerURL = pathToFileURL(join(consumerRootDir, 'package.json')).href\n  return canResolve(specifier, consumerURL) || canResolve(specifier, import.meta.url)\n}\n\nfunction canResolve(specifier: string, fromURL: string): boolean {\n  try {\n    import.meta.resolve(specifier, fromURL)\n    return true\n  } catch {\n    return false\n  }\n}\n\nexport default defineNuxtModule<AttaformModuleOptions>({\n  meta: {\n    name: 'Attaform',\n    configKey: 'attaform',\n    version: pkgVersion,\n    docs: 'https://attaform.dev/docs',\n    compatibility: {\n      nuxt: '>=3.0.0',\n    },\n  },\n  defaults: {},\n  setup(_options, nuxt) {\n    // Register `attaform/vite` so the same plugin handles every Vite-\n    // surface concern: pushing the compile-time node transforms into\n    // `@vitejs/plugin-vue`'s `api.options.template.compilerOptions.\n    // nodeTransforms`, AND rewriting `attaform/zod` imports at build\n    // time to either `/zod-v3` or `/zod-v4` based on the consumer's\n    // installed Zod major. Consolidating both behaviors in one Vite\n    // plugin instance keeps the Nuxt-side wiring minimal and ensures\n    // the consumer's Nuxt build sees the exact same DX as a bare-Vite\n    // consumer.\n    addVitePlugin(attaformVitePlugin({ resolveZodAlias: _options.resolveZodAlias !== false }))\n\n    // Publish module options to public runtime config so the plugin can\n    // read them at install time on both server and client. Frozen-empty\n    // by default — the plugin's merge code reads this slot directly\n    // without a `?? {}` guard at every call site.\n    const runtimePublic = nuxt.options.runtimeConfig.public as Record<string, unknown>\n    runtimePublic['attaform'] = {\n      defaults: _options.defaults ?? {},\n      version: pkgVersion,\n    } satisfies AttaformRuntimeConfig\n\n    // Force-include attaform's own peers that Vite's startup crawl\n    // tends to miss for Nuxt projects. Vite scans `index.html` + the\n    // statically-known entry points but doesn't deeply follow into\n    // pages that get loaded via Nuxt's dynamic router; deps imported\n    // exclusively from page chunks are discovered when the page first\n    // requests, the optimizer rebundles, and Vite silently broadcasts\n    // `{\"type\":\"full-reload\",\"path\":\"*\"}` over the HMR WebSocket — what\n    // consumers see as \"the page loads, then reloads itself a second\n    // later.\" Vite's own \"discovered new dependencies at runtime\"\n    // warning recommends exactly this remediation.\n    //\n    // We declare here only deps attaform itself owns the relationship\n    // with — `@vue/devtools-api` (attaform's DevTools integration\n    // peer) and `zod` (the adapter peer for `/zod`, `/zod-v3`, and\n    // `/zod-v4`). Consumer-\n    // side deps (vue-query, immer, etc.) are the consumer's\n    // responsibility — they declare them in their own\n    // `vite.optimizeDeps.include`. Each push is gated on the spec\n    // being resolvable from the consumer's project (or attaform's\n    // own module context for attaform's optional peers like\n    // devtools-api), so consumers without the optional peer don't see\n    // a \"failed to resolve\" warning at boot.\n    nuxt.options.vite.optimizeDeps ??= {}\n    nuxt.options.vite.optimizeDeps.include ??= []\n    const include = nuxt.options.vite.optimizeDeps.include\n    for (const spec of ['@vue/devtools-api', 'zod']) {\n      if (!isResolvableForVite(spec, nuxt.options.rootDir)) continue\n      if (!include.includes(spec)) include.push(spec)\n    }\n\n    const resolver = createResolver(import.meta.url)\n\n    // Auto-import the Zod-default form composables so a component can\n    // reach for `useForm` / `useWizard` / `injectForm` / `injectWizard` /\n    // `fieldMeta` / `withMeta` / `lazy` with no import line. The manifest\n    // in `./runtime/auto-imports` is the single source of truth, shared\n    // with the `attaform/vite` preset re-export.\n    //\n    // Each entry resolves from `attaform/zod`, not the bare `attaform`\n    // barrel: the Vite/bundler plugin rewrites the exact `attaform/zod`\n    // specifier to the one installed Zod major at build time, so a Nuxt\n    // consumer's bundle ships a single adapter instead of the runtime\n    // dispatcher. After the schema-entry re-partition the two surfaces\n    // are byte-identical (`attaform` re-exports exactly what\n    // `attaform/zod` does), so pointing at `/zod` costs nothing and buys\n    // the lean bundle for free. Resolving a public subpath rather than a\n    // relative `./runtime/…` path also keeps the published package honest\n    // — `attaform/zod` maps to a real `dist/zod.mjs`, so Nuxt's\n    // auto-import step never chases a source path with no built artifact.\n    //\n    // A Nuxt auto-import always loses to an explicit or local binding, so\n    // registering these never shadows a consumer's own `useForm`. The\n    // `autoImports: false` option suppresses the whole set for consumers\n    // who prefer explicit imports everywhere.\n    if (_options.autoImports !== false) {\n      addImports(attaformAutoImports)\n    }\n\n    // Plugin that installs `createAttaform()` on the Vue app and\n    // wires the payload serialize/hydrate bridge. Uses a physical\n    // `src/runtime/plugins/attaform.ts` file (shipped to\n    // `dist/runtime/plugins/attaform.mjs` via an explicit entry in\n    // build.config.ts) rather than an inline plugin template, because a\n    // template's `import { createAttaform } from 'attaform'`\n    // resolves through the `attaform` package entry — which in\n    // local dev (`unbuild --stub`) is a jiti runtime transpiler whose\n    // `node:module`/`createRequire` imports Nitro's Rollup build cannot\n    // bundle. A physical file lets Nitro follow its imports directly\n    // (TS source in dev, ESM in the published package), avoiding the\n    // jiti indirection entirely. Unbuild's shared-chunk splitter keeps\n    // `core/plugin` + `core/serialize` deduplicated with `src/zod` /\n    // `src/index`, so there's still only one `registry` module at runtime.\n    //\n    // `addPlugin` defaults to PREPEND so the plugin runs before any\n    // user plugin / page; `enforce: 'pre'` inside the plugin body makes\n    // that ordering explicit at the Nuxt-plugin layer too. Together\n    // they guarantee the registry is installed (and SSR payload staged\n    // into `pendingHydration`) before any `useForm` call runs.\n    addPlugin({\n      src: resolver.resolve('./runtime/plugins/attaform'),\n    })\n\n    // Dev-only: register a Nuxt DevTools overlay tab pointing at an\n    // iframe that mounts the Attaform inspector. The iframe URL\n    // (`/_attaform_devtools`) is served by a Vite-layer middleware\n    // wired up in `attaform/vite` — by intercepting at the Vite layer\n    // rather than via `extendPages`, the route stays invisible to\n    // vue-router and works regardless of whether the consumer uses\n    // a `pages/` directory or `app.vue`-only mode.\n    //\n    // `@nuxt/devtools-kit` is NOT a transitive peer of `@nuxt/kit`; it\n    // ships alongside `@nuxt/devtools`. Consumers who don't install\n    // Nuxt DevTools (rare in real Nuxt projects, common in test\n    // fixtures) get a silent no-op instead of an \"unresolved import\"\n    // error. Mirrors the same try/import pattern used for\n    // `@vue/devtools-api` in the runtime devtools wire-up.\n    if (nuxt.options.dev) {\n      nuxt.hook('ready', async () => {\n        try {\n          const { addCustomTab } = await import('@nuxt/devtools-kit')\n          addCustomTab({\n            name: 'attaform',\n            title: 'Attaform',\n            // Brand mark — purple square with a white \"A\" silhouette,\n            // matching `apps/site/public/favicon.svg`. Served by the\n            // `attaform/vite` middleware at the same `/_attaform_devtools`\n            // route family (sibling to the panel HTML). A real URL\n            // renders reliably across Nuxt DevTools versions where\n            // `data:` URIs don't.\n            icon: '/_attaform_devtools/icon.svg',\n            view: {\n              type: 'iframe',\n              src: '/_attaform_devtools',\n              persistent: true,\n            },\n          })\n        } catch {\n          // Nuxt DevTools (and thus @nuxt/devtools-kit) isn't installed\n          // in this consumer — silently skip. The library still works;\n          // only the overlay tab is missing.\n        }\n      })\n    }\n  },\n})\n"],"names":["createRequire","pathToFileURL","join","defineNuxtModule","addVitePlugin","attaformVitePlugin","createResolver","addImports","attaformAutoImports","addPlugin"],"mappings":"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"}

package/dist/nuxt.d.cts

@@ -1,66 +0,0 @@
-import * as _nuxt_schema from '@nuxt/schema';
-import { d as AttaformDefaults } from './shared/attaform.DniawQLP.cjs';
-import 'vue';
-
-/**
- * Options accepted by `attaform/nuxt` under the `attaform`
- * config key.
- *
- * ```ts
- * // nuxt.config.ts
- * export default defineNuxtConfig({
- *   modules: ['attaform/nuxt'],
- *   attaform: {
- *     defaults: { debounceMs: 100 },
- *   },
- * })
- * ```
- */
-interface AttaformModuleOptions {
-    /**
-     * App-level defaults applied to every `useForm` call. Per-form
-     * options always win. See `AttaformDefaults` for the
-     * supported option set and merge rules.
-     */
-    defaults?: AttaformDefaults;
-    /**
-     * Forwarded to `attaform/vite`'s `resolveZodAlias` option.
-     * Default `true` — `attaform` and `attaform/zod` imports are rewritten
-     * at build time to either `attaform/zod-v3` or `attaform/zod-v4`, based
-     * on the consumer's installed Zod major. Set to `false` to bypass
-     * the rewrite and ship the runtime-dispatch unified entry instead.
-     */
-    resolveZodAlias?: boolean;
-    /**
-     * Auto-import Attaform's form composables (`useForm`, `useWizard`,
-     * `injectForm`, `injectWizard`, `fieldMeta`, `withMeta`, `lazy`) so
-     * components can call them without an explicit `import`. Default
-     * `true`. The set is declared in Attaform's auto-import manifest and
-     * resolves from `attaform/zod`, so the build-time adapter rewrite
-     * still ships a single Zod major. Set to `false` to suppress the
-     * names entirely and import the composables yourself. Note a Nuxt
-     * auto-import already loses to an explicit or local binding of the
-     * same name, so opting out is only needed to keep the names out of
-     * global scope altogether.
-     */
-    autoImports?: boolean;
-}
-/**
- * Shape of the Nuxt public runtime-config slot the module populates.
- * Reach it via `useRuntimeConfig().public.attaform` if you need to
- * read the configured defaults outside the form library itself.
- */
-type AttaformRuntimeConfig = {
-    defaults: AttaformDefaults;
-    /**
-     * Library version, read from the package's own `package.json` at
-     * module setup. Surfaced to the runtime plugin so the DevTools
-     * overlay panel can render a version pill — single source of truth
-     * matches the `meta.version` Nuxt DevTools sees in the Modules panel.
-     */
-    version: string;
-};
-declare const _default: _nuxt_schema.NuxtModule<AttaformModuleOptions, AttaformModuleOptions, false>;
-
-export = _default;
-export type { AttaformModuleOptions, AttaformRuntimeConfig };

package/dist/nuxt.d.ts

@@ -1,66 +0,0 @@
-import * as _nuxt_schema from '@nuxt/schema';
-import { d as AttaformDefaults } from './shared/attaform.DniawQLP.js';
-import 'vue';
-
-/**
- * Options accepted by `attaform/nuxt` under the `attaform`
- * config key.
- *
- * ```ts
- * // nuxt.config.ts
- * export default defineNuxtConfig({
- *   modules: ['attaform/nuxt'],
- *   attaform: {
- *     defaults: { debounceMs: 100 },
- *   },
- * })
- * ```
- */
-interface AttaformModuleOptions {
-    /**
-     * App-level defaults applied to every `useForm` call. Per-form
-     * options always win. See `AttaformDefaults` for the
-     * supported option set and merge rules.
-     */
-    defaults?: AttaformDefaults;
-    /**
-     * Forwarded to `attaform/vite`'s `resolveZodAlias` option.
-     * Default `true` — `attaform` and `attaform/zod` imports are rewritten
-     * at build time to either `attaform/zod-v3` or `attaform/zod-v4`, based
-     * on the consumer's installed Zod major. Set to `false` to bypass
-     * the rewrite and ship the runtime-dispatch unified entry instead.
-     */
-    resolveZodAlias?: boolean;
-    /**
-     * Auto-import Attaform's form composables (`useForm`, `useWizard`,
-     * `injectForm`, `injectWizard`, `fieldMeta`, `withMeta`, `lazy`) so
-     * components can call them without an explicit `import`. Default
-     * `true`. The set is declared in Attaform's auto-import manifest and
-     * resolves from `attaform/zod`, so the build-time adapter rewrite
-     * still ships a single Zod major. Set to `false` to suppress the
-     * names entirely and import the composables yourself. Note a Nuxt
-     * auto-import already loses to an explicit or local binding of the
-     * same name, so opting out is only needed to keep the names out of
-     * global scope altogether.
-     */
-    autoImports?: boolean;
-}
-/**
- * Shape of the Nuxt public runtime-config slot the module populates.
- * Reach it via `useRuntimeConfig().public.attaform` if you need to
- * read the configured defaults outside the form library itself.
- */
-type AttaformRuntimeConfig = {
-    defaults: AttaformDefaults;
-    /**
-     * Library version, read from the package's own `package.json` at
-     * module setup. Surfaced to the runtime plugin so the DevTools
-     * overlay panel can render a version pill — single source of truth
-     * matches the `meta.version` Nuxt DevTools sees in the Modules panel.
-     */
-    version: string;
-};
-declare const _default: _nuxt_schema.NuxtModule<AttaformModuleOptions, AttaformModuleOptions, false>;
-
-export = _default;
-export type { AttaformModuleOptions, AttaformRuntimeConfig };

package/dist/nuxt.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"nuxt.mjs","sources":["../src/nuxt.ts"],"sourcesContent":["import { createRequire } from 'node:module'\nimport { join } from 'node:path'\nimport { pathToFileURL } from 'node:url'\nimport { addImports, addPlugin, addVitePlugin, createResolver, defineNuxtModule } from '@nuxt/kit'\nimport { attaformAutoImports } from './runtime/auto-imports'\nimport type { AttaformDefaults } from './runtime/types/types-api'\nimport { attaform as attaformVitePlugin } from './vite'\n\n// Read the published version from the package's own package.json so the\n// module's DevTools panel surfaces the live version pill without a\n// build-time string injection. `createRequire` reads sync at module load —\n// run once, free at steady state. Works under unbuild's Rollup output\n// without bundler-specific JSON-import handling.\nconst pkgVersion = (createRequire(import.meta.url)('../package.json') as { version: string })\n  .version\n\n/**\n * Options accepted by `attaform/nuxt` under the `attaform`\n * config key.\n *\n * ```ts\n * // nuxt.config.ts\n * export default defineNuxtConfig({\n *   modules: ['attaform/nuxt'],\n *   attaform: {\n *     defaults: { debounceMs: 100 },\n *   },\n * })\n * ```\n */\nexport interface AttaformModuleOptions {\n  /**\n   * App-level defaults applied to every `useForm` call. Per-form\n   * options always win. See `AttaformDefaults` for the\n   * supported option set and merge rules.\n   */\n  defaults?: AttaformDefaults\n  /**\n   * Forwarded to `attaform/vite`'s `resolveZodAlias` option.\n   * Default `true` — `attaform` and `attaform/zod` imports are rewritten\n   * at build time to either `attaform/zod-v3` or `attaform/zod-v4`, based\n   * on the consumer's installed Zod major. Set to `false` to bypass\n   * the rewrite and ship the runtime-dispatch unified entry instead.\n   */\n  resolveZodAlias?: boolean\n  /**\n   * Auto-import Attaform's form composables (`useForm`, `useWizard`,\n   * `injectForm`, `injectWizard`, `fieldMeta`, `withMeta`, `lazy`) so\n   * components can call them without an explicit `import`. Default\n   * `true`. The set is declared in Attaform's auto-import manifest and\n   * resolves from `attaform/zod`, so the build-time adapter rewrite\n   * still ships a single Zod major. Set to `false` to suppress the\n   * names entirely and import the composables yourself. Note a Nuxt\n   * auto-import already loses to an explicit or local binding of the\n   * same name, so opting out is only needed to keep the names out of\n   * global scope altogether.\n   */\n  autoImports?: boolean\n}\n\n/**\n * Shape of the Nuxt public runtime-config slot the module populates.\n * Reach it via `useRuntimeConfig().public.attaform` if you need to\n * read the configured defaults outside the form library itself.\n */\nexport type AttaformRuntimeConfig = {\n  defaults: AttaformDefaults\n  /**\n   * Library version, read from the package's own `package.json` at\n   * module setup. Surfaced to the runtime plugin so the DevTools\n   * overlay panel can render a version pill — single source of truth\n   * matches the `meta.version` Nuxt DevTools sees in the Modules panel.\n   */\n  version: string\n}\n\n/**\n * Whether `specifier` is resolvable using ESM resolution from either the\n * consumer's project root or attaform's own module location. Returning\n * true matches what Vite's resolver would do for `optimizeDeps.include`,\n * so a true here means Vite will pre-bundle the dep without warning.\n *\n * Why two probe locations:\n *   - Consumer-rootDir probe finds direct deps + their declared peers\n *     (the standard pnpm strict-isolation visibility).\n *   - attaform-module probe finds peers attaform itself declares —\n *     specifically the optional `@vue/devtools-api`, which lands in\n *     attaform's own node_modules tree (or pnpm virtual store) when\n *     installed, even if the consumer never references it directly.\n *\n * Why ESM resolution (`import.meta.resolve`) rather than CJS\n * (`createRequire(...).resolve`):\n *   - attaform's exports map declares only `import` conditions for\n *     non-`/nuxt` entries. CJS resolve hits ERR_PACKAGE_PATH_NOT_EXPORTED\n *     for `attaform` and its sub-entries.\n *   - pnpm strict isolation hides hoisted transitives behind the\n *     virtual store. CJS resolve walks the bare node_modules chain and\n *     misses them; ESM resolve follows pnpm's symlinks correctly.\n *   - `import.meta.resolve(spec, parentURL)` is sync and stable in\n *     Node 20.6+, which attaform already requires (engines.node).\n */\nfunction isResolvableForVite(specifier: string, consumerRootDir: string): boolean {\n  const consumerURL = pathToFileURL(join(consumerRootDir, 'package.json')).href\n  return canResolve(specifier, consumerURL) || canResolve(specifier, import.meta.url)\n}\n\nfunction canResolve(specifier: string, fromURL: string): boolean {\n  try {\n    import.meta.resolve(specifier, fromURL)\n    return true\n  } catch {\n    return false\n  }\n}\n\nexport default defineNuxtModule<AttaformModuleOptions>({\n  meta: {\n    name: 'Attaform',\n    configKey: 'attaform',\n    version: pkgVersion,\n    docs: 'https://attaform.dev/docs',\n    compatibility: {\n      nuxt: '>=3.0.0',\n    },\n  },\n  defaults: {},\n  setup(_options, nuxt) {\n    // Register `attaform/vite` so the same plugin handles every Vite-\n    // surface concern: pushing the compile-time node transforms into\n    // `@vitejs/plugin-vue`'s `api.options.template.compilerOptions.\n    // nodeTransforms`, AND rewriting `attaform/zod` imports at build\n    // time to either `/zod-v3` or `/zod-v4` based on the consumer's\n    // installed Zod major. Consolidating both behaviors in one Vite\n    // plugin instance keeps the Nuxt-side wiring minimal and ensures\n    // the consumer's Nuxt build sees the exact same DX as a bare-Vite\n    // consumer.\n    addVitePlugin(attaformVitePlugin({ resolveZodAlias: _options.resolveZodAlias !== false }))\n\n    // Publish module options to public runtime config so the plugin can\n    // read them at install time on both server and client. Frozen-empty\n    // by default — the plugin's merge code reads this slot directly\n    // without a `?? {}` guard at every call site.\n    const runtimePublic = nuxt.options.runtimeConfig.public as Record<string, unknown>\n    runtimePublic['attaform'] = {\n      defaults: _options.defaults ?? {},\n      version: pkgVersion,\n    } satisfies AttaformRuntimeConfig\n\n    // Force-include attaform's own peers that Vite's startup crawl\n    // tends to miss for Nuxt projects. Vite scans `index.html` + the\n    // statically-known entry points but doesn't deeply follow into\n    // pages that get loaded via Nuxt's dynamic router; deps imported\n    // exclusively from page chunks are discovered when the page first\n    // requests, the optimizer rebundles, and Vite silently broadcasts\n    // `{\"type\":\"full-reload\",\"path\":\"*\"}` over the HMR WebSocket — what\n    // consumers see as \"the page loads, then reloads itself a second\n    // later.\" Vite's own \"discovered new dependencies at runtime\"\n    // warning recommends exactly this remediation.\n    //\n    // We declare here only deps attaform itself owns the relationship\n    // with — `@vue/devtools-api` (attaform's DevTools integration\n    // peer) and `zod` (the adapter peer for `/zod`, `/zod-v3`, and\n    // `/zod-v4`). Consumer-\n    // side deps (vue-query, immer, etc.) are the consumer's\n    // responsibility — they declare them in their own\n    // `vite.optimizeDeps.include`. Each push is gated on the spec\n    // being resolvable from the consumer's project (or attaform's\n    // own module context for attaform's optional peers like\n    // devtools-api), so consumers without the optional peer don't see\n    // a \"failed to resolve\" warning at boot.\n    nuxt.options.vite.optimizeDeps ??= {}\n    nuxt.options.vite.optimizeDeps.include ??= []\n    const include = nuxt.options.vite.optimizeDeps.include\n    for (const spec of ['@vue/devtools-api', 'zod']) {\n      if (!isResolvableForVite(spec, nuxt.options.rootDir)) continue\n      if (!include.includes(spec)) include.push(spec)\n    }\n\n    const resolver = createResolver(import.meta.url)\n\n    // Auto-import the Zod-default form composables so a component can\n    // reach for `useForm` / `useWizard` / `injectForm` / `injectWizard` /\n    // `fieldMeta` / `withMeta` / `lazy` with no import line. The manifest\n    // in `./runtime/auto-imports` is the single source of truth, shared\n    // with the `attaform/vite` preset re-export.\n    //\n    // Each entry resolves from `attaform/zod`, not the bare `attaform`\n    // barrel: the Vite/bundler plugin rewrites the exact `attaform/zod`\n    // specifier to the one installed Zod major at build time, so a Nuxt\n    // consumer's bundle ships a single adapter instead of the runtime\n    // dispatcher. After the schema-entry re-partition the two surfaces\n    // are byte-identical (`attaform` re-exports exactly what\n    // `attaform/zod` does), so pointing at `/zod` costs nothing and buys\n    // the lean bundle for free. Resolving a public subpath rather than a\n    // relative `./runtime/…` path also keeps the published package honest\n    // — `attaform/zod` maps to a real `dist/zod.mjs`, so Nuxt's\n    // auto-import step never chases a source path with no built artifact.\n    //\n    // A Nuxt auto-import always loses to an explicit or local binding, so\n    // registering these never shadows a consumer's own `useForm`. The\n    // `autoImports: false` option suppresses the whole set for consumers\n    // who prefer explicit imports everywhere.\n    if (_options.autoImports !== false) {\n      addImports(attaformAutoImports)\n    }\n\n    // Plugin that installs `createAttaform()` on the Vue app and\n    // wires the payload serialize/hydrate bridge. Uses a physical\n    // `src/runtime/plugins/attaform.ts` file (shipped to\n    // `dist/runtime/plugins/attaform.mjs` via an explicit entry in\n    // build.config.ts) rather than an inline plugin template, because a\n    // template's `import { createAttaform } from 'attaform'`\n    // resolves through the `attaform` package entry — which in\n    // local dev (`unbuild --stub`) is a jiti runtime transpiler whose\n    // `node:module`/`createRequire` imports Nitro's Rollup build cannot\n    // bundle. A physical file lets Nitro follow its imports directly\n    // (TS source in dev, ESM in the published package), avoiding the\n    // jiti indirection entirely. Unbuild's shared-chunk splitter keeps\n    // `core/plugin` + `core/serialize` deduplicated with `src/zod` /\n    // `src/index`, so there's still only one `registry` module at runtime.\n    //\n    // `addPlugin` defaults to PREPEND so the plugin runs before any\n    // user plugin / page; `enforce: 'pre'` inside the plugin body makes\n    // that ordering explicit at the Nuxt-plugin layer too. Together\n    // they guarantee the registry is installed (and SSR payload staged\n    // into `pendingHydration`) before any `useForm` call runs.\n    addPlugin({\n      src: resolver.resolve('./runtime/plugins/attaform'),\n    })\n\n    // Dev-only: register a Nuxt DevTools overlay tab pointing at an\n    // iframe that mounts the Attaform inspector. The iframe URL\n    // (`/_attaform_devtools`) is served by a Vite-layer middleware\n    // wired up in `attaform/vite` — by intercepting at the Vite layer\n    // rather than via `extendPages`, the route stays invisible to\n    // vue-router and works regardless of whether the consumer uses\n    // a `pages/` directory or `app.vue`-only mode.\n    //\n    // `@nuxt/devtools-kit` is NOT a transitive peer of `@nuxt/kit`; it\n    // ships alongside `@nuxt/devtools`. Consumers who don't install\n    // Nuxt DevTools (rare in real Nuxt projects, common in test\n    // fixtures) get a silent no-op instead of an \"unresolved import\"\n    // error. Mirrors the same try/import pattern used for\n    // `@vue/devtools-api` in the runtime devtools wire-up.\n    if (nuxt.options.dev) {\n      nuxt.hook('ready', async () => {\n        try {\n          const { addCustomTab } = await import('@nuxt/devtools-kit')\n          addCustomTab({\n            name: 'attaform',\n            title: 'Attaform',\n            // Brand mark — purple square with a white \"A\" silhouette,\n            // matching `apps/site/public/favicon.svg`. Served by the\n            // `attaform/vite` middleware at the same `/_attaform_devtools`\n            // route family (sibling to the panel HTML). A real URL\n            // renders reliably across Nuxt DevTools versions where\n            // `data:` URIs don't.\n            icon: '/_attaform_devtools/icon.svg',\n            view: {\n              type: 'iframe',\n              src: '/_attaform_devtools',\n              persistent: true,\n            },\n          })\n        } catch {\n          // Nuxt DevTools (and thus @nuxt/devtools-kit) isn't installed\n          // in this consumer — silently skip. The library still works;\n          // only the overlay tab is missing.\n        }\n      })\n    }\n  },\n})\n"],"names":["attaformVitePlugin"],"mappings":"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"}

package/dist/rollup.cjs

@@ -1,24 +0,0 @@
-'use strict';
-
-const detectZodMajor = require('./shared/attaform.DoQm_Vkd.cjs');
-
-function attaform(options = {}) {
-  const resolveZodAlias = options.resolveZodAlias !== false;
-  const root = options.root ?? process.cwd();
-  const warnState = { warned: false };
-  let aliasTarget = null;
-  return {
-    name: "attaform",
-    buildStart() {
-      aliasTarget = detectZodMajor.resolveZodAliasTarget(root, "attaform/rollup", resolveZodAlias, warnState);
-    },
-    resolveId(source, importer) {
-      if (aliasTarget === null) return null;
-      if (!detectZodMajor.isRewritableZodSpecifier(source)) return null;
-      return this.resolve(aliasTarget, importer, { skipSelf: true });
-    }
-  };
-}
-
-exports.attaform = attaform;
-//# sourceMappingURL=rollup.cjs.map

package/dist/rollup.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"rollup.cjs","sources":["../src/rollup.ts"],"sourcesContent":["/**\n * `attaform/rollup` — Rollup 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, Rollup ships both adapters\n * because those entries import both for runtime dispatch.\n *\n * Usage:\n *\n *   // rollup.config.js\n *   import { attaform } from 'attaform/rollup'\n *\n *   export default {\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 `rollup` (the bundler injects\n * its plugin context at the consumer's build); the structural types below\n * are all it needs to compile.\n */\nimport { isRewritableZodSpecifier, resolveZodAliasTarget } from './core/detect-zod-major'\n\n/** Options for the Rollup `attaform()` plugin. */\nexport interface AttaformRollupPluginOptions {\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\n   * `process.cwd()`. Set this when the build runs from a directory other\n   * than the project that owns the Zod dependency.\n   */\n  root?: string\n}\n\ninterface RollupResolveContext {\n  resolve(\n    source: string,\n    importer: string | undefined,\n    options: { skipSelf: boolean }\n  ): Promise<{ id: string; external: boolean | 'absolute' | 'relative' } | null>\n}\n\n/** The structural shape Rollup requires of the plugin. */\nexport interface AttaformRollupPlugin {\n  name: string\n  buildStart(): void\n  resolveId(\n    this: RollupResolveContext,\n    source: string,\n    importer: string | undefined\n  ): Promise<{ id: string } | null> | null\n}\n\nexport function attaform(options: AttaformRollupPluginOptions = {}): AttaformRollupPlugin {\n  const resolveZodAlias = options.resolveZodAlias !== false\n  const root = options.root ?? process.cwd()\n  const warnState = { warned: false }\n  let aliasTarget: string | null = null\n\n  return {\n    name: 'attaform',\n    buildStart() {\n      // Detect once at build start (fail fast on missing zod). `buildStart`\n      // is guaranteed to run before any `resolveId`, so the target is set\n      // before the rewrite hook fires.\n      aliasTarget = resolveZodAliasTarget(root, 'attaform/rollup', resolveZodAlias, warnState)\n    },\n    resolveId(source, importer) {\n      if (aliasTarget === null) return null\n      // Both the bare `attaform` barrel and the explicit `attaform/zod`\n      // carry the runtime dispatcher, so both collapse to the one detected\n      // adapter; the pinned subpaths pass through untouched.\n      if (!isRewritableZodSpecifier(source)) return null\n      // Re-run the rewritten specifier through the resolver chain so the\n      // matching subpath export lands as a real module. `skipSelf` keeps\n      // the hook reentrant (our source check rejects the rewritten target\n      // anyway, since it is no longer a rewritable specifier).\n      return this.resolve(aliasTarget, importer, { skipSelf: true })\n    },\n  }\n}\n"],"names":["resolveZodAliasTarget","isRewritableZodSpecifier"],"mappings":";;;;AA+DO,SAAS,QAAA,CAAS,OAAA,GAAuC,EAAC,EAAyB;AACxF,EAAA,MAAM,eAAA,GAAkB,QAAQ,eAAA,KAAoB,KAAA;AACpD,EAAA,MAAM,IAAA,GAAO,OAAA,CAAQ,IAAA,IAAQ,OAAA,CAAQ,GAAA,EAAI;AACzC,EAAA,MAAM,SAAA,GAAY,EAAE,MAAA,EAAQ,KAAA,EAAM;AAClC,EAAA,IAAI,WAAA,GAA6B,IAAA;AAEjC,EAAA,OAAO;AAAA,IACL,IAAA,EAAM,UAAA;AAAA,IACN,UAAA,GAAa;AAIX,MAAA,WAAA,GAAcA,oCAAA,CAAsB,IAAA,EAAM,iBAAA,EAAmB,eAAA,EAAiB,SAAS,CAAA;AAAA,IACzF,CAAA;AAAA,IACA,SAAA,CAAU,QAAQ,QAAA,EAAU;AAC1B,MAAA,IAAI,WAAA,KAAgB,MAAM,OAAO,IAAA;AAIjC,MAAA,IAAI,CAACC,uCAAA,CAAyB,MAAM,CAAA,EAAG,OAAO,IAAA;AAK9C,MAAA,OAAO,KAAK,OAAA,CAAQ,WAAA,EAAa,UAAU,EAAE,QAAA,EAAU,MAAM,CAAA;AAAA,IAC/D;AAAA,GACF;AACF;;;;"}

package/dist/rollup.d.cts

@@ -1,35 +0,0 @@
-/** Options for the Rollup `attaform()` plugin. */
-interface AttaformRollupPluginOptions {
-    /**
-     * 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;
-    /**
-     * Project root to resolve the installed Zod from. Defaults to
-     * `process.cwd()`. Set this when the build runs from a directory other
-     * than the project that owns the Zod dependency.
-     */
-    root?: string;
-}
-interface RollupResolveContext {
-    resolve(source: string, importer: string | undefined, options: {
-        skipSelf: boolean;
-    }): Promise<{
-        id: string;
-        external: boolean | 'absolute' | 'relative';
-    } | null>;
-}
-/** The structural shape Rollup requires of the plugin. */
-interface AttaformRollupPlugin {
-    name: string;
-    buildStart(): void;
-    resolveId(this: RollupResolveContext, source: string, importer: string | undefined): Promise<{
-        id: string;
-    } | null> | null;
-}
-declare function attaform(options?: AttaformRollupPluginOptions): AttaformRollupPlugin;
-
-export { attaform };
-export type { AttaformRollupPlugin, AttaformRollupPluginOptions };