attaform 0.15.0 → 0.16.0

package/dist/vite.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"vite.cjs","sources":["../src/vite.ts"],"sourcesContent":["/**\n * `attaform/vite` — Vite plugin that registers the compile-time\n * node transforms with @vitejs/plugin-vue.\n *\n * Usage (bare Vue 3 consumers):\n *\n *   // vite.config.ts\n *   import vue from '@vitejs/plugin-vue'\n *   import { attaform } from 'attaform/vite'\n *\n *   export default defineConfig({\n *     plugins: [vue(), attaform()],\n *   })\n *\n * The transforms inject `:value`, `:checked`, and `:selected` bindings into\n * elements that use the `v-register` directive — load-bearing for SSR\n * initial-render correctness. Omitting this plugin under CSR is tolerable\n * (one-frame flash on mount); omitting it under SSR produces visibly wrong\n * initial HTML.\n *\n * Implementation note: this plugin mutates @vitejs/plugin-vue's options via\n * the documented but somewhat informal `api.options` surface used by\n * VueUse, Vite PWA, and other Vue ecosystem plugins. If you're using a\n * custom Vue plugin wrapper, fall back to `attaform/transforms`\n * and wire them yourself.\n */\nimport type { Plugin } from 'vite'\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'\n\n/** Options for `attaform()`. Reserved for future use; pass `{}` or omit. */\nexport type AttaformVitePluginOptions = Record<string, never>\n\ninterface VitePluginVueApi {\n  options?: {\n    template?: {\n      compilerOptions?: {\n        nodeTransforms?: unknown[]\n      }\n    }\n  }\n}\n\n/**\n * Vite plugin that wires the form library's compile-time template\n * transforms into `@vitejs/plugin-vue`. Required for SSR and for\n * hydration accuracy under bare Vue 3.\n *\n * ```ts\n * // vite.config.ts\n * import vue from '@vitejs/plugin-vue'\n * import { attaform } from 'attaform/vite'\n *\n * export default defineConfig({\n *   plugins: [vue(), attaform()],\n * })\n * ```\n *\n * Place the call after `vue()` in the plugins array. Nuxt projects\n * don't need this — `attaform/nuxt` handles it.\n */\nexport function attaform(_options: AttaformVitePluginOptions = {}): Plugin {\n  // Unused-var suppression until options exist.\n  void _options\n  return {\n    name: 'attaform',\n    enforce: 'pre',\n    configResolved(resolved) {\n      const vuePlugin = resolved.plugins.find((p) => p.name === 'vite:vue')\n      // Two distinct failure modes — separate error messages so the\n      // consumer's fix is unambiguous:\n      //   1. plugin not in the plugins array → install + register vue()\n      //   2. plugin found but version-incompatible (no `api.options`) →\n      //      version mismatch with @vitejs/plugin-vue\n      if (vuePlugin === undefined) {\n        throw new Error(\n          '[attaform/vite] @vitejs/plugin-vue is not installed (or not registered before attaform()). ' +\n            'Install @vitejs/plugin-vue and place `attaform()` after `vue()` in your plugins array.'\n        )\n      }\n      const api = (vuePlugin as unknown as { api?: VitePluginVueApi }).api\n      if (api?.options === undefined) {\n        throw new Error(\n          '[attaform/vite] Found @vitejs/plugin-vue but it does not expose `api.options`. ' +\n            'This usually means a version-incompatible @vitejs/plugin-vue (or a wrapper plugin re-exporting it). ' +\n            'Pin @vitejs/plugin-vue to a version compatible with the documented `api.options.template.compilerOptions.nodeTransforms` surface.'\n        )\n      }\n      api.options.template ??= {}\n      api.options.template.compilerOptions ??= {}\n      const existing = api.options.template.compilerOptions.nodeTransforms ?? []\n      // Idempotent install: if a previous attaform() invocation\n      // (vite + nuxt module + manual `plugins: [attaform()]`) has\n      // already pushed our transforms, skip — re-pushing would double\n      // every binding the AST emits, breaking the IIFE-wrapping\n      // invariants downstream transforms depend on. We detect the\n      // sentinel via reference equality; user-supplied transforms with\n      // the same name don't collide.\n      if (existing.includes(vRegisterPreambleTransform as unknown)) return\n      // vRegisterPreambleTransform MUST come before vRegisterHintTransform\n      // — the preamble's pre-order captures each `v-register` expression\n      // in its raw (un-wrapped) form, and the hint then mutates the same\n      // directive's `exp` to wrap it. Reversing the order would have the\n      // preamble pick up an already-wrapped IIFE, double-wrapping it\n      // when injected at the root.\n      api.options.template.compilerOptions.nodeTransforms = [\n        ...existing,\n        selectNodeTransform,\n        inputTextAreaNodeTransform,\n        vRegisterPreambleTransform,\n        vRegisterHintTransform,\n      ]\n    },\n  }\n}\n"],"names":["vRegisterPreambleTransform","selectNodeTransform","inputTextAreaNodeTransform","vRegisterHintTransform"],"mappings":";;;;AA+DO,SAAS,QAAA,CAAS,QAAA,GAAsC,EAAC,EAAW;AAGzE,EAAA,OAAO;AAAA,IACL,IAAA,EAAM,UAAA;AAAA,IACN,OAAA,EAAS,KAAA;AAAA,IACT,eAAe,QAAA,EAAU;AArE7B,MAAA,IAAA,EAAA,EAAA,EAAA;AAsEM,MAAA,MAAM,SAAA,GAAY,SAAS,OAAA,CAAQ,IAAA,CAAK,CAAC,CAAA,KAAM,CAAA,CAAE,SAAS,UAAU,CAAA;AAMpE,MAAA,IAAI,cAAc,MAAA,EAAW;AAC3B,QAAA,MAAM,IAAI,KAAA;AAAA,UACR;AAAA,SAEF;AAAA,MACF;AACA,MAAA,MAAM,MAAO,SAAA,CAAoD,GAAA;AACjE,MAAA,IAAI,GAAA,EAAK,YAAY,MAAA,EAAW;AAC9B,QAAA,MAAM,IAAI,KAAA;AAAA,UACR;AAAA,SAGF;AAAA,MACF;AACA,MAAA,CAAA,EAAA,GAAA,GAAA,CAAI,OAAA,EAAQ,QAAA,KAAZ,EAAA,CAAY,QAAA,GAAa,EAAC,CAAA;AAC1B,MAAA,CAAA,EAAA,GAAA,GAAA,CAAI,OAAA,CAAQ,QAAA,EAAS,eAAA,KAArB,EAAA,CAAqB,kBAAoB,EAAC,CAAA;AAC1C,MAAA,MAAM,WAAW,GAAA,CAAI,OAAA,CAAQ,QAAA,CAAS,eAAA,CAAgB,kBAAkB,EAAC;AAQzE,MAAA,IAAI,QAAA,CAAS,QAAA,CAASA,qDAAqC,CAAA,EAAG;AAO9D,MAAA,GAAA,CAAI,OAAA,CAAQ,QAAA,CAAS,eAAA,CAAgB,cAAA,GAAiB;AAAA,QACpD,GAAG,QAAA;AAAA,QACHC,8CAAA;AAAA,QACAC,qDAAA;AAAA,QACAF,qDAAA;AAAA,QACAG;AAAA,OACF;AAAA,IACF;AAAA,GACF;AACF;;;;"}
+{"version":3,"file":"vite.cjs","sources":["../src/vite.ts"],"sourcesContent":["/**\n * `attaform/vite` — Vite plugin that wires the compile-time node\n * transforms with @vitejs/plugin-vue AND rewrites `attaform/zod`\n * imports to either `attaform/zod-v3` or `attaform/zod-v4` at build\n * time, based on the consumer's installed Zod major. The result is\n * one Zod adapter shipped per bundle, with no manual subpath choice.\n *\n * Usage (bare Vue 3 consumers):\n *\n *   // vite.config.ts\n *   import vue from '@vitejs/plugin-vue'\n *   import { attaform } from 'attaform/vite'\n *\n *   export default defineConfig({\n *     plugins: [vue(), attaform()],\n *   })\n *\n * The transforms inject `:value`, `:checked`, and `:selected` bindings\n * into elements that use the `v-register` directive — load-bearing for\n * SSR initial-render correctness. Omitting this plugin under CSR is\n * tolerable (one-frame flash on mount); omitting it under SSR produces\n * visibly wrong initial HTML.\n *\n * The `resolveZodAlias` option (default `true`) controls the build-time\n * `attaform/zod` rewrite. Set to `false` if your project intentionally\n * mixes Zod versions or has a non-standard Zod resolution; the unified\n * `attaform/zod` entry's runtime dispatch covers that case at the cost\n * of bundling both adapters.\n *\n * Implementation note: this plugin mutates @vitejs/plugin-vue's options\n * via the documented but somewhat informal `api.options` surface used\n * by VueUse, Vite PWA, and other Vue ecosystem plugins. If you're\n * using a custom Vue plugin wrapper, fall back to `attaform/transforms`\n * and wire them yourself.\n */\nimport { readFileSync } from 'node:fs'\nimport { fileURLToPath, pathToFileURL } from 'node:url'\nimport { join } from 'node:path'\nimport type { Plugin } from 'vite'\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'\n\n/** Options for `attaform()`. */\nexport interface AttaformVitePluginOptions {\n  /**\n   * Rewrite `attaform/zod` imports at build time to either\n   * `attaform/zod-v3` or `attaform/zod-v4`, based on the consumer's\n   * installed Zod major. Default `true` — produces a leaner bundle\n   * for the common case of one Zod version per project.\n   *\n   * Set to `false` to fall through to the unified entry's runtime\n   * dispatch. Useful when:\n   *   - your project intentionally has both `zod` and `zod-v3`\n   *     installed (e.g. via a pnpm alias) and the schema-shape\n   *     dispatch is the right behavior;\n   *   - your monorepo's Zod resolution is non-standard and the\n   *     plugin's detection (`import.meta.resolve('zod/package.json')`)\n   *     would land on the wrong copy.\n   */\n  resolveZodAlias?: boolean\n}\n\ninterface VitePluginVueApi {\n  options?: {\n    template?: {\n      compilerOptions?: {\n        nodeTransforms?: unknown[]\n      }\n    }\n  }\n}\n\nconst ZOD_UNIFIED_SPECIFIER = 'attaform/zod'\nconst ZOD_V3_SPECIFIER = 'attaform/zod-v3'\nconst ZOD_V4_SPECIFIER = 'attaform/zod-v4'\n\n/**\n * Read the consumer's installed Zod major by resolving\n * `zod/package.json` from their project root. ESM resolution\n * (`import.meta.resolve`) is sync and stable on Node 20.6+, follows\n * pnpm symlinks, and works with attaform's ESM-only `exports` map.\n *\n * Returns:\n *  - `{ major: 3 | 4 }` when zod is resolvable AND its `version`\n *    field parses to a known major;\n *  - `{ major: 'missing' }` when zod can't be resolved at all;\n *  - `{ major: 'unknown' }` for any other failure (corrupted\n *    package.json, unexpected version string, monorepo edge case).\n */\nfunction detectZodMajor(\n  consumerRootDir: string\n): { major: 3 } | { major: 4 } | { major: 'missing' } | { major: 'unknown' } {\n  const consumerURL = pathToFileURL(join(consumerRootDir, 'package.json')).href\n  let resolved: string\n  try {\n    resolved = import.meta.resolve('zod/package.json', consumerURL)\n  } catch {\n    return { major: 'missing' }\n  }\n  try {\n    const pkg = JSON.parse(readFileSync(fileURLToPath(resolved), 'utf8')) as { version?: unknown }\n    const version = pkg.version\n    if (typeof version !== 'string') return { major: 'unknown' }\n    const major = Number.parseInt(version.split('.')[0] ?? '', 10)\n    if (major === 3) return { major: 3 }\n    if (major === 4) return { major: 4 }\n    return { major: 'unknown' }\n  } catch {\n    return { major: 'unknown' }\n  }\n}\n\n/**\n * Vite plugin that wires the form library's compile-time template\n * transforms into `@vitejs/plugin-vue` and rewrites the unified\n * `attaform/zod` import to the matching adapter subpath. Required\n * for SSR and for hydration accuracy under bare Vue 3.\n *\n * ```ts\n * // vite.config.ts\n * import vue from '@vitejs/plugin-vue'\n * import { attaform } from 'attaform/vite'\n *\n * export default defineConfig({\n *   plugins: [vue(), attaform()],\n * })\n * ```\n *\n * Place the call after `vue()` in the plugins array. Nuxt projects\n * don't need this — `attaform/nuxt` handles it.\n */\nexport function attaform(options: AttaformVitePluginOptions = {}): Plugin {\n  const resolveZodAlias = options.resolveZodAlias !== false\n  // Resolution is computed once per plugin instance from the resolved\n  // Vite root in `configResolved`, then cached for every `resolveId`\n  // call (the hook fires many times during dev/build).\n  let aliasTarget: string | null = null\n  let warnedAboutDetection = false\n\n  return {\n    name: 'attaform',\n    enforce: 'pre',\n    configResolved(resolved) {\n      const vuePlugin = resolved.plugins.find((p) => p.name === 'vite:vue')\n      // Two distinct failure modes — separate error messages so the\n      // consumer's fix is unambiguous:\n      //   1. plugin not in the plugins array → install + register vue()\n      //   2. plugin found but version-incompatible (no `api.options`) →\n      //      version mismatch with @vitejs/plugin-vue\n      if (vuePlugin === undefined) {\n        throw new Error(\n          '[attaform/vite] @vitejs/plugin-vue is not installed (or not registered before attaform()). ' +\n            'Install @vitejs/plugin-vue and place `attaform()` after `vue()` in your plugins array.'\n        )\n      }\n      const api = (vuePlugin as unknown as { api?: VitePluginVueApi }).api\n      if (api?.options === undefined) {\n        throw new Error(\n          '[attaform/vite] Found @vitejs/plugin-vue but it does not expose `api.options`. ' +\n            'This usually means a version-incompatible @vitejs/plugin-vue (or a wrapper plugin re-exporting it). ' +\n            'Pin @vitejs/plugin-vue to a version compatible with the documented `api.options.template.compilerOptions.nodeTransforms` surface.'\n        )\n      }\n      api.options.template ??= {}\n      api.options.template.compilerOptions ??= {}\n      const existing = api.options.template.compilerOptions.nodeTransforms ?? []\n      // Idempotent install: if a previous attaform() invocation\n      // (vite + nuxt module + manual `plugins: [attaform()]`) has\n      // already pushed our transforms, skip — re-pushing would double\n      // every binding the AST emits, breaking the IIFE-wrapping\n      // invariants downstream transforms depend on. We detect the\n      // sentinel via reference equality; user-supplied transforms with\n      // the same name don't collide.\n      if (!existing.includes(vRegisterPreambleTransform as unknown)) {\n        // vRegisterPreambleTransform MUST come before vRegisterHintTransform\n        // — the preamble's pre-order captures each `v-register` expression\n        // in its raw (un-wrapped) form, and the hint then mutates the same\n        // directive's `exp` to wrap it. Reversing the order would have the\n        // preamble pick up an already-wrapped IIFE, double-wrapping it\n        // when injected at the root.\n        api.options.template.compilerOptions.nodeTransforms = [\n          ...existing,\n          selectNodeTransform,\n          inputTextAreaNodeTransform,\n          vRegisterPreambleTransform,\n          vRegisterHintTransform,\n        ]\n      }\n\n      // Build-time alias resolution. Skip cleanly when the user opted\n      // out so consumers with non-standard Zod setups don't see a\n      // \"zod is not installed\" error from this plugin.\n      if (!resolveZodAlias) return\n      const detection = detectZodMajor(resolved.root)\n      if (detection.major === 'missing') {\n        throw new Error(\n          '[attaform/vite] zod is not installed. attaform requires zod as a peer dependency. ' +\n            'Install `zod@^3` or `zod@^4`, OR pass `attaform({ resolveZodAlias: false })` ' +\n            'to keep the runtime-dispatch unified entry (and silence this check).'\n        )\n      }\n      if (detection.major === 'unknown') {\n        // Detection landed on a zod resolution but couldn't classify\n        // the version — log once and fall through to runtime dispatch.\n        // The build still works; the consumer just ships both adapters.\n        if (!warnedAboutDetection) {\n          warnedAboutDetection = true\n          console.warn(\n            '[attaform/vite] Could not classify the installed Zod major (corrupted package.json, ' +\n              'monorepo edge case, or an unexpected version string). Falling through to runtime ' +\n              'dispatch — both Zod adapters will ship in the bundle. ' +\n              'Pass `attaform({ resolveZodAlias: false })` to silence this warning.'\n          )\n        }\n        return\n      }\n      aliasTarget = detection.major === 4 ? ZOD_V4_SPECIFIER : ZOD_V3_SPECIFIER\n    },\n    resolveId(source) {\n      // Intercept ONLY the exact unified specifier. Explicit subpaths\n      // (`attaform/zod-v3`, `attaform/zod-v4`) and the root entry\n      // (`attaform`) pass through unchanged — that's the documented\n      // escape hatch for power users.\n      if (!resolveZodAlias) return null\n      if (aliasTarget === null) return null\n      if (source !== ZOD_UNIFIED_SPECIFIER) return null\n      return aliasTarget\n    },\n  }\n}\n"],"names":["pathToFileURL","join","readFileSync","fileURLToPath","vRegisterPreambleTransform","selectNodeTransform","inputTextAreaNodeTransform","vRegisterHintTransform"],"mappings":"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"}

