@riddledc/riddle-proof 0.7.60 → 0.7.62

package/README.md

@@ -240,7 +240,7 @@ where the second request must carry newer state.
 `target.setup_actions` is optional. Use it when the meaningful proof surface
 appears only after a picker, tab, login stub, storage seed, form fill,
 transport control, or other bounded interaction. Supported setup actions are
-`click`, `press`, `fill`, `set_input_value`, `assert_text_visible`,
+`click`, `drag`, `press`, `fill`, `set_input_value`, `assert_text_visible`,
 `assert_text_absent`, `assert_selector_count`, `assert_window_value`,
 `assert_window_number`, `local_storage`, `session_storage`, `clear_storage`, `wait`,
 `wait_for_selector`, `wait_for_text`, and `window_call`; a failed setup action
@@ -253,6 +253,12 @@ stable enough for Playwright's default click actionability checks. Use `press`
 with a Playwright key name, such as `Enter`, `Space`, or `ArrowLeft`,
 when a route's intended browser control is keyboard-driven; omit `selector` for
 a page-level key press, or provide `selector` to press against a focused element.
+Use `drag` for pointer-driven controls such as canvas launch areas, sliders, or
+drag-to-aim games. Provide `selector`, `from_x`, `from_y`, `to_x`, and `to_y`;
+coordinates are element-relative pixels by default. Set `coordinate_mode:
+"ratio"` to make coordinates relative to the target element size, for example
+`from_x: 0.5, from_y: 0.5, to_x: 0.2, to_y: 0.5`. Optional `steps` and
+`duration_ms` control how gradually the pointer moves before release.
 Use setup assertions when the pre-click or pre-navigation state is part of the contract,
 for example a fresh row must be present, stale copy must be absent, exactly one
 source link must exist before clicking into the final route, or a canvas app's
@@ -278,6 +284,12 @@ and setup assertions then execute in that frame context and record
 Use `frame_index` / `frameIndex` when more than one matching iframe is present;
 it defaults to the first frame.
 
+Profiles with setup actions also include a compact
+`setup_actions_succeeded.evidence.setup_summary`. The summary groups each
+viewport's final route, final URL, action counts, clicked targets, iframe URLs,
+compact text samples, and failures so setup-heavy clickthrough or iframe proofs
+can be reviewed without reading every raw setup-action result.
+
 `target.timeout_sec` is optional. Use it for known-heavy profile targets so the
 profile carries its own hosted Riddle worker budget; an explicit CLI `--timeout`
 still overrides the profile value for one-off runs.

package/dist/{chunk-FLQ4HHTT.js → chunk-MIHU2AWC.js}

