npm - @riddledc/riddle-proof - Versions diffs - 0.7.173 → 0.7.174 - Mend

@riddledc/riddle-proof 0.7.173 → 0.7.174

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (11) hide show

package/README.md +7 -1
package/dist/{chunk-JIAMASZX.js → chunk-BD4RHTGW.js} +132 -6
package/dist/cli.cjs +159 -7
package/dist/cli.js +28 -2
package/dist/index.cjs +132 -6
package/dist/index.js +1 -1
package/dist/profile.cjs +132 -6
package/dist/profile.d.cts +1 -1
package/dist/profile.d.ts +1 -1
package/dist/profile.js +1 -1
package/package.json +1 -1

package/README.md CHANGED Viewed

@@ -397,7 +397,7 @@ when body matching overrides sequence order.
 `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`, `drag`, `press`, `fill`, `set_input_value`, `set_range_value`,
+`click`, `tap`, `drag`, `press`, `fill`, `set_input_value`, `set_range_value`,
 `deterministic_runtime`, `canvas_signature`, `assert_text_visible`, `assert_text_absent`,
 `assert_selector_count`, `assert_window_value`, `assert_window_number`,
 `local_storage`, `session_storage`, `clear_storage`, `clear_console`,
@@ -416,6 +416,12 @@ Use `click_count` / `clickCount` / `clicks` from 1 to 10 on a single `click`
 action for atomic double-click or double-submit contracts where modeling the
 interaction as repeated setup actions would incorrectly require the target to
 remain in the DOM after the first click.
+Use `tap` for touch-first controls, especially canvas regions where a mobile
+tap should produce trusted touch events and the browser's synthesized click.
+It requires `selector`, defaults to a touch tap at the target center, and
+accepts `x` / `y` or `from_x` / `from_y` plus `coordinate_mode: "ratio"` for
+element-relative coordinates. Set `pointer_type` to `mouse`, `touch`, or `pen`
+when the proof must distinguish input modality.
 Use `set_range_value` for HTML range inputs and React-controlled sliders. It
 accepts aliases such as `set-slider-value`, requires `selector` plus `value`,
 uses the native input value setter, dispatches bubbling `input` and `change`

package/dist/{chunk-JIAMASZX.js → chunk-BD4RHTGW.js} RENAMED Viewed

@@ -44,6 +44,7 @@ var RIDDLE_PROOF_PROFILE_CHECK_TYPES = [
 ];
 var RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES = [
   "click",
+  "tap",
   "drag",
   "press",
   "fill",
@@ -595,6 +596,21 @@ function profileSetupDragReceipts(results) {
     reason: result.reason ?? result.error ?? null
   }));
 }
