attaform 0.27.2 → 0.27.3

package/dist/shared/{attaform.B2d0FszH.d.ts → attaform.gqOCvpSB.d.ts}

@@ -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.CXHebpij.cjs → attaform.ij2W7VTw.cjs}

@@ -6348,14 +6348,16 @@ const PENDING_STATUS = {
   dirty: false,
   submitted: false,
   errorCount: 0,
-  locked: false
+  locked: false,
+  gate: null
 };
 const NOOP_VALID_STATUS = {
   valid: true,
   dirty: false,
   submitted: false,
   errorCount: 0,
-  locked: false
+  locked: false,
+  gate: null
 };
 const EMPTY_LOCK_SET = /* @__PURE__ */ new Set();
 function asStatusSource(form) {
@@ -6837,6 +6839,10 @@ function useWizard(options) {
     const source = asStatusSource(form);
     const computedStatus = vue.computed(() => {
       const locked = navLockSet.value.has(form.key);
+      let gate = null;
+      if (gatePositions.value.includes(form.key)) {
+        gate = clearedGates.has(form.key) ? "cleared" : "uncleared";
+      }
       if (isFormReady(form.key)) {
         const meta = source.meta;
         if (meta !== void 0 && meta !== null) {
@@ -6845,16 +6851,17 @@ function useWizard(options) {
             dirty: meta.dirty,
             submitted: meta.submitted,
             errorCount: meta.errorCount,
-            locked
+            locked,
+            gate
           };
         }
       }
       if (noopForms.has(form.key)) {
-        return locked ? { ...NOOP_VALID_STATUS, locked: true } : NOOP_VALID_STATUS;
+        return locked || gate !== null ? { ...NOOP_VALID_STATUS, locked, gate } : NOOP_VALID_STATUS;
       }
       const seed = seedRef.value?.[form.key];
-      if (seed !== void 0) return { ...seed, locked };
-      return locked ? { ...PENDING_STATUS, locked: true } : PENDING_STATUS;
+      if (seed !== void 0) return { ...seed, locked, gate };
+      return locked || gate !== null ? { ...PENDING_STATUS, locked, gate } : PENDING_STATUS;
     });
     statusCache.set(form.key, computedStatus);
     return computedStatus;
@@ -7590,4 +7597,4 @@ exports.unset = unset;
 exports.useAbstractForm = useAbstractForm;
 exports.useRegister = useRegister;
 exports.useWizard = useWizard;
-//# sourceMappingURL=attaform.CXHebpij.cjs.map
+//# sourceMappingURL=attaform.ij2W7VTw.cjs.map