@@ -34,6 +34,7 @@ var RIDDLE_PROOF_PROFILE_CHECK_TYPES = [
 ];
 var RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES = [
   "click",
+  "drag",
   "press",
   "fill",
   "set_input_value",
@@ -174,6 +175,78 @@ function toJsonValue(value) {
   if (isRecord(value)) return Object.fromEntries(Object.entries(value).map(([key, child]) => [key, toJsonValue(child)]));
   return String(value);
 }
+function compactProfileSetupSummaryText(value, limit = 160) {
+  const text = typeof value === "string" ? value.replace(/\s+/g, " ").trim() : "";
+  if (!text) return void 0;
+  if (text.length <= limit) return text;
+  return `${text.slice(0, Math.max(0, limit - 15)).trimEnd()}... (${text.length} chars)`;
+}
+function profileSetupResultAction(value) {
+  const action = value.action ?? value.type;
+  return typeof action === "string" && action ? action : "unknown";
+}
+function profileSetupFrameUrls(viewport) {
+  const urls = [];
+  const frames = viewport.frames || {};
+  for (const container of Object.values(frames)) {
+    if (!isRecord(container) || !Array.isArray(container.frames)) continue;
+    for (const frame of container.frames) {
+      if (!isRecord(frame)) continue;
+      const url = typeof frame.url === "string" ? frame.url : void 0;
+      if (url && !urls.includes(url)) urls.push(url);
+    }
+  }
+  return urls.slice(0, 10);
+}
+function profileSetupActionCounts(results) {
+  const counts = {};
+  for (const result of results) {
+    const action = profileSetupResultAction(result);
+    counts[action] = (counts[action] || 0) + 1;
+  }
+  return toJsonValue(counts);
+}
+function profileSetupSummary(viewports, actionCount) {
+  return toJsonValue({
+    viewport_count: viewports.length,
+    action_count: actionCount ?? null,
+    viewports: viewports.map((viewport) => {
+      const results = viewport.setup_action_results || [];
+      const failed = results.filter((result) => result.ok === false);
+      const clicked = results.filter((result) => profileSetupResultAction(result) === "click" && result.ok !== false).map((result) => ({
+        ordinal: result.ordinal ?? null,
+        selector: result.selector ?? null,
+        frame_selector: result.frame_selector ?? null,
+        text: compactProfileSetupSummaryText(result.text)
+      })).slice(0, 8);
+      const text_samples = results.filter((result) => result.ok !== false && typeof result.text === "string" && (profileSetupResultAction(result) === "assert_text_visible" || profileSetupResultAction(result) === "assert_text_absent" || profileSetupResultAction(result) === "wait_for_text")).map((result) => ({
+        ordinal: result.ordinal ?? null,
+        action: profileSetupResultAction(result),
+        frame_selector: result.frame_selector ?? null,
+        text: compactProfileSetupSummaryText(result.text)
+      })).filter((item) => item.text).slice(-6);
+      return {
+        name: viewport.name,
+        ok: (actionCount === void 0 ? results.length > 0 : results.length >= actionCount) && failed.length === 0,
+        result_count: results.length,
+        observed_path: viewport.route?.observed ?? null,
+        final_url: viewport.url ?? null,
+        action_counts: profileSetupActionCounts(results),
+        frame_action_count: results.filter((result) => result.frame_selector).length,
+        frame_urls: profileSetupFrameUrls(viewport),
+        clicked,
+        text_samples,
+        failed: failed.map((result) => ({
+          ordinal: result.ordinal ?? null,
+          action: profileSetupResultAction(result),
+          selector: result.selector ?? null,
+          frame_selector: result.frame_selector ?? null,
+          reason: result.reason ?? result.error ?? null
+        }))
+      };
+    })
+  });
+}
 function normalizeName(value, fallback) {
   const name = stringValue(value) || fallback;
   return name.replace(/\s+/g, " ").trim();
@@ -204,7 +277,7 @@ function isSupportedCheckType(value) {
 }
 function normalizeSetupActionType(value, index) {
   const normalizedInput = String(value || "").trim().replace(/-/g, "_");
-  const normalized = normalizedInput === "clear_browser_storage" ? "clear_storage" : normalizedInput === "keyboard_press" || normalizedInput === "key_press" ? "press" : normalizedInput;
+  const normalized = normalizedInput === "clear_browser_storage" ? "clear_storage" : normalizedInput === "pointer_drag" || normalizedInput === "mouse_drag" || normalizedInput === "drag_to" ? "drag" : normalizedInput === "keyboard_press" || normalizedInput === "key_press" ? "press" : normalizedInput;
   if (RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES.includes(normalized)) {
     return normalized;
   }
@@ -234,6 +307,13 @@ function normalizeSetupActionRepeat(input, index) {
   }
   return repeat;
 }
+function normalizeSetupActionCoordinateMode(value, index) {
+  if (value === void 0 || value === null || value === "") return void 0;
+  const normalized = String(value).trim().replace(/-/g, "_").toLowerCase();
+  if (normalized === "pixels" || normalized === "pixel" || normalized === "px") return "pixels";
+  if (normalized === "ratio" || normalized === "relative" || normalized === "fraction") return "ratio";
+  throw new Error(`target.setup_actions[${index}].coordinate_mode ${String(value)} is not supported. Supported coordinate modes: pixels, ratio.`);
+}
 function normalizeSetupAction(input, index) {
   if (!isRecord(input)) throw new Error(`target.setup_actions[${index}] must be an object.`);
   const type = normalizeSetupActionType(stringValue(input.type), index);
@@ -243,9 +323,25 @@ function normalizeSetupAction(input, index) {
   if (frameIndex !== void 0 && (!Number.isInteger(frameIndex) || frameIndex < 0)) {
     throw new Error(`target.setup_actions[${index}].frame_index must be a non-negative integer.`);
   }
-  if ((type === "click" || type === "fill" || type === "set_input_value" || type === "wait_for_selector" || type === "wait_for_text" || type === "assert_text_visible" || type === "assert_text_absent" || type === "assert_selector_count") && !selector) {
+  if ((type === "click" || type === "drag" || type === "fill" || type === "set_input_value" || type === "wait_for_selector" || type === "wait_for_text" || type === "assert_text_visible" || type === "assert_text_absent" || type === "assert_selector_count") && !selector) {
     throw new Error(`target.setup_actions[${index}] ${type} requires selector.`);
   }
+  const fromX = numberValue(valueFromOwn(input, "from_x", "fromX", "start_x", "startX", "x1"));
+  const fromY = numberValue(valueFromOwn(input, "from_y", "fromY", "start_y", "startY", "y1"));
+  const toX = numberValue(valueFromOwn(input, "to_x", "toX", "end_x", "endX", "x2"));
+  const toY = numberValue(valueFromOwn(input, "to_y", "toY", "end_y", "endY", "y2"));
+  const coordinateMode = normalizeSetupActionCoordinateMode(valueFromOwn(input, "coordinate_mode", "coordinateMode", "coords", "units"), index);
+  if (type === "drag") {
+    if (fromX === void 0 || fromY === void 0 || toX === void 0 || toY === void 0) {
+      throw new Error(`target.setup_actions[${index}] drag requires from_x, from_y, to_x, and to_y.`);
+    }
+    if (coordinateMode === "ratio" && [fromX, fromY, toX, toY].some((value2) => value2 < 0 || value2 > 1)) {
+      throw new Error(`target.setup_actions[${index}] drag ratio coordinates must be between 0 and 1.`);
+    }
+    if ((coordinateMode === void 0 || coordinateMode === "pixels") && [fromX, fromY, toX, toY].some((value2) => value2 < 0)) {
+      throw new Error(`target.setup_actions[${index}] drag pixel coordinates must be non-negative.`);
+    }
+  }
   if (type === "wait_for_text" && !stringValue(input.text) && !stringValue(input.pattern)) {
     throw new Error(`target.setup_actions[${index}] wait_for_text requires text or pattern.`);
   }
@@ -292,12 +388,23 @@ function normalizeSetupAction(input, index) {
     }
   }
   const hasExpectedReturn = hasOwn(input, "expect_return") || hasOwn(input, "expectReturn") || hasOwn(input, "expected_return") || hasOwn(input, "expectedReturn");
+  const steps = numberValue(input.steps);
+  if (type === "drag" && steps !== void 0 && (!Number.isInteger(steps) || steps < 1 || steps > 100)) {
+    throw new Error(`target.setup_actions[${index}].steps must be an integer from 1 to 100.`);
+  }
   return {
     type,
     selector,
     frame_selector: frameSelector,
     frame_index: frameIndex,
     force: type === "click" && (input.force === true || input.force_click === true || input.forceClick === true),
+    coordinate_mode: coordinateMode,
+    from_x: fromX,
+    from_y: fromY,
+    to_x: toX,
+    to_y: toY,
+    duration_ms: numberValue(input.duration_ms) ?? numberValue(input.durationMs),
+    steps,
     key,
     value,
     value_json: hasJsonValue ? toJsonValue(input.value_json ?? input.valueJson ?? input.json) : void 0,
@@ -1246,6 +1353,7 @@ function assessSetupActionsFromEvidence(profile, evidence) {
         ok: (viewport.setup_action_results || []).length >= actionCount && (viewport.setup_action_results || []).every((result) => result.ok !== false),
         result_count: (viewport.setup_action_results || []).length
       })),
+      setup_summary: profileSetupSummary(viewports, actionCount),
       failed
     },
     message: failed.length ? `Setup actions failed in ${failed.length} viewport action(s).` : void 0
@@ -1659,6 +1767,90 @@ function requiredNetworkMockHitCount(mock) {
   if (Array.isArray(mock.responses) && mock.responses.length) return mock.responses.length;
   return 1;
 }
+function compactProfileSetupSummaryText(value, limit) {
+  limit = limit || 160;
+  const text = typeof value === "string" ? value.replace(/\\s+/g, " ").trim() : "";
+  if (!text) return undefined;
+  if (text.length <= limit) return text;
+  return text.slice(0, Math.max(0, limit - 15)).trimEnd() + "... (" + text.length + " chars)";
+}
+function profileSetupResultAction(result) {
+  const action = result && (result.action || result.type);
+  return typeof action === "string" && action ? action : "unknown";
+}
+function profileSetupFrameUrls(viewport) {
+  const urls = [];
+  const frames = viewport && viewport.frames || {};
+  for (const container of Object.values(frames)) {
+    if (!container || typeof container !== "object" || Array.isArray(container) || !Array.isArray(container.frames)) continue;
+    for (const frame of container.frames) {
+      if (!frame || typeof frame !== "object" || Array.isArray(frame)) continue;
+      const url = typeof frame.url === "string" ? frame.url : null;
+      if (url && !urls.includes(url)) urls.push(url);
+    }
+  }
+  return urls.slice(0, 10);
+}
+function profileSetupActionCounts(results) {
+  const counts = {};
+  for (const result of results || []) {
+    const action = profileSetupResultAction(result);
+    counts[action] = (counts[action] || 0) + 1;
+  }
+  return counts;
+}
+function profileSetupSummary(viewports, actionCount) {
+  return {
+    viewport_count: (viewports || []).length,
+    action_count: actionCount ?? null,
+    viewports: (viewports || []).map((viewport) => {
+      const results = viewport.setup_action_results || [];
+      const failed = results.filter((result) => result && result.ok === false);
+      const clicked = results
+        .filter((result) => result && profileSetupResultAction(result) === "click" && result.ok !== false)
+        .map((result) => ({
+          ordinal: result.ordinal ?? null,
+          selector: result.selector ?? null,
+          frame_selector: result.frame_selector ?? null,
+          text: compactProfileSetupSummaryText(result.text),
+        }))
+        .slice(0, 8);
+      const textSamples = results
+        .filter((result) => result && result.ok !== false && typeof result.text === "string" && (
+          profileSetupResultAction(result) === "assert_text_visible"
+          || profileSetupResultAction(result) === "assert_text_absent"
+          || profileSetupResultAction(result) === "wait_for_text"
+        ))
+        .map((result) => ({
+          ordinal: result.ordinal ?? null,
+          action: profileSetupResultAction(result),
+          frame_selector: result.frame_selector ?? null,
+          text: compactProfileSetupSummaryText(result.text),
+        }))
+        .filter((item) => item.text)
+        .slice(-6);
+      return {
+        name: viewport.name,
+        ok: (actionCount === undefined ? results.length > 0 : results.length >= actionCount) && failed.length === 0,
+        result_count: results.length,
+        observed_path: viewport.route && viewport.route.observed || null,
+        final_url: viewport.url || null,
+        action_counts: profileSetupActionCounts(results),
+        frame_action_count: results.filter((result) => result && result.frame_selector).length,
+        frame_urls: profileSetupFrameUrls(viewport),
+        clicked,
+        text_samples: textSamples,
+        failed: failed.map((result) => ({
+          ordinal: result.ordinal ?? null,
+          action: profileSetupResultAction(result),
+          selector: result.selector ?? null,
+          frame_selector: result.frame_selector ?? null,
+          reason: result.reason || result.error || null,
+        })),
+      };
+    }),
+  };
+}
 function assessProfile(profile, evidence) {
   const checks = [];
   const viewports = evidence.viewports || [];
@@ -1763,6 +1955,7 @@ function assessProfile(profile, evidence) {
             && (viewport.setup_action_results || []).every((result) => !result || result.ok !== false),
           result_count: (viewport.setup_action_results || []).length,
         })),
+        setup_summary: profileSetupSummary(viewports, actionCount),
         failed,
       },
       message: failed.length ? "Setup actions failed in " + failed.length + " viewport action(s)." : undefined,
