@riddledc/riddle-proof 0.7.50 → 0.7.51

package/README.md

@@ -239,15 +239,18 @@ appears only after a picker, tab, login stub, storage seed, form fill,
 transport control, or other bounded interaction. Supported setup actions are
 `click`, `fill`, `set_input_value`, `assert_text_visible`,
 `assert_text_absent`, `assert_selector_count`, `local_storage`,
-`session_storage`, `clear_storage`, `wait`, `wait_for_selector`, and
-`wait_for_text`; a failed setup action is recorded as a failed
+`session_storage`, `clear_storage`, `wait`, `wait_for_selector`,
+`wait_for_text`, and `window_call`; a failed setup action is recorded as a failed
 `setup_actions_succeeded` check so the profile cannot pass without reaching
 the intended state. Text-matched `click` actions prefer visible matching
 elements, which keeps responsive layouts from selecting hidden desktop or
-mobile-only links. 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, or exactly one source link must exist before clicking into
-the final route. `assert_selector_count` accepts `expected_count`.
+mobile-only links. Add `force: true` to a click action only when the matched
+visible element is intentionally animated or otherwise never becomes stable
+enough for Playwright's default click actionability checks. 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, or exactly
+one source link must exist before clicking into the final route.
+`assert_selector_count` accepts `expected_count`.
 `local_storage` and `session_storage` accept a `key` plus string `value` or
 JSON `json` / `value_json`, and can reload the page with `reload: true`.
 `clear_storage` clears `local`, `session`, or `both` browser storage scopes,

package/dist/{chunk-5FHHNCX4.js → chunk-ZC4C52ZC.js}

