@ggui-ai/ui-visual-tester 0.17.0 → 0.19.0

package/dist/fixture-runtime.js

@@ -82,6 +82,12 @@ const CLICKABLE_SELECTOR = 'button, [role="button"], input[type="submit"], input
 // parent <details> — a DOM change that says nothing about the action).
 /** Per-control wait in the fallback pass — enough for a synchronous dispatch + a render. */
 const FALLBACK_CLICK_WAIT_MS = 600;
+/**
+ * #1040: how many times ONE control whose click revealed new controls (a wizard's Next, a tab) may be
+ * clicked again while the action's own control is still not visible. Bounds a walk through a
+ * multi-step form; a toggle that keeps revealing and hiding a panel cannot spin the probe.
+ */
+const MAX_NAVIGATOR_RECLICKS = 8;
 /**
  * ONE deadline covers both passes for an action: max(the caller's wait, this
  * floor). A few loosely-matching decoys can no longer run an action for
@@ -99,9 +105,13 @@ function norm(text) {
  * DOM order. A generated component that wires `useAction('toggleItem')` to an
  * unnamed checkbox is found by pass 2 and judged by what its click dispatches.
  */
+/** The one disabled predicate: the collector's and the walk's reveal signal must not drift apart. */
+function isControlDisabled(el) {
+    return el.hasAttribute('disabled') || el.getAttribute('aria-disabled') === 'true';
+}
 function collectActionCandidates(root, name, label) {
     const every = Array.from(root.querySelectorAll(CLICKABLE_SELECTOR)).filter((el) => el instanceof HTMLElement);
-    const isDisabled = (el) => el.hasAttribute('disabled') || el.getAttribute('aria-disabled') === 'true';
+    const isDisabled = isControlDisabled;
     const lcName = name.toLowerCase();
     const lcLabel = label.toLowerCase();
     const nameKey = norm(name);
@@ -140,10 +150,54 @@ function collectActionCandidates(root, name, label) {
     }
     return { named: [...byValue, ...byText], fallback: rest, disabled, namedDisabled, allClickables: every };
 }
