@ggui-ai/ui-visual-tester 0.24.0 → 0.26.0

package/README.md

@@ -1,6 +1,6 @@
 # @ggui-ai/ui-visual-tester
 
-Behavioral validator for [ggui](https://ggui.ai)-generated component code.
+Behavioral validator for [GGUI](https://ggui.ai)-generated component code.
 
 Structural validators (schema checks, wire-preservation, compile/lint)
 confirm that a component is _shaped_ correctly. They cannot tell you

package/fixture/fixture-runtime.js

@@ -20121,7 +20121,7 @@
     const inkAlias = "--ggui-surface-" + name + "-ink";
     const B = "var(" + bgAlias + ")";
     const I = "var(" + inkAlias + ")";
-    return `.${cls}{${bgAlias}:${bg};${inkAlias}:${ink};--ggui-color-onInverted:${ink}}.${cls}>*{--ggui-color-container:${B};--ggui-color-onContainer:${I};--ggui-color-elevated:${B};--ggui-color-onElevated:${I};--ggui-color-sunken:${B};--ggui-color-onSunken:${I};--ggui-color-neutral-500:${I};--ggui-color-ground:${B};--ggui-color-onGround:${I};--ggui-color-link:${accent}}@supports (color: color-mix(in srgb, red, blue)){.${cls}>*{--ggui-color-container:color-mix(in srgb, ${B} 94%, ${I});--ggui-color-elevated:color-mix(in srgb, ${B} 92%, ${I});--ggui-color-sunken:color-mix(in srgb, ${B} 88%, ${I});--ggui-color-onSunken:color-mix(in srgb, ${I} 76%, ${B});--ggui-color-neutral-500:color-mix(in srgb, ${I} 62%, ${B});--ggui-color-outline:${outlineOpen}color-mix(in srgb, ${I} 32%, ${B}));--ggui-color-outlineVariant:color-mix(in srgb, ${I} 18%, ${B})}}`;
+    return `.${cls}{${bgAlias}:${bg};${inkAlias}:${ink};--ggui-color-onInverted:${ink}}.${cls}>*{--ggui-color-container:${B};--ggui-color-onContainer:${I};--ggui-color-elevated:${B};--ggui-color-onElevated:${I};--ggui-color-sunken:${B};--ggui-color-onSunken:${I};--ggui-color-neutral-500:${I};--ggui-color-ground:${B};--ggui-color-onGround:${I};--ggui-color-link:${accent};--ggui-color-controlAccentOutline:${accent}}@supports (color: color-mix(in srgb, red, blue)){.${cls}>*{--ggui-color-container:color-mix(in srgb, ${B} 94%, ${I});--ggui-color-elevated:color-mix(in srgb, ${B} 92%, ${I});--ggui-color-sunken:color-mix(in srgb, ${B} 88%, ${I});--ggui-color-onSunken:color-mix(in srgb, ${I} 76%, ${B});--ggui-color-neutral-500:color-mix(in srgb, ${I} 62%, ${B});--ggui-color-outline:${outlineOpen}color-mix(in srgb, ${I} 32%, ${B}));--ggui-color-controlOutline:${outlineOpen}color-mix(in srgb, ${I} 32%, ${B}));--ggui-color-outlineVariant:color-mix(in srgb, ${I} 18%, ${B})}}`;
   }
   var INVERTED_SCOPE_CSS = surfaceScopeCss(
     INVERTED_SCOPE_CLASS,
@@ -20657,7 +20657,8 @@
     },
     secondary: {
       backgroundColor: "var(--ggui-color-sunken, #f4f4f5)",
-      color: "var(--ggui-color-onSunken, #52525b)",
+      // The label reads at full strength; the chip marks the rank (ggui#1566).
+      color: "var(--ggui-color-onContainer, #18181b)",
       border: "none"
     },
     outline: {
@@ -20666,13 +20667,15 @@
       // label is the surface's own on-colour, never a brand-ladder stop
       // (ggui#1034): `primary-600` as the label read mid-grey on a monochrome
       // dark theme's ground — 2.41:1 / 3.5:1 on served reply chips. The brand
-      // stays on the border, where contrast is decorative.
+      // stays on the border, and the border identifies the control, so it is the
+      // first brand stop that clears 3:1 on the container (ggui#1494).
       color: "var(--ggui-color-onContainer, #18181b)",
-      border: "1px solid var(--ggui-color-primary-600, #0284c7)"
+      border: "1px solid var(--ggui-color-controlAccentOutline, var(--ggui-color-primary-600, #0284c7))"
     },
     ghost: {
       backgroundColor: "transparent",
-      color: "var(--ggui-color-onSunken, #52525b)",
+      // A dimmed label reads as disabled; ghost's rank is its missing chrome (ggui#1566).
+      color: "var(--ggui-color-onContainer, #18181b)",
       border: "none"
     },
     danger: {
@@ -20738,7 +20741,7 @@
       ...sizeStyles2[size],
       width: "100%",
       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)"}`,
+      border: `1px solid ${hasError ? "var(--ggui-color-error-500, #ef4444)" : "var(--ggui-color-controlOutline, 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 ${motionVar.duration.base} ${motionVar.easing.standard}, box-shadow ${motionVar.duration.base} ${motionVar.easing.standard}`,
@@ -20772,7 +20775,7 @@
       padding: "10px 12px",
       width: "100%",
       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)"}`,
