attaform 0.0.1 → 0.14.0

package/dist/vite.d.ts

@@ -0,0 +1,53 @@
+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>;
+/**
+ * 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.
+ *
+ * ```ts
+ * // vite.config.ts
+ * import vue from '@vitejs/plugin-vue'
+ * import { attaform } from 'attaform/vite'
+ *
+ * export default defineConfig({
+ *   plugins: [vue(), attaform()],
+ * })
+ * ```
+ *
+ * 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;
+
+export { attaform };
+export type { AttaformVitePluginOptions };

package/dist/vite.mjs

@@ -0,0 +1,37 @@
+import { a as vRegisterPreambleTransform, s as selectNodeTransform, i as inputTextAreaNodeTransform, v as vRegisterHintTransform } from './shared/attaform.CXpzmj38.mjs';
+
+function attaform(_options = {}) {
+  return {
+    name: "attaform",
+    enforce: "pre",
+    configResolved(resolved) {
+      var _a, _b;
+      const vuePlugin = resolved.plugins.find((p) => p.name === "vite:vue");
+      if (vuePlugin === void 0) {
+        throw new Error(
+          "[attaform/vite] @vitejs/plugin-vue is not installed (or not registered before attaform()). Install @vitejs/plugin-vue and place `attaform()` after `vue()` in your plugins array."
+        );
+      }
+      const api = vuePlugin.api;
+      if (api?.options === void 0) {
+        throw new Error(
+          "[attaform/vite] Found @vitejs/plugin-vue but it does not expose `api.options`. This usually means a version-incompatible @vitejs/plugin-vue (or a wrapper plugin re-exporting it). Pin @vitejs/plugin-vue to a version compatible with the documented `api.options.template.compilerOptions.nodeTransforms` surface."
+        );
+      }
+      (_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
+      ];
+    }
+  };
+}
+
+export { attaform };
+//# sourceMappingURL=vite.mjs.map

package/dist/vite.mjs.map

@@ -0,0 +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;;;;"}