attaform 0.14.0 → 0.15.0

package/dist/shared/{attaform.BYc9kugA.d.ts → attaform.riAENZQM.d.ts}

@@ -1,5 +1,5 @@
-import { G as GenericForm, F as FormKey, d as UseFormReturnType, R as RegisterValue } from './attaform.DDXrY-1Q.js';
-import { ComputedRef } from 'vue';
+import { G as GenericForm, F as FormKey, d as UseFormReturnType, R as RegisterValue } from './attaform.0Gxd_OOx.js';
+import { Ref } from 'vue';
 
 /**
  * Access an existing form from a descendant component without passing
@@ -56,26 +56,42 @@ declare function injectForm<Form extends GenericForm, GetValueFormType extends G
  * <!-- MyInput.vue -->
  * <script setup lang="ts">
  *   import { useRegister } from 'attaform'
- *   const register = useRegister()
+ *   const rv = useRegister()
+ *   // rv.path / rv.segments / rv.formKey / rv.formInstanceId / rv.innerRef
+ *   // are all reachable directly — no `.value` unwrap.
  * </script>
  *
  * <template>
  *   <label class="field">
  *     <span>Email</span>
- *     <input v-register="register" />
+ *     <input v-register="rv" />
  *   </label>
  * </template>
  * ```
  *
- * Returns a `ComputedRef<RegisterValue | undefined>`. The directive
- * handles `undefined` gracefully (silent no-op assigner, no listener
- * attachment), so always pass the result to `v-register` directly.
+ * Returns a hybrid Proxy: it answers `__v_isRef` / `.value` like a
+ * Vue `Ref<RegisterValue | undefined>` (so templates auto-unwrap
+ * correctly and `v-register="rv"` feeds the underlying RV to the
+ * directive — preserving the directive's path-migration diff across
+ * renders), AND every other property read pierces to the captured
+ * RV's field (so `rv.path` works directly in script setup). Reads
+ * inside reactive scopes (`computed` / `watchEffect`) track the
+ * underlying `shallowRef`, so `rv.path` re-runs when the parent
+ * rebinds to a different path.
+ *
+ * Unbound state: when the parent didn't pass `v-register`, every
+ * piercing read returns `undefined` at runtime even though the type
+ * says otherwise. The composable's `onMounted` warn fires once per
+ * instance to flag this misuse — the type "lies" because the bound
+ * case is the only correct one, and forcing every consumer through
+ * a `T | undefined` narrow at every property access is a worse
+ * trade than the runtime warn.
  *
  * Diagnostic: in dev mode, a single `console.warn` fires per instance
  * at `onMounted` if the captured value is still `undefined` — by then
  * the parent has had its full mount lifecycle to bind, so a missing
  * binding is conclusive misuse. The warn does NOT fire on every read
- * of the computed, and is intentionally silent under SSR
+ * of the proxy, and is intentionally silent under SSR
  * (`renderToString` skips `onMounted`); the CSR hydration pass
  * surfaces the same diagnostic without double-counting through Nuxt's
  * `dev:ssr-logs` channel.
@@ -86,7 +102,21 @@ declare function injectForm<Form extends GenericForm, GetValueFormType extends G
  * `injectForm<Form>(key?)` and call `ctx.register(...)` directly.
  */
 