@@ -2505,6 +2698,71 @@ async function executeSetupAction(action, ordinal) {
       await scope.context.waitForSelector(action.selector, { state: "visible", timeout });
       return { ...base, ...setupScopeEvidence(scope), ok: true, timeout_ms: timeout };
     }
+    if (type === "drag") {
+      const scope = await setupActionScope(action, timeout);
+      if (!scope.ok) return setupScopeFailure(base, scope);
+      const locator = scope.context.locator(action.selector);
+      const count = await locator.count();
+      if (!count) return { ...base, ...setupScopeEvidence(scope), reason: "selector_not_found", count };
+      const targetIndex = Number.isInteger(action.index) ? action.index : 0;
+      if (targetIndex < 0 || targetIndex >= count) return { ...base, ...setupScopeEvidence(scope), reason: "index_out_of_range", count, target_index: targetIndex };
+      const target = locator.nth(targetIndex);
+      await target.waitFor({ state: "visible", timeout });
+      const box = await target.boundingBox();
+      if (!box) return { ...base, ...setupScopeEvidence(scope), reason: "bounding_box_unavailable", count, target_index: targetIndex };
+      const mode = String(action.coordinate_mode || action.coordinateMode || "pixels").trim();
+      const coordinate = (value, size) => mode === "ratio" ? value * size : value;
+      const fromX = setupFiniteNumber(action.from_x ?? action.fromX ?? action.start_x ?? action.startX ?? action.x1);
+      const fromY = setupFiniteNumber(action.from_y ?? action.fromY ?? action.start_y ?? action.startY ?? action.y1);
+      const toX = setupFiniteNumber(action.to_x ?? action.toX ?? action.end_x ?? action.endX ?? action.x2);
+      const toY = setupFiniteNumber(action.to_y ?? action.toY ?? action.end_y ?? action.endY ?? action.y2);
+      if (fromX === undefined || fromY === undefined || toX === undefined || toY === undefined) return { ...base, ...setupScopeEvidence(scope), reason: "missing_drag_coordinates", count, target_index: targetIndex };
+      if (mode === "ratio" && [fromX, fromY, toX, toY].some((value) => value < 0 || value > 1)) return { ...base, ...setupScopeEvidence(scope), reason: "invalid_ratio_coordinates", count, target_index: targetIndex };
+      if (mode !== "ratio" && [fromX, fromY, toX, toY].some((value) => value < 0)) return { ...base, ...setupScopeEvidence(scope), reason: "invalid_pixel_coordinates", count, target_index: targetIndex };
+      const start = {
+        x: box.x + coordinate(fromX, box.width),
+        y: box.y + coordinate(fromY, box.height),
+      };
+      const end = {
+        x: box.x + coordinate(toX, box.width),
+        y: box.y + coordinate(toY, box.height),
+      };
+      const requestedSteps = setupNumber(action.steps, 8);
+      const steps = Math.min(100, Math.max(1, Math.floor(requestedSteps || 8)));
+      const durationMs = setupNumber(action.duration_ms ?? action.durationMs, 0);
+      await page.mouse.move(start.x, start.y);
+      await page.mouse.down();
+      try {
+        if (durationMs && steps > 1) {
+          for (let step = 1; step <= steps; step += 1) {
+            const progress = step / steps;
+            await page.mouse.move(
+              start.x + (end.x - start.x) * progress,
+              start.y + (end.y - start.y) * progress,
+            );
+            await page.waitForTimeout(durationMs / steps);
+          }
+        } else {
+          await page.mouse.move(end.x, end.y, { steps });
+        }
+      } finally {
+        await page.mouse.up().catch(() => {});
+      }
+      return {
+        ...base,
+        ...setupScopeEvidence(scope),
+        ok: true,
+        count,
+        target_index: targetIndex,
+        coordinate_mode: mode,
+        from_x: fromX,
+        from_y: fromY,
+        to_x: toX,
+        to_y: toY,
+        steps,
+        duration_ms: durationMs || undefined,
+      };
+    }
     if (type === "press") {
       const key = String(action.key || "").trim();
       if (!key) return { ...base, reason: "missing_key" };