@riddledc/riddle-proof 0.7.21 → 0.7.23

package/dist/cli.cjs

@@ -6818,6 +6818,79 @@ function stringValue2(value) {
 function numberValue(value) {
   return typeof value === "number" && Number.isFinite(value) ? value : void 0;
 }
+function horizontalBoundsOverflowPx(value) {
+  if (!isRecord(value)) return 0;
+  let max = maxPositiveNumber(
+    value.overflow_px,
+    value.overflow,
+    value.bounds_overflow_px,
+    value.horizontal_overflow_px,
+    value.left_overflow_px,
+    value.right_overflow_px
+  );
+  for (const offender of boundsOffendersForEvidence(value)) {
+    max = Math.max(max, horizontalOffenderOverflowPx(offender));
+  }
+  return roundPixels(max);
+}
+function horizontalOffenderOverflowPx(value) {
+  if (!isRecord(value)) return 0;
+  let max = maxPositiveNumber(
+    value.overflow,
+    value.overflow_px,
+    value.bounds_overflow_px,
+    value.horizontal_overflow_px,
+    value.left_overflow_px,
+    value.right_overflow_px,
+    value.leftOverflowPx,
+    value.rightOverflowPx
+  );
+  const clipped = isRecord(value.clipped || value.clip || value.clipping) ? value.clipped || value.clip || value.clipping : void 0;
+  if (isRecord(clipped)) {
+    max = Math.max(max, maxPositiveNumber(
+      clipped.left,
+      clipped.right,
+      clipped.left_px,
+      clipped.right_px,
+      clipped.leftPx,
+      clipped.rightPx
+    ));
+  }
+  const rect = isRecord(value.rect || value.bounds || value.bounding_rect || value.boundingRect) ? value.rect || value.bounds || value.bounding_rect || value.boundingRect : void 0;
+  const viewportWidth = numberValue(value.viewport_width ?? value.viewportWidth);
+  if (isRecord(rect) && viewportWidth !== void 0) {
+    const left = numberValue(rect.left);
+    const right = numberValue(rect.right);
+    if (left !== void 0 && left < 0) max = Math.max(max, Math.abs(left));
+    if (right !== void 0 && right > viewportWidth) max = Math.max(max, right - viewportWidth);
+  }
+  return roundPixels(max);
+}
+function boundsOffendersForEvidence(value) {
+  if (!isRecord(value)) return [];
+  const offenders = [
+    ...Array.isArray(value.overflow_offenders) ? value.overflow_offenders : [],
+    ...Array.isArray(value.overflowOffenders) ? value.overflowOffenders : [],
+    ...Array.isArray(value.bounds_offenders) ? value.bounds_offenders : [],
+    ...Array.isArray(value.boundsOffenders) ? value.boundsOffenders : [],
+    ...Array.isArray(value.clipped_elements) ? value.clipped_elements : [],
+    ...Array.isArray(value.clippedElements) ? value.clippedElements : [],
+    ...Array.isArray(value.clipping_offenders) ? value.clipping_offenders : [],
+    ...Array.isArray(value.clippingOffenders) ? value.clippingOffenders : []
+  ];
+  return offenders.filter((item) => isRecord(item)).sort((a, b) => horizontalOffenderOverflowPx(b) - horizontalOffenderOverflowPx(a));
+}
+function maxPositiveNumber(...values) {
+  let max = 0;
+  for (const value of values) {
+    const number = numberValue(value);
+    if (number !== void 0 && number > max) max = number;
+  }
+  return max;
+}
+function roundPixels(value) {
+  return Math.round(value * 100) / 100;
+}
 function timeoutSecValue(value) {
   const number = numberValue(value);
   return number && number > 0 ? Math.ceil(number) : void 0;
@@ -7160,7 +7233,7 @@ function assessCheckFromEvidence(check, evidence) {
         message: "No applicable viewport evidence was captured for overflow check."
       };
     }
-    const failed = applicable.filter((viewport) => (viewport.overflow_px ?? 0) > maxOverflow);
+    const failed = applicable.filter((viewport) => horizontalBoundsOverflowPx(viewport) > maxOverflow);
     return {
       type: check.type,
       label: checkLabel(check),
@@ -7168,9 +7241,11 @@ function assessCheckFromEvidence(check, evidence) {
       evidence: {
         max_overflow_px: maxOverflow,
         overflow_px: applicable.map((viewport) => viewport.overflow_px ?? null),
+        bounds_overflow_px: applicable.map((viewport) => horizontalBoundsOverflowPx(viewport)),
+        overflow_offender_counts: applicable.map((viewport) => boundsOffendersForEvidence(viewport).length),
         viewports: applicable.map((viewport) => viewport.name)
       },
-      message: failed.length ? `Horizontal overflow exceeded ${maxOverflow}px in ${failed.length} viewport(s).` : void 0
+      message: failed.length ? `Horizontal bounds overflow exceeded ${maxOverflow}px in ${failed.length} viewport(s).` : void 0
     };
   }
   if (check.type === "no_fatal_console_errors") {
@@ -7376,6 +7451,77 @@ function textMatches(sample, check) {
   }
   return String(sample || "").includes(check.text || "");
 }
+function numberValue(value) {
+  return typeof value === "number" && Number.isFinite(value) ? value : undefined;
+}
+function maxPositiveNumber() {
+  let max = 0;
+  for (const value of arguments) {
+    const number = numberValue(value);
+    if (number !== undefined && number > max) max = number;
+  }
+  return max;
+}
+function roundPixels(value) {
+  return Math.round(value * 100) / 100;
+}
+function isRecord(value) {
+  return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+}
+function boundsOffendersForEvidence(value) {
+  if (!isRecord(value)) return [];
+  const offenders = []
+    .concat(Array.isArray(value.overflow_offenders) ? value.overflow_offenders : [])
+    .concat(Array.isArray(value.overflowOffenders) ? value.overflowOffenders : [])
+    .concat(Array.isArray(value.bounds_offenders) ? value.bounds_offenders : [])
+    .concat(Array.isArray(value.boundsOffenders) ? value.boundsOffenders : [])
+    .concat(Array.isArray(value.clipped_elements) ? value.clipped_elements : [])
+    .concat(Array.isArray(value.clippedElements) ? value.clippedElements : [])
+    .concat(Array.isArray(value.clipping_offenders) ? value.clipping_offenders : [])
+    .concat(Array.isArray(value.clippingOffenders) ? value.clippingOffenders : []);
+  return offenders.filter(isRecord).sort((a, b) => horizontalOffenderOverflowPx(b) - horizontalOffenderOverflowPx(a));
+}
+function horizontalOffenderOverflowPx(value) {
+  if (!isRecord(value)) return 0;
+  let max = maxPositiveNumber(
+    value.overflow,
+    value.overflow_px,
+    value.bounds_overflow_px,
+    value.horizontal_overflow_px,
+    value.left_overflow_px,
+    value.right_overflow_px,
+    value.leftOverflowPx,
+    value.rightOverflowPx
+  );
+  const clipped = value.clipped || value.clip || value.clipping;
+  if (isRecord(clipped)) {
+    max = Math.max(max, maxPositiveNumber(clipped.left, clipped.right, clipped.left_px, clipped.right_px, clipped.leftPx, clipped.rightPx));
+  }
+  const rect = value.rect || value.bounds || value.bounding_rect || value.boundingRect;
+  const viewportWidth = numberValue(value.viewport_width != null ? value.viewport_width : value.viewportWidth);
+  if (isRecord(rect) && viewportWidth !== undefined) {
+    const left = numberValue(rect.left);
+    const right = numberValue(rect.right);
+    if (left !== undefined && left < 0) max = Math.max(max, Math.abs(left));
+    if (right !== undefined && right > viewportWidth) max = Math.max(max, right - viewportWidth);
+  }
+  return roundPixels(max);
+}
+function horizontalBoundsOverflowPx(value) {
+  if (!isRecord(value)) return 0;
+  let max = maxPositiveNumber(
+    value.overflow_px,
+    value.overflow,
+    value.bounds_overflow_px,
+    value.horizontal_overflow_px,
+    value.left_overflow_px,
+    value.right_overflow_px
+  );
+  for (const offender of boundsOffendersForEvidence(value)) {
+    max = Math.max(max, horizontalOffenderOverflowPx(offender));
+  }
+  return roundPixels(max);
+}
 function assessProfile(profile, evidence) {
   const checks = [];
   const viewports = evidence.viewports || [];
@@ -7493,13 +7639,19 @@ function assessProfile(profile, evidence) {
         });
         continue;
       }
