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

package/dist/fixture-runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fixture-runtime.d.ts","sourceRoot":"","sources":["../src/fixture-runtime.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"fixture-runtime.d.ts","sourceRoot":"","sources":["../src/fixture-runtime.ts"],"names":[],"mappings":"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"}

package/dist/fixture-runtime.js

@@ -26,6 +26,7 @@ import * as Wire from '@ggui-ai/wire';
 // in-repo consumers of the compile pipeline use.
 import { hoistImports, loadModule } from '@ggui-ai/design/module-loader';
 import { rewriteImports, stripMarkers, } from '@ggui-ai/design/rendering';
+import { primeInputs } from './prime-inputs.js';
 function parseActionEntry(raw) {
     if (raw === null || typeof raw !== 'object')
         return null;
@@ -150,156 +151,6 @@ function collectActionCandidates(root, name, label) {
     }
     return { named: [...byValue, ...byText], fallback: rest, disabled, namedDisabled, allClickables: every };
 }
-// #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) {
-    if (!(el instanceof HTMLInputElement))
-        return 'probe'; // a textarea has no type to switch on
-    switch (el.type) {
-        case 'number':
-            return '1';
-        case 'email':
-            return 'probe@example.com';
-        case 'url':
-            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';
-    }
-}
-/** Set a value the way React notices it: through the prototype's native setter, then an input + change event. */
-function setNativeValue(el, value) {
-    const proto = el instanceof HTMLTextAreaElement
-        ? HTMLTextAreaElement.prototype
-        : el instanceof HTMLSelectElement
-            ? HTMLSelectElement.prototype
-            : HTMLInputElement.prototype;
-    const setter = Object.getOwnPropertyDescriptor(proto, 'value')?.set;
-    if (setter)
-        setter.call(el, value);
-    else
-        el.value = value;
-    el.dispatchEvent(new Event('input', { bubbles: true }));
-    el.dispatchEvent(new Event('change', { bubbles: true }));
-}
-/**
- * The generic minimum a user does before pressing Send / Submit / Complete
- * (#1021): give every empty text-like input and textarea a value, every
- * unset select its first real option, every unchecked radio group its first
- * radio. Checkboxes are never touched — they are often the action itself.
- * Returns how many controls were primed.
- */
-function primeInputs(root) {
-    let primed = 0;
-    const editable = (el) => !el.disabled && !(el instanceof HTMLSelectElement) ? !el.readOnly : !el.disabled;
-    for (const el of Array.from(root.querySelectorAll('input, textarea'))) {
-        if (!(el instanceof HTMLInputElement || el instanceof HTMLTextAreaElement) || !editable(el))
-            continue;
-        if (el instanceof HTMLInputElement && !TEXT_LIKE_INPUT_TYPES.has(el.type))
-            continue;
-        if (el.value.trim().length > 0)
-            continue;
-        setNativeValue(el, sampleValueFor(el));
-        if (el.value.trim().length > 0)
-            primed += 1;
-    }
-    for (const el of Array.from(root.querySelectorAll('select'))) {
-        if (!(el instanceof HTMLSelectElement) || el.disabled)
-            continue;
-        const current = el.options[el.selectedIndex];
-        if (current !== undefined && current.value.trim().length > 0)
-            continue;
-        const first = Array.from(el.options).find((o) => o.value.trim().length > 0 && !o.disabled);
-        if (first === undefined)
-            continue;
-        setNativeValue(el, first.value);
-        primed += 1;
-    }
-    const seenGroups = new Set();
-    for (const el of Array.from(root.querySelectorAll('input[type="radio"]'))) {
-        if (!(el instanceof HTMLInputElement) || el.disabled)
-            continue;
-        const group = el.name || '';
-        if (seenGroups.has(group))
-            continue;
-        seenGroups.add(group);
-        const members = group
-            ? Array.from(root.querySelectorAll(`input[type="radio"][name="${CSS.escape(group)}"]`)).filter((m) => m instanceof HTMLInputElement)
-            : [el];
-        if (members.some((m) => m.checked))
-            continue;
-        const first = members.find((m) => !m.disabled);
-        if (first === undefined)
-            continue;
-        first.click();
-        primed += 1;
-    }
-    return primed;
-}
 function countNamedDispatches(actionName) {
     return (window.__ggui_test_dispatches__ ?? []).filter((d) => d.actionName === actionName).length;
 }

package/dist/prime-inputs.d.ts

