@riddledc/riddle-proof 0.7.59 → 0.7.61

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
@@ -355,6 +361,11 @@ game, or preview surfaces that render inside iframes:
 
 ```json
 [
+  {
+    "type": "frame_url_matches",
+    "selector": ".game-player-root iframe",
+    "pattern": "/saved/hot-path-.+/index\\.html$"
+  },
   {
     "type": "frame_text_visible",
     "selector": ".game-player-root iframe",
@@ -368,6 +379,11 @@ game, or preview surfaces that render inside iframes:
 ]
 ```
 
+Use `frame_url_equals` when the iframe must resolve to one exact embedded
+resource, or `frame_url_matches` when a preview/job/saved-game URL has a stable
+shape but a generated ID. URL checks fail when the frame is missing, just like
+frame text and overflow checks.
+
 Frame checks capture each matching iframe's URL, title, compact text sample,
 scroll width, client width, measured horizontal overflow, and top visible
 overflow offenders. This keeps embedded-player audits in profile mode instead

package/dist/{chunk-Q5VW6MAP.js → chunk-T66DWLBE.js}

@@ -22,6 +22,8 @@ var RIDDLE_PROOF_PROFILE_CHECK_TYPES = [
   "selector_count_eq",
   "selector_text_order",
   "frame_text_visible",
+  "frame_url_equals",
+  "frame_url_matches",
   "frame_no_horizontal_overflow",
   "text_visible",
   "text_absent",
@@ -32,6 +34,7 @@ var RIDDLE_PROOF_PROFILE_CHECK_TYPES = [
 ];
 var RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES = [
   "click",
+  "drag",
   "press",
   "fill",
   "set_input_value",
@@ -202,7 +205,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;
   }
@@ -232,6 +235,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);
@@ -241,9 +251,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.`);
   }
@@ -290,12 +316,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,
@@ -506,12 +543,19 @@ function normalizeCheck(input, index) {
   if ((type === "selector_visible" || type === "selector_absent" || type === "selector_count_at_least" || type === "selector_count_equals" || type === "selector_count_equal" || type === "selector_count_eq") && !stringValue(input.selector)) {
     throw new Error(`checks[${index}] ${type} requires selector.`);
   }
-  if ((type === "frame_text_visible" || type === "frame_no_horizontal_overflow") && !stringValue(input.selector)) {
+  if ((type === "frame_text_visible" || type === "frame_url_equals" || type === "frame_url_matches" || type === "frame_no_horizontal_overflow") && !stringValue(input.selector)) {
     throw new Error(`checks[${index}] ${type} requires selector.`);
   }
   if (type === "frame_text_visible" && !stringValue(input.text) && !stringValue(input.pattern)) {
     throw new Error(`checks[${index}] frame_text_visible requires text or pattern.`);
   }
+  const expectedUrl = stringFromOwn(input, "expected_url", "expectedUrl", "url", "expected_value", "expectedValue", "value");
+  if (type === "frame_url_equals" && expectedUrl === void 0) {
+    throw new Error(`checks[${index}] frame_url_equals requires expected_url.`);
+  }
+  if (type === "frame_url_matches" && !stringValue(input.pattern)) {
+    throw new Error(`checks[${index}] frame_url_matches requires pattern.`);
+  }
   if ((type === "text_visible" || type === "text_absent") && !stringValue(input.text) && !stringValue(input.pattern)) {
     throw new Error(`checks[${index}] ${type} requires text or pattern.`);
   }
@@ -544,6 +588,7 @@ function normalizeCheck(input, index) {
     expected_path: stringValue(input.expected_path),
     param: stringValue(input.param) || stringValue(input.search_param) || stringValue(input.searchParam) || stringValue(input.key),
     expected_value: expectedValue,
+    expected_url: expectedUrl,
     expected_routes: expectedRoutes,
     selector: stringValue(input.selector),
     expected_texts: expectedTexts,
@@ -1011,6 +1056,35 @@ function assessCheckFromEvidence(check, evidence) {
       message: failed ? `Frame selector ${key} did not contain expected text in ${failed} viewport(s).` : void 0
     };
   }
+  if (check.type === "frame_url_equals" || check.type === "frame_url_matches") {
+    const key = selectorKey(check);
+    const expectedUrl = check.expected_url || check.expected_value || "";
+    const results = viewports.map((viewport) => {
+      const frames = frameEvidenceForSelector(viewport, key);
+      const urls = frames.map((frame) => String(frame.url || "")).filter(Boolean);
+      const matches = urls.filter((url) => check.type === "frame_url_equals" ? url === expectedUrl : matchText(url, check));
+      return {
+        viewport: viewport.name,
+        frame_count: frames.length,
+        matched_count: matches.length,
+        matched: matches.length > 0,
+        urls: urls.slice(0, 10)
+      };
+    });
+    const failed = results.filter((result) => !result.matched).length;
+    return {
+      type: check.type,
+      label: checkLabel(check),
+      status: failed ? "failed" : "passed",
+      evidence: {
+        selector: key,
+        expected_url: check.type === "frame_url_equals" ? expectedUrl : null,
+        pattern: check.type === "frame_url_matches" ? check.pattern || null : null,
+        viewports: results.map((result) => toJsonValue(result))
+      },
+      message: failed ? `Frame selector ${key} URL assertion failed in ${failed} viewport(s).` : void 0
+    };
+  }
   if (check.type === "frame_no_horizontal_overflow") {
     const key = selectorKey(check);
     const maxOverflow = check.max_overflow_px ?? 4;
@@ -1902,6 +1976,36 @@ function assessProfile(profile, evidence) {
       });
       continue;
     }
+    if (check.type === "frame_url_equals" || check.type === "frame_url_matches") {
+      const selector = check.selector || "";
+      const expectedUrl = check.expected_url || check.expected_value || "";
+      const results = checkViewports.map((viewport) => {
+        const frames = frameEvidenceForSelector(viewport, selector);
+        const urls = frames.map((frame) => String(frame.url || "")).filter(Boolean);
+        const matches = urls.filter((url) => check.type === "frame_url_equals" ? url === expectedUrl : textMatches(url, check));
+        return {
+          viewport: viewport.name,
+          frame_count: frames.length,
+          matched_count: matches.length,
+          matched: matches.length > 0,
+          urls: urls.slice(0, 10),
+        };
+      });
+      const failed = results.filter((result) => !result.matched).length;
+      checks.push({
+        type: check.type,
+        label: check.label || check.type,
+        status: failed ? "failed" : "passed",
+        evidence: {
+          selector,
+          expected_url: check.type === "frame_url_equals" ? expectedUrl : null,
+          pattern: check.type === "frame_url_matches" ? check.pattern || null : null,
+          viewports: results,
+        },
+        message: failed ? "Frame selector " + selector + " URL assertion failed in " + failed + " viewport(s)." : undefined,
+      });
+      continue;
+    }
     if (check.type === "frame_no_horizontal_overflow") {
       const selector = check.selector || "";
       const maxOverflow = check.max_overflow_px == null ? 4 : check.max_overflow_px;
@@ -2436,6 +2540,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" };
@@ -3373,7 +3542,7 @@ async function captureViewport(viewport) {
     if ((check.type === "text_visible" || check.type === "text_absent") && (check.text || check.pattern)) {
       text_matches[textKey(check)] = textMatches(dom.body_text || dom.body_text_sample || "", check);
     }
-    if ((check.type === "frame_text_visible" || check.type === "frame_no_horizontal_overflow") && check.selector) {
+    if ((check.type === "frame_text_visible" || check.type === "frame_url_equals" || check.type === "frame_url_matches" || check.type === "frame_no_horizontal_overflow") && check.selector) {
       selectors[check.selector] = selectors[check.selector] || await selectorStats(check.selector);
       frames[check.selector] = frames[check.selector] || await frameEvidence(check.selector);
     }

package/dist/cli.cjs

@@ -6895,6 +6895,8 @@ var RIDDLE_PROOF_PROFILE_CHECK_TYPES = [
   "selector_count_eq",
   "selector_text_order",
   "frame_text_visible",
+  "frame_url_equals",
+  "frame_url_matches",
   "frame_no_horizontal_overflow",
   "text_visible",
   "text_absent",
@@ -6905,6 +6907,7 @@ var RIDDLE_PROOF_PROFILE_CHECK_TYPES = [
 ];
 var RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES = [
   "click",
+  "drag",
   "press",
   "fill",
   "set_input_value",
@@ -7075,7 +7078,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;
   }
@@ -7105,6 +7108,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(stringValue2(input.type), index);
@@ -7114,9 +7124,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" && !stringValue2(input.text) && !stringValue2(input.pattern)) {
     throw new Error(`target.setup_actions[${index}] wait_for_text requires text or pattern.`);
   }
@@ -7163,12 +7189,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,
@@ -7379,12 +7416,19 @@ function normalizeCheck(input, index) {
   if ((type === "selector_visible" || type === "selector_absent" || type === "selector_count_at_least" || type === "selector_count_equals" || type === "selector_count_equal" || type === "selector_count_eq") && !stringValue2(input.selector)) {
     throw new Error(`checks[${index}] ${type} requires selector.`);
   }
-  if ((type === "frame_text_visible" || type === "frame_no_horizontal_overflow") && !stringValue2(input.selector)) {
+  if ((type === "frame_text_visible" || type === "frame_url_equals" || type === "frame_url_matches" || type === "frame_no_horizontal_overflow") && !stringValue2(input.selector)) {
     throw new Error(`checks[${index}] ${type} requires selector.`);
   }
   if (type === "frame_text_visible" && !stringValue2(input.text) && !stringValue2(input.pattern)) {
     throw new Error(`checks[${index}] frame_text_visible requires text or pattern.`);
   }
+  const expectedUrl = stringFromOwn(input, "expected_url", "expectedUrl", "url", "expected_value", "expectedValue", "value");
+  if (type === "frame_url_equals" && expectedUrl === void 0) {
+    throw new Error(`checks[${index}] frame_url_equals requires expected_url.`);
+  }
+  if (type === "frame_url_matches" && !stringValue2(input.pattern)) {
+    throw new Error(`checks[${index}] frame_url_matches requires pattern.`);
+  }
   if ((type === "text_visible" || type === "text_absent") && !stringValue2(input.text) && !stringValue2(input.pattern)) {
     throw new Error(`checks[${index}] ${type} requires text or pattern.`);
   }
@@ -7417,6 +7461,7 @@ function normalizeCheck(input, index) {
     expected_path: stringValue2(input.expected_path),
     param: stringValue2(input.param) || stringValue2(input.search_param) || stringValue2(input.searchParam) || stringValue2(input.key),
     expected_value: expectedValue,
+    expected_url: expectedUrl,
     expected_routes: expectedRoutes,
     selector: stringValue2(input.selector),
     expected_texts: expectedTexts,
@@ -7884,6 +7929,35 @@ function assessCheckFromEvidence(check, evidence) {
       message: failed ? `Frame selector ${key} did not contain expected text in ${failed} viewport(s).` : void 0
     };
   }
+  if (check.type === "frame_url_equals" || check.type === "frame_url_matches") {
+    const key = selectorKey(check);
+    const expectedUrl = check.expected_url || check.expected_value || "";
+    const results = viewports.map((viewport) => {
+      const frames = frameEvidenceForSelector(viewport, key);
+      const urls = frames.map((frame) => String(frame.url || "")).filter(Boolean);
+      const matches = urls.filter((url) => check.type === "frame_url_equals" ? url === expectedUrl : matchText(url, check));
+      return {
+        viewport: viewport.name,
+        frame_count: frames.length,
+        matched_count: matches.length,
+        matched: matches.length > 0,
+        urls: urls.slice(0, 10)
+      };
+    });
+    const failed = results.filter((result) => !result.matched).length;
+    return {
+      type: check.type,
+      label: checkLabel(check),
+      status: failed ? "failed" : "passed",
+      evidence: {
+        selector: key,
+        expected_url: check.type === "frame_url_equals" ? expectedUrl : null,
+        pattern: check.type === "frame_url_matches" ? check.pattern || null : null,
+        viewports: results.map((result) => toJsonValue(result))
+      },
+      message: failed ? `Frame selector ${key} URL assertion failed in ${failed} viewport(s).` : void 0
+    };
+  }
   if (check.type === "frame_no_horizontal_overflow") {
     const key = selectorKey(check);
     const maxOverflow = check.max_overflow_px ?? 4;
@@ -8759,6 +8833,36 @@ function assessProfile(profile, evidence) {
       });
       continue;
     }
+    if (check.type === "frame_url_equals" || check.type === "frame_url_matches") {
+      const selector = check.selector || "";
+      const expectedUrl = check.expected_url || check.expected_value || "";
+      const results = checkViewports.map((viewport) => {
+        const frames = frameEvidenceForSelector(viewport, selector);
+        const urls = frames.map((frame) => String(frame.url || "")).filter(Boolean);
+        const matches = urls.filter((url) => check.type === "frame_url_equals" ? url === expectedUrl : textMatches(url, check));
+        return {
+          viewport: viewport.name,
+          frame_count: frames.length,
+          matched_count: matches.length,
+          matched: matches.length > 0,
+          urls: urls.slice(0, 10),
+        };
+      });
+      const failed = results.filter((result) => !result.matched).length;
+      checks.push({
+        type: check.type,
+        label: check.label || check.type,
+        status: failed ? "failed" : "passed",
+        evidence: {
+          selector,
+          expected_url: check.type === "frame_url_equals" ? expectedUrl : null,
+          pattern: check.type === "frame_url_matches" ? check.pattern || null : null,
+          viewports: results,
+        },
+        message: failed ? "Frame selector " + selector + " URL assertion failed in " + failed + " viewport(s)." : undefined,
+      });
+      continue;
+    }
     if (check.type === "frame_no_horizontal_overflow") {
       const selector = check.selector || "";
       const maxOverflow = check.max_overflow_px == null ? 4 : check.max_overflow_px;
@@ -9293,6 +9397,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" };
@@ -10230,7 +10399,7 @@ async function captureViewport(viewport) {
     if ((check.type === "text_visible" || check.type === "text_absent") && (check.text || check.pattern)) {
       text_matches[textKey(check)] = textMatches(dom.body_text || dom.body_text_sample || "", check);
     }
-    if ((check.type === "frame_text_visible" || check.type === "frame_no_horizontal_overflow") && check.selector) {
+    if ((check.type === "frame_text_visible" || check.type === "frame_url_equals" || check.type === "frame_url_matches" || check.type === "frame_no_horizontal_overflow") && check.selector) {
       selectors[check.selector] = selectors[check.selector] || await selectorStats(check.selector);
       frames[check.selector] = frames[check.selector] || await frameEvidence(check.selector);
     }

package/dist/cli.js

@@ -10,7 +10,7 @@ import {
   profileStatusExitCode,
   resolveRiddleProofProfileTargetUrl,
   resolveRiddleProofProfileTimeoutSec
-} from "./chunk-Q5VW6MAP.js";
+} from "./chunk-T66DWLBE.js";
 import {
   createRiddleApiClient,
   parseRiddleViewport