attaform 0.23.0 → 0.24.0

package/dist/shared/{attaform.DrY8srOp.d.mts → attaform.DiWNbKWa.d.mts}

@@ -1,4 +1,4 @@
-import { F as FormKey, Y as PathKey, p as DisplayCtx, d as GetDisplayState, q as DisplayMachine, X as Path, ac as SlimPrimitiveKind, C as CoercionEntry, j as CoercionRegistry, G as GenericForm, V as ValidationError, a as AbstractSchema, al as WriteMeta, m as DeepPartial, am as WriteShape, at as TransformAbortHolder, ag as ValidateOn, A as AttaformDefaults, b as UseFormReturnType, c as RegisterValue } from './attaform.BJnNK75Y.mjs';
+import { F as FormKey, W as PathKey, m as DisplayCtx, d as GetDisplayState, n as DisplayMachine, V as Path, aa as SlimPrimitiveKind, C as CoercionEntry, g as CoercionRegistry, G as GenericForm, ag as ValidationError, a as AbstractSchema, ak as WriteMeta, j as DeepPartial, al as WriteShape, as as TransformAbortHolder, ae as ValidateOn, A as AttaformDefaults, b as UseFormReturnType, c as RegisterValue } from './attaform.GJbSmwLB.mjs';
 import { Ref, ComputedRef, App, InjectionKey } from 'vue';
 
 /**
@@ -643,12 +643,12 @@ type FormStore<F extends GenericForm, G extends GenericForm = F> = {
      * Schema-driven errors. Written ONLY by the schema validation pipeline:
      * `scheduleFieldValidation`, `handleSubmit`, the construction-time seed,
      * history restore, and hydration. Cleared by `reset` / `resetField` and by
-     * a successful submit. `setFieldErrors*` APIs do NOT touch this Map.
+     * a successful submit. `setErrors` / `clearErrors` do NOT touch this Map.
      */
     readonly schemaErrors: Map<PathKey, ValidationError[]>;
     /**
-     * User-injected errors. Written ONLY by the `setFieldErrors*` API surfaces
-     * (and history / hydration replay). Survives schema revalidation and
+     * User-injected errors. Written ONLY by the `setErrors` / `clearErrors`
+     * API surface (and history / hydration replay). Survives schema revalidation and
      * successful submits — the consumer owns its lifetime explicitly.
      */
     readonly userErrors: Map<PathKey, ValidationError[]>;
@@ -1005,7 +1005,7 @@ type FormStore<F extends GenericForm, G extends GenericForm = F> = {
      */
     applySchemaErrorsForSubtree(path: Path, errors: ValidationError[]): void;
     setAllUserErrors(errors: readonly ValidationError[]): void;
-    addUserErrors(errors: readonly ValidationError[]): void;
+    setUserErrorsForPath(path: Path, errors: readonly ValidationError[]): void;
     clearUserErrors(path?: Path): void;
     /**
      * Merged read — returns `[...schemaErrors[path], ...userErrors[path]]`.
@@ -1311,9 +1311,8 @@ type SerializedFormData = {
      */
     readonly schemaErrors: ReadonlyArray<readonly [string, unknown]>;
     /**
-     * Errors set explicitly via `setFieldErrors` / `addFieldErrors`
-     * (typically from a server response parsed via `parseApiErrors`)
-     * at snapshot time. Replayed at hydration; persists across
+     * Errors set explicitly via `setErrors` (typically a server
+     * response) at snapshot time. Replayed at hydration; persists across
      * client-side re-validation.
      */
     readonly userErrors: ReadonlyArray<readonly [string, unknown]>;
@@ -1741,9 +1740,9 @@ declare function lazy<Ctx = WizardCtx>(resolve: (ctx: Ctx) => AnyForm | string |
  *   `issue.code` (e.g. `zod:too_small`). No enum here because
  *   Zod's code list evolves.
  * - consumer-defined — anything the consumer's backend / app stamps
- *   onto a `ValidationError` (via the `parseApiErrors` wire payload
- *   or `setFieldErrors` directly). Pick a scope (`api:`, `auth:`,
- *   etc.) and stay consistent.
+ *   onto a `ValidationError` (a server response handed to `setErrors`,
+ *   or a code passed inline). Pick a scope (`api:`, `auth:`, etc.) and
+ *   stay consistent.
  *
  * Use these constants in tests and error-routing UI:
  *
@@ -1787,6 +1786,14 @@ declare const AttaformErrorCode: {
      * `form.hydrateError` for retry UX.
      */
     readonly ActivationFailed: "atta:activation-failed";
+    /**
+     * Default code stamped on a manual error set through `form.setErrors`
+     * when the caller omits an explicit `code`. The `setErrors` input is
+     * lenient (`code` optional), so this is the fallback that keeps every
+     * produced `ValidationError` carrying a stable, branchable identifier.
+     * Override it per error by passing your own `code` (`api:…`, `auth:…`).
+     */
+    readonly UserError: "atta:user-error";
 };
 type AttaformErrorCode = (typeof AttaformErrorCode)[keyof typeof AttaformErrorCode];
 

package/dist/shared/{attaform.Db4E4IW6.cjs → attaform.DwkU0oY9.cjs}

@@ -1429,8 +1429,6 @@ function coerceToPathKey(input) {
 }
 const ROOT_PATH = Object.freeze([]);
 const ROOT_PATH_KEY = "[]";
-const FORM_ERRORS_PATH = Object.freeze([""]);
-const FORM_ERRORS_PATH_KEY = '[""]';
 function isPathPrefix(prefix, path) {
   if (path.length < prefix.length) return false;
   for (let i = 0; i < prefix.length; i++) {
@@ -1447,8 +1445,6 @@ function pathsEqual(a, b) {
 }
 
 exports.AttaformError = AttaformError;
-exports.FORM_ERRORS_PATH = FORM_ERRORS_PATH;
-exports.FORM_ERRORS_PATH_KEY = FORM_ERRORS_PATH_KEY;
 exports.INTERACTIVE_TAG_NAMES = INTERACTIVE_TAG_NAMES;
 exports.InvalidPathError = InvalidPathError;
 exports.InvalidUseFormConfigError = InvalidUseFormConfigError;
@@ -1483,4 +1479,4 @@ exports.segmentsForPathKey = segmentsForPathKey;
 exports.toError = toError;
 exports.useRegistry = useRegistry;
 exports.vRegister = vRegister;
-//# sourceMappingURL=attaform.Db4E4IW6.cjs.map
+//# sourceMappingURL=attaform.DwkU0oY9.cjs.map