@ggui-ai/ui-visual-tester 0.16.0 → 0.17.0

package/dist/validate.js

@@ -58,8 +58,13 @@ function parseRunOutcome(value) {
                 diagnostic: typeof diagnostic === 'string' ? diagnostic : 'unknown',
             };
         }
-        case 'action-not-rendered':
-            return { status: 'action-not-rendered' };
+        case 'action-not-rendered': {
+            const diagnostic = value.diagnostic;
+            return {
+                status: 'action-not-rendered',
+                diagnostic: typeof diagnostic === 'string' ? diagnostic : 'no clickable control in the rendered DOM',
+            };
+        }
         case 'action-no-effect': {
             const diagnostic = value.diagnostic;
             return {
@@ -67,6 +72,21 @@ function parseRunOutcome(value) {
                 diagnostic: typeof diagnostic === 'string' ? diagnostic : 'no signal',
             };
         }
+        case 'action-unreachable': {
+            const diagnostic = value.diagnostic;
+            const reason = value.reason;
+            if (reason !== 'disabled-after-priming' && reason !== 'behind-navigation') {
+                return {
+                    status: 'render-failed',
+                    diagnostic: `fixture returned action-unreachable with an unknown reason: ${JSON.stringify(reason)}`,
+                };
+            }
+            return {
+                status: 'action-unreachable',
+                reason,
+                diagnostic: typeof diagnostic === 'string' ? diagnostic : 'the action could not be reached',
+            };
+        }
         case 'ok': {
             const dispatchFired = value.dispatchFired === true;
             const domChanged = value.domChanged === true;
@@ -83,6 +103,7 @@ async function runOne(page, input) {
     const serialized = {
         componentCode: input.componentCode,
         contractJson: JSON.stringify(input.contract),
+        samplePropsJson: JSON.stringify(input.sampleProps ?? {}),
         actionName: input.actionName,
         classification: input.classification,
         settleMs: input.settleMs,
@@ -96,6 +117,7 @@ async function runOne(page, input) {
         return await fn({
             componentCode: arg.componentCode,
             contract: JSON.parse(arg.contractJson),
+            sampleProps: JSON.parse(arg.samplePropsJson),
             actionName: arg.actionName,
             classification: arg.classification,
             settleMs: arg.settleMs,
@@ -118,7 +140,7 @@ function classify(actionName, outcome) {
             return {
                 kind: 'action-not-rendered',
                 actionName,
-                diagnostic: `no button found matching actionSpec.${actionName}.label`,
+                diagnostic: outcome.diagnostic,
             };
         case 'action-no-effect':
             return {
@@ -127,6 +149,13 @@ function classify(actionName, outcome) {
                 diagnostic: `clicking actionSpec.${actionName} produced no required signal — ` +
                     outcome.diagnostic,
             };
+        case 'action-unreachable':
+            return {
+                kind: 'action-unreachable',
+                actionName,
+                reason: outcome.reason,
+                diagnostic: `actionSpec.${actionName} could not be reached by the static probe (not measured) — ${outcome.diagnostic}`,
+            };
     }
 }
 /**
@@ -173,6 +202,7 @@ export async function validateContractBehavior(input) {
                 const outcome = await runOne(page, {
                     componentCode: input.componentCode,
                     contract: input.contract,
+                    ...(input.sampleProps !== undefined ? { sampleProps: input.sampleProps } : {}),
                     actionName: name,
                     classification,
                     settleMs: SETTLE_MS,