attaform 0.15.0 → 0.16.0

package/dist/index.d.cts

@@ -1,71 +1,8 @@
-import { Plugin, App, InjectionKey } from 'vue';
-import { A as AttaformDefaults, C as CoercionRegistry, S as SlimPrimitiveKind, a as CoercionEntry, F as FormKey, G as GenericForm, U as UseFormConfiguration, b as AbstractSchema, D as DeepPartial, c as DefaultValuesShape, d as UseFormReturnType, R as RegisterValue, e as RegisterModelDynamicCustomDirective, V as ValidationError, f as ApiErrorEnvelope, g as ApiErrorDetails } from './shared/attaform.0Gxd_OOx.cjs';
+import { App, InjectionKey, Plugin } from 'vue';
+import { C as CoercionRegistry, S as SlimPrimitiveKind, a as CoercionEntry, A as AttaformDefaults, F as FormKey, G as GenericForm, U as UseFormConfiguration, b as AbstractSchema, D as DeepPartial, c as DefaultValuesShape, d as UseFormReturnType, R as RegisterValue, e as RegisterModelDynamicCustomDirective, V as ValidationError, f as ApiErrorEnvelope, g as ApiErrorDetails } from './shared/attaform.0Gxd_OOx.cjs';
 export { h as ApiErrorEntry, i as ArrayItem, j as ArrayPath, k as CoercionResult, l as CustomDirectiveRegisterAssignerFn, m as DefaultValuesResponse, n as FieldMetaPayload, o as FieldState, p as FieldStateMap, q as FieldStateMapEntry, r as FlatPath, s as FormErrorRecord, t as FormErrorsSurface, u as FormMeta, v as FormStorage, w as FormStorageKind, H as HandleSubmit, x as HistoryConfig, I as IsTuple, y as IsUnion, J as JoinSegments, K as KeyofUnion, L as LiftedValueShape, M as MetaTrackerValue, N as NestedReadType, z as NestedType, O as OnError, B as OnInvalidSubmitPolicy, E as OnSubmit, P as Path, Q as PathKey, T as PendingValidationStatus, W as PersistConfig, X as PersistConfigOptions, Y as PersistIncludeMode, Z as ROOT_PATH, _ as ROOT_PATH_KEY, $ as ReactiveValidationStatus, a0 as RegisterDirective, a1 as RegisterFlatPath, a2 as RegisterOptions, a3 as RegisterSelectModifier, a4 as RegisterTextModifier, a5 as RegisterTransform, a6 as Segment, a7 as SetValueCallback, a8 as SetValuePayload, a9 as SettledValidationStatus, aa as SlimRuntimeOf, ab as SubmitHandler, ac as Unset, ad as ValidateOn, ae as ValidateOnConfig, af as ValidationResponse, ag as ValidationResponseWithoutValue, ah as ValueOfUnion, ai as WriteMeta, aj as WriteShape, ak as canonicalizePath, al as isPathPrefix, am as isUnset, an as parseDottedPath, ao as unset } from './shared/attaform.0Gxd_OOx.cjs';
-export { A as AttaformErrorCode, i as injectForm, u as useRegister } from './shared/attaform.D-eHWfVx.cjs';
-export { A as AnonPersistError, a as AttaformError, I as InvalidPathError, O as OutsideSetupError, R as RegistryNotInstalledError, b as ReservedFormKeyError, S as SensitivePersistFieldError, c as SubmitErrorHandlerError } from './shared/attaform.BwaYWtMs.cjs';
-
-/**
- * Portable SSR detection. The plugin captures this value at install time and
- * exposes it via the registry so every runtime branch reads a single source
- * of truth instead of sniffing `import.meta.*` (bundler-specific) at each
- * call site.
- *
- * Consumers can override explicitly via `createAttaform({ ssr: true })`;
- * the default heuristic handles the common Node-vs-browser split without
- * relying on any bundler-injected flag.
- */
-interface SSRDetectOptions {
-    override?: boolean;
-}
-
-/**
- * Options for `createAttaform()`.
- */
-type AttaformPluginOptions = SSRDetectOptions & {
-    /**
-     * Whether to install the Vue DevTools integration. Default `true`.
-     * The DevTools peer dependency is loaded lazily — in production
-     * builds where it's absent, the import fails silently and no
-     * extra bundle is shipped. Pass `false` to skip even attempting
-     * the import.
-     */
-    devtools?: boolean;
-    /**
-     * App-level defaults applied to every `useForm` call in this app.
-     * Per-form options always win. See `AttaformDefaults` for
-     * the supported option set and the merge rules.
-     *
-     * ```ts
-     * app.use(
-     *   createAttaform({
-     *     defaults: { debounceMs: 100 },
-     *   })
-     * )
-     * ```
-     */
-    defaults?: AttaformDefaults;
-};
-/**
- * Create the Vue plugin that installs the form library on a Vue
- * application. Call once per app, then `app.use(...)` the result.
- *
- * ```ts
- * import { createApp } from 'vue'
- * import { createAttaform } from 'attaform'
- *
- * createApp(App)
- *   .use(createAttaform())
- *   .mount('#app')
- * ```
- *
- * Under SSR with bare Vue 3, pass `{ ssr: true }` from your server
- * entry. Under Nuxt, install via `attaform/nuxt` instead —
- * the Nuxt module wires both server and client automatically.
- *
- * Installing more than once on the same app is a no-op (the second
- * call logs a dev-mode warning).
- */
-declare function createAttaform(options?: AttaformPluginOptions): Plugin;
+export { A as AttaformErrorCode, i as injectForm, u as useRegister } from './shared/attaform.Dq5BabH1.cjs';
+export { A as AnonPersistError, a as AttaformError, I as InvalidPathError, b as InvalidUseFormConfigError, O as OutsideSetupError, R as RegistryNotInstalledError, c as ReservedFormKeyError, S as SensitivePersistFieldError, d as SubmitErrorHandlerError } from './shared/attaform.B7rzpK1U.cjs';
 
 /**
  * Schema-driven coercion of user-typed DOM values at the v-register
@@ -110,6 +47,20 @@ declare function defineCoercion<I extends SlimPrimitiveKind, O extends SlimPrimi
  */
 declare const defaultCoercionRules: CoercionRegistry;
 
