@ggui-ai/ui-visual-tester 0.18.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,106 +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',
-]);
-function sampleValueFor(el) {
-    const type = el instanceof HTMLInputElement ? el.type : 'textarea';
-    switch (type) {
-        case 'number':
-            return '1';
-        case 'email':
-            return 'probe@example.com';
-        case 'url':
-            return 'https://example.com';
-        case 'tel':
-            return '5550100';
-        case 'date':
-            return '2026-01-15';
-        case 'time':
-            return '09:30';
-        case 'month':
-            return '2026-01';
-        case 'week':
-            return '2026-W03';
-        case 'datetime-local':
-            return '2026-01-15T09:30';
-        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

@@ -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",
@@ -32775,6 +32794,123 @@
     }
   }
 
+  // src/prime-inputs.ts
+  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) {
+    if (!(el instanceof HTMLInputElement)) return "probe";
+    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";
+    }
+  }
+  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 }));
+  }
+  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 !== void 0 && current.value.trim().length > 0) continue;
+      const first = Array.from(el.options).find((o) => o.value.trim().length > 0 && !o.disabled);
+      if (first === void 0) continue;
+      setNativeValue(el, first.value);
+      primed += 1;
+    }
+    const seenGroups = /* @__PURE__ */ 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 === void 0) continue;
+      first.click();
+      primed += 1;
+    }
+    return primed;
+  }
+
   // src/fixture-runtime.ts
   function parseActionEntry(raw) {
     if (raw === null || typeof raw !== "object") return null;
@@ -32864,88 +33000,6 @@
     }
     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",
-    "",
-    "date",
-    "time",
-    "month",
-    "week",
-    "datetime-local"
-  ]);
-  function sampleValueFor(el) {
-    const type = el instanceof HTMLInputElement ? el.type : "textarea";
-    switch (type) {
-      case "number":
-        return "1";
-      case "email":
-        return "probe@example.com";
-      case "url":
-        return "https://example.com";
-      case "tel":
-        return "5550100";
-      case "date":
-        return "2026-01-15";
-      case "time":
-        return "09:30";
-      case "month":
-        return "2026-01";
-      case "week":
-        return "2026-W03";
-      case "datetime-local":
-        return "2026-01-15T09:30";
-      default:
-        return "probe";
-    }
-  }
-  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 }));
-  }
-  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 !== void 0 && current.value.trim().length > 0) continue;
-      const first = Array.from(el.options).find((o) => o.value.trim().length > 0 && !o.disabled);
-      if (first === void 0) continue;
-      setNativeValue(el, first.value);
-      primed += 1;
-    }
-    const seenGroups = /* @__PURE__ */ 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 === void 0) continue;
-      first.click();
-      primed += 1;
-    }
-    return primed;
-  }
   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.18.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.18.0",
-    "@ggui-ai/wire": "0.18.0",
-    "@ggui-ai/protocol": "0.18.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",