attaform 0.24.0 → 0.24.2

package/dist/shared/{attaform.GJbSmwLB.d.ts → attaform.DUc6cetN.d.ts}

@@ -644,6 +644,42 @@ type DefaultValuesInput<T> = T extends string ? string | Unset : T extends numbe
 } | Unset : Array<DefaultValuesInput<U>> | Unset : T extends object ? {
     [K in keyof T]?: DefaultValuesInput<T[K]>;
 } | Unset : T;
+/**
+ * The type accepted at a `useForm` overload's `defaultValues` slot.
+ *
+ * `Form` is the schema's input projection; `SchemaInput` is the schema's
+ * own input type (`z.input<Schema>`). A `defaultValues` value is one of:
+ *  - `DefaultValuesInput<Form>` — the partial, `Unset`-widened in-progress
+ *    shape. `defaultValues` deliberately accepts a form mid-completion: a
+ *    leaf may be blank or hold a not-yet-valid value (a `z.email()` field
+ *    accepts any `string`, not only valid emails). Sharp, fully-validated
+ *    types are produced only at `handleSubmit`.
+ *  - `SchemaInput` — the schema's full input shape.
+ *  - a sync or async factory returning either of the above.
+ *
+ * `SchemaInput` is REDUNDANT at a concrete call site: a schema's input is
+ * always assignable to its own `DefaultValuesInput`, so this arm adds
+ * nothing a concrete caller could not already pass and does not weaken the
+ * per-field checking (`number` is still rejected where `string` is
+ * expected). It earns its place for the generic form-wrapper case (#422):
+ * when the schema is a free type parameter `S`, a forwarded `z.input<S>`
+ * is REFLEXIVELY assignable to the `SchemaInput` arm — a relation TS can
+ * decide even under a generic — whereas `DefaultValuesInput<Form>` alone
+ * stays a deferred conditional cascade that is not provably assignable,
+ * tripping TS2589 / TS2769. No runtime effect; the slot only governs what
+ * the type checker accepts.
+ *
+ * `DefaultValuesInput<Form>` is computed ONCE — passed as the `DVI` type
+ * argument to `AcceptableDefaultsOf` and referenced across the value and
+ * factory arms — rather than inlined in each arm, which would
+ * re-instantiate the (deep) cascade three times per overload and, across
+ * the unified entry's two overloads at a concrete call site, tip the
+ * bundled `.d.ts` into TS2589. The arms stay a DIRECT union (not a
+ * conditional over the cascade) so the `SchemaInput` arm remains
+ * reflexively matchable under a generic.
+ */
+type AcceptableDefaults<Form, SchemaInput> = AcceptableDefaultsOf<DefaultValuesInput<Form>, SchemaInput>;
+type AcceptableDefaultsOf<DVI, SchemaInput> = DVI | SchemaInput | (() => DVI | SchemaInput) | (() => Promise<DVI | SchemaInput>);
 
 /**
  * Identifier for a form. A `FormKey` is the string passed via
@@ -2002,9 +2038,11 @@ type AttaformDefaults = {
  */
 type OnSubmit<Form extends GenericForm> = (form: Form) => void | Promise<void>;
 /**
- * Callback invoked by `handleSubmit` when validation fails. Receives
- * the full list of errors. Bind this when you want to react to
- * submit failures explicitly (alongside or instead of the
+ * Callback invoked by `handleSubmit` on a failed submit. Fires when
+ * client validation fails AND when the submit callback leaves errors in
+ * the user-error layer (the `setErrors(...); return` server-rejection
+ * pattern). Receives the full list of errors. Bind this when you want to
+ * react to submit failures explicitly (alongside or instead of the
  * automatic `onInvalidSubmit` UI nudge).
  */
 type OnError = (error: ValidationError[]) => void | Promise<void>;