package/dist/vite.d.cts

@@ -1,38 +1,29 @@
 import { Plugin } from 'vite';
 
-/**
- * `attaform/vite` — Vite plugin that registers the compile-time
- * node transforms with @vitejs/plugin-vue.
- *
- * Usage (bare Vue 3 consumers):
- *
- *   // vite.config.ts
- *   import vue from '@vitejs/plugin-vue'
- *   import { attaform } from 'attaform/vite'
- *
- *   export default defineConfig({
- *     plugins: [vue(), attaform()],
- *   })
- *
- * The transforms inject `:value`, `:checked`, and `:selected` bindings into
- * elements that use the `v-register` directive — load-bearing for SSR
- * initial-render correctness. Omitting this plugin under CSR is tolerable
- * (one-frame flash on mount); omitting it under SSR produces visibly wrong
- * initial HTML.
- *
- * Implementation note: this plugin mutates @vitejs/plugin-vue's options via
- * the documented but somewhat informal `api.options` surface used by
- * VueUse, Vite PWA, and other Vue ecosystem plugins. If you're using a
- * custom Vue plugin wrapper, fall back to `attaform/transforms`
- * and wire them yourself.
- */
-
-/** Options for `attaform()`. Reserved for future use; pass `{}` or omit. */
-type AttaformVitePluginOptions = Record<string, never>;
+/** Options for `attaform()`. */
+interface AttaformVitePluginOptions {
+    /**
+     * Rewrite `attaform/zod` imports at build time to either
+     * `attaform/zod-v3` or `attaform/zod-v4`, based on the consumer's
+     * installed Zod major. Default `true` — produces a leaner bundle
+     * for the common case of one Zod version per project.
+     *
+     * Set to `false` to fall through to the unified entry's runtime
+     * dispatch. Useful when:
+     *   - your project intentionally has both `zod` and `zod-v3`
+     *     installed (e.g. via a pnpm alias) and the schema-shape
+     *     dispatch is the right behavior;
+     *   - your monorepo's Zod resolution is non-standard and the
+     *     plugin's detection (`import.meta.resolve('zod/package.json')`)
+     *     would land on the wrong copy.
+     */
+    resolveZodAlias?: boolean;
+}
 /**
  * Vite plugin that wires the form library's compile-time template
- * transforms into `@vitejs/plugin-vue`. Required for SSR and for
- * hydration accuracy under bare Vue 3.
+ * transforms into `@vitejs/plugin-vue` and rewrites the unified
+ * `attaform/zod` import to the matching adapter subpath. Required
+ * for SSR and for hydration accuracy under bare Vue 3.
  *
  * ```ts
  * // vite.config.ts
@@ -47,7 +38,7 @@ type AttaformVitePluginOptions = Record<string, never>;
  * Place the call after `vue()` in the plugins array. Nuxt projects
  * don't need this — `attaform/nuxt` handles it.
  */