+      border: `1px solid ${hasError ? "var(--ggui-color-error-500, #ef4444)" : "var(--ggui-color-controlOutline, var(--ggui-color-outline, #d4d4d8))"}`,
       backgroundColor: disabled ? "var(--ggui-color-sunken, #fafafa)" : "var(--ggui-color-sunken, #ffffff)",
       color: "var(--ggui-color-onContainer, #18181b)",
       fontSize: "var(--ggui-font-size-sm, 14px)",
@@ -20804,17 +20807,25 @@
     const messageId = `${uniqueId}-message`;
     const hasError = Boolean(error);
     const hasMessage = Boolean(error || helperText);
+    const startsOnPlaceholder = Boolean(placeholder) && value === void 0 && rest.defaultValue === void 0;
+    const [uncontrolledValue, setUncontrolledValue] = (0, import_react7.useState)(startsOnPlaceholder ? "" : typeof rest.defaultValue === "string" ? rest.defaultValue : void 0);
+    const showingPlaceholder = Boolean(placeholder) && (value ?? uncontrolledValue) === "";
     return (0, import_jsx_runtime11.jsxs)("div", { className, style: { display: "flex", flexDirection: "column", gap: "var(--ggui-spacing-1, 4px)", ...style }, children: [label && (0, import_jsx_runtime11.jsxs)("label", { htmlFor: selectId, style: {
       fontSize: "var(--ggui-font-size-sm, 14px)",
       fontWeight: "var(--ggui-font-weight-medium, 500)",
       color: "var(--ggui-color-onSunken, #52525b)"
-    }, 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: {
+    }, 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, ...startsOnPlaceholder ? { defaultValue: "" } : {}, onChange: (e) => {
+      if (value === void 0)
+        setUncontrolledValue(e.target.value);
+      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-control, var(--ggui-shape-radius-md, 8px))",
-      border: `1px solid ${hasError ? "var(--ggui-color-error-500, #ef4444)" : "var(--ggui-color-outline, #d4d4d8)"}`,
+      border: `1px solid ${hasError ? "var(--ggui-color-error-500, #ef4444)" : "var(--ggui-color-controlOutline, 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)",
+      // Muted only while the placeholder is what shows (ggui#1566, #1569).
+      color: showingPlaceholder ? "var(--ggui-color-onSunken, #52525b)" : "var(--ggui-color-onContainer, #18181b)",
       cursor: disabled ? "not-allowed" : "pointer",
       appearance: "none",
       backgroundImage: `url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='12' height='12' viewBox='0 0 12 12'%3E%3Cpath fill='%236b7280' d='M3 4.5L6 7.5L9 4.5'/%3E%3C/svg%3E")`,
@@ -20859,7 +20870,7 @@
       width: "18px",
       height: "18px",
       borderRadius: "var(--ggui-shape-radius-sm, 4px)",
-      border: `2px solid ${checked || indeterminate ? "var(--ggui-color-primary-600, #0284c7)" : "var(--ggui-color-outline, #d4d4d8)"}`,
+      border: `2px solid ${checked || indeterminate ? "var(--ggui-color-primary-600, #0284c7)" : "var(--ggui-color-controlOutline, var(--ggui-color-outline, #d4d4d8))"}`,
       backgroundColor: checked || indeterminate ? "var(--ggui-color-primary-600, #0284c7)" : "var(--ggui-color-sunken, #ffffff)",
       display: "flex",
       alignItems: "center",
@@ -20868,7 +20879,7 @@
     }, 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)",
-      color: "var(--ggui-color-onSunken, #52525b)"
+      color: "var(--ggui-color-onContainer, #18181b)"
     }, children: label }), description && (0, import_jsx_runtime12.jsx)("span", { style: {
       fontSize: "var(--ggui-font-size-xs, 12px)",
       color: "var(--ggui-color-onSunken, #52525b)"
@@ -20904,7 +20915,7 @@
       width: config.width,
       height: config.height,
       borderRadius: "9999px",
-      backgroundColor: checked ? "var(--ggui-color-primary-600, #0284c7)" : "var(--ggui-color-outline, #d4d4d8)",
+      backgroundColor: checked ? "var(--ggui-color-primary-600, #0284c7)" : "var(--ggui-color-controlOutline, var(--ggui-color-outline, #d4d4d8))",
       position: "relative",
       transition: `background-color ${motionVar.duration.base} ${motionVar.easing.standard}, box-shadow ${motionVar.duration.base} ${motionVar.easing.standard}`,
       flexShrink: 0,
@@ -20923,7 +20934,7 @@
     } }) }), label && (0, import_jsx_runtime13.jsx)("span", { style: {
       fontSize: "var(--ggui-font-size-sm, 14px)",
       fontWeight: "var(--ggui-font-weight-medium, 500)",
-      color: "var(--ggui-color-onSunken, #52525b)"
+      color: "var(--ggui-color-onContainer, #18181b)"
     }, children: label })] });
   }
 