+/**
+ * Portable SSR detection. The plugin captures this value at install time and
+ * exposes it via the registry so every runtime branch reads a single source
+ * of truth instead of sniffing `import.meta.*` (bundler-specific) at each
+ * call site.
+ *
+ * Consumers can override explicitly via `createAttaform({ ssr: true })`;
+ * the default heuristic handles the common Node-vs-browser split without
+ * relying on any bundler-injected flag.
+ */
+interface SSRDetectOptions {
+    override?: boolean;
+}
+
 /**
  * Per-Vue-app container for all form state instances. Each
  * `app.use(createAttaform())` call gets its own registry,
@@ -223,6 +174,61 @@ declare function useRegistry(): AttaformRegistry;
  */
 declare function getRegistryFromApp(app: App): AttaformRegistry;
 
+/**
+ * Options for `createAttaform()`.
+ */
+type AttaformPluginOptions = SSRDetectOptions & {
+    /**
+     * Whether to install the Vue DevTools integration. Default `true`.
+     * The DevTools peer dependency is loaded lazily — in production
+     * builds where it's absent, the import fails silently and no
+     * extra bundle is shipped. Pass `false` to skip even attempting
+     * the import.
+     */
+    devtools?: boolean;
+    /**
+     * App-level defaults applied to every `useForm` call in this app.
+     * Per-form options always win. See `AttaformDefaults` for
+     * the supported option set and the merge rules.
+     *
+     * ```ts
+     * app.use(
+     *   createAttaform({
+     *     defaults: { debounceMs: 100 },
+     *   })
+     * )
+     * ```
+     */
+    defaults?: AttaformDefaults;
+};
+/**
+ * Create the Vue plugin that installs the form library on a Vue
+ * application. Required only when you want app-wide options
+ * (`defaults`, `devtools: false`, `ssr: true`) — for the default
+ * setup, `useForm` / `injectForm` / `useRegister` lazy-install the
+ * registry on first use.
+ *
+ * ```ts
+ * import { createApp } from 'vue'
+ * import { createAttaform } from 'attaform'
+ *
+ * createApp(App)
+ *   .use(createAttaform({ defaults: { debounceMs: 100 } }))
+ *   .mount('#app')
+ * ```
+ *
+ * Under SSR with bare Vue 3, install explicitly with `{ ssr: true }`
+ * from your server entry — the SSR serialization helpers
+ * (`renderAttaformState` / `hydrateAttaformState`) require an
+ * already-attached registry and don't trigger lazy install. Under
+ * Nuxt, install via `attaform/nuxt` instead — the Nuxt module wires
+ * both server and client automatically.
+ *
+ * Installing more than once on the same app is a no-op (the second
+ * call logs a dev-mode warning).
+ */
+declare function createAttaform(options?: AttaformPluginOptions): Plugin;
+
 /**
  * Serialised snapshot of every form in a Vue app, produced by
  * `renderAttaformState` and consumed by `hydrateAttaformState`.
@@ -305,10 +311,9 @@ declare function escapeForInlineScript(json: string): string;
  * })
  * ```
  *
- * Most consumers prefer a typed entry point — e.g.
- * `attaform/zod` (v4) or `attaform/zod-v3` —
- * which wrap the underlying library's schema with the matching
- * adapter automatically.
+ * 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.

package/dist/index.d.mts

@@ -1,71 +1,8 @@
-import { Plugin, App, InjectionKey } from 'vue';
-import { A as AttaformDefaults, C as CoercionRegistry, S as SlimPrimitiveKind, a as CoercionEntry, F as FormKey, G as GenericForm, U as UseFormConfiguration, b as AbstractSchema, D as DeepPartial, c as DefaultValuesShape, d as UseFormReturnType, R as RegisterValue, e as RegisterModelDynamicCustomDirective, V as ValidationError, f as ApiErrorEnvelope, g as ApiErrorDetails } from './shared/attaform.0Gxd_OOx.mjs';
+import { App, InjectionKey, Plugin } from 'vue';
+import { C as CoercionRegistry, S as SlimPrimitiveKind, a as CoercionEntry, A as AttaformDefaults, F as FormKey, G as GenericForm, U as UseFormConfiguration, b as AbstractSchema, D as DeepPartial, c as DefaultValuesShape, d as UseFormReturnType, R as RegisterValue, e as RegisterModelDynamicCustomDirective, V as ValidationError, f as ApiErrorEnvelope, g as ApiErrorDetails } from './shared/attaform.0Gxd_OOx.mjs';
 export { h as ApiErrorEntry, i as ArrayItem, j as ArrayPath, k as CoercionResult, l as CustomDirectiveRegisterAssignerFn, m as DefaultValuesResponse, n as FieldMetaPayload, o as FieldState, p as FieldStateMap, q as FieldStateMapEntry, r as FlatPath, s as FormErrorRecord, t as FormErrorsSurface, u as FormMeta, v as FormStorage, w as FormStorageKind, H as HandleSubmit, x as HistoryConfig, I as IsTuple, y as IsUnion, J as JoinSegments, K as KeyofUnion, L as LiftedValueShape, M as MetaTrackerValue, N as NestedReadType, z as NestedType, O as OnError, B as OnInvalidSubmitPolicy, E as OnSubmit, P as Path, Q as PathKey, T as PendingValidationStatus, W as PersistConfig, X as PersistConfigOptions, Y as PersistIncludeMode, Z as ROOT_PATH, _ as ROOT_PATH_KEY, $ as ReactiveValidationStatus, a0 as RegisterDirective, a1 as RegisterFlatPath, a2 as RegisterOptions, a3 as RegisterSelectModifier, a4 as RegisterTextModifier, a5 as RegisterTransform, a6 as Segment, a7 as SetValueCallback, a8 as SetValuePayload, a9 as SettledValidationStatus, aa as SlimRuntimeOf, ab as SubmitHandler, ac as Unset, ad as ValidateOn, ae as ValidateOnConfig, af as ValidationResponse, ag as ValidationResponseWithoutValue, ah as ValueOfUnion, ai as WriteMeta, aj as WriteShape, ak as canonicalizePath, al as isPathPrefix, am as isUnset, an as parseDottedPath, ao as unset } from './shared/attaform.0Gxd_OOx.mjs';
-export { A as AttaformErrorCode, i as injectForm, u as useRegister } from './shared/attaform.CPx7zTgS.mjs';
-export { A as AnonPersistError, a as AttaformError, I as InvalidPathError, O as OutsideSetupError, R as RegistryNotInstalledError, b as ReservedFormKeyError, S as SensitivePersistFieldError, c as SubmitErrorHandlerError } from './shared/attaform.BwaYWtMs.mjs';
-
-/**
- * Portable SSR detection. The plugin captures this value at install time and
- * exposes it via the registry so every runtime branch reads a single source
- * of truth instead of sniffing `import.meta.*` (bundler-specific) at each
- * call site.
- *
- * Consumers can override explicitly via `createAttaform({ ssr: true })`;
- * the default heuristic handles the common Node-vs-browser split without
- * relying on any bundler-injected flag.
- */
-interface SSRDetectOptions {
-    override?: boolean;
-}
-
-/**
- * Options for `createAttaform()`.
- */
-type AttaformPluginOptions = SSRDetectOptions & {
-    /**
-     * Whether to install the Vue DevTools integration. Default `true`.
-     * The DevTools peer dependency is loaded lazily — in production
-     * builds where it's absent, the import fails silently and no
-     * extra bundle is shipped. Pass `false` to skip even attempting
-     * the import.
-     */
-    devtools?: boolean;
-    /**
-     * App-level defaults applied to every `useForm` call in this app.
-     * Per-form options always win. See `AttaformDefaults` for
-     * the supported option set and the merge rules.
-     *
-     * ```ts
-     * app.use(
-     *   createAttaform({
-     *     defaults: { debounceMs: 100 },
-     *   })
-     * )
-     * ```
-     */
-    defaults?: AttaformDefaults;
-};
-/**
- * Create the Vue plugin that installs the form library on a Vue
- * application. Call once per app, then `app.use(...)` the result.
- *
- * ```ts
- * import { createApp } from 'vue'
- * import { createAttaform } from 'attaform'
- *
- * createApp(App)
- *   .use(createAttaform())
- *   .mount('#app')
- * ```
- *
- * Under SSR with bare Vue 3, pass `{ ssr: true }` from your server
- * entry. Under Nuxt, install via `attaform/nuxt` instead —
- * the Nuxt module wires both server and client automatically.
- *
- * Installing more than once on the same app is a no-op (the second
- * call logs a dev-mode warning).
- */
-declare function createAttaform(options?: AttaformPluginOptions): Plugin;
+export { A as AttaformErrorCode, i as injectForm, u as useRegister } from './shared/attaform.CVv9Oh0a.mjs';
+export { A as AnonPersistError, a as AttaformError, I as InvalidPathError, b as InvalidUseFormConfigError, O as OutsideSetupError, R as RegistryNotInstalledError, c as ReservedFormKeyError, S as SensitivePersistFieldError, d as SubmitErrorHandlerError } from './shared/attaform.B7rzpK1U.mjs';
 
 /**
  * Schema-driven coercion of user-typed DOM values at the v-register
@@ -110,6 +47,20 @@ declare function defineCoercion<I extends SlimPrimitiveKind, O extends SlimPrimi
  */
 declare const defaultCoercionRules: CoercionRegistry;
 
