attaform 0.27.2 → 0.27.3

package/dist/shared/{attaform.Dcj-OS43.d.mts → attaform.CEZP3i3I.d.mts}

@@ -1026,13 +1026,24 @@ type AnyForm = {
  *    `submissionAttempts > 0` is the "user has tried" signal.
  *  - `errorCount` — `form.meta.errorCount`. Count of active validation
  *    errors (zero when valid).
- *  - `locked`: `true` when this step sits after an uncleared `gate()`
- *    (see `gate`). Its member form is frozen (data writes no-op) and
- *    navigation to it is refused, so a stepper can render it as an
- *    unreachable gate. `false` when no gate seals it.
+ *  - `locked`: `true` when this step sits after an uncleared gate. Its
+ *    member form is frozen (data writes no-op) and navigation to it is
+ *    refused, so a stepper can render it as an unreachable step. `false`
+ *    when no gate seals it. Orthogonal to `gate`: the first uncleared
+ *    gate reads `locked: false` (you must reach it to clear it), while a
+ *    later gate sealed behind it reads both `gate: 'uncleared'` and
+ *    `locked: true`.
+ *  - `gate`: this step's own role as a hard prerequisite. `null` when the
+ *    step is not a `gate()`; `'uncleared'` while its member form is
+ *    unconfirmed (so it seals every later step); `'cleared'` once
+ *    confirmed by a clean member submit or a seeded-valid form gate at
+ *    mount. Reflects the live compiled shape, so a conditional `gate()`
+ *    that a function slot drops resolves to `null`.
  *
  * Noop forms generated for string slots surface as default-valid
- * (`{ valid: true, dirty: false, submitted: false, errorCount: 0, locked: false }`).
+ * (`{ valid: true, dirty: false, submitted: false, errorCount: 0, locked: false, gate: null }`),
+ * unless the string slot is a `gate('...')`, whose `gate` tracks the
+ * in-session acknowledgment.
  */
 type FormStatus = {
     readonly valid: boolean;
@@ -1040,14 +1051,15 @@ type FormStatus = {
     readonly submitted: boolean;
     readonly errorCount: number;
     readonly locked: boolean;
+    readonly gate: 'cleared' | 'uncleared' | null;
 };
 /**
  * Seed shape accepted by `useWizard({ defaultStatuses })`. Mirrors
- * `FormStatus` minus `locked`: the lock flag is computed live from the
- * wizard's gates and overlaid on every status read, so a seed never
- * carries it (a seeded value would be ignored).
+ * `FormStatus` minus its two live-computed flags, `locked` and `gate`:
+ * both are derived from the wizard's gates and overlaid on every status
+ * read, so a seed never carries them (a seeded value would be ignored).
  */
-type FormStatusSeed = Omit<FormStatus, 'locked'>;
+type FormStatusSeed = Omit<FormStatus, 'locked' | 'gate'>;
 /**
  * Flat error shape returned per form by `wizard.allErrors[key]`. Each
  * entry carries the formKey + path tuple so consumers can route to the

package/dist/shared/{attaform.yOE3udL1.mjs → attaform.DDIn4fv-.mjs}

@@ -1,6 +1,6 @@
-import { r as getAtPath, p as slimKindOf, t as setAtPath, q as humanize, h as useAbstractForm } from './attaform.DGCijpZT.mjs';
+import { r as getAtPath, p as slimKindOf, t as setAtPath, q as humanize, h as useAbstractForm } from './attaform.BqkFQ2B9.mjs';
 import { A as AttaformError, _ as __DEV__, f as canonicalizePath, a as InvalidUseFormConfigError } from './attaform.CgsQZdy1.mjs';
-import { f as fieldMetaStore, g as getFieldMetaForSchema, a as getFieldMetaListForSchema, s as slimPrimitivesWalk, w as walkPathSegments, d as deriveDefaultWalk, m as mergeDeep, c as createAbstractSchema, b as getFieldMetaPathMap } from './attaform.BAlfXoAx.mjs';
+import { f as fieldMetaStore, g as getFieldMetaForSchema, a as getFieldMetaListForSchema, s as slimPrimitivesWalk, w as walkPathSegments, d as deriveDefaultWalk, m as mergeDeep, c as createAbstractSchema, b as getFieldMetaPathMap } from './attaform.BKxpBJVF.mjs';
 import { z } from 'zod';
 
 const fieldMeta = fieldMetaStore;
@@ -1272,4 +1272,4 @@ function useForm(configuration) {
 }
 
 export { UnsupportedSchemaError as U, assertZodVersion as a, getIntersectionRight as b, unwrapLazy as c, unwrapInner as d, unwrapPipe as e, fieldMeta as f, getIntersectionLeft as g, getDiscriminator as h, getDiscriminatedOptions as i, getUnionOptions as j, kindOf as k, getRecordKeyType as l, getRecordValueType as m, getTupleItems as n, getSetValueType as o, getArrayElement as p, getObjectShape as q, getEnumValues as r, getLiteralValues as s, getChecks as t, useForm as u, getCatchDefault as v, withMeta as w, getDefaultValue as x, zodV4Adapter as z };
-//# sourceMappingURL=attaform.yOE3udL1.mjs.map
+//# sourceMappingURL=attaform.DDIn4fv-.mjs.map