@@ -20971,7 +20982,7 @@
         width: "18px",
         height: "18px",
         borderRadius: "var(--ggui-shape-radius-full, 9999px)",
-        border: `2px solid ${isSelected ? "var(--ggui-color-primary-600, #0284c7)" : "var(--ggui-color-outline, #d4d4d8)"}`,
+        border: `2px solid ${isSelected ? "var(--ggui-color-primary-600, #0284c7)" : "var(--ggui-color-controlOutline, var(--ggui-color-outline, #d4d4d8))"}`,
         backgroundColor: "var(--ggui-color-sunken, #ffffff)",
         display: "flex",
         alignItems: "center",
@@ -20985,7 +20996,7 @@
       } }) })] }), (0, import_jsx_runtime14.jsxs)("div", { style: { display: "flex", flexDirection: "column", gap: "2px" }, children: [(0, import_jsx_runtime14.jsx)("span", { style: {
         fontSize: "var(--ggui-font-size-sm, 14px)",
         fontWeight: "var(--ggui-font-weight-medium, 500)",
-        color: "var(--ggui-color-onSunken, #52525b)"
+        color: "var(--ggui-color-onContainer, #18181b)"
       }, children: option.label }), option.description && (0, import_jsx_runtime14.jsx)("span", { style: {
         fontSize: "var(--ggui-font-size-xs, 12px)",
         color: "var(--ggui-color-onSunken, #52525b)"
@@ -26043,7 +26054,9 @@
       width: "100%",
       borderCollapse: "collapse",
       fontSize: "var(--ggui-font-size-sm, 14px)",
-      color: "var(--ggui-color-onSunken, #52525b)"
+      // Body cells are the data and inherit this (ggui#1566); the header and
+      // caption set the muted tier themselves.
+      color: "var(--ggui-color-onContainer, #18181b)"
     }, children: [caption && (0, import_jsx_runtime25.jsx)("caption", { style: {
       padding: cellPadding,
       fontSize: "var(--ggui-font-size-sm, 14px)",
@@ -26509,7 +26522,7 @@
       }, children: isExpanded && (0, import_jsx_runtime28.jsx)("div", { style: {
         padding: "0 var(--ggui-spacing-4, 16px) var(--ggui-spacing-4, 16px)",
         fontSize: "var(--ggui-font-size-sm, 14px)",
-        color: "var(--ggui-color-onSunken, #52525b)",
+        color: "var(--ggui-color-onContainer, #18181b)",
         lineHeight: "var(--ggui-font-lineHeight-normal, 1.5)"
       }, children: item.content }) })] }, item.key);
     }) });
