@ggui-ai/ui-visual-tester 0.19.0 → 0.21.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":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,KAAK,cAAc,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,gBAAgB,MAAM,4BAA4B,CAAC;AAC/D,OAAO,KAAK,gBAAgB,MAAM,4BAA4B,CAAC;AAC/D,OAAO,KAAK,kBAAkB,MAAM,8BAA8B,CAAC;AACnE,OAAO,KAAK,cAAc,MAAM,0BAA0B,CAAC;AAC3D,OAAO,KAAK,IAAI,MAAM,eAAe,CAAC;AA0CtC,UAAU,cAAc;IACtB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,KAAK,oBAAoB,GAAG,aAAa,GAAG,eAAe,CAAC;AAE5D,UAAU,QAAQ;IAChB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,4EAA4E;IAC5E,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,cAAc,EAAE,oBAAoB,CAAC;IAC9C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,KAAK,UAAU,GACX;IAAE,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GACjE;IAAE,QAAQ,CAAC,MAAM,EAAE,qBAAqB,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GACvE;IAAE,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAAE;AACtE,8FAA8F;GAC5F;IAAE,QAAQ,CAAC,MAAM,EAAE,oBAAoB,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,wBAAwB,GAAG,mBAAmB,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GACvI;IACE,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC;IACtB,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,qGAAqG;IACrG,QAAQ,CAAC,GAAG,CAAC,EAAE,OAAO,GAAG,UAAU,CAAC;IACpC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEN,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd,wBAAwB,CAAC,EAAE,cAAc,EAAE,CAAC;QAC5C,gCAAgC,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;QAC5E,QAAQ,CAAC,EAAE,YAAY,CAAC;QACxB,OAAO,CAAC,EAAE,OAAO,KAAK,CAAC;QACvB,iBAAiB,CAAC,EAAE,OAAO,gBAAgB,CAAC;QAC5C,iBAAiB,CAAC,EAAE,OAAO,gBAAgB,CAAC;QAC5C,mBAAmB,CAAC,EAAE,OAAO,kBAAkB,CAAC;QAChD,eAAe,CAAC,EAAE,OAAO,cAAc,CAAC;QACxC,qBAAqB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACjD;CACF;AAED,UAAU,YAAY;IACpB,KAAK,EAAE,OAAO,KAAK,CAAC;IACpB,QAAQ,EAAE,OAAO,cAAc,CAAC;IAChC,UAAU,EAAE,OAAO,gBAAgB,CAAC;IACpC,UAAU,EAAE,OAAO,gBAAgB,CAAC;IACpC,YAAY,EAAE,OAAO,kBAAkB,CAAC;IACxC,QAAQ,EAAE,OAAO,cAAc,CAAC;IAChC;;;;;;;;OAQG;IACH,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,IAAI,EAAE,OAAO,IAAI,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC"}
+{"version":3,"file":"fixture-runtime.d.ts","sourceRoot":"","sources":["../src/fixture-runtime.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,KAAK,cAAc,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,gBAAgB,MAAM,4BAA4B,CAAC;AAC/D,OAAO,KAAK,gBAAgB,MAAM,4BAA4B,CAAC;AAC/D,OAAO,KAAK,kBAAkB,MAAM,8BAA8B,CAAC;AACnE,OAAO,KAAK,cAAc,MAAM,0BAA0B,CAAC;AAC3D,OAAO,KAAK,IAAI,MAAM,eAAe,CAAC;AA2CtC,UAAU,cAAc;IACtB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,KAAK,oBAAoB,GAAG,aAAa,GAAG,eAAe,CAAC;AAE5D,UAAU,QAAQ;IAChB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,4EAA4E;IAC5E,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,cAAc,EAAE,oBAAoB,CAAC;IAC9C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,KAAK,UAAU,GACX;IAAE,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GACjE;IAAE,QAAQ,CAAC,MAAM,EAAE,qBAAqB,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GACvE;IAAE,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAAE;AACtE,8FAA8F;GAC5F;IAAE,QAAQ,CAAC,MAAM,EAAE,oBAAoB,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,wBAAwB,GAAG,mBAAmB,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GACvI;IACE,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC;IACtB,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,qGAAqG;IACrG,QAAQ,CAAC,GAAG,CAAC,EAAE,OAAO,GAAG,UAAU,CAAC;IACpC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEN,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd,wBAAwB,CAAC,EAAE,cAAc,EAAE,CAAC;QAC5C,gCAAgC,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;QAC5E,QAAQ,CAAC,EAAE,YAAY,CAAC;QACxB,OAAO,CAAC,EAAE,OAAO,KAAK,CAAC;QACvB,iBAAiB,CAAC,EAAE,OAAO,gBAAgB,CAAC;QAC5C,iBAAiB,CAAC,EAAE,OAAO,gBAAgB,CAAC;QAC5C,mBAAmB,CAAC,EAAE,OAAO,kBAAkB,CAAC;QAChD,eAAe,CAAC,EAAE,OAAO,cAAc,CAAC;QACxC,qBAAqB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACjD;CACF;AAED,UAAU,YAAY;IACpB,KAAK,EAAE,OAAO,KAAK,CAAC;IACpB,QAAQ,EAAE,OAAO,cAAc,CAAC;IAChC,UAAU,EAAE,OAAO,gBAAgB,CAAC;IACpC,UAAU,EAAE,OAAO,gBAAgB,CAAC;IACpC,YAAY,EAAE,OAAO,kBAAkB,CAAC;IACxC,QAAQ,EAAE,OAAO,cAAc,CAAC;IAChC;;;;;;;;OAQG;IACH,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,IAAI,EAAE,OAAO,IAAI,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC"}

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":"AA2EA,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,CAYlH;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,CA0CrD"}

package/dist/prime-inputs.js

@@ -0,0 +1,182 @@
+// 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.
+//
+// Realm rule (ggui#1187 follow-up): every constructor this module needs —
+// `HTMLInputElement`, `HTMLTextAreaElement`, `HTMLSelectElement`, `Event` —
+// is read from the ROOT'S OWN window (`ownerDocument.defaultView`), never
+// from ambient globals. The check worker installs happy-dom's `window` and
+// `document` on `globalThis` without the element constructors, so an
+// `instanceof HTMLInputElement` there is a `ReferenceError`, not a `false`;
+// a browser page or vitest's happy-dom environment happens to have them.
+// One code path, every realm.
+/** The realm an element lives in. A detached document has none — that is a caller error, reported as one. */
+function realmOf(el) {
+    const view = el.ownerDocument.defaultView;
+    if (view === null) {
+        throw new Error('primeInputs: the element is not attached to a window (ownerDocument.defaultView is null) — a detached document has no constructors to prime with');
+    }
+    return view;
+}
+// #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 realmOf(el).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 view = realmOf(el);
+    const proto = el instanceof view.HTMLTextAreaElement
+        ? view.HTMLTextAreaElement.prototype
+        : el instanceof view.HTMLSelectElement
+            ? view.HTMLSelectElement.prototype
+            : view.HTMLInputElement.prototype;
+    const setter = Object.getOwnPropertyDescriptor(proto, 'value')?.set;
+    if (setter)
+        setter.call(el, value);
+    else
+        el.value = value;
+    el.dispatchEvent(new view.Event('input', { bubbles: true }));
+    el.dispatchEvent(new view.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) {
+    const view = realmOf(root);
+    let primed = 0;
+    const editable = (el) => !el.disabled && !el.readOnly;
+    for (const el of Array.from(root.querySelectorAll('input, textarea'))) {
+        if (!(el instanceof view.HTMLInputElement || el instanceof view.HTMLTextAreaElement) || !editable(el))
+            continue;
+        if (el instanceof view.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 view.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;
+    }
+    // Radios: one pick per named group; an unnamed radio is its own group.
+    // Grouping is done in JS (by `name` equality), not by re-querying with the
+    // name interpolated into a selector — no `CSS.escape`, no realm dependency.
+    const radios = Array.from(root.querySelectorAll('input[type="radio"]')).filter((m) => m instanceof view.HTMLInputElement);
+    const seenGroups = new Set();
+    for (const el of radios) {
+        if (el.disabled)
+            continue;
+        const group = el.name;
+        if (group !== '') {
+            if (seenGroups.has(group))
+                continue;
+            seenGroups.add(group);
+        }
+        const members = group !== '' ? radios.filter((m) => m.name === group) : [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

@@ -20580,14 +20580,29 @@
     easeInOut: "cubic-bezier(0.4, 0, 0.2, 1)",
     spring: "cubic-bezier(0.175, 0.885, 0.32, 1.275)"
   };
+  var motionVar = {
+    duration: {
+      fast: "var(--ggui-motion-duration-fast)",
+      base: "var(--ggui-motion-duration-base)",
+      slow: "var(--ggui-motion-duration-slow)"
+    },
+    easing: {
+      /** The system's ease-in-out — the default for colour, border and size changes. */
+      standard: "var(--ggui-motion-easing-standard)",
+      /** The decelerating arrival — transforms and entrances. */
+      emphasized: "var(--ggui-motion-easing-emphasized)",
+      /** The accelerating departure. */
+      exit: "var(--ggui-motion-easing-exit)"
+    }
+  };
   var transition = {
     none: "none",
-    fast: `${duration.fast} ${easing.easeInOut}`,
-    normal: `${duration.normal} ${easing.easeInOut}`,
-    slow: `${duration.slow} ${easing.easeInOut}`,
-    colors: `color ${duration.normal} ${easing.easeInOut}, background-color ${duration.normal} ${easing.easeInOut}, border-color ${duration.normal} ${easing.easeInOut}`,
-    opacity: `opacity ${duration.normal} ${easing.easeInOut}`,
-    transform: `transform ${duration.normal} ${easing.easeOut}`
+    fast: `${motionVar.duration.fast} ${motionVar.easing.standard}`,
+    normal: `${motionVar.duration.base} ${motionVar.easing.standard}`,
+    slow: `${motionVar.duration.slow} ${motionVar.easing.standard}`,
+    colors: `color ${motionVar.duration.base} ${motionVar.easing.standard}, background-color ${motionVar.duration.base} ${motionVar.easing.standard}, border-color ${motionVar.duration.base} ${motionVar.easing.standard}`,
+    opacity: `opacity ${motionVar.duration.base} ${motionVar.easing.standard}`,
+    transform: `transform ${motionVar.duration.base} ${motionVar.easing.emphasized}`
   };
 
   // ../design/dist/primitives/Button.js
@@ -20663,7 +20678,7 @@
       cursor: isDisabled ? "not-allowed" : "pointer",
       opacity: isDisabled ? 0.5 : 1,
       width: fullWidth ? "100%" : void 0,
-      transition: `background-color ${duration.normal} ${easing.easeInOut}, box-shadow ${duration.normal} ${easing.easeInOut}, opacity ${duration.normal} ${easing.easeInOut}`,
+      transition: `background-color ${motionVar.duration.base} ${motionVar.easing.standard}, box-shadow ${motionVar.duration.base} ${motionVar.easing.standard}, opacity ${motionVar.duration.base} ${motionVar.easing.standard}`,
       boxShadow: "var(--ggui-shape-shadow-sm, 0 1px 2px rgba(0,0,0,0.05))",
       ...style
     }, ...rest, children: loading ? (0, import_jsx_runtime8.jsx)(Spinner, { size: 16, tone: "inherit" }) : (0, import_jsx_runtime8.jsxs)(import_jsx_runtime8.Fragment, { children: [leftIcon, children, rightIcon] }) });
@@ -20708,7 +20723,7 @@
       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)",
