attaform 0.27.2 → 0.27.3

package/dist/shared/{attaform.DIJTp_Kv.d.cts → attaform.BjGedLx2.d.cts}

@@ -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.DGCijpZT.mjs → attaform.BqkFQ2B9.mjs}

@@ -6346,14 +6346,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) {
@@ -6835,6 +6837,10 @@ function useWizard(options) {
     const source = asStatusSource(form);
     const computedStatus = 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) {
@@ -6843,16 +6849,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;
@@ -7566,4 +7573,4 @@ function escapeForInlineScript(json) {
 }
 
 export { AttaformErrorCode as A, DEFAULT_TIMINGS as D, defaultDisplayState as a, defineCoercion as b, injectWizard as c, defaultCoercionRules as d, escapeForInlineScript as e, isUnset as f, gate as g, useAbstractForm as h, injectForm as i, useRegister as j, useWizard as k, lazy as l, makeDefaultDisplayState as m, isPlainRecord as n, safeAssign as o, slimKindOf as p, humanize as q, getAtPath as r, safeOwnRead as s, setAtPath as t, unset as u };
-//# sourceMappingURL=attaform.DGCijpZT.mjs.map
+//# sourceMappingURL=attaform.BqkFQ2B9.mjs.map