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

package/fixture/fixture-runtime.js

@@ -28577,6 +28577,7 @@
     buildWireConfig: () => buildWireConfig,
     connectionSource: () => connectionSource,
     useAction: () => useAction,
+    useActionSpent: () => useActionSpent,
     useApp: () => useApp,
     useAuth: () => useAuth,
     useContract: () => useContract,
@@ -28667,8 +28668,19 @@
     }, [actionName, dispatch, onDispatchSuppressed]);
   }
 
-  // ../wire/dist/useGguiContext.js
+  // ../wire/dist/action-spent.js
   var import_react35 = __toESM(require_react(), 1);
+  var ActionSpentContext = (0, import_react35.createContext)(null);
+  var noSubscription = () => () => void 0;
+  function useActionSpent(actionName) {
+    const source = (0, import_react35.useContext)(ActionSpentContext);
+    const subscribe = (0, import_react35.useCallback)((listener) => source === null ? noSubscription() : source.subscribe(listener), [source]);
+    const read = (0, import_react35.useCallback)(() => source === null ? false : source.isSpent(actionName), [source, actionName]);
+    return (0, import_react35.useSyncExternalStore)(subscribe, read, read);
+  }
+
+  // ../wire/dist/useGguiContext.js
+  var import_react36 = __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;
@@ -28676,19 +28688,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_react35.useContext)(ctx);
+    return (0, import_react36.useContext)(ctx);
   }
 
   // ../wire/dist/useStream.js
-  var import_react36 = __toESM(require_react(), 1);
+  var import_react37 = __toESM(require_react(), 1);
   function useStream(channelName) {
     const { subscribe } = useWireContext();
-    const [latest, setLatest] = (0, import_react36.useState)(null);
-    const [all, setAll] = (0, import_react36.useState)([]);
-    const [isComplete, setIsComplete] = (0, import_react36.useState)(false);
-    const allRef = (0, import_react36.useRef)(all);
+    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);
     allRef.current = all;
-    (0, import_react36.useEffect)(() => {
+    (0, import_react37.useEffect)(() => {
       return subscribe(channelName, (delivery) => {
         const typed = delivery.payload;
         setLatest(typed);
@@ -28726,7 +28738,7 @@
   }
 
   // ../wire/dist/useRender.js
-  var import_react37 = __toESM(require_react(), 1);
+  var import_react38 = __toESM(require_react(), 1);
 
   // ../wire/dist/connection-store.js
   var ConnectionWriterConflictError = class extends Error {
@@ -28823,7 +28835,7 @@
   // ../wire/dist/useRender.js
   function useRender() {
     const { render } = useWireContext();
-    const isConnected = (0, import_react37.useSyncExternalStore)(connectionSource.subscribe, connectionSource.getSnapshot, connectionSource.getSnapshot);
+    const isConnected = (0, import_react38.useSyncExternalStore)(connectionSource.subscribe, connectionSource.getSnapshot, connectionSource.getSnapshot);
     return { sessionId: render.sessionId, isConnected };
   }
 
@@ -29407,7 +29419,24 @@
     });
     const validateEnvelope = opts.validateEnvelope ?? validateOutboundActionEnvelope;
     const spentOneShots = /* @__PURE__ */ new Set();
+    const isSpent = (actionName) => opts.getActiveActionSpec()?.[actionName]?.oneShot === true && (spentOneShots.has(actionName) || opts.getSpentOneShots?.()?.includes(actionName) === true);
+    const spentListeners = /* @__PURE__ */ new Set();
+    const notifySpent = () => {
+      for (const listener of [...spentListeners])
+        listener();
+    };
+    const actionSpent = {
+      isSpent,
+      subscribe: (listener) => {
+        spentListeners.add(listener);
+        return () => {
+          spentListeners.delete(listener);
+        };
+      }
+    };
+    opts.spentInputsChanged?.(notifySpent);
     return {
+      actionSpent,
       app: opts.app,
       render: opts.render,
       auth: opts.auth,
@@ -29417,8 +29446,7 @@
         if (actionSpec === void 0)
           opts.onActionSpecAbsent?.(actionName);
         const isOneShot = actionSpec?.[actionName]?.oneShot === true;
-        const spent = spentOneShots.has(actionName) || opts.getSpentOneShots?.()?.includes(actionName) === true;
-        if (isOneShot && spent) {
+        if (isSpent(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",
@@ -29443,8 +29471,10 @@
           opts.onViolation(new ClientContractViolationError("outbound-action", result.violations));
           return;
         }
-        if (isOneShot)
+        if (isOneShot && !spentOneShots.has(actionName)) {
           spentOneShots.add(actionName);
+          notifySpent();
+        }
         opts.emitEnvelope(envelope);
       },
       subscribe: (channelName, handler) => {
@@ -32439,8 +32469,8 @@
 
   // ../design/dist/themes/ThemeProvider.js
   var import_jsx_runtime58 = __toESM(require_jsx_runtime(), 1);
-  var import_react38 = __toESM(require_react(), 1);
-  var ThemeContext = (0, import_react38.createContext)(null);
+  var import_react39 = __toESM(require_react(), 1);
+  var ThemeContext = (0, import_react39.createContext)(null);
 
   // ../design/dist/rendering/css-tokens.js
   var EXPANDED_FRAME = { outerRadiusVar: "--ggui-shape-radius-xl", insetPx: 16 };
@@ -32459,6 +32489,11 @@
     "useGguiContext",
     "useContract",
     "useWireContext",
+    // ggui#1223: a `oneShot` action's spent state, as data. It is served here
+    // one release BEFORE the triad teaches it, because a card that imports a name
+    // its runtime's shim lacks fails at module link. A card generated to use it
+    // must never meet a runtime without it.
+    "useActionSpent",
     // Provider component
     "GguiWireProvider"
   ];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ggui-ai/ui-visual-tester",
-  "version": "0.23.0",
+  "version": "0.24.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.23.0",
-    "@ggui-ai/wire": "0.23.0",
-    "@ggui-ai/protocol": "0.23.0"
+    "@ggui-ai/design": "0.24.0",
+    "@ggui-ai/protocol": "0.24.0",
+    "@ggui-ai/wire": "0.24.0"
   },
   "devDependencies": {
     "@playwright/test": "^1.60.0",