+function profileSetupTapReceipts(results) {
+  return results.filter((result) => profileSetupResultAction(result) === "tap").map((result) => ({
+    ordinal: result.ordinal ?? null,
+    ok: result.ok !== false,
+    selector: result.selector ?? null,
+    frame_selector: result.frame_selector ?? null,
+    pointer_type: result.pointer_type ?? null,
+    input_dispatch: result.input_dispatch ?? null,
+    coordinate_mode: result.coordinate_mode ?? null,
+    x: result.x ?? null,
+    y: result.y ?? null,
+    duration_ms: result.duration_ms ?? null,
+    reason: result.reason ?? result.error ?? null
+  }));
+}
 function profileSetupCanvasSignatureReceipts(results) {
   return results.filter((result) => profileSetupResultAction(result) === "canvas_signature").map((result) => ({
     ordinal: result.ordinal ?? null,
@@ -756,6 +772,8 @@ function profileSetupSummary(viewports, actionCount, expectedActionCountByViewpo
       const sampledRangeValueReceipts = sampleProfileSetupSummaryItems(rangeValueReceipts, 8);
       const dragReceipts = profileSetupDragReceipts(results);
       const sampledDragReceipts = sampleProfileSetupSummaryItems(dragReceipts, 8);
+      const tapReceipts = profileSetupTapReceipts(results);
+      const sampledTapReceipts = sampleProfileSetupSummaryItems(tapReceipts, 8);
       const canvasSignatureReceipts = profileSetupCanvasSignatureReceipts(results);
       const sampledCanvasSignatureReceipts = sampleProfileSetupSummaryItems(canvasSignatureReceipts, 8);
       const clickedItems = results.filter((result) => profileSetupResultAction(result) === "click" && result.ok !== false).map((result) => {
@@ -820,6 +838,9 @@ function profileSetupSummary(viewports, actionCount, expectedActionCountByViewpo
         drag_total: dragReceipts.length,
         drag_truncated: dragReceipts.length > sampledDragReceipts.length,
         drag: sampledDragReceipts,
+        tap_total: tapReceipts.length,
+        tap_truncated: tapReceipts.length > sampledTapReceipts.length,
+        tap: sampledTapReceipts,
         canvas_signature_total: canvasSignatureReceipts.length,
         canvas_signature_truncated: canvasSignatureReceipts.length > sampledCanvasSignatureReceipts.length,
         canvas_signature: sampledCanvasSignatureReceipts,
@@ -876,7 +897,7 @@ function isSupportedCheckType(value) {
 }
 function normalizeSetupActionType(value, index) {
   const normalizedInput = String(value || "").trim().replace(/-/g, "_");
-  const normalized = normalizedInput === "clear_browser_storage" ? "clear_storage" : normalizedInput === "reset_console" || normalizedInput === "clear_browser_console" || normalizedInput === "reset_browser_console" ? "clear_console" : normalizedInput === "pointer_drag" || normalizedInput === "mouse_drag" || normalizedInput === "drag_to" ? "drag" : normalizedInput === "keyboard_press" || normalizedInput === "key_press" ? "press" : normalizedInput === "set_slider_value" || normalizedInput === "slider_value" || normalizedInput === "set_slider" || normalizedInput === "set_range" || normalizedInput === "range_value" || normalizedInput === "range_input" || normalizedInput === "set_range_input" ? "set_range_value" : normalizedInput === "deterministic_runtime" || normalizedInput === "mock_runtime" || normalizedInput === "mock_random" || normalizedInput === "mock_random_queue" || normalizedInput === "seed_random_queue" || normalizedInput === "set_random_queue" || normalizedInput === "mock_clock" || normalizedInput === "set_mock_clock" || normalizedInput === "set_runtime_determinism" || normalizedInput === "runtime_determinism" ? "deterministic_runtime" : normalizedInput === "canvas_hash" || normalizedInput === "capture_canvas_hash" || normalizedInput === "capture_canvas_signature" || normalizedInput === "canvas_state_signature" ? "canvas_signature" : normalizedInput === "capture_screenshot" || normalizedInput === "save_screenshot" || normalizedInput === "setup_screenshot" ? "screenshot" : normalizedInput === "accept_dialog" || normalizedInput === "accept_dialogs" || normalizedInput === "confirm_dialog" || normalizedInput === "set_dialog_response" ? "dialog_response" : normalizedInput === "dismiss_dialog" || normalizedInput === "dismiss_dialogs" || normalizedInput === "cancel_dialog" ? "dialog_response" : normalizedInput === "window_call_until" || normalizedInput === "call_until" || normalizedInput === "window_call_repeat_until" || normalizedInput === "repeat_window_call_until" ? "window_call_until" : normalizedInput === "window_evaluate" || normalizedInput === "browser_eval" || normalizedInput === "browser_evaluate" || normalizedInput === "evaluate_script" || normalizedInput === "profile_script" ? "window_eval" : normalizedInput;
+  const normalized = normalizedInput === "clear_browser_storage" ? "clear_storage" : normalizedInput === "reset_console" || normalizedInput === "clear_browser_console" || normalizedInput === "reset_browser_console" ? "clear_console" : normalizedInput === "pointer_drag" || normalizedInput === "mouse_drag" || normalizedInput === "drag_to" ? "drag" : normalizedInput === "pointer_tap" || normalizedInput === "touch_tap" || normalizedInput === "canvas_tap" ? "tap" : normalizedInput === "keyboard_press" || normalizedInput === "key_press" ? "press" : normalizedInput === "set_slider_value" || normalizedInput === "slider_value" || normalizedInput === "set_slider" || normalizedInput === "set_range" || normalizedInput === "range_value" || normalizedInput === "range_input" || normalizedInput === "set_range_input" ? "set_range_value" : normalizedInput === "deterministic_runtime" || normalizedInput === "mock_runtime" || normalizedInput === "mock_random" || normalizedInput === "mock_random_queue" || normalizedInput === "seed_random_queue" || normalizedInput === "set_random_queue" || normalizedInput === "mock_clock" || normalizedInput === "set_mock_clock" || normalizedInput === "set_runtime_determinism" || normalizedInput === "runtime_determinism" ? "deterministic_runtime" : normalizedInput === "canvas_hash" || normalizedInput === "capture_canvas_hash" || normalizedInput === "capture_canvas_signature" || normalizedInput === "canvas_state_signature" ? "canvas_signature" : normalizedInput === "capture_screenshot" || normalizedInput === "save_screenshot" || normalizedInput === "setup_screenshot" ? "screenshot" : normalizedInput === "accept_dialog" || normalizedInput === "accept_dialogs" || normalizedInput === "confirm_dialog" || normalizedInput === "set_dialog_response" ? "dialog_response" : normalizedInput === "dismiss_dialog" || normalizedInput === "dismiss_dialogs" || normalizedInput === "cancel_dialog" ? "dialog_response" : normalizedInput === "window_call_until" || normalizedInput === "call_until" || normalizedInput === "window_call_repeat_until" || normalizedInput === "repeat_window_call_until" ? "window_call_until" : normalizedInput === "window_evaluate" || normalizedInput === "browser_eval" || normalizedInput === "browser_evaluate" || normalizedInput === "evaluate_script" || normalizedInput === "profile_script" ? "window_eval" : normalizedInput;
   if (RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES.includes(normalized)) {
     return normalized;
   }
@@ -958,8 +979,8 @@ function normalizeSetupActionCoordinateMode(value, index) {
 }
 function normalizeSetupActionPointerType(value, type, index) {
   if (value === void 0 || value === null || value === "") return void 0;
-  if (type !== "drag") {
-    throw new Error(`target.setup_actions[${index}].pointer_type is only supported for drag actions.`);
+  if (type !== "drag" && type !== "tap") {
+    throw new Error(`target.setup_actions[${index}].pointer_type is only supported for drag/tap actions.`);
   }
   const normalized = String(value).trim().replace(/-/g, "_").toLowerCase();
   if (normalized === "mouse") return "mouse";
@@ -1038,11 +1059,11 @@ 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 === "drag" || type === "fill" || type === "set_input_value" || type === "set_range_value" || type === "canvas_signature" || 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 === "tap" || type === "drag" || type === "fill" || type === "set_input_value" || type === "set_range_value" || type === "canvas_signature" || 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 = type === "click" ? numberValue(valueFromOwn(input, "from_x", "fromX", "x", "click_x", "clickX", "start_x", "startX", "x1")) : numberValue(valueFromOwn(input, "from_x", "fromX", "start_x", "startX", "x1"));
-  const fromY = type === "click" ? numberValue(valueFromOwn(input, "from_y", "fromY", "y", "click_y", "clickY", "start_y", "startY", "y1")) : numberValue(valueFromOwn(input, "from_y", "fromY", "start_y", "startY", "y1"));
+  const fromX = type === "click" || type === "tap" ? numberValue(valueFromOwn(input, "from_x", "fromX", "x", "click_x", "clickX", "start_x", "startX", "x1")) : numberValue(valueFromOwn(input, "from_x", "fromX", "start_x", "startX", "x1"));
+  const fromY = type === "click" || type === "tap" ? numberValue(valueFromOwn(input, "from_y", "fromY", "y", "click_y", "clickY", "start_y", "startY", "y1")) : 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);
@@ -1062,6 +1083,21 @@ function normalizeSetupAction(input, index) {
       }
     }
   }
+  if (type === "tap") {
+    const hasTapCoordinate = fromX !== void 0 || fromY !== void 0;
+    if (hasTapCoordinate && (fromX === void 0 || fromY === void 0)) {
+      throw new Error(`target.setup_actions[${index}] tap coordinates require both x and y.`);
+    }
+    if (hasTapCoordinate && fromX !== void 0 && fromY !== void 0) {
+      const tapCoordinates = [fromX, fromY];
+      if (coordinateMode === "ratio" && tapCoordinates.some((value2) => value2 < 0 || value2 > 1)) {
+        throw new Error(`target.setup_actions[${index}] tap ratio coordinates must be between 0 and 1.`);
+      }
+      if ((coordinateMode === void 0 || coordinateMode === "pixels") && tapCoordinates.some((value2) => value2 < 0)) {
+        throw new Error(`target.setup_actions[${index}] tap pixel coordinates must be non-negative.`);
+      }
+    }
+  }
   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.`);
@@ -6057,6 +6093,96 @@ async function executeSetupAction(action, ordinal, viewport) {
       await waitForAnyVisibleSelector(scope.context, action.selector, timeout);
       return { ...base, ...setupScopeEvidence(scope), ok: true, timeout_ms: timeout };
     }
+    if (type === "tap") {
+      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 fromX = setupFiniteNumber(action.from_x ?? action.fromX ?? action.x ?? action.click_x ?? action.clickX);
+      const fromY = setupFiniteNumber(action.from_y ?? action.fromY ?? action.y ?? action.click_y ?? action.clickY);
+      const hasTapPosition = fromX !== undefined || fromY !== undefined;
+      if (hasTapPosition && (fromX === undefined || fromY === undefined)) return { ...base, ...setupScopeEvidence(scope), reason: "missing_tap_coordinates", count, target_index: targetIndex };
+      const mode = String(action.coordinate_mode || action.coordinateMode || (hasTapPosition ? "pixels" : "ratio")).trim();
+      if (hasTapPosition && mode === "ratio" && [fromX, fromY].some((value) => value < 0 || value > 1)) return { ...base, ...setupScopeEvidence(scope), reason: "invalid_ratio_coordinates", count, target_index: targetIndex };
+      if (hasTapPosition && mode !== "ratio" && [fromX, fromY].some((value) => value < 0)) return { ...base, ...setupScopeEvidence(scope), reason: "invalid_pixel_coordinates", count, target_index: targetIndex };
+      const coordinate = (value, size) => mode === "ratio" ? value * size : value;
+      const localX = hasTapPosition && fromX !== undefined ? fromX : 0.5;
+      const localY = hasTapPosition && fromY !== undefined ? fromY : 0.5;
+      const point = {
+        x: box.x + coordinate(localX, box.width),
+        y: box.y + coordinate(localY, box.height),
+      };
+      const durationMs = setupNumber(action.duration_ms ?? action.durationMs, 0);
+      const pointerType = String(action.pointer_type || action.pointerType || "touch").trim().toLowerCase();
+      if (pointerType === "touch" || pointerType === "pen") {
+        const client = await page.context().newCDPSession(page);
+        try {
+          if (pointerType === "touch") {
+            const touchPoint = {
+              x: point.x,
+              y: point.y,
+              radiusX: 1,
+              radiusY: 1,
+              force: 1,
+              id: 11,
+            };
+            await client.send("Input.dispatchTouchEvent", {
+              type: "touchStart",
+              touchPoints: [touchPoint],
+            });
+            if (durationMs) await page.waitForTimeout(durationMs);
+            await client.send("Input.dispatchTouchEvent", {
+              type: "touchEnd",
+              touchPoints: [],
+            });
+          } else {
+            await client.send("Input.dispatchMouseEvent", {
+              type: "mousePressed",
+              x: point.x,
+              y: point.y,
+              button: "left",
+              buttons: 1,
+              clickCount: 1,
+              pointerType: "pen",
+            });
+            if (durationMs) await page.waitForTimeout(durationMs);
+            await client.send("Input.dispatchMouseEvent", {
+              type: "mouseReleased",
+              x: point.x,
+              y: point.y,
+              button: "left",
+              buttons: 0,
+              clickCount: 1,
+              pointerType: "pen",
+            });
+          }
+        } finally {
+          await client.detach().catch(() => {});
+        }
+      } else {
+        await page.mouse.click(point.x, point.y);
+      }
+      return {
+        ...base,
+        ...setupScopeEvidence(scope),
+        ok: true,
+        count,
+        target_index: targetIndex,
+        coordinate_mode: hasTapPosition ? mode : undefined,
+        x: hasTapPosition ? fromX : undefined,
+        y: hasTapPosition ? fromY : undefined,
+        pointer_type: pointerType,
+        input_dispatch: pointerType === "touch" || pointerType === "pen" ? "cdp" : "playwright_mouse",
+        duration_ms: durationMs || undefined,
+      };
+    }
     if (type === "drag") {
       const scope = await setupActionScope(action, timeout);
       if (!scope.ok) return setupScopeFailure(base, scope);

package/dist/cli.cjs CHANGED Viewed

@@ -7001,6 +7001,7 @@ var RIDDLE_PROOF_PROFILE_CHECK_TYPES = [
 ];
 var RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES = [
   "click",
+  "tap",
   "drag",
   "press",
   "fill",
@@ -7552,6 +7553,21 @@ function profileSetupDragReceipts(results) {
     reason: result.reason ?? result.error ?? null
   }));
 }
+function profileSetupTapReceipts(results) {
+  return results.filter((result) => profileSetupResultAction(result) === "tap").map((result) => ({
+    ordinal: result.ordinal ?? null,
+    ok: result.ok !== false,
+    selector: result.selector ?? null,
+    frame_selector: result.frame_selector ?? null,
+    pointer_type: result.pointer_type ?? null,
+    input_dispatch: result.input_dispatch ?? null,
+    coordinate_mode: result.coordinate_mode ?? null,
+    x: result.x ?? null,
+    y: result.y ?? null,
+    duration_ms: result.duration_ms ?? null,
+    reason: result.reason ?? result.error ?? null
+  }));
+}
 function profileSetupCanvasSignatureReceipts(results) {
   return results.filter((result) => profileSetupResultAction(result) === "canvas_signature").map((result) => ({
     ordinal: result.ordinal ?? null,
@@ -7713,6 +7729,8 @@ function profileSetupSummary(viewports, actionCount, expectedActionCountByViewpo
       const sampledRangeValueReceipts = sampleProfileSetupSummaryItems(rangeValueReceipts, 8);
       const dragReceipts = profileSetupDragReceipts(results);
       const sampledDragReceipts = sampleProfileSetupSummaryItems(dragReceipts, 8);
+      const tapReceipts = profileSetupTapReceipts(results);
+      const sampledTapReceipts = sampleProfileSetupSummaryItems(tapReceipts, 8);
       const canvasSignatureReceipts = profileSetupCanvasSignatureReceipts(results);
       const sampledCanvasSignatureReceipts = sampleProfileSetupSummaryItems(canvasSignatureReceipts, 8);
       const clickedItems = results.filter((result) => profileSetupResultAction(result) === "click" && result.ok !== false).map((result) => {
@@ -7777,6 +7795,9 @@ function profileSetupSummary(viewports, actionCount, expectedActionCountByViewpo
         drag_total: dragReceipts.length,
         drag_truncated: dragReceipts.length > sampledDragReceipts.length,
         drag: sampledDragReceipts,
+        tap_total: tapReceipts.length,
+        tap_truncated: tapReceipts.length > sampledTapReceipts.length,
+        tap: sampledTapReceipts,
         canvas_signature_total: canvasSignatureReceipts.length,
         canvas_signature_truncated: canvasSignatureReceipts.length > sampledCanvasSignatureReceipts.length,
         canvas_signature: sampledCanvasSignatureReceipts,
@@ -7833,7 +7854,7 @@ function isSupportedCheckType(value) {
 }
 function normalizeSetupActionType(value, index) {
   const normalizedInput = String(value || "").trim().replace(/-/g, "_");
-  const normalized = normalizedInput === "clear_browser_storage" ? "clear_storage" : normalizedInput === "reset_console" || normalizedInput === "clear_browser_console" || normalizedInput === "reset_browser_console" ? "clear_console" : normalizedInput === "pointer_drag" || normalizedInput === "mouse_drag" || normalizedInput === "drag_to" ? "drag" : normalizedInput === "keyboard_press" || normalizedInput === "key_press" ? "press" : normalizedInput === "set_slider_value" || normalizedInput === "slider_value" || normalizedInput === "set_slider" || normalizedInput === "set_range" || normalizedInput === "range_value" || normalizedInput === "range_input" || normalizedInput === "set_range_input" ? "set_range_value" : normalizedInput === "deterministic_runtime" || normalizedInput === "mock_runtime" || normalizedInput === "mock_random" || normalizedInput === "mock_random_queue" || normalizedInput === "seed_random_queue" || normalizedInput === "set_random_queue" || normalizedInput === "mock_clock" || normalizedInput === "set_mock_clock" || normalizedInput === "set_runtime_determinism" || normalizedInput === "runtime_determinism" ? "deterministic_runtime" : normalizedInput === "canvas_hash" || normalizedInput === "capture_canvas_hash" || normalizedInput === "capture_canvas_signature" || normalizedInput === "canvas_state_signature" ? "canvas_signature" : normalizedInput === "capture_screenshot" || normalizedInput === "save_screenshot" || normalizedInput === "setup_screenshot" ? "screenshot" : normalizedInput === "accept_dialog" || normalizedInput === "accept_dialogs" || normalizedInput === "confirm_dialog" || normalizedInput === "set_dialog_response" ? "dialog_response" : normalizedInput === "dismiss_dialog" || normalizedInput === "dismiss_dialogs" || normalizedInput === "cancel_dialog" ? "dialog_response" : normalizedInput === "window_call_until" || normalizedInput === "call_until" || normalizedInput === "window_call_repeat_until" || normalizedInput === "repeat_window_call_until" ? "window_call_until" : normalizedInput === "window_evaluate" || normalizedInput === "browser_eval" || normalizedInput === "browser_evaluate" || normalizedInput === "evaluate_script" || normalizedInput === "profile_script" ? "window_eval" : normalizedInput;
+  const normalized = normalizedInput === "clear_browser_storage" ? "clear_storage" : normalizedInput === "reset_console" || normalizedInput === "clear_browser_console" || normalizedInput === "reset_browser_console" ? "clear_console" : normalizedInput === "pointer_drag" || normalizedInput === "mouse_drag" || normalizedInput === "drag_to" ? "drag" : normalizedInput === "pointer_tap" || normalizedInput === "touch_tap" || normalizedInput === "canvas_tap" ? "tap" : normalizedInput === "keyboard_press" || normalizedInput === "key_press" ? "press" : normalizedInput === "set_slider_value" || normalizedInput === "slider_value" || normalizedInput === "set_slider" || normalizedInput === "set_range" || normalizedInput === "range_value" || normalizedInput === "range_input" || normalizedInput === "set_range_input" ? "set_range_value" : normalizedInput === "deterministic_runtime" || normalizedInput === "mock_runtime" || normalizedInput === "mock_random" || normalizedInput === "mock_random_queue" || normalizedInput === "seed_random_queue" || normalizedInput === "set_random_queue" || normalizedInput === "mock_clock" || normalizedInput === "set_mock_clock" || normalizedInput === "set_runtime_determinism" || normalizedInput === "runtime_determinism" ? "deterministic_runtime" : normalizedInput === "canvas_hash" || normalizedInput === "capture_canvas_hash" || normalizedInput === "capture_canvas_signature" || normalizedInput === "canvas_state_signature" ? "canvas_signature" : normalizedInput === "capture_screenshot" || normalizedInput === "save_screenshot" || normalizedInput === "setup_screenshot" ? "screenshot" : normalizedInput === "accept_dialog" || normalizedInput === "accept_dialogs" || normalizedInput === "confirm_dialog" || normalizedInput === "set_dialog_response" ? "dialog_response" : normalizedInput === "dismiss_dialog" || normalizedInput === "dismiss_dialogs" || normalizedInput === "cancel_dialog" ? "dialog_response" : normalizedInput === "window_call_until" || normalizedInput === "call_until" || normalizedInput === "window_call_repeat_until" || normalizedInput === "repeat_window_call_until" ? "window_call_until" : normalizedInput === "window_evaluate" || normalizedInput === "browser_eval" || normalizedInput === "browser_evaluate" || normalizedInput === "evaluate_script" || normalizedInput === "profile_script" ? "window_eval" : normalizedInput;
   if (RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES.includes(normalized)) {
     return normalized;
   }
@@ -7915,8 +7936,8 @@ function normalizeSetupActionCoordinateMode(value, index) {
 }
 function normalizeSetupActionPointerType(value, type, index) {
   if (value === void 0 || value === null || value === "") return void 0;
-  if (type !== "drag") {
-    throw new Error(`target.setup_actions[${index}].pointer_type is only supported for drag actions.`);
+  if (type !== "drag" && type !== "tap") {
+    throw new Error(`target.setup_actions[${index}].pointer_type is only supported for drag/tap actions.`);
   }
   const normalized = String(value).trim().replace(/-/g, "_").toLowerCase();
   if (normalized === "mouse") return "mouse";
@@ -7995,11 +8016,11 @@ 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 === "drag" || type === "fill" || type === "set_input_value" || type === "set_range_value" || type === "canvas_signature" || 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 === "tap" || type === "drag" || type === "fill" || type === "set_input_value" || type === "set_range_value" || type === "canvas_signature" || 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 = type === "click" ? numberValue(valueFromOwn(input, "from_x", "fromX", "x", "click_x", "clickX", "start_x", "startX", "x1")) : numberValue(valueFromOwn(input, "from_x", "fromX", "start_x", "startX", "x1"));
-  const fromY = type === "click" ? numberValue(valueFromOwn(input, "from_y", "fromY", "y", "click_y", "clickY", "start_y", "startY", "y1")) : numberValue(valueFromOwn(input, "from_y", "fromY", "start_y", "startY", "y1"));
+  const fromX = type === "click" || type === "tap" ? numberValue(valueFromOwn(input, "from_x", "fromX", "x", "click_x", "clickX", "start_x", "startX", "x1")) : numberValue(valueFromOwn(input, "from_x", "fromX", "start_x", "startX", "x1"));
+  const fromY = type === "click" || type === "tap" ? numberValue(valueFromOwn(input, "from_y", "fromY", "y", "click_y", "clickY", "start_y", "startY", "y1")) : 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);
@@ -8019,6 +8040,21 @@ function normalizeSetupAction(input, index) {
       }
     }
   }
+  if (type === "tap") {
+    const hasTapCoordinate = fromX !== void 0 || fromY !== void 0;
+    if (hasTapCoordinate && (fromX === void 0 || fromY === void 0)) {
+      throw new Error(`target.setup_actions[${index}] tap coordinates require both x and y.`);
+    }
+    if (hasTapCoordinate && fromX !== void 0 && fromY !== void 0) {
+      const tapCoordinates = [fromX, fromY];
+      if (coordinateMode === "ratio" && tapCoordinates.some((value2) => value2 < 0 || value2 > 1)) {
+        throw new Error(`target.setup_actions[${index}] tap ratio coordinates must be between 0 and 1.`);
+      }
+      if ((coordinateMode === void 0 || coordinateMode === "pixels") && tapCoordinates.some((value2) => value2 < 0)) {
+        throw new Error(`target.setup_actions[${index}] tap pixel coordinates must be non-negative.`);
+      }
+    }
+  }
   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.`);
@@ -12998,6 +13034,96 @@ async function executeSetupAction(action, ordinal, viewport) {
       await waitForAnyVisibleSelector(scope.context, action.selector, timeout);
       return { ...base, ...setupScopeEvidence(scope), ok: true, timeout_ms: timeout };
     }
+    if (type === "tap") {
+      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 fromX = setupFiniteNumber(action.from_x ?? action.fromX ?? action.x ?? action.click_x ?? action.clickX);
+      const fromY = setupFiniteNumber(action.from_y ?? action.fromY ?? action.y ?? action.click_y ?? action.clickY);
+      const hasTapPosition = fromX !== undefined || fromY !== undefined;
+      if (hasTapPosition && (fromX === undefined || fromY === undefined)) return { ...base, ...setupScopeEvidence(scope), reason: "missing_tap_coordinates", count, target_index: targetIndex };
+      const mode = String(action.coordinate_mode || action.coordinateMode || (hasTapPosition ? "pixels" : "ratio")).trim();
+      if (hasTapPosition && mode === "ratio" && [fromX, fromY].some((value) => value < 0 || value > 1)) return { ...base, ...setupScopeEvidence(scope), reason: "invalid_ratio_coordinates", count, target_index: targetIndex };
+      if (hasTapPosition && mode !== "ratio" && [fromX, fromY].some((value) => value < 0)) return { ...base, ...setupScopeEvidence(scope), reason: "invalid_pixel_coordinates", count, target_index: targetIndex };
+      const coordinate = (value, size) => mode === "ratio" ? value * size : value;
+      const localX = hasTapPosition && fromX !== undefined ? fromX : 0.5;
+      const localY = hasTapPosition && fromY !== undefined ? fromY : 0.5;
+      const point = {
+        x: box.x + coordinate(localX, box.width),
+        y: box.y + coordinate(localY, box.height),
+      };
+      const durationMs = setupNumber(action.duration_ms ?? action.durationMs, 0);
+      const pointerType = String(action.pointer_type || action.pointerType || "touch").trim().toLowerCase();
+      if (pointerType === "touch" || pointerType === "pen") {
+        const client = await page.context().newCDPSession(page);
+        try {
+          if (pointerType === "touch") {
+            const touchPoint = {
+              x: point.x,
+              y: point.y,
+              radiusX: 1,
+              radiusY: 1,
+              force: 1,
+              id: 11,
+            };
+            await client.send("Input.dispatchTouchEvent", {
+              type: "touchStart",
+              touchPoints: [touchPoint],
+            });
+            if (durationMs) await page.waitForTimeout(durationMs);
+            await client.send("Input.dispatchTouchEvent", {
+              type: "touchEnd",
+              touchPoints: [],
+            });
+          } else {
+            await client.send("Input.dispatchMouseEvent", {
+              type: "mousePressed",
+              x: point.x,
+              y: point.y,
+              button: "left",
+              buttons: 1,
+              clickCount: 1,
+              pointerType: "pen",
+            });
+            if (durationMs) await page.waitForTimeout(durationMs);
+            await client.send("Input.dispatchMouseEvent", {
+              type: "mouseReleased",
+              x: point.x,
+              y: point.y,
+              button: "left",
+              buttons: 0,
+              clickCount: 1,
+              pointerType: "pen",
+            });
+          }
+        } finally {
+          await client.detach().catch(() => {});
+        }
+      } else {
+        await page.mouse.click(point.x, point.y);
+      }
+      return {
+        ...base,
+        ...setupScopeEvidence(scope),
+        ok: true,
+        count,
+        target_index: targetIndex,
+        coordinate_mode: hasTapPosition ? mode : undefined,
+        x: hasTapPosition ? fromX : undefined,
+        y: hasTapPosition ? fromY : undefined,
+        pointer_type: pointerType,
+        input_dispatch: pointerType === "touch" || pointerType === "pen" ? "cdp" : "playwright_mouse",
+        duration_ms: durationMs || undefined,
+      };
+    }
     if (type === "drag") {
       const scope = await setupActionScope(action, timeout);
       if (!scope.ok) return setupScopeFailure(base, scope);
@@ -16279,6 +16405,7 @@ function profileSetupSummaryMarkdown(result) {
   const windowCallUntilCallTotal = viewports.reduce((sum, viewport) => sum + (cliFiniteNumber(viewport.window_call_until_call_total) || 0), 0);
   const rangeValueTotal = viewports.reduce((sum, viewport) => sum + (cliFiniteNumber(viewport.set_range_value_total) || 0), 0);
   const dragTotal = viewports.reduce((sum, viewport) => sum + (cliFiniteNumber(viewport.drag_total) || 0), 0);
+  const tapTotal = viewports.reduce((sum, viewport) => sum + (cliFiniteNumber(viewport.tap_total) || 0), 0);
   const canvasSignatureTotal = viewports.reduce((sum, viewport) => sum + (cliFiniteNumber(viewport.canvas_signature_total) || 0), 0);
   const failedTotal = viewports.reduce((sum, viewport) => sum + (Array.isArray(viewport.failed) ? viewport.failed.length : 0), 0);
   const lines = [
@@ -16311,6 +16438,9 @@ function profileSetupSummaryMarkdown(result) {
   if (dragTotal) {
     lines.push(`- drag: ${dragTotal} action(s)`);
   }
+  if (tapTotal) {
+    lines.push(`- tap: ${tapTotal} action(s)`);
+  }
   if (canvasSignatureTotal) {
     lines.push(`- canvas_signature: ${canvasSignatureTotal} action(s)`);
   }
@@ -16333,9 +16463,10 @@ function profileSetupSummaryMarkdown(result) {
     const windowCallUntilCalls = cliFiniteNumber(viewport.window_call_until_call_total) || 0;
     const rangeValueActions = cliFiniteNumber(viewport.set_range_value_total) || 0;
     const dragActions = cliFiniteNumber(viewport.drag_total) || 0;
+    const tapActions = cliFiniteNumber(viewport.tap_total) || 0;
     const canvasSignatureActions = cliFiniteNumber(viewport.canvas_signature_total) || 0;
     const observedPath = cliString(viewport.observed_path);
-    lines.push(`- ${name}: ${ok}, ${resultCount} result(s), ${screenshotCount} setup screenshot(s), ${clicked} click(s)${clickSequenceCount ? `, ${clickSequenceCount} click sequence(s)` : ""}${clickCountActions ? `, ${clickCountActions} click_count action(s)` : ""}${rangeValueActions ? `, ${rangeValueActions} set_range_value action(s)` : ""}${dragActions ? `, ${dragActions} drag action(s)` : ""}${canvasSignatureActions ? `, ${canvasSignatureActions} canvas_signature action(s)` : ""}${deterministicRuntimeActions ? `, ${deterministicRuntimeActions} deterministic_runtime action(s)` : ""}${windowCallActions ? `, ${windowCallActions} window_call action(s), ${windowCallStored} stored return(s), ${windowCallCaptured} captured return(s)` : ""}${windowEvalActions ? `, ${windowEvalActions} window_eval action(s), ${windowEvalStored} stored return(s), ${windowEvalCaptured} captured return(s)` : ""}${windowCallUntilActions ? `, ${windowCallUntilActions} window_call_until action(s), ${windowCallUntilCalls} call(s)` : ""}${observedPath ? `, path ${observedPath}` : ""}`);
+    lines.push(`- ${name}: ${ok}, ${resultCount} result(s), ${screenshotCount} setup screenshot(s), ${clicked} click(s)${clickSequenceCount ? `, ${clickSequenceCount} click sequence(s)` : ""}${clickCountActions ? `, ${clickCountActions} click_count action(s)` : ""}${rangeValueActions ? `, ${rangeValueActions} set_range_value action(s)` : ""}${dragActions ? `, ${dragActions} drag action(s)` : ""}${tapActions ? `, ${tapActions} tap action(s)` : ""}${canvasSignatureActions ? `, ${canvasSignatureActions} canvas_signature action(s)` : ""}${deterministicRuntimeActions ? `, ${deterministicRuntimeActions} deterministic_runtime action(s)` : ""}${windowCallActions ? `, ${windowCallActions} window_call action(s), ${windowCallStored} stored return(s), ${windowCallCaptured} captured return(s)` : ""}${windowEvalActions ? `, ${windowEvalActions} window_eval action(s), ${windowEvalStored} stored return(s), ${windowEvalCaptured} captured return(s)` : ""}${windowCallUntilActions ? `, ${windowCallUntilActions} window_call_until action(s), ${windowCallUntilCalls} call(s)` : ""}${observedPath ? `, path ${observedPath}` : ""}`);
   }
   const clickSequenceGroups = viewports.map((viewport) => {
     const name = cliString(viewport.name) || "viewport";
@@ -16381,6 +16512,27 @@ function profileSetupSummaryMarkdown(result) {
     lines.push(`- ${name} drag: ${ok}, ${markdownInlineCode(selector)}${pointerType ? ` ${markdownInlineCode(pointerType)}` : ""}${inputDispatch ? ` via ${markdownInlineCode(inputDispatch)}` : ""}${coordinateText}${steps === void 0 ? "" : `, steps ${steps}`}${durationMs === void 0 ? "" : `, duration ${durationMs}ms`}${reason ? `, reason ${markdownInlineCode(reason, 100)}` : ""}`);
   }
   if (dragDetails.length > sampledDragDetails.length) lines.push(`- ${dragDetails.length - sampledDragDetails.length} additional drag receipt(s) omitted.`);
+  const tapGroups = viewports.map((viewport) => {
+    const name = cliString(viewport.name) || "viewport";
+    const receipts = Array.isArray(viewport.tap) ? viewport.tap.map(cliRecord).filter((item) => Boolean(item)) : [];
+    return receipts.map((receipt) => ({ name, receipt }));
+  });
+  const tapDetails = tapGroups.flat();
+  const sampledTapDetails = balancedSetupReceiptDetails(tapGroups, 12);
+  for (const { name, receipt } of sampledTapDetails) {
+    const selector = cliString(receipt.selector) || "target";
+    const pointerType = cliString(receipt.pointer_type);
+    const inputDispatch = cliString(receipt.input_dispatch);
+    const coordinateMode = cliString(receipt.coordinate_mode);
+    const x = cliValueLabel(receipt.x);
+    const y = cliValueLabel(receipt.y);
+    const durationMs = cliFiniteNumber(receipt.duration_ms);
+    const ok = receipt.ok === false ? "failed" : "ok";
+    const reason = cliString(receipt.reason);
+    const coordinateText = x && y ? `, ${coordinateMode ? `${coordinateMode} ` : ""}${markdownInlineCode(`${x},${y}`)}` : "";
+    lines.push(`- ${name} tap: ${ok}, ${markdownInlineCode(selector)}${pointerType ? ` ${markdownInlineCode(pointerType)}` : ""}${inputDispatch ? ` via ${markdownInlineCode(inputDispatch)}` : ""}${coordinateText}${durationMs === void 0 ? "" : `, duration ${durationMs}ms`}${reason ? `, reason ${markdownInlineCode(reason, 100)}` : ""}`);
+  }
+  if (tapDetails.length > sampledTapDetails.length) lines.push(`- ${tapDetails.length - sampledTapDetails.length} additional tap receipt(s) omitted.`);
   const canvasSignatureGroups = viewports.map((viewport) => {
     const name = cliString(viewport.name) || "viewport";
     const receipts = Array.isArray(viewport.canvas_signature) ? viewport.canvas_signature.map(cliRecord).filter((item) => Boolean(item)) : [];

package/dist/cli.js CHANGED Viewed

@@ -13,7 +13,7 @@ import {
   profileStatusExitCode,
   resolveRiddleProofProfileTargetUrl,
   resolveRiddleProofProfileTimeoutSec
-} from "./chunk-JIAMASZX.js";
+} from "./chunk-BD4RHTGW.js";
 import {
   createRiddleApiClient,
   isTerminalRiddleJobStatus,
@@ -790,6 +790,7 @@ function profileSetupSummaryMarkdown(result) {
   const windowCallUntilCallTotal = viewports.reduce((sum, viewport) => sum + (cliFiniteNumber(viewport.window_call_until_call_total) || 0), 0);
   const rangeValueTotal = viewports.reduce((sum, viewport) => sum + (cliFiniteNumber(viewport.set_range_value_total) || 0), 0);
   const dragTotal = viewports.reduce((sum, viewport) => sum + (cliFiniteNumber(viewport.drag_total) || 0), 0);
+  const tapTotal = viewports.reduce((sum, viewport) => sum + (cliFiniteNumber(viewport.tap_total) || 0), 0);
   const canvasSignatureTotal = viewports.reduce((sum, viewport) => sum + (cliFiniteNumber(viewport.canvas_signature_total) || 0), 0);
   const failedTotal = viewports.reduce((sum, viewport) => sum + (Array.isArray(viewport.failed) ? viewport.failed.length : 0), 0);
   const lines = [
@@ -822,6 +823,9 @@ function profileSetupSummaryMarkdown(result) {
   if (dragTotal) {
     lines.push(`- drag: ${dragTotal} action(s)`);
   }
+  if (tapTotal) {
+    lines.push(`- tap: ${tapTotal} action(s)`);
+  }
   if (canvasSignatureTotal) {
     lines.push(`- canvas_signature: ${canvasSignatureTotal} action(s)`);
   }
@@ -844,9 +848,10 @@ function profileSetupSummaryMarkdown(result) {
     const windowCallUntilCalls = cliFiniteNumber(viewport.window_call_until_call_total) || 0;
     const rangeValueActions = cliFiniteNumber(viewport.set_range_value_total) || 0;
     const dragActions = cliFiniteNumber(viewport.drag_total) || 0;
+    const tapActions = cliFiniteNumber(viewport.tap_total) || 0;
     const canvasSignatureActions = cliFiniteNumber(viewport.canvas_signature_total) || 0;
     const observedPath = cliString(viewport.observed_path);
-    lines.push(`- ${name}: ${ok}, ${resultCount} result(s), ${screenshotCount} setup screenshot(s), ${clicked} click(s)${clickSequenceCount ? `, ${clickSequenceCount} click sequence(s)` : ""}${clickCountActions ? `, ${clickCountActions} click_count action(s)` : ""}${rangeValueActions ? `, ${rangeValueActions} set_range_value action(s)` : ""}${dragActions ? `, ${dragActions} drag action(s)` : ""}${canvasSignatureActions ? `, ${canvasSignatureActions} canvas_signature action(s)` : ""}${deterministicRuntimeActions ? `, ${deterministicRuntimeActions} deterministic_runtime action(s)` : ""}${windowCallActions ? `, ${windowCallActions} window_call action(s), ${windowCallStored} stored return(s), ${windowCallCaptured} captured return(s)` : ""}${windowEvalActions ? `, ${windowEvalActions} window_eval action(s), ${windowEvalStored} stored return(s), ${windowEvalCaptured} captured return(s)` : ""}${windowCallUntilActions ? `, ${windowCallUntilActions} window_call_until action(s), ${windowCallUntilCalls} call(s)` : ""}${observedPath ? `, path ${observedPath}` : ""}`);
+    lines.push(`- ${name}: ${ok}, ${resultCount} result(s), ${screenshotCount} setup screenshot(s), ${clicked} click(s)${clickSequenceCount ? `, ${clickSequenceCount} click sequence(s)` : ""}${clickCountActions ? `, ${clickCountActions} click_count action(s)` : ""}${rangeValueActions ? `, ${rangeValueActions} set_range_value action(s)` : ""}${dragActions ? `, ${dragActions} drag action(s)` : ""}${tapActions ? `, ${tapActions} tap action(s)` : ""}${canvasSignatureActions ? `, ${canvasSignatureActions} canvas_signature action(s)` : ""}${deterministicRuntimeActions ? `, ${deterministicRuntimeActions} deterministic_runtime action(s)` : ""}${windowCallActions ? `, ${windowCallActions} window_call action(s), ${windowCallStored} stored return(s), ${windowCallCaptured} captured return(s)` : ""}${windowEvalActions ? `, ${windowEvalActions} window_eval action(s), ${windowEvalStored} stored return(s), ${windowEvalCaptured} captured return(s)` : ""}${windowCallUntilActions ? `, ${windowCallUntilActions} window_call_until action(s), ${windowCallUntilCalls} call(s)` : ""}${observedPath ? `, path ${observedPath}` : ""}`);
   }
   const clickSequenceGroups = viewports.map((viewport) => {
     const name = cliString(viewport.name) || "viewport";
@@ -892,6 +897,27 @@ function profileSetupSummaryMarkdown(result) {
     lines.push(`- ${name} drag: ${ok}, ${markdownInlineCode(selector)}${pointerType ? ` ${markdownInlineCode(pointerType)}` : ""}${inputDispatch ? ` via ${markdownInlineCode(inputDispatch)}` : ""}${coordinateText}${steps === void 0 ? "" : `, steps ${steps}`}${durationMs === void 0 ? "" : `, duration ${durationMs}ms`}${reason ? `, reason ${markdownInlineCode(reason, 100)}` : ""}`);
   }
   if (dragDetails.length > sampledDragDetails.length) lines.push(`- ${dragDetails.length - sampledDragDetails.length} additional drag receipt(s) omitted.`);
+  const tapGroups = viewports.map((viewport) => {
+    const name = cliString(viewport.name) || "viewport";
+    const receipts = Array.isArray(viewport.tap) ? viewport.tap.map(cliRecord).filter((item) => Boolean(item)) : [];
+    return receipts.map((receipt) => ({ name, receipt }));
+  });
+  const tapDetails = tapGroups.flat();
+  const sampledTapDetails = balancedSetupReceiptDetails(tapGroups, 12);
+  for (const { name, receipt } of sampledTapDetails) {
+    const selector = cliString(receipt.selector) || "target";
+    const pointerType = cliString(receipt.pointer_type);
+    const inputDispatch = cliString(receipt.input_dispatch);
+    const coordinateMode = cliString(receipt.coordinate_mode);
+    const x = cliValueLabel(receipt.x);
+    const y = cliValueLabel(receipt.y);
+    const durationMs = cliFiniteNumber(receipt.duration_ms);
+    const ok = receipt.ok === false ? "failed" : "ok";
+    const reason = cliString(receipt.reason);
+    const coordinateText = x && y ? `, ${coordinateMode ? `${coordinateMode} ` : ""}${markdownInlineCode(`${x},${y}`)}` : "";
+    lines.push(`- ${name} tap: ${ok}, ${markdownInlineCode(selector)}${pointerType ? ` ${markdownInlineCode(pointerType)}` : ""}${inputDispatch ? ` via ${markdownInlineCode(inputDispatch)}` : ""}${coordinateText}${durationMs === void 0 ? "" : `, duration ${durationMs}ms`}${reason ? `, reason ${markdownInlineCode(reason, 100)}` : ""}`);
+  }
+  if (tapDetails.length > sampledTapDetails.length) lines.push(`- ${tapDetails.length - sampledTapDetails.length} additional tap receipt(s) omitted.`);
   const canvasSignatureGroups = viewports.map((viewport) => {
     const name = cliString(viewport.name) || "viewport";
     const receipts = Array.isArray(viewport.canvas_signature) ? viewport.canvas_signature.map(cliRecord).filter((item) => Boolean(item)) : [];

package/dist/index.cjs CHANGED Viewed

@@ -8777,6 +8777,7 @@ var RIDDLE_PROOF_PROFILE_CHECK_TYPES = [
 ];
 var RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES = [
   "click",
+  "tap",
   "drag",
   "press",
   "fill",
@@ -9328,6 +9329,21 @@ function profileSetupDragReceipts(results) {
     reason: result.reason ?? result.error ?? null
   }));
 }
+function profileSetupTapReceipts(results) {
+  return results.filter((result) => profileSetupResultAction(result) === "tap").map((result) => ({
+    ordinal: result.ordinal ?? null,
+    ok: result.ok !== false,
+    selector: result.selector ?? null,
+    frame_selector: result.frame_selector ?? null,
+    pointer_type: result.pointer_type ?? null,
+    input_dispatch: result.input_dispatch ?? null,
+    coordinate_mode: result.coordinate_mode ?? null,
+    x: result.x ?? null,
+    y: result.y ?? null,
+    duration_ms: result.duration_ms ?? null,
+    reason: result.reason ?? result.error ?? null
+  }));
+}
 function profileSetupCanvasSignatureReceipts(results) {
   return results.filter((result) => profileSetupResultAction(result) === "canvas_signature").map((result) => ({
     ordinal: result.ordinal ?? null,
@@ -9489,6 +9505,8 @@ function profileSetupSummary(viewports, actionCount, expectedActionCountByViewpo
       const sampledRangeValueReceipts = sampleProfileSetupSummaryItems(rangeValueReceipts, 8);
       const dragReceipts = profileSetupDragReceipts(results);
       const sampledDragReceipts = sampleProfileSetupSummaryItems(dragReceipts, 8);
+      const tapReceipts = profileSetupTapReceipts(results);
+      const sampledTapReceipts = sampleProfileSetupSummaryItems(tapReceipts, 8);
       const canvasSignatureReceipts = profileSetupCanvasSignatureReceipts(results);
       const sampledCanvasSignatureReceipts = sampleProfileSetupSummaryItems(canvasSignatureReceipts, 8);
       const clickedItems = results.filter((result) => profileSetupResultAction(result) === "click" && result.ok !== false).map((result) => {
@@ -9553,6 +9571,9 @@ function profileSetupSummary(viewports, actionCount, expectedActionCountByViewpo
         drag_total: dragReceipts.length,
         drag_truncated: dragReceipts.length > sampledDragReceipts.length,
         drag: sampledDragReceipts,
+        tap_total: tapReceipts.length,
+        tap_truncated: tapReceipts.length > sampledTapReceipts.length,
+        tap: sampledTapReceipts,
         canvas_signature_total: canvasSignatureReceipts.length,
         canvas_signature_truncated: canvasSignatureReceipts.length > sampledCanvasSignatureReceipts.length,
         canvas_signature: sampledCanvasSignatureReceipts,
@@ -9609,7 +9630,7 @@ function isSupportedCheckType(value) {
 }
 function normalizeSetupActionType(value, index) {
   const normalizedInput = String(value || "").trim().replace(/-/g, "_");
-  const normalized = normalizedInput === "clear_browser_storage" ? "clear_storage" : normalizedInput === "reset_console" || normalizedInput === "clear_browser_console" || normalizedInput === "reset_browser_console" ? "clear_console" : normalizedInput === "pointer_drag" || normalizedInput === "mouse_drag" || normalizedInput === "drag_to" ? "drag" : normalizedInput === "keyboard_press" || normalizedInput === "key_press" ? "press" : normalizedInput === "set_slider_value" || normalizedInput === "slider_value" || normalizedInput === "set_slider" || normalizedInput === "set_range" || normalizedInput === "range_value" || normalizedInput === "range_input" || normalizedInput === "set_range_input" ? "set_range_value" : normalizedInput === "deterministic_runtime" || normalizedInput === "mock_runtime" || normalizedInput === "mock_random" || normalizedInput === "mock_random_queue" || normalizedInput === "seed_random_queue" || normalizedInput === "set_random_queue" || normalizedInput === "mock_clock" || normalizedInput === "set_mock_clock" || normalizedInput === "set_runtime_determinism" || normalizedInput === "runtime_determinism" ? "deterministic_runtime" : normalizedInput === "canvas_hash" || normalizedInput === "capture_canvas_hash" || normalizedInput === "capture_canvas_signature" || normalizedInput === "canvas_state_signature" ? "canvas_signature" : normalizedInput === "capture_screenshot" || normalizedInput === "save_screenshot" || normalizedInput === "setup_screenshot" ? "screenshot" : normalizedInput === "accept_dialog" || normalizedInput === "accept_dialogs" || normalizedInput === "confirm_dialog" || normalizedInput === "set_dialog_response" ? "dialog_response" : normalizedInput === "dismiss_dialog" || normalizedInput === "dismiss_dialogs" || normalizedInput === "cancel_dialog" ? "dialog_response" : normalizedInput === "window_call_until" || normalizedInput === "call_until" || normalizedInput === "window_call_repeat_until" || normalizedInput === "repeat_window_call_until" ? "window_call_until" : normalizedInput === "window_evaluate" || normalizedInput === "browser_eval" || normalizedInput === "browser_evaluate" || normalizedInput === "evaluate_script" || normalizedInput === "profile_script" ? "window_eval" : normalizedInput;
+  const normalized = normalizedInput === "clear_browser_storage" ? "clear_storage" : normalizedInput === "reset_console" || normalizedInput === "clear_browser_console" || normalizedInput === "reset_browser_console" ? "clear_console" : normalizedInput === "pointer_drag" || normalizedInput === "mouse_drag" || normalizedInput === "drag_to" ? "drag" : normalizedInput === "pointer_tap" || normalizedInput === "touch_tap" || normalizedInput === "canvas_tap" ? "tap" : normalizedInput === "keyboard_press" || normalizedInput === "key_press" ? "press" : normalizedInput === "set_slider_value" || normalizedInput === "slider_value" || normalizedInput === "set_slider" || normalizedInput === "set_range" || normalizedInput === "range_value" || normalizedInput === "range_input" || normalizedInput === "set_range_input" ? "set_range_value" : normalizedInput === "deterministic_runtime" || normalizedInput === "mock_runtime" || normalizedInput === "mock_random" || normalizedInput === "mock_random_queue" || normalizedInput === "seed_random_queue" || normalizedInput === "set_random_queue" || normalizedInput === "mock_clock" || normalizedInput === "set_mock_clock" || normalizedInput === "set_runtime_determinism" || normalizedInput === "runtime_determinism" ? "deterministic_runtime" : normalizedInput === "canvas_hash" || normalizedInput === "capture_canvas_hash" || normalizedInput === "capture_canvas_signature" || normalizedInput === "canvas_state_signature" ? "canvas_signature" : normalizedInput === "capture_screenshot" || normalizedInput === "save_screenshot" || normalizedInput === "setup_screenshot" ? "screenshot" : normalizedInput === "accept_dialog" || normalizedInput === "accept_dialogs" || normalizedInput === "confirm_dialog" || normalizedInput === "set_dialog_response" ? "dialog_response" : normalizedInput === "dismiss_dialog" || normalizedInput === "dismiss_dialogs" || normalizedInput === "cancel_dialog" ? "dialog_response" : normalizedInput === "window_call_until" || normalizedInput === "call_until" || normalizedInput === "window_call_repeat_until" || normalizedInput === "repeat_window_call_until" ? "window_call_until" : normalizedInput === "window_evaluate" || normalizedInput === "browser_eval" || normalizedInput === "browser_evaluate" || normalizedInput === "evaluate_script" || normalizedInput === "profile_script" ? "window_eval" : normalizedInput;
   if (RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES.includes(normalized)) {
     return normalized;
   }
@@ -9691,8 +9712,8 @@ function normalizeSetupActionCoordinateMode(value, index) {
 }
 function normalizeSetupActionPointerType(value, type, index) {
   if (value === void 0 || value === null || value === "") return void 0;
-  if (type !== "drag") {
-    throw new Error(`target.setup_actions[${index}].pointer_type is only supported for drag actions.`);
+  if (type !== "drag" && type !== "tap") {
+    throw new Error(`target.setup_actions[${index}].pointer_type is only supported for drag/tap actions.`);
   }
   const normalized = String(value).trim().replace(/-/g, "_").toLowerCase();
   if (normalized === "mouse") return "mouse";
@@ -9771,11 +9792,11 @@ 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 === "drag" || type === "fill" || type === "set_input_value" || type === "set_range_value" || type === "canvas_signature" || 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 === "tap" || type === "drag" || type === "fill" || type === "set_input_value" || type === "set_range_value" || type === "canvas_signature" || 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 = type === "click" ? numberValue3(valueFromOwn(input, "from_x", "fromX", "x", "click_x", "clickX", "start_x", "startX", "x1")) : numberValue3(valueFromOwn(input, "from_x", "fromX", "start_x", "startX", "x1"));
-  const fromY = type === "click" ? numberValue3(valueFromOwn(input, "from_y", "fromY", "y", "click_y", "clickY", "start_y", "startY", "y1")) : numberValue3(valueFromOwn(input, "from_y", "fromY", "start_y", "startY", "y1"));
+  const fromX = type === "click" || type === "tap" ? numberValue3(valueFromOwn(input, "from_x", "fromX", "x", "click_x", "clickX", "start_x", "startX", "x1")) : numberValue3(valueFromOwn(input, "from_x", "fromX", "start_x", "startX", "x1"));
+  const fromY = type === "click" || type === "tap" ? numberValue3(valueFromOwn(input, "from_y", "fromY", "y", "click_y", "clickY", "start_y", "startY", "y1")) : numberValue3(valueFromOwn(input, "from_y", "fromY", "start_y", "startY", "y1"));
   const toX = numberValue3(valueFromOwn(input, "to_x", "toX", "end_x", "endX", "x2"));
   const toY = numberValue3(valueFromOwn(input, "to_y", "toY", "end_y", "endY", "y2"));
   const coordinateMode = normalizeSetupActionCoordinateMode(valueFromOwn(input, "coordinate_mode", "coordinateMode", "coords", "units"), index);
@@ -9795,6 +9816,21 @@ function normalizeSetupAction(input, index) {
       }
     }
   }
+  if (type === "tap") {
+    const hasTapCoordinate = fromX !== void 0 || fromY !== void 0;
+    if (hasTapCoordinate && (fromX === void 0 || fromY === void 0)) {
+      throw new Error(`target.setup_actions[${index}] tap coordinates require both x and y.`);
+    }
+    if (hasTapCoordinate && fromX !== void 0 && fromY !== void 0) {
+      const tapCoordinates = [fromX, fromY];
+      if (coordinateMode === "ratio" && tapCoordinates.some((value2) => value2 < 0 || value2 > 1)) {
+        throw new Error(`target.setup_actions[${index}] tap ratio coordinates must be between 0 and 1.`);
+      }
+      if ((coordinateMode === void 0 || coordinateMode === "pixels") && tapCoordinates.some((value2) => value2 < 0)) {
+        throw new Error(`target.setup_actions[${index}] tap pixel coordinates must be non-negative.`);
+      }
+    }
+  }
   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.`);
@@ -14790,6 +14826,96 @@ async function executeSetupAction(action, ordinal, viewport) {
       await waitForAnyVisibleSelector(scope.context, action.selector, timeout);
       return { ...base, ...setupScopeEvidence(scope), ok: true, timeout_ms: timeout };
     }
+    if (type === "tap") {
+      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 fromX = setupFiniteNumber(action.from_x ?? action.fromX ?? action.x ?? action.click_x ?? action.clickX);
+      const fromY = setupFiniteNumber(action.from_y ?? action.fromY ?? action.y ?? action.click_y ?? action.clickY);
+      const hasTapPosition = fromX !== undefined || fromY !== undefined;
+      if (hasTapPosition && (fromX === undefined || fromY === undefined)) return { ...base, ...setupScopeEvidence(scope), reason: "missing_tap_coordinates", count, target_index: targetIndex };
+      const mode = String(action.coordinate_mode || action.coordinateMode || (hasTapPosition ? "pixels" : "ratio")).trim();
+      if (hasTapPosition && mode === "ratio" && [fromX, fromY].some((value) => value < 0 || value > 1)) return { ...base, ...setupScopeEvidence(scope), reason: "invalid_ratio_coordinates", count, target_index: targetIndex };
+      if (hasTapPosition && mode !== "ratio" && [fromX, fromY].some((value) => value < 0)) return { ...base, ...setupScopeEvidence(scope), reason: "invalid_pixel_coordinates", count, target_index: targetIndex };
+      const coordinate = (value, size) => mode === "ratio" ? value * size : value;
+      const localX = hasTapPosition && fromX !== undefined ? fromX : 0.5;
+      const localY = hasTapPosition && fromY !== undefined ? fromY : 0.5;
+      const point = {
+        x: box.x + coordinate(localX, box.width),
+        y: box.y + coordinate(localY, box.height),
+      };
+      const durationMs = setupNumber(action.duration_ms ?? action.durationMs, 0);
+      const pointerType = String(action.pointer_type || action.pointerType || "touch").trim().toLowerCase();
+      if (pointerType === "touch" || pointerType === "pen") {
+        const client = await page.context().newCDPSession(page);
+        try {
+          if (pointerType === "touch") {
+            const touchPoint = {
+              x: point.x,
+              y: point.y,
+              radiusX: 1,
+              radiusY: 1,
+              force: 1,
+              id: 11,
+            };
+            await client.send("Input.dispatchTouchEvent", {
+              type: "touchStart",
+              touchPoints: [touchPoint],
+            });
+            if (durationMs) await page.waitForTimeout(durationMs);
+            await client.send("Input.dispatchTouchEvent", {
+              type: "touchEnd",
+              touchPoints: [],
+            });
+          } else {
+            await client.send("Input.dispatchMouseEvent", {
+              type: "mousePressed",
+              x: point.x,
+              y: point.y,
+              button: "left",
+              buttons: 1,
+              clickCount: 1,
+              pointerType: "pen",
+            });
+            if (durationMs) await page.waitForTimeout(durationMs);
+            await client.send("Input.dispatchMouseEvent", {
+              type: "mouseReleased",
+              x: point.x,
+              y: point.y,
+              button: "left",
+              buttons: 0,
+              clickCount: 1,
+              pointerType: "pen",
+            });
+          }
+        } finally {
+          await client.detach().catch(() => {});
+        }
+      } else {
+        await page.mouse.click(point.x, point.y);
+      }
+      return {
+        ...base,
+        ...setupScopeEvidence(scope),
+        ok: true,
+        count,
+        target_index: targetIndex,
+        coordinate_mode: hasTapPosition ? mode : undefined,
+        x: hasTapPosition ? fromX : undefined,
+        y: hasTapPosition ? fromY : undefined,
+        pointer_type: pointerType,
+        input_dispatch: pointerType === "touch" || pointerType === "pen" ? "cdp" : "playwright_mouse",
+        duration_ms: durationMs || undefined,
+      };
+    }
     if (type === "drag") {
       const scope = await setupActionScope(action, timeout);
       if (!scope.ok) return setupScopeFailure(base, scope);

package/dist/index.js CHANGED Viewed

@@ -62,7 +62,7 @@ import {
   resolveRiddleProofProfileTimeoutSec,
   slugifyRiddleProofProfileName,
   summarizeRiddleProofProfileResult
-} from "./chunk-JIAMASZX.js";
+} from "./chunk-BD4RHTGW.js";
 import {
   DEFAULT_RIDDLE_API_BASE_URL,
   DEFAULT_RIDDLE_API_KEY_FILE,

package/dist/profile.cjs CHANGED Viewed

@@ -91,6 +91,7 @@ var RIDDLE_PROOF_PROFILE_CHECK_TYPES = [
 ];
 var RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES = [
   "click",
+  "tap",
   "drag",
   "press",
   "fill",
@@ -642,6 +643,21 @@ function profileSetupDragReceipts(results) {
     reason: result.reason ?? result.error ?? null
   }));
 }
+function profileSetupTapReceipts(results) {
+  return results.filter((result) => profileSetupResultAction(result) === "tap").map((result) => ({
+    ordinal: result.ordinal ?? null,
+    ok: result.ok !== false,
+    selector: result.selector ?? null,
+    frame_selector: result.frame_selector ?? null,
+    pointer_type: result.pointer_type ?? null,
+    input_dispatch: result.input_dispatch ?? null,
+    coordinate_mode: result.coordinate_mode ?? null,
+    x: result.x ?? null,
+    y: result.y ?? null,
+    duration_ms: result.duration_ms ?? null,
+    reason: result.reason ?? result.error ?? null
+  }));
+}
 function profileSetupCanvasSignatureReceipts(results) {
   return results.filter((result) => profileSetupResultAction(result) === "canvas_signature").map((result) => ({
     ordinal: result.ordinal ?? null,
@@ -803,6 +819,8 @@ function profileSetupSummary(viewports, actionCount, expectedActionCountByViewpo
       const sampledRangeValueReceipts = sampleProfileSetupSummaryItems(rangeValueReceipts, 8);
       const dragReceipts = profileSetupDragReceipts(results);
       const sampledDragReceipts = sampleProfileSetupSummaryItems(dragReceipts, 8);
+      const tapReceipts = profileSetupTapReceipts(results);
+      const sampledTapReceipts = sampleProfileSetupSummaryItems(tapReceipts, 8);
       const canvasSignatureReceipts = profileSetupCanvasSignatureReceipts(results);
       const sampledCanvasSignatureReceipts = sampleProfileSetupSummaryItems(canvasSignatureReceipts, 8);
       const clickedItems = results.filter((result) => profileSetupResultAction(result) === "click" && result.ok !== false).map((result) => {
@@ -867,6 +885,9 @@ function profileSetupSummary(viewports, actionCount, expectedActionCountByViewpo
         drag_total: dragReceipts.length,
         drag_truncated: dragReceipts.length > sampledDragReceipts.length,
         drag: sampledDragReceipts,
+        tap_total: tapReceipts.length,
+        tap_truncated: tapReceipts.length > sampledTapReceipts.length,
+        tap: sampledTapReceipts,
         canvas_signature_total: canvasSignatureReceipts.length,
         canvas_signature_truncated: canvasSignatureReceipts.length > sampledCanvasSignatureReceipts.length,
         canvas_signature: sampledCanvasSignatureReceipts,
@@ -923,7 +944,7 @@ function isSupportedCheckType(value) {
 }
 function normalizeSetupActionType(value, index) {
   const normalizedInput = String(value || "").trim().replace(/-/g, "_");
-  const normalized = normalizedInput === "clear_browser_storage" ? "clear_storage" : normalizedInput === "reset_console" || normalizedInput === "clear_browser_console" || normalizedInput === "reset_browser_console" ? "clear_console" : normalizedInput === "pointer_drag" || normalizedInput === "mouse_drag" || normalizedInput === "drag_to" ? "drag" : normalizedInput === "keyboard_press" || normalizedInput === "key_press" ? "press" : normalizedInput === "set_slider_value" || normalizedInput === "slider_value" || normalizedInput === "set_slider" || normalizedInput === "set_range" || normalizedInput === "range_value" || normalizedInput === "range_input" || normalizedInput === "set_range_input" ? "set_range_value" : normalizedInput === "deterministic_runtime" || normalizedInput === "mock_runtime" || normalizedInput === "mock_random" || normalizedInput === "mock_random_queue" || normalizedInput === "seed_random_queue" || normalizedInput === "set_random_queue" || normalizedInput === "mock_clock" || normalizedInput === "set_mock_clock" || normalizedInput === "set_runtime_determinism" || normalizedInput === "runtime_determinism" ? "deterministic_runtime" : normalizedInput === "canvas_hash" || normalizedInput === "capture_canvas_hash" || normalizedInput === "capture_canvas_signature" || normalizedInput === "canvas_state_signature" ? "canvas_signature" : normalizedInput === "capture_screenshot" || normalizedInput === "save_screenshot" || normalizedInput === "setup_screenshot" ? "screenshot" : normalizedInput === "accept_dialog" || normalizedInput === "accept_dialogs" || normalizedInput === "confirm_dialog" || normalizedInput === "set_dialog_response" ? "dialog_response" : normalizedInput === "dismiss_dialog" || normalizedInput === "dismiss_dialogs" || normalizedInput === "cancel_dialog" ? "dialog_response" : normalizedInput === "window_call_until" || normalizedInput === "call_until" || normalizedInput === "window_call_repeat_until" || normalizedInput === "repeat_window_call_until" ? "window_call_until" : normalizedInput === "window_evaluate" || normalizedInput === "browser_eval" || normalizedInput === "browser_evaluate" || normalizedInput === "evaluate_script" || normalizedInput === "profile_script" ? "window_eval" : normalizedInput;
+  const normalized = normalizedInput === "clear_browser_storage" ? "clear_storage" : normalizedInput === "reset_console" || normalizedInput === "clear_browser_console" || normalizedInput === "reset_browser_console" ? "clear_console" : normalizedInput === "pointer_drag" || normalizedInput === "mouse_drag" || normalizedInput === "drag_to" ? "drag" : normalizedInput === "pointer_tap" || normalizedInput === "touch_tap" || normalizedInput === "canvas_tap" ? "tap" : normalizedInput === "keyboard_press" || normalizedInput === "key_press" ? "press" : normalizedInput === "set_slider_value" || normalizedInput === "slider_value" || normalizedInput === "set_slider" || normalizedInput === "set_range" || normalizedInput === "range_value" || normalizedInput === "range_input" || normalizedInput === "set_range_input" ? "set_range_value" : normalizedInput === "deterministic_runtime" || normalizedInput === "mock_runtime" || normalizedInput === "mock_random" || normalizedInput === "mock_random_queue" || normalizedInput === "seed_random_queue" || normalizedInput === "set_random_queue" || normalizedInput === "mock_clock" || normalizedInput === "set_mock_clock" || normalizedInput === "set_runtime_determinism" || normalizedInput === "runtime_determinism" ? "deterministic_runtime" : normalizedInput === "canvas_hash" || normalizedInput === "capture_canvas_hash" || normalizedInput === "capture_canvas_signature" || normalizedInput === "canvas_state_signature" ? "canvas_signature" : normalizedInput === "capture_screenshot" || normalizedInput === "save_screenshot" || normalizedInput === "setup_screenshot" ? "screenshot" : normalizedInput === "accept_dialog" || normalizedInput === "accept_dialogs" || normalizedInput === "confirm_dialog" || normalizedInput === "set_dialog_response" ? "dialog_response" : normalizedInput === "dismiss_dialog" || normalizedInput === "dismiss_dialogs" || normalizedInput === "cancel_dialog" ? "dialog_response" : normalizedInput === "window_call_until" || normalizedInput === "call_until" || normalizedInput === "window_call_repeat_until" || normalizedInput === "repeat_window_call_until" ? "window_call_until" : normalizedInput === "window_evaluate" || normalizedInput === "browser_eval" || normalizedInput === "browser_evaluate" || normalizedInput === "evaluate_script" || normalizedInput === "profile_script" ? "window_eval" : normalizedInput;
   if (RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES.includes(normalized)) {
     return normalized;
   }
@@ -1005,8 +1026,8 @@ function normalizeSetupActionCoordinateMode(value, index) {
 }
 function normalizeSetupActionPointerType(value, type, index) {
   if (value === void 0 || value === null || value === "") return void 0;
-  if (type !== "drag") {
-    throw new Error(`target.setup_actions[${index}].pointer_type is only supported for drag actions.`);
+  if (type !== "drag" && type !== "tap") {
+    throw new Error(`target.setup_actions[${index}].pointer_type is only supported for drag/tap actions.`);
   }
   const normalized = String(value).trim().replace(/-/g, "_").toLowerCase();
   if (normalized === "mouse") return "mouse";
@@ -1085,11 +1106,11 @@ 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 === "drag" || type === "fill" || type === "set_input_value" || type === "set_range_value" || type === "canvas_signature" || 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 === "tap" || type === "drag" || type === "fill" || type === "set_input_value" || type === "set_range_value" || type === "canvas_signature" || 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 = type === "click" ? numberValue(valueFromOwn(input, "from_x", "fromX", "x", "click_x", "clickX", "start_x", "startX", "x1")) : numberValue(valueFromOwn(input, "from_x", "fromX", "start_x", "startX", "x1"));
-  const fromY = type === "click" ? numberValue(valueFromOwn(input, "from_y", "fromY", "y", "click_y", "clickY", "start_y", "startY", "y1")) : numberValue(valueFromOwn(input, "from_y", "fromY", "start_y", "startY", "y1"));
+  const fromX = type === "click" || type === "tap" ? numberValue(valueFromOwn(input, "from_x", "fromX", "x", "click_x", "clickX", "start_x", "startX", "x1")) : numberValue(valueFromOwn(input, "from_x", "fromX", "start_x", "startX", "x1"));
+  const fromY = type === "click" || type === "tap" ? numberValue(valueFromOwn(input, "from_y", "fromY", "y", "click_y", "clickY", "start_y", "startY", "y1")) : 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);
@@ -1109,6 +1130,21 @@ function normalizeSetupAction(input, index) {
       }
     }
   }
+  if (type === "tap") {
+    const hasTapCoordinate = fromX !== void 0 || fromY !== void 0;
+    if (hasTapCoordinate && (fromX === void 0 || fromY === void 0)) {
+      throw new Error(`target.setup_actions[${index}] tap coordinates require both x and y.`);
+    }
+    if (hasTapCoordinate && fromX !== void 0 && fromY !== void 0) {
+      const tapCoordinates = [fromX, fromY];
+      if (coordinateMode === "ratio" && tapCoordinates.some((value2) => value2 < 0 || value2 > 1)) {
+        throw new Error(`target.setup_actions[${index}] tap ratio coordinates must be between 0 and 1.`);
+      }
+      if ((coordinateMode === void 0 || coordinateMode === "pixels") && tapCoordinates.some((value2) => value2 < 0)) {
+        throw new Error(`target.setup_actions[${index}] tap pixel coordinates must be non-negative.`);
+      }
+    }
+  }
   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.`);
@@ -6104,6 +6140,96 @@ async function executeSetupAction(action, ordinal, viewport) {
       await waitForAnyVisibleSelector(scope.context, action.selector, timeout);
       return { ...base, ...setupScopeEvidence(scope), ok: true, timeout_ms: timeout };
     }
+    if (type === "tap") {
+      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 fromX = setupFiniteNumber(action.from_x ?? action.fromX ?? action.x ?? action.click_x ?? action.clickX);
+      const fromY = setupFiniteNumber(action.from_y ?? action.fromY ?? action.y ?? action.click_y ?? action.clickY);
+      const hasTapPosition = fromX !== undefined || fromY !== undefined;
+      if (hasTapPosition && (fromX === undefined || fromY === undefined)) return { ...base, ...setupScopeEvidence(scope), reason: "missing_tap_coordinates", count, target_index: targetIndex };
+      const mode = String(action.coordinate_mode || action.coordinateMode || (hasTapPosition ? "pixels" : "ratio")).trim();
+      if (hasTapPosition && mode === "ratio" && [fromX, fromY].some((value) => value < 0 || value > 1)) return { ...base, ...setupScopeEvidence(scope), reason: "invalid_ratio_coordinates", count, target_index: targetIndex };
+      if (hasTapPosition && mode !== "ratio" && [fromX, fromY].some((value) => value < 0)) return { ...base, ...setupScopeEvidence(scope), reason: "invalid_pixel_coordinates", count, target_index: targetIndex };
+      const coordinate = (value, size) => mode === "ratio" ? value * size : value;
+      const localX = hasTapPosition && fromX !== undefined ? fromX : 0.5;
+      const localY = hasTapPosition && fromY !== undefined ? fromY : 0.5;
+      const point = {
+        x: box.x + coordinate(localX, box.width),
+        y: box.y + coordinate(localY, box.height),
+      };
+      const durationMs = setupNumber(action.duration_ms ?? action.durationMs, 0);
+      const pointerType = String(action.pointer_type || action.pointerType || "touch").trim().toLowerCase();
+      if (pointerType === "touch" || pointerType === "pen") {
+        const client = await page.context().newCDPSession(page);
+        try {
+          if (pointerType === "touch") {
+            const touchPoint = {
+              x: point.x,
+              y: point.y,
+              radiusX: 1,
+              radiusY: 1,
+              force: 1,
+              id: 11,
+            };
+            await client.send("Input.dispatchTouchEvent", {
+              type: "touchStart",
+              touchPoints: [touchPoint],
+            });
+            if (durationMs) await page.waitForTimeout(durationMs);
+            await client.send("Input.dispatchTouchEvent", {
+              type: "touchEnd",
+              touchPoints: [],
+            });
+          } else {
+            await client.send("Input.dispatchMouseEvent", {
+              type: "mousePressed",
+              x: point.x,
+              y: point.y,
+              button: "left",
+              buttons: 1,
+              clickCount: 1,
+              pointerType: "pen",
+            });
+            if (durationMs) await page.waitForTimeout(durationMs);
+            await client.send("Input.dispatchMouseEvent", {
+              type: "mouseReleased",
+              x: point.x,
+              y: point.y,
+              button: "left",
+              buttons: 0,
+              clickCount: 1,
+              pointerType: "pen",
+            });
+          }
+        } finally {
+          await client.detach().catch(() => {});
+        }
+      } else {
+        await page.mouse.click(point.x, point.y);
+      }
+      return {
+        ...base,
+        ...setupScopeEvidence(scope),
+        ok: true,
+        count,
+        target_index: targetIndex,
+        coordinate_mode: hasTapPosition ? mode : undefined,
+        x: hasTapPosition ? fromX : undefined,
+        y: hasTapPosition ? fromY : undefined,
+        pointer_type: pointerType,
+        input_dispatch: pointerType === "touch" || pointerType === "pen" ? "cdp" : "playwright_mouse",
+        duration_ms: durationMs || undefined,
+      };
+    }
     if (type === "drag") {
       const scope = await setupActionScope(action, timeout);
       if (!scope.ok) return setupScopeFailure(base, scope);

package/dist/profile.d.cts CHANGED Viewed

@@ -5,7 +5,7 @@ declare const RIDDLE_PROOF_PROFILE_EVIDENCE_VERSION: "riddle-proof.profile-evide
 declare const RIDDLE_PROOF_PROFILE_RESULT_VERSION: "riddle-proof.profile-result.v1";
 declare const RIDDLE_PROOF_PROFILE_STATUSES: readonly ["passed", "product_regression", "proof_insufficient", "environment_blocked", "configuration_error", "needs_human_review"];
 declare const RIDDLE_PROOF_PROFILE_CHECK_TYPES: readonly ["route_loaded", "url_search_param_equals", "url_search_param_absent", "selector_visible", "selector_absent", "selector_count_at_least", "selector_count_equals", "selector_count_equal", "selector_count_eq", "dialog_count_equals", "dialog_accept_count_equals", "dialog_dismiss_count_equals", "selector_text_visible", "selector_text_absent", "selector_text_order", "observe_within", "frame_text_visible", "frame_url_equals", "frame_url_matches", "frame_no_horizontal_overflow", "text_visible", "text_absent", "http_status", "link_status", "artifact_link_status", "route_inventory", "no_horizontal_overflow", "no_mobile_horizontal_overflow", "no_fatal_console_errors", "no_console_warnings"];
-declare const RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES: readonly ["click", "drag", "press", "fill", "set_input_value", "set_range_value", "deterministic_runtime", "canvas_signature", "assert_text_visible", "assert_text_absent", "assert_selector_count", "assert_window_value", "assert_window_number", "local_storage", "session_storage", "clear_storage", "clear_console", "dialog_response", "screenshot", "wait", "wait_for_selector", "wait_for_text", "window_eval", "window_call", "window_call_until"];
+declare const RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES: readonly ["click", "tap", "drag", "press", "fill", "set_input_value", "set_range_value", "deterministic_runtime", "canvas_signature", "assert_text_visible", "assert_text_absent", "assert_selector_count", "assert_window_value", "assert_window_number", "local_storage", "session_storage", "clear_storage", "clear_console", "dialog_response", "screenshot", "wait", "wait_for_selector", "wait_for_text", "window_eval", "window_call", "window_call_until"];
 type RiddleProofProfileStatus = typeof RIDDLE_PROOF_PROFILE_STATUSES[number];
 type RiddleProofProfileCheckType = typeof RIDDLE_PROOF_PROFILE_CHECK_TYPES[number];
 type RiddleProofProfileSetupActionType = typeof RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES[number];

package/dist/profile.d.ts CHANGED Viewed

@@ -5,7 +5,7 @@ declare const RIDDLE_PROOF_PROFILE_EVIDENCE_VERSION: "riddle-proof.profile-evide
 declare const RIDDLE_PROOF_PROFILE_RESULT_VERSION: "riddle-proof.profile-result.v1";
 declare const RIDDLE_PROOF_PROFILE_STATUSES: readonly ["passed", "product_regression", "proof_insufficient", "environment_blocked", "configuration_error", "needs_human_review"];
 declare const RIDDLE_PROOF_PROFILE_CHECK_TYPES: readonly ["route_loaded", "url_search_param_equals", "url_search_param_absent", "selector_visible", "selector_absent", "selector_count_at_least", "selector_count_equals", "selector_count_equal", "selector_count_eq", "dialog_count_equals", "dialog_accept_count_equals", "dialog_dismiss_count_equals", "selector_text_visible", "selector_text_absent", "selector_text_order", "observe_within", "frame_text_visible", "frame_url_equals", "frame_url_matches", "frame_no_horizontal_overflow", "text_visible", "text_absent", "http_status", "link_status", "artifact_link_status", "route_inventory", "no_horizontal_overflow", "no_mobile_horizontal_overflow", "no_fatal_console_errors", "no_console_warnings"];
-declare const RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES: readonly ["click", "drag", "press", "fill", "set_input_value", "set_range_value", "deterministic_runtime", "canvas_signature", "assert_text_visible", "assert_text_absent", "assert_selector_count", "assert_window_value", "assert_window_number", "local_storage", "session_storage", "clear_storage", "clear_console", "dialog_response", "screenshot", "wait", "wait_for_selector", "wait_for_text", "window_eval", "window_call", "window_call_until"];
+declare const RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES: readonly ["click", "tap", "drag", "press", "fill", "set_input_value", "set_range_value", "deterministic_runtime", "canvas_signature", "assert_text_visible", "assert_text_absent", "assert_selector_count", "assert_window_value", "assert_window_number", "local_storage", "session_storage", "clear_storage", "clear_console", "dialog_response", "screenshot", "wait", "wait_for_selector", "wait_for_text", "window_eval", "window_call", "window_call_until"];
 type RiddleProofProfileStatus = typeof RIDDLE_PROOF_PROFILE_STATUSES[number];
 type RiddleProofProfileCheckType = typeof RIDDLE_PROOF_PROFILE_CHECK_TYPES[number];
 type RiddleProofProfileSetupActionType = typeof RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES[number];

package/dist/profile.js CHANGED Viewed

@@ -23,7 +23,7 @@ import {
   resolveRiddleProofProfileTimeoutSec,
   slugifyRiddleProofProfileName,
   summarizeRiddleProofProfileResult
-} from "./chunk-JIAMASZX.js";
+} from "./chunk-BD4RHTGW.js";
 export {
   RIDDLE_PROOF_PROFILE_CHECK_TYPES,
   RIDDLE_PROOF_PROFILE_EVIDENCE_VERSION,

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@riddledc/riddle-proof",
-  "version": "0.7.173",
+  "version": "0.7.174",
   "description": "Reusable Riddle Proof contracts and helpers for evidence-backed agent changes.",
   "license": "MIT",
   "author": "RiddleDC",