-declare function attaform(_options?: AttaformVitePluginOptions): Plugin;
+declare function attaform(options?: AttaformVitePluginOptions): Plugin;
 
 export { attaform };
 export type { AttaformVitePluginOptions };

package/dist/vite.d.mts

@@ -1,38 +1,29 @@
 import { Plugin } from 'vite';
 
-/**
- * `attaform/vite` — Vite plugin that registers the compile-time
- * node transforms with @vitejs/plugin-vue.
- *
- * Usage (bare Vue 3 consumers):
- *
- *   // vite.config.ts
- *   import vue from '@vitejs/plugin-vue'
- *   import { attaform } from 'attaform/vite'
- *
- *   export default defineConfig({
- *     plugins: [vue(), attaform()],
- *   })
- *
- * The transforms inject `:value`, `:checked`, and `:selected` bindings into
- * elements that use the `v-register` directive — load-bearing for SSR
- * initial-render correctness. Omitting this plugin under CSR is tolerable
- * (one-frame flash on mount); omitting it under SSR produces visibly wrong
- * initial HTML.
- *
- * Implementation note: this plugin mutates @vitejs/plugin-vue's options via
- * the documented but somewhat informal `api.options` surface used by
- * VueUse, Vite PWA, and other Vue ecosystem plugins. If you're using a
- * custom Vue plugin wrapper, fall back to `attaform/transforms`
- * and wire them yourself.
- */
-
-/** Options for `attaform()`. Reserved for future use; pass `{}` or omit. */
-type AttaformVitePluginOptions = Record<string, never>;
+/** Options for `attaform()`. */
+interface AttaformVitePluginOptions {
+    /**
+     * Rewrite `attaform/zod` imports at build time to either
+     * `attaform/zod-v3` or `attaform/zod-v4`, based on the consumer's
+     * installed Zod major. Default `true` — produces a leaner bundle
+     * for the common case of one Zod version per project.
+     *
+     * Set to `false` to fall through to the unified entry's runtime
+     * dispatch. Useful when:
+     *   - your project intentionally has both `zod` and `zod-v3`
+     *     installed (e.g. via a pnpm alias) and the schema-shape
+     *     dispatch is the right behavior;
+     *   - your monorepo's Zod resolution is non-standard and the
+     *     plugin's detection (`import.meta.resolve('zod/package.json')`)
+     *     would land on the wrong copy.
+     */
+    resolveZodAlias?: boolean;
+}
 /**
  * Vite plugin that wires the form library's compile-time template
- * transforms into `@vitejs/plugin-vue`. Required for SSR and for
- * hydration accuracy under bare Vue 3.
+ * transforms into `@vitejs/plugin-vue` and rewrites the unified
+ * `attaform/zod` import to the matching adapter subpath. Required
+ * for SSR and for hydration accuracy under bare Vue 3.
  *
  * ```ts
  * // vite.config.ts
@@ -47,7 +38,7 @@ type AttaformVitePluginOptions = Record<string, never>;
  * Place the call after `vue()` in the plugins array. Nuxt projects
  * don't need this — `attaform/nuxt` handles it.
  */