@@ -0,0 +1,12 @@
+export declare function sampleValueFor(el: HTMLInputElement | HTMLTextAreaElement): string;
+/** Set a value the way React notices it: through the prototype's native setter, then an input + change event. */
+export declare function setNativeValue(el: HTMLInputElement | HTMLTextAreaElement | HTMLSelectElement, value: string): void;
+/**
+ * The generic minimum a user does before pressing Send / Submit / Complete
+ * (#1021): give every empty text-like input and textarea a value, every
+ * unset select its first real option, every unchecked radio group its first
+ * radio. Checkboxes are never touched — they are often the action itself.
+ * Returns how many controls were primed.
+ */
+export declare function primeInputs(root: HTMLElement): number;
+//# sourceMappingURL=prime-inputs.d.ts.map

package/dist/prime-inputs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prime-inputs.d.ts","sourceRoot":"","sources":["../src/prime-inputs.ts"],"names":[],"mappings":"AAsDA,wBAAgB,cAAc,CAAC,EAAE,EAAE,gBAAgB,GAAG,mBAAmB,GAAG,MAAM,CAmCjF;AAED,iHAAiH;AACjH,wBAAgB,cAAc,CAAC,EAAE,EAAE,gBAAgB,GAAG,mBAAmB,GAAG,iBAAiB,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAWlH;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,CAoCrD"}

package/dist/prime-inputs.js

@@ -0,0 +1,159 @@
+// oss/packages/ui-visual-tester/src/prime-inputs.ts
+//
+// Shared input-priming for the "generic minimum a user does before pressing
+// Send / Submit / Complete" (#1021), incl. the #1040 relative-to-now date rule.
+// Extracted from fixture-runtime.ts so BOTH the Playwright fixture runtime and
+// the ui-gen runtime-render action-wiring probe (ggui#1187) prime inputs the
+// SAME way — one typed-values table, no divergence. Pure DOM + Date only (no
+// Playwright), so it is safe to import into the lightweight happy-dom check
+// worker via the `@ggui-ai/ui-visual-tester/prime-inputs` subpath.
+// #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)}`;
+}
+export function sampleValueFor(el) {
+    if (!(el instanceof HTMLInputElement))
+        return 'probe'; // a textarea has no type to switch on
+    switch (el.type) {
+        case 'number':
+            return '1';
+        case 'email':
+            return 'probe@example.com';
+        case 'url':
+            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';
+    }
+}
+/** Set a value the way React notices it: through the prototype's native setter, then an input + change event. */
+export function setNativeValue(el, value) {
+    const proto = el instanceof HTMLTextAreaElement
+        ? HTMLTextAreaElement.prototype
+        : el instanceof HTMLSelectElement
+            ? HTMLSelectElement.prototype
+            : HTMLInputElement.prototype;
+    const setter = Object.getOwnPropertyDescriptor(proto, 'value')?.set;
+    if (setter)
+        setter.call(el, value);
+    else
+        el.value = value;
+    el.dispatchEvent(new Event('input', { bubbles: true }));
+    el.dispatchEvent(new Event('change', { bubbles: true }));
+}
+/**
+ * The generic minimum a user does before pressing Send / Submit / Complete
+ * (#1021): give every empty text-like input and textarea a value, every
+ * unset select its first real option, every unchecked radio group its first
+ * radio. Checkboxes are never touched — they are often the action itself.
+ * Returns how many controls were primed.
+ */
+export function primeInputs(root) {
+    let primed = 0;
+    const editable = (el) => !el.disabled && !(el instanceof HTMLSelectElement) ? !el.readOnly : !el.disabled;
+    for (const el of Array.from(root.querySelectorAll('input, textarea'))) {
+        if (!(el instanceof HTMLInputElement || el instanceof HTMLTextAreaElement) || !editable(el))
+            continue;
+        if (el instanceof HTMLInputElement && !TEXT_LIKE_INPUT_TYPES.has(el.type))
+            continue;
+        if (el.value.trim().length > 0)
+            continue;
+        setNativeValue(el, sampleValueFor(el));
+        if (el.value.trim().length > 0)
+            primed += 1;
+    }
+    for (const el of Array.from(root.querySelectorAll('select'))) {
+        if (!(el instanceof HTMLSelectElement) || el.disabled)
+            continue;
+        const current = el.options[el.selectedIndex];
+        if (current !== undefined && current.value.trim().length > 0)
+            continue;
+        const first = Array.from(el.options).find((o) => o.value.trim().length > 0 && !o.disabled);
+        if (first === undefined)
+            continue;
+        setNativeValue(el, first.value);
+        primed += 1;
+    }
+    const seenGroups = new Set();
+    for (const el of Array.from(root.querySelectorAll('input[type="radio"]'))) {
+        if (!(el instanceof HTMLInputElement) || el.disabled)
+            continue;
+        const group = el.name || '';
+        if (seenGroups.has(group))
+            continue;
+        seenGroups.add(group);
+        const members = group
+            ? Array.from(root.querySelectorAll(`input[type="radio"][name="${CSS.escape(group)}"]`)).filter((m) => m instanceof HTMLInputElement)
+            : [el];
+        if (members.some((m) => m.checked))
+            continue;
+        const first = members.find((m) => !m.disabled);
+        if (first === undefined)
+            continue;
+        first.click();
+        primed += 1;
+    }
+    return primed;
+}