-      const failed = applicable.filter((viewport) => (viewport.overflow_px || 0) > maxOverflow);
+      const failed = applicable.filter((viewport) => horizontalBoundsOverflowPx(viewport) > maxOverflow);
       checks.push({
         type: check.type,
         label: check.label || check.type,
         status: failed.length ? "failed" : "passed",
-        evidence: { max_overflow_px: maxOverflow, overflow_px: applicable.map((viewport) => viewport.overflow_px ?? null), viewports: applicable.map((viewport) => viewport.name) },
-        message: failed.length ? "Horizontal overflow exceeded " + maxOverflow + "px in " + failed.length + " viewport(s)." : undefined,
+        evidence: {
+          max_overflow_px: maxOverflow,
+          overflow_px: applicable.map((viewport) => viewport.overflow_px ?? null),
+          bounds_overflow_px: applicable.map((viewport) => horizontalBoundsOverflowPx(viewport)),
+          overflow_offender_counts: applicable.map((viewport) => boundsOffendersForEvidence(viewport).length),
+          viewports: applicable.map((viewport) => viewport.name)
+        },
+        message: failed.length ? "Horizontal bounds overflow exceeded " + maxOverflow + "px in " + failed.length + " viewport(s)." : undefined,
       });
       continue;
     }
@@ -7729,14 +7881,55 @@ async function captureViewport(viewport) {
     const body = document.body;
     const documentElement = document.documentElement;
     const text = (body ? body.innerText : "").replace(/\s+/g, " ").trim();
+    const clientWidth = documentElement ? documentElement.clientWidth : window.innerWidth;
+    const scrollWidth = documentElement ? documentElement.scrollWidth : 0;
+    const viewportWidth = clientWidth || window.innerWidth;
+    const overflowOffenders = [];
+    for (const element of Array.from(body ? body.querySelectorAll("*") : [])) {
+      const rect = element.getBoundingClientRect();
+      if (!rect || rect.width < 1 || rect.height < 1) continue;
+      const style = window.getComputedStyle(element);
+      if (style.display === "none" || style.visibility === "hidden" || style.opacity === "0") continue;
+      const leftOverflow = Math.max(0, -rect.left);
+      const rightOverflow = Math.max(0, rect.right - viewportWidth);
+      const overflow = Math.max(leftOverflow, rightOverflow);
+      if (overflow <= 0.5) continue;
+      const tag = element.tagName ? element.tagName.toLowerCase() : "element";
+      const id = element.id ? "#" + element.id : "";
+      const className = typeof element.className === "string"
+        ? element.className.trim().split(/\s+/).filter(Boolean).slice(0, 2).join(".")
+        : "";
+      overflowOffenders.push({
+        selector: tag + id + (className ? "." + className : ""),
+        tag,
+        text: (element.textContent || "").replace(/\s+/g, " ").trim().slice(0, 120),
+        overflow,
+        left_overflow_px: leftOverflow,
+        right_overflow_px: rightOverflow,
+        viewport_width: viewportWidth,
+        rect: {
+          left: rect.left,
+          right: rect.right,
+          width: rect.width,
+        },
+      });
+    }
+    overflowOffenders.sort((a, b) => b.overflow - a.overflow);
+    const boundsOverflowPx = Math.max(
+      0,
+      scrollWidth - (clientWidth || viewportWidth),
+      ...overflowOffenders.map((offender) => offender.overflow),
+    );
     return {
       url: location.href,
       pathname: location.pathname,
       title: document.title,
       body_text_length: text.length,
       body_text_sample: text.slice(0, 8000),
-      scroll_width: documentElement ? documentElement.scrollWidth : 0,
-      client_width: documentElement ? documentElement.clientWidth : window.innerWidth,
+      scroll_width: scrollWidth,
+      client_width: clientWidth,
+      bounds_overflow_px: Math.round(boundsOverflowPx * 100) / 100,
+      overflow_offenders: overflowOffenders.slice(0, 10),
     };
   }).catch((error) => ({
     url: page.url(),
@@ -7746,6 +7939,8 @@ async function captureViewport(viewport) {
     body_text_sample: "",
     scroll_width: 0,
     client_width: viewport.width,
+    bounds_overflow_px: 0,
+    overflow_offenders: [],
     evaluation_error: String(error && error.message ? error.message : error).slice(0, 1000),
   }));
   const selectors = {};
@@ -7784,6 +7979,8 @@ async function captureViewport(viewport) {
     scroll_width: dom.scroll_width,
     client_width: dom.client_width,
     overflow_px: Math.max(0, (dom.scroll_width || 0) - (dom.client_width || viewport.width)),
+    bounds_overflow_px: dom.bounds_overflow_px,
+    overflow_offenders: dom.overflow_offenders || [],
     selectors,
     text_matches,
     setup_action_results: setupActionResults,
@@ -7815,6 +8012,8 @@ function buildProfileEvidence(currentViewports) {
       routes: currentViewports.map((viewport) => viewport.route),
       titles: currentViewports.map((viewport) => viewport.title),
       overflow_px: currentViewports.map((viewport) => viewport.overflow_px),
+      bounds_overflow_px: currentViewports.map((viewport) => viewport.bounds_overflow_px),
+      overflow_offender_counts: currentViewports.map((viewport) => (viewport.overflow_offenders || []).length),
     },
   };
 }
