attaform 0.27.1 → 0.27.3

package/dist/shared/{attaform.C3WnCDXz.d.cts → attaform.BIPSHY5U.d.cts}

@@ -1,4 +1,4 @@
-import { ObjectDirective, Ref, ComputedRef } from 'vue';
+import { ObjectDirective, Ref, ComputedRef, MaybeRefOrGetter } from 'vue';
 
 /**
  * Schema-attached field metadata — the shared types used by both Zod
@@ -1733,6 +1733,29 @@ type UseFormConfiguration<Form extends GenericForm, GetValueFormType, Schema ext
      * the policy silently no-ops.
      */
     onInvalidSubmit?: OnInvalidSubmitPolicy;
+    /**
+     * Freeze the form's data. When this resolves truthy every value write
+     * no-ops at the store's write chokepoint (programmatic `setValue`, the
+     * `v-register` directive, and host-model events alike), native
+     * registered inputs render the HTML `disabled` attribute, component
+     * hosts receive a `disabled` flag on their register value, and every
+     * field's `displayState` drops to `'idle'` so error, pending, and
+     * success signals stand down. The first blocked write logs a one-time
+     * dev warning; writes never throw.
+     *
+     * `reset()` and `defaultValues` hydration still apply while frozen, so
+     * a disabled form can be populated or cleared programmatically. This is
+     * a data freeze only: a disabled form stays navigable, which is what a
+     * read-only review page wants.
+     *
+     * Accepts a boolean, a ref, a computed, or a getter, read live so the
+     * freeze tracks a reactive source. `undefined` resolves to `false`.
+     * Falls back to `AttaformDefaults.disabled`.
+     *
+     * A shared FormStore resolves `disabled` from its first `useForm({ key })`
+     * call; a later caller passing a different value is ignored.
+     */
+    disabled?: MaybeRefOrGetter<boolean | undefined>;
     /**
      * When per-field VALIDATION runs (the directive's listener controls
      * how often storage commits — per keystroke by default, per blur
@@ -1917,6 +1940,8 @@ type AttaformDefaults = {
     history?: HistoryConfig;
     /** Default for `useForm({ rememberVariants })`. */
     rememberVariants?: boolean;
+    /** Default for `useForm({ disabled })` — freeze the form's data. */
+    disabled?: MaybeRefOrGetter<boolean | undefined>;
     /**
      * Default for `useForm({ coerce })`. Schema-driven coercion of
      * user-typed DOM values at the v-register directive layer.
@@ -2583,6 +2608,26 @@ type RegisterValue<Value = unknown> = Readonly<{
      * patching `el.value` back to `'0'` (the slim default).
      */
     displayValue: Readonly<Ref<string>>;
+    /**
+     * Blank-aware model presentation for a `v-register` component host's
+     * `:modelValue`. Returns `undefined` when the path is in the form's
+     * `blankPaths` set (the typed-model analog of `displayValue`'s `''`),
+     * otherwise the raw typed storage. Lets a cleared numeric field read
+     * empty in a v-model-bound component the way it does in a native
+     * input. Read only by the compile-time component-bridge transform's
+     * `:modelValue` injection.
+     * @internal
+     */
+    hostModelValue: Readonly<Ref<Value | undefined>>;
+    /**
+     * Live `true` when this binding's form is frozen via
+     * `useForm({ disabled })`. The compile-time transforms bind it to the
+     * host's `:disabled`, so a native `<input v-register>` renders the
+     * HTML `disabled` attribute (SSR and client) and a component host
+     * receives a `disabled` prop. Read it directly from a custom
+     * `useRegister` integration to drive your own disabled affordance.
+     */
+    disabled: Readonly<Ref<boolean>>;
     /**
      * Add this field's path to the form's `blankPaths` set,
      * writing the slim default to storage. Returns the `setValueAtPath`
@@ -3341,6 +3386,15 @@ type FieldState<Value = unknown> = {
      */
     readonly key: string;
     readonly blank: boolean;
+    /**
+     * `true` when this field's form is frozen via `useForm({ disabled })`.
+     * While disabled, value writes no-op and this field's `displayState`
+     * is forced to `'idle'` so error, pending, and success signals stand
+     * down. A form-level flag: every field of a disabled form reads
+     * `true`, and the form root exposes it as `form.meta.disabled`. Bind
+     * read-only or styling affordances off this.
+     */
+    readonly disabled: boolean;
     /**
      * Presentational label for this field. Resolves through the
      * shared cross-adapter field-meta store — written via

package/dist/shared/{attaform.C3WnCDXz.d.mts → attaform.BIPSHY5U.d.mts}

@@ -1,4 +1,4 @@
-import { ObjectDirective, Ref, ComputedRef } from 'vue';
+import { ObjectDirective, Ref, ComputedRef, MaybeRefOrGetter } from 'vue';
 
 /**
  * Schema-attached field metadata — the shared types used by both Zod
@@ -1733,6 +1733,29 @@ type UseFormConfiguration<Form extends GenericForm, GetValueFormType, Schema ext
      * the policy silently no-ops.
      */
     onInvalidSubmit?: OnInvalidSubmitPolicy;