@@ -26626,7 +26639,7 @@
       paddingLeft: "36px",
       fontSize: size === "lg" ? "16px" : "14px",
       borderRadius: "6px",
-      border: `1px solid var(--ggui-color-outline, #d1d5db)`,
+      border: `1px solid var(--ggui-color-controlOutline, var(--ggui-color-outline, #d1d5db))`,
       backgroundColor: disabled ? "var(--ggui-color-sunken, #f9fafb)" : "var(--ggui-color-container, #ffffff)",
       color: "var(--ggui-color-onContainer, #111827)",
       outline: "none",
@@ -27824,14 +27837,17 @@
         padding: "10px 14px",
         borderRadius: radius.lg,
         backgroundColor: isOwn ? "var(--ggui-color-primary-600, #0284c7)" : "var(--ggui-color-sunken, #f3f4f6)",
-        color: isOwn ? "var(--ggui-color-onPrimary, #ffffff)" : "var(--ggui-color-onSunken, #111827)"
+        color: isOwn ? "var(--ggui-color-onPrimary, #ffffff)" : "var(--ggui-color-onContainer, #111827)"
       }, children: [(0, import_jsx_runtime46.jsx)("p", { style: { margin: 0, fontSize: fontSize.sm }, children: message.content }), (0, import_jsx_runtime46.jsxs)("div", { style: {
         display: "flex",
         alignItems: "center",
         gap: "4px",
         marginTop: "4px",
         fontSize: fontSize.xs,
-        opacity: 0.7
+        // Own messages derive the muted line from onPrimary; the other
+        // party's message now reads at onContainer, so its timestamp
+        // takes the muted tier itself (ggui#1566).
+        ...isOwn ? { opacity: 0.7 } : { color: "var(--ggui-color-onSunken, #52525b)" }
       }, children: [(0, import_jsx_runtime46.jsx)("span", { children: timestamp }), isOwn && message.status && (0, import_jsx_runtime46.jsxs)("span", { children: [message.status === "sending" && "\u2022", message.status === "sent" && "\u2713", message.status === "delivered" && "\u2713\u2713", message.status === "read" && "\u2713\u2713", message.status === "error" && "!"] })] })] })] }, message.id);
     }), typing && (0, import_jsx_runtime46.jsx)("div", { style: { display: "flex", alignItems: "center", gap: "8px" }, children: (0, import_jsx_runtime46.jsxs)("span", { style: { fontSize: fontSize.xs, color: "var(--ggui-color-neutral-500, #6b7280)" }, children: [typing.name, " is typing..."] }) }), (0, import_jsx_runtime46.jsx)("div", { ref: messagesEndRef })] }), (0, import_jsx_runtime46.jsxs)("div", { style: {
       padding: "12px 16px",
@@ -27841,7 +27857,7 @@
     }, children: [(0, import_jsx_runtime46.jsx)("input", { type: "text", value: inputValue, onChange: (e) => setInputValue(e.target.value), onKeyDown: handleKeyDown, placeholder, style: {
       flex: 1,
       padding: "10px 14px",
-      border: `1px solid var(--ggui-color-outline, #d1d5db)`,
+      border: `1px solid var(--ggui-color-controlOutline, var(--ggui-color-outline, #d1d5db))`,
       borderRadius: radius.full,
       fontSize: fontSize.sm,
       outline: "none"
@@ -27953,7 +27969,7 @@
       setIsDragOver(false);
     };
     return (0, import_jsx_runtime48.jsxs)("div", { className, style: { ...style }, children: [(0, import_jsx_runtime48.jsxs)("div", { onClick: () => !disabled && inputRef.current?.click(), onDrop: handleDrop, onDragOver: handleDragOver, onDragLeave: handleDragLeave, style: {
-      border: `2px dashed ${isDragOver ? "var(--ggui-color-primary-400, #38bdf8)" : "var(--ggui-color-outline, #d1d5db)"}`,
+      border: `2px dashed ${isDragOver ? "var(--ggui-color-primary-400, #38bdf8)" : "var(--ggui-color-controlOutline, var(--ggui-color-outline, #d1d5db))"}`,
       borderRadius: radius.lg,
       padding: "32px",
       textAlign: "center",
@@ -28436,7 +28452,7 @@
       fontWeight: fontWeight.semibold,
       color: showOverlay ? "#ffffff" : "var(--ggui-color-onContainer, #374151)",
       backgroundColor: "transparent",
-      border: `1px solid ${showOverlay ? "rgba(255,255,255,0.3)" : "var(--ggui-color-outline, #d1d5db)"}`,
+      border: `1px solid ${showOverlay ? "rgba(255,255,255,0.3)" : "var(--ggui-color-controlOutline, var(--ggui-color-outline, #d1d5db))"}`,
       borderRadius: "8px",
       cursor: "pointer",
       transition: "all 0.15s",
@@ -28577,6 +28593,7 @@
     buildWireConfig: () => buildWireConfig,
     connectionSource: () => connectionSource,
     useAction: () => useAction,
+    useActionPending: () => useActionPending,
     useActionSpent: () => useActionSpent,
     useApp: () => useApp,
     useAuth: () => useAuth,
@@ -28679,8 +28696,19 @@
     return (0, import_react35.useSyncExternalStore)(subscribe, read, read);
   }
 
-  // ../wire/dist/useGguiContext.js
+  // ../wire/dist/action-pending.js
   var import_react36 = __toESM(require_react(), 1);
+  var ActionPendingContext = (0, import_react36.createContext)(null);
+  var noSubscription2 = () => () => void 0;
+  function useActionPending(actionName) {
+    const source = (0, import_react36.useContext)(ActionPendingContext);
+    const subscribe = (0, import_react36.useCallback)((listener) => source === null ? noSubscription2() : source.subscribe(listener), [source]);
+    const read = (0, import_react36.useCallback)(() => source === null ? false : source.isPending(actionName), [source, actionName]);
+    return (0, import_react36.useSyncExternalStore)(subscribe, read, read);
+  }
+
+  // ../wire/dist/useGguiContext.js
+  var import_react37 = __toESM(require_react(), 1);
   function useGguiContext(slotName) {
     const contextName = slotName.length === 0 ? "Context" : slotName.charAt(0).toUpperCase() + slotName.slice(1) + "Context";
     const registry = globalThis.__ggui__?.contexts;
@@ -28688,19 +28716,19 @@
     if (!ctx) {
       throw new Error(`[ggui] useGguiContext('${slotName}'): no Context registered. The contract must declare 'contextSpec.${slotName}' AND the runtime must have synthesized the per-slot React Context at boot. If you see this in production code generated by the LLM, the boilerplate's destructure line drifted from the contract.`);
     }
-    return (0, import_react36.useContext)(ctx);
+    return (0, import_react37.useContext)(ctx);
   }
 
   // ../wire/dist/useStream.js
-  var import_react37 = __toESM(require_react(), 1);
+  var import_react38 = __toESM(require_react(), 1);
   function useStream(channelName) {
     const { subscribe } = useWireContext();
-    const [latest, setLatest] = (0, import_react37.useState)(null);
-    const [all, setAll] = (0, import_react37.useState)([]);
-    const [isComplete, setIsComplete] = (0, import_react37.useState)(false);
-    const allRef = (0, import_react37.useRef)(all);
+    const [latest, setLatest] = (0, import_react38.useState)(null);
+    const [all, setAll] = (0, import_react38.useState)([]);
+    const [isComplete, setIsComplete] = (0, import_react38.useState)(false);
+    const allRef = (0, import_react38.useRef)(all);
     allRef.current = all;
-    (0, import_react37.useEffect)(() => {
+    (0, import_react38.useEffect)(() => {
       return subscribe(channelName, (delivery) => {
         const typed = delivery.payload;
         setLatest(typed);
@@ -28738,7 +28766,7 @@
   }
 
   // ../wire/dist/useRender.js
-  var import_react38 = __toESM(require_react(), 1);
+  var import_react39 = __toESM(require_react(), 1);
 
   // ../wire/dist/connection-store.js
   var ConnectionWriterConflictError = class extends Error {
@@ -28835,7 +28863,7 @@
   // ../wire/dist/useRender.js
   function useRender() {
     const { render } = useWireContext();
-    const isConnected = (0, import_react38.useSyncExternalStore)(connectionSource.subscribe, connectionSource.getSnapshot, connectionSource.getSnapshot);
+    const isConnected = (0, import_react39.useSyncExternalStore)(connectionSource.subscribe, connectionSource.getSnapshot, connectionSource.getSnapshot);
     return { sessionId: render.sessionId, isConnected };
   }
 
@@ -29411,6 +29439,7 @@
       }
     }
   };
+  var DEFAULT_ACTION_PENDING_BOUND_MS = 2e4;
   function buildWireConfig(opts) {
     let internalSeq = 0;
     const nextClientSeq = opts.nextClientSeq ?? (() => {
@@ -29435,8 +29464,43 @@
       }
     };
     opts.spentInputsChanged?.(notifySpent);
+    const pendingBoundMs = opts.actionPendingBoundMs ?? DEFAULT_ACTION_PENDING_BOUND_MS;
+    const pending = /* @__PURE__ */ new Map();
+    const pendingListeners = /* @__PURE__ */ new Set();
+    const notifyPending = () => {
+      for (const listener of [...pendingListeners])
+        listener();
+    };
+    const markPending = (actionName) => {
+      const previous = pending.get(actionName);
+      if (previous !== void 0)
+        clearTimeout(previous);
+      pending.set(actionName, setTimeout(() => {
+        pending.delete(actionName);
+        notifyPending();
+      }, pendingBoundMs));
+      notifyPending();
+    };
+    const actionPending = {
+      isPending: (actionName) => pending.has(actionName),
+      subscribe: (listener) => {
+        pendingListeners.add(listener);
+        return () => {
+          pendingListeners.delete(listener);
+        };
+      }
+    };
+    opts.pendingInputsChanged?.(() => {
+      if (pending.size === 0)
+        return;
+      for (const timer of pending.values())
+        clearTimeout(timer);
+      pending.clear();
+      notifyPending();
+    });
     return {
       actionSpent,
+      actionPending,
       app: opts.app,
       render: opts.render,
       auth: opts.auth,
@@ -29469,6 +29533,7 @@
         const result = validateEnvelope(actionSpec, envelope);
         if (!result.valid) {
           opts.onViolation(new ClientContractViolationError("outbound-action", result.violations));
+          opts.onDispatchRefused?.({ actionName, violations: result.violations });
           return;
         }
         if (isOneShot && !spentOneShots.has(actionName)) {
@@ -29476,6 +29541,7 @@
           notifySpent();
         }
         opts.emitEnvelope(envelope);
+        markPending(actionName);
       },
       subscribe: (channelName, handler) => {
         return opts.streamBus.subscribe(channelName, (env) => {
@@ -29530,6 +29596,8 @@
     version: 2,
     tokens: [
       "--ggui-color-container",
+      "--ggui-color-controlAccentOutline",
+      "--ggui-color-controlOutline",
       "--ggui-color-elevated",
       "--ggui-color-error",
       "--ggui-color-error-100",
@@ -30161,8 +30229,10 @@
       // paper
       sunken: { $value: "#292929", $type: "color" },
       // ink
-      onSunken: { $value: "#d9d9d9", $type: "color" },
-      // chrome
+      // Muted text, and text on sunken grounds (ggui#1566): the kit's dark muted
+      // value, 6.57:1 on container and 5.80:1 on sunken. Light's onSunken is ink-3,
+      // the same tier, so dark now reads as light already does.
+      onSunken: { $value: "#a3a3a9", $type: "color" },
       container: { $value: "#1f1f1f", $type: "color" },
       // ink
       onContainer: { $value: "#f4f3ed", $type: "color" },
@@ -32469,12 +32539,18 @@
 
   // ../design/dist/themes/ThemeProvider.js
   var import_jsx_runtime58 = __toESM(require_jsx_runtime(), 1);
-  var import_react39 = __toESM(require_react(), 1);
-  var ThemeContext = (0, import_react39.createContext)(null);
+  var import_react40 = __toESM(require_react(), 1);
+  var ThemeContext = (0, import_react40.createContext)(null);
 
   // ../design/dist/rendering/css-tokens.js
   var EXPANDED_FRAME = { outerRadiusVar: "--ggui-shape-radius-xl", insetPx: 16 };
   var EXPANDED_FRAME_INNER_RADIUS = `max(0px, calc(var(${EXPANDED_FRAME.outerRadiusVar}) - ${EXPANDED_FRAME.insetPx}px))`;
+  var EXPANDED_FRAME_CHROME = {
+    radius: `var(${EXPANDED_FRAME.outerRadiusVar})`,
+    hairline: "color-mix(in srgb, var(--ggui-color-onGround) 6%, transparent)",
+    shadowVar: "--ggui-shape-shadow-sm",
+    ground: "var(--ggui-color-neutral-50)"
+  };
 
   // ../design/dist/rendering/rewrite-imports.js
   var WIRE_EXPORTS = [
@@ -32494,6 +32570,10 @@
     // its runtime's shim lacks fails at module link. A card generated to use it
     // must never meet a runtime without it.
     "useActionSpent",
+    // ggui#1398: whether a dispatched action is waiting for the agent's answer,
+    // as data. Served one release before the triad teaches it, for the same
+    // reason as `useActionSpent` above.
+    "useActionPending",
     // Provider component
     "GguiWireProvider"
   ];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ggui-ai/ui-visual-tester",
-  "version": "0.24.0",
+  "version": "0.26.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",
@@ -53,9 +53,9 @@
   "dependencies": {
     "react": "^19.0.0",
     "react-dom": "^19.0.0",
-    "@ggui-ai/design": "0.24.0",
-    "@ggui-ai/protocol": "0.24.0",
-    "@ggui-ai/wire": "0.24.0"
+    "@ggui-ai/design": "0.26.0",
+    "@ggui-ai/wire": "0.26.0",
+    "@ggui-ai/protocol": "0.26.0"
   },
   "devDependencies": {
     "@playwright/test": "^1.60.0",