@@ -7838,24 +8037,36 @@ return result;
 }
 function collectRiddleProfileArtifactRefs(input) {
   const refs = [];
-  const seen = /* @__PURE__ */ new Set();
+  const indexes = /* @__PURE__ */ new Map();
+  const priorities = /* @__PURE__ */ new Map();
   function add(item, source) {
     if (!isRecord(item)) return;
-    const name = stringValue2(item.name) || stringValue2(item.filename) || "";
     const url = stringValue2(item.url);
     const path7 = stringValue2(item.path);
+    const rawName = stringValue2(item.name) || stringValue2(item.filename) || artifactNameFromPath(url || path7) || "";
+    const name = normalizeRiddleProfileArtifactName(rawName);
     if (!name && !url && !path7) return;
-    const key = `${name}:${url || path7 || ""}`;
-    if (seen.has(key)) return;
-    seen.add(key);
-    refs.push({
+    const key = profileArtifactDedupeKey(name, url || path7 || "");
+    const priority = profileArtifactPriority(rawName, name);
+    const ref = {
       name,
       url,
       path: path7,
       kind: stringValue2(item.kind) || stringValue2(item.type),
       content_type: stringValue2(item.content_type) || stringValue2(item.contentType),
       source
-    });
+    };
+    const existingIndex = indexes.get(key);
+    if (existingIndex !== void 0) {
+      if (priority > (priorities.get(key) || 0)) {
+        refs[existingIndex] = ref;
+        priorities.set(key, priority);
+      }
+      return;
+    }
+    indexes.set(key, refs.length);
+    priorities.set(key, priority);
+    refs.push(ref);
   }
   function visit(value, source) {
     if (Array.isArray(value)) {
@@ -7870,6 +8081,31 @@ function collectRiddleProfileArtifactRefs(input) {
   visit(input, "artifacts");
   return refs;
 }
+function normalizeRiddleProfileArtifactName(name) {
+  return name.replace(/\.json\.json$/i, ".json");
+}
+function profileArtifactDedupeKey(name, location) {
+  if (PROFILE_SINGLETON_ARTIFACT_NAMES.has(name.toLowerCase())) return name.toLowerCase();
+  return `${name}:${location}`;
+}
+function profileArtifactPriority(rawName, normalizedName) {
+  const lower = normalizedName.toLowerCase();
+  if (!PROFILE_SINGLETON_ARTIFACT_NAMES.has(lower)) return 1;
+  return /\.json\.json$/i.test(rawName) ? 2 : 1;
+}
+function artifactNameFromPath(value) {
+  if (!value) return "";
+  try {
+    return new URL(value).pathname.split("/").filter(Boolean).pop() || "";
+  } catch {
+    return value.split(/[\\/]/).filter(Boolean).pop() || "";
+  }
+}
+var PROFILE_SINGLETON_ARTIFACT_NAMES = /* @__PURE__ */ new Set([
+  "proof.json",
+  "console.json",
+  "dom-summary.json"
+]);
 function extractRiddleProofProfileResult(input) {
   if (!isRecord(input)) return void 0;
   if (input.version === RIDDLE_PROOF_PROFILE_RESULT_VERSION) return input;

package/dist/cli.js

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