+    /**
+     * Freeze the form's data. When this resolves truthy every value write
+     * no-ops at the store's write chokepoint (programmatic `setValue`, the
+     * `v-register` directive, and host-model events alike), native
+     * registered inputs render the HTML `disabled` attribute, component
+     * hosts receive a `disabled` flag on their register value, and every
+     * field's `displayState` drops to `'idle'` so error, pending, and
+     * success signals stand down. The first blocked write logs a one-time
+     * dev warning; writes never throw.
+     *
+     * `reset()` and `defaultValues` hydration still apply while frozen, so
+     * a disabled form can be populated or cleared programmatically. This is
+     * a data freeze only: a disabled form stays navigable, which is what a
+     * read-only review page wants.
+     *
+     * Accepts a boolean, a ref, a computed, or a getter, read live so the
+     * freeze tracks a reactive source. `undefined` resolves to `false`.
+     * Falls back to `AttaformDefaults.disabled`.
+     *
+     * A shared FormStore resolves `disabled` from its first `useForm({ key })`
+     * call; a later caller passing a different value is ignored.
+     */
+    disabled?: MaybeRefOrGetter<boolean | undefined>;
     /**
      * When per-field VALIDATION runs (the directive's listener controls
      * how often storage commits — per keystroke by default, per blur
@@ -1917,6 +1940,8 @@ type AttaformDefaults = {
     history?: HistoryConfig;
     /** Default for `useForm({ rememberVariants })`. */
     rememberVariants?: boolean;
+    /** Default for `useForm({ disabled })` — freeze the form's data. */
+    disabled?: MaybeRefOrGetter<boolean | undefined>;
     /**
      * Default for `useForm({ coerce })`. Schema-driven coercion of
      * user-typed DOM values at the v-register directive layer.
@@ -2583,6 +2608,26 @@ type RegisterValue<Value = unknown> = Readonly<{
      * patching `el.value` back to `'0'` (the slim default).
      */
     displayValue: Readonly<Ref<string>>;
+    /**
+     * Blank-aware model presentation for a `v-register` component host's
+     * `:modelValue`. Returns `undefined` when the path is in the form's
+     * `blankPaths` set (the typed-model analog of `displayValue`'s `''`),
+     * otherwise the raw typed storage. Lets a cleared numeric field read
+     * empty in a v-model-bound component the way it does in a native
+     * input. Read only by the compile-time component-bridge transform's
+     * `:modelValue` injection.
+     * @internal
+     */
+    hostModelValue: Readonly<Ref<Value | undefined>>;
+    /**
+     * Live `true` when this binding's form is frozen via
+     * `useForm({ disabled })`. The compile-time transforms bind it to the
+     * host's `:disabled`, so a native `<input v-register>` renders the
+     * HTML `disabled` attribute (SSR and client) and a component host
+     * receives a `disabled` prop. Read it directly from a custom
+     * `useRegister` integration to drive your own disabled affordance.
+     */
+    disabled: Readonly<Ref<boolean>>;
     /**
      * Add this field's path to the form's `blankPaths` set,
      * writing the slim default to storage. Returns the `setValueAtPath`
@@ -3341,6 +3386,15 @@ type FieldState<Value = unknown> = {
      */
     readonly key: string;
     readonly blank: boolean;
+    /**
+     * `true` when this field's form is frozen via `useForm({ disabled })`.
+     * While disabled, value writes no-op and this field's `displayState`
+     * is forced to `'idle'` so error, pending, and success signals stand
+     * down. A form-level flag: every field of a disabled form reads
+     * `true`, and the form root exposes it as `form.meta.disabled`. Bind
+     * read-only or styling affordances off this.
+     */
+    readonly disabled: boolean;
     /**
      * Presentational label for this field. Resolves through the
      * shared cross-adapter field-meta store — written via

package/dist/shared/{attaform.C3WnCDXz.d.ts → attaform.BIPSHY5U.d.ts}

@@ -1,4 +1,4 @@
-import { ObjectDirective, Ref, ComputedRef } from 'vue';
+import { ObjectDirective, Ref, ComputedRef, MaybeRefOrGetter } from 'vue';
 
 /**
  * Schema-attached field metadata — the shared types used by both Zod
@@ -1733,6 +1733,29 @@ type UseFormConfiguration<Form extends GenericForm, GetValueFormType, Schema ext
      * the policy silently no-ops.
      */
     onInvalidSubmit?: OnInvalidSubmitPolicy;
