attaform 0.17.2 → 0.18.1

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 {\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;;;;"}
+{"version":3,"file":"nuxt.cjs","sources":["../src/nuxt.ts"],"sourcesContent":["import { createRequire } from 'node:module'\nimport { join } from 'node:path'\nimport { pathToFileURL } from 'node:url'\nimport { addImports, addPlugin, addVitePlugin, createResolver, defineNuxtModule } from '@nuxt/kit'\nimport type { AttaformDefaults } from './runtime/types/types-api'\nimport { attaform as attaformVitePlugin } from './vite'\n\n// Read the published version from the package's own package.json so the\n// module's DevTools panel surfaces the live version pill without a\n// build-time string injection. `createRequire` reads sync at module load —\n// run once, free at steady state. Works under unbuild's Rollup output\n// without bundler-specific JSON-import handling.\nconst pkgVersion = (createRequire(import.meta.url)('../package.json') as { version: string })\n  .version\n\n/**\n * Options accepted by `attaform/nuxt` under the `attaform`\n * config key.\n *\n * ```ts\n * // nuxt.config.ts\n * export default defineNuxtConfig({\n *   modules: ['attaform/nuxt'],\n *   attaform: {\n *     defaults: { debounceMs: 100 },\n *   },\n * })\n * ```\n */\nexport interface AttaformModuleOptions {\n  /**\n   * App-level defaults applied to every `useForm` call. Per-form\n   * options always win. See `AttaformDefaults` for the\n   * supported option set and merge rules.\n   */\n  defaults?: AttaformDefaults\n  /**\n   * Forwarded to `attaform/vite`'s `resolveZodAlias` option.\n   * Default `true` — `attaform/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   * Library version, read from the package's own `package.json` at\n   * module setup. Surfaced to the runtime plugin so the DevTools\n   * overlay panel can render a version pill — single source of truth\n   * matches the `meta.version` Nuxt DevTools sees in the Modules panel.\n   */\n  version: string\n}\n\n/**\n * Whether `specifier` is resolvable using ESM resolution from either the\n * consumer's project root or attaform's own module location. Returning\n * true matches what Vite's resolver would do for `optimizeDeps.include`,\n * so a true here means Vite will pre-bundle the dep without warning.\n *\n * Why two probe locations:\n *   - Consumer-rootDir probe finds direct deps + their declared peers\n *     (the standard pnpm strict-isolation visibility).\n *   - attaform-module probe finds peers attaform itself declares —\n *     specifically the optional `@vue/devtools-api`, which lands in\n *     attaform's own node_modules tree (or pnpm virtual store) when\n *     installed, even if the consumer never references it directly.\n *\n * Why ESM resolution (`import.meta.resolve`) rather than CJS\n * (`createRequire(...).resolve`):\n *   - attaform's exports map declares only `import` conditions for\n *     non-`/nuxt` entries. CJS resolve hits ERR_PACKAGE_PATH_NOT_EXPORTED\n *     for `attaform` and its sub-entries.\n *   - pnpm strict isolation hides hoisted transitives behind the\n *     virtual store. CJS resolve walks the bare node_modules chain and\n *     misses them; ESM resolve follows pnpm's symlinks correctly.\n *   - `import.meta.resolve(spec, parentURL)` is sync and stable in\n *     Node 20.6+, which attaform already requires (engines.node).\n */\nfunction isResolvableForVite(specifier: string, consumerRootDir: string): boolean {\n  const consumerURL = pathToFileURL(join(consumerRootDir, 'package.json')).href\n  return canResolve(specifier, consumerURL) || canResolve(specifier, import.meta.url)\n}\n\nfunction canResolve(specifier: string, fromURL: string): boolean {\n  try {\n    import.meta.resolve(specifier, fromURL)\n    return true\n  } catch {\n    return false\n  }\n}\n\nexport default defineNuxtModule<AttaformModuleOptions>({\n  meta: {\n    name: 'Attaform',\n    configKey: 'attaform',\n    version: pkgVersion,\n    docs: 'https://www.attaform.com/docs',\n    compatibility: {\n      nuxt: '>=3.0.0',\n    },\n  },\n  defaults: {},\n  setup(_options, nuxt) {\n    // Register `attaform/vite` so the same plugin handles every Vite-\n    // surface concern: pushing the compile-time node transforms into\n    // `@vitejs/plugin-vue`'s `api.options.template.compilerOptions.\n    // nodeTransforms`, AND rewriting `attaform/zod` imports at build\n    // time to either `/zod-v3` or `/zod-v4` based on the consumer's\n    // installed Zod major. Consolidating both behaviors in one Vite\n    // plugin instance keeps the Nuxt-side wiring minimal and ensures\n    // the consumer's Nuxt build sees the exact same DX as a bare-Vite\n    // consumer.\n    addVitePlugin(attaformVitePlugin({ resolveZodAlias: _options.resolveZodAlias !== false }))\n\n    // Publish module options to public runtime config so the plugin can\n    // read them at install time on both server and client. Frozen-empty\n    // by default — the plugin's merge code reads this slot directly\n    // without a `?? {}` guard at every call site.\n    const runtimePublic = nuxt.options.runtimeConfig.public as Record<string, unknown>\n    runtimePublic['attaform'] = {\n      defaults: _options.defaults ?? {},\n      version: pkgVersion,\n    } satisfies AttaformRuntimeConfig\n\n    // Force-include attaform's own peers that Vite's startup crawl\n    // tends to miss for Nuxt projects. Vite scans `index.html` + the\n    // statically-known entry points but doesn't deeply follow into\n    // pages that get loaded via Nuxt's dynamic router; deps imported\n    // exclusively from page chunks are discovered when the page first\n    // requests, the optimizer rebundles, and Vite silently broadcasts\n    // `{\"type\":\"full-reload\",\"path\":\"*\"}` over the HMR WebSocket — what\n    // consumers see as \"the page loads, then reloads itself a second\n    // later.\" Vite's own \"discovered new dependencies at runtime\"\n    // warning recommends exactly this remediation.\n    //\n    // We declare here only deps attaform itself owns the relationship\n    // with — `@vue/devtools-api` (attaform's DevTools integration\n    // peer) and `zod` (the adapter peer for `/zod`, `/zod-v3`, and\n    // `/zod-v4`). Consumer-\n    // side deps (vue-query, immer, etc.) are the consumer's\n    // responsibility — they declare them in their own\n    // `vite.optimizeDeps.include`. Each push is gated on the spec\n    // being resolvable from the consumer's project (or attaform's\n    // own module context for attaform's optional peers like\n    // devtools-api), so consumers without the optional peer don't see\n    // a \"failed to resolve\" warning at boot.\n    nuxt.options.vite.optimizeDeps ??= {}\n    nuxt.options.vite.optimizeDeps.include ??= []\n    const include = nuxt.options.vite.optimizeDeps.include\n    for (const spec of ['@vue/devtools-api', 'zod']) {\n      if (!isResolvableForVite(spec, nuxt.options.rootDir)) continue\n      if (!include.includes(spec)) include.push(spec)\n    }\n\n    const resolver = createResolver(import.meta.url)\n\n    // Auto-import `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    // Dev-only: register a Nuxt DevTools overlay tab pointing at an\n    // iframe that mounts the Attaform inspector. The iframe URL\n    // (`/_attaform_devtools`) is served by a Vite-layer middleware\n    // wired up in `attaform/vite` — by intercepting at the Vite layer\n    // rather than via `extendPages`, the route stays invisible to\n    // vue-router and works regardless of whether the consumer uses\n    // a `pages/` directory or `app.vue`-only mode.\n    //\n    // `@nuxt/devtools-kit` is NOT a transitive peer of `@nuxt/kit`; it\n    // ships alongside `@nuxt/devtools`. Consumers who don't install\n    // Nuxt DevTools (rare in real Nuxt projects, common in test\n    // fixtures) get a silent no-op instead of an \"unresolved import\"\n    // error. Mirrors the same try/import pattern used for\n    // `@vue/devtools-api` in the runtime devtools wire-up.\n    if (nuxt.options.dev) {\n      nuxt.hook('ready', async () => {\n        try {\n          const { addCustomTab } = await import('@nuxt/devtools-kit')\n          addCustomTab({\n            name: 'attaform',\n            title: 'Attaform',\n            // Brand mark — purple square with a white \"A\" silhouette,\n            // matching `apps/site/public/favicon.svg`. Served by the\n            // `attaform/vite` middleware at the same `/_attaform_devtools`\n            // route family (sibling to the panel HTML). A real URL\n            // renders reliably across Nuxt DevTools versions where\n            // `data:` URIs don't.\n            icon: '/_attaform_devtools/icon.svg',\n            view: {\n              type: 'iframe',\n              src: '/_attaform_devtools',\n              persistent: true,\n            },\n          })\n        } catch {\n          // Nuxt DevTools (and thus @nuxt/devtools-kit) isn't installed\n          // in this consumer — silently skip. The library still works;\n          // only the overlay tab is missing.\n        }\n      })\n    }\n  },\n})\n"],"names":["createRequire","pathToFileURL","join","defineNuxtModule","addVitePlugin","attaformVitePlugin","createResolver","addImports","addPlugin"],"mappings":"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"}

package/dist/nuxt.d.cts

@@ -1,5 +1,5 @@
 import * as _nuxt_schema from '@nuxt/schema';
-import { A as AttaformDefaults } from './shared/attaform.C_5aB6EQ.cjs';
+import { A as AttaformDefaults } from './shared/attaform.Dj9mwbaV.cjs';
 import 'vue';
 
 /**
@@ -39,6 +39,13 @@ interface AttaformModuleOptions {
  */
 type AttaformRuntimeConfig = {
     defaults: AttaformDefaults;
+    /**
+     * Library version, read from the package's own `package.json` at
+     * module setup. Surfaced to the runtime plugin so the DevTools
+     * overlay panel can render a version pill — single source of truth
+     * matches the `meta.version` Nuxt DevTools sees in the Modules panel.
+     */
+    version: string;
 };
 declare const _default: _nuxt_schema.NuxtModule<AttaformModuleOptions, AttaformModuleOptions, false>;
 

package/dist/nuxt.d.mts

@@ -1,5 +1,5 @@
 import * as _nuxt_schema from '@nuxt/schema';
-import { A as AttaformDefaults } from './shared/attaform.C_5aB6EQ.mjs';
+import { A as AttaformDefaults } from './shared/attaform.Dj9mwbaV.mjs';
 import 'vue';
 
 /**
@@ -39,6 +39,13 @@ interface AttaformModuleOptions {
  */
 type AttaformRuntimeConfig = {
     defaults: AttaformDefaults;
+    /**
+     * Library version, read from the package's own `package.json` at
+     * module setup. Surfaced to the runtime plugin so the DevTools
+     * overlay panel can render a version pill — single source of truth
+     * matches the `meta.version` Nuxt DevTools sees in the Modules panel.
+     */
+    version: string;
 };
 declare const _default: _nuxt_schema.NuxtModule<AttaformModuleOptions, AttaformModuleOptions, false>;
 

package/dist/nuxt.d.ts

@@ -1,5 +1,5 @@
 import * as _nuxt_schema from '@nuxt/schema';
-import { A as AttaformDefaults } from './shared/attaform.C_5aB6EQ.js';
+import { A as AttaformDefaults } from './shared/attaform.Dj9mwbaV.js';
 import 'vue';
 
 /**
@@ -39,6 +39,13 @@ interface AttaformModuleOptions {
  */
 type AttaformRuntimeConfig = {
     defaults: AttaformDefaults;
+    /**
+     * Library version, read from the package's own `package.json` at
+     * module setup. Surfaced to the runtime plugin so the DevTools
+     * overlay panel can render a version pill — single source of truth
+     * matches the `meta.version` Nuxt DevTools sees in the Modules panel.
+     */
+    version: string;
 };
 declare const _default: _nuxt_schema.NuxtModule<AttaformModuleOptions, AttaformModuleOptions, false>;
 

package/dist/nuxt.mjs

@@ -1,8 +1,10 @@
+import { createRequire } from 'node:module';
 import { join } from 'node:path';
 import { pathToFileURL } from 'node:url';
-import { defineNuxtModule, addVitePlugin, createResolver, addImports, addPlugin, addTypeTemplate } from '@nuxt/kit';
+import { defineNuxtModule, addVitePlugin, createResolver, addImports, addPlugin } from '@nuxt/kit';
 import { attaform } from './vite.mjs';
 
+const pkgVersion = createRequire(import.meta.url)("../package.json").version;
 function isResolvableForVite(specifier, consumerRootDir) {
   const consumerURL = pathToFileURL(join(consumerRootDir, "package.json")).href;
   return canResolve(specifier, consumerURL) || canResolve(specifier, import.meta.url);
@@ -17,8 +19,10 @@ function canResolve(specifier, fromURL) {
 }
 var nuxt_default = defineNuxtModule({
   meta: {
-    name: "attaform",
+    name: "Attaform",
     configKey: "attaform",
+    version: pkgVersion,
+    docs: "https://www.attaform.com/docs",
     compatibility: {
       nuxt: ">=3.0.0"
     }
@@ -29,7 +33,8 @@ var nuxt_default = defineNuxtModule({
     addVitePlugin(attaform({ resolveZodAlias: _options.resolveZodAlias !== false }));
     const runtimePublic = nuxt.options.runtimeConfig.public;
     runtimePublic["attaform"] = {
-      defaults: _options.defaults ?? {}
+      defaults: _options.defaults ?? {},
+      version: pkgVersion
     };
     (_a = nuxt.options.vite).optimizeDeps ?? (_a.optimizeDeps = {});
     (_b = nuxt.options.vite.optimizeDeps).include ?? (_b.include = []);
@@ -43,44 +48,30 @@ var nuxt_default = defineNuxtModule({
     addPlugin({
       src: resolver.resolve("./runtime/plugins/attaform")
     });
-    addTypeTemplate({
-      filename: "types/v-register.d.ts",
-      getContents: () => `// Generated by attaform
-import type { ObjectDirective } from "vue"
-import type { RegisterDirective } from "attaform/types"
-
-declare module "vue" {
-  interface GlobalDirectives {
-    /**
-     * The \`v-register\` directive. Binds a form field to a native
-     * input, select, textarea, checkbox, or radio:
-     *
-     * \`\`\`vue
-     * <input v-register="form.register('email')" />
-     * \`\`\`
-     *
-     * Also works on custom components whose root is NOT a native
-     * input \u2014 call \`useRegister()\` in the child's setup to read
-     * the parent's binding, then re-bind \`v-register\` onto an
-     * inner native element. (When the wrapper's root IS the input
-     * itself, attribute fallthrough handles it; \`useRegister\` is
-     * unnecessary.) See \`RegisterDirective\` for the full
-     * non-input-root example.
-     *
-     * Modifier support varies by element:
-     *   - text / number / textarea: \`.lazy\`, \`.trim\`, \`.number\`
-     *   - select: \`.number\`
-     *   - checkbox / radio: none
-     *
-     * See \`RegisterDirective\` for full usage and per-modifier
-     * semantics.
-     */
-    vRegister: RegisterDirective
-  }
-}
-
-export { }`
-    });
+    if (nuxt.options.dev) {
+      nuxt.hook("ready", async () => {
+        try {
+          const { addCustomTab } = await import('@nuxt/devtools-kit');
+          addCustomTab({
+            name: "attaform",
+            title: "Attaform",
+            // Brand mark — purple square with a white "A" silhouette,
+            // matching `apps/site/public/favicon.svg`. Served by the
+            // `attaform/vite` middleware at the same `/_attaform_devtools`
+            // route family (sibling to the panel HTML). A real URL
+            // renders reliably across Nuxt DevTools versions where
+            // `data:` URIs don't.
+            icon: "/_attaform_devtools/icon.svg",
+            view: {
+              type: "iframe",
+              src: "/_attaform_devtools",
+              persistent: true
+            }
+          });
+        } catch {
+        }
+      });
+    }
   }
 });
 

package/dist/nuxt.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"nuxt.mjs","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":["attaformVitePlugin"],"mappings":";;;;;AA8EA,SAAS,mBAAA,CAAoB,WAAmB,eAAA,EAAkC;AAChF,EAAA,MAAM,cAAc,aAAA,CAAc,IAAA,CAAK,eAAA,EAAiB,cAAc,CAAC,CAAA,CAAE,IAAA;AACzE,EAAA,OAAO,WAAW,SAAA,EAAW,WAAW,KAAK,UAAA,CAAW,SAAA,EAAW,YAAY,GAAG,CAAA;AACpF;AAEA,SAAS,UAAA,CAAW,WAAmB,OAAA,EAA0B;AAC/D,EAAA,IAAI;AACF,IAAA,MAAA,CAAA,IAAA,CAAY,OAAA,CAAQ,WAAW,OAAO,CAAA;AACtC,IAAA,OAAO,IAAA;AAAA,EACT,CAAA,CAAA,MAAQ;AACN,IAAA,OAAO,KAAA;AAAA,EACT;AACF;AAEA,IAAO,eAAQ,gBAAA,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,IAAA,aAAA,CAAcA,SAAmB,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,GAAW,cAAA,CAAe,MAAA,CAAA,IAAA,CAAY,GAAG,CAAA;AAiB/C,IAAA,UAAA,CAAW,CAAC,EAAE,IAAA,EAAM,WAAW,IAAA,EAAM,UAAA,EAAY,CAAC,CAAA;AAsBlD,IAAA,SAAA,CAAU;AAAA,MACR,GAAA,EAAK,QAAA,CAAS,OAAA,CAAQ,4BAA4B;AAAA,KACnD,CAAA;AAMD,IAAA,eAAA,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.mjs","sources":["../src/nuxt.ts"],"sourcesContent":["import { createRequire } from 'node:module'\nimport { join } from 'node:path'\nimport { pathToFileURL } from 'node:url'\nimport { addImports, addPlugin, addVitePlugin, createResolver, defineNuxtModule } from '@nuxt/kit'\nimport type { AttaformDefaults } from './runtime/types/types-api'\nimport { attaform as attaformVitePlugin } from './vite'\n\n// Read the published version from the package's own package.json so the\n// module's DevTools panel surfaces the live version pill without a\n// build-time string injection. `createRequire` reads sync at module load —\n// run once, free at steady state. Works under unbuild's Rollup output\n// without bundler-specific JSON-import handling.\nconst pkgVersion = (createRequire(import.meta.url)('../package.json') as { version: string })\n  .version\n\n/**\n * Options accepted by `attaform/nuxt` under the `attaform`\n * config key.\n *\n * ```ts\n * // nuxt.config.ts\n * export default defineNuxtConfig({\n *   modules: ['attaform/nuxt'],\n *   attaform: {\n *     defaults: { debounceMs: 100 },\n *   },\n * })\n * ```\n */\nexport interface AttaformModuleOptions {\n  /**\n   * App-level defaults applied to every `useForm` call. Per-form\n   * options always win. See `AttaformDefaults` for the\n   * supported option set and merge rules.\n   */\n  defaults?: AttaformDefaults\n  /**\n   * Forwarded to `attaform/vite`'s `resolveZodAlias` option.\n   * Default `true` — `attaform/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   * Library version, read from the package's own `package.json` at\n   * module setup. Surfaced to the runtime plugin so the DevTools\n   * overlay panel can render a version pill — single source of truth\n   * matches the `meta.version` Nuxt DevTools sees in the Modules panel.\n   */\n  version: string\n}\n\n/**\n * Whether `specifier` is resolvable using ESM resolution from either the\n * consumer's project root or attaform's own module location. Returning\n * true matches what Vite's resolver would do for `optimizeDeps.include`,\n * so a true here means Vite will pre-bundle the dep without warning.\n *\n * Why two probe locations:\n *   - Consumer-rootDir probe finds direct deps + their declared peers\n *     (the standard pnpm strict-isolation visibility).\n *   - attaform-module probe finds peers attaform itself declares —\n *     specifically the optional `@vue/devtools-api`, which lands in\n *     attaform's own node_modules tree (or pnpm virtual store) when\n *     installed, even if the consumer never references it directly.\n *\n * Why ESM resolution (`import.meta.resolve`) rather than CJS\n * (`createRequire(...).resolve`):\n *   - attaform's exports map declares only `import` conditions for\n *     non-`/nuxt` entries. CJS resolve hits ERR_PACKAGE_PATH_NOT_EXPORTED\n *     for `attaform` and its sub-entries.\n *   - pnpm strict isolation hides hoisted transitives behind the\n *     virtual store. CJS resolve walks the bare node_modules chain and\n *     misses them; ESM resolve follows pnpm's symlinks correctly.\n *   - `import.meta.resolve(spec, parentURL)` is sync and stable in\n *     Node 20.6+, which attaform already requires (engines.node).\n */\nfunction isResolvableForVite(specifier: string, consumerRootDir: string): boolean {\n  const consumerURL = pathToFileURL(join(consumerRootDir, 'package.json')).href\n  return canResolve(specifier, consumerURL) || canResolve(specifier, import.meta.url)\n}\n\nfunction canResolve(specifier: string, fromURL: string): boolean {\n  try {\n    import.meta.resolve(specifier, fromURL)\n    return true\n  } catch {\n    return false\n  }\n}\n\nexport default defineNuxtModule<AttaformModuleOptions>({\n  meta: {\n    name: 'Attaform',\n    configKey: 'attaform',\n    version: pkgVersion,\n    docs: 'https://www.attaform.com/docs',\n    compatibility: {\n      nuxt: '>=3.0.0',\n    },\n  },\n  defaults: {},\n  setup(_options, nuxt) {\n    // Register `attaform/vite` so the same plugin handles every Vite-\n    // surface concern: pushing the compile-time node transforms into\n    // `@vitejs/plugin-vue`'s `api.options.template.compilerOptions.\n    // nodeTransforms`, AND rewriting `attaform/zod` imports at build\n    // time to either `/zod-v3` or `/zod-v4` based on the consumer's\n    // installed Zod major. Consolidating both behaviors in one Vite\n    // plugin instance keeps the Nuxt-side wiring minimal and ensures\n    // the consumer's Nuxt build sees the exact same DX as a bare-Vite\n    // consumer.\n    addVitePlugin(attaformVitePlugin({ resolveZodAlias: _options.resolveZodAlias !== false }))\n\n    // Publish module options to public runtime config so the plugin can\n    // read them at install time on both server and client. Frozen-empty\n    // by default — the plugin's merge code reads this slot directly\n    // without a `?? {}` guard at every call site.\n    const runtimePublic = nuxt.options.runtimeConfig.public as Record<string, unknown>\n    runtimePublic['attaform'] = {\n      defaults: _options.defaults ?? {},\n      version: pkgVersion,\n    } satisfies AttaformRuntimeConfig\n\n    // Force-include attaform's own peers that Vite's startup crawl\n    // tends to miss for Nuxt projects. Vite scans `index.html` + the\n    // statically-known entry points but doesn't deeply follow into\n    // pages that get loaded via Nuxt's dynamic router; deps imported\n    // exclusively from page chunks are discovered when the page first\n    // requests, the optimizer rebundles, and Vite silently broadcasts\n    // `{\"type\":\"full-reload\",\"path\":\"*\"}` over the HMR WebSocket — what\n    // consumers see as \"the page loads, then reloads itself a second\n    // later.\" Vite's own \"discovered new dependencies at runtime\"\n    // warning recommends exactly this remediation.\n    //\n    // We declare here only deps attaform itself owns the relationship\n    // with — `@vue/devtools-api` (attaform's DevTools integration\n    // peer) and `zod` (the adapter peer for `/zod`, `/zod-v3`, and\n    // `/zod-v4`). Consumer-\n    // side deps (vue-query, immer, etc.) are the consumer's\n    // responsibility — they declare them in their own\n    // `vite.optimizeDeps.include`. Each push is gated on the spec\n    // being resolvable from the consumer's project (or attaform's\n    // own module context for attaform's optional peers like\n    // devtools-api), so consumers without the optional peer don't see\n    // a \"failed to resolve\" warning at boot.\n    nuxt.options.vite.optimizeDeps ??= {}\n    nuxt.options.vite.optimizeDeps.include ??= []\n    const include = nuxt.options.vite.optimizeDeps.include\n    for (const spec of ['@vue/devtools-api', 'zod']) {\n      if (!isResolvableForVite(spec, nuxt.options.rootDir)) continue\n      if (!include.includes(spec)) include.push(spec)\n    }\n\n    const resolver = createResolver(import.meta.url)\n\n    // Auto-import `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    // Dev-only: register a Nuxt DevTools overlay tab pointing at an\n    // iframe that mounts the Attaform inspector. The iframe URL\n    // (`/_attaform_devtools`) is served by a Vite-layer middleware\n    // wired up in `attaform/vite` — by intercepting at the Vite layer\n    // rather than via `extendPages`, the route stays invisible to\n    // vue-router and works regardless of whether the consumer uses\n    // a `pages/` directory or `app.vue`-only mode.\n    //\n    // `@nuxt/devtools-kit` is NOT a transitive peer of `@nuxt/kit`; it\n    // ships alongside `@nuxt/devtools`. Consumers who don't install\n    // Nuxt DevTools (rare in real Nuxt projects, common in test\n    // fixtures) get a silent no-op instead of an \"unresolved import\"\n    // error. Mirrors the same try/import pattern used for\n    // `@vue/devtools-api` in the runtime devtools wire-up.\n    if (nuxt.options.dev) {\n      nuxt.hook('ready', async () => {\n        try {\n          const { addCustomTab } = await import('@nuxt/devtools-kit')\n          addCustomTab({\n            name: 'attaform',\n            title: 'Attaform',\n            // Brand mark — purple square with a white \"A\" silhouette,\n            // matching `apps/site/public/favicon.svg`. Served by the\n            // `attaform/vite` middleware at the same `/_attaform_devtools`\n            // route family (sibling to the panel HTML). A real URL\n            // renders reliably across Nuxt DevTools versions where\n            // `data:` URIs don't.\n            icon: '/_attaform_devtools/icon.svg',\n            view: {\n              type: 'iframe',\n              src: '/_attaform_devtools',\n              persistent: true,\n            },\n          })\n        } catch {\n          // Nuxt DevTools (and thus @nuxt/devtools-kit) isn't installed\n          // in this consumer — silently skip. The library still works;\n          // only the overlay tab is missing.\n        }\n      })\n    }\n  },\n})\n"],"names":["attaformVitePlugin"],"mappings":"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"}

package/dist/runtime/components/AttaformDevtoolsPanel.d.vue.ts

@@ -0,0 +1,7 @@
+import { type AttaformDevtoolsBridge } from 'attaform';
+type __VLS_Props = {
+    bridge: AttaformDevtoolsBridge;
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;