-      transition: `border-color ${duration.normal} ${easing.easeInOut}, box-shadow ${duration.normal} ${easing.easeInOut}`,
+      transition: `border-color ${motionVar.duration.base} ${motionVar.easing.standard}, box-shadow ${motionVar.duration.base} ${motionVar.easing.standard}`,
       boxSizing: "border-box"
     }, ...rest }), hasMessage && (0, import_jsx_runtime9.jsx)("span", { id: messageId, role: hasError ? "alert" : void 0, style: {
       fontSize: "var(--ggui-font-size-xs, 12px)",
@@ -20744,7 +20759,7 @@
       color: "var(--ggui-color-onContainer, #18181b)",
       fontSize: "var(--ggui-font-size-sm, 14px)",
       fontFamily: "inherit",
-      transition: `border-color ${duration.normal} ${easing.easeInOut}, box-shadow ${duration.normal} ${easing.easeInOut}`,
+      transition: `border-color ${motionVar.duration.base} ${motionVar.easing.standard}, box-shadow ${motionVar.duration.base} ${motionVar.easing.standard}`,
       boxSizing: "border-box",
       resize: autoResize ? "none" : "vertical"
     }, ...rest }), (0, import_jsx_runtime10.jsxs)("div", { style: { display: "flex", justifyContent: "space-between" }, children: [hasMessage && (0, import_jsx_runtime10.jsx)("span", { id: messageId, role: hasError ? "alert" : void 0, style: {
@@ -20789,7 +20804,7 @@
       backgroundPosition: "right 12px center",
       paddingRight: "36px",
       boxSizing: "border-box",
-      transition: `border-color ${duration.normal} ${easing.easeInOut}, box-shadow ${duration.normal} ${easing.easeInOut}`
+      transition: `border-color ${motionVar.duration.base} ${motionVar.easing.standard}, box-shadow ${motionVar.duration.base} ${motionVar.easing.standard}`
     }, ...rest, children: [placeholder && (0, import_jsx_runtime11.jsx)("option", { value: "", disabled: true, children: placeholder }), options.map((opt) => (0, import_jsx_runtime11.jsx)("option", { value: opt.value, disabled: opt.disabled, children: opt.label }, opt.value))] }), hasMessage && (0, import_jsx_runtime11.jsx)("span", { id: messageId, role: hasError ? "alert" : void 0, style: {
       fontSize: "var(--ggui-font-size-xs, 12px)",
       color: hasError ? "var(--ggui-color-error-500, #ef4444)" : "var(--ggui-color-onSunken, #52525b)"
@@ -20831,7 +20846,7 @@
       display: "flex",
       alignItems: "center",
       justifyContent: "center",
-      transition: "all 0.2s"
+      transition: `all ${motionVar.duration.base} ${motionVar.easing.standard}`
     }, children: (checked || indeterminate) && (0, import_jsx_runtime12.jsx)("svg", { width: "12", height: "12", viewBox: "0 0 12 12", fill: "none", style: { color: "var(--ggui-color-onPrimary, #ffffff)" }, children: indeterminate ? (0, import_jsx_runtime12.jsx)("path", { d: "M2.5 6H9.5", stroke: "currentColor", strokeWidth: "2", strokeLinecap: "round" }) : (0, import_jsx_runtime12.jsx)("path", { d: "M2.5 6L5 8.5L9.5 3.5", stroke: "currentColor", strokeWidth: "2", strokeLinecap: "round", strokeLinejoin: "round" }) }) })] }), (label || description) && (0, import_jsx_runtime12.jsxs)("div", { style: { display: "flex", flexDirection: "column", gap: "2px" }, children: [label && (0, import_jsx_runtime12.jsx)("span", { style: {
       fontSize: "var(--ggui-font-size-sm, 14px)",
       fontWeight: "var(--ggui-font-weight-medium, 500)",
@@ -20873,7 +20888,7 @@
       borderRadius: "9999px",
       backgroundColor: checked ? "var(--ggui-color-primary-600, #0284c7)" : "var(--ggui-color-outline, #d4d4d8)",
       position: "relative",
-      transition: `background-color ${duration.normal} ${easing.easeInOut}, box-shadow ${duration.normal} ${easing.easeInOut}`,
+      transition: `background-color ${motionVar.duration.base} ${motionVar.easing.standard}, box-shadow ${motionVar.duration.base} ${motionVar.easing.standard}`,
       flexShrink: 0,
       outline: "none",
       boxShadow: focused ? "0 0 0 3px var(--ggui-color-primary-200, #bae6fd)" : void 0
@@ -20885,7 +20900,7 @@
       position: "absolute",
       top: (config.height - config.knob) / 2,
       left: checked ? config.width - config.knob - (config.height - config.knob) / 2 : (config.height - config.knob) / 2,
-      transition: `left ${duration.normal} ${easing.easeInOut}`,
+      transition: `left ${motionVar.duration.base} ${motionVar.easing.standard}`,
       boxShadow: "var(--ggui-shape-shadow-sm, 0 1px 2px rgba(0,0,0,0.05))"
     } }) }), label && (0, import_jsx_runtime13.jsx)("span", { style: {
       fontSize: "var(--ggui-font-size-sm, 14px)",
@@ -20943,7 +20958,7 @@
         display: "flex",
         alignItems: "center",
         justifyContent: "center",
-        transition: "all 0.2s"
+        transition: `all ${motionVar.duration.base} ${motionVar.easing.standard}`
       }, children: isSelected && (0, import_jsx_runtime14.jsx)("div", { style: {
         width: "8px",
         height: "8px",
@@ -20991,7 +21006,7 @@
       height: "6px",
       borderRadius: "3px",
       backgroundColor: disabled ? "var(--ggui-color-outline, #d4d4d8)" : "var(--ggui-color-primary-600, #0284c7)",
-      transition: "width 0.1s"
+      transition: `width ${motionVar.duration.fast} ${motionVar.easing.standard}`
     } }), (0, import_jsx_runtime15.jsx)("input", { id: sliderId, type: "range", min, max, step, value, onChange: (e) => onChange?.(Number(e.target.value)), disabled, "aria-labelledby": label ? labelId : void 0, "aria-label": label ? void 0 : "Slider", "aria-valuenow": value, "aria-valuemin": min, "aria-valuemax": max, style: {
       position: "absolute",
       width: "100%",
@@ -21009,7 +21024,7 @@
       backgroundColor: "#ffffff",
       border: `2px solid ${disabled ? "var(--ggui-color-outline, #d4d4d8)" : "var(--ggui-color-primary-600, #0284c7)"}`,
       boxShadow: "var(--ggui-shape-shadow-sm, 0 1px 2px rgba(0,0,0,0.05))",
-      transition: "left 0.1s",
+      transition: `left ${motionVar.duration.fast} ${motionVar.easing.standard}`,
       pointerEvents: "none"
     } })] })] });
   }