-const TEXT_LIKE_INPUT_TYPES = new Set(['text', 'email', 'search', 'url', 'tel', 'number', 'password', '']);
+// #1040: date-like types too — a wizard's first step is routinely gated on one ("preferred follow-up
+// date"), and a Next that never enables hides every step behind it from the probe.
+const TEXT_LIKE_INPUT_TYPES = new Set([
+    'text', 'email', 'search', 'url', 'tel', 'number', 'password', '',
+    'date', 'time', 'month', 'week', 'datetime-local',
+]);
+/**
+ * #1040: dates are primed RELATIVE TO NOW — a form routinely refuses a date in the past
+ * ("preferred follow-up date"), and a constant sample date is a past date. Thirty days out,
+ * clamped into the input's own [min, max] when those are set in the input's format (ISO
+ * strings compare lexically). Time-of-day values have no past to fall into.
+ */
+const pad2 = (n) => String(n).padStart(2, '0');
+const partsOf = (at) => ({ y: at.getFullYear(), m: at.getMonth() + 1, d: at.getDate() });
+/** Today and thirty days out, as the parts a date-like value is built from. */
+function todayAndThirtyDaysOut() {
+    const now = new Date();
+    const at = new Date(now);
+    at.setDate(at.getDate() + 30);
+    return { today: partsOf(now), later: partsOf(at) };
+}
+/**
+ * Clamp a value into the input's [min, max] when each is set in the input's own format
+ * (ISO-shaped strings compare lexically). `min` later than the value wins; `max` earlier than
+ * the value wins only while it is not before `floor` (today in the same format) — a max in
+ * the past is a form that can never be satisfied, and the probe reports that as it is.
+ */
+function clampToRange(el, value, floor, format) {
+    let out = value;
+    if (format.test(el.min) && el.min > out)
+        out = el.min;
+    if (format.test(el.max) && el.max < out && el.max >= floor)
+        out = el.max;
+    return out;
+}
+function isoWeekOf(y, m, d) {
+    // ISO-8601 week: Thursday of the same week decides the year.
+    const date = new Date(Date.UTC(y, m - 1, d));
+    const day = date.getUTCDay() || 7;
+    date.setUTCDate(date.getUTCDate() + 4 - day);
+    const jan1 = new Date(Date.UTC(date.getUTCFullYear(), 0, 1));
+    const week = Math.ceil(((date.getTime() - jan1.getTime()) / 86_400_000 + 1) / 7);
+    return `${date.getUTCFullYear()}-W${pad2(week)}`;
+}
 function sampleValueFor(el) {
-    const type = el instanceof HTMLInputElement ? el.type : 'textarea';
-    switch (type) {
+    if (!(el instanceof HTMLInputElement))
+        return 'probe'; // a textarea has no type to switch on
+    switch (el.type) {
         case 'number':
             return '1';
         case 'email':
@@ -152,6 +206,27 @@ function sampleValueFor(el) {
             return 'https://example.com';
         case 'tel':
             return '5550100';
+        case 'date': {
+            const { today, later } = todayAndThirtyDaysOut();
+            const iso = (p) => `${p.y}-${pad2(p.m)}-${pad2(p.d)}`;
+            return clampToRange(el, iso(later), iso(today), /^\d{4}-\d{2}-\d{2}$/);
+        }
+        case 'time':
+            return '09:30';
+        case 'month': {
+            const { today, later } = todayAndThirtyDaysOut();
+            const ym = (p) => `${p.y}-${pad2(p.m)}`;
+            return clampToRange(el, ym(later), ym(today), /^\d{4}-\d{2}$/);
+        }
+        case 'week': {
+            const { today, later } = todayAndThirtyDaysOut();
+            return clampToRange(el, isoWeekOf(later.y, later.m, later.d), isoWeekOf(today.y, today.m, today.d), /^\d{4}-W\d{2}$/);
+        }
+        case 'datetime-local': {
+            const { today, later } = todayAndThirtyDaysOut();
+            const at = (p, hm) => `${p.y}-${pad2(p.m)}-${pad2(p.d)}T${hm}`;
+            return clampToRange(el, at(later, '09:30'), at(today, '00:00'), /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}$/);
+        }
         default:
             return 'probe';
     }
@@ -189,7 +264,8 @@ function primeInputs(root) {
         if (el.value.trim().length > 0)
             continue;
         setNativeValue(el, sampleValueFor(el));
-        primed += 1;
+        if (el.value.trim().length > 0)
+            primed += 1;
     }
     for (const el of Array.from(root.querySelectorAll('select'))) {
         if (!(el instanceof HTMLSelectElement) || el.disabled)
@@ -422,7 +498,8 @@ async function run(input) {
             return {
                 status: 'action-not-rendered',
                 diagnostic: `no clickable control in the rendered DOM for actionSpec.${input.actionName} (label "${entry.label}")` +
-                    (first.disabled > 0 ? ` — ${first.disabled} control(s) rendered disabled, none naming the action` : ''),
+                    (first.disabled > 0 ? ` — ${first.disabled} control(s) rendered disabled, none naming the action` : '') +
+                    ` (primed ${primed} input(s))`,
             };
         }
         // One deadline for the whole action. Named controls get the caller's wait
@@ -459,27 +536,71 @@ async function run(input) {
         let namedDisabledSeen = first.namedDisabled;
         let navigated = false;
         let knownSignatures = new Set(first.allClickables.map((el) => signatureOf(container, el)));
+        // #1040: the walk. A wizard's Next is ONE element at ONE DOM path on every step, so "tried once by
+        // path" stopped the probe at step 1 forever, and the terminal control never mounted. A control
+        // whose click revealed controls the probe had not seen is a NAVIGATOR: while the action's own
+        // control is not visible, the probe clicks it again (bounded) before exploring further — the way
+        // a user presses Next until the last step. Inputs a step reveals are primed like the first step's.
+        const navigators = new Map();
+        let lastClickedSignature;
+        // The action's OWN control is keyed by path AND text: a wizard renders Complete at the path Next
+        // occupied on every earlier step, and "tried by path" would read it as the Next already clicked.
+        const namedKey = (el) => `${signatureOf(container, el)}|${(el.textContent ?? '').trim()}`;
+        const triedNamed = new Set();
+        // A step is "revealed" when a control the probe had not seen appears OR a control it had only
+        // seen disabled becomes enabled (a wizard's Back on step 2, a Next a step's own field unlocked).
+        const stateOf = (el) => `${signatureOf(container, el)}|${isControlDisabled(el) ? 'off' : 'on'}`;
+        let knownStates = new Set(first.allClickables.map(stateOf));
         for (;;) {
             if (remaining() === 0) {
                 exhausted = true;
                 break;
             }
-            const live = collectActionCandidates(container, input.actionName, entry.label);
-            namedDisabledSeen = Math.max(namedDisabledSeen, live.namedDisabled);
+            let live = collectActionCandidates(container, input.actionName, entry.label);
             // Disabled controls count: a step that reveals a disabled Complete IS navigation into the gate.
             const liveSignatures = live.allClickables.map((el) => signatureOf(container, el));
+            const liveStates = live.allClickables.map(stateOf);
+            // `navigated` (the reason on an unreachable exit) keeps its meaning: controls the probe had not
+            // seen appeared. `revealed` (the walk) is wider: that, or a control seen only disabled enabling.
             if (clicked > 0 && liveSignatures.some((sig) => !knownSignatures.has(sig)))
                 navigated = true;
+            const revealed = clicked > 0 && liveStates.some((state) => !knownStates.has(state));
             knownSignatures = new Set([...knownSignatures, ...liveSignatures]);
+            knownStates = new Set([...knownStates, ...liveStates]);
+            if (revealed) {
+                if (lastClickedSignature !== undefined && !navigators.has(lastClickedSignature))
+                    navigators.set(lastClickedSignature, 0);
+                // The revealed step may carry its own gate ("name", "date") — give it what the first step got.
+                if (primeInputs(container) > 0) {
+                    await delay(150);
+                    live = collectActionCandidates(container, input.actionName, entry.label);
+                }
+            }
+            namedDisabledSeen = Math.max(namedDisabledSeen, live.namedDisabled);
             const untried = (list) => list.find((el) => el.isConnected && !tried.has(signatureOf(container, el)));
-            const nextNamed = untried(live.named);
-            const next = nextNamed ?? untried(live.fallback);
+            const nextNamed = live.named.find((el) => el.isConnected && !triedNamed.has(namedKey(el)));
+            const navigator = nextNamed === undefined
+                ? live.fallback.find((el) => {
+                    const sig = signatureOf(container, el);
+                    return el.isConnected && (navigators.get(sig) ?? MAX_NAVIGATOR_RECLICKS) < MAX_NAVIGATOR_RECLICKS;
+                })
+                : undefined;
+            // Untried controls first — including the ones the last click revealed — and only when nothing
+            // untried remains, the navigator again: a wizard walks (one extra Back click); an "Add item"
+            // or a tab is not clicked eight more times before what it revealed gets its turn.
+            const next = nextNamed ?? untried(live.fallback) ?? navigator;
             if (next === undefined)
                 break;
             const via = nextNamed !== undefined ? 'named' : 'fallback';
             if (via === 'named')
                 namedAttempted = true;
-            tried.add(signatureOf(container, next));
+            const nextSignature = signatureOf(container, next);
+            if (navigator !== undefined && next === navigator)
+                navigators.set(nextSignature, (navigators.get(nextSignature) ?? 0) + 1);
+            if (via === 'named')
+                triedNamed.add(namedKey(next));
+            tried.add(nextSignature);
+            lastClickedSignature = nextSignature;
             const hit = await attempt(next, via === 'named' ? Math.min(input.waitMs, remaining()) : Math.min(FALLBACK_CLICK_WAIT_MS, remaining()), via);
             if (hit !== null)
                 return hit;
@@ -490,6 +611,7 @@ async function run(input) {
         if (req.requireDom && !bestDom)
             missing.push('DOM change');
         const others = otherActions.size > 0 ? `; other actions dispatched: ${[...otherActions].join(', ')}` : '';
+        const navigatorReclicks = [...navigators.values()].reduce((sum, n) => sum + n, 0);
         // #1040: the named control was seen only disabled and never clicked enabled — the probe could not
         // reach the action. Not measured, with the reason: a click made new controls appear (the gate sits
         // behind navigation the probe walked into but could not finish) or none did (the gate is input the
@@ -500,14 +622,14 @@ async function run(input) {
                 status: 'action-unreachable',
                 reason,
                 diagnostic: `actionSpec.${input.actionName} (label "${entry.label}") rendered disabled on every observation (${namedDisabledSeen} matching control(s)) and was never clicked enabled; ` +
-                    `clicked ${clicked} other control(s) (${tried.size} distinct; primed ${primed} input(s)); new controls appeared after a click=${navigated}; DOM changed=${bestDom}` +
+                    `clicked ${clicked} other control(s) (${tried.size} distinct; primed ${primed} input(s); navigator re-clicks=${navigatorReclicks}); new controls appeared after a click=${navigated}; DOM changed=${bestDom}` +
                     `${exhausted ? '; budget exhausted' : ''}${others}`,
             };
         }
         return {
             status: 'action-no-effect',
             diagnostic: `${req.description}; clicked ${clicked} control(s) (${tried.size} distinct; first collection ${first.named.length} named, ${first.fallback.length} fallback, ${first.disabled} disabled; primed ${primed} input(s)` +
-                `${exhausted ? '; budget exhausted' : ''}); best observed dispatch=${bestDispatch}, domChanged=${bestDom}; ` +
+                `; navigator re-clicks=${navigatorReclicks}${exhausted ? '; budget exhausted' : ''}); best observed dispatch=${bestDispatch}, domChanged=${bestDom}; ` +
                 `missing=${missing.join('+')}${others}`,
         };
     }

package/fixture/fixture-runtime.js

@@ -20658,7 +20658,7 @@
       alignItems: "center",
       justifyContent: "center",
       gap: "var(--ggui-spacing-2, 8px)",
-      borderRadius: "var(--ggui-shape-radius-md, 8px)",
+      borderRadius: "var(--ggui-shape-radius-control, var(--ggui-shape-radius-md, 8px))",
       fontWeight: "var(--ggui-font-weight-medium, 500)",
       cursor: isDisabled ? "not-allowed" : "pointer",
       opacity: isDisabled ? 0.5 : 1,
@@ -20704,7 +20704,7 @@
     }, children: [label, required && (0, import_jsx_runtime9.jsx)("span", { "aria-hidden": "true", style: { color: "var(--ggui-color-error-500, #ef4444)", marginLeft: "2px" }, children: "*" })] }), (0, import_jsx_runtime9.jsx)("input", { id: inputId, type, placeholder, value, onChange: (e) => onChange?.(e.target.value), disabled, required, "aria-invalid": hasError || void 0, "aria-describedby": hasMessage ? messageId : void 0, style: {
       ...sizeStyles2[size],
       width: "100%",
-      borderRadius: "var(--ggui-shape-radius-md, 8px)",
+      borderRadius: "var(--ggui-shape-radius-control, var(--ggui-shape-radius-md, 8px))",
       border: `1px solid ${hasError ? "var(--ggui-color-error-500, #ef4444)" : "var(--ggui-color-outline, #d4d4d8)"}`,
       backgroundColor: disabled ? "var(--ggui-color-sunken, #fafafa)" : "var(--ggui-color-sunken, #ffffff)",
       color: "var(--ggui-color-onContainer, #18181b)",
@@ -20738,7 +20738,7 @@
     }, children: [label, required && (0, import_jsx_runtime10.jsx)("span", { "aria-hidden": "true", style: { color: "var(--ggui-color-error-500, #ef4444)", marginLeft: "2px" }, children: "*" })] }), (0, import_jsx_runtime10.jsx)("textarea", { id: textareaId, placeholder, value, onChange: (e) => onChange?.(e.target.value), rows, disabled, required, maxLength, "aria-invalid": hasError || void 0, "aria-describedby": hasMessage ? messageId : void 0, style: {
       padding: "10px 12px",
       width: "100%",
-      borderRadius: "var(--ggui-shape-radius-md, 8px)",
+      borderRadius: "var(--ggui-shape-radius-control, var(--ggui-shape-radius-md, 8px))",
       border: `1px solid ${hasError ? "var(--ggui-color-error-500, #ef4444)" : "var(--ggui-color-outline, #d4d4d8)"}`,
       backgroundColor: disabled ? "var(--ggui-color-sunken, #fafafa)" : "var(--ggui-color-sunken, #ffffff)",
       color: "var(--ggui-color-onContainer, #18181b)",
@@ -20778,7 +20778,7 @@
     }, children: [label, required && (0, import_jsx_runtime11.jsx)("span", { "aria-hidden": "true", style: { color: "var(--ggui-color-error-500, #ef4444)", marginLeft: "2px" }, children: "*" })] }), (0, import_jsx_runtime11.jsxs)("select", { id: selectId, value, onChange: (e) => onChange?.(e.target.value), disabled, required, "aria-invalid": hasError || void 0, "aria-describedby": hasMessage ? messageId : void 0, style: {
       ...sizeStyles3[size],
       width: "100%",
-      borderRadius: "var(--ggui-shape-radius-md, 8px)",
+      borderRadius: "var(--ggui-shape-radius-control, var(--ggui-shape-radius-md, 8px))",
       border: `1px solid ${hasError ? "var(--ggui-color-error-500, #ef4444)" : "var(--ggui-color-outline, #d4d4d8)"}`,
       backgroundColor: disabled ? "var(--ggui-color-sunken, #fafafa)" : "var(--ggui-color-sunken, #ffffff)",
       color: value ? "var(--ggui-color-onContainer, #18181b)" : "var(--ggui-color-onSunken, #52525b)",
@@ -28618,6 +28618,7 @@
         if (onDispatchSuppressed) {
           try {
             onDispatchSuppressed({
+              reason: "duplicate-dispatch",
               actionName,
               payloadSignature: decision.signature,
               payload: data,
@@ -29372,11 +29373,26 @@
       return internalSeq;
     });
     const validateEnvelope = opts.validateEnvelope ?? validateOutboundActionEnvelope;
+    const spentOneShots = /* @__PURE__ */ new Set();
     return {
       app: opts.app,
       render: opts.render,
       auth: opts.auth,
+      ...opts.onDispatchSuppressed !== void 0 ? { onDispatchSuppressed: opts.onDispatchSuppressed } : {},
       dispatch: (actionName, data) => {
+        const actionSpec = opts.getActiveActionSpec();
+        const isOneShot = actionSpec?.[actionName]?.oneShot === true;
+        if (isOneShot && spentOneShots.has(actionName)) {
+          console.warn(`[ggui] dispatch('${actionName}') suppressed: this action is declared oneShot and already fired for this render. A second gesture is NOT sent to the agent \u2014 the submitted control is spent for the render's lifetime. If the action is meant to repeat, remove \`oneShot\` from its contract entry.`);
+          opts.onDispatchSuppressed?.({
+            reason: "one-shot-spent",
+            actionName,
+            payloadSignature: payloadSignature(actionName, data),
+            payload: data,
+            suppressedAt: Date.now()
+          });
+          return;
+        }
         const envelope = buildActionEnvelope({
           sessionId: opts.render.sessionId,
           type: "data:submit",
@@ -29386,11 +29402,13 @@
           },
           clientSeq: nextClientSeq()
         });
-        const result = validateEnvelope(opts.getActiveActionSpec(), envelope);
+        const result = validateEnvelope(actionSpec, envelope);
         if (!result.valid) {
           opts.onViolation(new ClientContractViolationError("outbound-action", result.violations));
           return;
         }
+        if (isOneShot)
+          spentOneShots.add(actionName);
         opts.emitEnvelope(envelope);
       },
       subscribe: (channelName, handler) => {
@@ -29543,6 +29561,7 @@
       "--ggui-font-weight-normal",
       "--ggui-font-weight-semibold",
       "--ggui-letter-spacing-heading",
+      "--ggui-shape-radius-control",
       "--ggui-shape-radius-full",
       "--ggui-shape-radius-lg",
       "--ggui-shape-radius-md",
@@ -32820,15 +32839,19 @@
   }
   var CLICKABLE_SELECTOR = 'button, [role="button"], input[type="submit"], input[type="button"], input[type="checkbox"], input[type="radio"], [role="switch"], [role="checkbox"], [role="menuitem"], [role="tab"], [role="option"], [data-action]';
   var FALLBACK_CLICK_WAIT_MS = 600;
+  var MAX_NAVIGATOR_RECLICKS = 8;
   var ACTION_BUDGET_FLOOR_MS = 6e3;
   function norm(text) {
     return text.toLowerCase().replace(/[^a-z0-9]/g, "");
   }
+  function isControlDisabled(el) {
+    return el.hasAttribute("disabled") || el.getAttribute("aria-disabled") === "true";
+  }
   function collectActionCandidates(root, name, label) {
     const every = Array.from(root.querySelectorAll(CLICKABLE_SELECTOR)).filter(
       (el) => el instanceof HTMLElement
     );
-    const isDisabled = (el) => el.hasAttribute("disabled") || el.getAttribute("aria-disabled") === "true";
+    const isDisabled = isControlDisabled;
     const lcName = name.toLowerCase();
     const lcLabel = label.toLowerCase();
     const nameKey = norm(name);
@@ -32860,10 +32883,46 @@
     }
     return { named: [...byValue, ...byText], fallback: rest, disabled, namedDisabled, allClickables: every };
   }
-  var TEXT_LIKE_INPUT_TYPES = /* @__PURE__ */ new Set(["text", "email", "search", "url", "tel", "number", "password", ""]);
+  var TEXT_LIKE_INPUT_TYPES = /* @__PURE__ */ new Set([
+    "text",
+    "email",
+    "search",
+    "url",
+    "tel",
+    "number",
+    "password",
+    "",
+    "date",
+    "time",
+    "month",
+    "week",
+    "datetime-local"
+  ]);
+  var pad2 = (n) => String(n).padStart(2, "0");
+  var partsOf = (at) => ({ y: at.getFullYear(), m: at.getMonth() + 1, d: at.getDate() });
+  function todayAndThirtyDaysOut() {
+    const now = /* @__PURE__ */ new Date();
+    const at = new Date(now);
+    at.setDate(at.getDate() + 30);
+    return { today: partsOf(now), later: partsOf(at) };
+  }
+  function clampToRange(el, value, floor, format) {
+    let out = value;
+    if (format.test(el.min) && el.min > out) out = el.min;
+    if (format.test(el.max) && el.max < out && el.max >= floor) out = el.max;
+    return out;
+  }
+  function isoWeekOf(y, m, d) {
+    const date = new Date(Date.UTC(y, m - 1, d));
+    const day = date.getUTCDay() || 7;
+    date.setUTCDate(date.getUTCDate() + 4 - day);
+    const jan1 = new Date(Date.UTC(date.getUTCFullYear(), 0, 1));
+    const week = Math.ceil(((date.getTime() - jan1.getTime()) / 864e5 + 1) / 7);
+    return `${date.getUTCFullYear()}-W${pad2(week)}`;
+  }
   function sampleValueFor(el) {
-    const type = el instanceof HTMLInputElement ? el.type : "textarea";
-    switch (type) {
+    if (!(el instanceof HTMLInputElement)) return "probe";
+    switch (el.type) {
       case "number":
         return "1";
       case "email":
@@ -32872,6 +32931,27 @@
         return "https://example.com";
       case "tel":
         return "5550100";
+      case "date": {
+        const { today, later } = todayAndThirtyDaysOut();
+        const iso = (p) => `${p.y}-${pad2(p.m)}-${pad2(p.d)}`;
+        return clampToRange(el, iso(later), iso(today), /^\d{4}-\d{2}-\d{2}$/);
+      }
+      case "time":
+        return "09:30";
+      case "month": {
+        const { today, later } = todayAndThirtyDaysOut();
+        const ym = (p) => `${p.y}-${pad2(p.m)}`;
+        return clampToRange(el, ym(later), ym(today), /^\d{4}-\d{2}$/);
+      }
+      case "week": {
+        const { today, later } = todayAndThirtyDaysOut();
+        return clampToRange(el, isoWeekOf(later.y, later.m, later.d), isoWeekOf(today.y, today.m, today.d), /^\d{4}-W\d{2}$/);
+      }
+      case "datetime-local": {
+        const { today, later } = todayAndThirtyDaysOut();
+        const at = (p, hm) => `${p.y}-${pad2(p.m)}-${pad2(p.d)}T${hm}`;
+        return clampToRange(el, at(later, "09:30"), at(today, "00:00"), /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}$/);
+      }
       default:
         return "probe";
     }
@@ -32892,7 +32972,7 @@
       if (el instanceof HTMLInputElement && !TEXT_LIKE_INPUT_TYPES.has(el.type)) continue;
       if (el.value.trim().length > 0) continue;
       setNativeValue(el, sampleValueFor(el));
-      primed += 1;
+      if (el.value.trim().length > 0) primed += 1;
     }
     for (const el of Array.from(root.querySelectorAll("select"))) {
       if (!(el instanceof HTMLSelectElement) || el.disabled) continue;
@@ -33084,7 +33164,7 @@
         }
         return {
           status: "action-not-rendered",
-          diagnostic: `no clickable control in the rendered DOM for actionSpec.${input.actionName} (label "${entry.label}")` + (first.disabled > 0 ? ` \u2014 ${first.disabled} control(s) rendered disabled, none naming the action` : "")
+          diagnostic: `no clickable control in the rendered DOM for actionSpec.${input.actionName} (label "${entry.label}")` + (first.disabled > 0 ? ` \u2014 ${first.disabled} control(s) rendered disabled, none naming the action` : "") + ` (primed ${primed} input(s))`
         };
       }
       const deadline = Date.now() + Math.max(input.waitMs, ACTION_BUDGET_FLOOR_MS);
@@ -33109,23 +33189,47 @@
       let namedDisabledSeen = first.namedDisabled;
       let navigated = false;
       let knownSignatures = new Set(first.allClickables.map((el) => signatureOf(container, el)));
+      const navigators = /* @__PURE__ */ new Map();
+      let lastClickedSignature;
+      const namedKey = (el) => `${signatureOf(container, el)}|${(el.textContent ?? "").trim()}`;
+      const triedNamed = /* @__PURE__ */ new Set();
+      const stateOf = (el) => `${signatureOf(container, el)}|${isControlDisabled(el) ? "off" : "on"}`;
+      let knownStates = new Set(first.allClickables.map(stateOf));
       for (; ; ) {
         if (remaining() === 0) {
           exhausted = true;
           break;
         }
-        const live = collectActionCandidates(container, input.actionName, entry.label);
-        namedDisabledSeen = Math.max(namedDisabledSeen, live.namedDisabled);
+        let live = collectActionCandidates(container, input.actionName, entry.label);
         const liveSignatures = live.allClickables.map((el) => signatureOf(container, el));
+        const liveStates = live.allClickables.map(stateOf);
         if (clicked > 0 && liveSignatures.some((sig) => !knownSignatures.has(sig))) navigated = true;
+        const revealed = clicked > 0 && liveStates.some((state) => !knownStates.has(state));
         knownSignatures = /* @__PURE__ */ new Set([...knownSignatures, ...liveSignatures]);
+        knownStates = /* @__PURE__ */ new Set([...knownStates, ...liveStates]);
+        if (revealed) {
+          if (lastClickedSignature !== void 0 && !navigators.has(lastClickedSignature)) navigators.set(lastClickedSignature, 0);
+          if (primeInputs(container) > 0) {
+            await delay(150);
+            live = collectActionCandidates(container, input.actionName, entry.label);
+          }
+        }
+        namedDisabledSeen = Math.max(namedDisabledSeen, live.namedDisabled);
         const untried = (list) => list.find((el) => el.isConnected && !tried.has(signatureOf(container, el)));
-        const nextNamed = untried(live.named);
-        const next = nextNamed ?? untried(live.fallback);
+        const nextNamed = live.named.find((el) => el.isConnected && !triedNamed.has(namedKey(el)));
+        const navigator2 = nextNamed === void 0 ? live.fallback.find((el) => {
+          const sig = signatureOf(container, el);
+          return el.isConnected && (navigators.get(sig) ?? MAX_NAVIGATOR_RECLICKS) < MAX_NAVIGATOR_RECLICKS;
+        }) : void 0;
+        const next = nextNamed ?? untried(live.fallback) ?? navigator2;
         if (next === void 0) break;
         const via = nextNamed !== void 0 ? "named" : "fallback";
         if (via === "named") namedAttempted = true;
-        tried.add(signatureOf(container, next));
+        const nextSignature = signatureOf(container, next);
+        if (navigator2 !== void 0 && next === navigator2) navigators.set(nextSignature, (navigators.get(nextSignature) ?? 0) + 1);
+        if (via === "named") triedNamed.add(namedKey(next));
+        tried.add(nextSignature);
+        lastClickedSignature = nextSignature;
         const hit = await attempt(
           next,
           via === "named" ? Math.min(input.waitMs, remaining()) : Math.min(FALLBACK_CLICK_WAIT_MS, remaining()),
@@ -33137,17 +33241,18 @@
       if (req.requireDispatch && !bestDispatch) missing.push("dispatch");
       if (req.requireDom && !bestDom) missing.push("DOM change");
       const others = otherActions.size > 0 ? `; other actions dispatched: ${[...otherActions].join(", ")}` : "";
+      const navigatorReclicks = [...navigators.values()].reduce((sum, n) => sum + n, 0);
       if (!namedAttempted && namedDisabledSeen > 0) {
         const reason = navigated ? "behind-navigation" : "disabled-after-priming";
         return {
           status: "action-unreachable",
           reason,
-          diagnostic: `actionSpec.${input.actionName} (label "${entry.label}") rendered disabled on every observation (${namedDisabledSeen} matching control(s)) and was never clicked enabled; clicked ${clicked} other control(s) (${tried.size} distinct; primed ${primed} input(s)); new controls appeared after a click=${navigated}; DOM changed=${bestDom}${exhausted ? "; budget exhausted" : ""}${others}`
+          diagnostic: `actionSpec.${input.actionName} (label "${entry.label}") rendered disabled on every observation (${namedDisabledSeen} matching control(s)) and was never clicked enabled; clicked ${clicked} other control(s) (${tried.size} distinct; primed ${primed} input(s); navigator re-clicks=${navigatorReclicks}); new controls appeared after a click=${navigated}; DOM changed=${bestDom}${exhausted ? "; budget exhausted" : ""}${others}`
         };
       }
       return {
         status: "action-no-effect",
-        diagnostic: `${req.description}; clicked ${clicked} control(s) (${tried.size} distinct; first collection ${first.named.length} named, ${first.fallback.length} fallback, ${first.disabled} disabled; primed ${primed} input(s)${exhausted ? "; budget exhausted" : ""}); best observed dispatch=${bestDispatch}, domChanged=${bestDom}; missing=${missing.join("+")}${others}`
+        diagnostic: `${req.description}; clicked ${clicked} control(s) (${tried.size} distinct; first collection ${first.named.length} named, ${first.fallback.length} fallback, ${first.disabled} disabled; primed ${primed} input(s); navigator re-clicks=${navigatorReclicks}${exhausted ? "; budget exhausted" : ""}); best observed dispatch=${bestDispatch}, domChanged=${bestDom}; missing=${missing.join("+")}${others}`
       };
     } finally {
       window.removeEventListener("error", onWindowError);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ggui-ai/ui-visual-tester",
-  "version": "0.17.0",
+  "version": "0.19.0",
   "description": "Behavioral validator for ggui-generated component code. Renders a component in real Chromium via Playwright, clicks each action declared in its contract, and verifies the action actually does something — mutating bound state or dispatching to the agent. Catches buttons wired to no-op handlers that structural validators miss. Playwright is an optional peer dependency, injected by the caller.",
   "keywords": [
     "ggui",
@@ -48,9 +48,9 @@
   "dependencies": {
     "react": "^19.0.0",
     "react-dom": "^19.0.0",
-    "@ggui-ai/design": "0.17.0",
-    "@ggui-ai/protocol": "0.17.0",
-    "@ggui-ai/wire": "0.17.0"
+    "@ggui-ai/design": "0.19.0",
+    "@ggui-ai/wire": "0.19.0",
+    "@ggui-ai/protocol": "0.19.0"
   },
   "devDependencies": {
     "@playwright/test": "^1.60.0",