@@ -257,6 +257,7 @@ function normalizeSetupAction(input, index) {
   return {
     type,
     selector,
+    force: type === "click" && (input.force === true || input.force_click === true || input.forceClick === true),
     key,
     value,
     value_json: hasJsonValue ? toJsonValue(input.value_json ?? input.valueJson ?? input.json) : void 0,
@@ -2253,8 +2254,11 @@ async function executeSetupAction(action, ordinal) {
         if (targetIndex < 0) return { ...base, reason: "text_not_found", count };
       }
       if (targetIndex < 0 || targetIndex >= count) return { ...base, reason: "index_out_of_range", count, target_index: targetIndex };
-      await locator.nth(targetIndex).click({ timeout, noWaitAfter: true });
-      return { ...base, ok: true, count, target_index: targetIndex, text: matchedText };
+      const clickOptions = action.force === true
+        ? { timeout, noWaitAfter: true, force: true }
+        : { timeout, noWaitAfter: true };
+      await locator.nth(targetIndex).click(clickOptions);
+      return { ...base, ok: true, count, target_index: targetIndex, text: matchedText, force: action.force === true || undefined };
     }
     if (type === "fill" || type === "set_input_value") {
       const locator = page.locator(action.selector);

package/dist/cli.cjs

@@ -7130,6 +7130,7 @@ function normalizeSetupAction(input, index) {
   return {
     type,
     selector,
+    force: type === "click" && (input.force === true || input.force_click === true || input.forceClick === true),
     key,
     value,
     value_json: hasJsonValue ? toJsonValue(input.value_json ?? input.valueJson ?? input.json) : void 0,
@@ -9110,8 +9111,11 @@ async function executeSetupAction(action, ordinal) {
         if (targetIndex < 0) return { ...base, reason: "text_not_found", count };
       }
       if (targetIndex < 0 || targetIndex >= count) return { ...base, reason: "index_out_of_range", count, target_index: targetIndex };
-      await locator.nth(targetIndex).click({ timeout, noWaitAfter: true });
-      return { ...base, ok: true, count, target_index: targetIndex, text: matchedText };
+      const clickOptions = action.force === true
+        ? { timeout, noWaitAfter: true, force: true }
+        : { timeout, noWaitAfter: true };
+      await locator.nth(targetIndex).click(clickOptions);
+      return { ...base, ok: true, count, target_index: targetIndex, text: matchedText, force: action.force === true || undefined };
     }
     if (type === "fill" || type === "set_input_value") {
       const locator = page.locator(action.selector);

package/dist/cli.js

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

package/dist/index.cjs

@@ -8971,6 +8971,7 @@ function normalizeSetupAction(input, index) {
   return {
     type,
     selector,
+    force: type === "click" && (input.force === true || input.force_click === true || input.forceClick === true),
     key,
     value,
     value_json: hasJsonValue ? toJsonValue(input.value_json ?? input.valueJson ?? input.json) : void 0,
@@ -10967,8 +10968,11 @@ async function executeSetupAction(action, ordinal) {
         if (targetIndex < 0) return { ...base, reason: "text_not_found", count };
       }
       if (targetIndex < 0 || targetIndex >= count) return { ...base, reason: "index_out_of_range", count, target_index: targetIndex };
-      await locator.nth(targetIndex).click({ timeout, noWaitAfter: true });
-      return { ...base, ok: true, count, target_index: targetIndex, text: matchedText };
+      const clickOptions = action.force === true
+        ? { timeout, noWaitAfter: true, force: true }
+        : { timeout, noWaitAfter: true };
+      await locator.nth(targetIndex).click(clickOptions);
+      return { ...base, ok: true, count, target_index: targetIndex, text: matchedText, force: action.force === true || undefined };
     }
     if (type === "fill" || type === "set_input_value") {
       const locator = page.locator(action.selector);

package/dist/index.js

@@ -58,7 +58,7 @@ import {
   resolveRiddleProofProfileTimeoutSec,
   slugifyRiddleProofProfileName,
   summarizeRiddleProofProfileResult
-} from "./chunk-5FHHNCX4.js";
+} from "./chunk-ZC4C52ZC.js";
 import {
   DEFAULT_RIDDLE_API_BASE_URL,
   DEFAULT_RIDDLE_API_KEY_FILE,

package/dist/profile.cjs

@@ -300,6 +300,7 @@ function normalizeSetupAction(input, index) {
   return {
     type,
     selector,
+    force: type === "click" && (input.force === true || input.force_click === true || input.forceClick === true),
     key,
     value,
     value_json: hasJsonValue ? toJsonValue(input.value_json ?? input.valueJson ?? input.json) : void 0,
@@ -2296,8 +2297,11 @@ async function executeSetupAction(action, ordinal) {
         if (targetIndex < 0) return { ...base, reason: "text_not_found", count };
       }
       if (targetIndex < 0 || targetIndex >= count) return { ...base, reason: "index_out_of_range", count, target_index: targetIndex };
-      await locator.nth(targetIndex).click({ timeout, noWaitAfter: true });
-      return { ...base, ok: true, count, target_index: targetIndex, text: matchedText };
+      const clickOptions = action.force === true
+        ? { timeout, noWaitAfter: true, force: true }
+        : { timeout, noWaitAfter: true };
+      await locator.nth(targetIndex).click(clickOptions);
+      return { ...base, ok: true, count, target_index: targetIndex, text: matchedText, force: action.force === true || undefined };
     }
     if (type === "fill" || type === "set_input_value") {
       const locator = page.locator(action.selector);

package/dist/profile.d.cts

@@ -20,6 +20,7 @@ interface RiddleProofProfileViewport {
 interface RiddleProofProfileSetupAction {
     type: RiddleProofProfileSetupActionType;
     selector?: string;
+    force?: boolean;
     key?: string;
     value?: string;
     value_json?: JsonValue;

package/dist/profile.d.ts

@@ -20,6 +20,7 @@ interface RiddleProofProfileViewport {
 interface RiddleProofProfileSetupAction {
     type: RiddleProofProfileSetupActionType;
     selector?: string;
+    force?: boolean;
     key?: string;
     value?: string;
     value_json?: JsonValue;

package/dist/profile.js

@@ -19,7 +19,7 @@ import {
   resolveRiddleProofProfileTimeoutSec,
   slugifyRiddleProofProfileName,
   summarizeRiddleProofProfileResult
-} from "./chunk-5FHHNCX4.js";
+} from "./chunk-ZC4C52ZC.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.50",
+  "version": "0.7.51",
   "description": "Reusable Riddle Proof contracts and helpers for evidence-backed agent changes.",
   "license": "MIT",
   "author": "RiddleDC",