package/fixture/fixture-runtime.js

@@ -32794,95 +32794,7 @@
     }
   }
 
-  // src/fixture-runtime.ts
-  function parseActionEntry(raw) {
-    if (raw === null || typeof raw !== "object") return null;
-    const r = raw;
-    if (typeof r.label !== "string") return null;
-    return { label: r.label };
-  }
-  function parseContract(raw) {
-    const out = {};
-    if (raw === null || typeof raw !== "object") return { actionSpec: out };
-    const v = raw;
-    if (v.actionSpec === null || typeof v.actionSpec !== "object") {
-      return { actionSpec: out };
-    }
-    for (const [name, entry] of Object.entries(
-      v.actionSpec
-    )) {
-      const parsed = parseActionEntry(entry);
-      if (parsed !== null) out[name] = parsed;
-    }
-    return { actionSpec: out };
-  }
-  function installRegistry() {
-    const registry = {
-      react: React3,
-      reactDom: ReactDomClient,
-      primitives: primitives_exports,
-      components: components_exports,
-      compositions: compositions_exports,
-      interact: interact_exports,
-      appComponents: {},
-      wire: dist_exports,
-      adapters: {}
-    };
-    window.__ggui__ = registry;
-    window.__REACT = React3;
-    window.__GGUI_PRIMITIVES = primitives_exports;
-    window.__GGUI_COMPONENTS = components_exports;
-    window.__GGUI_COMPOSITIONS = compositions_exports;
-    window.__GGUI_INTERACT = interact_exports;
-    window.__GGUI_APP_COMPONENTS = registry.appComponents;
-    return registry;
-  }
-  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 = isControlDisabled;
-    const lcName = name.toLowerCase();
-    const lcLabel = label.toLowerCase();
-    const nameKey = norm(name);
-    const labelKey = norm(label);
-    const namesAction = (el) => {
-      const dataAction = (el.getAttribute("data-action") ?? "").toLowerCase();
-      if (dataAction === lcName) return "value";
-      const aria = (el.getAttribute("aria-label") ?? "").toLowerCase();
-      const txt = (el.textContent ?? "").trim().toLowerCase();
-      const ariaNames = aria.length > 0 && (aria.includes(lcLabel) || nameKey.length > 0 && norm(aria).includes(nameKey));
-      const textNames = txt.length > 0 && (txt.includes(lcLabel) || nameKey.length > 0 && norm(txt).includes(nameKey) || labelKey.length > 0 && norm(txt).includes(labelKey));
-      return ariaNames || textNames ? "text" : null;
-    };
-    const disabledEls = every.filter(isDisabled);
-    const disabled = disabledEls.length;
-    const namedDisabled = disabledEls.filter((el) => namesAction(el) !== null).length;
-    const all = every.filter(
-      (el) => !isDisabled(el) && // an already-checked radio fires no change on click — nothing to observe
-      !(el instanceof HTMLInputElement && el.type === "radio" && el.checked)
-    );
-    const byValue = [];
-    const byText = [];
-    const rest = [];
-    for (const el of all) {
-      const how = namesAction(el);
-      if (how === "value") byValue.push(el);
-      else if (how === "text") byText.push(el);
-      else rest.push(el);
-    }
-    return { named: [...byValue, ...byText], fallback: rest, disabled, namedDisabled, allClickables: every };
-  }
+  // src/prime-inputs.ts
   var TEXT_LIKE_INPUT_TYPES = /* @__PURE__ */ new Set([
     "text",
     "email",
@@ -32998,6 +32910,96 @@
     }
     return primed;
   }