-declare function useRegister(): ComputedRef<RegisterValue | undefined>;
+/**
+ * Return type of `useRegister()`. Hybrid of `RegisterValue<V>` (so
+ * `rv.path` / `rv.segments` / `rv.formKey` etc. work directly in
+ * script setup) and `Ref<RegisterValue<V> | undefined>` (so Vue's
+ * template auto-unwrap surfaces the underlying RV to `v-register`
+ * and the directive's path-migration diff sees the real RV across
+ * renders).
+ *
+ * The two surfaces don't clash at the type level: `RegisterValue`
+ * doesn't carry a `value` field, and `Ref<T>`'s `value: T` becomes
+ * the hybrid's only `.value`. Older code that read `rv.value?.path`
+ * keeps working; new code can write `rv.path` directly.
+ */
+type UseRegisterReturn<V = unknown> = RegisterValue<V> & Ref<RegisterValue<V> | undefined>;
+declare function useRegister<V = unknown>(): UseRegisterReturn<V>;
 
 /**
  * Stable identifiers for library-emitted `ValidationError` codes.

package/dist/transforms.d.cts

@@ -27,7 +27,7 @@ declare const selectNodeTransform: NodeTransform;
  * Vue compiler node transform that wraps every `v-register`
  * expression in a small IIFE so the directive can flag a field as
  * connected during SSR. Eliminates the `false → true` flicker on
- * `getFieldState(path).isConnected` after hydration.
+ * `getFieldState(path).connected` after hydration.
  *
  * Must run after `vRegisterPreambleTransform`. Wired automatically
  * by `attaform/vite` and `attaform/nuxt`.
@@ -38,7 +38,7 @@ declare const vRegisterHintTransform: NodeTransform;
  * Vue compiler node transform that hoists `v-register`'s SSR
  * connection marks to the root of the template. Together with
  * `vRegisterHintTransform`, ensures expressions earlier in the
- * template that read `getFieldState(path).isConnected` see the
+ * template that read `getFieldState(path).connected` see the
  * correct value during the server's single-pass render.
  *
  * Must run before `vRegisterHintTransform`. Wired automatically

package/dist/transforms.d.mts

@@ -27,7 +27,7 @@ declare const selectNodeTransform: NodeTransform;
  * Vue compiler node transform that wraps every `v-register`
  * expression in a small IIFE so the directive can flag a field as
  * connected during SSR. Eliminates the `false → true` flicker on
- * `getFieldState(path).isConnected` after hydration.
+ * `getFieldState(path).connected` after hydration.
  *
  * Must run after `vRegisterPreambleTransform`. Wired automatically
  * by `attaform/vite` and `attaform/nuxt`.
@@ -38,7 +38,7 @@ declare const vRegisterHintTransform: NodeTransform;
  * Vue compiler node transform that hoists `v-register`'s SSR
  * connection marks to the root of the template. Together with
  * `vRegisterHintTransform`, ensures expressions earlier in the
- * template that read `getFieldState(path).isConnected` see the
+ * template that read `getFieldState(path).connected` see the
  * correct value during the server's single-pass render.
  *
  * Must run before `vRegisterHintTransform`. Wired automatically

package/dist/transforms.d.ts

@@ -27,7 +27,7 @@ declare const selectNodeTransform: NodeTransform;
  * Vue compiler node transform that wraps every `v-register`
  * expression in a small IIFE so the directive can flag a field as
  * connected during SSR. Eliminates the `false → true` flicker on
- * `getFieldState(path).isConnected` after hydration.
+ * `getFieldState(path).connected` after hydration.
  *
  * Must run after `vRegisterPreambleTransform`. Wired automatically
  * by `attaform/vite` and `attaform/nuxt`.
@@ -38,7 +38,7 @@ declare const vRegisterHintTransform: NodeTransform;
  * Vue compiler node transform that hoists `v-register`'s SSR
  * connection marks to the root of the template. Together with
  * `vRegisterHintTransform`, ensures expressions earlier in the
- * template that read `getFieldState(path).isConnected` see the
+ * template that read `getFieldState(path).connected` see the
  * correct value during the server's single-pass render.
  *
  * Must run before `vRegisterHintTransform`. Wired automatically

package/dist/zod-v3.cjs

@@ -2,9 +2,33 @@
 
 const lodashEs = require('lodash-es');
 const zod = require('zod');
-const useFormContext = require('./shared/attaform.CNJO3mME.cjs');
-const paths = require('./shared/attaform.xKWYHMdq.cjs');
-const sensitiveNames = require('./shared/attaform.B5GWYl76.cjs');
+const useFormContext = require('./shared/attaform.CDJVeoJU.cjs');
+const paths = require('./shared/attaform.BOi138GE.cjs');
+const sensitiveNames = require('./shared/attaform.RypIkgVy.cjs');
+
+const store = /* @__PURE__ */ new WeakMap();
+const fieldMeta = {
+  add(schema, payload) {
+    store.set(schema, payload);
+    return fieldMeta;
+  },
+  get(schema) {
+    return store.get(schema);
+  },
+  has(schema) {
+    return store.has(schema);
+  }
+};
+function withMeta(schema, payload) {
+  const existing = store.get(schema) ?? {};
+  const Ctor = schema.constructor;
+  const cloned = new Ctor(schema._def);
+  store.set(cloned, { ...existing, ...payload });
+  return cloned;
+}
+function getFieldMeta(schema) {
+  return store.get(schema);
+}
 
 class UnsupportedSchemaError extends sensitiveNames.AttaformError {
 }
@@ -659,6 +683,9 @@ function zodAdapter(zodSchema) {
         if (!leaf) return false;
         return isLeafRequiredV3(leaf);
       },
+      getFieldMetaAtPath(path) {
+        return resolveFieldMetaAtPathV3(_zodSchema, path);
+      },
       getUnionDiscriminatorAtPath(path) {
         const candidates = path.length === 0 ? [_zodSchema] : getNestedZodSchemasAtPath(_zodSchema, path);
         let matchedUnion;
@@ -1486,6 +1513,29 @@ function getSlimSchema(config) {
   const processedRootSchema = stripRootSchema(config.schema, config.stripConfig)[0];
   return _getSlimSchema(processedRootSchema);
 }
+function resolveFieldMetaAtPathV3(rootSchema, path) {
+  const lastSegment = path.length === 0 ? "" : path[path.length - 1];
+  const target = path.length === 0 ? rootSchema : walkV3ToLeafSchema(rootSchema, path);
+  if (target === void 0) {
+    return {
+      label: useFormContext.humanize(lastSegment),
+      description: void 0,
+      placeholder: void 0,
+      meta: Object.freeze({})
+    };
+  }
+  const peeled = peelV3Wrappers(target);
+  const payload = getFieldMeta(target) ?? (peeled !== target ? getFieldMeta(peeled) : void 0);
+  const targetDescription = typeof target.description === "string" ? target.description : void 0;
+  const peeledDescription = peeled !== target && typeof peeled.description === "string" ? peeled.description : void 0;
+  const schemaDescription = targetDescription ?? peeledDescription;
+  return {
+    label: payload?.label ?? useFormContext.humanize(lastSegment),
+    description: payload?.description ?? schemaDescription ?? void 0,
+    placeholder: payload?.placeholder ?? void 0,
+    meta: Object.freeze({ ...payload ?? {} })
+  };
+}
 
 function useForm(configuration) {
   function isZodType(value) {
@@ -1505,7 +1555,9 @@ exports.injectForm = useFormContext.injectForm;
 exports.isUnset = useFormContext.isUnset;
 exports.unset = useFormContext.unset;
 exports.useRegister = sensitiveNames.useRegister;
+exports.fieldMeta = fieldMeta;
 exports.isZodSchemaType = isZodSchemaType;
 exports.useForm = useForm;
+exports.withMeta = withMeta;
 exports.zodAdapter = zodAdapter;
 //# sourceMappingURL=zod-v3.cjs.map