-declare function attaform(_options?: AttaformVitePluginOptions): Plugin;
+declare function attaform(options?: AttaformVitePluginOptions): Plugin;
 
 export { attaform };
 export type { AttaformVitePluginOptions };

package/dist/vite.d.ts

@@ -1,38 +1,29 @@
 import { Plugin } from 'vite';
 
-/**
- * `attaform/vite` — Vite plugin that registers the compile-time
- * node transforms with @vitejs/plugin-vue.
- *
- * Usage (bare Vue 3 consumers):
- *
- *   // vite.config.ts
- *   import vue from '@vitejs/plugin-vue'
- *   import { attaform } from 'attaform/vite'
- *
- *   export default defineConfig({
- *     plugins: [vue(), attaform()],
- *   })
- *
- * The transforms inject `:value`, `:checked`, and `:selected` bindings into
- * elements that use the `v-register` directive — load-bearing for SSR
- * initial-render correctness. Omitting this plugin under CSR is tolerable
- * (one-frame flash on mount); omitting it under SSR produces visibly wrong
- * initial HTML.
- *
- * Implementation note: this plugin mutates @vitejs/plugin-vue's options via
- * the documented but somewhat informal `api.options` surface used by
- * VueUse, Vite PWA, and other Vue ecosystem plugins. If you're using a
- * custom Vue plugin wrapper, fall back to `attaform/transforms`
- * and wire them yourself.
- */
-
-/** Options for `attaform()`. Reserved for future use; pass `{}` or omit. */
-type AttaformVitePluginOptions = Record<string, never>;
+/** Options for `attaform()`. */
+interface AttaformVitePluginOptions {
+    /**
+     * Rewrite `attaform/zod` imports at build time to either
+     * `attaform/zod-v3` or `attaform/zod-v4`, based on the consumer's
+     * installed Zod major. Default `true` — produces a leaner bundle
+     * for the common case of one Zod version per project.
+     *
+     * Set to `false` to fall through to the unified entry's runtime
+     * dispatch. Useful when:
+     *   - your project intentionally has both `zod` and `zod-v3`
+     *     installed (e.g. via a pnpm alias) and the schema-shape
+     *     dispatch is the right behavior;
+     *   - your monorepo's Zod resolution is non-standard and the
+     *     plugin's detection (`import.meta.resolve('zod/package.json')`)
+     *     would land on the wrong copy.
+     */
+    resolveZodAlias?: boolean;
+}
 /**
  * Vite plugin that wires the form library's compile-time template
- * transforms into `@vitejs/plugin-vue`. Required for SSR and for
- * hydration accuracy under bare Vue 3.
+ * transforms into `@vitejs/plugin-vue` and rewrites the unified
+ * `attaform/zod` import to the matching adapter subpath. Required
+ * for SSR and for hydration accuracy under bare Vue 3.
  *
  * ```ts
  * // vite.config.ts
@@ -47,7 +38,7 @@ type AttaformVitePluginOptions = Record<string, never>;
  * Place the call after `vue()` in the plugins array. Nuxt projects
  * don't need this — `attaform/nuxt` handles it.
  */