+
+  // src/fixture-runtime.ts
+  function parseActionEntry(raw) {
+    if (raw === null || typeof raw !== "object") return null;
+    const r = raw;
+    if (typeof r.label !== "string") return null;
+    return { label: r.label };
+  }
+  function parseContract(raw) {
+    const out = {};
+    if (raw === null || typeof raw !== "object") return { actionSpec: out };
+    const v = raw;
+    if (v.actionSpec === null || typeof v.actionSpec !== "object") {
+      return { actionSpec: out };
+    }
+    for (const [name, entry] of Object.entries(
+      v.actionSpec
+    )) {
+      const parsed = parseActionEntry(entry);
+      if (parsed !== null) out[name] = parsed;
+    }
+    return { actionSpec: out };
+  }
+  function installRegistry() {
+    const registry = {
+      react: React3,
+      reactDom: ReactDomClient,
+      primitives: primitives_exports,
+      components: components_exports,
+      compositions: compositions_exports,
+      interact: interact_exports,
+      appComponents: {},
+      wire: dist_exports,
+      adapters: {}
+    };
+    window.__ggui__ = registry;
+    window.__REACT = React3;
+    window.__GGUI_PRIMITIVES = primitives_exports;
+    window.__GGUI_COMPONENTS = components_exports;
+    window.__GGUI_COMPOSITIONS = compositions_exports;
+    window.__GGUI_INTERACT = interact_exports;
+    window.__GGUI_APP_COMPONENTS = registry.appComponents;
+    return registry;
+  }
+  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 = isControlDisabled;
+    const lcName = name.toLowerCase();
+    const lcLabel = label.toLowerCase();
+    const nameKey = norm(name);
+    const labelKey = norm(label);
+    const namesAction = (el) => {
+      const dataAction = (el.getAttribute("data-action") ?? "").toLowerCase();
+      if (dataAction === lcName) return "value";
+      const aria = (el.getAttribute("aria-label") ?? "").toLowerCase();
+      const txt = (el.textContent ?? "").trim().toLowerCase();
+      const ariaNames = aria.length > 0 && (aria.includes(lcLabel) || nameKey.length > 0 && norm(aria).includes(nameKey));
+      const textNames = txt.length > 0 && (txt.includes(lcLabel) || nameKey.length > 0 && norm(txt).includes(nameKey) || labelKey.length > 0 && norm(txt).includes(labelKey));
+      return ariaNames || textNames ? "text" : null;
+    };
+    const disabledEls = every.filter(isDisabled);
+    const disabled = disabledEls.length;
+    const namedDisabled = disabledEls.filter((el) => namesAction(el) !== null).length;
+    const all = every.filter(
+      (el) => !isDisabled(el) && // an already-checked radio fires no change on click — nothing to observe
+      !(el instanceof HTMLInputElement && el.type === "radio" && el.checked)
+    );
+    const byValue = [];
+    const byText = [];
+    const rest = [];
+    for (const el of all) {
+      const how = namesAction(el);
+      if (how === "value") byValue.push(el);
+      else if (how === "text") byText.push(el);
+      else rest.push(el);
+    }
+    return { named: [...byValue, ...byText], fallback: rest, disabled, namedDisabled, allClickables: every };
+  }
   function countNamedDispatches(actionName) {
     return (window.__ggui_test_dispatches__ ?? []).filter((d) => d.actionName === actionName).length;
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ggui-ai/ui-visual-tester",
-  "version": "0.19.0",
+  "version": "0.20.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",
@@ -35,6 +35,11 @@
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js",
       "default": "./dist/index.js"
+    },
+    "./prime-inputs": {
+      "types": "./dist/prime-inputs.d.ts",
+      "import": "./dist/prime-inputs.js",
+      "default": "./dist/prime-inputs.js"
     }
   },
   "peerDependencies": {
@@ -48,9 +53,9 @@
   "dependencies": {
     "react": "^19.0.0",
     "react-dom": "^19.0.0",
-    "@ggui-ai/design": "0.19.0",
-    "@ggui-ai/wire": "0.19.0",
-    "@ggui-ai/protocol": "0.19.0"
+    "@ggui-ai/design": "0.20.0",
+    "@ggui-ai/protocol": "0.20.0",
+    "@ggui-ai/wire": "0.20.0"
   },
   "devDependencies": {
     "@playwright/test": "^1.60.0",