+    /**
+     * Freeze the form's data. When this resolves truthy every value write
+     * no-ops at the store's write chokepoint (programmatic `setValue`, the
+     * `v-register` directive, and host-model events alike), native
+     * registered inputs render the HTML `disabled` attribute, component
+     * hosts receive a `disabled` flag on their register value, and every
+     * field's `displayState` drops to `'idle'` so error, pending, and
+     * success signals stand down. The first blocked write logs a one-time
+     * dev warning; writes never throw.
+     *
+     * `reset()` and `defaultValues` hydration still apply while frozen, so
+     * a disabled form can be populated or cleared programmatically. This is
+     * a data freeze only: a disabled form stays navigable, which is what a
+     * read-only review page wants.
+     *
+     * Accepts a boolean, a ref, a computed, or a getter, read live so the
+     * freeze tracks a reactive source. `undefined` resolves to `false`.
+     * Falls back to `AttaformDefaults.disabled`.
+     *
+     * A shared FormStore resolves `disabled` from its first `useForm({ key })`
+     * call; a later caller passing a different value is ignored.
+     */
+    disabled?: MaybeRefOrGetter<boolean | undefined>;
     /**
      * When per-field VALIDATION runs (the directive's listener controls
      * how often storage commits — per keystroke by default, per blur
@@ -1917,6 +1940,8 @@ type AttaformDefaults = {
     history?: HistoryConfig;
     /** Default for `useForm({ rememberVariants })`. */
     rememberVariants?: boolean;
+    /** Default for `useForm({ disabled })` — freeze the form's data. */
+    disabled?: MaybeRefOrGetter<boolean | undefined>;
     /**
      * Default for `useForm({ coerce })`. Schema-driven coercion of
      * user-typed DOM values at the v-register directive layer.
@@ -2583,6 +2608,26 @@ type RegisterValue<Value = unknown> = Readonly<{
      * patching `el.value` back to `'0'` (the slim default).
      */
     displayValue: Readonly<Ref<string>>;
+    /**
+     * Blank-aware model presentation for a `v-register` component host's
+     * `:modelValue`. Returns `undefined` when the path is in the form's
+     * `blankPaths` set (the typed-model analog of `displayValue`'s `''`),
+     * otherwise the raw typed storage. Lets a cleared numeric field read
+     * empty in a v-model-bound component the way it does in a native
+     * input. Read only by the compile-time component-bridge transform's
+     * `:modelValue` injection.
+     * @internal
+     */
+    hostModelValue: Readonly<Ref<Value | undefined>>;
+    /**
+     * Live `true` when this binding's form is frozen via
+     * `useForm({ disabled })`. The compile-time transforms bind it to the
+     * host's `:disabled`, so a native `<input v-register>` renders the
+     * HTML `disabled` attribute (SSR and client) and a component host
+     * receives a `disabled` prop. Read it directly from a custom
+     * `useRegister` integration to drive your own disabled affordance.
+     */
+    disabled: Readonly<Ref<boolean>>;
     /**
      * Add this field's path to the form's `blankPaths` set,
      * writing the slim default to storage. Returns the `setValueAtPath`
@@ -3341,6 +3386,15 @@ type FieldState<Value = unknown> = {
      */
     readonly key: string;
     readonly blank: boolean;
+    /**
+     * `true` when this field's form is frozen via `useForm({ disabled })`.
+     * While disabled, value writes no-op and this field's `displayState`
+     * is forced to `'idle'` so error, pending, and success signals stand
+     * down. A form-level flag: every field of a disabled form reads
+     * `true`, and the form root exposes it as `form.meta.disabled`. Bind
+     * read-only or styling affordances off this.
+     */
+    readonly disabled: boolean;
     /**
      * Presentational label for this field. Resolves through the
      * shared cross-adapter field-meta store — written via

package/dist/shared/{attaform.DDAmSFnl.mjs → attaform.BKxpBJVF.mjs}

@@ -1,5 +1,5 @@
-import { A as AttaformErrorCode, k as isPlainRecord, s as safeOwnRead, n as safeAssign, o as slimKindOf } from './attaform.CyQxTOdX.mjs';
-import { f as canonicalizePath } from './attaform.Da8EdI2t.mjs';
+import { A as AttaformErrorCode, n as isPlainRecord, s as safeOwnRead, o as safeAssign, p as slimKindOf } from './attaform.BqkFQ2B9.mjs';
+import { f as canonicalizePath } from './attaform.CgsQZdy1.mjs';
 
 const PATH_SEPARATOR = ".";
 function createAbstractSchema(rootSchema, intro, services, formKey, options) {
@@ -904,4 +904,4 @@ function walkForMeta(schema, path, map, counters, lastPathPerSchema, inProgress,
 }
 
 export { NO_EMBEDDED_DEFAULT as N, getFieldMetaListForSchema as a, getFieldMetaPathMap as b, createAbstractSchema as c, deriveDefaultWalk as d, fieldMetaStore as f, getFieldMetaForSchema as g, mergeDeep as m, peelEmbeddedDefault as p, slimPrimitivesWalk as s, walkPathSegments as w };
-//# sourceMappingURL=attaform.DDAmSFnl.mjs.map
+//# sourceMappingURL=attaform.BKxpBJVF.mjs.map