@@ -21237,7 +21252,7 @@
       height: "100%",
       borderRadius: height / 2,
       backgroundColor: barColor,
-      transition: indeterminate ? "none" : "width 0.3s ease",
+      transition: indeterminate ? "none" : `width ${motionVar.duration.slow} ${motionVar.easing.standard}`,
       ...indeterminate ? {
         width: "30%",
         animation: "ggui-progress-indeterminate 1.5s ease-in-out infinite"
@@ -25869,7 +25884,7 @@
       color: linkColor,
       textDecoration: underlineStyle,
       cursor: "pointer",
-      transition: "color 0.2s",
+      transition: `color ${motionVar.duration.base} ${motionVar.easing.standard}`,
       ...style
     }, onMouseEnter: (e) => {
       if (underline === "hover") {
@@ -26029,7 +26044,7 @@
       cursor: col.sortable ? "pointer" : "default"
     }, children: (0, import_jsx_runtime25.jsxs)("span", { style: { display: "inline-flex", alignItems: "center" }, children: [col.header, col.sortable && sortIndicator(sortKey === col.key, sortDirection)] }) }, col.key)) }) }), (0, import_jsx_runtime25.jsx)("tbody", { children: data.map((row, rowIndex) => (0, import_jsx_runtime25.jsx)("tr", { onMouseEnter: hoverable ? () => setHoveredRow(rowIndex) : void 0, onMouseLeave: hoverable ? () => setHoveredRow(null) : void 0, style: {
       backgroundColor: hoverable && hoveredRow === rowIndex ? "var(--ggui-color-sunken, #fafafa)" : striped && rowIndex % 2 === 1 ? "var(--ggui-color-sunken, #fafafa)" : "transparent",
-      transition: "background-color 0.15s ease"
+      transition: `background-color ${motionVar.duration.fast} ${motionVar.easing.standard}`
     }, children: columns.map((col) => (0, import_jsx_runtime25.jsx)("td", { style: {
       padding: cellPadding,
       textAlign: col.align || "left",
@@ -26103,7 +26118,7 @@
         background: "none",
         border: "none",
         fontWeight: isActive ? "var(--ggui-font-weight-semibold, 600)" : "var(--ggui-font-weight-medium, 500)",
-        transition: `color ${duration.normal} ${easing.easeInOut}, background-color ${duration.normal} ${easing.easeInOut}, border-color ${duration.normal} ${easing.easeInOut}`,
+        transition: `color ${motionVar.duration.base} ${motionVar.easing.standard}, background-color ${motionVar.duration.base} ${motionVar.easing.standard}, border-color ${motionVar.duration.base} ${motionVar.easing.standard}`,
         whiteSpace: "nowrap",
         flex: fullWidth ? 1 : void 0,
         justifyContent: fullWidth ? "center" : void 0
@@ -26397,7 +26412,7 @@
   var import_jsx_runtime28 = __toESM(require_jsx_runtime(), 1);
   var import_react18 = __toESM(require_react(), 1);
   var chevron = (expanded) => (0, import_jsx_runtime28.jsx)("svg", { width: "16", height: "16", viewBox: "0 0 20 20", fill: "currentColor", "aria-hidden": "true", style: {
-    transition: `transform ${duration.normal} ${easing.easeInOut}`,
+    transition: `transform ${motionVar.duration.base} ${motionVar.easing.standard}`,
     transform: expanded ? "rotate(180deg)" : "rotate(0deg)",
     flexShrink: 0
   }, children: (0, import_jsx_runtime28.jsx)("path", { fillRule: "evenodd", d: "M5.293 7.293a1 1 0 011.414 0L10 10.586l3.293-3.293a1 1 0 111.414 1.414l-4 4a1 1 0 01-1.414 0l-4-4a1 1 0 010-1.414z", clipRule: "evenodd" }) });
@@ -26470,7 +26485,7 @@
         fontWeight: "var(--ggui-font-weight-medium, 500)",
         color: "var(--ggui-color-onContainer, #18181b)",
         textAlign: "left",
-        transition: `background-color ${duration.fast} ${easing.easeInOut}`
+        transition: `background-color ${motionVar.duration.fast} ${motionVar.easing.standard}`
       }, children: [(0, import_jsx_runtime28.jsx)("span", { children: item.title }), chevron(isExpanded)] }) }), (0, import_jsx_runtime28.jsx)("div", { id: `${uniqueId}-panel-${item.key}`, role: "region", "aria-labelledby": `${uniqueId}-header-${item.key}`, hidden: !isExpanded, style: {
         overflow: "hidden"
       }, children: isExpanded && (0, import_jsx_runtime28.jsx)("div", { style: {
@@ -26644,7 +26659,7 @@
       fontWeight: active ? fontWeight.medium : fontWeight.normal,
       textAlign: "left",
       cursor: disabled ? "not-allowed" : "pointer",
-      transition: "background-color 0.15s",
+      transition: `background-color ${motionVar.duration.fast} ${motionVar.easing.standard}`,
       ...style
     }, onMouseEnter: (e) => {
       if (!disabled && !active) {
@@ -26962,7 +26977,7 @@
       fontWeight: active ? fontWeight.medium : fontWeight.normal,
       cursor: disabled ? "not-allowed" : "pointer",
       opacity: disabled ? 0.5 : 1,
-      transition: "all 0.15s"
+      transition: `all ${motionVar.duration.fast} ${motionVar.easing.standard}`
     }, children: page });
     return (0, import_jsx_runtime36.jsxs)("nav", { "aria-label": "Pagination", className, style: {
       display: "flex",
@@ -27030,7 +27045,7 @@
       justifyContent: "center",
       flexShrink: 0,
       boxSizing: "border-box",
-      transition: "background-color 0.2s, border-color 0.2s, color 0.2s",
+      transition: `background-color ${motionVar.duration.base} ${motionVar.easing.standard}, border-color ${motionVar.duration.base} ${motionVar.easing.standard}, color ${motionVar.duration.base} ${motionVar.easing.standard}`,
       ...markerStyles[state]
     }, children: state === "completed" ? (0, import_jsx_runtime39.jsx)(Icon, { name: "check", size: 16, tone: "inherit" }) : (0, import_jsx_runtime39.jsx)(Text, { is: "span", size: "sm", weight: "semibold", tone: "inherit", children: index + 1 }) });
   }
@@ -29561,6 +29576,14 @@
       "--ggui-font-weight-normal",
       "--ggui-font-weight-semibold",
       "--ggui-letter-spacing-heading",
+      "--ggui-motion-duration-base",
+      "--ggui-motion-duration-fast",
+      "--ggui-motion-duration-slow",
+      "--ggui-motion-easing-emphasized",
+      "--ggui-motion-easing-exit",
+      "--ggui-motion-easing-standard",
+      "--ggui-scrim-opacity",
+      "--ggui-scrim-tint",
       "--ggui-shape-radius-control",
       "--ggui-shape-radius-full",
       "--ggui-shape-radius-lg",
@@ -32534,6 +32557,7 @@
     "duration",
     "easing",
     "transition",
+    "motionVar",
     "keyframes",
     "thinkingAnimation",
     "thinkingKeyframes",
@@ -32794,94 +32818,13 @@
     }
   }
 
-  // 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;
+  // src/prime-inputs.ts
+  function realmOf(el) {
+    const view = el.ownerDocument.defaultView;
+    if (view === null) {
+      throw new Error("primeInputs: the element is not attached to a window (ownerDocument.defaultView is null) \u2014 a detached document has no constructors to prime with");
     }
-    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 };
+    return view;
   }
   var TEXT_LIKE_INPUT_TYPES = /* @__PURE__ */ new Set([
     "text",
@@ -32921,7 +32864,7 @@
     return `${date.getUTCFullYear()}-W${pad2(week)}`;
   }
   function sampleValueFor(el) {
-    if (!(el instanceof HTMLInputElement)) return "probe";
+    if (!(el instanceof realmOf(el).HTMLInputElement)) return "probe";
     switch (el.type) {
       case "number":
         return "1";
@@ -32957,25 +32900,27 @@
     }
   }
   function setNativeValue(el, value) {
-    const proto = el instanceof HTMLTextAreaElement ? HTMLTextAreaElement.prototype : el instanceof HTMLSelectElement ? HTMLSelectElement.prototype : HTMLInputElement.prototype;
+    const view = realmOf(el);
+    const proto = el instanceof view.HTMLTextAreaElement ? view.HTMLTextAreaElement.prototype : el instanceof view.HTMLSelectElement ? view.HTMLSelectElement.prototype : view.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 }));
+    el.dispatchEvent(new view.Event("input", { bubbles: true }));
+    el.dispatchEvent(new view.Event("change", { bubbles: true }));
   }
   function primeInputs(root) {
+    const view = realmOf(root);
     let primed = 0;
-    const editable = (el) => !el.disabled && !(el instanceof HTMLSelectElement) ? !el.readOnly : !el.disabled;
+    const editable = (el) => !el.disabled && !el.readOnly;
     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 instanceof view.HTMLInputElement || el instanceof view.HTMLTextAreaElement) || !editable(el)) continue;
+      if (el instanceof view.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;
+      if (!(el instanceof view.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);
@@ -32983,13 +32928,18 @@
       setNativeValue(el, first.value);
       primed += 1;
     }
+    const radios = Array.from(root.querySelectorAll('input[type="radio"]')).filter(
+      (m) => m instanceof view.HTMLInputElement
+    );
     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];
+    for (const el of radios) {
+      if (el.disabled) continue;
+      const group = el.name;
+      if (group !== "") {
+        if (seenGroups.has(group)) continue;
+        seenGroups.add(group);
+      }
+      const members = group !== "" ? radios.filter((m) => m.name === group) : [el];
       if (members.some((m) => m.checked)) continue;
       const first = members.find((m) => !m.disabled);
       if (first === void 0) continue;
@@ -32998,6 +32948,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.21.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/protocol": "0.21.0",
+    "@ggui-ai/design": "0.21.0",
+    "@ggui-ai/wire": "0.21.0"
   },
   "devDependencies": {
     "@playwright/test": "^1.60.0",