-declare function attaform(_options?: AttaformVitePluginOptions): Plugin;
+declare function attaform(options?: AttaformVitePluginOptions): Plugin;
 
 export { attaform };
 export type { AttaformVitePluginOptions };

package/dist/vite.mjs

@@ -1,6 +1,35 @@
+import { readFileSync } from 'node:fs';
+import { pathToFileURL, fileURLToPath } from 'node:url';
+import { join } from 'node:path';
 import { a as vRegisterPreambleTransform, s as selectNodeTransform, i as inputTextAreaNodeTransform, v as vRegisterHintTransform } from './shared/attaform.CXpzmj38.mjs';
 
-function attaform(_options = {}) {
+const ZOD_UNIFIED_SPECIFIER = "attaform/zod";
+const ZOD_V3_SPECIFIER = "attaform/zod-v3";
+const ZOD_V4_SPECIFIER = "attaform/zod-v4";
+function detectZodMajor(consumerRootDir) {
+  const consumerURL = pathToFileURL(join(consumerRootDir, "package.json")).href;
+  let resolved;
+  try {
+    resolved = import.meta.resolve("zod/package.json", consumerURL);
+  } catch {
+    return { major: "missing" };
+  }
+  try {
+    const pkg = JSON.parse(readFileSync(fileURLToPath(resolved), "utf8"));
+    const version = pkg.version;
+    if (typeof version !== "string") return { major: "unknown" };
+    const major = Number.parseInt(version.split(".")[0] ?? "", 10);
+    if (major === 3) return { major: 3 };
+    if (major === 4) return { major: 4 };
+    return { major: "unknown" };
+  } catch {
+    return { major: "unknown" };
+  }
+}
+function attaform(options = {}) {
+  const resolveZodAlias = options.resolveZodAlias !== false;
+  let aliasTarget = null;
+  let warnedAboutDetection = false;
   return {
     name: "attaform",
     enforce: "pre",
@@ -21,14 +50,38 @@ function attaform(_options = {}) {
       (_a = api.options).template ?? (_a.template = {});
       (_b = api.options.template).compilerOptions ?? (_b.compilerOptions = {});
       const existing = api.options.template.compilerOptions.nodeTransforms ?? [];
-      if (existing.includes(vRegisterPreambleTransform)) return;
-      api.options.template.compilerOptions.nodeTransforms = [
-        ...existing,
-        selectNodeTransform,
-        inputTextAreaNodeTransform,
-        vRegisterPreambleTransform,
-        vRegisterHintTransform
-      ];
+      if (!existing.includes(vRegisterPreambleTransform)) {
+        api.options.template.compilerOptions.nodeTransforms = [
+          ...existing,
+          selectNodeTransform,
+          inputTextAreaNodeTransform,
+          vRegisterPreambleTransform,
+          vRegisterHintTransform
+        ];
+      }
+      if (!resolveZodAlias) return;
+      const detection = detectZodMajor(resolved.root);
+      if (detection.major === "missing") {
+        throw new Error(
+          "[attaform/vite] zod is not installed. attaform requires zod as a peer dependency. Install `zod@^3` or `zod@^4`, OR pass `attaform({ resolveZodAlias: false })` to keep the runtime-dispatch unified entry (and silence this check)."
+        );
+      }
+      if (detection.major === "unknown") {
+        if (!warnedAboutDetection) {
+          warnedAboutDetection = true;
+          console.warn(
+            "[attaform/vite] Could not classify the installed Zod major (corrupted package.json, monorepo edge case, or an unexpected version string). Falling through to runtime dispatch \u2014 both Zod adapters will ship in the bundle. Pass `attaform({ resolveZodAlias: false })` to silence this warning."
+          );
+        }
+        return;
+      }
+      aliasTarget = detection.major === 4 ? ZOD_V4_SPECIFIER : ZOD_V3_SPECIFIER;
+    },
+    resolveId(source) {
+      if (!resolveZodAlias) return null;
+      if (aliasTarget === null) return null;
+      if (source !== ZOD_UNIFIED_SPECIFIER) return null;
+      return aliasTarget;
     }
   };
 }

package/dist/vite.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"vite.mjs","sources":["../src/vite.ts"],"sourcesContent":["/**\n * `attaform/vite` — Vite plugin that registers the compile-time\n * node transforms with @vitejs/plugin-vue.\n *\n * Usage (bare Vue 3 consumers):\n *\n *   // vite.config.ts\n *   import vue from '@vitejs/plugin-vue'\n *   import { attaform } from 'attaform/vite'\n *\n *   export default defineConfig({\n *     plugins: [vue(), attaform()],\n *   })\n *\n * The transforms inject `:value`, `:checked`, and `:selected` bindings into\n * elements that use the `v-register` directive — load-bearing for SSR\n * initial-render correctness. Omitting this plugin under CSR is tolerable\n * (one-frame flash on mount); omitting it under SSR produces visibly wrong\n * initial HTML.\n *\n * Implementation note: this plugin mutates @vitejs/plugin-vue's options via\n * the documented but somewhat informal `api.options` surface used by\n * VueUse, Vite PWA, and other Vue ecosystem plugins. If you're using a\n * custom Vue plugin wrapper, fall back to `attaform/transforms`\n * and wire them yourself.\n */\nimport type { Plugin } from 'vite'\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'\n\n/** Options for `attaform()`. Reserved for future use; pass `{}` or omit. */\nexport type AttaformVitePluginOptions = Record<string, never>\n\ninterface VitePluginVueApi {\n  options?: {\n    template?: {\n      compilerOptions?: {\n        nodeTransforms?: unknown[]\n      }\n    }\n  }\n}\n\n/**\n * Vite plugin that wires the form library's compile-time template\n * transforms into `@vitejs/plugin-vue`. Required for SSR and for\n * hydration accuracy under bare Vue 3.\n *\n * ```ts\n * // vite.config.ts\n * import vue from '@vitejs/plugin-vue'\n * import { attaform } from 'attaform/vite'\n *\n * export default defineConfig({\n *   plugins: [vue(), attaform()],\n * })\n * ```\n *\n * Place the call after `vue()` in the plugins array. Nuxt projects\n * don't need this — `attaform/nuxt` handles it.\n */\nexport function attaform(_options: AttaformVitePluginOptions = {}): Plugin {\n  // Unused-var suppression until options exist.\n  void _options\n  return {\n    name: 'attaform',\n    enforce: 'pre',\n    configResolved(resolved) {\n      const vuePlugin = resolved.plugins.find((p) => p.name === 'vite:vue')\n      // Two distinct failure modes — separate error messages so the\n      // consumer's fix is unambiguous:\n      //   1. plugin not in the plugins array → install + register vue()\n      //   2. plugin found but version-incompatible (no `api.options`) →\n      //      version mismatch with @vitejs/plugin-vue\n      if (vuePlugin === undefined) {\n        throw new Error(\n          '[attaform/vite] @vitejs/plugin-vue is not installed (or not registered before attaform()). ' +\n            'Install @vitejs/plugin-vue and place `attaform()` after `vue()` in your plugins array.'\n        )\n      }\n      const api = (vuePlugin as unknown as { api?: VitePluginVueApi }).api\n      if (api?.options === undefined) {\n        throw new Error(\n          '[attaform/vite] Found @vitejs/plugin-vue but it does not expose `api.options`. ' +\n            'This usually means a version-incompatible @vitejs/plugin-vue (or a wrapper plugin re-exporting it). ' +\n            'Pin @vitejs/plugin-vue to a version compatible with the documented `api.options.template.compilerOptions.nodeTransforms` surface.'\n        )\n      }\n      api.options.template ??= {}\n      api.options.template.compilerOptions ??= {}\n      const existing = api.options.template.compilerOptions.nodeTransforms ?? []\n      // Idempotent install: if a previous attaform() invocation\n      // (vite + nuxt module + manual `plugins: [attaform()]`) has\n      // already pushed our transforms, skip — re-pushing would double\n      // every binding the AST emits, breaking the IIFE-wrapping\n      // invariants downstream transforms depend on. We detect the\n      // sentinel via reference equality; user-supplied transforms with\n      // the same name don't collide.\n      if (existing.includes(vRegisterPreambleTransform as unknown)) return\n      // vRegisterPreambleTransform MUST come before vRegisterHintTransform\n      // — the preamble's pre-order captures each `v-register` expression\n      // in its raw (un-wrapped) form, and the hint then mutates the same\n      // directive's `exp` to wrap it. Reversing the order would have the\n      // preamble pick up an already-wrapped IIFE, double-wrapping it\n      // when injected at the root.\n      api.options.template.compilerOptions.nodeTransforms = [\n        ...existing,\n        selectNodeTransform,\n        inputTextAreaNodeTransform,\n        vRegisterPreambleTransform,\n        vRegisterHintTransform,\n      ]\n    },\n  }\n}\n"],"names":[],"mappings":";;AA+DO,SAAS,QAAA,CAAS,QAAA,GAAsC,EAAC,EAAW;AAGzE,EAAA,OAAO;AAAA,IACL,IAAA,EAAM,UAAA;AAAA,IACN,OAAA,EAAS,KAAA;AAAA,IACT,eAAe,QAAA,EAAU;AArE7B,MAAA,IAAA,EAAA,EAAA,EAAA;AAsEM,MAAA,MAAM,SAAA,GAAY,SAAS,OAAA,CAAQ,IAAA,CAAK,CAAC,CAAA,KAAM,CAAA,CAAE,SAAS,UAAU,CAAA;AAMpE,MAAA,IAAI,cAAc,MAAA,EAAW;AAC3B,QAAA,MAAM,IAAI,KAAA;AAAA,UACR;AAAA,SAEF;AAAA,MACF;AACA,MAAA,MAAM,MAAO,SAAA,CAAoD,GAAA;AACjE,MAAA,IAAI,GAAA,EAAK,YAAY,MAAA,EAAW;AAC9B,QAAA,MAAM,IAAI,KAAA;AAAA,UACR;AAAA,SAGF;AAAA,MACF;AACA,MAAA,CAAA,EAAA,GAAA,GAAA,CAAI,OAAA,EAAQ,QAAA,KAAZ,EAAA,CAAY,QAAA,GAAa,EAAC,CAAA;AAC1B,MAAA,CAAA,EAAA,GAAA,GAAA,CAAI,OAAA,CAAQ,QAAA,EAAS,eAAA,KAArB,EAAA,CAAqB,kBAAoB,EAAC,CAAA;AAC1C,MAAA,MAAM,WAAW,GAAA,CAAI,OAAA,CAAQ,QAAA,CAAS,eAAA,CAAgB,kBAAkB,EAAC;AAQzE,MAAA,IAAI,QAAA,CAAS,QAAA,CAAS,0BAAqC,CAAA,EAAG;AAO9D,MAAA,GAAA,CAAI,OAAA,CAAQ,QAAA,CAAS,eAAA,CAAgB,cAAA,GAAiB;AAAA,QACpD,GAAG,QAAA;AAAA,QACH,mBAAA;AAAA,QACA,0BAAA;AAAA,QACA,0BAAA;AAAA,QACA;AAAA,OACF;AAAA,IACF;AAAA,GACF;AACF;;;;"}
+{"version":3,"file":"vite.mjs","sources":["../src/vite.ts"],"sourcesContent":["/**\n * `attaform/vite` — Vite plugin that wires the compile-time node\n * transforms with @vitejs/plugin-vue AND rewrites `attaform/zod`\n * imports to either `attaform/zod-v3` or `attaform/zod-v4` at build\n * time, based on the consumer's installed Zod major. The result is\n * one Zod adapter shipped per bundle, with no manual subpath choice.\n *\n * Usage (bare Vue 3 consumers):\n *\n *   // vite.config.ts\n *   import vue from '@vitejs/plugin-vue'\n *   import { attaform } from 'attaform/vite'\n *\n *   export default defineConfig({\n *     plugins: [vue(), attaform()],\n *   })\n *\n * The transforms inject `:value`, `:checked`, and `:selected` bindings\n * into elements that use the `v-register` directive — load-bearing for\n * SSR initial-render correctness. Omitting this plugin under CSR is\n * tolerable (one-frame flash on mount); omitting it under SSR produces\n * visibly wrong initial HTML.\n *\n * The `resolveZodAlias` option (default `true`) controls the build-time\n * `attaform/zod` rewrite. Set to `false` if your project intentionally\n * mixes Zod versions or has a non-standard Zod resolution; the unified\n * `attaform/zod` entry's runtime dispatch covers that case at the cost\n * of bundling both adapters.\n *\n * Implementation note: this plugin mutates @vitejs/plugin-vue's options\n * via the documented but somewhat informal `api.options` surface used\n * by VueUse, Vite PWA, and other Vue ecosystem plugins. If you're\n * using a custom Vue plugin wrapper, fall back to `attaform/transforms`\n * and wire them yourself.\n */\nimport { readFileSync } from 'node:fs'\nimport { fileURLToPath, pathToFileURL } from 'node:url'\nimport { join } from 'node:path'\nimport type { Plugin } from 'vite'\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'\n\n/** Options for `attaform()`. */\nexport interface AttaformVitePluginOptions {\n  /**\n   * Rewrite `attaform/zod` imports at build time to either\n   * `attaform/zod-v3` or `attaform/zod-v4`, based on the consumer's\n   * installed Zod major. Default `true` — produces a leaner bundle\n   * for the common case of one Zod version per project.\n   *\n   * Set to `false` to fall through to the unified entry's runtime\n   * dispatch. Useful when:\n   *   - your project intentionally has both `zod` and `zod-v3`\n   *     installed (e.g. via a pnpm alias) and the schema-shape\n   *     dispatch is the right behavior;\n   *   - your monorepo's Zod resolution is non-standard and the\n   *     plugin's detection (`import.meta.resolve('zod/package.json')`)\n   *     would land on the wrong copy.\n   */\n  resolveZodAlias?: boolean\n}\n\ninterface VitePluginVueApi {\n  options?: {\n    template?: {\n      compilerOptions?: {\n        nodeTransforms?: unknown[]\n      }\n    }\n  }\n}\n\nconst ZOD_UNIFIED_SPECIFIER = 'attaform/zod'\nconst ZOD_V3_SPECIFIER = 'attaform/zod-v3'\nconst ZOD_V4_SPECIFIER = 'attaform/zod-v4'\n\n/**\n * Read the consumer's installed Zod major by resolving\n * `zod/package.json` from their project root. ESM resolution\n * (`import.meta.resolve`) is sync and stable on Node 20.6+, follows\n * pnpm symlinks, and works with attaform's ESM-only `exports` map.\n *\n * Returns:\n *  - `{ major: 3 | 4 }` when zod is resolvable AND its `version`\n *    field parses to a known major;\n *  - `{ major: 'missing' }` when zod can't be resolved at all;\n *  - `{ major: 'unknown' }` for any other failure (corrupted\n *    package.json, unexpected version string, monorepo edge case).\n */\nfunction detectZodMajor(\n  consumerRootDir: string\n): { major: 3 } | { major: 4 } | { major: 'missing' } | { major: 'unknown' } {\n  const consumerURL = pathToFileURL(join(consumerRootDir, 'package.json')).href\n  let resolved: string\n  try {\n    resolved = import.meta.resolve('zod/package.json', consumerURL)\n  } catch {\n    return { major: 'missing' }\n  }\n  try {\n    const pkg = JSON.parse(readFileSync(fileURLToPath(resolved), 'utf8')) as { version?: unknown }\n    const version = pkg.version\n    if (typeof version !== 'string') return { major: 'unknown' }\n    const major = Number.parseInt(version.split('.')[0] ?? '', 10)\n    if (major === 3) return { major: 3 }\n    if (major === 4) return { major: 4 }\n    return { major: 'unknown' }\n  } catch {\n    return { major: 'unknown' }\n  }\n}\n\n/**\n * Vite plugin that wires the form library's compile-time template\n * transforms into `@vitejs/plugin-vue` and rewrites the unified\n * `attaform/zod` import to the matching adapter subpath. Required\n * for SSR and for hydration accuracy under bare Vue 3.\n *\n * ```ts\n * // vite.config.ts\n * import vue from '@vitejs/plugin-vue'\n * import { attaform } from 'attaform/vite'\n *\n * export default defineConfig({\n *   plugins: [vue(), attaform()],\n * })\n * ```\n *\n * Place the call after `vue()` in the plugins array. Nuxt projects\n * don't need this — `attaform/nuxt` handles it.\n */\nexport function attaform(options: AttaformVitePluginOptions = {}): Plugin {\n  const resolveZodAlias = options.resolveZodAlias !== false\n  // Resolution is computed once per plugin instance from the resolved\n  // Vite root in `configResolved`, then cached for every `resolveId`\n  // call (the hook fires many times during dev/build).\n  let aliasTarget: string | null = null\n  let warnedAboutDetection = false\n\n  return {\n    name: 'attaform',\n    enforce: 'pre',\n    configResolved(resolved) {\n      const vuePlugin = resolved.plugins.find((p) => p.name === 'vite:vue')\n      // Two distinct failure modes — separate error messages so the\n      // consumer's fix is unambiguous:\n      //   1. plugin not in the plugins array → install + register vue()\n      //   2. plugin found but version-incompatible (no `api.options`) →\n      //      version mismatch with @vitejs/plugin-vue\n      if (vuePlugin === undefined) {\n        throw new Error(\n          '[attaform/vite] @vitejs/plugin-vue is not installed (or not registered before attaform()). ' +\n            'Install @vitejs/plugin-vue and place `attaform()` after `vue()` in your plugins array.'\n        )\n      }\n      const api = (vuePlugin as unknown as { api?: VitePluginVueApi }).api\n      if (api?.options === undefined) {\n        throw new Error(\n          '[attaform/vite] Found @vitejs/plugin-vue but it does not expose `api.options`. ' +\n            'This usually means a version-incompatible @vitejs/plugin-vue (or a wrapper plugin re-exporting it). ' +\n            'Pin @vitejs/plugin-vue to a version compatible with the documented `api.options.template.compilerOptions.nodeTransforms` surface.'\n        )\n      }\n      api.options.template ??= {}\n      api.options.template.compilerOptions ??= {}\n      const existing = api.options.template.compilerOptions.nodeTransforms ?? []\n      // Idempotent install: if a previous attaform() invocation\n      // (vite + nuxt module + manual `plugins: [attaform()]`) has\n      // already pushed our transforms, skip — re-pushing would double\n      // every binding the AST emits, breaking the IIFE-wrapping\n      // invariants downstream transforms depend on. We detect the\n      // sentinel via reference equality; user-supplied transforms with\n      // the same name don't collide.\n      if (!existing.includes(vRegisterPreambleTransform as unknown)) {\n        // vRegisterPreambleTransform MUST come before vRegisterHintTransform\n        // — the preamble's pre-order captures each `v-register` expression\n        // in its raw (un-wrapped) form, and the hint then mutates the same\n        // directive's `exp` to wrap it. Reversing the order would have the\n        // preamble pick up an already-wrapped IIFE, double-wrapping it\n        // when injected at the root.\n        api.options.template.compilerOptions.nodeTransforms = [\n          ...existing,\n          selectNodeTransform,\n          inputTextAreaNodeTransform,\n          vRegisterPreambleTransform,\n          vRegisterHintTransform,\n        ]\n      }\n\n      // Build-time alias resolution. Skip cleanly when the user opted\n      // out so consumers with non-standard Zod setups don't see a\n      // \"zod is not installed\" error from this plugin.\n      if (!resolveZodAlias) return\n      const detection = detectZodMajor(resolved.root)\n      if (detection.major === 'missing') {\n        throw new Error(\n          '[attaform/vite] zod is not installed. attaform requires zod as a peer dependency. ' +\n            'Install `zod@^3` or `zod@^4`, OR pass `attaform({ resolveZodAlias: false })` ' +\n            'to keep the runtime-dispatch unified entry (and silence this check).'\n        )\n      }\n      if (detection.major === 'unknown') {\n        // Detection landed on a zod resolution but couldn't classify\n        // the version — log once and fall through to runtime dispatch.\n        // The build still works; the consumer just ships both adapters.\n        if (!warnedAboutDetection) {\n          warnedAboutDetection = true\n          console.warn(\n            '[attaform/vite] Could not classify the installed Zod major (corrupted package.json, ' +\n              'monorepo edge case, or an unexpected version string). Falling through to runtime ' +\n              'dispatch — both Zod adapters will ship in the bundle. ' +\n              'Pass `attaform({ resolveZodAlias: false })` to silence this warning.'\n          )\n        }\n        return\n      }\n      aliasTarget = detection.major === 4 ? ZOD_V4_SPECIFIER : ZOD_V3_SPECIFIER\n    },\n    resolveId(source) {\n      // Intercept ONLY the exact unified specifier. Explicit subpaths\n      // (`attaform/zod-v3`, `attaform/zod-v4`) and the root entry\n      // (`attaform`) pass through unchanged — that's the documented\n      // escape hatch for power users.\n      if (!resolveZodAlias) return null\n      if (aliasTarget === null) return null\n      if (source !== ZOD_UNIFIED_SPECIFIER) return null\n      return aliasTarget\n    },\n  }\n}\n"],"names":[],"mappings":"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"}