@riddledc/riddle-proof 0.7.68 → 0.7.69

package/README.md

@@ -272,6 +272,10 @@ 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 `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 `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:

package/dist/{chunk-376FPGFA.js → chunk-ZQPC7PYM.js}

@@ -329,6 +329,18 @@ function normalizeSetupActionRepeat(input, index) {
   }
   return repeat;
 }
+function normalizeSetupActionClickCount(input, type, index) {
+  const clickCountInput = valueFromOwn(input, "click_count", "clickCount", "clicks");
+  if (clickCountInput === void 0) return void 0;
+  if (type !== "click") {
+    throw new Error(`target.setup_actions[${index}].click_count is only supported for click actions.`);
+  }
+  const clickCount = numberValue(clickCountInput);
+  if (clickCount === void 0 || !Number.isInteger(clickCount) || clickCount < 1 || clickCount > 10) {
+    throw new Error(`target.setup_actions[${index}].click_count must be an integer from 1 to 10.`);
+  }
+  return clickCount;
+}
 function normalizeSetupActionCoordinateMode(value, index) {
   if (value === void 0 || value === null || value === "") return void 0;
   const normalized = String(value).trim().replace(/-/g, "_").toLowerCase();
@@ -420,6 +432,7 @@ function normalizeSetupAction(input, index) {
     frame_selector: frameSelector,
     frame_index: frameIndex,
     force: type === "click" && (input.force === true || input.force_click === true || input.forceClick === true),
+    click_count: normalizeSetupActionClickCount(input, type, index),
     coordinate_mode: coordinateMode,
     from_x: fromX,
     from_y: fromY,
@@ -3118,8 +3131,10 @@ async function executeSetupAction(action, ordinal, viewport) {
       const clickOptions = action.force === true
         ? { timeout, noWaitAfter: true, force: true }
         : { timeout, noWaitAfter: true };
+      const clickCount = setupNumber(action.click_count, 1);
+      if (Number.isInteger(clickCount) && clickCount > 1) clickOptions.clickCount = clickCount;
       await locator.nth(targetIndex).click(clickOptions);
-      return { ...base, ...setupScopeEvidence(scope), ok: true, count, target_index: targetIndex, text: matchedText, force: action.force === true || undefined };
+      return { ...base, ...setupScopeEvidence(scope), ok: true, count, target_index: targetIndex, text: matchedText, force: action.force === true || undefined, click_count: clickCount > 1 ? clickCount : undefined };
     }
     if (type === "fill" || type === "set_input_value") {
       const scope = await setupActionScope(action, timeout);

package/dist/cli.cjs

@@ -7202,6 +7202,18 @@ function normalizeSetupActionRepeat(input, index) {
   }
   return repeat;
 }
+function normalizeSetupActionClickCount(input, type, index) {
+  const clickCountInput = valueFromOwn(input, "click_count", "clickCount", "clicks");
+  if (clickCountInput === void 0) return void 0;
+  if (type !== "click") {
+    throw new Error(`target.setup_actions[${index}].click_count is only supported for click actions.`);
+  }
+  const clickCount = numberValue(clickCountInput);
+  if (clickCount === void 0 || !Number.isInteger(clickCount) || clickCount < 1 || clickCount > 10) {
+    throw new Error(`target.setup_actions[${index}].click_count must be an integer from 1 to 10.`);
+  }
+  return clickCount;
+}
 function normalizeSetupActionCoordinateMode(value, index) {
   if (value === void 0 || value === null || value === "") return void 0;
   const normalized = String(value).trim().replace(/-/g, "_").toLowerCase();
@@ -7293,6 +7305,7 @@ function normalizeSetupAction(input, index) {
     frame_selector: frameSelector,
     frame_index: frameIndex,
     force: type === "click" && (input.force === true || input.force_click === true || input.forceClick === true),
+    click_count: normalizeSetupActionClickCount(input, type, index),
     coordinate_mode: coordinateMode,
     from_x: fromX,
     from_y: fromY,
@@ -9975,8 +9988,10 @@ async function executeSetupAction(action, ordinal, viewport) {
       const clickOptions = action.force === true
         ? { timeout, noWaitAfter: true, force: true }
         : { timeout, noWaitAfter: true };
+      const clickCount = setupNumber(action.click_count, 1);
+      if (Number.isInteger(clickCount) && clickCount > 1) clickOptions.clickCount = clickCount;
       await locator.nth(targetIndex).click(clickOptions);
-      return { ...base, ...setupScopeEvidence(scope), ok: true, count, target_index: targetIndex, text: matchedText, force: action.force === true || undefined };
+      return { ...base, ...setupScopeEvidence(scope), ok: true, count, target_index: targetIndex, text: matchedText, force: action.force === true || undefined, click_count: clickCount > 1 ? clickCount : undefined };
     }
     if (type === "fill" || type === "set_input_value") {
       const scope = await setupActionScope(action, timeout);

package/dist/cli.js

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

package/dist/index.cjs

@@ -9043,6 +9043,18 @@ function normalizeSetupActionRepeat(input, index) {
   }
   return repeat;
 }
+function normalizeSetupActionClickCount(input, type, index) {
+  const clickCountInput = valueFromOwn(input, "click_count", "clickCount", "clicks");
+  if (clickCountInput === void 0) return void 0;
+  if (type !== "click") {
+    throw new Error(`target.setup_actions[${index}].click_count is only supported for click actions.`);
+  }
+  const clickCount = numberValue3(clickCountInput);
+  if (clickCount === void 0 || !Number.isInteger(clickCount) || clickCount < 1 || clickCount > 10) {
+    throw new Error(`target.setup_actions[${index}].click_count must be an integer from 1 to 10.`);
+  }
+  return clickCount;
+}
 function normalizeSetupActionCoordinateMode(value, index) {
   if (value === void 0 || value === null || value === "") return void 0;
   const normalized = String(value).trim().replace(/-/g, "_").toLowerCase();
@@ -9134,6 +9146,7 @@ function normalizeSetupAction(input, index) {
     frame_selector: frameSelector,
     frame_index: frameIndex,
     force: type === "click" && (input.force === true || input.force_click === true || input.forceClick === true),
+    click_count: normalizeSetupActionClickCount(input, type, index),
     coordinate_mode: coordinateMode,
     from_x: fromX,
     from_y: fromY,
@@ -11832,8 +11845,10 @@ async function executeSetupAction(action, ordinal, viewport) {
       const clickOptions = action.force === true
         ? { timeout, noWaitAfter: true, force: true }
         : { timeout, noWaitAfter: true };
+      const clickCount = setupNumber(action.click_count, 1);
+      if (Number.isInteger(clickCount) && clickCount > 1) clickOptions.clickCount = clickCount;
       await locator.nth(targetIndex).click(clickOptions);
-      return { ...base, ...setupScopeEvidence(scope), ok: true, count, target_index: targetIndex, text: matchedText, force: action.force === true || undefined };
+      return { ...base, ...setupScopeEvidence(scope), ok: true, count, target_index: targetIndex, text: matchedText, force: action.force === true || undefined, click_count: clickCount > 1 ? clickCount : undefined };
     }
     if (type === "fill" || type === "set_input_value") {
       const scope = await setupActionScope(action, timeout);

package/dist/index.js

@@ -58,7 +58,7 @@ import {
   resolveRiddleProofProfileTimeoutSec,
   slugifyRiddleProofProfileName,
   summarizeRiddleProofProfileResult
-} from "./chunk-376FPGFA.js";
+} from "./chunk-ZQPC7PYM.js";
 import {
   DEFAULT_RIDDLE_API_BASE_URL,
   DEFAULT_RIDDLE_API_KEY_FILE,

package/dist/profile.cjs

@@ -372,6 +372,18 @@ function normalizeSetupActionRepeat(input, index) {
   }
   return repeat;
 }
+function normalizeSetupActionClickCount(input, type, index) {
+  const clickCountInput = valueFromOwn(input, "click_count", "clickCount", "clicks");
+  if (clickCountInput === void 0) return void 0;
+  if (type !== "click") {
+    throw new Error(`target.setup_actions[${index}].click_count is only supported for click actions.`);
+  }
+  const clickCount = numberValue(clickCountInput);
+  if (clickCount === void 0 || !Number.isInteger(clickCount) || clickCount < 1 || clickCount > 10) {
+    throw new Error(`target.setup_actions[${index}].click_count must be an integer from 1 to 10.`);
+  }
+  return clickCount;
+}
 function normalizeSetupActionCoordinateMode(value, index) {
   if (value === void 0 || value === null || value === "") return void 0;
   const normalized = String(value).trim().replace(/-/g, "_").toLowerCase();
@@ -463,6 +475,7 @@ function normalizeSetupAction(input, index) {
     frame_selector: frameSelector,
     frame_index: frameIndex,
     force: type === "click" && (input.force === true || input.force_click === true || input.forceClick === true),
+    click_count: normalizeSetupActionClickCount(input, type, index),
     coordinate_mode: coordinateMode,
     from_x: fromX,
     from_y: fromY,
@@ -3161,8 +3174,10 @@ async function executeSetupAction(action, ordinal, viewport) {
       const clickOptions = action.force === true
         ? { timeout, noWaitAfter: true, force: true }
         : { timeout, noWaitAfter: true };
+      const clickCount = setupNumber(action.click_count, 1);
+      if (Number.isInteger(clickCount) && clickCount > 1) clickOptions.clickCount = clickCount;
       await locator.nth(targetIndex).click(clickOptions);
-      return { ...base, ...setupScopeEvidence(scope), ok: true, count, target_index: targetIndex, text: matchedText, force: action.force === true || undefined };
+      return { ...base, ...setupScopeEvidence(scope), ok: true, count, target_index: targetIndex, text: matchedText, force: action.force === true || undefined, click_count: clickCount > 1 ? clickCount : undefined };
     }
     if (type === "fill" || type === "set_input_value") {
       const scope = await setupActionScope(action, timeout);

package/dist/profile.d.cts

@@ -23,6 +23,7 @@ interface RiddleProofProfileSetupAction {
     frame_selector?: string;
     frame_index?: number;
     force?: boolean;
+    click_count?: number;
     coordinate_mode?: "pixels" | "ratio";
     from_x?: number;
     from_y?: number;

package/dist/profile.d.ts

@@ -23,6 +23,7 @@ interface RiddleProofProfileSetupAction {
     frame_selector?: string;
     frame_index?: number;
     force?: boolean;
+    click_count?: number;
     coordinate_mode?: "pixels" | "ratio";
     from_x?: number;
     from_y?: number;

package/dist/profile.js

@@ -19,7 +19,7 @@ import {
   resolveRiddleProofProfileTimeoutSec,
   slugifyRiddleProofProfileName,
   summarizeRiddleProofProfileResult
-} from "./chunk-376FPGFA.js";
+} from "./chunk-ZQPC7PYM.js";
 export {
   RIDDLE_PROOF_PROFILE_CHECK_TYPES,
   RIDDLE_PROOF_PROFILE_EVIDENCE_VERSION,

package/package.json

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