@riddledc/riddle-proof 0.7.21 → 0.7.22

package/dist/basic-gameplay.cjs

@@ -119,7 +119,8 @@ function assessBasicGameplayEvidence(evidence, options = {}) {
   }
   const routeResults = (run.results || []).map((route) => augmentRouteAssessmentWithProgressionChecks(
     assessBasicGameplayRoute(route, options),
-    route
+    route,
+    options
   ));
   const failingRoutes = routeResults.filter((result) => !result.ok).map((result) => ({
     name: result.name,
@@ -180,7 +181,7 @@ function assessBasicGameplayRoute(route, options = {}) {
   const responseStatus = firstNumber(route.http_status, route.response_status, route.status);
   const pageErrorCount = numberValue(route.page_error_count);
   const consoleErrorCount = numberValue(route.console_error_count);
-  const mobileOverflowPx = numberValue(mobile.overflow_px);
+  const mobileOverflowPx = horizontalBoundsOverflowPx(mobile);
   if (responseStatus !== null && responseStatus >= 400) failures.push("route_http_error");
   if (pageErrorCount > 0) failures.push("fatal_page_error");
   if (numberValue(initial.body_text_length) < minBodyTextLength && numberValue(initial.visible_large_node_count) < minVisibleLargeNodes) {
@@ -323,11 +324,11 @@ function assessBasicGameplayProgressionCheck(check) {
 function assessBasicGameplayProgressionChecks(route) {
   return progressionChecksForRoute(route).map((check) => assessBasicGameplayProgressionCheck(check));
 }
-function augmentBasicGameplayAssessmentWithProgressionChecks(assessment, evidence) {
+function augmentBasicGameplayAssessmentWithProgressionChecks(assessment, evidence, options = {}) {
   const run = extractBasicGameplayEvidence(evidence);
   if (!run?.results?.length) return assessment;
   const routeResults = assessment.route_results.map(
-    (result, index) => augmentRouteAssessmentWithProgressionChecks(result, run.results?.[index] || {})
+    (result, index) => augmentRouteAssessmentWithProgressionChecks(result, run.results?.[index] || {}, options)
   );
   const failingRoutes = routeResults.filter((result) => !result.ok).map((result) => ({
     name: result.name,
@@ -389,7 +390,7 @@ function attachBasicGameplayArtifactScreenshotHashes(evidence, routesOrOptions =
   }
   return evidence;
 }
-function createBasicGameplayCatchRecords(assessment, evidence) {
+function createBasicGameplayCatchRecords(assessment, evidence, options = {}) {
   const run = extractBasicGameplayEvidence(evidence);
   if (!run?.results?.length) return [];
   const catches = [];
@@ -463,6 +464,24 @@ function createBasicGameplayCatchRecords(assessment, evidence) {
         summary: `${route.name || route.path || "Route"}: responsive setup failed on ${failure.viewport?.label || "viewport"} (${failure.reason || "responsive_setup_failed"})`
       });
     }
+    for (const failure of responsiveBoundsFailures(route, options.maxMobileOverflowPx ?? 4)) {
+      catches.push({
+        site: run.site || null,
+        route: route.name,
+        path: route.path,
+        code: failure.code,
+        label: failure.label,
+        type: "responsive_bounds",
+        selector: null,
+        reason: failure.reason || "responsive_bounds_clipped",
+        phase: failure.viewport?.phase || void 0,
+        viewport: failure.viewport,
+        overflow_px: failure.overflow_px,
+        max_allowed_px: failure.max_allowed_px,
+        offenders: failure.offenders,
+        summary: `${route.name || route.path || "Route"}: responsive bounds exceeded ${failure.max_allowed_px}px on ${failure.viewport?.label || "viewport"} (${failure.overflow_px}px)`
+      });
+    }
     for (const check of assessBasicGameplayProgressionChecks(route).filter((item) => item.ok === false)) {
       catches.push({
         site: run.site || null,
@@ -617,13 +636,15 @@ function changed(before, after) {
 function canvasHashes(canvases) {
   return (canvases || []).map((canvas) => canvas.hash).filter(Boolean).join("|");
 }
-function augmentRouteAssessmentWithProgressionChecks(result, route) {
+function augmentRouteAssessmentWithProgressionChecks(result, route, options = {}) {
   const progressionFailures = assessBasicGameplayProgressionChecks(route).filter((check) => check.ok === false);
   const responsiveFailures = responsiveSetupFailures(route);
-  if (!progressionFailures.length && !responsiveFailures.length) return result;
+  const responsiveBounds = responsiveBoundsFailures(route, options.maxMobileOverflowPx ?? 4);
+  if (!progressionFailures.length && !responsiveFailures.length && !responsiveBounds.length) return result;
   const failures = new Set(result.failures);
   if (progressionFailures.length) failures.add("progression_assertion_failed");
   for (const failure of responsiveFailures) failures.add(failure.code);
+  for (const failure of responsiveBounds) failures.add(failure.code);
   return {
     ...result,
     ok: false,
@@ -639,7 +660,8 @@ function augmentRouteAssessmentWithProgressionChecks(result, route) {
         state_call: check.state_call || null,
         property_path: check.property_path || null
       })),
-      ...responsiveFailures
+      ...responsiveFailures,
+      ...responsiveBounds
     ]
   };
 }
@@ -665,6 +687,28 @@ function responsiveSetupFailures(route) {
   }
   return failures;
 }
+function responsiveBoundsFailures(route, maxOverflowPx) {
+  const failures = [];
+  for (const viewport of responsiveViewportsForRoute(route)) {
+    const overflowPx = horizontalBoundsOverflowPx(viewport);
+    if (overflowPx <= maxOverflowPx) continue;
+    failures.push({
+      code: "responsive_bounds_clipped",
+      label: `${viewport.label || "responsive"} horizontal bounds`,
+      reason: `horizontal bounds overflow ${overflowPx}px exceeded ${maxOverflowPx}px`,
+      overflow_px: overflowPx,
+      max_allowed_px: maxOverflowPx,
+      offenders: boundsOffendersForEvidence(viewport).slice(0, 10),
+      viewport: {
+        label: viewport.label || null,
+        width: numberValue(viewport.width) || null,
+        height: numberValue(viewport.height) || null,
+        phase: viewport.phase || null
+      }
+    });
+  }
+  return failures;
+}
 function responsiveViewportsForRoute(route) {
   return listValue(route.responsive_viewports || route.responsiveViewports).filter((item) => Boolean(recordValue(item)));
 }
@@ -674,6 +718,82 @@ function progressionChecksForRoute(route) {
 function metricValue(value) {
   return recordValue(value);
 }
+function horizontalBoundsOverflowPx(value) {
+  const record = recordValue(value);
+  if (!record) return 0;
+  let max = maxPositiveNumber(
+    record.overflow_px,
+    record.overflow,
+    record.bounds_overflow_px,
+    record.horizontal_overflow_px,
+    record.left_overflow_px,
+    record.right_overflow_px
+  );
+  for (const offender of boundsOffendersForEvidence(record)) {
+    max = Math.max(max, horizontalOffenderOverflowPx(offender));
+  }
+  return roundPixels(max);
+}
+function horizontalOffenderOverflowPx(value) {
+  const record = recordValue(value);
+  if (!record) return 0;
+  let max = maxPositiveNumber(
+    record.overflow,
+    record.overflow_px,
+    record.bounds_overflow_px,
+    record.horizontal_overflow_px,
+    record.left_overflow_px,
+    record.right_overflow_px,
+    record.leftOverflowPx,
+    record.rightOverflowPx
+  );
+  const clipped = recordValue(record.clipped || record.clip || record.clipping);
+  if (clipped) {
+    max = Math.max(max, maxPositiveNumber(
+      clipped.left,
+      clipped.right,
+      clipped.left_px,
+      clipped.right_px,
+      clipped.leftPx,
+      clipped.rightPx
+    ));
+  }
+  const rect = recordValue(record.rect || record.bounds || record.bounding_rect || record.boundingRect);
+  const viewportWidth = numericValue(record.viewport_width ?? record.viewportWidth);
+  if (rect && viewportWidth !== null) {
+    const left = numericValue(rect.left);
+    const right = numericValue(rect.right);
+    if (left !== null && left < 0) max = Math.max(max, Math.abs(left));
+    if (right !== null && right > viewportWidth) max = Math.max(max, right - viewportWidth);
+  }
+  return roundPixels(max);
+}
+function boundsOffendersForEvidence(value) {
+  const record = recordValue(value);
+  if (!record) return [];
+  const offenders = [
+    ...listValue(record.overflow_offenders),
+    ...listValue(record.overflowOffenders),
+    ...listValue(record.bounds_offenders),
+    ...listValue(record.boundsOffenders),
+    ...listValue(record.clipped_elements),
+    ...listValue(record.clippedElements),
+    ...listValue(record.clipping_offenders),
+    ...listValue(record.clippingOffenders)
+  ];
+  return offenders.filter((item) => Boolean(recordValue(item))).sort((a, b) => horizontalOffenderOverflowPx(b) - horizontalOffenderOverflowPx(a));
+}
+function maxPositiveNumber(...values) {
+  let max = 0;
+  for (const value of values) {
+    const number = numericValue(value);
+    if (number !== null && number > max) max = number;
+  }
+  return max;
+}
+function roundPixels(value) {
+  return Math.round(value * 100) / 100;
+}
 function textMatches(text, pattern, flags) {
   if (!pattern) return Boolean(text);
   try {

package/dist/basic-gameplay.d.cts

@@ -1,7 +1,7 @@
 declare const RIDDLE_PROOF_BASIC_GAMEPLAY_VERSION = "riddle-proof.basic-gameplay.v1";
 declare const RIDDLE_PROOF_BASIC_GAMEPLAY_ASSESSMENT_VERSION = "riddle-proof.basic-gameplay.assessment.v1";
 declare const RIDDLE_PROOF_BASIC_GAMEPLAY_CATCH_VERSION = "riddle-proof.basic-gameplay.catch.v1";
-type BasicGameplayFailureCode = "route_http_error" | "fatal_page_error" | "route_blank_or_thin" | "no_game_surface" | "mobile_horizontal_overflow" | "primary_control_missing" | "primary_control_inert" | "progression_assertion_failed" | "responsive_setup_failed";
+type BasicGameplayFailureCode = "route_http_error" | "fatal_page_error" | "route_blank_or_thin" | "no_game_surface" | "mobile_horizontal_overflow" | "responsive_bounds_clipped" | "primary_control_missing" | "primary_control_inert" | "progression_assertion_failed" | "responsive_setup_failed";
 type BasicGameplayWarningCode = "canvas_inert" | "some_actions_failed" | "missing_reset_path" | "critical_console_error";
 interface BasicGameplayCanvasState {
     index?: number;
@@ -95,13 +95,16 @@ interface BasicGameplayProgressionCheck {
     [key: string]: unknown;
 }
 interface BasicGameplaySuiteFailure {
-    code: "progression_assertion_failed" | "responsive_setup_failed";
+    code: "progression_assertion_failed" | "responsive_setup_failed" | "responsive_bounds_clipped";
     label?: string;
     reason?: string | null;
     selector?: string | null;
     state_path?: string | null;
     state_call?: string | null;
     property_path?: string | null;
+    overflow_px?: number | null;
+    max_allowed_px?: number | null;
+    offenders?: BasicGameplayBoundsOffender[];
     viewport?: {
         label?: string | null;
         width?: number | null;
@@ -110,17 +113,37 @@ interface BasicGameplaySuiteFailure {
     };
     action_result?: BasicGameplayActionResult;
 }
+interface BasicGameplayBoundsOffender {
+    selector?: string | null;
+    tag?: string | null;
+    overflow?: number;
+    overflow_px?: number;
+    left_overflow_px?: number;
+    right_overflow_px?: number;
+    bounds_overflow_px?: number;
+    clipped?: Record<string, unknown>;
+    rect?: Record<string, unknown>;
+    bounds?: Record<string, unknown>;
+    viewport_width?: number;
+    viewportWidth?: number;
+    [key: string]: unknown;
+}
 interface BasicGameplayResponsiveViewportEvidence {
     label?: string;
     width?: number;
     height?: number;
     phase?: string;
+    overflow_px?: number;
+    bounds_overflow_px?: number;
+    overflow_offenders?: BasicGameplayBoundsOffender[];
     setup_action_results?: BasicGameplayActionResult[];
     setupActionResults?: BasicGameplayActionResult[];
     [key: string]: unknown;
 }
 interface BasicGameplayMobileEvidence {
     overflow_px?: number;
+    bounds_overflow_px?: number;
+    overflow_offenders?: BasicGameplayBoundsOffender[];
     [key: string]: unknown;
 }
 interface RiddleProofBasicGameplayRouteEvidence {
@@ -314,11 +337,11 @@ declare function sanitizeBasicGameplayJsonString(value: unknown): string;
 declare function compactBasicGameplayText(value: unknown, max?: number): string;
 declare function assessBasicGameplayProgressionCheck(check: BasicGameplayProgressionCheck): BasicGameplayProgressionCheck;
 declare function assessBasicGameplayProgressionChecks(route: RiddleProofBasicGameplayRouteEvidence): BasicGameplayProgressionCheck[];
-declare function augmentBasicGameplayAssessmentWithProgressionChecks(assessment: RiddleProofBasicGameplayAssessment, evidence: unknown): RiddleProofBasicGameplayAssessment;
+declare function augmentBasicGameplayAssessmentWithProgressionChecks(assessment: RiddleProofBasicGameplayAssessment, evidence: unknown, options?: AssessBasicGameplayOptions): RiddleProofBasicGameplayAssessment;
 declare function resolveBasicGameplayProgressionCheckWithArtifactScreenshots(check: BasicGameplayProgressionCheck): BasicGameplayProgressionCheck;
 declare function attachBasicGameplayArtifactScreenshotHashes(evidence: RiddleProofBasicGameplayEvidence, routesOrOptions?: BasicGameplayRouteReference[] | AttachBasicGameplayArtifactOptions, maybeArtifacts?: BasicGameplayProofArtifact[]): RiddleProofBasicGameplayEvidence;
-declare function createBasicGameplayCatchRecords(assessment: RiddleProofBasicGameplayAssessment, evidence: unknown): BasicGameplayCatchRecord[];
+declare function createBasicGameplayCatchRecords(assessment: RiddleProofBasicGameplayAssessment, evidence: unknown, options?: AssessBasicGameplayOptions): BasicGameplayCatchRecord[];
 declare function createBasicGameplayCatchSummary(input: CreateBasicGameplayCatchSummaryInput, options?: AssessBasicGameplayOptions): RiddleProofBasicGameplayCatchSummary;
 declare function extractBasicGameplayEvidence(...sources: unknown[]): RiddleProofBasicGameplayEvidence | null;
 
-export { type AssessBasicGameplayOptions, type AttachBasicGameplayArtifactOptions, BASIC_GAMEPLAY_ACTION_TYPES, BASIC_GAMEPLAY_PROGRESS_CHECK_TYPES, type BasicGameplayActionResult, type BasicGameplayActionType, type BasicGameplayArtifactResolution, type BasicGameplayAssessmentSummary, type BasicGameplayCanvasState, type BasicGameplayCatchRecord, type BasicGameplayChangeSummary, type BasicGameplayFailureCode, type BasicGameplayFixReference, type BasicGameplayMetric, type BasicGameplayMobileEvidence, type BasicGameplayProgressCheckType, type BasicGameplayProgressionCheck, type BasicGameplayProofArtifact, type BasicGameplayResponsiveViewportEvidence, type BasicGameplayRouteReference, type BasicGameplaySnapshot, type BasicGameplaySuiteFailure, type BasicGameplayWarningCode, type CreateBasicGameplayCatchSummaryInput, RIDDLE_PROOF_BASIC_GAMEPLAY_ASSESSMENT_VERSION, RIDDLE_PROOF_BASIC_GAMEPLAY_CATCH_VERSION, RIDDLE_PROOF_BASIC_GAMEPLAY_VERSION, type RiddleProofBasicGameplayAssessment, type RiddleProofBasicGameplayCatchSummary, type RiddleProofBasicGameplayEvidence, type RiddleProofBasicGameplayRouteAssessment, type RiddleProofBasicGameplayRouteEvidence, assessBasicGameplayEvidence, assessBasicGameplayProgressionCheck, assessBasicGameplayProgressionChecks, assessBasicGameplayRoute, attachBasicGameplayArtifactScreenshotHashes, augmentBasicGameplayAssessmentWithProgressionChecks, compactBasicGameplayText, createBasicGameplayCatchRecords, createBasicGameplayCatchSummary, extractBasicGameplayEvidence, resolveBasicGameplayProgressionCheckWithArtifactScreenshots, sanitizeBasicGameplayJsonString };
+export { type AssessBasicGameplayOptions, type AttachBasicGameplayArtifactOptions, BASIC_GAMEPLAY_ACTION_TYPES, BASIC_GAMEPLAY_PROGRESS_CHECK_TYPES, type BasicGameplayActionResult, type BasicGameplayActionType, type BasicGameplayArtifactResolution, type BasicGameplayAssessmentSummary, type BasicGameplayBoundsOffender, type BasicGameplayCanvasState, type BasicGameplayCatchRecord, type BasicGameplayChangeSummary, type BasicGameplayFailureCode, type BasicGameplayFixReference, type BasicGameplayMetric, type BasicGameplayMobileEvidence, type BasicGameplayProgressCheckType, type BasicGameplayProgressionCheck, type BasicGameplayProofArtifact, type BasicGameplayResponsiveViewportEvidence, type BasicGameplayRouteReference, type BasicGameplaySnapshot, type BasicGameplaySuiteFailure, type BasicGameplayWarningCode, type CreateBasicGameplayCatchSummaryInput, RIDDLE_PROOF_BASIC_GAMEPLAY_ASSESSMENT_VERSION, RIDDLE_PROOF_BASIC_GAMEPLAY_CATCH_VERSION, RIDDLE_PROOF_BASIC_GAMEPLAY_VERSION, type RiddleProofBasicGameplayAssessment, type RiddleProofBasicGameplayCatchSummary, type RiddleProofBasicGameplayEvidence, type RiddleProofBasicGameplayRouteAssessment, type RiddleProofBasicGameplayRouteEvidence, assessBasicGameplayEvidence, assessBasicGameplayProgressionCheck, assessBasicGameplayProgressionChecks, assessBasicGameplayRoute, attachBasicGameplayArtifactScreenshotHashes, augmentBasicGameplayAssessmentWithProgressionChecks, compactBasicGameplayText, createBasicGameplayCatchRecords, createBasicGameplayCatchSummary, extractBasicGameplayEvidence, resolveBasicGameplayProgressionCheckWithArtifactScreenshots, sanitizeBasicGameplayJsonString };

package/dist/basic-gameplay.d.ts

@@ -1,7 +1,7 @@
 declare const RIDDLE_PROOF_BASIC_GAMEPLAY_VERSION = "riddle-proof.basic-gameplay.v1";
 declare const RIDDLE_PROOF_BASIC_GAMEPLAY_ASSESSMENT_VERSION = "riddle-proof.basic-gameplay.assessment.v1";
 declare const RIDDLE_PROOF_BASIC_GAMEPLAY_CATCH_VERSION = "riddle-proof.basic-gameplay.catch.v1";
-type BasicGameplayFailureCode = "route_http_error" | "fatal_page_error" | "route_blank_or_thin" | "no_game_surface" | "mobile_horizontal_overflow" | "primary_control_missing" | "primary_control_inert" | "progression_assertion_failed" | "responsive_setup_failed";
+type BasicGameplayFailureCode = "route_http_error" | "fatal_page_error" | "route_blank_or_thin" | "no_game_surface" | "mobile_horizontal_overflow" | "responsive_bounds_clipped" | "primary_control_missing" | "primary_control_inert" | "progression_assertion_failed" | "responsive_setup_failed";
 type BasicGameplayWarningCode = "canvas_inert" | "some_actions_failed" | "missing_reset_path" | "critical_console_error";
 interface BasicGameplayCanvasState {
     index?: number;
@@ -95,13 +95,16 @@ interface BasicGameplayProgressionCheck {
     [key: string]: unknown;
 }
 interface BasicGameplaySuiteFailure {
-    code: "progression_assertion_failed" | "responsive_setup_failed";
+    code: "progression_assertion_failed" | "responsive_setup_failed" | "responsive_bounds_clipped";
     label?: string;
     reason?: string | null;
     selector?: string | null;
     state_path?: string | null;
     state_call?: string | null;
     property_path?: string | null;
+    overflow_px?: number | null;
+    max_allowed_px?: number | null;
+    offenders?: BasicGameplayBoundsOffender[];
     viewport?: {
         label?: string | null;
         width?: number | null;
@@ -110,17 +113,37 @@ interface BasicGameplaySuiteFailure {
     };
     action_result?: BasicGameplayActionResult;
 }
+interface BasicGameplayBoundsOffender {
+    selector?: string | null;
+    tag?: string | null;
+    overflow?: number;
+    overflow_px?: number;
+    left_overflow_px?: number;
+    right_overflow_px?: number;
+    bounds_overflow_px?: number;
+    clipped?: Record<string, unknown>;
+    rect?: Record<string, unknown>;
+    bounds?: Record<string, unknown>;
+    viewport_width?: number;
+    viewportWidth?: number;
+    [key: string]: unknown;
+}
 interface BasicGameplayResponsiveViewportEvidence {
     label?: string;
     width?: number;
     height?: number;
     phase?: string;
+    overflow_px?: number;
+    bounds_overflow_px?: number;
+    overflow_offenders?: BasicGameplayBoundsOffender[];
     setup_action_results?: BasicGameplayActionResult[];
     setupActionResults?: BasicGameplayActionResult[];
     [key: string]: unknown;
 }
 interface BasicGameplayMobileEvidence {
     overflow_px?: number;
+    bounds_overflow_px?: number;
+    overflow_offenders?: BasicGameplayBoundsOffender[];
     [key: string]: unknown;
 }
 interface RiddleProofBasicGameplayRouteEvidence {
@@ -314,11 +337,11 @@ declare function sanitizeBasicGameplayJsonString(value: unknown): string;
 declare function compactBasicGameplayText(value: unknown, max?: number): string;
 declare function assessBasicGameplayProgressionCheck(check: BasicGameplayProgressionCheck): BasicGameplayProgressionCheck;
 declare function assessBasicGameplayProgressionChecks(route: RiddleProofBasicGameplayRouteEvidence): BasicGameplayProgressionCheck[];
-declare function augmentBasicGameplayAssessmentWithProgressionChecks(assessment: RiddleProofBasicGameplayAssessment, evidence: unknown): RiddleProofBasicGameplayAssessment;
+declare function augmentBasicGameplayAssessmentWithProgressionChecks(assessment: RiddleProofBasicGameplayAssessment, evidence: unknown, options?: AssessBasicGameplayOptions): RiddleProofBasicGameplayAssessment;
 declare function resolveBasicGameplayProgressionCheckWithArtifactScreenshots(check: BasicGameplayProgressionCheck): BasicGameplayProgressionCheck;
 declare function attachBasicGameplayArtifactScreenshotHashes(evidence: RiddleProofBasicGameplayEvidence, routesOrOptions?: BasicGameplayRouteReference[] | AttachBasicGameplayArtifactOptions, maybeArtifacts?: BasicGameplayProofArtifact[]): RiddleProofBasicGameplayEvidence;
-declare function createBasicGameplayCatchRecords(assessment: RiddleProofBasicGameplayAssessment, evidence: unknown): BasicGameplayCatchRecord[];
+declare function createBasicGameplayCatchRecords(assessment: RiddleProofBasicGameplayAssessment, evidence: unknown, options?: AssessBasicGameplayOptions): BasicGameplayCatchRecord[];
 declare function createBasicGameplayCatchSummary(input: CreateBasicGameplayCatchSummaryInput, options?: AssessBasicGameplayOptions): RiddleProofBasicGameplayCatchSummary;
 declare function extractBasicGameplayEvidence(...sources: unknown[]): RiddleProofBasicGameplayEvidence | null;
 
-export { type AssessBasicGameplayOptions, type AttachBasicGameplayArtifactOptions, BASIC_GAMEPLAY_ACTION_TYPES, BASIC_GAMEPLAY_PROGRESS_CHECK_TYPES, type BasicGameplayActionResult, type BasicGameplayActionType, type BasicGameplayArtifactResolution, type BasicGameplayAssessmentSummary, type BasicGameplayCanvasState, type BasicGameplayCatchRecord, type BasicGameplayChangeSummary, type BasicGameplayFailureCode, type BasicGameplayFixReference, type BasicGameplayMetric, type BasicGameplayMobileEvidence, type BasicGameplayProgressCheckType, type BasicGameplayProgressionCheck, type BasicGameplayProofArtifact, type BasicGameplayResponsiveViewportEvidence, type BasicGameplayRouteReference, type BasicGameplaySnapshot, type BasicGameplaySuiteFailure, type BasicGameplayWarningCode, type CreateBasicGameplayCatchSummaryInput, RIDDLE_PROOF_BASIC_GAMEPLAY_ASSESSMENT_VERSION, RIDDLE_PROOF_BASIC_GAMEPLAY_CATCH_VERSION, RIDDLE_PROOF_BASIC_GAMEPLAY_VERSION, type RiddleProofBasicGameplayAssessment, type RiddleProofBasicGameplayCatchSummary, type RiddleProofBasicGameplayEvidence, type RiddleProofBasicGameplayRouteAssessment, type RiddleProofBasicGameplayRouteEvidence, assessBasicGameplayEvidence, assessBasicGameplayProgressionCheck, assessBasicGameplayProgressionChecks, assessBasicGameplayRoute, attachBasicGameplayArtifactScreenshotHashes, augmentBasicGameplayAssessmentWithProgressionChecks, compactBasicGameplayText, createBasicGameplayCatchRecords, createBasicGameplayCatchSummary, extractBasicGameplayEvidence, resolveBasicGameplayProgressionCheckWithArtifactScreenshots, sanitizeBasicGameplayJsonString };
+export { type AssessBasicGameplayOptions, type AttachBasicGameplayArtifactOptions, BASIC_GAMEPLAY_ACTION_TYPES, BASIC_GAMEPLAY_PROGRESS_CHECK_TYPES, type BasicGameplayActionResult, type BasicGameplayActionType, type BasicGameplayArtifactResolution, type BasicGameplayAssessmentSummary, type BasicGameplayBoundsOffender, type BasicGameplayCanvasState, type BasicGameplayCatchRecord, type BasicGameplayChangeSummary, type BasicGameplayFailureCode, type BasicGameplayFixReference, type BasicGameplayMetric, type BasicGameplayMobileEvidence, type BasicGameplayProgressCheckType, type BasicGameplayProgressionCheck, type BasicGameplayProofArtifact, type BasicGameplayResponsiveViewportEvidence, type BasicGameplayRouteReference, type BasicGameplaySnapshot, type BasicGameplaySuiteFailure, type BasicGameplayWarningCode, type CreateBasicGameplayCatchSummaryInput, RIDDLE_PROOF_BASIC_GAMEPLAY_ASSESSMENT_VERSION, RIDDLE_PROOF_BASIC_GAMEPLAY_CATCH_VERSION, RIDDLE_PROOF_BASIC_GAMEPLAY_VERSION, type RiddleProofBasicGameplayAssessment, type RiddleProofBasicGameplayCatchSummary, type RiddleProofBasicGameplayEvidence, type RiddleProofBasicGameplayRouteAssessment, type RiddleProofBasicGameplayRouteEvidence, assessBasicGameplayEvidence, assessBasicGameplayProgressionCheck, assessBasicGameplayProgressionChecks, assessBasicGameplayRoute, attachBasicGameplayArtifactScreenshotHashes, augmentBasicGameplayAssessmentWithProgressionChecks, compactBasicGameplayText, createBasicGameplayCatchRecords, createBasicGameplayCatchSummary, extractBasicGameplayEvidence, resolveBasicGameplayProgressionCheckWithArtifactScreenshots, sanitizeBasicGameplayJsonString };

package/dist/basic-gameplay.js

@@ -16,7 +16,7 @@ import {
   extractBasicGameplayEvidence,
   resolveBasicGameplayProgressionCheckWithArtifactScreenshots,
   sanitizeBasicGameplayJsonString
-} from "./chunk-E6O3EOEI.js";
+} from "./chunk-ELZSPOWV.js";
 export {
   BASIC_GAMEPLAY_ACTION_TYPES,
   BASIC_GAMEPLAY_PROGRESS_CHECK_TYPES,

package/dist/{chunk-E6O3EOEI.js → chunk-ELZSPOWV.js}

@@ -79,7 +79,8 @@ function assessBasicGameplayEvidence(evidence, options = {}) {
   }
   const routeResults = (run.results || []).map((route) => augmentRouteAssessmentWithProgressionChecks(
     assessBasicGameplayRoute(route, options),
-    route
+    route,
+    options
   ));
   const failingRoutes = routeResults.filter((result) => !result.ok).map((result) => ({
     name: result.name,
@@ -140,7 +141,7 @@ function assessBasicGameplayRoute(route, options = {}) {
   const responseStatus = firstNumber(route.http_status, route.response_status, route.status);
   const pageErrorCount = numberValue(route.page_error_count);
   const consoleErrorCount = numberValue(route.console_error_count);
-  const mobileOverflowPx = numberValue(mobile.overflow_px);
+  const mobileOverflowPx = horizontalBoundsOverflowPx(mobile);
   if (responseStatus !== null && responseStatus >= 400) failures.push("route_http_error");
   if (pageErrorCount > 0) failures.push("fatal_page_error");
   if (numberValue(initial.body_text_length) < minBodyTextLength && numberValue(initial.visible_large_node_count) < minVisibleLargeNodes) {
@@ -283,11 +284,11 @@ function assessBasicGameplayProgressionCheck(check) {
 function assessBasicGameplayProgressionChecks(route) {
   return progressionChecksForRoute(route).map((check) => assessBasicGameplayProgressionCheck(check));
 }
-function augmentBasicGameplayAssessmentWithProgressionChecks(assessment, evidence) {
+function augmentBasicGameplayAssessmentWithProgressionChecks(assessment, evidence, options = {}) {
   const run = extractBasicGameplayEvidence(evidence);
   if (!run?.results?.length) return assessment;
   const routeResults = assessment.route_results.map(
-    (result, index) => augmentRouteAssessmentWithProgressionChecks(result, run.results?.[index] || {})
+    (result, index) => augmentRouteAssessmentWithProgressionChecks(result, run.results?.[index] || {}, options)
   );
   const failingRoutes = routeResults.filter((result) => !result.ok).map((result) => ({
     name: result.name,
@@ -349,7 +350,7 @@ function attachBasicGameplayArtifactScreenshotHashes(evidence, routesOrOptions =
   }
   return evidence;
 }
-function createBasicGameplayCatchRecords(assessment, evidence) {
+function createBasicGameplayCatchRecords(assessment, evidence, options = {}) {
   const run = extractBasicGameplayEvidence(evidence);
   if (!run?.results?.length) return [];
   const catches = [];
@@ -423,6 +424,24 @@ function createBasicGameplayCatchRecords(assessment, evidence) {
         summary: `${route.name || route.path || "Route"}: responsive setup failed on ${failure.viewport?.label || "viewport"} (${failure.reason || "responsive_setup_failed"})`
       });
     }
+    for (const failure of responsiveBoundsFailures(route, options.maxMobileOverflowPx ?? 4)) {
+      catches.push({
+        site: run.site || null,
+        route: route.name,
+        path: route.path,
+        code: failure.code,
+        label: failure.label,
+        type: "responsive_bounds",
+        selector: null,
+        reason: failure.reason || "responsive_bounds_clipped",
+        phase: failure.viewport?.phase || void 0,
+        viewport: failure.viewport,
+        overflow_px: failure.overflow_px,
+        max_allowed_px: failure.max_allowed_px,
+        offenders: failure.offenders,
+        summary: `${route.name || route.path || "Route"}: responsive bounds exceeded ${failure.max_allowed_px}px on ${failure.viewport?.label || "viewport"} (${failure.overflow_px}px)`
+      });
+    }
     for (const check of assessBasicGameplayProgressionChecks(route).filter((item) => item.ok === false)) {
       catches.push({
         site: run.site || null,
@@ -577,13 +596,15 @@ function changed(before, after) {
 function canvasHashes(canvases) {
   return (canvases || []).map((canvas) => canvas.hash).filter(Boolean).join("|");
 }
-function augmentRouteAssessmentWithProgressionChecks(result, route) {
+function augmentRouteAssessmentWithProgressionChecks(result, route, options = {}) {
   const progressionFailures = assessBasicGameplayProgressionChecks(route).filter((check) => check.ok === false);
   const responsiveFailures = responsiveSetupFailures(route);
-  if (!progressionFailures.length && !responsiveFailures.length) return result;
+  const responsiveBounds = responsiveBoundsFailures(route, options.maxMobileOverflowPx ?? 4);
+  if (!progressionFailures.length && !responsiveFailures.length && !responsiveBounds.length) return result;
   const failures = new Set(result.failures);
   if (progressionFailures.length) failures.add("progression_assertion_failed");
   for (const failure of responsiveFailures) failures.add(failure.code);
+  for (const failure of responsiveBounds) failures.add(failure.code);
   return {
     ...result,
     ok: false,
@@ -599,7 +620,8 @@ function augmentRouteAssessmentWithProgressionChecks(result, route) {
         state_call: check.state_call || null,
         property_path: check.property_path || null
       })),
-      ...responsiveFailures
+      ...responsiveFailures,
+      ...responsiveBounds
     ]
   };
 }
@@ -625,6 +647,28 @@ function responsiveSetupFailures(route) {
   }
   return failures;
 }
+function responsiveBoundsFailures(route, maxOverflowPx) {
+  const failures = [];
+  for (const viewport of responsiveViewportsForRoute(route)) {
+    const overflowPx = horizontalBoundsOverflowPx(viewport);
+    if (overflowPx <= maxOverflowPx) continue;
+    failures.push({
+      code: "responsive_bounds_clipped",
+      label: `${viewport.label || "responsive"} horizontal bounds`,
+      reason: `horizontal bounds overflow ${overflowPx}px exceeded ${maxOverflowPx}px`,
+      overflow_px: overflowPx,
+      max_allowed_px: maxOverflowPx,
+      offenders: boundsOffendersForEvidence(viewport).slice(0, 10),
+      viewport: {
+        label: viewport.label || null,
+        width: numberValue(viewport.width) || null,
+        height: numberValue(viewport.height) || null,
+        phase: viewport.phase || null
+      }
+    });
+  }
+  return failures;
+}
 function responsiveViewportsForRoute(route) {
   return listValue(route.responsive_viewports || route.responsiveViewports).filter((item) => Boolean(recordValue(item)));
 }
@@ -634,6 +678,82 @@ function progressionChecksForRoute(route) {
 function metricValue(value) {
   return recordValue(value);
 }
+function horizontalBoundsOverflowPx(value) {
+  const record = recordValue(value);
+  if (!record) return 0;
+  let max = maxPositiveNumber(
+    record.overflow_px,
+    record.overflow,
+    record.bounds_overflow_px,
+    record.horizontal_overflow_px,
+    record.left_overflow_px,
+    record.right_overflow_px
+  );
+  for (const offender of boundsOffendersForEvidence(record)) {
+    max = Math.max(max, horizontalOffenderOverflowPx(offender));
+  }
+  return roundPixels(max);
+}
+function horizontalOffenderOverflowPx(value) {
+  const record = recordValue(value);
+  if (!record) return 0;
+  let max = maxPositiveNumber(
+    record.overflow,
+    record.overflow_px,
+    record.bounds_overflow_px,
+    record.horizontal_overflow_px,
+    record.left_overflow_px,
+    record.right_overflow_px,
+    record.leftOverflowPx,
+    record.rightOverflowPx
+  );
+  const clipped = recordValue(record.clipped || record.clip || record.clipping);
+  if (clipped) {
+    max = Math.max(max, maxPositiveNumber(
+      clipped.left,
+      clipped.right,
+      clipped.left_px,
+      clipped.right_px,
+      clipped.leftPx,
+      clipped.rightPx
+    ));
+  }
+  const rect = recordValue(record.rect || record.bounds || record.bounding_rect || record.boundingRect);
+  const viewportWidth = numericValue(record.viewport_width ?? record.viewportWidth);
+  if (rect && viewportWidth !== null) {
+    const left = numericValue(rect.left);
+    const right = numericValue(rect.right);
+    if (left !== null && left < 0) max = Math.max(max, Math.abs(left));
+    if (right !== null && right > viewportWidth) max = Math.max(max, right - viewportWidth);
+  }
+  return roundPixels(max);
+}
+function boundsOffendersForEvidence(value) {
+  const record = recordValue(value);
+  if (!record) return [];
+  const offenders = [
+    ...listValue(record.overflow_offenders),
+    ...listValue(record.overflowOffenders),
+    ...listValue(record.bounds_offenders),
+    ...listValue(record.boundsOffenders),
+    ...listValue(record.clipped_elements),
+    ...listValue(record.clippedElements),
+    ...listValue(record.clipping_offenders),
+    ...listValue(record.clippingOffenders)
+  ];
+  return offenders.filter((item) => Boolean(recordValue(item))).sort((a, b) => horizontalOffenderOverflowPx(b) - horizontalOffenderOverflowPx(a));
+}
+function maxPositiveNumber(...values) {
+  let max = 0;
+  for (const value of values) {
+    const number = numericValue(value);
+    if (number !== null && number > max) max = number;
+  }
+  return max;
+}
+function roundPixels(value) {
+  return Math.round(value * 100) / 100;
+}
 function textMatches(text, pattern, flags) {
   if (!pattern) return Boolean(text);
   try {