@@ -3649,10 +3687,14 @@ type FormMeta<F = unknown> = FieldState<F> & {
      *
      * The submit handler does NOT re-throw — its returned promise always
      * resolves, so binding it to `@submit.prevent` never manufactures a
-     * `window` unhandledrejection. This is the single channel for "the
-     * submit failed", read the same way in templates and after an
-     * imperative `await submit()`. Like `hydrateError`, it stays distinct
-     * from the curated user-error store: render it where you choose:
+     * `window` unhandledrejection. This is the channel for an UNEXPECTED
+     * submit failure (a thrown exception or rejected promise), read the
+     * same way in templates and after an imperative `await submit()`. An
+     * EXPECTED rejection handled the documented way (`setErrors(...)` then
+     * `return`, no throw) surfaces through the error store and `onError`
+     * instead, leaving `submitError` `null`. Like `hydrateError`, it stays
+     * distinct from the curated user-error store: render it where you
+     * choose:
      *
      * ```vue
      * <p v-if="form.meta.submitError">{{ form.meta.submitError.message }}</p>
@@ -3669,11 +3711,18 @@ type FormMeta<F = unknown> = FieldState<F> & {
      */
     readonly errorCount: number;
     /**
-     * `true` once a `handleSubmit` callback has resolved without
-     * throwing. Independent of `submissionAttempts` — a failed submit
-     * (validation failure or callback rejection) increments attempts but
-     * leaves `submitted` at `false`. Templates read it as "the form has
-     * been submitted successfully at least once."
+     * `true` once a `handleSubmit` callback has resolved without throwing
+     * AND left no errors behind. Independent of `submissionAttempts` — a
+     * failed submit (validation failure, callback rejection, or a callback
+     * that calls `setErrors` and returns) increments attempts but leaves
+     * `submitted` at `false`. Templates read it as "the form has been
+     * submitted successfully at least once."
+     *
+     * The error check is scoped to the user-error layer (`setErrors` /
+     * `clearErrors`): the documented server-rejection pattern
+     * (`setErrors(response.errors); return`) is a failed submit, so it does
+     * not flip `submitted`. A background async refinement that writes a
+     * schema error mid-submit does not retroactively fail it.
      *
      * Cleared by `form.reset()` alongside `submissionAttempts` and
      * `submitError`. For "the user has attempted a submit," read
@@ -4491,4 +4540,4 @@ type UseFormReturnType<Form extends GenericForm, GetValueFormType extends Generi
 };
 
 export { ROOT_PATH as Z, ROOT_PATH_KEY as _, canonicalizePath as am, isPathPrefix as an, isUnset as ao, parseDottedPath as ap, unset as aq };
-export type { ReactiveValidationStatus as $, AttaformDefaults as A, Json as B, CoercionEntry as C, DefaultValuesInput as D, ErrorInput as E, FormKey as F, GenericForm as G, HandleSubmit as H, IsTuple as I, JoinSegments as J, KeyofUnion as K, LiftedValueShape as L, MetaTrackerValue as M, NestedReadType as N, NestedType as O, OnError as P, OnInvalidSubmitPolicy as Q, RegisterModelDynamicCustomDirective as R, OnSubmit as S, PartialFlatPath as T, UseFormConfiguration as U, Path as V, PathKey as W, PendingValidationStatus as X, Primitive as Y, AbstractSchema as a, RegisterDirective as a0, RegisterFlatPath as a1, RegisterOptions as a2, RegisterSelectModifier as a3, RegisterTextModifier as a4, RegisterTransform as a5, Segment as a6, SetValueCallback as a7, SetValuePayload as a8, SettledValidationStatus as a9, SlimPrimitiveKind as aa, SlimRuntimeOf as ab, SubmitHandler as ac, Unset as ad, ValidateOn as ae, ValidateOnConfig as af, ValidationError as ag, ValidationResponse as ah, ValidationResponseWithoutValue as ai, ValueOfUnion as aj, WriteMeta as ak, WriteShape as al, SchemaFactoryOptions as ar, TransformAbortHolder as as, UseFormReturnType as b, RegisterValue as c, GetDisplayState as d, ArrayItem as e, ArrayPath as f, CoercionRegistry as g, CoercionResult as h, CustomDirectiveRegisterAssignerFn as i, DeepPartial as j, DefaultValuesResponse as k, DefaultValuesShape as l, DisplayCtx as m, DisplayMachine as n, DisplayState as o, ErrorsProxyShape as p, FieldMetaPayload as q, FieldState as r, FieldStateMap as s, FieldStateMapEntry as t, FlatPath as u, FormErrorRecord as v, FormErrorsSurface as w, FormMeta as x, HistoryConfig as y, IsUnion as z };
+export type { ReactiveValidationStatus as $, AttaformDefaults as A, Json as B, CoercionEntry as C, DefaultValuesInput as D, ErrorInput as E, FormKey as F, GenericForm as G, HandleSubmit as H, IsTuple as I, JoinSegments as J, KeyofUnion as K, LiftedValueShape as L, MetaTrackerValue as M, NestedReadType as N, NestedType as O, OnError as P, OnInvalidSubmitPolicy as Q, RegisterModelDynamicCustomDirective as R, OnSubmit as S, PartialFlatPath as T, UseFormConfiguration as U, Path as V, PathKey as W, PendingValidationStatus as X, Primitive as Y, AbstractSchema as a, RegisterDirective as a0, RegisterFlatPath as a1, RegisterOptions as a2, RegisterSelectModifier as a3, RegisterTextModifier as a4, RegisterTransform as a5, Segment as a6, SetValueCallback as a7, SetValuePayload as a8, SettledValidationStatus as a9, SlimPrimitiveKind as aa, SlimRuntimeOf as ab, SubmitHandler as ac, Unset as ad, ValidateOn as ae, ValidateOnConfig as af, ValidationError as ag, ValidationResponse as ah, ValidationResponseWithoutValue as ai, ValueOfUnion as aj, WriteMeta as ak, WriteShape as al, AcceptableDefaults as ar, SchemaFactoryOptions as as, TransformAbortHolder as at, UseFormReturnType as b, RegisterValue as c, GetDisplayState as d, ArrayItem as e, ArrayPath as f, CoercionRegistry as g, CoercionResult as h, CustomDirectiveRegisterAssignerFn as i, DeepPartial as j, DefaultValuesResponse as k, DefaultValuesShape as l, DisplayCtx as m, DisplayMachine as n, DisplayState as o, ErrorsProxyShape as p, FieldMetaPayload as q, FieldState as r, FieldStateMap as s, FieldStateMapEntry as t, FlatPath as u, FormErrorRecord as v, FormErrorsSurface as w, FormMeta as x, HistoryConfig as y, IsUnion as z };

package/dist/shared/{attaform.BV_HyaMO.cjs → attaform.DdfLrIgM.cjs}

@@ -1,7 +1,7 @@
 'use strict';
 
-const injectWizard = require('./attaform.C42wL7EJ.cjs');
-const paths = require('./attaform.DwkU0oY9.cjs');
+const injectWizard = require('./attaform.Bos7wVZw.cjs');
+const paths = require('./attaform.B7UdTs_o.cjs');
 
 const PATH_SEPARATOR = ".";
 function createAbstractSchema(rootSchema, intro, services, formKey, options) {
@@ -916,4 +916,4 @@ exports.mergeDeep = mergeDeep;
 exports.peelEmbeddedDefault = peelEmbeddedDefault;
 exports.slimPrimitivesWalk = slimPrimitivesWalk;
 exports.walkPathSegments = walkPathSegments;
-//# sourceMappingURL=attaform.BV_HyaMO.cjs.map
+//# sourceMappingURL=attaform.DdfLrIgM.cjs.map