@riddledc/riddle-proof 0.7.148 → 0.7.150

package/dist/index.cjs

@@ -8759,6 +8759,7 @@ var RIDDLE_PROOF_PROFILE_CHECK_TYPES = [
   "selector_text_visible",
   "selector_text_absent",
   "selector_text_order",
+  "observe_within",
   "frame_text_visible",
   "frame_url_equals",
   "frame_url_matches",
@@ -9230,6 +9231,22 @@ function profileSetupWindowEvalReceipts(results) {
     return receipt;
   });
 }
+function profileSetupRangeValueReceipts(results) {
+  return results.filter((result) => profileSetupResultAction(result) === "set_range_value").map((result) => ({
+    ordinal: result.ordinal ?? null,
+    ok: result.ok !== false,
+    selector: result.selector ?? null,
+    frame_selector: result.frame_selector ?? null,
+    requested_value: result.requested_value ?? null,
+    actual_value: result.actual_value ?? null,
+    before_value: result.before_value ?? null,
+    value_as_number: result.value_as_number ?? null,
+    min: result.min ?? null,
+    max: result.max ?? null,
+    step: result.step ?? null,
+    reason: result.reason ?? result.error ?? null
+  }));
+}
 function sampleProfileSetupSummaryItems(items, limit) {
   if (items.length <= limit) return items;
   const firstCount = Math.floor(limit / 2);
@@ -9272,6 +9289,8 @@ function profileSetupSummary(viewports, actionCount, expectedActionCountByViewpo
       const windowEvalStoredTotal = windowEvalReceipts.filter((result) => typeof result.return_stored_to === "string" && result.return_stored_to.trim()).length;
       const windowEvalCapturedTotal = windowEvalReceipts.filter((result) => result.return_captured === true).length;
       const sampledWindowEvalReceipts = sampleProfileSetupSummaryItems(windowEvalReceipts, 8);
+      const rangeValueReceipts = profileSetupRangeValueReceipts(results);
+      const sampledRangeValueReceipts = sampleProfileSetupSummaryItems(rangeValueReceipts, 8);
       const clickedItems = results.filter((result) => profileSetupResultAction(result) === "click" && result.ok !== false).map((result) => {
         const clickCount = typeof result.click_count === "number" && Number.isFinite(result.click_count) && result.click_count > 1 ? result.click_count : void 0;
         return {
@@ -9320,6 +9339,9 @@ function profileSetupSummary(viewports, actionCount, expectedActionCountByViewpo
         window_eval_captured_total: windowEvalCapturedTotal,
         window_eval_truncated: windowEvalReceipts.length > sampledWindowEvalReceipts.length,
         window_eval: sampledWindowEvalReceipts,
+        set_range_value_total: rangeValueReceipts.length,
+        set_range_value_truncated: rangeValueReceipts.length > sampledRangeValueReceipts.length,
+        set_range_value: sampledRangeValueReceipts,
         clicked,
         text_samples,
         failed: failed.map((result) => ({
@@ -10060,7 +10082,7 @@ function normalizeCheck(input, index) {
     throw new Error(`checks[${index}].type ${type} is not supported. Supported checks: ${RIDDLE_PROOF_PROFILE_CHECK_TYPES.join(", ")}`);
   }
   const isDialogCountCheck = isDialogCountCheckType(type);
-  if ((type === "selector_visible" || type === "selector_absent" || type === "selector_count_at_least" || type === "selector_count_equals" || type === "selector_count_equal" || type === "selector_count_eq" || type === "selector_text_visible" || type === "selector_text_absent") && !stringValue5(input.selector)) {
+  if ((type === "selector_visible" || type === "selector_absent" || type === "selector_count_at_least" || type === "selector_count_equals" || type === "selector_count_equal" || type === "selector_count_eq" || type === "selector_text_visible" || type === "selector_text_absent" || type === "observe_within" && !stringValue5(input.text) && !stringValue5(input.pattern)) && !stringValue5(input.selector)) {
     throw new Error(`checks[${index}] ${type} requires selector.`);
   }
   if ((type === "frame_text_visible" || type === "frame_url_equals" || type === "frame_url_matches" || type === "frame_no_horizontal_overflow") && !stringValue5(input.selector)) {
@@ -10201,7 +10223,7 @@ function normalizeCheck(input, index) {
     allowed_content_types: allowedContentTypes,
     allow_get_fallback: isLinkStatusCheck ? input.allow_get_fallback === false || input.allowGetFallback === false ? false : true : void 0,
     max_overflow_px: numberValue3(input.max_overflow_px),
-    timeout_ms: numberValue3(input.timeout_ms) ?? numberValue3(input.timeoutMs),
+    timeout_ms: numberValue3(input.timeout_ms) ?? numberValue3(input.timeoutMs) ?? numberValue3(input.within_ms) ?? numberValue3(input.withinMs),
     run_direct_routes: input.run_direct_routes === false || input.runDirectRoutes === false ? false : true,
     run_clickthroughs: input.run_clickthroughs === false || input.runClickthroughs === false ? false : true,
     run_all_viewports: input.run_all_viewports === true || input.runAllViewports === true,
@@ -10719,6 +10741,16 @@ function summarizeLinkStatusEvidence(viewport, check) {
 function textKey(check) {
   return check.pattern ? `pattern:${check.pattern}/${check.flags || ""}` : `text:${check.text || ""}`;
 }
+function observeWithinTimeoutMs(check) {
+  const raw = check.timeout_ms;
+  if (typeof raw === "number" && Number.isFinite(raw) && raw > 0) return Math.min(Math.round(raw), 6e4);
+  return 2e3;
+}
+function observeWithinKey(check) {
+  const target = check.selector ? `selector:${check.selector}` : "page";
+  const expectation = check.pattern ? `pattern:${check.pattern}/${check.flags || ""}` : check.text ? `text:${check.text}` : "visible";
+  return `${target}|${expectation}|within:${observeWithinTimeoutMs(check)}`;
+}
 function textSequenceForCheck(viewport, check) {
   const key = selectorKey(check);
   const sequence = viewport.text_sequences?.[key];
@@ -11225,6 +11257,40 @@ function assessCheckFromEvidence(check, evidence) {
       message: failed ? `Selector ${key} text order failed in ${failed} viewport(s).` : void 0
     };
   }
+  if (check.type === "observe_within") {
+    const key = observeWithinKey(check);
+    const timeoutMs = observeWithinTimeoutMs(check);
+    const results = viewports.map((viewport) => {
+      const observation = viewport.observations?.[key];
+      const matched = observation?.matched === true;
+      return {
+        viewport: viewport.name,
+        matched,
+        elapsed_ms: numberValue3(observation?.elapsed_ms) ?? null,
+        timeout_ms: numberValue3(observation?.timeout_ms) ?? timeoutMs,
+        attempts: numberValue3(observation?.attempts) ?? null,
+        selector_count: numberValue3(observation?.selector_count) ?? null,
+        visible_count: numberValue3(observation?.visible_count) ?? null,
+        matched_count: numberValue3(observation?.matched_count) ?? null,
+        sample: stringValue5(observation?.sample) ?? null,
+        error: stringValue5(observation?.error) ?? null
+      };
+    });
+    const failed = results.filter((result) => !result.matched).length;
+    return {
+      type: check.type,
+      label: checkLabel(check),
+      status: failed ? "failed" : "passed",
+      evidence: {
+        selector: check.selector || null,
+        text: check.text || null,
+        pattern: check.pattern || null,
+        timeout_ms: timeoutMs,
+        viewports: results.map((result) => toJsonValue(result))
+      },
+      message: failed ? `Observation did not match within ${timeoutMs}ms in ${failed} viewport(s).` : void 0
+    };
+  }
   if (check.type === "frame_text_visible") {
     const key = selectorKey(check);
     const results = viewports.map((viewport) => {
@@ -12629,6 +12695,24 @@ function profileSetupWindowEvalReceipts(results) {
       return receipt;
     });
 }
+function profileSetupRangeValueReceipts(results) {
+  return (results || [])
+    .filter((result) => result && profileSetupResultAction(result) === "set_range_value")
+    .map((result) => ({
+      ordinal: result.ordinal ?? null,
+      ok: result.ok !== false,
+      selector: result.selector ?? null,
+      frame_selector: result.frame_selector ?? null,
+      requested_value: result.requested_value ?? null,
+      actual_value: result.actual_value ?? null,
+      before_value: result.before_value ?? null,
+      value_as_number: result.value_as_number ?? null,
+      min: result.min ?? null,
+      max: result.max ?? null,
+      step: result.step ?? null,
+      reason: result.reason || result.error || null,
+    }));
+}
 function sampleProfileSetupSummaryItems(items, limit) {
   if ((items || []).length <= limit) return items || [];
   const firstCount = Math.floor(limit / 2);
@@ -12685,6 +12769,8 @@ function profileSetupSummary(viewports, actionCount, expectedActionCountsByViewp
       const windowEvalStoredTotal = windowEvalReceipts.filter((result) => typeof result.return_stored_to === "string" && result.return_stored_to.trim()).length;
       const windowEvalCapturedTotal = windowEvalReceipts.filter((result) => result.return_captured === true).length;
       const sampledWindowEvalReceipts = sampleProfileSetupSummaryItems(windowEvalReceipts, 8);
+      const rangeValueReceipts = profileSetupRangeValueReceipts(results);
+      const sampledRangeValueReceipts = sampleProfileSetupSummaryItems(rangeValueReceipts, 8);
       const clickedItems = results
         .filter((result) => result && profileSetupResultAction(result) === "click" && result.ok !== false)
         .map((result) => {
@@ -12743,6 +12829,9 @@ function profileSetupSummary(viewports, actionCount, expectedActionCountsByViewp
         window_eval_captured_total: windowEvalCapturedTotal,
         window_eval_truncated: windowEvalReceipts.length > sampledWindowEvalReceipts.length,
         window_eval: sampledWindowEvalReceipts,
+        set_range_value_total: rangeValueReceipts.length,
+        set_range_value_truncated: rangeValueReceipts.length > sampledRangeValueReceipts.length,
+        set_range_value: sampledRangeValueReceipts,
         clicked,
         text_samples: textSamples,
         failed: failed.map((result) => ({
@@ -13111,6 +13200,36 @@ function assessProfile(profile, evidence) {
       });
       continue;
     }
+    if (check.type === "observe_within") {
+      const key = observeWithinKey(check);
+      const timeoutMs = observeWithinTimeoutMs(check);
+      const results = checkViewports.map((viewport) => {
+        const observation = viewport.observations && viewport.observations[key] && typeof viewport.observations[key] === "object"
+          ? viewport.observations[key]
+          : {};
+        return {
+          viewport: viewport.name,
+          matched: observation.matched === true,
+          elapsed_ms: typeof observation.elapsed_ms === "number" && Number.isFinite(observation.elapsed_ms) ? observation.elapsed_ms : null,
+          timeout_ms: typeof observation.timeout_ms === "number" && Number.isFinite(observation.timeout_ms) ? observation.timeout_ms : timeoutMs,
+          attempts: typeof observation.attempts === "number" && Number.isFinite(observation.attempts) ? observation.attempts : null,
+          selector_count: typeof observation.selector_count === "number" && Number.isFinite(observation.selector_count) ? observation.selector_count : null,
+          visible_count: typeof observation.visible_count === "number" && Number.isFinite(observation.visible_count) ? observation.visible_count : null,
+          matched_count: typeof observation.matched_count === "number" && Number.isFinite(observation.matched_count) ? observation.matched_count : null,
+          sample: typeof observation.sample === "string" && observation.sample.trim() ? observation.sample.trim() : null,
+          error: typeof observation.error === "string" && observation.error.trim() ? observation.error.trim() : null,
+        };
+      });
+      const failed = results.filter((result) => !result.matched).length;
+      checks.push({
+        type: check.type,
+        label: check.label || check.type,
+        status: failed ? "failed" : "passed",
+        evidence: { selector: check.selector || null, text: check.text || null, pattern: check.pattern || null, timeout_ms: timeoutMs, viewports: results },
+        message: failed ? "Observation did not match within " + timeoutMs + "ms in " + failed + " viewport(s)." : undefined,
+      });
+      continue;
+    }
     if (check.type === "frame_text_visible") {
       const selector = check.selector || "";
       const results = checkViewports.map((viewport) => {
@@ -13543,6 +13662,19 @@ function ensureDialogHandler() {
 function textKey(check) {
   return check.pattern ? "pattern:" + check.pattern + "/" + (check.flags || "") : "text:" + (check.text || "");
 }
+function observeWithinTimeoutMs(check) {
+  const raw = Number(check && check.timeout_ms);
+  return Number.isFinite(raw) && raw > 0 ? Math.min(Math.round(raw), 60000) : 2000;
+}
+function observeWithinKey(check) {
+  const target = check && check.selector ? "selector:" + check.selector : "page";
+  const expectation = check && check.pattern
+    ? "pattern:" + check.pattern + "/" + (check.flags || "")
+    : check && check.text
+      ? "text:" + check.text
+      : "visible";
+  return target + "|" + expectation + "|within:" + observeWithinTimeoutMs(check);
+}
 function textMatches(sample, check) {
   if (check.pattern) {
     try { return new RegExp(check.pattern, check.flags || "").test(sample || ""); } catch { return false; }
@@ -14858,6 +14990,104 @@ async function selectorTextSequence(selector) {
     };
   }).catch((error) => ({ count: 0, visible_count: 0, texts: [], visible_texts: [], match_texts: [], visible_match_texts: [], error: String(error && error.message ? error.message : error).slice(0, 500) }));
 }
+async function observeWithinSnapshot(check) {
+  const payload = {
+    selector: check.selector || "",
+    text: check.text || "",
+    pattern: check.pattern || "",
+    flags: check.flags || "",
+    wants_text: Boolean(check.text || check.pattern),
+  };
+  if (payload.selector) {
+    return page.locator(payload.selector).evaluateAll((elements, input) => {
+      const compact = (value) => String(value || "").replace(/\s+/g, " ").trim();
+      const matchText = (value) => {
+        const source = compact(value);
+        if (input.pattern) {
+          try { return new RegExp(input.pattern, input.flags || "").test(source); } catch { return false; }
+        }
+        return source.includes(input.text || "");
+      };
+      const isVisible = (element) => {
+        const style = window.getComputedStyle(element);
+        const rect = element.getBoundingClientRect();
+        return style && style.visibility !== "hidden" && style.display !== "none" && rect.width > 0 && rect.height > 0;
+      };
+      const rows = elements.map((element, index) => {
+        const text = compact(element.innerText || element.textContent || "");
+        const visible = isVisible(element);
+        return { index, text, visible, matched: input.wants_text ? matchText(text) : visible };
+      });
+      const visibleRows = rows.filter((row) => row.visible);
+      const matches = input.wants_text ? visibleRows.filter((row) => row.matched) : visibleRows;
+      const sampleRow = matches[0] || visibleRows[0] || rows[0] || null;
+      return {
+        selector: input.selector,
+        text: input.text || null,
+        pattern: input.pattern || null,
+        selector_count: rows.length,
+        visible_count: visibleRows.length,
+        matched_count: matches.length,
+        matched: matches.length > 0,
+        sample: sampleRow && sampleRow.text ? sampleRow.text.slice(0, 240) : null,
+      };
+    }, payload).catch((error) => ({
+      selector: payload.selector,
+      text: payload.text || null,
+      pattern: payload.pattern || null,
+      selector_count: 0,
+      visible_count: 0,
+      matched_count: 0,
+      matched: false,
+      sample: null,
+      error: String(error && error.message ? error.message : error).slice(0, 500),
+    }));
+  }
+  return page.evaluate((input) => {
+    const compact = (value) => String(value || "").replace(/\s+/g, " ").trim();
+    const sample = compact(document.body ? document.body.innerText || document.body.textContent || "" : "");
+    let matched = false;
+    if (input.pattern) {
+      try { matched = new RegExp(input.pattern, input.flags || "").test(sample); } catch { matched = false; }
+    } else {
+      matched = sample.includes(input.text || "");
+    }
+    return {
+      selector: null,
+      text: input.text || null,
+      pattern: input.pattern || null,
+      matched,
+      matched_count: matched ? 1 : 0,
+      sample: sample.slice(0, 240),
+    };
+  }, payload).catch((error) => ({
+    selector: null,
+    text: payload.text || null,
+    pattern: payload.pattern || null,
+    matched: false,
+    matched_count: 0,
+    sample: null,
+    error: String(error && error.message ? error.message : error).slice(0, 500),
+  }));
+}
+async function observeWithin(check) {
+  const timeoutMs = observeWithinTimeoutMs(check);
+  const startedAt = Date.now();
+  let attempts = 0;
+  let last = null;
+  while (true) {
+    attempts += 1;
+    last = await observeWithinSnapshot(check);
+    const elapsedMs = Date.now() - startedAt;
+    if (last && last.matched === true) {
+      return { ...last, timeout_ms: timeoutMs, elapsed_ms: elapsedMs, attempts };
+    }
+    if (elapsedMs >= timeoutMs) {
+      return { ...(last || {}), matched: false, timeout_ms: timeoutMs, elapsed_ms: elapsedMs, attempts };
+    }
+    await page.waitForTimeout(Math.min(100, Math.max(25, timeoutMs - elapsedMs)));
+  }
+}
 function linkProbeMaxLinks(check) {
   const value = Number(check.max_links || check.maxLinks || check.limit || 100);
   return Number.isInteger(value) && value > 0 ? Math.min(value, 500) : 100;
@@ -15910,6 +16140,7 @@ async function captureViewport(viewport) {
   const text_matches = {};
   const text_match_samples = {};
   const text_case_insensitive_samples = {};
+  const observations = {};
   const http_statuses = {};
   const link_statuses = {};
   for (const check of profile.checks || []) {
@@ -15930,6 +16161,10 @@ async function captureViewport(viewport) {
       selectors[check.selector] = selectors[check.selector] || await selectorStats(check.selector);
       text_sequences[check.selector] = await selectorTextSequence(check.selector);
     }
+    if (check.type === "observe_within") {
+      const key = observeWithinKey(check);
+      observations[key] = observations[key] || await observeWithin(check);
+    }
     if ((check.type === "text_visible" || check.type === "text_absent") && (check.text || check.pattern)) {
       const key = textKey(check);
       const sample = dom.body_text || dom.body_text_sample || "";
@@ -16023,6 +16258,7 @@ async function captureViewport(viewport) {
     text_matches,
     text_match_samples,
     text_case_insensitive_samples,
+    observations,
     http_statuses,
     link_statuses,
     route_inventory: routeInventory,

package/dist/index.js

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