+/**
+ * Portable SSR detection. The plugin captures this value at install time and
+ * exposes it via the registry so every runtime branch reads a single source
+ * of truth instead of sniffing `import.meta.*` (bundler-specific) at each
+ * call site.
+ *
+ * Consumers can override explicitly via `createAttaform({ ssr: true })`;
+ * the default heuristic handles the common Node-vs-browser split without
+ * relying on any bundler-injected flag.
+ */
+interface SSRDetectOptions {
+    override?: boolean;
+}
+
 /**
  * Per-Vue-app container for all form state instances. Each
  * `app.use(createAttaform())` call gets its own registry,
@@ -223,6 +174,61 @@ declare function useRegistry(): AttaformRegistry;
  */
 declare function getRegistryFromApp(app: App): AttaformRegistry;
 
+/**
+ * Options for `createAttaform()`.
+ */
+type AttaformPluginOptions = SSRDetectOptions & {
+    /**
+     * Whether to install the Vue DevTools integration. Default `true`.
+     * The DevTools peer dependency is loaded lazily — in production
+     * builds where it's absent, the import fails silently and no
+     * extra bundle is shipped. Pass `false` to skip even attempting
+     * the import.
+     */
+    devtools?: boolean;
+    /**
+     * App-level defaults applied to every `useForm` call in this app.
+     * Per-form options always win. See `AttaformDefaults` for
+     * the supported option set and the merge rules.
+     *
+     * ```ts
+     * app.use(
+     *   createAttaform({
+     *     defaults: { debounceMs: 100 },
+     *   })
+     * )
+     * ```
+     */
+    defaults?: AttaformDefaults;
+};
+/**
+ * Create the Vue plugin that installs the form library on a Vue
+ * application. Required only when you want app-wide options
+ * (`defaults`, `devtools: false`, `ssr: true`) — for the default
+ * setup, `useForm` / `injectForm` / `useRegister` lazy-install the
+ * registry on first use.
+ *
+ * ```ts
+ * import { createApp } from 'vue'
+ * import { createAttaform } from 'attaform'
+ *
+ * createApp(App)
+ *   .use(createAttaform({ defaults: { debounceMs: 100 } }))
+ *   .mount('#app')
+ * ```
+ *
+ * Under SSR with bare Vue 3, install explicitly with `{ ssr: true }`
+ * from your server entry — the SSR serialization helpers
+ * (`renderAttaformState` / `hydrateAttaformState`) require an
+ * already-attached registry and don't trigger lazy install. Under
+ * Nuxt, install via `attaform/nuxt` instead — the Nuxt module wires
+ * both server and client automatically.
+ *
+ * Installing more than once on the same app is a no-op (the second
+ * call logs a dev-mode warning).
+ */
+declare function createAttaform(options?: AttaformPluginOptions): Plugin;
+
 /**
  * Serialised snapshot of every form in a Vue app, produced by
  * `renderAttaformState` and consumed by `hydrateAttaformState`.
@@ -305,10 +311,9 @@ declare function escapeForInlineScript(json: string): string;
  * })
  * ```
  *
- * Most consumers prefer a typed entry point — e.g.
- * `attaform/zod` (v4) or `attaform/zod-v3` —
- * which wrap the underlying library's schema with the matching
- * adapter automatically.
+ * 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.

package/dist/index.d.ts

@@ -1,71 +1,8 @@
-import { Plugin, App, InjectionKey } from 'vue';
-import { A as AttaformDefaults, C as CoercionRegistry, S as SlimPrimitiveKind, a as CoercionEntry, F as FormKey, G as GenericForm, U as UseFormConfiguration, b as AbstractSchema, D as DeepPartial, c as DefaultValuesShape, d as UseFormReturnType, R as RegisterValue, e as RegisterModelDynamicCustomDirective, V as ValidationError, f as ApiErrorEnvelope, g as ApiErrorDetails } from './shared/attaform.0Gxd_OOx.js';
+import { App, InjectionKey, Plugin } from 'vue';
+import { C as CoercionRegistry, S as SlimPrimitiveKind, a as CoercionEntry, A as AttaformDefaults, F as FormKey, G as GenericForm, U as UseFormConfiguration, b as AbstractSchema, D as DeepPartial, c as DefaultValuesShape, d as UseFormReturnType, R as RegisterValue, e as RegisterModelDynamicCustomDirective, V as ValidationError, f as ApiErrorEnvelope, g as ApiErrorDetails } from './shared/attaform.0Gxd_OOx.js';
 export { h as ApiErrorEntry, i as ArrayItem, j as ArrayPath, k as CoercionResult, l as CustomDirectiveRegisterAssignerFn, m as DefaultValuesResponse, n as FieldMetaPayload, o as FieldState, p as FieldStateMap, q as FieldStateMapEntry, r as FlatPath, s as FormErrorRecord, t as FormErrorsSurface, u as FormMeta, v as FormStorage, w as FormStorageKind, H as HandleSubmit, x as HistoryConfig, I as IsTuple, y as IsUnion, J as JoinSegments, K as KeyofUnion, L as LiftedValueShape, M as MetaTrackerValue, N as NestedReadType, z as NestedType, O as OnError, B as OnInvalidSubmitPolicy, E as OnSubmit, P as Path, Q as PathKey, T as PendingValidationStatus, W as PersistConfig, X as PersistConfigOptions, Y as PersistIncludeMode, Z as ROOT_PATH, _ as ROOT_PATH_KEY, $ as ReactiveValidationStatus, a0 as RegisterDirective, a1 as RegisterFlatPath, a2 as RegisterOptions, a3 as RegisterSelectModifier, a4 as RegisterTextModifier, a5 as RegisterTransform, a6 as Segment, a7 as SetValueCallback, a8 as SetValuePayload, a9 as SettledValidationStatus, aa as SlimRuntimeOf, ab as SubmitHandler, ac as Unset, ad as ValidateOn, ae as ValidateOnConfig, af as ValidationResponse, ag as ValidationResponseWithoutValue, ah as ValueOfUnion, ai as WriteMeta, aj as WriteShape, ak as canonicalizePath, al as isPathPrefix, am as isUnset, an as parseDottedPath, ao as unset } from './shared/attaform.0Gxd_OOx.js';
-export { A as AttaformErrorCode, i as injectForm, u as useRegister } from './shared/attaform.riAENZQM.js';
-export { A as AnonPersistError, a as AttaformError, I as InvalidPathError, O as OutsideSetupError, R as RegistryNotInstalledError, b as ReservedFormKeyError, S as SensitivePersistFieldError, c as SubmitErrorHandlerError } from './shared/attaform.BwaYWtMs.js';
-
-/**
- * Portable SSR detection. The plugin captures this value at install time and
- * exposes it via the registry so every runtime branch reads a single source
- * of truth instead of sniffing `import.meta.*` (bundler-specific) at each
- * call site.
- *
- * Consumers can override explicitly via `createAttaform({ ssr: true })`;
- * the default heuristic handles the common Node-vs-browser split without
- * relying on any bundler-injected flag.
- */
-interface SSRDetectOptions {
-    override?: boolean;
-}
-
-/**
- * Options for `createAttaform()`.
- */
-type AttaformPluginOptions = SSRDetectOptions & {
-    /**
-     * Whether to install the Vue DevTools integration. Default `true`.
-     * The DevTools peer dependency is loaded lazily — in production
-     * builds where it's absent, the import fails silently and no
-     * extra bundle is shipped. Pass `false` to skip even attempting
-     * the import.
-     */
-    devtools?: boolean;
-    /**
-     * App-level defaults applied to every `useForm` call in this app.
-     * Per-form options always win. See `AttaformDefaults` for
-     * the supported option set and the merge rules.
-     *
-     * ```ts
-     * app.use(
-     *   createAttaform({
-     *     defaults: { debounceMs: 100 },
-     *   })
-     * )
-     * ```
-     */
-    defaults?: AttaformDefaults;
-};
-/**
- * Create the Vue plugin that installs the form library on a Vue
- * application. Call once per app, then `app.use(...)` the result.
- *
- * ```ts
- * import { createApp } from 'vue'
- * import { createAttaform } from 'attaform'
- *
- * createApp(App)
- *   .use(createAttaform())
- *   .mount('#app')
- * ```
- *
- * Under SSR with bare Vue 3, pass `{ ssr: true }` from your server
- * entry. Under Nuxt, install via `attaform/nuxt` instead —
- * the Nuxt module wires both server and client automatically.
- *
- * Installing more than once on the same app is a no-op (the second
- * call logs a dev-mode warning).
- */
-declare function createAttaform(options?: AttaformPluginOptions): Plugin;
+export { A as AttaformErrorCode, i as injectForm, u as useRegister } from './shared/attaform.CWCx2r0x.js';
+export { A as AnonPersistError, a as AttaformError, I as InvalidPathError, b as InvalidUseFormConfigError, O as OutsideSetupError, R as RegistryNotInstalledError, c as ReservedFormKeyError, S as SensitivePersistFieldError, d as SubmitErrorHandlerError } from './shared/attaform.B7rzpK1U.js';
 
 /**
  * Schema-driven coercion of user-typed DOM values at the v-register
@@ -110,6 +47,20 @@ declare function defineCoercion<I extends SlimPrimitiveKind, O extends SlimPrimi
  */
 declare const defaultCoercionRules: CoercionRegistry;
 
+/**
+ * Portable SSR detection. The plugin captures this value at install time and
+ * exposes it via the registry so every runtime branch reads a single source
+ * of truth instead of sniffing `import.meta.*` (bundler-specific) at each
+ * call site.
+ *
+ * Consumers can override explicitly via `createAttaform({ ssr: true })`;
+ * the default heuristic handles the common Node-vs-browser split without
+ * relying on any bundler-injected flag.
+ */
+interface SSRDetectOptions {
+    override?: boolean;
+}
+
 /**
  * Per-Vue-app container for all form state instances. Each
  * `app.use(createAttaform())` call gets its own registry,
@@ -223,6 +174,61 @@ declare function useRegistry(): AttaformRegistry;
  */
 declare function getRegistryFromApp(app: App): AttaformRegistry;
 
+/**
+ * Options for `createAttaform()`.
+ */
+type AttaformPluginOptions = SSRDetectOptions & {
+    /**
+     * Whether to install the Vue DevTools integration. Default `true`.
+     * The DevTools peer dependency is loaded lazily — in production
+     * builds where it's absent, the import fails silently and no
+     * extra bundle is shipped. Pass `false` to skip even attempting
+     * the import.
+     */
+    devtools?: boolean;
+    /**
+     * App-level defaults applied to every `useForm` call in this app.
+     * Per-form options always win. See `AttaformDefaults` for
+     * the supported option set and the merge rules.
+     *
+     * ```ts
+     * app.use(
+     *   createAttaform({
+     *     defaults: { debounceMs: 100 },
+     *   })
+     * )
+     * ```
+     */
+    defaults?: AttaformDefaults;
+};
+/**
+ * Create the Vue plugin that installs the form library on a Vue
+ * application. Required only when you want app-wide options
+ * (`defaults`, `devtools: false`, `ssr: true`) — for the default
+ * setup, `useForm` / `injectForm` / `useRegister` lazy-install the
+ * registry on first use.
+ *
+ * ```ts
+ * import { createApp } from 'vue'
+ * import { createAttaform } from 'attaform'
+ *
+ * createApp(App)
+ *   .use(createAttaform({ defaults: { debounceMs: 100 } }))
+ *   .mount('#app')
+ * ```
+ *
+ * Under SSR with bare Vue 3, install explicitly with `{ ssr: true }`
+ * from your server entry — the SSR serialization helpers
+ * (`renderAttaformState` / `hydrateAttaformState`) require an
+ * already-attached registry and don't trigger lazy install. Under
+ * Nuxt, install via `attaform/nuxt` instead — the Nuxt module wires
+ * both server and client automatically.
+ *
+ * Installing more than once on the same app is a no-op (the second
+ * call logs a dev-mode warning).
+ */
+declare function createAttaform(options?: AttaformPluginOptions): Plugin;
+
 /**
  * Serialised snapshot of every form in a Vue app, produced by
  * `renderAttaformState` and consumed by `hydrateAttaformState`.
@@ -305,10 +311,9 @@ declare function escapeForInlineScript(json: string): string;
  * })
  * ```
  *
- * Most consumers prefer a typed entry point — e.g.
- * `attaform/zod` (v4) or `attaform/zod-v3` —
- * which wrap the underlying library's schema with the matching
- * adapter automatically.
+ * 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.

package/dist/index.mjs

@@ -1,9 +1,9 @@
-export { a as assignKey, c as createAttaform, h as hydrateAttaformState, i as isRegisterValue, r as renderAttaformState, v as vRegister } from './shared/attaform.CRk8NhlD.mjs';
-import { I as InvalidPathError } from './shared/attaform.a99dQV7Q.mjs';
-export { A as AnonPersistError, a as AttaformError, O as OutsideSetupError, R as RegistryNotInstalledError, b as ReservedFormKeyError, S as SensitivePersistFieldError, c as SubmitErrorHandlerError, d as createRegistry, g as getRegistryFromApp, k as kAttaformRegistry, u as useRegister, e as useRegistry } from './shared/attaform.a99dQV7Q.mjs';
-export { A as AttaformErrorCode, d as defaultCoercionRules, a as defineCoercion, i as injectForm, b as isUnset, u as unset, c as useForm } from './shared/attaform.qxyip_aN.mjs';
-import { c as canonicalizePath } from './shared/attaform.DXye3JKf.mjs';
-export { R as ROOT_PATH, a as ROOT_PATH_KEY, i as isPathPrefix, p as parseDottedPath } from './shared/attaform.DXye3JKf.mjs';
+import { I as InvalidPathError } from './shared/attaform.BfMxsfmE.mjs';
+export { A as AnonPersistError, a as AttaformError, b as InvalidUseFormConfigError, O as OutsideSetupError, R as RegistryNotInstalledError, d as ReservedFormKeyError, S as SensitivePersistFieldError, e as SubmitErrorHandlerError, f as assignKey, c as createAttaform, h as createRegistry, g as getRegistryFromApp, j as isRegisterValue, k as kAttaformRegistry, u as useRegister, l as useRegistry, v as vRegister } from './shared/attaform.BfMxsfmE.mjs';
+export { h as hydrateAttaformState, r as renderAttaformState } from './shared/attaform.CINUMjPq.mjs';
+export { A as AttaformErrorCode, d as defaultCoercionRules, b as defineCoercion, i as injectForm, a as isUnset, u as unset, c as useForm } from './shared/attaform.DILbdvfo.mjs';
+import { c as canonicalizePath } from './shared/attaform.jrxE_xZw.mjs';
+export { R as ROOT_PATH, a as ROOT_PATH_KEY, i as isPathPrefix, p as parseDottedPath } from './shared/attaform.jrxE_xZw.mjs';
 
 function escapeForInlineScript(json) {
   return json.replace(/[<>&\u2028\u2029]/g, (char) => {

package/dist/nuxt.cjs

@@ -3,7 +3,7 @@
 const node_path = require('node:path');
 const node_url = require('node:url');
 const kit = require('@nuxt/kit');
-const vRegisterPreambleTransform = require('./shared/attaform.Bubm_slq.cjs');
+const vite = require('./vite.cjs');
 
 var _documentCurrentScript = typeof document !== 'undefined' ? document.currentScript : null;
 function isResolvableForVite(specifier, consumerRootDir) {
@@ -28,20 +28,14 @@ var nuxt_default = kit.defineNuxtModule({
   },
   defaults: {},
   setup(_options, nuxt) {
-    var _a, _b, _c;
-    (_a = nuxt.options.vue.compilerOptions).nodeTransforms ?? (_a.nodeTransforms = []);
-    nuxt.options.vue.compilerOptions.nodeTransforms.push(
-      vRegisterPreambleTransform.selectNodeTransform,
-      vRegisterPreambleTransform.inputTextAreaNodeTransform,
-      vRegisterPreambleTransform.vRegisterPreambleTransform,
-      vRegisterPreambleTransform.vRegisterHintTransform
-    );
+    var _a, _b;
+    kit.addVitePlugin(vite.attaform({ resolveZodAlias: _options.resolveZodAlias !== false }));
     const runtimePublic = nuxt.options.runtimeConfig.public;
     runtimePublic["attaform"] = {
       defaults: _options.defaults ?? {}
     };
-    (_b = nuxt.options.vite).optimizeDeps ?? (_b.optimizeDeps = {});
-    (_c = nuxt.options.vite.optimizeDeps).include ?? (_c.include = []);
+    (_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;

package/dist/nuxt.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"nuxt.cjs","sources":["../src/nuxt.ts"],"sourcesContent":["import { join } from 'node:path'\nimport { pathToFileURL } from 'node:url'\nimport { addImports, addPlugin, addTypeTemplate, createResolver, defineNuxtModule } from '@nuxt/kit'\nimport { inputTextAreaNodeTransform } from './runtime/lib/core/transforms/input-text-area-transform'\nimport { selectNodeTransform } from './runtime/lib/core/transforms/select-transform'\nimport { vRegisterHintTransform } from './runtime/lib/core/transforms/v-register-hint-transform'\nimport { vRegisterPreambleTransform } from './runtime/lib/core/transforms/v-register-preamble-transform'\nimport type { AttaformDefaults } from './runtime/types/types-api'\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\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\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    compatibility: {\n      nuxt: '>=3.0.0',\n    },\n  },\n  defaults: {},\n  setup(_options, nuxt) {\n    // vRegisterPreambleTransform MUST come before vRegisterHintTransform\n    // — see src/vite.ts for the ordering rationale.\n    nuxt.options.vue.compilerOptions.nodeTransforms ??= []\n    nuxt.options.vue.compilerOptions.nodeTransforms.push(\n      selectNodeTransform,\n      inputTextAreaNodeTransform,\n      vRegisterPreambleTransform,\n      vRegisterHintTransform\n    )\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    } 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 `/zod` and `/zod-v3` adapter peer). 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 `useForm` — the framework-agnostic core composable (same\n    // binding as `attaform`'s top-level `useForm` export, which\n    // is the abstract form composable). Consumers who want the zod-typed\n    // wrapper must import from `attaform/zod` or `/zod-v3`\n    // explicitly.\n    //\n    // We point at the public package entry rather than a relative\n    // `./runtime/…` path on purpose: in the published package the\n    // `src/runtime/composables/use-abstract-form` path has no matching\n    // `dist/runtime/…` file (build.config's entries don't include it),\n    // so a `resolver.resolve(...)` would raise ENOENT at Nuxt's auto-\n    // import step. Importing from `attaform` resolves through\n    // the shared chunk, identical to what `attaform/zod`\n    // consumers bundle — single registry instance across both import\n    // surfaces.\n    addImports([{ name: 'useForm', from: 'attaform' }])\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    // v-register directive type. The directive itself is globally\n    // registered by `createAttaform().install(app)` in the plugin\n    // above; this template only publishes the type so that\n    // `<input v-register=\"…\">` type-checks in consumer SFCs.\n    addTypeTemplate({\n      filename: 'types/v-register.d.ts',\n      getContents: () => `// Generated by attaform\nimport type { ObjectDirective } from \"vue\"\nimport type { RegisterDirective } from \"attaform/types\"\n\ndeclare module \"vue\" {\n  interface GlobalDirectives {\n    /**\n     * The \\`v-register\\` directive. Binds a form field to a native\n     * input, select, textarea, checkbox, or radio:\n     *\n     * \\`\\`\\`vue\n     * <input v-register=\"form.register('email')\" />\n     * \\`\\`\\`\n     *\n     * Also works on custom components whose root is NOT a native\n     * input — call \\`useRegister()\\` in the child's setup to read\n     * the parent's binding, then re-bind \\`v-register\\` onto an\n     * inner native element. (When the wrapper's root IS the input\n     * itself, attribute fallthrough handles it; \\`useRegister\\` is\n     * unnecessary.) See \\`RegisterDirective\\` for the full\n     * non-input-root example.\n     *\n     * Modifier support varies by element:\n     *   - text / number / textarea: \\`.lazy\\`, \\`.trim\\`, \\`.number\\`\n     *   - select: \\`.number\\`\n     *   - checkbox / radio: none\n     *\n     * See \\`RegisterDirective\\` for full usage and per-modifier\n     * semantics.\n     */\n    vRegister: RegisterDirective\n  }\n}\n\nexport { }`,\n    })\n  },\n})\n"],"names":["pathToFileURL","join","defineNuxtModule","selectNodeTransform","inputTextAreaNodeTransform","vRegisterPreambleTransform","vRegisterHintTransform","createResolver","addImports","addPlugin","addTypeTemplate"],"mappings":";;;;;;;;AAkEA,SAAS,mBAAA,CAAoB,WAAmB,eAAA,EAAkC;AAChF,EAAA,MAAM,cAAcA,sBAAA,CAAcC,cAAA,CAAK,eAAA,EAAiB,cAAc,CAAC,CAAA,CAAE,IAAA;AACzE,EAAA,OAAO,WAAW,SAAA,EAAW,WAAW,KAAK,UAAA,CAAW,SAAA,EAAW,0PAAe,CAAA;AACpF;AAEA,SAAS,UAAA,CAAW,WAAmB,OAAA,EAA0B;AAC/D,EAAA,IAAI;AACF,IAAA,SAAY,CAAQ,WAAW,OAAO,CAAA;AACtC,IAAA,OAAO,IAAA;AAAA,EACT,CAAA,CAAA,MAAQ;AACN,IAAA,OAAO,KAAA;AAAA,EACT;AACF;AAEA,IAAO,eAAQC,oBAAA,CAAwC;AAAA,EACrD,IAAA,EAAM;AAAA,IACJ,IAAA,EAAM,UAAA;AAAA,IACN,SAAA,EAAW,UAAA;AAAA,IACX,aAAA,EAAe;AAAA,MACb,IAAA,EAAM;AAAA;AACR,GACF;AAAA,EACA,UAAU,EAAC;AAAA,EACX,KAAA,CAAM,UAAU,IAAA,EAAM;AAzFxB,IAAA,IAAA,EAAA,EAAA,EAAA,EAAA,EAAA;AA4FI,IAAA,CAAA,EAAA,GAAA,IAAA,CAAK,QAAQ,GAAA,CAAI,eAAA,EAAgB,cAAA,KAAjC,EAAA,CAAiC,iBAAmB,EAAC,CAAA;AACrD,IAAA,IAAA,CAAK,OAAA,CAAQ,GAAA,CAAI,eAAA,CAAgB,cAAA,CAAe,IAAA;AAAA,MAC9CC,8CAAA;AAAA,MACAC,qDAAA;AAAA,MACAC,qDAAA;AAAA,MACAC;AAAA,KACF;AAMA,IAAA,MAAM,aAAA,GAAgB,IAAA,CAAK,OAAA,CAAQ,aAAA,CAAc,MAAA;AACjD,IAAA,aAAA,CAAc,UAAU,CAAA,GAAI;AAAA,MAC1B,QAAA,EAAU,QAAA,CAAS,QAAA,IAAY;AAAC,KAClC;AAuBA,IAAA,CAAA,EAAA,GAAA,IAAA,CAAK,OAAA,CAAQ,IAAA,EAAK,YAAA,KAAlB,EAAA,CAAkB,eAAiB,EAAC,CAAA;AACpC,IAAA,CAAA,EAAA,GAAA,IAAA,CAAK,QAAQ,IAAA,CAAK,YAAA,EAAa,OAAA,KAA/B,EAAA,CAA+B,UAAY,EAAC,CAAA;AAC5C,IAAA,MAAM,OAAA,GAAU,IAAA,CAAK,OAAA,CAAQ,IAAA,CAAK,YAAA,CAAa,OAAA;AAC/C,IAAA,KAAA,MAAW,IAAA,IAAQ,CAAC,mBAAA,EAAqB,KAAK,CAAA,EAAG;AAC/C,MAAA,IAAI,CAAC,mBAAA,CAAoB,IAAA,EAAM,IAAA,CAAK,OAAA,CAAQ,OAAO,CAAA,EAAG;AACtD,MAAA,IAAI,CAAC,OAAA,CAAQ,QAAA,CAAS,IAAI,CAAA,EAAG,OAAA,CAAQ,KAAK,IAAI,CAAA;AAAA,IAChD;AAEA,IAAA,MAAM,QAAA,GAAWC,kBAAA,CAAe,0PAAe,CAAA;AAiB/C,IAAAC,cAAA,CAAW,CAAC,EAAE,IAAA,EAAM,WAAW,IAAA,EAAM,UAAA,EAAY,CAAC,CAAA;AAsBlD,IAAAC,aAAA,CAAU;AAAA,MACR,GAAA,EAAK,QAAA,CAAS,OAAA,CAAQ,4BAA4B;AAAA,KACnD,CAAA;AAMD,IAAAC,mBAAA,CAAgB;AAAA,MACd,QAAA,EAAU,uBAAA;AAAA,MACV,aAAa,MAAM,CAAA;AAAA;AAAA;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;AAAA,UAAA;AAAA,KAmCpB,CAAA;AAAA,EACH;AACF,CAAC;;;;"}
+{"version":3,"file":"nuxt.cjs","sources":["../src/nuxt.ts"],"sourcesContent":["import { join } from 'node:path'\nimport { pathToFileURL } from 'node:url'\nimport {\n  addImports,\n  addPlugin,\n  addTypeTemplate,\n  addVitePlugin,\n  createResolver,\n  defineNuxtModule,\n} from '@nuxt/kit'\nimport type { AttaformDefaults } from './runtime/types/types-api'\nimport { attaform as attaformVitePlugin } from './vite'\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/zod` imports are rewritten at build\n   * time to either `attaform/zod-v3` or `attaform/zod-v4`, based on\n   * 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\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\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    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    } 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 `useForm` — the framework-agnostic core composable (same\n    // binding as `attaform`'s top-level `useForm` export, which\n    // is the abstract form composable). Consumers who want the zod-typed\n    // wrapper must import from `attaform/zod` or `/zod-v3`\n    // explicitly.\n    //\n    // We point at the public package entry rather than a relative\n    // `./runtime/…` path on purpose: in the published package the\n    // `src/runtime/composables/use-abstract-form` path has no matching\n    // `dist/runtime/…` file (build.config's entries don't include it),\n    // so a `resolver.resolve(...)` would raise ENOENT at Nuxt's auto-\n    // import step. Importing from `attaform` resolves through\n    // the shared chunk, identical to what `attaform/zod`\n    // consumers bundle — single registry instance across both import\n    // surfaces.\n    addImports([{ name: 'useForm', from: 'attaform' }])\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    // v-register directive type. The directive itself is globally\n    // registered by `createAttaform().install(app)` in the plugin\n    // above; this template only publishes the type so that\n    // `<input v-register=\"…\">` type-checks in consumer SFCs.\n    addTypeTemplate({\n      filename: 'types/v-register.d.ts',\n      getContents: () => `// Generated by attaform\nimport type { ObjectDirective } from \"vue\"\nimport type { RegisterDirective } from \"attaform/types\"\n\ndeclare module \"vue\" {\n  interface GlobalDirectives {\n    /**\n     * The \\`v-register\\` directive. Binds a form field to a native\n     * input, select, textarea, checkbox, or radio:\n     *\n     * \\`\\`\\`vue\n     * <input v-register=\"form.register('email')\" />\n     * \\`\\`\\`\n     *\n     * Also works on custom components whose root is NOT a native\n     * input — call \\`useRegister()\\` in the child's setup to read\n     * the parent's binding, then re-bind \\`v-register\\` onto an\n     * inner native element. (When the wrapper's root IS the input\n     * itself, attribute fallthrough handles it; \\`useRegister\\` is\n     * unnecessary.) See \\`RegisterDirective\\` for the full\n     * non-input-root example.\n     *\n     * Modifier support varies by element:\n     *   - text / number / textarea: \\`.lazy\\`, \\`.trim\\`, \\`.number\\`\n     *   - select: \\`.number\\`\n     *   - checkbox / radio: none\n     *\n     * See \\`RegisterDirective\\` for full usage and per-modifier\n     * semantics.\n     */\n    vRegister: RegisterDirective\n  }\n}\n\nexport { }`,\n    })\n  },\n})\n"],"names":["pathToFileURL","join","defineNuxtModule","addVitePlugin","attaformVitePlugin","createResolver","addImports","addPlugin","addTypeTemplate"],"mappings":";;;;;;;;AA8EA,SAAS,mBAAA,CAAoB,WAAmB,eAAA,EAAkC;AAChF,EAAA,MAAM,cAAcA,sBAAA,CAAcC,cAAA,CAAK,eAAA,EAAiB,cAAc,CAAC,CAAA,CAAE,IAAA;AACzE,EAAA,OAAO,WAAW,SAAA,EAAW,WAAW,KAAK,UAAA,CAAW,SAAA,EAAW,0PAAe,CAAA;AACpF;AAEA,SAAS,UAAA,CAAW,WAAmB,OAAA,EAA0B;AAC/D,EAAA,IAAI;AACF,IAAA,SAAY,CAAQ,WAAW,OAAO,CAAA;AACtC,IAAA,OAAO,IAAA;AAAA,EACT,CAAA,CAAA,MAAQ;AACN,IAAA,OAAO,KAAA;AAAA,EACT;AACF;AAEA,IAAO,eAAQC,oBAAA,CAAwC;AAAA,EACrD,IAAA,EAAM;AAAA,IACJ,IAAA,EAAM,UAAA;AAAA,IACN,SAAA,EAAW,UAAA;AAAA,IACX,aAAA,EAAe;AAAA,MACb,IAAA,EAAM;AAAA;AACR,GACF;AAAA,EACA,UAAU,EAAC;AAAA,EACX,KAAA,CAAM,UAAU,IAAA,EAAM;AArGxB,IAAA,IAAA,EAAA,EAAA,EAAA;AA+GI,IAAAC,iBAAA,CAAcC,cAAmB,EAAE,eAAA,EAAiB,SAAS,eAAA,KAAoB,KAAA,EAAO,CAAC,CAAA;AAMzF,IAAA,MAAM,aAAA,GAAgB,IAAA,CAAK,OAAA,CAAQ,aAAA,CAAc,MAAA;AACjD,IAAA,aAAA,CAAc,UAAU,CAAA,GAAI;AAAA,MAC1B,QAAA,EAAU,QAAA,CAAS,QAAA,IAAY;AAAC,KAClC;AAwBA,IAAA,CAAA,EAAA,GAAA,IAAA,CAAK,OAAA,CAAQ,IAAA,EAAK,YAAA,KAAlB,EAAA,CAAkB,eAAiB,EAAC,CAAA;AACpC,IAAA,CAAA,EAAA,GAAA,IAAA,CAAK,QAAQ,IAAA,CAAK,YAAA,EAAa,OAAA,KAA/B,EAAA,CAA+B,UAAY,EAAC,CAAA;AAC5C,IAAA,MAAM,OAAA,GAAU,IAAA,CAAK,OAAA,CAAQ,IAAA,CAAK,YAAA,CAAa,OAAA;AAC/C,IAAA,KAAA,MAAW,IAAA,IAAQ,CAAC,mBAAA,EAAqB,KAAK,CAAA,EAAG;AAC/C,MAAA,IAAI,CAAC,mBAAA,CAAoB,IAAA,EAAM,IAAA,CAAK,OAAA,CAAQ,OAAO,CAAA,EAAG;AACtD,MAAA,IAAI,CAAC,OAAA,CAAQ,QAAA,CAAS,IAAI,CAAA,EAAG,OAAA,CAAQ,KAAK,IAAI,CAAA;AAAA,IAChD;AAEA,IAAA,MAAM,QAAA,GAAWC,kBAAA,CAAe,0PAAe,CAAA;AAiB/C,IAAAC,cAAA,CAAW,CAAC,EAAE,IAAA,EAAM,WAAW,IAAA,EAAM,UAAA,EAAY,CAAC,CAAA;AAsBlD,IAAAC,aAAA,CAAU;AAAA,MACR,GAAA,EAAK,QAAA,CAAS,OAAA,CAAQ,4BAA4B;AAAA,KACnD,CAAA;AAMD,IAAAC,mBAAA,CAAgB;AAAA,MACd,QAAA,EAAU,uBAAA;AAAA,MACV,aAAa,MAAM,CAAA;AAAA;AAAA;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;AAAA,UAAA;AAAA,KAmCpB,CAAA;AAAA,EACH;AACF,CAAC;;;;"}

package/dist/nuxt.d.cts

@@ -23,6 +23,14 @@ interface AttaformModuleOptions {
      * supported option set and merge rules.
      */
     defaults?: AttaformDefaults;
+    /**
+     * Forwarded to `attaform/vite`'s `resolveZodAlias` option.
+     * Default `true` — `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;
 }
 /**
  * Shape of the Nuxt public runtime-config slot the module populates.